Изменения документа Интеграция с трекингом (API)

Редактировал(а) Дмитрий Семёнов 2025/04/10 15:52
От версии < 6.1 >
отредактировано Григорий Лепёшкин
на 2023/12/21 15:04
К версии < 11.1 >
отредактировано Григорий Лепёшкин
на 2024/05/28 10:17
< >
Изменить комментарий: К данной версии нет комментариев

Комментарий

Подробности

Свойства страницы
Содержимое
... ... @@ -41,7 +41,10 @@
41 41  |CBuild|**string (5)**|Нет|Корпус дома клиента
42 42  |CFlat|**string (5)**|Нет|Номер квартиры клиента
43 43  |CMobTel|**string (15)**|Нет|Мобильный телефон клиента
44 +|CWorkTel|**string (15)**|Нет|Рабочий телефон клиента
45 +|CHomeTel|**string (15)**|Нет|Домашний телефон клиента
44 44  |Cemail|**string (255)**|Нет|Email клиента
47 +|PurchDate|**datetime**|Нет|Дата продажи
45 45  |UrlQuestionnaire|**string**|Нет|URL на анкету для прохождения опроса по завершению ремонта
46 46  
47 47  Выходные параметры:
... ... @@ -101,13 +101,13 @@
101 101  Возвращает справочник мест ремонта.
102 102  
103 103  * (((
104 -== [[GetAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachment]] ==
107 +== [[GetAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachment]] ==
105 105  )))
106 106  
107 107  Возвращает вложение по номеру ремонта АСЦ (OrderNumAsc) и по типу вложения.
108 108  
109 109  * (((
110 -== [[GetAttachmentKeys>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachmentKeys]] ==
113 +== [[GetAttachmentKeys>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachmentKeys]] ==
111 111  )))
112 112  
113 113  Возвращает список вложений по системному номеру трекинга (OrderNum) без самих вложений.
... ... @@ -124,6 +124,23 @@
124 124  
125 125  Возвращает список брендов в разрезе групп брендов.
126 126  
130 +**Входные параметры:**
131 +
132 +Секция message
133 +
134 +|Название параметра|Тип параметра|Обяз?|Описание параметра|Пример
135 +|ticket|**string**|Да|Сессионный ключ|Vasya
136 +
137 +**Выходные параметры:**
138 +
139 +Возвращает коллекцию BrandItem следующего вида:
140 +
141 +|Название параметра|Тип параметра|Описание параметра|Пример
142 +|MainBrandUid|**guid**|Идентификатор группы брендов|7e86699d-50a4-4b5d-8627-f8c8da56f053
143 +|MainBrandName|**string (50)**|Наименование группы брендов|PHILIPS
144 +|BrandUid|**guid**|Идентификатор бренда модели|4f94a810-2f0d-48a0-bbd0-c9617390efd3
145 +|BrandName|**string (50)**|Наименование бренда модели|PHILIPS
146 +
127 127  * (((
128 128  == [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]] ==
129 129  )))
... ... @@ -172,6 +172,186 @@
172 172  
173 173  Возвращает трекинг по номеру ремонта АСЦ (OrderNumAsc)
174 174  
195 +**Входные параметры:**
196 +
197 +|Название параметра|Тип параметра|Обяз?|Описание параметра|Пример
198 +|ticket|**string**|Да|Сессионный ключ|YOB7IG8UG687068
199 +|(((
200 +numberKey
201 +
202 +
203 +)))|**string**|Да|Собственный номер ремонта АСЦ.|1.0.0.0
204 +
205 +**Выходные параметры:**
206 +
207 +**Секция Tracking**
208 +
209 +|Название параметра|Тип параметра|Описание параметра|Пример
210 +|uid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]] в случае, если нужно обновить значения трекинга.|6e18064e-1cd3-4207-8ebe-08c4417db2be
211 +|Brand|**guid**|Группа брендов. Значение берётся из поля MainBrandUid из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b457927a-766e-44b1-a79d-508adee3a915
212 +|Model|**string (50)**|Строка названия модели|121
213 +|OrderNum|**string (50)**|Строка номера ремонта|0000018
214 +|OrderNumBrand|**string (50)**|Номер заявки колл-центра|
215 +|ReceiveDate|**datetime**|Дата получения товара в ремонт|
216 +|ReadyDate|**datetime**|Дата готовности|
217 +|ReadyOutDate|**datetime**|Дата готовности к выдаче|
218 +|OutDate|**datetime**|Дата выдачи|
219 +|PurchDate|**datetime**|Дата покупки|
220 +|SerialNumb|**string (50)**|Серийный номер|
221 +|ProductNumb|**string (50)**|Продуктовый номер|
222 +|EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|2023-04-07T18:16:10.783
223 +|TransportService|**guid**|Вид транспортировки. Значение берётся из [[GetTransportService>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]].|f34fa37d-b678-469d-9129-6ac9d9d270f7
224 +|PlanTransportDate|**datetime**|Плановая дата доставки|
225 +|Status|**guid**|Статус. Значение берётся из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].|51deb04d-b307-4efc-826a-2d0e3d151d1d
226 +|MasterASC|**string (255)**|ФИО мастера|
227 +|CreateDate|**datetime**|Дата создания (в первый раз будет заменена на текущую)|2023-04-03T16:56:20.74
228 +|ComplectPack|**int**|Наличие коробки|
229 +|ComplectWarr|**int**|Наличие гарантийного талона|
230 +|ComplectCheck|**int**|Наличие чека|
231 +|PlanMasterDate|**datetime**|Планируемая дата выезда|
232 +|IsExpRep|**boolean**|Флаг экспресс-ремонта|
233 +|ServiceBulletin|**string (255)**|Сервисный бюллетень|
234 +|ActionPlace|**guid**|Место ремонта. Значение берётся из [[GetActionPlace>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetActionPlace]].|87da8c9b-61d8-4db0-825b-9c39adf1f50b
235 +|DesRepair|**string (3000)**|Заявленная неисправность|test
236 +|DescriptionCC|**string (3000)**|Результат диагностики оператором Call Центра|
237 +|DescriptionCompCent|**string (3000)**|Резюме центра компетенции|
238 +|DiagnosticResult|**string (3000)**|Результат диагностики|
239 +|Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
240 +|Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
241 +|Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]].|
242 +|Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]].|
243 +|Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]].|
244 +|LocationCode|**string (50)**|Позиционный номер|
245 +|DName|**string (255)**|Наименование дилера|
246 +|DCity|**string (255)**|Город дилера|
247 +|DAddress|**string (255)**|Адрес дилера|
248 +|DTel|**string (11)**|Телефон дилера|
249 +|Demail|**string (255)**|Email дилера|
250 +|DComments|**string (500)**|Дополнительная информация дилера|
251 +|CName|**string (255)**|Имя клиента|
252 +|CSurname|**string (255)**|Фамилия клиента|
253 +|CPatronymic|**string (255)**|Отчество клиента|
254 +|CCity|**string (255)**|Город клиента|
255 +|CAddress|**string (255)**|Адрес клиента|
256 +|CHouse|**string (5)**|Номер дома клиента|
257 +|CBuild|**string (5)**|Корпус клиента|
258 +|CFlat|**string (5)**|Номер квартиры клиента|
259 +|CHomeTel|**string (11)**|Домашний телефон клиента|
260 +|CWorkTel|**string (11)**|Рабочий телефон клиента|
261 +|CMobTel|**string (13)**|Мобильный телефон клиента|
262 +|Cemail|**string (255)**|Email клиента|
263 +|CComments|**string (500)**|Дополнительная информация клиента|
264 +|CLift|**int**|Наличие лифта в доме клиента|
265 +|CDomofon|**string (50)**|Код домофона у клиента|
266 +|OrderNumAsc|**string (50)**|Номер ремонта в системе АСЦ|
267 +|StartRepairDate|**datetime**|Дата начала ремонта АСЦ|
268 +|RegularSWnumberIN|**string (255)**|Версия прошивки "Main SW" при поступлении в ремонт|
269 +|RegularSWnumberOUT|**string (255)**|Версия прошивки "Main SW" при выдаче из ремонта|
270 +|StandBySWnumberIN|**string (255)**|Версия прошивки "Stand By SW" при поступлении в ремонт|
271 +|StandBySWnumberOUT|**string (255)**|Версия прошивки "Stand By" при выдаче из ремонта|
272 +|(((
273 +ConditionDescr
274 +
275 +
276 +)))|**string (255)**|Описание Iris кода условия|1-Постоянно
277 +|RepairTypeCurrent|**guid**|Тип ремонта текущий (связь с брендами (Default))|b7a77d5a-e95a-11d9-b44e-000476de6b1e
278 +|RepairTypeStart|**guid**|Тип ремонта начальный (связь с брендами (Default))|
279 +|TransportZone|**guid**|Зона транспортировки. Значение берётся из GetTransportZone.|85df2056-e60f-4bc1-a21c-17c9f6c9241a
280 +|UidNRP|**guid**|Uid акта НРП|
281 +|RealBrand|**guid**|Бренд (торговая марка). Значение берётся из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b8a3f06b-cacf-4a9b-b3f7-089c266ea654
282 +|(((
283 +IWS
284 +
285 +
286 +)))|**string (255)**|Номер IWS|b8a3f06b-cacf-4a9b-b3f7-089c266ea654
287 +|RegionUid|**guid**|Город АСЦ.|
288 +|Recommendation|**string (3000)**|Рекомендации мастера по эксплуатации|
289 +|IMEI1|**string (255)**|IMEI1|
290 +|IMEI2|**string (255)**|IMEI2|
291 +|IMEI3|**string (255)**|IMEI3|
292 +|IMEI4|**string (255)**|IMEI4|
293 +|IMEI1NEW|**string (255)**|IMEI1 новый|
294 +|IMEI2NEW|**string (255)**|IMEI2 новый|
295 +|IMEI3NEW|**string (255)**|IMEI3 новый|
296 +|IMEI4NEW|**string (255)**|IMEI4 новый|
297 +|RepairLevel|**string (300)**|Уровень ремонта|
298 +
299 +Подсекция Parts секции Tracking состоит из коллекции типа PartRecord следующего формата:
300 +
301 +|Название параметра|Тип параметра|Описание параметра|Пример
302 +|uid|**guid**|Уникальный идентификатор детали/з/ч. Значение берётся из предыдущего вызова метода SaveOrder в случае, если нужно обновить значения трекинга.|
303 +|CreateDate|**datetime**|Дата создания (будет заменена на текущую)|
304 +|PartNumber|**string (100)**|ПартНомер|
305 +|PartName|**string (255)**|Наименование детали|
306 +|Price|**decimal**|Цена отгрузки|
307 +|Qnt|**int**|Количество|
308 +|Compensate|**decimal**|Размер компенсации для ASC|
309 +|ASCOrderNo|**string (100)**|№ заказа ACЦ (ссылка на заказ)|
310 +|SPOrderNo|**string (100)**|№ заявки з/ч (проверка при создании акта НРП)|
311 +|OrderCreate|**datetime**|Дата заказа запчасти|
312 +|PrognoseDate|**datetime**|Ожидаемая дата получения з/ч|
313 +|OrderUid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]].|
314 +|AscItemKey|**string (50)**|Внутренний ID детали АСЦ|
315 +|TypeOrder|**guid**|Тип заказчика, в основном пустой или АСЦ|9314B01D-3D61-426C-BCAF-BFDEF25AAA56
316 +|InvoiceNum|**string (50)**|Номер накладной|
317 +|InvoiceDate|**datetime**|Дата накладной|
318 +|InvoiceRef|**guid**|Ссылка на позицию в накладной. Не используется в данное время|
319 +|AscStore|**int**|(((
320 +~=1, если деталь получена АСЦ не у провайдера, а со стороны
321 +
322 +~=0, если получена АСЦ у провайдера.
323 +
324 +Возможность указывать детали своего склада зависит от настроек авторизации по бренду.
325 +)))|
326 +|Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
327 +|Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
328 +|Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]].|
329 +|Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]].|
330 +|Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]].|
331 +|LocationCode|**string (50)**|Позиционный номер|
332 +|EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|
333 +|EditUser|**guid**|Идентификатор пользователя|
334 +|ProblemPartSerial|**string (255)**|Серийный номер неисправной детали|
335 +|SetupPartSerial|**string (255)**|Серийный номер установленной детали|
336 +
337 +**Секция Payment**
338 +
339 +|Название параметра|Тип параметра|Описание параметра|Пример
340 +|uid|**guid**|Идентификатор заказа|00000000-0000-0000-0000-000000000000
341 +|Labor|**decimal**|Стоимость работы|
342 +|BonusASC|**decimal**|Бонус АСЦ|
343 +|Handling|**decimal**|Фиксированный тариф провайдера|
344 +|BonusCSP|**decimal**|Переменное вознаграждение провайдера|
345 +|BonusCSPPercent|**decimal**|Процент ~(% от тарифа) на момент формирования инвойса|
346 +|SU|**decimal**|Оплата доставки з/ч провайдера|
347 +|Transport|**decimal**|Оплата транспортировки/выезда|
348 +|SparePartsASC|**decimal**|Сумма компенсации з/ч АСЦ|
349 +|SparePartsCSP|**decimal**|Сумма компенсации з/ч провайдера|
350 +|AdditionalLabor|**decimal**|Оплата дополнительных работ АСЦ|
351 +|ASCSumm|**decimal**|Итого оплата АСЦ|
352 +|CSPSumm|**decimal**|Итого оплата провайдера|
353 +|TotalSumm|**decimal**|Итого сумма отплаты|
354 +|LaborCSP|**decimal**|Стоимость работы провайдера|
355 +|LaborPSU|**decimal**|Стоимость ремонта PSU|
356 +|LaborSSB|**decimal**|Стоимость ремонта SSB|
357 +|AdditionalLaborTotal|**decimal**|Всего стоимость дополнительных работ|
358 +|BonusASCPercent|**decimal**|Процент бонусов АСЦ|
359 +|SparePartsTotal|**decimal**|Всего стоимость з/ч|
360 +|AdditionalLaborDescr|**String (1000)**|Описание дополнительных работ|
361 +
362 +**Отдельный параметр**
363 +
364 +|Название параметра|Тип параметра|Описание параметра|Пример
365 +|RefUri|**string**|Ссылка на трекинг, которую можно открыть в браузере|
366 +
367 +Секция ValidationErrors содержит коллекцию ErrorItem следующего вида:
368 +
369 +|Название параметра|Тип параметра|Описание параметра|Пример
370 +|ErrorCode|**string**|Код ошибки|43
371 +|ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.|1
372 +|Status|**string**|Статус трекинга|
373 +|Descriptilon|**string**|Описание ошибки|Для продолжения ремонта необходимо ввести, по крайней мере, одну запасную часть
374 +
175 175  * (((
176 176  == [[GetOrderBySysKey>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderBySysKey]] ==
177 177  )))
... ... @@ -178,6 +178,186 @@
178 178  
179 179  Возвращает трекинг по системному номеру (OrderNum).
180 180  
381 +**Входные параметры:**
382 +
383 +|Название параметра|Тип параметра|Обяз?|Описание параметра|Пример
384 +|ticket|**string**|Да|Сессионный ключ|YOB7IG8UG687068
385 +|(((
386 +numberKey
387 +
388 +
389 +)))|**string**|Да|Системный номер ремонта. OrderNum секции трекинг.|1.0.0.0
390 +
391 +**Выходные параметры:**
392 +
393 +**Секция Tracking**
394 +
395 +|Название параметра|Тип параметра|Описание параметра|Пример
396 +|uid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]] в случае, если нужно обновить значения трекинга.|6e18064e-1cd3-4207-8ebe-08c4417db2be
397 +|Brand|**guid**|Группа брендов. Значение берётся из поля MainBrandUid из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b457927a-766e-44b1-a79d-508adee3a915
398 +|Model|**string (50)**|Строка названия модели|121
399 +|OrderNum|**string (50)**|Строка номера ремонта|0000018
400 +|OrderNumBrand|**string (50)**|Номер заявки колл-центра|
401 +|ReceiveDate|**datetime**|Дата получения товара в ремонт|
402 +|ReadyDate|**datetime**|Дата готовности|
403 +|ReadyOutDate|**datetime**|Дата готовности к выдаче|
404 +|OutDate|**datetime**|Дата выдачи|
405 +|PurchDate|**datetime**|Дата покупки|
406 +|SerialNumb|**string (50)**|Серийный номер|
407 +|ProductNumb|**string (50)**|Продуктовый номер|
408 +|EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|2023-04-07T18:16:10.783
409 +|TransportService|**guid**|Вид транспортировки. Значение берётся из [[GetTransportService>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]].|f34fa37d-b678-469d-9129-6ac9d9d270f7
410 +|PlanTransportDate|**datetime**|Плановая дата доставки|
411 +|Status|**guid**|Статус. Значение берётся из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].|51deb04d-b307-4efc-826a-2d0e3d151d1d
412 +|MasterASC|**string (255)**|ФИО мастера|
413 +|CreateDate|**datetime**|Дата создания (в первый раз будет заменена на текущую)|2023-04-03T16:56:20.74
414 +|ComplectPack|**int**|Наличие коробки|
415 +|ComplectWarr|**int**|Наличие гарантийного талона|
416 +|ComplectCheck|**int**|Наличие чека|
417 +|PlanMasterDate|**datetime**|Планируемая дата выезда|
418 +|IsExpRep|**boolean**|Флаг экспресс-ремонта|
419 +|ServiceBulletin|**string (255)**|Сервисный бюллетень|
420 +|ActionPlace|**guid**|Место ремонта. Значение берётся из [[GetActionPlace>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetActionPlace]].|87da8c9b-61d8-4db0-825b-9c39adf1f50b
421 +|DesRepair|**string (3000)**|Заявленная неисправность|test
422 +|DescriptionCC|**string (3000)**|Результат диагностики оператором Call Центра|
423 +|DescriptionCompCent|**string (3000)**|Резюме центра компетенции|
424 +|DiagnosticResult|**string (3000)**|Результат диагностики|
425 +|Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
426 +|Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
427 +|Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]].|
428 +|Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]].|
429 +|Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]].|
430 +|LocationCode|**string (50)**|Позиционный номер|
431 +|DName|**string (255)**|Наименование дилера|
432 +|DCity|**string (255)**|Город дилера|
433 +|DAddress|**string (255)**|Адрес дилера|
434 +|DTel|**string (11)**|Телефон дилера|
435 +|Demail|**string (255)**|Email дилера|
436 +|DComments|**string (500)**|Дополнительная информация дилера|
437 +|CName|**string (255)**|Имя клиента|
438 +|CSurname|**string (255)**|Фамилия клиента|
439 +|CPatronymic|**string (255)**|Отчество клиента|
440 +|CCity|**string (255)**|Город клиента|
441 +|CAddress|**string (255)**|Адрес клиента|
442 +|CHouse|**string (5)**|Номер дома клиента|
443 +|CBuild|**string (5)**|Корпус клиента|
444 +|CFlat|**string (5)**|Номер квартиры клиента|
445 +|CHomeTel|**string (11)**|Домашний телефон клиента|
446 +|CWorkTel|**string (11)**|Рабочий телефон клиента|
447 +|CMobTel|**string (13)**|Мобильный телефон клиента|
448 +|Cemail|**string (255)**|Email клиента|
449 +|CComments|**string (500)**|Дополнительная информация клиента|
450 +|CLift|**int**|Наличие лифта в доме клиента|
451 +|CDomofon|**string (50)**|Код домофона у клиента|
452 +|OrderNumAsc|**string (50)**|Номер ремонта в системе АСЦ|
453 +|StartRepairDate|**datetime**|Дата начала ремонта АСЦ|
454 +|RegularSWnumberIN|**string (255)**|Версия прошивки "Main SW" при поступлении в ремонт|
455 +|RegularSWnumberOUT|**string (255)**|Версия прошивки "Main SW" при выдаче из ремонта|
456 +|StandBySWnumberIN|**string (255)**|Версия прошивки "Stand By SW" при поступлении в ремонт|
457 +|StandBySWnumberOUT|**string (255)**|Версия прошивки "Stand By" при выдаче из ремонта|
458 +|(((
459 +ConditionDescr
460 +
461 +
462 +)))|**string (255)**|Описание Iris кода условия|1-Постоянно
463 +|RepairTypeCurrent|**guid**|Тип ремонта текущий (связь с брендами (Default))|b7a77d5a-e95a-11d9-b44e-000476de6b1e
464 +|RepairTypeStart|**guid**|Тип ремонта начальный (связь с брендами (Default))|
465 +|TransportZone|**guid**|Зона транспортировки. Значение берётся из GetTransportZone.|85df2056-e60f-4bc1-a21c-17c9f6c9241a
466 +|UidNRP|**guid**|Uid акта НРП|
467 +|RealBrand|**guid**|Бренд (торговая марка). Значение берётся из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b8a3f06b-cacf-4a9b-b3f7-089c266ea654
468 +|(((
469 +IWS
470 +
471 +
472 +)))|**string (255)**|Номер IWS|b8a3f06b-cacf-4a9b-b3f7-089c266ea654
473 +|RegionUid|**guid**|Город АСЦ.|
474 +|Recommendation|**string (3000)**|Рекомендации мастера по эксплуатации|
475 +|IMEI1|**string (255)**|IMEI1|
476 +|IMEI2|**string (255)**|IMEI2|
477 +|IMEI3|**string (255)**|IMEI3|
478 +|IMEI4|**string (255)**|IMEI4|
479 +|IMEI1NEW|**string (255)**|IMEI1 новый|
480 +|IMEI2NEW|**string (255)**|IMEI2 новый|
481 +|IMEI3NEW|**string (255)**|IMEI3 новый|
482 +|IMEI4NEW|**string (255)**|IMEI4 новый|
483 +|RepairLevel|**string (300)**|Уровень ремонта|
484 +
485 +Подсекция Parts секции Tracking состоит из коллекции типа PartRecord следующего формата:
486 +
487 +|Название параметра|Тип параметра|Описание параметра|Пример
488 +|uid|**guid**|Уникальный идентификатор детали/з/ч. Значение берётся из предыдущего вызова метода SaveOrder в случае, если нужно обновить значения трекинга.|
489 +|CreateDate|**datetime**|Дата создания (будет заменена на текущую)|
490 +|PartNumber|**string (100)**|ПартНомер|
491 +|PartName|**string (255)**|Наименование детали|
492 +|Price|**decimal**|Цена отгрузки|
493 +|Qnt|**int**|Количество|
494 +|Compensate|**decimal**|Размер компенсации для ASC|
495 +|ASCOrderNo|**string (100)**|№ заказа ACЦ (ссылка на заказ)|
496 +|SPOrderNo|**string (100)**|№ заявки з/ч (проверка при создании акта НРП)|
497 +|OrderCreate|**datetime**|Дата заказа запчасти|
498 +|PrognoseDate|**datetime**|Ожидаемая дата получения з/ч|
499 +|OrderUid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]].|
500 +|AscItemKey|**string (50)**|Внутренний ID детали АСЦ|
501 +|TypeOrder|**guid**|Тип заказчика, в основном пустой или АСЦ|9314B01D-3D61-426C-BCAF-BFDEF25AAA56
502 +|InvoiceNum|**string (50)**|Номер накладной|
503 +|InvoiceDate|**datetime**|Дата накладной|
504 +|InvoiceRef|**guid**|Ссылка на позицию в накладной. Не используется в данное время|
505 +|AscStore|**int**|(((
506 +~=1, если деталь получена АСЦ не у провайдера, а со стороны
507 +
508 +~=0, если получена АСЦ у провайдера.
509 +
510 +Возможность указывать детали своего склада зависит от настроек авторизации по бренду.
511 +)))|
512 +|Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
513 +|Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
514 +|Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]].|
515 +|Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]].|
516 +|Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]].|
517 +|LocationCode|**string (50)**|Позиционный номер|
518 +|EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|
519 +|EditUser|**guid**|Идентификатор пользователя|
520 +|ProblemPartSerial|**string (255)**|Серийный номер неисправной детали|
521 +|SetupPartSerial|**string (255)**|Серийный номер установленной детали|
522 +
523 +**Секция Payment**
524 +
525 +|Название параметра|Тип параметра|Описание параметра|Пример
526 +|uid|**guid**|Идентификатор заказа|00000000-0000-0000-0000-000000000000
527 +|Labor|**decimal**|Стоимость работы|
528 +|BonusASC|**decimal**|Бонус АСЦ|
529 +|Handling|**decimal**|Фиксированный тариф провайдера|
530 +|BonusCSP|**decimal**|Переменное вознаграждение провайдера|
531 +|BonusCSPPercent|**decimal**|Процент ~(% от тарифа) на момент формирования инвойса|
532 +|SU|**decimal**|Оплата доставки з/ч провайдера|
533 +|Transport|**decimal**|Оплата транспортировки/выезда|
534 +|SparePartsASC|**decimal**|Сумма компенсации з/ч АСЦ|
535 +|SparePartsCSP|**decimal**|Сумма компенсации з/ч провайдера|
536 +|AdditionalLabor|**decimal**|Оплата дополнительных работ АСЦ|
537 +|ASCSumm|**decimal**|Итого оплата АСЦ|
538 +|CSPSumm|**decimal**|Итого оплата провайдера|
539 +|TotalSumm|**decimal**|Итого сумма отплаты|
540 +|LaborCSP|**decimal**|Стоимость работы провайдера|
541 +|LaborPSU|**decimal**|Стоимость ремонта PSU|
542 +|LaborSSB|**decimal**|Стоимость ремонта SSB|
543 +|AdditionalLaborTotal|**decimal**|Всего стоимость дополнительных работ|
544 +|BonusASCPercent|**decimal**|Процент бонусов АСЦ|
545 +|SparePartsTotal|**decimal**|Всего стоимость з/ч|
546 +|AdditionalLaborDescr|**String (1000)**|Описание дополнительных работ|
547 +
548 +**Отдельный параметр**
549 +
550 +|Название параметра|Тип параметра|Описание параметра|Пример
551 +|RefUri|**string**|Ссылка на трекинг, которую можно открыть в браузере|
552 +
553 +Секция ValidationErrors содержит коллекцию ErrorItem следующего вида:
554 +
555 +|Название параметра|Тип параметра|Описание параметра|Пример
556 +|ErrorCode|**string**|Код ошибки|43
557 +|ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.|1
558 +|Status|**string**|Статус трекинга|
559 +|Descriptilon|**string**|Описание ошибки|Для продолжения ремонта необходимо ввести, по крайней мере, одну запасную часть
560 +
181 181  * (((
182 182  == [[GetOrderKeys>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderKeys]] ==
183 183  )))
... ... @@ -184,6 +184,24 @@
184 184  
185 185  Возвращает список трекингов, перешедших в конечный статус в последние 35 дней и всех остальных, не перешедших в конечный статус.
186 186  
567 +Входные параметры:
568 +
569 +|(% style="width:180px" %)Название параметра|(% style="width:141px" %)Тип параметра|(% style="width:79px" %)Обяз.|(% style="width:415px" %)Описание параметра|(% style="width:168px" %)Пример
570 +|(% style="width:180px" %)ticket|(% style="width:141px" %)**string**|(% style="width:79px" %)Да|(% style="width:415px" %)Сессионный ключ|(% style="width:168px" %)YOB7IG8UG687068
571 +
572 +Выходные параметры:
573 +
574 +Возвращает коллекцию TrackingShortItem следующего вида:
575 +
576 +|Название параметра|Тип параметра|Описание параметра|Пример
577 +|Uid|**guid**|Идентификатор ремонта|bf181853-8a82-4d7a-91b0-002e1105fe10
578 +|NumKey|**string (50)**|Код ремонта в системе|ET0000001
579 +|AscKey|**string (50)**|Код АСЦ ремонта|11947
580 +|Status|**guid**|Статус. Значения из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]]|574fa171-5482-4979-be0f-117a3dd0dd29
581 +|LastEditDate|**dateTime**|Дата последнего редактирования ремонта|2015-03-17T15:41:39.923
582 +|MainBrandUid|**guid**|Идентификатор группы брендов. Значения из поля MainBrandUid из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]]|b457927a-766e-44b1-a79d-508adee3a915
583 +|BrandUid|**guid**|Идентификатор бренда модели. Значения из поля BrandUid из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]]|318c5448-3632-413e-ba36-16a95d85bb26
584 +
187 187  * (((
188 188  == [[GetRejectReasons>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetRejectReasons]] ==
189 189  )))
... ... @@ -191,11 +191,27 @@
191 191  Список причин отмены трекинга
192 192  
193 193  * (((
194 -== [[GetSpRepairTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpRepairTypes]] ==
592 +== [[GetSpRepairTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpRepairTypes]] ==
195 195  )))
196 196  
197 197  Возвращает справочник типов ремонтов по группе брендов (MainBrandUid).
198 198  
597 +**Входные параметры:**
598 +
599 +|Название параметра|Тип параметра|Обяз?|Описание параметра|Пример
600 +|MainBrandUid|**guid**|Да|Ссылка на группу брендов, возвращаемую методом GetBrands|
601 +|ticket|**string**|Да|Сессионный ключ|srry8gJT2TJNZzckI6vGWwiRGZ6BcurM
602 +
603 +**Выходные параметры:**
604 +
605 +Возвращает коллекцию RefItem следующего вида:
606 +
607 +|Название параметра|Тип параметра|Описание параметра|Пример
608 +|Uid|**guid**|Идентификатор типа ремонта|b7a77d5a-e95a-11d9-b44e-000476de6b1e
609 +|Name|**string (255)**|Наименование типа ремонта|Гарантийный ремонт
610 +|Id|**int**|Id типа ремонта|
611 +|Description|**string**|Описание типа ремонта|
612 +
199 199  * (((
200 200  == [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]] ==
201 201  )))
... ... @@ -202,6 +202,21 @@
202 202  
203 203  Возвращает список статусов трекинга.
204 204  
619 +**Входные параметры:**
620 +
621 +|Название параметра|Тип параметра|Обяз.|Описание параметра|Пример
622 +|ticket|**string**|Да|Сессионный ключ|srry8gJT2TJNZzckI6vGWwiRGZ6BcurM
623 +
624 +**Выходные параметры:**
625 +
626 +Возвращает коллекцию StatusItem следующего вида:
627 +
628 +|Название параметра|Тип параметра|Описание параметра|Пример
629 +|Uid|**guid**|Идентификатор статуса|574fa171-5482-4979-be0f-117a3dd0dd29
630 +|Name|**string (255)**|Наименование статуса|23005
631 +|Description|**string (100)**|Описание статуса|ОТЧЕТ
632 +|IsEnd|**boolean**|Является ли статус конечным|false
633 +
205 205  * (((
206 206  == [[GetTicket>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTicket]] ==
207 207  )))
... ... @@ -208,6 +208,17 @@
208 208  
209 209  Получение бинарного идентификатора для аутентификации пользователя по логину и паролю.
210 210  
640 +Входные параметры:
641 +
642 +|(% style="width:206px" %)Название параметра|(% style="width:130px" %)Тип параметра|(% style="width:70px" %)Обяз.|(% style="width:234px" %)Описание параметра|(% style="width:343px" %)Пример
643 +|(% style="width:206px" %)Login|(% style="width:130px" %)**string**|(% style="width:70px" %)Да|(% style="width:234px" %)Логин пользователя|(% style="width:343px" %)Vasya
644 +|(% style="width:206px" %)Password|(% style="width:130px" %)**string**|(% style="width:70px" %)Да|(% style="width:234px" %)Пароль пользователя|(% style="width:343px" %)123456
645 +
646 +Возвращаемое значение:
647 +
648 +|Тип параметра|Описание параметра|Пример
649 +|string|Сессионный ключ|YOB7IG8UG687068
650 +
211 211  * (((
212 212  == [[GetTransportService>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]] ==
213 213  )))
... ... @@ -232,6 +232,46 @@
232 232  
233 233  Создание/обновление трекинга.
234 234  
675 +Входные параметры:
676 +
677 +|Название параметра|Тип параметра|Обяз?|Описание параметра|Пример
678 +|ticket|**string**|Да|Сессионный ключ|YOB7IG8UG687068
679 +|record|**TrackingRecord**|Да|(((
680 +структура содержащая данные, идентична секции Tracking в методе [[GetOrderBySysKey>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderBySysKey]]
681 +)))|
682 +
683 +Выходные параметры:
684 +
685 +|Название параметра|Тип параметра|Описание параметра|Пример
686 +|TrackingUid|**guid**|Уникальный идентификатор трекинга. Значение можно использовать для дальнейших вызовов метода SaveOrder, если нужно обновить значения трекинга.|
687 +|SysNum|**string**|Системный номер трекинга (учётный номер ремонта в системе)|
688 +|StatusName|**string**|Статус трекинга|
689 +|StatusUid|**guid**|UID статуса трекинга. Значение берётся из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].|
690 +|Result|**Added** or **Changed** or **NotFound** or **Error** or **Unknown**|(((
691 +Результат выполнения операции:
692 +
693 +Added – трекинг создан и помещён в базу
694 +
695 +Changed – трекинг изменён
696 +
697 +NotFound – трекинг не найден по uid
698 +
699 +Error – ошибка в работе метода
700 +
701 +Unknown – неизвестная ошибка
702 +)))|Added
703 +|TrackingUri|**string**|Ссылка на трекинг, которую можно открыть в браузере|
704 +
705 +Секция Errors содержит коллекцию строк ошибок.
706 +
707 +Секция ValidationErrors содержит коллекцию ErrorItem следующего вида:
708 +
709 +|Название параметра|Тип параметра|Описание параметра|Пример
710 +|ErrorCode|**string**|Код ошибки|
711 +|ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.|
712 +|Status|**string**|Статус трекинга|
713 +|Descriptilon|**string**|Описание ошибки|
714 +
235 235  = Порядок вызова методов и работы с сервисом =
236 236  
237 237  1. Для начала работы требуется аутентифицироваться. Для этого нужно вызвать метод [[GetTicket>>path:#_heading=h.1fob9te]] с параметрами login и password и получить в ответ ticket. Он используются для вызова других методов сервиса. В качестве пользователя может использоваться любой созданный на сайте аккаунт с доступом к созданию трекинга.