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

Редактировал(а) Дмитрий Семёнов 2025/04/10 15:52

От версии < 6.1 >

отредактировано Григорий Лепёшкин
на 2023/12/21 15:04

К версии < 9.1 >

отредактировано Григорий Лепёшкин
на 2023/12/21 17:18

< >

Изменить комментарий: К данной версии нет комментариев

Необработанный
Обработанный

Комментарий

Свойства страницы (1 изменено, 0 добавлено, 0 удалено)

Подробности

Свойства страницы

Содержимое

@@ -101,13
          +101,13 @@
  Возвращает справочник мест ремонта.
  * (((
--== [[GetAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachment]]  ==
++== [[GetAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachment]] ==
  )))
  Возвращает вложение по номеру ремонта АСЦ (OrderNumAsc) и по типу вложения.
  * (((
--== [[GetAttachmentKeys>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachmentKeys]]  ==
++== [[GetAttachmentKeys>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachmentKeys]] ==
  )))
  Возвращает список вложений по системному номеру трекинга (OrderNum) без самих вложений.
@@ -172,6
          +172,186 @@
  Возвращает трекинг по номеру ремонта АСЦ (OrderNumAsc)
++**Входные параметры:**
++
++|Название параметра|Тип параметра|Обяз?|Описание параметра|Пример
++|ticket|**string**|Да|Сессионный ключ|YOB7IG8UG687068
++|(((
++numberKey
++
++
++)))|**string**|Да|Собственный номер ремонта АСЦ.|1.0.0.0
++
++**Выходные параметры:**
++
++**Секция Tracking**
++
++|Название параметра|Тип параметра|Описание параметра|Пример
++|uid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]] в случае, если нужно обновить значения трекинга.|6e18064e-1cd3-4207-8ebe-08c4417db2be
++|Brand|**guid**|Группа брендов. Значение берётся из поля MainBrandUid из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b457927a-766e-44b1-a79d-508adee3a915
++|Model|**string (50)**|Строка названия модели|121
++|OrderNum|**string (50)**|Строка номера ремонта|0000018
++|OrderNumBrand|**string (50)**|Номер заявки колл-центра|
++|ReceiveDate|**datetime**|Дата получения товара в ремонт|
++|ReadyDate|**datetime**|Дата готовности|
++|ReadyOutDate|**datetime**|Дата готовности к выдаче|
++|OutDate|**datetime**|Дата выдачи|
++|PurchDate|**datetime**|Дата покупки|
++|SerialNumb|**string (50)**|Серийный номер|
++|ProductNumb|**string (50)**|Продуктовый номер|
++|EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|2023-04-07T18:16:10.783
++|TransportService|**guid**|Вид транспортировки. Значение берётся из [[GetTransportService>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]].|f34fa37d-b678-469d-9129-6ac9d9d270f7
++|PlanTransportDate|**datetime**|Плановая дата доставки|
++|Status|**guid**|Статус. Значение берётся из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].|51deb04d-b307-4efc-826a-2d0e3d151d1d
++|MasterASC|**string (255)**|ФИО мастера|
++|CreateDate|**datetime**|Дата создания (в первый раз будет заменена на текущую)|2023-04-03T16:56:20.74
++|ComplectPack|**int**|Наличие коробки|
++|ComplectWarr|**int**|Наличие гарантийного талона|
++|ComplectCheck|**int**|Наличие чека|
++|PlanMasterDate|**datetime**|Планируемая дата выезда|
++|IsExpRep|**boolean**|Флаг экспресс-ремонта|
++|ServiceBulletin|**string (255)**|Сервисный бюллетень|
++|ActionPlace|**guid**|Место ремонта. Значение берётся из [[GetActionPlace>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetActionPlace]].|87da8c9b-61d8-4db0-825b-9c39adf1f50b
++|DesRepair|**string (3000)**|Заявленная неисправность|test
++|DescriptionCC|**string (3000)**|Результат диагностики оператором Call Центра|
++|DescriptionCompCent|**string (3000)**|Резюме центра компетенции|
++|DiagnosticResult|**string (3000)**|Результат диагностики|
++|Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
++|Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
++|Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]].|
++|Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]].|
++|Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]].|
++|LocationCode|**string (50)**|Позиционный номер|
++|DName|**string (255)**|Наименование дилера|
++|DCity|**string (255)**|Город дилера|
++|DAddress|**string (255)**|Адрес дилера|
++|DTel|**string (11)**|Телефон дилера|
++|Demail|**string (255)**|Email дилера|
++|DComments|**string (500)**|Дополнительная информация дилера|
++|CName|**string (255)**|Имя клиента|
++|CSurname|**string (255)**|Фамилия клиента|
++|CPatronymic|**string (255)**|Отчество клиента|
++|CCity|**string (255)**|Город клиента|
++|CAddress|**string (255)**|Адрес клиента|
++|CHouse|**string (5)**|Номер дома клиента|
++|CBuild|**string (5)**|Корпус клиента|
++|CFlat|**string (5)**|Номер квартиры клиента|
++|CHomeTel|**string (11)**|Домашний телефон клиента|
++|CWorkTel|**string (11)**|Рабочий телефон клиента|
++|CMobTel|**string (13)**|Мобильный телефон клиента|
++|Cemail|**string (255)**|Email клиента|
++|CComments|**string (500)**|Дополнительная информация клиента|
++|CLift|**int**|Наличие лифта в доме клиента|
++|CDomofon|**string (50)**|Код домофона у клиента|
++|OrderNumAsc|**string (50)**|Номер ремонта в системе АСЦ|
++|StartRepairDate|**datetime**|Дата начала ремонта АСЦ|
++|RegularSWnumberIN|**string (255)**|Версия прошивки "Main SW" при поступлении в ремонт|
++|RegularSWnumberOUT|**string (255)**|Версия прошивки "Main SW" при выдаче из ремонта|
++|StandBySWnumberIN|**string (255)**|Версия прошивки "Stand By SW" при поступлении в ремонт|
++|StandBySWnumberOUT|**string (255)**|Версия прошивки "Stand By" при выдаче из ремонта|
++|(((
++ConditionDescr
++
++
++)))|**string (255)**|Описание Iris кода условия|1-Постоянно
++|RepairTypeCurrent|**guid**|Тип ремонта текущий (связь с брендами (Default))|b7a77d5a-e95a-11d9-b44e-000476de6b1e
++|RepairTypeStart|**guid**|Тип ремонта начальный (связь с брендами (Default))|
++|TransportZone|**guid**|Зона транспортировки. Значение берётся из GetTransportZone.|85df2056-e60f-4bc1-a21c-17c9f6c9241a
++|UidNRP|**guid**|Uid акта НРП|
++|RealBrand|**guid**|Бренд (торговая марка). Значение берётся из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b8a3f06b-cacf-4a9b-b3f7-089c266ea654
++|(((
++IWS
++
++
++)))|**string (255)**|Номер IWS|b8a3f06b-cacf-4a9b-b3f7-089c266ea654
++|RegionUid|**guid**|Город АСЦ.|
++|Recommendation|**string (3000)**|Рекомендации мастера по эксплуатации|
++|IMEI1|**string (255)**|IMEI1|
++|IMEI2|**string (255)**|IMEI2|
++|IMEI3|**string (255)**|IMEI3|
++|IMEI4|**string (255)**|IMEI4|
++|IMEI1NEW|**string (255)**|IMEI1 новый|
++|IMEI2NEW|**string (255)**|IMEI2 новый|
++|IMEI3NEW|**string (255)**|IMEI3 новый|
++|IMEI4NEW|**string (255)**|IMEI4 новый|
++|RepairLevel|**string (300)**|Уровень ремонта|
++
++Подсекция Parts секции Tracking состоит из коллекции типа PartRecord следующего формата:
++
++|Название параметра|Тип параметра|Описание параметра|Пример
++|uid|**guid**|Уникальный идентификатор детали/з/ч. Значение берётся из предыдущего вызова метода SaveOrder в случае, если нужно обновить значения трекинга.|
++|CreateDate|**datetime**|Дата создания (будет заменена на текущую)|
++|PartNumber|**string (100)**|ПартНомер|
++|PartName|**string (255)**|Наименование детали|
++|Price|**decimal**|Цена отгрузки|
++|Qnt|**int**|Количество|
++|Compensate|**decimal**|Размер компенсации для ASC|
++|ASCOrderNo|**string (100)**|№ заказа ACЦ (ссылка на заказ)|
++|SPOrderNo|**string (100)**|№ заявки з/ч (проверка при создании акта НРП)|
++|OrderCreate|**datetime**|Дата заказа запчасти|
++|PrognoseDate|**datetime**|Ожидаемая дата получения з/ч|
++|OrderUid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]].|
++|AscItemKey|**string (50)**|Внутренний ID детали АСЦ|
++|TypeOrder|**guid**|Тип заказчика, в основном пустой или АСЦ|9314B01D-3D61-426C-BCAF-BFDEF25AAA56
++|InvoiceNum|**string (50)**|Номер накладной|
++|InvoiceDate|**datetime**|Дата накладной|
++|InvoiceRef|**guid**|Ссылка на позицию в накладной. Не используется в данное время|
++|AscStore|**int**|(((
++~=1, если деталь получена АСЦ не у провайдера, а со стороны
++
++~=0, если получена АСЦ у провайдера.
++
++Возможность указывать детали своего склада зависит от настроек авторизации по бренду.
++)))|
++|Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
++|Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
++|Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]].|
++|Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]].|
++|Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]].|
++|LocationCode|**string (50)**|Позиционный номер|
++|EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|
++|EditUser|**guid**|Идентификатор пользователя|
++|ProblemPartSerial|**string (255)**|Серийный номер неисправной детали|
++|SetupPartSerial|**string (255)**|Серийный номер установленной детали|
++
++**Секция Payment**
++
++|Название параметра|Тип параметра|Описание параметра|Пример
++|uid|**guid**|Идентификатор заказа|00000000-0000-0000-0000-000000000000
++|Labor|**decimal**|Стоимость работы|
++|BonusASC|**decimal**|Бонус АСЦ|
++|Handling|**decimal**|Фиксированный тариф провайдера|
++|BonusCSP|**decimal**|Переменное вознаграждение провайдера|
++|BonusCSPPercent|**decimal**|Процент ~(% от тарифа) на момент формирования инвойса|
++|SU|**decimal**|Оплата доставки з/ч провайдера|
++|Transport|**decimal**|Оплата транспортировки/выезда|
++|SparePartsASC|**decimal**|Сумма компенсации з/ч АСЦ|
++|SparePartsCSP|**decimal**|Сумма компенсации з/ч провайдера|
++|AdditionalLabor|**decimal**|Оплата дополнительных работ АСЦ|
++|ASCSumm|**decimal**|Итого оплата АСЦ|
++|CSPSumm|**decimal**|Итого оплата провайдера|
++|TotalSumm|**decimal**|Итого сумма отплаты|
++|LaborCSP|**decimal**|Стоимость работы провайдера|
++|LaborPSU|**decimal**|Стоимость ремонта PSU|
++|LaborSSB|**decimal**|Стоимость ремонта SSB|
++|AdditionalLaborTotal|**decimal**|Всего стоимость дополнительных работ|
++|BonusASCPercent|**decimal**|Процент бонусов АСЦ|
++|SparePartsTotal|**decimal**|Всего стоимость з/ч|
++|AdditionalLaborDescr|**String (1000)**|Описание дополнительных работ|
++
++**Отдельный параметр**
++
++|Название параметра|Тип параметра|Описание параметра|Пример
++|RefUri|**string**|Ссылка на трекинг, которую можно открыть в браузере|
++
++Секция ValidationErrors содержит коллекцию ErrorItem следующего вида:
++
++|Название параметра|Тип параметра|Описание параметра|Пример
++|ErrorCode|**string**|Код ошибки|43
++|ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.|1
++|Status|**string**|Статус трекинга|
++|Descriptilon|**string**|Описание ошибки|Для продолжения ремонта необходимо ввести, по крайней мере, одну запасную часть
++
  * (((
  == [[GetOrderBySysKey>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderBySysKey]] ==
  )))
