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

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

Комментарий

Подробности

Свойства страницы
Содержимое
... ... @@ -172,6 +172,186 @@
172 172  
173 173  Возвращает трекинг по номеру ремонта АСЦ (OrderNumAsc)
174 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 +
175 175  * (((
176 176  == [[GetOrderBySysKey>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderBySysKey]] ==
177 177  )))
... ... @@ -224,9 +224,9 @@
224 224  |DiagnosticResult|**string (3000)**|Результат диагностики|
225 225  |Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
226 226  |Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
227 -|Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>path:#_heading=h.78vvoirxywim]].|
228 -|Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>path:#_heading=h.yoy5sp5fg7is]].|
229 -|Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://getirisrepaircodes]].|
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]].|
230 230  |LocationCode|**string (50)**|Позиционный номер|
231 231  |DName|**string (255)**|Наименование дилера|
232 232  |DCity|**string (255)**|Город дилера|
... ... @@ -311,9 +311,9 @@
311 311  )))|
312 312  |Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
313 313  |Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
314 -|Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>path:#_heading=h.78vvoirxywim]].|
315 -|Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>path:#_heading=h.yoy5sp5fg7is]].|
316 -|Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>path:#_heading=h.5yv1vdf6s1yh]].|
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]].|
317 317  |LocationCode|**string (50)**|Позиционный номер|
318 318  |EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|
319 319  |EditUser|**guid**|Идентификатор пользователя|
... ... @@ -441,6 +441,48 @@
441 441  
442 442  Создание/обновление трекинга.
443 443  
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 +
444 444  = Порядок вызова методов и работы с сервисом =
445 445  
446 446  1. Для начала работы требуется аутентифицироваться. Для этого нужно вызвать метод [[GetTicket>>path:#_heading=h.1fob9te]] с параметрами login и password и получить в ответ ticket. Он используются для вызова других методов сервиса. В качестве пользователя может использоваться любой созданный на сайте аккаунт с доступом к созданию трекинга.