Changes for page Интеграция с трекингом (API)
Last modified by Дмитрий Семёнов on 2025/04/10 15:52
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -8,444 +8,39 @@ 8 8 9 9 = Список методов = 10 10 11 -* ((( 12 -== [[CreateTrackingCallCentr>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=CreateTrackingCallCentr]] == 13 -))) 11 +* [[CreateTrackingCallCentr>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=CreateTrackingCallCentr]] - Создание трекинга колл-центра. 12 +* [[DeleteAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=DeleteAttachment]] -Удаляет вложение трекинга по номеру ремонта АСЦ (OrderNumAsc) и по типу вложения 13 +* [[GetANRPInfo>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetANRPInfo]] - Получение информации по акту неремонтопригодности. 14 +* [[GetATOInfo>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetATOInfo]] - Получение информации по акту технического освидетельствования. 15 +* [[GetActionPlace>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetActionPlace]] - Возвращает справочник мест ремонта. 16 +* [[GetAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachment]] - Возвращает вложение по номеру ремонта АСЦ (OrderNumAsc) и по типу вложения. 17 +* [[GetAttachmentKeys>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachmentKeys]] - Возвращает список вложений по системному номеру трекинга (OrderNum) без самих вложений. 18 +* [[GetAttachmentTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachmentTypes]] - Возвращает список типов вложений 19 +* [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]] - Возвращает список брендов в разрезе групп брендов. 20 +* [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]] - Возвращает справочник Iris Код условий по бренду и категории модели. 21 +* [[GetCategIrisDefectCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]] - Возвращает справочник Iris Код дефектов по бренду и категории модели. 22 +* [[GetCategIrisRepairCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]] - Возвращает справочник Iris Код ремонтов по бренду и категории модели. 23 +* [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]] - Возвращает справочник Iris Код секций по бренду и категории модели. 24 +* [[GetCategIrisSymptomCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]] - Возвращает справочник Iris Код симптомов по бренду и категории модели. 25 +* [[GetIrisCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetIrisCodes]] - Возвращает Iris коды в разрезе типов Iris кодов (ConditionCode, DefectCode, RepairCode, sectionCode, SymptomCode), категорий моделей и брендов (в рамках активных авторизаций по брендам) 26 +* [[GetModelCategories>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetModelCategories]] - Возвращает справочник категорий моделей. 27 +* [[GetOrderByAscKey>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderByAscKey]] - Возвращает трекинг по номеру ремонта АСЦ (OrderNumAsc) 28 +* [[GetOrderBySysKey>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderBySysKey]] - Возвращает трекинг по системному номеру (OrderNum). 29 +* [[GetOrderKeys>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderKeys]] - Возвращает список трекингов, перешедших в конечный статус в последние 35 дней и всех остальных, не перешедших в конечный статус. 30 +* [[GetRejectReasons>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetRejectReasons]] - Список причин отмены трекинга 31 +* [[GetSpRepairTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpRepairTypes]] - Возвращает справочник типов ремонтов по группе брендов (MainBrandUid). 32 +* [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]] - Возвращает список статусов трекинга. 33 +* [[GetTicket>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTicket]] - Получение бинарного идентификатора для аутентификации пользователя по логину и паролю. 34 +* [[GetTransportService>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]] - Возвращает справочник типов транспортировки по мету ремонта и бренду. 35 +* [[GetTransportZone>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportZone]] - Возврат справочника зон транспортировки. 36 +* [[SaveAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveAttachment]] - Создание вложения определенного типа в трекинге, с удалением всех вложений того же типа 37 +* [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]] - Создание/обновление трекинга. 14 14 15 -Создание трекинга колл-центра. 16 - 17 -Входные параметры: 18 - 19 -|Название параметра|Тип параметра|Обяз.|Описание параметра 20 -|ticket|**string**|Да|Сессионный ключ 21 -|record|**record**|Да|структура содержащая данные 22 -|(% colspan="4" %)**Структура Record** 23 -|Model|**string (50)**|Да|Строка названия модели 24 -|OrderNumBrand|**string (50)**|Да|Номер заявки колл-центра 25 -|SerialNumb|**string (50)**|Нет|Серийный номер 26 -|DesRepair|**string (3000)**|Нет|Заявленная неисправность 27 -|RepairTypeUid|**guid**|Нет|((( 28 -Тип ремонта (связь с брендами (Default)). Значение берется из метода [[GetSpRepairTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpRepairTypes]]. Если не заполнено, то подставится «Клиентский гарантийный». 29 - 30 - 31 -))) 32 -|BrandUid|**guid**|Да|Бренд (торговая марка). Значение берётся из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].BrandUid 33 -|CountryServiceCenter|**string (2)**|Нет|Стана АСЦ. Указывается страна в виде кода ALFA-2. Если страна найдена, то город будет сопоставляться с городами этой страны, иначе со страной пользователя колл-центра. 34 -|CityServiceCenter|**string (255)**|Нет|Город АСЦ. Город подбирается по тексту и стране. Если город найден, то по городу и бренду осуществляется поиск АСЦ. Если найден единственный АСЦ, то подставляется он иначе, если не единственный или если город не найден, то берется город пользователя колл-центра и в качестве АСЦ указывается пусто. Далее при редактировании данного трекинга на сайте, его не возможно сохранить с пустым АСЦ. 35 -|CName|**string (255)**|Нет|Имя клиента 36 -|CSurname|**string (255)**|Нет|Фамилия клиента 37 -|CPatronymic|**string (255)**|Нет|Отчество клиента 38 -|CCity|**string (255)**|Нет|Город клиента 39 -|CAddress|**string (255)**|Нет|Адрес клиента 40 -|CHouse|**string (5)**|Нет|Номер дома клиента 41 -|CBuild|**string (5)**|Нет|Корпус дома клиента 42 -|CFlat|**string (5)**|Нет|Номер квартиры клиента 43 -|CMobTel|**string (15)**|Нет|Мобильный телефон клиента 44 -|Cemail|**string (255)**|Нет|Email клиента 45 -|UrlQuestionnaire|**string**|Нет|URL на анкету для прохождения опроса по завершению ремонта 46 - 47 -Выходные параметры: 48 - 49 -|Название параметра|Тип параметра|Описание параметра|Пример 50 -|TrackingUid|**guid**|Уникальный идентификатор трекинга. Значение можно использовать для дальнейших вызовов метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]], если необходимо обновить значения трекинга.| 51 -|SysNum|**string**|Системный номер трекинга (учётный номер ремонта в системе)| 52 -|StatusName|**string**|Статус трекинга| 53 -|StatusUid|**guid**|UID статуса трекинга. Значение берётся из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].| 54 -|Result|**Added** or **Changed** or **NotFound** or **Error** or **Unknown**|((( 55 -Результат выполнения операции: 56 - 57 -Added – трекинг создан и помещён в базу 58 - 59 -Changed – трекинг изменён 60 - 61 -NotFound – трекинг не найден по uid 62 - 63 -Error – ошибка в работе метода 64 - 65 -Unknown – неизвестная ошибка 66 -)))|Added 67 -|TrackingUri|**string**|Ссылка на трекинг, которую можно открыть в браузере| 68 - 69 -Секция Errors содержит коллекцию строк ошибок. 70 - 71 -Секция ValidationErrors содержит коллекцию ErrorItem следующего вида: 72 - 73 -|Название параметра|Тип параметра|Описание параметра|Пример 74 -|ErrorCode|**string**|Код ошибки| 75 -|ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.| 76 -|Status|**string**|Статус трекинга| 77 -|Descriptilon|**string**|Описание ошибки 78 - 79 -* ((( 80 -== [[DeleteAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=DeleteAttachment]] == 81 -))) 82 - 83 -Удаляет вложение трекинга по номеру ремонта АСЦ (OrderNumAsc) и по типу вложения 84 - 85 -* ((( 86 -== [[GetANRPInfo>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetANRPInfo]] == 87 -))) 88 - 89 -Получение информации по акту неремонтопригодности. 90 - 91 -* ((( 92 -== [[GetATOInfo>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetATOInfo]] == 93 -))) 94 - 95 -Получение информации по акту технического освидетельствования. 96 - 97 -* ((( 98 -== [[GetActionPlace>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetActionPlace]] == 99 -))) 100 - 101 -Возвращает справочник мест ремонта. 102 - 103 -* ((( 104 -== [[GetAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachment]] == 105 -))) 106 - 107 -Возвращает вложение по номеру ремонта АСЦ (OrderNumAsc) и по типу вложения. 108 - 109 -* ((( 110 -== [[GetAttachmentKeys>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachmentKeys]] == 111 -))) 112 - 113 -Возвращает список вложений по системному номеру трекинга (OrderNum) без самих вложений. 114 - 115 -* ((( 116 -== [[GetAttachmentTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachmentTypes]] == 117 -))) 118 - 119 -Возвращает список типов вложений 120 - 121 -* ((( 122 -== [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]] == 123 -))) 124 - 125 -Возвращает список брендов в разрезе групп брендов. 126 - 127 -* ((( 128 -== [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]] == 129 -))) 130 - 131 -Возвращает справочник Iris Код условий по бренду и категории модели. 132 - 133 -* ((( 134 -== [[GetCategIrisDefectCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]] == 135 -))) 136 - 137 -Возвращает справочник Iris Код дефектов по бренду и категории модели. 138 - 139 -* ((( 140 -== [[GetCategIrisRepairCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]] == 141 -))) 142 - 143 -Возвращает справочник Iris Код ремонтов по бренду и категории модели. 144 - 145 -* ((( 146 -== [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]] == 147 -))) 148 - 149 -Возвращает справочник Iris Код секций по бренду и категории модели. 150 - 151 -* ((( 152 -== [[GetCategIrisSymptomCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]] == 153 -))) 154 - 155 -Возвращает справочник Iris Код симптомов по бренду и категории модели. 156 - 157 -* ((( 158 -== [[GetIrisCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetIrisCodes]] == 159 -))) 160 - 161 -Возвращает Iris коды в разрезе типов Iris кодов (ConditionCode, DefectCode, RepairCode, sectionCode, SymptomCode), категорий моделей и брендов (в рамках активных авторизаций по брендам) 162 - 163 -* ((( 164 -== [[GetModelCategories>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetModelCategories]] == 165 -))) 166 - 167 -Возвращает справочник категорий моделей. 168 - 169 -* ((( 170 -== [[GetOrderByAscKey>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderByAscKey]] == 171 -))) 172 - 173 -Возвращает трекинг по номеру ремонта АСЦ (OrderNumAsc) 174 - 175 -* ((( 176 -== [[GetOrderBySysKey>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderBySysKey]] == 177 -))) 178 - 179 -Возвращает трекинг по системному номеру (OrderNum). 180 - 181 -**Входные параметры:** 182 - 183 -|Название параметра|Тип параметра|Обяз?|Описание параметра|Пример 184 -|ticket|**string**|Да|Сессионный ключ|YOB7IG8UG687068 185 -|((( 186 -numberKey 187 - 188 - 189 -)))|**string**|Да|Системный номер ремонта. OrderNum секции трекинг.|1.0.0.0 190 - 191 -**Выходные параметры:** 192 - 193 -**Секция Tracking** 194 - 195 -|Название параметра|Тип параметра|Описание параметра|Пример 196 -|uid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]] в случае, если нужно обновить значения трекинга.|6e18064e-1cd3-4207-8ebe-08c4417db2be 197 -|Brand|**guid**|Группа брендов. Значение берётся из поля MainBrandUid из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b457927a-766e-44b1-a79d-508adee3a915 198 -|Model|**string (50)**|Строка названия модели|121 199 -|OrderNum|**string (50)**|Строка номера ремонта|0000018 200 -|OrderNumBrand|**string (50)**|Номер заявки колл-центра| 201 -|ReceiveDate|**datetime**|Дата получения товара в ремонт| 202 -|ReadyDate|**datetime**|Дата готовности| 203 -|ReadyOutDate|**datetime**|Дата готовности к выдаче| 204 -|OutDate|**datetime**|Дата выдачи| 205 -|PurchDate|**datetime**|Дата покупки| 206 -|SerialNumb|**string (50)**|Серийный номер| 207 -|ProductNumb|**string (50)**|Продуктовый номер| 208 -|EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|2023-04-07T18:16:10.783 209 -|TransportService|**guid**|Вид транспортировки. Значение берётся из [[GetTransportService>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]].|f34fa37d-b678-469d-9129-6ac9d9d270f7 210 -|PlanTransportDate|**datetime**|Плановая дата доставки| 211 -|Status|**guid**|Статус. Значение берётся из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].|51deb04d-b307-4efc-826a-2d0e3d151d1d 212 -|MasterASC|**string (255)**|ФИО мастера| 213 -|CreateDate|**datetime**|Дата создания (в первый раз будет заменена на текущую)|2023-04-03T16:56:20.74 214 -|ComplectPack|**int**|Наличие коробки| 215 -|ComplectWarr|**int**|Наличие гарантийного талона| 216 -|ComplectCheck|**int**|Наличие чека| 217 -|PlanMasterDate|**datetime**|Планируемая дата выезда| 218 -|IsExpRep|**boolean**|Флаг экспресс-ремонта| 219 -|ServiceBulletin|**string (255)**|Сервисный бюллетень| 220 -|ActionPlace|**guid**|Место ремонта. Значение берётся из [[GetActionPlace>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetActionPlace]].|87da8c9b-61d8-4db0-825b-9c39adf1f50b 221 -|DesRepair|**string (3000)**|Заявленная неисправность|test 222 -|DescriptionCC|**string (3000)**|Результат диагностики оператором Call Центра| 223 -|DescriptionCompCent|**string (3000)**|Резюме центра компетенции| 224 -|DiagnosticResult|**string (3000)**|Результат диагностики| 225 -|Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].| 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]].| 230 -|LocationCode|**string (50)**|Позиционный номер| 231 -|DName|**string (255)**|Наименование дилера| 232 -|DCity|**string (255)**|Город дилера| 233 -|DAddress|**string (255)**|Адрес дилера| 234 -|DTel|**string (11)**|Телефон дилера| 235 -|Demail|**string (255)**|Email дилера| 236 -|DComments|**string (500)**|Дополнительная информация дилера| 237 -|CName|**string (255)**|Имя клиента| 238 -|CSurname|**string (255)**|Фамилия клиента| 239 -|CPatronymic|**string (255)**|Отчество клиента| 240 -|CCity|**string (255)**|Город клиента| 241 -|CAddress|**string (255)**|Адрес клиента| 242 -|CHouse|**string (5)**|Номер дома клиента| 243 -|CBuild|**string (5)**|Корпус клиента| 244 -|CFlat|**string (5)**|Номер квартиры клиента| 245 -|CHomeTel|**string (11)**|Домашний телефон клиента| 246 -|CWorkTel|**string (11)**|Рабочий телефон клиента| 247 -|CMobTel|**string (13)**|Мобильный телефон клиента| 248 -|Cemail|**string (255)**|Email клиента| 249 -|CComments|**string (500)**|Дополнительная информация клиента| 250 -|CLift|**int**|Наличие лифта в доме клиента| 251 -|CDomofon|**string (50)**|Код домофона у клиента| 252 -|OrderNumAsc|**string (50)**|Номер ремонта в системе АСЦ| 253 -|StartRepairDate|**datetime**|Дата начала ремонта АСЦ| 254 -|RegularSWnumberIN|**string (255)**|Версия прошивки "Main SW" при поступлении в ремонт| 255 -|RegularSWnumberOUT|**string (255)**|Версия прошивки "Main SW" при выдаче из ремонта| 256 -|StandBySWnumberIN|**string (255)**|Версия прошивки "Stand By SW" при поступлении в ремонт| 257 -|StandBySWnumberOUT|**string (255)**|Версия прошивки "Stand By" при выдаче из ремонта| 258 -|((( 259 -ConditionDescr 260 - 261 - 262 -)))|**string (255)**|Описание Iris кода условия|1-Постоянно 263 -|RepairTypeCurrent|**guid**|Тип ремонта текущий (связь с брендами (Default))|b7a77d5a-e95a-11d9-b44e-000476de6b1e 264 -|RepairTypeStart|**guid**|Тип ремонта начальный (связь с брендами (Default))| 265 -|TransportZone|**guid**|Зона транспортировки. Значение берётся из GetTransportZone.|85df2056-e60f-4bc1-a21c-17c9f6c9241a 266 -|UidNRP|**guid**|Uid акта НРП| 267 -|RealBrand|**guid**|Бренд (торговая марка). Значение берётся из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b8a3f06b-cacf-4a9b-b3f7-089c266ea654 268 -|((( 269 -IWS 270 - 271 - 272 -)))|**string (255)**|Номер IWS|b8a3f06b-cacf-4a9b-b3f7-089c266ea654 273 -|RegionUid|**guid**|Город АСЦ.| 274 -|Recommendation|**string (3000)**|Рекомендации мастера по эксплуатации| 275 -|IMEI1|**string (255)**|IMEI1| 276 -|IMEI2|**string (255)**|IMEI2| 277 -|IMEI3|**string (255)**|IMEI3| 278 -|IMEI4|**string (255)**|IMEI4| 279 -|IMEI1NEW|**string (255)**|IMEI1 новый| 280 -|IMEI2NEW|**string (255)**|IMEI2 новый| 281 -|IMEI3NEW|**string (255)**|IMEI3 новый| 282 -|IMEI4NEW|**string (255)**|IMEI4 новый| 283 -|RepairLevel|**string (300)**|Уровень ремонта| 284 - 285 -Подсекция Parts секции Tracking состоит из коллекции типа PartRecord следующего формата: 286 - 287 -|Название параметра|Тип параметра|Описание параметра|Пример 288 -|uid|**guid**|Уникальный идентификатор детали/з/ч. Значение берётся из предыдущего вызова метода SaveOrder в случае, если нужно обновить значения трекинга.| 289 -|CreateDate|**datetime**|Дата создания (будет заменена на текущую)| 290 -|PartNumber|**string (100)**|ПартНомер| 291 -|PartName|**string (255)**|Наименование детали| 292 -|Price|**decimal**|Цена отгрузки| 293 -|Qnt|**int**|Количество| 294 -|Compensate|**decimal**|Размер компенсации для ASC| 295 -|ASCOrderNo|**string (100)**|№ заказа ACЦ (ссылка на заказ)| 296 -|SPOrderNo|**string (100)**|№ заявки з/ч (проверка при создании акта НРП)| 297 -|OrderCreate|**datetime**|Дата заказа запчасти| 298 -|PrognoseDate|**datetime**|Ожидаемая дата получения з/ч| 299 -|OrderUid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]].| 300 -|AscItemKey|**string (50)**|Внутренний ID детали АСЦ| 301 -|TypeOrder|**guid**|Тип заказчика, в основном пустой или АСЦ|9314B01D-3D61-426C-BCAF-BFDEF25AAA56 302 -|InvoiceNum|**string (50)**|Номер накладной| 303 -|InvoiceDate|**datetime**|Дата накладной| 304 -|InvoiceRef|**guid**|Ссылка на позицию в накладной. Не используется в данное время| 305 -|AscStore|**int**|((( 306 -~=1, если деталь получена АСЦ не у провайдера, а со стороны 307 - 308 -~=0, если получена АСЦ у провайдера. 309 - 310 -Возможность указывать детали своего склада зависит от настроек авторизации по бренду. 311 -)))| 312 -|Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].| 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]].| 317 -|LocationCode|**string (50)**|Позиционный номер| 318 -|EditDate|**datetime**|Дата редактирования (будет заменена на текущую)| 319 -|EditUser|**guid**|Идентификатор пользователя| 320 -|ProblemPartSerial|**string (255)**|Серийный номер неисправной детали| 321 -|SetupPartSerial|**string (255)**|Серийный номер установленной детали| 322 - 323 -**Секция Payment** 324 - 325 -|Название параметра|Тип параметра|Описание параметра|Пример 326 -|uid|**guid**|Идентификатор заказа|00000000-0000-0000-0000-000000000000 327 -|Labor|**decimal**|Стоимость работы| 328 -|BonusASC|**decimal**|Бонус АСЦ| 329 -|Handling|**decimal**|Фиксированный тариф провайдера| 330 -|BonusCSP|**decimal**|Переменное вознаграждение провайдера| 331 -|BonusCSPPercent|**decimal**|Процент ~(% от тарифа) на момент формирования инвойса| 332 -|SU|**decimal**|Оплата доставки з/ч провайдера| 333 -|Transport|**decimal**|Оплата транспортировки/выезда| 334 -|SparePartsASC|**decimal**|Сумма компенсации з/ч АСЦ| 335 -|SparePartsCSP|**decimal**|Сумма компенсации з/ч провайдера| 336 -|AdditionalLabor|**decimal**|Оплата дополнительных работ АСЦ| 337 -|ASCSumm|**decimal**|Итого оплата АСЦ| 338 -|CSPSumm|**decimal**|Итого оплата провайдера| 339 -|TotalSumm|**decimal**|Итого сумма отплаты| 340 -|LaborCSP|**decimal**|Стоимость работы провайдера| 341 -|LaborPSU|**decimal**|Стоимость ремонта PSU| 342 -|LaborSSB|**decimal**|Стоимость ремонта SSB| 343 -|AdditionalLaborTotal|**decimal**|Всего стоимость дополнительных работ| 344 -|BonusASCPercent|**decimal**|Процент бонусов АСЦ| 345 -|SparePartsTotal|**decimal**|Всего стоимость з/ч| 346 -|AdditionalLaborDescr|**String (1000)**|Описание дополнительных работ| 347 - 348 -**Отдельный параметр** 349 - 350 -|Название параметра|Тип параметра|Описание параметра|Пример 351 -|RefUri|**string**|Ссылка на трекинг, которую можно открыть в браузере| 352 - 353 -Секция ValidationErrors содержит коллекцию ErrorItem следующего вида: 354 - 355 -|Название параметра|Тип параметра|Описание параметра|Пример 356 -|ErrorCode|**string**|Код ошибки|43 357 -|ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.|1 358 -|Status|**string**|Статус трекинга| 359 -|Descriptilon|**string**|Описание ошибки|Для продолжения ремонта необходимо ввести, по крайней мере, одну запасную часть 360 - 361 -* ((( 362 -== [[GetOrderKeys>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderKeys]] == 363 -))) 364 - 365 -Возвращает список трекингов, перешедших в конечный статус в последние 35 дней и всех остальных, не перешедших в конечный статус. 366 - 367 -Входные параметры: 368 - 369 -|(% style="width:180px" %)Название параметра|(% style="width:141px" %)Тип параметра|(% style="width:79px" %)Обяз.|(% style="width:415px" %)Описание параметра|(% style="width:168px" %)Пример 370 -|(% style="width:180px" %)ticket|(% style="width:141px" %)**string**|(% style="width:79px" %)Да|(% style="width:415px" %)Сессионный ключ|(% style="width:168px" %)YOB7IG8UG687068 371 - 372 -Выходные параметры: 373 - 374 -Возвращает коллекцию TrackingShortItem следующего вида: 375 - 376 -|Название параметра|Тип параметра|Описание параметра|Пример 377 -|Uid|**guid**|Идентификатор ремонта|bf181853-8a82-4d7a-91b0-002e1105fe10 378 -|NumKey|**string (50)**|Код ремонта в системе|ET0000001 379 -|AscKey|**string (50)**|Код АСЦ ремонта|11947 380 -|Status|**guid**|Статус. Значения из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]]|574fa171-5482-4979-be0f-117a3dd0dd29 381 -|LastEditDate|**dateTime**|Дата последнего редактирования ремонта|2015-03-17T15:41:39.923 382 -|MainBrandUid|**guid**|Идентификатор группы брендов. Значения из поля MainBrandUid из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]]|b457927a-766e-44b1-a79d-508adee3a915 383 -|BrandUid|**guid**|Идентификатор бренда модели. Значения из поля BrandUid из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]]|318c5448-3632-413e-ba36-16a95d85bb26 384 - 385 -* ((( 386 -== [[GetRejectReasons>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetRejectReasons]] == 387 -))) 388 - 389 -Список причин отмены трекинга 390 - 391 -* ((( 392 -== [[GetSpRepairTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpRepairTypes]] == 393 -))) 394 - 395 -Возвращает справочник типов ремонтов по группе брендов (MainBrandUid). 396 - 397 -* ((( 398 -== [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]] == 399 -))) 400 - 401 -Возвращает список статусов трекинга. 402 - 403 -* ((( 404 -== [[GetTicket>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTicket]] == 405 -))) 406 - 407 -Получение бинарного идентификатора для аутентификации пользователя по логину и паролю. 408 - 409 -Входные параметры: 410 - 411 -|(% style="width:206px" %)Название параметра|(% style="width:130px" %)Тип параметра|(% style="width:70px" %)Обяз.|(% style="width:234px" %)Описание параметра|(% style="width:343px" %)Пример 412 -|(% style="width:206px" %)Login|(% style="width:130px" %)**string**|(% style="width:70px" %)Да|(% style="width:234px" %)Логин пользователя|(% style="width:343px" %)Vasya 413 -|(% style="width:206px" %)Password|(% style="width:130px" %)**string**|(% style="width:70px" %)Да|(% style="width:234px" %)Пароль пользователя|(% style="width:343px" %)123456 414 - 415 -Возвращаемое значение: 416 - 417 -|Тип параметра|Описание параметра|Пример 418 -|string|Сессионный ключ|YOB7IG8UG687068 419 - 420 -* ((( 421 -== [[GetTransportService>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]] == 422 -))) 423 - 424 -Возвращает справочник типов транспортировки по мету ремонта и бренду. 425 - 426 -* ((( 427 -== [[GetTransportZone>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportZone]] == 428 -))) 429 - 430 -Возврат справочника зон транспортировки. 431 - 432 -* ((( 433 -== [[SaveAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveAttachment]] == 434 -))) 435 - 436 -Создание вложения определенного типа в трекинге, с удалением всех вложений того же типа 437 - 438 -* ((( 439 -== [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]] == 440 -))) 441 - 442 -Создание/обновление трекинга. 443 - 444 444 = Порядок вызова методов и работы с сервисом = 445 445 446 446 1. Для начала работы требуется аутентифицироваться. Для этого нужно вызвать метод [[GetTicket>>path:#_heading=h.1fob9te]] с параметрами login и password и получить в ответ ticket. Он используются для вызова других методов сервиса. В качестве пользователя может использоваться любой созданный на сайте аккаунт с доступом к созданию трекинга. 447 447 1. Далее нужно заполнить справочники (классификаторы) вашего сервиса, чтобы передавать их в метод сохранения ремонта. Справочники заполняются вызовами соответствующих методов класса «Получение классификатора». 448 -1. Ремонт создаётся методом [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]].Любые изменения вносятся повторным вызовом этого метода. Метод возвращает в числе других параметров TrackingUid, необходим при сохранении вложений к трекингу [[SaveAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveAttachment]], получении информации по акту неремонтопригодности [[GetANRPInfo>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetANRPInfo]] или акту технического освидетельствования [[GetATOInfo>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetATOInfo]]. Все детали (запчасти, з/ч) нужно передавать каждый раз при вызове метода.43 +1. Ремонт создаётся методом SaveOrder. Любые изменения вносятся повторным вызовом этого метода. Метод возвращает в числе других параметров TrackingUid, необходим при сохранении вложений к трекингу [[SaveAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveAttachment]], получении информации по акту неремонтопригодности [[GetANRPInfo>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetANRPInfo]] или акту технического освидетельствования [[GetATOInfo>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetATOInfo]]. Все детали (запчасти, з/ч) нужно передавать каждый раз при вызове метода. 449 449 1. **Важно: ** 450 450 451 451 * Ремонт в статусе «ОТЧЕТ», «ОТМЕНЁН», «ОПЛАЧЕН» не может быть обновлён. ... ... @@ -459,6 +459,21 @@ 459 459 460 460 То есть при передачи новых данных по этим полям, они будут проигнорированы. 461 461 57 += Метод GetTicket = 58 + 59 +Получение бинарного идентификатора для аутентификации пользователя. 60 + 61 +**Входные параметры:** 62 + 63 +|(% style="width:173px" %)Название параметра|(% style="width:173px" %)Тип параметра|(% style="width:159px" %)Обязательный|(% style="width:253px" %)Описание параметра|(% style="width:225px" %)Пример 64 +|(% style="width:173px" %)Login|(% style="width:173px" %)**string**|(% style="width:159px" %)Да|(% style="width:253px" %)Логин пользователя|(% style="width:225px" %)Vasya 65 +|(% style="width:173px" %)Password|(% style="width:173px" %)**string**|(% style="width:159px" %)Да|(% style="width:253px" %)Пароль пользователя|(% style="width:225px" %)123456 66 + 67 +**Возвращаемое значение:** 68 + 69 +|Тип параметра|Описание параметра|Пример 70 +|string|Сессионный ключ|YOB7IG8UG687068 71 + 462 462 463 463 ))) 464 464