@@ -178,6
          +178,186 @@
  Возвращает трекинг по системному номеру (OrderNum).
++**Входные параметры:**
++
++|Название параметра|Тип параметра|Обяз?|Описание параметра|Пример
++|ticket|**string**|Да|Сессионный ключ|YOB7IG8UG687068
++|(((
++numberKey
++
++
++)))|**string**|Да|Системный номер ремонта. OrderNum секции трекинг.|1.0.0.0
++
++**Выходные параметры:**
++
++**Секция Tracking**
++
++|Название параметра|Тип параметра|Описание параметра|Пример
++|uid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]] в случае, если нужно обновить значения трекинга.|6e18064e-1cd3-4207-8ebe-08c4417db2be
++|Brand|**guid**|Группа брендов. Значение берётся из поля MainBrandUid из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b457927a-766e-44b1-a79d-508adee3a915
++|Model|**string (50)**|Строка названия модели|121
++|OrderNum|**string (50)**|Строка номера ремонта|0000018
++|OrderNumBrand|**string (50)**|Номер заявки колл-центра|
++|ReceiveDate|**datetime**|Дата получения товара в ремонт|
++|ReadyDate|**datetime**|Дата готовности|
++|ReadyOutDate|**datetime**|Дата готовности к выдаче|
++|OutDate|**datetime**|Дата выдачи|
++|PurchDate|**datetime**|Дата покупки|
++|SerialNumb|**string (50)**|Серийный номер|
++|ProductNumb|**string (50)**|Продуктовый номер|
++|EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|2023-04-07T18:16:10.783
++|TransportService|**guid**|Вид транспортировки. Значение берётся из [[GetTransportService>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]].|f34fa37d-b678-469d-9129-6ac9d9d270f7
++|PlanTransportDate|**datetime**|Плановая дата доставки|
++|Status|**guid**|Статус. Значение берётся из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].|51deb04d-b307-4efc-826a-2d0e3d151d1d
++|MasterASC|**string (255)**|ФИО мастера|
++|CreateDate|**datetime**|Дата создания (в первый раз будет заменена на текущую)|2023-04-03T16:56:20.74
++|ComplectPack|**int**|Наличие коробки|
++|ComplectWarr|**int**|Наличие гарантийного талона|
++|ComplectCheck|**int**|Наличие чека|
++|PlanMasterDate|**datetime**|Планируемая дата выезда|
++|IsExpRep|**boolean**|Флаг экспресс-ремонта|
++|ServiceBulletin|**string (255)**|Сервисный бюллетень|
++|ActionPlace|**guid**|Место ремонта. Значение берётся из [[GetActionPlace>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetActionPlace]].|87da8c9b-61d8-4db0-825b-9c39adf1f50b
++|DesRepair|**string (3000)**|Заявленная неисправность|test
++|DescriptionCC|**string (3000)**|Результат диагностики оператором Call Центра|
++|DescriptionCompCent|**string (3000)**|Резюме центра компетенции|
++|DiagnosticResult|**string (3000)**|Результат диагностики|
++|Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
++|Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
++|Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]].|
++|Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]].|
++|Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]].|
++|LocationCode|**string (50)**|Позиционный номер|
++|DName|**string (255)**|Наименование дилера|
++|DCity|**string (255)**|Город дилера|
++|DAddress|**string (255)**|Адрес дилера|
++|DTel|**string (11)**|Телефон дилера|
++|Demail|**string (255)**|Email дилера|
++|DComments|**string (500)**|Дополнительная информация дилера|
++|CName|**string (255)**|Имя клиента|
++|CSurname|**string (255)**|Фамилия клиента|
++|CPatronymic|**string (255)**|Отчество клиента|
++|CCity|**string (255)**|Город клиента|
++|CAddress|**string (255)**|Адрес клиента|
++|CHouse|**string (5)**|Номер дома клиента|
++|CBuild|**string (5)**|Корпус клиента|
++|CFlat|**string (5)**|Номер квартиры клиента|
++|CHomeTel|**string (11)**|Домашний телефон клиента|
++|CWorkTel|**string (11)**|Рабочий телефон клиента|
++|CMobTel|**string (13)**|Мобильный телефон клиента|
++|Cemail|**string (255)**|Email клиента|
++|CComments|**string (500)**|Дополнительная информация клиента|
++|CLift|**int**|Наличие лифта в доме клиента|
++|CDomofon|**string (50)**|Код домофона у клиента|
++|OrderNumAsc|**string (50)**|Номер ремонта в системе АСЦ|
++|StartRepairDate|**datetime**|Дата начала ремонта АСЦ|
++|RegularSWnumberIN|**string (255)**|Версия прошивки "Main SW" при поступлении в ремонт|
++|RegularSWnumberOUT|**string (255)**|Версия прошивки "Main SW" при выдаче из ремонта|
++|StandBySWnumberIN|**string (255)**|Версия прошивки "Stand By SW" при поступлении в ремонт|
++|StandBySWnumberOUT|**string (255)**|Версия прошивки "Stand By" при выдаче из ремонта|
++|(((
++ConditionDescr
++
++
++)))|**string (255)**|Описание Iris кода условия|1-Постоянно
++|RepairTypeCurrent|**guid**|Тип ремонта текущий (связь с брендами (Default))|b7a77d5a-e95a-11d9-b44e-000476de6b1e
++|RepairTypeStart|**guid**|Тип ремонта начальный (связь с брендами (Default))|
++|TransportZone|**guid**|Зона транспортировки. Значение берётся из GetTransportZone.|85df2056-e60f-4bc1-a21c-17c9f6c9241a
++|UidNRP|**guid**|Uid акта НРП|
++|RealBrand|**guid**|Бренд (торговая марка). Значение берётся из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b8a3f06b-cacf-4a9b-b3f7-089c266ea654
++|(((
++IWS
++
++
++)))|**string (255)**|Номер IWS|b8a3f06b-cacf-4a9b-b3f7-089c266ea654
++|RegionUid|**guid**|Город АСЦ.|
++|Recommendation|**string (3000)**|Рекомендации мастера по эксплуатации|
++|IMEI1|**string (255)**|IMEI1|
++|IMEI2|**string (255)**|IMEI2|
++|IMEI3|**string (255)**|IMEI3|
++|IMEI4|**string (255)**|IMEI4|
++|IMEI1NEW|**string (255)**|IMEI1 новый|
++|IMEI2NEW|**string (255)**|IMEI2 новый|
++|IMEI3NEW|**string (255)**|IMEI3 новый|
++|IMEI4NEW|**string (255)**|IMEI4 новый|
++|RepairLevel|**string (300)**|Уровень ремонта|
++
++Подсекция Parts секции Tracking состоит из коллекции типа PartRecord следующего формата:
++
++|Название параметра|Тип параметра|Описание параметра|Пример
++|uid|**guid**|Уникальный идентификатор детали/з/ч. Значение берётся из предыдущего вызова метода SaveOrder в случае, если нужно обновить значения трекинга.|
++|CreateDate|**datetime**|Дата создания (будет заменена на текущую)|
++|PartNumber|**string (100)**|ПартНомер|
++|PartName|**string (255)**|Наименование детали|
++|Price|**decimal**|Цена отгрузки|
++|Qnt|**int**|Количество|
++|Compensate|**decimal**|Размер компенсации для ASC|
++|ASCOrderNo|**string (100)**|№ заказа ACЦ (ссылка на заказ)|
++|SPOrderNo|**string (100)**|№ заявки з/ч (проверка при создании акта НРП)|
++|OrderCreate|**datetime**|Дата заказа запчасти|
++|PrognoseDate|**datetime**|Ожидаемая дата получения з/ч|
++|OrderUid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]].|
++|AscItemKey|**string (50)**|Внутренний ID детали АСЦ|
++|TypeOrder|**guid**|Тип заказчика, в основном пустой или АСЦ|9314B01D-3D61-426C-BCAF-BFDEF25AAA56
++|InvoiceNum|**string (50)**|Номер накладной|
++|InvoiceDate|**datetime**|Дата накладной|
++|InvoiceRef|**guid**|Ссылка на позицию в накладной. Не используется в данное время|
++|AscStore|**int**|(((
++~=1, если деталь получена АСЦ не у провайдера, а со стороны
++
++~=0, если получена АСЦ у провайдера.
++
++Возможность указывать детали своего склада зависит от настроек авторизации по бренду.
++)))|
++|Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
++|Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
++|Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]].|
++|Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]].|
++|Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]].|
++|LocationCode|**string (50)**|Позиционный номер|
++|EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|
++|EditUser|**guid**|Идентификатор пользователя|
++|ProblemPartSerial|**string (255)**|Серийный номер неисправной детали|
++|SetupPartSerial|**string (255)**|Серийный номер установленной детали|
++
++**Секция Payment**
++
++|Название параметра|Тип параметра|Описание параметра|Пример
++|uid|**guid**|Идентификатор заказа|00000000-0000-0000-0000-000000000000
++|Labor|**decimal**|Стоимость работы|
++|BonusASC|**decimal**|Бонус АСЦ|
++|Handling|**decimal**|Фиксированный тариф провайдера|
++|BonusCSP|**decimal**|Переменное вознаграждение провайдера|
++|BonusCSPPercent|**decimal**|Процент ~(% от тарифа) на момент формирования инвойса|
++|SU|**decimal**|Оплата доставки з/ч провайдера|
++|Transport|**decimal**|Оплата транспортировки/выезда|
++|SparePartsASC|**decimal**|Сумма компенсации з/ч АСЦ|
++|SparePartsCSP|**decimal**|Сумма компенсации з/ч провайдера|
++|AdditionalLabor|**decimal**|Оплата дополнительных работ АСЦ|
++|ASCSumm|**decimal**|Итого оплата АСЦ|
++|CSPSumm|**decimal**|Итого оплата провайдера|
++|TotalSumm|**decimal**|Итого сумма отплаты|
++|LaborCSP|**decimal**|Стоимость работы провайдера|
++|LaborPSU|**decimal**|Стоимость ремонта PSU|
++|LaborSSB|**decimal**|Стоимость ремонта SSB|
++|AdditionalLaborTotal|**decimal**|Всего стоимость дополнительных работ|
++|BonusASCPercent|**decimal**|Процент бонусов АСЦ|
++|SparePartsTotal|**decimal**|Всего стоимость з/ч|
++|AdditionalLaborDescr|**String (1000)**|Описание дополнительных работ|
++
++**Отдельный параметр**
++
++|Название параметра|Тип параметра|Описание параметра|Пример
++|RefUri|**string**|Ссылка на трекинг, которую можно открыть в браузере|
++
++Секция ValidationErrors содержит коллекцию ErrorItem следующего вида:
++
++|Название параметра|Тип параметра|Описание параметра|Пример
++|ErrorCode|**string**|Код ошибки|43
++|ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.|1
++|Status|**string**|Статус трекинга|
++|Descriptilon|**string**|Описание ошибки|Для продолжения ремонта необходимо ввести, по крайней мере, одну запасную часть
++
  * (((
  == [[GetOrderKeys>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderKeys]] ==
  )))
