Исходный код вики Интеграция с трекингом (API)

Версия 9.1 от Григорий Лепёшкин на 2023/12/21 17:18
Последние авторы
1 (% class="row" %)
2 (((
3 (% class="col-xs-12 col-sm-8" %)
4 (((
5 = Назначение API =
6
7 Веб-сервис для интеграции систем авторизованных сервисных центров (АСЦ) с системой провайдера. Веб-сервис позволяет передавать и получать данные по ремонту/трекингу, а также загружать вложения.
8
9 = Список методов =
10
11 * (((
12 == [[CreateTrackingCallCentr>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=CreateTrackingCallCentr]] ==
13 )))
14
15 Создание трекинга колл-центра.
16
17 Входные параметры:
18
19 |Название параметра|Тип параметра|Обяз.|Описание параметра
20 |ticket|**string**|Да|Сессионный ключ
21 |record|**record**|Да|структура содержащая данные
22 |(% colspan="4" %)**Структура Record**
23 |Model|**string (50)**|Да|Строка названия модели
24 |OrderNumBrand|**string (50)**|Да|Номер заявки колл-центра
25 |SerialNumb|**string (50)**|Нет|Серийный номер
26 |DesRepair|**string (3000)**|Нет|Заявленная неисправность
27 |RepairTypeUid|**guid**|Нет|(((
28 Тип ремонта  (связь с брендами (Default)). Значение берется из метода [[GetSpRepairTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpRepairTypes]]. Если не заполнено, то подставится «Клиентский гарантийный».
29
30
31 )))
32 |BrandUid|**guid**|Да|Бренд (торговая марка). Значение берётся из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].BrandUid
33 |CountryServiceCenter|**string (2)**|Нет|Стана АСЦ. Указывается страна в виде кода ALFA-2. Если страна найдена, то город будет сопоставляться с городами этой страны, иначе со страной пользователя колл-центра.
34 |CityServiceCenter|**string (255)**|Нет|Город АСЦ. Город подбирается по тексту и стране. Если город найден, то по городу и бренду  осуществляется поиск АСЦ. Если найден единственный АСЦ, то подставляется он иначе, если не единственный или если город не найден, то берется город пользователя колл-центра и в качестве АСЦ указывается пусто. Далее при редактировании данного трекинга на сайте, его не возможно сохранить с пустым АСЦ.  
35 |CName|**string (255)**|Нет|Имя клиента
36 |CSurname|**string (255)**|Нет|Фамилия клиента
37 |CPatronymic|**string (255)**|Нет|Отчество клиента
38 |CCity|**string (255)**|Нет|Город клиента
39 |CAddress|**string (255)**|Нет|Адрес клиента
40 |CHouse|**string (5)**|Нет|Номер дома клиента
41 |CBuild|**string (5)**|Нет|Корпус дома клиента
42 |CFlat|**string (5)**|Нет|Номер квартиры клиента
43 |CMobTel|**string (15)**|Нет|Мобильный телефон клиента
44 |Cemail|**string (255)**|Нет|Email клиента
45 |UrlQuestionnaire|**string**|Нет|URL на анкету для прохождения опроса по завершению ремонта
46
47 Выходные параметры:
48
49 |Название параметра|Тип параметра|Описание параметра|Пример
50 |TrackingUid|**guid**|Уникальный идентификатор трекинга. Значение можно использовать для дальнейших вызовов метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]], если необходимо обновить значения трекинга.|
51 |SysNum|**string**|Системный номер трекинга (учётный номер ремонта в системе)|
52 |StatusName|**string**|Статус трекинга|
53 |StatusUid|**guid**|UID статуса трекинга. Значение берётся из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].|
54 |Result|**Added** or **Changed** or **NotFound** or **Error** or **Unknown**|(((
55 Результат выполнения операции:
56
57 Added – трекинг создан и помещён в базу
58
59 Changed – трекинг изменён
60
61 NotFound – трекинг не найден по uid
62
63 Error – ошибка в работе метода
64
65 Unknown – неизвестная ошибка
66 )))|Added
67 |TrackingUri|**string**|Ссылка на трекинг, которую можно открыть в браузере|
68
69 Секция Errors содержит коллекцию строк ошибок.
70
71 Секция ValidationErrors содержит коллекцию ErrorItem следующего вида:
72
73 |Название параметра|Тип параметра|Описание параметра|Пример
74 |ErrorCode|**string**|Код ошибки|
75 |ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.|
76 |Status|**string**|Статус трекинга|
77 |Descriptilon|**string**|Описание ошибки
78
79 * (((
80 == [[DeleteAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=DeleteAttachment]] ==
81 )))
82
83 Удаляет вложение трекинга по номеру ремонта АСЦ (OrderNumAsc) и по типу вложения
84
85 * (((
86 == [[GetANRPInfo>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetANRPInfo]] ==
87 )))
88
89 Получение информации по акту неремонтопригодности.
90
91 * (((
92 == [[GetATOInfo>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetATOInfo]] ==
93 )))
94
95 Получение информации по акту технического освидетельствования.
96
97 * (((
98 == [[GetActionPlace>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetActionPlace]] ==
99 )))
100
101 Возвращает справочник мест ремонта.
102
103 * (((
104 == [[GetAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachment]] ==
105 )))
106
107 Возвращает вложение по номеру ремонта АСЦ (OrderNumAsc) и по типу вложения.
108
109 * (((
110 == [[GetAttachmentKeys>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachmentKeys]] ==
111 )))
112
113 Возвращает список вложений по системному номеру трекинга (OrderNum) без самих вложений.
114
115 * (((
116 == [[GetAttachmentTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachmentTypes]] ==
117 )))
118
119 Возвращает список типов вложений
120
121 * (((
122 == [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]] ==
123 )))
124
125 Возвращает список брендов в разрезе групп брендов.
126
127 * (((
128 == [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]] ==
129 )))
130
131 Возвращает справочник Iris Код условий по бренду и категории модели.
132
133 * (((
134 == [[GetCategIrisDefectCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]] ==
135 )))
136
137 Возвращает справочник Iris Код дефектов по бренду и категории модели.
138
139 * (((
140 == [[GetCategIrisRepairCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]] ==
141 )))
142
143 Возвращает справочник Iris Код ремонтов по бренду и категории модели.
144
145 * (((
146 == [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]] ==
147 )))
148
149 Возвращает справочник Iris Код секций по бренду и категории модели.
150
151 * (((
152 == [[GetCategIrisSymptomCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]] ==
153 )))
154
155 Возвращает справочник Iris Код симптомов по бренду и категории модели.
156
157 * (((
158 == [[GetIrisCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetIrisCodes]] ==
159 )))
160
161 Возвращает Iris коды в разрезе типов Iris кодов (ConditionCode, DefectCode, RepairCode, sectionCode, SymptomCode), категорий моделей и брендов (в рамках активных авторизаций по брендам)
162
163 * (((
164 == [[GetModelCategories>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetModelCategories]] ==
165 )))
166
167 Возвращает справочник категорий моделей.
168
169 * (((
170 == [[GetOrderByAscKey>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderByAscKey]] ==
171 )))
172
173 Возвращает трекинг по номеру ремонта АСЦ (OrderNumAsc)
174
175 **Входные параметры:**
176
177 |Название параметра|Тип параметра|Обяз?|Описание параметра|Пример
178 |ticket|**string**|Да|Сессионный ключ|YOB7IG8UG687068
179 |(((
180 numberKey
181
182
183 )))|**string**|Да|Собственный номер ремонта АСЦ.|1.0.0.0
184
185 **Выходные параметры:**
186
187 **Секция Tracking**
188
189 |Название параметра|Тип параметра|Описание параметра|Пример
190 |uid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]] в случае, если нужно обновить значения трекинга.|6e18064e-1cd3-4207-8ebe-08c4417db2be
191 |Brand|**guid**|Группа брендов. Значение берётся из поля MainBrandUid из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b457927a-766e-44b1-a79d-508adee3a915
192 |Model|**string (50)**|Строка названия модели|121
193 |OrderNum|**string (50)**|Строка номера ремонта|0000018
194 |OrderNumBrand|**string (50)**|Номер заявки колл-центра|
195 |ReceiveDate|**datetime**|Дата получения товара в ремонт|
196 |ReadyDate|**datetime**|Дата готовности|
197 |ReadyOutDate|**datetime**|Дата готовности к выдаче|
198 |OutDate|**datetime**|Дата выдачи|
199 |PurchDate|**datetime**|Дата покупки|
200 |SerialNumb|**string (50)**|Серийный номер|
201 |ProductNumb|**string (50)**|Продуктовый номер|
202 |EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|2023-04-07T18:16:10.783
203 |TransportService|**guid**|Вид транспортировки. Значение берётся из [[GetTransportService>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]].|f34fa37d-b678-469d-9129-6ac9d9d270f7
204 |PlanTransportDate|**datetime**|Плановая дата доставки|
205 |Status|**guid**|Статус. Значение берётся из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].|51deb04d-b307-4efc-826a-2d0e3d151d1d
206 |MasterASC|**string (255)**|ФИО мастера|
207 |CreateDate|**datetime**|Дата создания (в первый раз будет заменена на текущую)|2023-04-03T16:56:20.74
208 |ComplectPack|**int**|Наличие коробки|
209 |ComplectWarr|**int**|Наличие гарантийного талона|
210 |ComplectCheck|**int**|Наличие чека|
211 |PlanMasterDate|**datetime**|Планируемая дата выезда|
212 |IsExpRep|**boolean**|Флаг экспресс-ремонта|
213 |ServiceBulletin|**string (255)**|Сервисный бюллетень|
214 |ActionPlace|**guid**|Место ремонта. Значение берётся из [[GetActionPlace>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetActionPlace]].|87da8c9b-61d8-4db0-825b-9c39adf1f50b
215 |DesRepair|**string (3000)**|Заявленная неисправность|test
216 |DescriptionCC|**string (3000)**|Результат диагностики оператором Call Центра|
217 |DescriptionCompCent|**string (3000)**|Резюме центра компетенции|
218 |DiagnosticResult|**string (3000)**|Результат диагностики|
219 |Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
220 |Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
221 |Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]].|
222 |Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]].|
223 |Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]].|
224 |LocationCode|**string (50)**|Позиционный номер|
225 |DName|**string (255)**|Наименование дилера|
226 |DCity|**string (255)**|Город дилера|
227 |DAddress|**string (255)**|Адрес дилера|
228 |DTel|**string (11)**|Телефон дилера|
229 |Demail|**string (255)**|Email дилера|
230 |DComments|**string (500)**|Дополнительная информация дилера|
231 |CName|**string (255)**|Имя клиента|
232 |CSurname|**string (255)**|Фамилия клиента|
233 |CPatronymic|**string (255)**|Отчество клиента|
234 |CCity|**string (255)**|Город клиента|
235 |CAddress|**string (255)**|Адрес клиента|
236 |CHouse|**string (5)**|Номер дома клиента|
237 |CBuild|**string (5)**|Корпус клиента|
238 |CFlat|**string (5)**|Номер квартиры клиента|
239 |CHomeTel|**string (11)**|Домашний телефон клиента|
240 |CWorkTel|**string (11)**|Рабочий телефон клиента|
241 |CMobTel|**string (13)**|Мобильный телефон клиента|
242 |Cemail|**string (255)**|Email клиента|
243 |CComments|**string (500)**|Дополнительная информация клиента|
244 |CLift|**int**|Наличие лифта в доме клиента|
245 |CDomofon|**string (50)**|Код домофона у клиента|
246 |OrderNumAsc|**string (50)**|Номер ремонта в системе АСЦ|
247 |StartRepairDate|**datetime**|Дата начала ремонта АСЦ|
248 |RegularSWnumberIN|**string (255)**|Версия прошивки "Main SW" при поступлении в ремонт|
249 |RegularSWnumberOUT|**string (255)**|Версия прошивки "Main SW" при выдаче из ремонта|
250 |StandBySWnumberIN|**string (255)**|Версия прошивки "Stand By SW" при поступлении в ремонт|
251 |StandBySWnumberOUT|**string (255)**|Версия прошивки "Stand By" при выдаче из ремонта|
252 |(((
253 ConditionDescr
254
255
256 )))|**string (255)**|Описание Iris кода условия|1-Постоянно
257 |RepairTypeCurrent|**guid**|Тип ремонта текущий (связь с брендами (Default))|b7a77d5a-e95a-11d9-b44e-000476de6b1e
258 |RepairTypeStart|**guid**|Тип ремонта начальный (связь с брендами (Default))|
259 |TransportZone|**guid**|Зона транспортировки. Значение берётся из GetTransportZone.|85df2056-e60f-4bc1-a21c-17c9f6c9241a
260 |UidNRP|**guid**|Uid акта НРП|
261 |RealBrand|**guid**|Бренд (торговая марка). Значение берётся из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b8a3f06b-cacf-4a9b-b3f7-089c266ea654
262 |(((
263 IWS
264
265
266 )))|**string (255)**|Номер IWS|b8a3f06b-cacf-4a9b-b3f7-089c266ea654
267 |RegionUid|**guid**|Город АСЦ.|
268 |Recommendation|**string (3000)**|Рекомендации мастера по эксплуатации|
269 |IMEI1|**string (255)**|IMEI1|
270 |IMEI2|**string (255)**|IMEI2|
271 |IMEI3|**string (255)**|IMEI3|
272 |IMEI4|**string (255)**|IMEI4|
273 |IMEI1NEW|**string (255)**|IMEI1 новый|
274 |IMEI2NEW|**string (255)**|IMEI2 новый|
275 |IMEI3NEW|**string (255)**|IMEI3 новый|
276 |IMEI4NEW|**string (255)**|IMEI4 новый|
277 |RepairLevel|**string (300)**|Уровень ремонта|
278
279 Подсекция Parts секции Tracking состоит из коллекции типа PartRecord следующего формата:
280
281 |Название параметра|Тип параметра|Описание параметра|Пример
282 |uid|**guid**|Уникальный идентификатор детали/з/ч. Значение берётся из предыдущего вызова метода SaveOrder в случае, если нужно обновить значения трекинга.|
283 |CreateDate|**datetime**|Дата создания (будет заменена на текущую)|
284 |PartNumber|**string (100)**|ПартНомер|
285 |PartName|**string (255)**|Наименование детали|
286 |Price|**decimal**|Цена отгрузки|
287 |Qnt|**int**|Количество|
288 |Compensate|**decimal**|Размер компенсации для ASC|
289 |ASCOrderNo|**string (100)**|№ заказа ACЦ (ссылка на заказ)|
290 |SPOrderNo|**string (100)**|№ заявки з/ч (проверка при создании акта НРП)|
291 |OrderCreate|**datetime**|Дата заказа запчасти|
292 |PrognoseDate|**datetime**|Ожидаемая дата получения з/ч|
293 |OrderUid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]].|
294 |AscItemKey|**string (50)**|Внутренний ID детали АСЦ|
295 |TypeOrder|**guid**|Тип заказчика, в основном пустой или АСЦ|9314B01D-3D61-426C-BCAF-BFDEF25AAA56
296 |InvoiceNum|**string (50)**|Номер накладной|
297 |InvoiceDate|**datetime**|Дата накладной|
298 |InvoiceRef|**guid**|Ссылка на позицию в накладной. Не используется в данное время|
299 |AscStore|**int**|(((
300 ~=1, если деталь получена АСЦ не у провайдера, а со стороны
301
302 ~=0, если получена АСЦ у провайдера.
303
304 Возможность указывать детали своего склада зависит от настроек авторизации по бренду.
305 )))|
306 |Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
307 |Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
308 |Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]].|
309 |Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]].|
310 |Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]].|
311 |LocationCode|**string (50)**|Позиционный номер|
312 |EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|
313 |EditUser|**guid**|Идентификатор пользователя|
314 |ProblemPartSerial|**string (255)**|Серийный номер неисправной детали|
315 |SetupPartSerial|**string (255)**|Серийный номер установленной детали|
316
317 **Секция Payment**
318
319 |Название параметра|Тип параметра|Описание параметра|Пример
320 |uid|**guid**|Идентификатор заказа|00000000-0000-0000-0000-000000000000
321 |Labor|**decimal**|Стоимость работы|
322 |BonusASC|**decimal**|Бонус АСЦ|
323 |Handling|**decimal**|Фиксированный тариф провайдера|
324 |BonusCSP|**decimal**|Переменное вознаграждение провайдера|
325 |BonusCSPPercent|**decimal**|Процент ~(% от тарифа) на момент формирования инвойса|
326 |SU|**decimal**|Оплата доставки з/ч провайдера|
327 |Transport|**decimal**|Оплата транспортировки/выезда|
328 |SparePartsASC|**decimal**|Сумма компенсации з/ч АСЦ|
329 |SparePartsCSP|**decimal**|Сумма компенсации з/ч провайдера|
330 |AdditionalLabor|**decimal**|Оплата дополнительных работ АСЦ|
331 |ASCSumm|**decimal**|Итого оплата АСЦ|
332 |CSPSumm|**decimal**|Итого оплата провайдера|
333 |TotalSumm|**decimal**|Итого сумма отплаты|
334 |LaborCSP|**decimal**|Стоимость работы провайдера|
335 |LaborPSU|**decimal**|Стоимость ремонта PSU|
336 |LaborSSB|**decimal**|Стоимость ремонта SSB|
337 |AdditionalLaborTotal|**decimal**|Всего стоимость дополнительных работ|
338 |BonusASCPercent|**decimal**|Процент бонусов АСЦ|
339 |SparePartsTotal|**decimal**|Всего стоимость з/ч|
340 |AdditionalLaborDescr|**String (1000)**|Описание дополнительных работ|
341
342 **Отдельный параметр**
343
344 |Название параметра|Тип параметра|Описание параметра|Пример
345 |RefUri|**string**|Ссылка на трекинг, которую можно открыть в браузере|
346
347 Секция ValidationErrors содержит коллекцию ErrorItem следующего вида:
348
349 |Название параметра|Тип параметра|Описание параметра|Пример
350 |ErrorCode|**string**|Код ошибки|43
351 |ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.|1
352 |Status|**string**|Статус трекинга|
353 |Descriptilon|**string**|Описание ошибки|Для продолжения ремонта необходимо ввести, по крайней мере, одну запасную часть
354
355 * (((
356 == [[GetOrderBySysKey>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderBySysKey]] ==
357 )))
358
359 Возвращает трекинг по системному номеру (OrderNum).
360
361 **Входные параметры:**
362
363 |Название параметра|Тип параметра|Обяз?|Описание параметра|Пример
364 |ticket|**string**|Да|Сессионный ключ|YOB7IG8UG687068
365 |(((
366 numberKey
367
368
369 )))|**string**|Да|Системный номер ремонта. OrderNum секции трекинг.|1.0.0.0
370
371 **Выходные параметры:**
372
373 **Секция Tracking**
374
375 |Название параметра|Тип параметра|Описание параметра|Пример
376 |uid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]] в случае, если нужно обновить значения трекинга.|6e18064e-1cd3-4207-8ebe-08c4417db2be
377 |Brand|**guid**|Группа брендов. Значение берётся из поля MainBrandUid из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b457927a-766e-44b1-a79d-508adee3a915
378 |Model|**string (50)**|Строка названия модели|121
379 |OrderNum|**string (50)**|Строка номера ремонта|0000018
380 |OrderNumBrand|**string (50)**|Номер заявки колл-центра|
381 |ReceiveDate|**datetime**|Дата получения товара в ремонт|
382 |ReadyDate|**datetime**|Дата готовности|
383 |ReadyOutDate|**datetime**|Дата готовности к выдаче|
384 |OutDate|**datetime**|Дата выдачи|
385 |PurchDate|**datetime**|Дата покупки|
386 |SerialNumb|**string (50)**|Серийный номер|
387 |ProductNumb|**string (50)**|Продуктовый номер|
388 |EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|2023-04-07T18:16:10.783
389 |TransportService|**guid**|Вид транспортировки. Значение берётся из [[GetTransportService>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]].|f34fa37d-b678-469d-9129-6ac9d9d270f7
390 |PlanTransportDate|**datetime**|Плановая дата доставки|
391 |Status|**guid**|Статус. Значение берётся из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].|51deb04d-b307-4efc-826a-2d0e3d151d1d
392 |MasterASC|**string (255)**|ФИО мастера|
393 |CreateDate|**datetime**|Дата создания (в первый раз будет заменена на текущую)|2023-04-03T16:56:20.74
394 |ComplectPack|**int**|Наличие коробки|
395 |ComplectWarr|**int**|Наличие гарантийного талона|
396 |ComplectCheck|**int**|Наличие чека|
397 |PlanMasterDate|**datetime**|Планируемая дата выезда|
398 |IsExpRep|**boolean**|Флаг экспресс-ремонта|
399 |ServiceBulletin|**string (255)**|Сервисный бюллетень|
400 |ActionPlace|**guid**|Место ремонта. Значение берётся из [[GetActionPlace>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetActionPlace]].|87da8c9b-61d8-4db0-825b-9c39adf1f50b
401 |DesRepair|**string (3000)**|Заявленная неисправность|test
402 |DescriptionCC|**string (3000)**|Результат диагностики оператором Call Центра|
403 |DescriptionCompCent|**string (3000)**|Резюме центра компетенции|
404 |DiagnosticResult|**string (3000)**|Результат диагностики|
405 |Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
406 |Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
407 |Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]].|
408 |Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]].|
409 |Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]].|
410 |LocationCode|**string (50)**|Позиционный номер|
411 |DName|**string (255)**|Наименование дилера|
412 |DCity|**string (255)**|Город дилера|
413 |DAddress|**string (255)**|Адрес дилера|
414 |DTel|**string (11)**|Телефон дилера|
415 |Demail|**string (255)**|Email дилера|
416 |DComments|**string (500)**|Дополнительная информация дилера|
417 |CName|**string (255)**|Имя клиента|
418 |CSurname|**string (255)**|Фамилия клиента|
419 |CPatronymic|**string (255)**|Отчество клиента|
420 |CCity|**string (255)**|Город клиента|
421 |CAddress|**string (255)**|Адрес клиента|
422 |CHouse|**string (5)**|Номер дома клиента|
423 |CBuild|**string (5)**|Корпус клиента|
424 |CFlat|**string (5)**|Номер квартиры клиента|
425 |CHomeTel|**string (11)**|Домашний телефон клиента|
426 |CWorkTel|**string (11)**|Рабочий телефон клиента|
427 |CMobTel|**string (13)**|Мобильный телефон клиента|
428 |Cemail|**string (255)**|Email клиента|
429 |CComments|**string (500)**|Дополнительная информация клиента|
430 |CLift|**int**|Наличие лифта в доме клиента|
431 |CDomofon|**string (50)**|Код домофона у клиента|
432 |OrderNumAsc|**string (50)**|Номер ремонта в системе АСЦ|
433 |StartRepairDate|**datetime**|Дата начала ремонта АСЦ|
434 |RegularSWnumberIN|**string (255)**|Версия прошивки "Main SW" при поступлении в ремонт|
435 |RegularSWnumberOUT|**string (255)**|Версия прошивки "Main SW" при выдаче из ремонта|
436 |StandBySWnumberIN|**string (255)**|Версия прошивки "Stand By SW" при поступлении в ремонт|
437 |StandBySWnumberOUT|**string (255)**|Версия прошивки "Stand By" при выдаче из ремонта|
438 |(((
439 ConditionDescr
440
441
442 )))|**string (255)**|Описание Iris кода условия|1-Постоянно
443 |RepairTypeCurrent|**guid**|Тип ремонта текущий (связь с брендами (Default))|b7a77d5a-e95a-11d9-b44e-000476de6b1e
444 |RepairTypeStart|**guid**|Тип ремонта начальный (связь с брендами (Default))|
445 |TransportZone|**guid**|Зона транспортировки. Значение берётся из GetTransportZone.|85df2056-e60f-4bc1-a21c-17c9f6c9241a
446 |UidNRP|**guid**|Uid акта НРП|
447 |RealBrand|**guid**|Бренд (торговая марка). Значение берётся из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b8a3f06b-cacf-4a9b-b3f7-089c266ea654
448 |(((
449 IWS
450
451
452 )))|**string (255)**|Номер IWS|b8a3f06b-cacf-4a9b-b3f7-089c266ea654
453 |RegionUid|**guid**|Город АСЦ.|
454 |Recommendation|**string (3000)**|Рекомендации мастера по эксплуатации|
455 |IMEI1|**string (255)**|IMEI1|
456 |IMEI2|**string (255)**|IMEI2|
457 |IMEI3|**string (255)**|IMEI3|
458 |IMEI4|**string (255)**|IMEI4|
459 |IMEI1NEW|**string (255)**|IMEI1 новый|
460 |IMEI2NEW|**string (255)**|IMEI2 новый|
461 |IMEI3NEW|**string (255)**|IMEI3 новый|
462 |IMEI4NEW|**string (255)**|IMEI4 новый|
463 |RepairLevel|**string (300)**|Уровень ремонта|
464
465 Подсекция Parts секции Tracking состоит из коллекции типа PartRecord следующего формата:
466
467 |Название параметра|Тип параметра|Описание параметра|Пример
468 |uid|**guid**|Уникальный идентификатор детали/з/ч. Значение берётся из предыдущего вызова метода SaveOrder в случае, если нужно обновить значения трекинга.|
469 |CreateDate|**datetime**|Дата создания (будет заменена на текущую)|
470 |PartNumber|**string (100)**|ПартНомер|
471 |PartName|**string (255)**|Наименование детали|
472 |Price|**decimal**|Цена отгрузки|
473 |Qnt|**int**|Количество|
474 |Compensate|**decimal**|Размер компенсации для ASC|
475 |ASCOrderNo|**string (100)**|№ заказа ACЦ (ссылка на заказ)|
476 |SPOrderNo|**string (100)**|№ заявки з/ч (проверка при создании акта НРП)|
477 |OrderCreate|**datetime**|Дата заказа запчасти|
478 |PrognoseDate|**datetime**|Ожидаемая дата получения з/ч|
479 |OrderUid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]].|
480 |AscItemKey|**string (50)**|Внутренний ID детали АСЦ|
481 |TypeOrder|**guid**|Тип заказчика, в основном пустой или АСЦ|9314B01D-3D61-426C-BCAF-BFDEF25AAA56
482 |InvoiceNum|**string (50)**|Номер накладной|
483 |InvoiceDate|**datetime**|Дата накладной|
484 |InvoiceRef|**guid**|Ссылка на позицию в накладной. Не используется в данное время|
485 |AscStore|**int**|(((
486 ~=1, если деталь получена АСЦ не у провайдера, а со стороны
487
488 ~=0, если получена АСЦ у провайдера.
489
490 Возможность указывать детали своего склада зависит от настроек авторизации по бренду.
491 )))|
492 |Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
493 |Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
494 |Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]].|
495 |Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]].|
496 |Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]].|
497 |LocationCode|**string (50)**|Позиционный номер|
498 |EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|
499 |EditUser|**guid**|Идентификатор пользователя|
500 |ProblemPartSerial|**string (255)**|Серийный номер неисправной детали|
501 |SetupPartSerial|**string (255)**|Серийный номер установленной детали|
502
503 **Секция Payment**
504
505 |Название параметра|Тип параметра|Описание параметра|Пример
506 |uid|**guid**|Идентификатор заказа|00000000-0000-0000-0000-000000000000
507 |Labor|**decimal**|Стоимость работы|
508 |BonusASC|**decimal**|Бонус АСЦ|
509 |Handling|**decimal**|Фиксированный тариф провайдера|
510 |BonusCSP|**decimal**|Переменное вознаграждение провайдера|
511 |BonusCSPPercent|**decimal**|Процент ~(% от тарифа) на момент формирования инвойса|
512 |SU|**decimal**|Оплата доставки з/ч провайдера|
513 |Transport|**decimal**|Оплата транспортировки/выезда|
514 |SparePartsASC|**decimal**|Сумма компенсации з/ч АСЦ|
515 |SparePartsCSP|**decimal**|Сумма компенсации з/ч провайдера|
516 |AdditionalLabor|**decimal**|Оплата дополнительных работ АСЦ|
517 |ASCSumm|**decimal**|Итого оплата АСЦ|
518 |CSPSumm|**decimal**|Итого оплата провайдера|
519 |TotalSumm|**decimal**|Итого сумма отплаты|
520 |LaborCSP|**decimal**|Стоимость работы провайдера|
521 |LaborPSU|**decimal**|Стоимость ремонта PSU|
522 |LaborSSB|**decimal**|Стоимость ремонта SSB|
523 |AdditionalLaborTotal|**decimal**|Всего стоимость дополнительных работ|
524 |BonusASCPercent|**decimal**|Процент бонусов АСЦ|
525 |SparePartsTotal|**decimal**|Всего стоимость з/ч|
526 |AdditionalLaborDescr|**String (1000)**|Описание дополнительных работ|
527
528 **Отдельный параметр**
529
530 |Название параметра|Тип параметра|Описание параметра|Пример
531 |RefUri|**string**|Ссылка на трекинг, которую можно открыть в браузере|
532
533 Секция ValidationErrors содержит коллекцию ErrorItem следующего вида:
534
535 |Название параметра|Тип параметра|Описание параметра|Пример
536 |ErrorCode|**string**|Код ошибки|43
537 |ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.|1
538 |Status|**string**|Статус трекинга|
539 |Descriptilon|**string**|Описание ошибки|Для продолжения ремонта необходимо ввести, по крайней мере, одну запасную часть
540
541 * (((
542 == [[GetOrderKeys>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderKeys]] ==
543 )))
544
545 Возвращает список трекингов, перешедших в конечный статус в последние 35 дней и всех остальных, не перешедших в конечный статус.
546
547 Входные параметры:
548
549 |(% style="width:180px" %)Название параметра|(% style="width:141px" %)Тип параметра|(% style="width:79px" %)Обяз.|(% style="width:415px" %)Описание параметра|(% style="width:168px" %)Пример
550 |(% style="width:180px" %)ticket|(% style="width:141px" %)**string**|(% style="width:79px" %)Да|(% style="width:415px" %)Сессионный ключ|(% style="width:168px" %)YOB7IG8UG687068
551
552 Выходные параметры:
553
554 Возвращает коллекцию TrackingShortItem следующего вида:
555
556 |Название параметра|Тип параметра|Описание параметра|Пример
557 |Uid|**guid**|Идентификатор ремонта|bf181853-8a82-4d7a-91b0-002e1105fe10
558 |NumKey|**string (50)**|Код ремонта в системе|ET0000001
559 |AscKey|**string (50)**|Код АСЦ ремонта|11947
560 |Status|**guid**|Статус. Значения из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]]|574fa171-5482-4979-be0f-117a3dd0dd29
561 |LastEditDate|**dateTime**|Дата последнего редактирования ремонта|2015-03-17T15:41:39.923
562 |MainBrandUid|**guid**|Идентификатор группы брендов. Значения из поля MainBrandUid из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]]|b457927a-766e-44b1-a79d-508adee3a915
563 |BrandUid|**guid**|Идентификатор бренда модели. Значения из поля BrandUid из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]]|318c5448-3632-413e-ba36-16a95d85bb26
564
565 * (((
566 == [[GetRejectReasons>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetRejectReasons]] ==
567 )))
568
569 Список причин отмены трекинга
570
571 * (((
572 == [[GetSpRepairTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpRepairTypes]] ==
573 )))
574
575 Возвращает справочник типов ремонтов по группе брендов (MainBrandUid).
576
577 * (((
578 == [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]] ==
579 )))
580
581 Возвращает список статусов трекинга.
582
583 * (((
584 == [[GetTicket>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTicket]] ==
585 )))
586
587 Получение бинарного идентификатора для аутентификации пользователя по логину и паролю.
588
589 Входные параметры:
590
591 |(% style="width:206px" %)Название параметра|(% style="width:130px" %)Тип параметра|(% style="width:70px" %)Обяз.|(% style="width:234px" %)Описание параметра|(% style="width:343px" %)Пример
592 |(% style="width:206px" %)Login|(% style="width:130px" %)**string**|(% style="width:70px" %)Да|(% style="width:234px" %)Логин пользователя|(% style="width:343px" %)Vasya
593 |(% style="width:206px" %)Password|(% style="width:130px" %)**string**|(% style="width:70px" %)Да|(% style="width:234px" %)Пароль пользователя|(% style="width:343px" %)123456
594
595 Возвращаемое значение:
596
597 |Тип параметра|Описание параметра|Пример
598 |string|Сессионный ключ|YOB7IG8UG687068
599
600 * (((
601 == [[GetTransportService>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]] ==
602 )))
603
604 Возвращает справочник типов транспортировки по мету ремонта и бренду.
605
606 * (((
607 == [[GetTransportZone>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportZone]] ==
608 )))
609
610 Возврат справочника зон транспортировки.
611
612 * (((
613 == [[SaveAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveAttachment]] ==
614 )))
615
616 Создание вложения определенного типа в трекинге, с удалением всех вложений того же типа
617
618 * (((
619 == [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]] ==
620 )))
621
622 Создание/обновление трекинга.
623
624 Входные параметры:
625
626 |Название параметра|Тип параметра|Обяз?|Описание параметра|Пример
627 |ticket|**string**|Да|Сессионный ключ|YOB7IG8UG687068
628 |record|**TrackingRecord**|Да|(((
629 структура содержащая данные, идентична секции Tracking в методе [[GetOrderBySysKey>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderBySysKey]]
630 )))|
631
632 Выходные параметры:
633
634 |Название параметра|Тип параметра|Описание параметра|Пример
635 |TrackingUid|**guid**|Уникальный идентификатор трекинга. Значение можно использовать для дальнейших вызовов метода SaveOrder, если нужно обновить значения трекинга.|
636 |SysNum|**string**|Системный номер трекинга (учётный номер ремонта в системе)|
637 |StatusName|**string**|Статус трекинга|
638 |StatusUid|**guid**|UID статуса трекинга. Значение берётся из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].|
639 |Result|**Added** or **Changed** or **NotFound** or **Error** or **Unknown**|(((
640 Результат выполнения операции:
641
642 Added – трекинг создан и помещён в базу
643
644 Changed – трекинг изменён
645
646 NotFound – трекинг не найден по uid
647
648 Error – ошибка в работе метода
649
650 Unknown – неизвестная ошибка
651 )))|Added
652 |TrackingUri|**string**|Ссылка на трекинг, которую можно открыть в браузере|
653
654 Секция Errors содержит коллекцию строк ошибок.
655
656 Секция ValidationErrors содержит коллекцию ErrorItem следующего вида:
657
658 |Название параметра|Тип параметра|Описание параметра|Пример
659 |ErrorCode|**string**|Код ошибки|
660 |ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.|
661 |Status|**string**|Статус трекинга|
662 |Descriptilon|**string**|Описание ошибки|
663
664 = Порядок вызова методов и работы с сервисом =
665
666 1. Для начала работы требуется аутентифицироваться. Для этого нужно вызвать метод [[GetTicket>>path:#_heading=h.1fob9te]] с параметрами login и password и получить в ответ ticket. Он используются для вызова других методов сервиса. В качестве пользователя может использоваться любой созданный на сайте аккаунт с доступом к созданию трекинга.
667 1. Далее нужно заполнить справочники (классификаторы) вашего сервиса, чтобы передавать их в метод сохранения ремонта. Справочники заполняются вызовами соответствующих методов класса «Получение классификатора».
668 1. Ремонт создаётся методом [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]]. Любые изменения вносятся повторным вызовом этого метода. Метод возвращает в числе других параметров TrackingUid, необходим при сохранении вложений к трекингу [[SaveAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveAttachment]], получении информации по акту неремонтопригодности [[GetANRPInfo>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetANRPInfo]] или акту технического освидетельствования [[GetATOInfo>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetATOInfo]]. Все детали (запчасти, з/ч) нужно передавать каждый раз при вызове метода.
669 1. **Важно: **
670
671 * Ремонт в статусе «ОТЧЕТ», «ОТМЕНЁН», «ОПЛАЧЕН»  не может быть обновлён.
672 * Ремонт в статусе «Ремонт начат» блокируется на изменение ряда полей:
673 ** ReceiveDate - Дата приёма в ремонт
674 ** Model - Модель
675 ** SerialNumb - Серийный номер
676 ** DesRepair - Заявленный дефект
677 ** OrderNumBrand - Номер заявки ИЦ
678 ** RepairTypeCurrent - Тип ремонта
679
680 То есть при передачи новых данных по этим полям, они будут проигнорированы.
681
682
683 )))
684
685 (% class="col-xs-12 col-sm-4" %)
686 (((
687 {{box title="**Содержание**"}}
688 {{toc/}}
689 {{/box}}
690 )))
691 )))