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

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

Комментарий

Подробности

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