@@ -184,6
          +184,24 @@
  Возвращает список трекингов, перешедших в конечный статус в последние 35 дней и всех остальных, не перешедших в конечный статус.
++Входные параметры:
++
++|(% style="width:180px" %)Название параметра|(% style="width:141px" %)Тип параметра|(% style="width:79px" %)Обяз.|(% style="width:415px" %)Описание параметра|(% style="width:168px" %)Пример
++|(% style="width:180px" %)ticket|(% style="width:141px" %)**string**|(% style="width:79px" %)Да|(% style="width:415px" %)Сессионный ключ|(% style="width:168px" %)YOB7IG8UG687068
++
++Выходные параметры:
++
++Возвращает коллекцию TrackingShortItem следующего вида:
++
++|Название параметра|Тип параметра|Описание параметра|Пример
++|Uid|**guid**|Идентификатор ремонта|bf181853-8a82-4d7a-91b0-002e1105fe10
++|NumKey|**string (50)**|Код ремонта в системе|ET0000001
++|AscKey|**string (50)**|Код АСЦ ремонта|11947
++|Status|**guid**|Статус. Значения из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]]|574fa171-5482-4979-be0f-117a3dd0dd29
++|LastEditDate|**dateTime**|Дата последнего редактирования ремонта|2015-03-17T15:41:39.923
++|MainBrandUid|**guid**|Идентификатор группы брендов. Значения из поля MainBrandUid из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]]|b457927a-766e-44b1-a79d-508adee3a915
++|BrandUid|**guid**|Идентификатор бренда модели. Значения из поля BrandUid из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]]|318c5448-3632-413e-ba36-16a95d85bb26
++
  * (((
  == [[GetRejectReasons>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetRejectReasons]] ==
  )))
@@ -191,7
          +191,7 @@
  Список причин отмены трекинга
  * (((
--== [[GetSpRepairTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpRepairTypes]]  ==
++== [[GetSpRepairTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpRepairTypes]] ==
  )))
  Возвращает справочник типов ремонтов по группе брендов (MainBrandUid).
@@ -208,6
          +208,17 @@
  Получение бинарного идентификатора для аутентификации пользователя по логину и паролю.
++Входные параметры:
++
++|(% style="width:206px" %)Название параметра|(% style="width:130px" %)Тип параметра|(% style="width:70px" %)Обяз.|(% style="width:234px" %)Описание параметра|(% style="width:343px" %)Пример
++|(% style="width:206px" %)Login|(% style="width:130px" %)**string**|(% style="width:70px" %)Да|(% style="width:234px" %)Логин пользователя|(% style="width:343px" %)Vasya
++|(% style="width:206px" %)Password|(% style="width:130px" %)**string**|(% style="width:70px" %)Да|(% style="width:234px" %)Пароль пользователя|(% style="width:343px" %)123456
++
++Возвращаемое значение:
++
++|Тип параметра|Описание параметра|Пример
++|string|Сессионный ключ|YOB7IG8UG687068
++
  * (((
  == [[GetTransportService>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]] ==
  )))
@@ -232,6
          +232,46 @@
  Создание/обновление трекинга.
++Входные параметры:
++
++|Название параметра|Тип параметра|Обяз?|Описание параметра|Пример
++|ticket|**string**|Да|Сессионный ключ|YOB7IG8UG687068
++|record|**TrackingRecord**|Да|(((
++структура содержащая данные, идентична секции Tracking в методе [[GetOrderBySysKey>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderBySysKey]]
++)))|
++
++Выходные параметры:
++
++|Название параметра|Тип параметра|Описание параметра|Пример
++|TrackingUid|**guid**|Уникальный идентификатор трекинга. Значение можно использовать для дальнейших вызовов метода SaveOrder, если нужно обновить значения трекинга.|
++|SysNum|**string**|Системный номер трекинга (учётный номер ремонта в системе)|
++|StatusName|**string**|Статус трекинга|
++|StatusUid|**guid**|UID статуса трекинга. Значение берётся из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].|
++|Result|**Added** or **Changed** or **NotFound** or **Error** or **Unknown**|(((
++Результат выполнения операции:
++
++Added – трекинг создан и помещён в базу
++
++Changed – трекинг изменён
++
++NotFound – трекинг не найден по uid
++
++Error – ошибка в работе метода
++
++Unknown – неизвестная ошибка
++)))|Added
++|TrackingUri|**string**|Ссылка на трекинг, которую можно открыть в браузере|
++
++Секция Errors содержит коллекцию строк ошибок.
++
++Секция ValidationErrors содержит коллекцию ErrorItem следующего вида:
++
++|Название параметра|Тип параметра|Описание параметра|Пример
++|ErrorCode|**string**|Код ошибки|
++|ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.|
++|Status|**string**|Статус трекинга|
++|Descriptilon|**string**|Описание ошибки|
++
  = Порядок вызова методов и работы с сервисом =
 . Для начала работы требуется аутентифицироваться. Для этого нужно вызвать метод [[GetTicket>>path:#_heading=h.1fob9te]] с параметрами login и password и получить в ответ ticket. Он используются для вызова других методов сервиса. В качестве пользователя может использоваться любой созданный на сайте аккаунт с доступом к созданию трекинга.

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

Комментарий

Подробности

Приложения

Навигация