Изменения документа Интеграция с трекингом (API)
Редактировал(а) Дмитрий Семёнов 2025/04/10 15:52
отредактировано Григорий Лепёшкин
на 2023/12/21 15:04
на 2023/12/21 15:04
отредактировано Григорий Лепёшкин
на 2023/12/21 17:00
на 2023/12/21 17:00
Изменить комментарий:
К данной версии нет комментариев
Комментарий
-
Свойства страницы (1 изменено, 0 добавлено, 0 удалено)
Подробности
- Свойства страницы
-
- Содержимое
-
... ... @@ -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) без самих вложений. ... ... @@ -178,6 +178,186 @@ 178 178 179 179 Возвращает трекинг по системному номеру (OrderNum). 180 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 + 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 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 + 187 187 * ((( 188 188 == [[GetRejectReasons>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetRejectReasons]] == 189 189 ))) ... ... @@ -191,7 +191,7 @@ 191 191 Список причин отмены трекинга 192 192 193 193 * ((( 194 -== [[GetSpRepairTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpRepairTypes]] ==392 +== [[GetSpRepairTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpRepairTypes]] == 195 195 ))) 196 196 197 197 Возвращает справочник типов ремонтов по группе брендов (MainBrandUid). ... ... @@ -208,6 +208,17 @@ 208 208 209 209 Получение бинарного идентификатора для аутентификации пользователя по логину и паролю. 210 210 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 + 211 211 * ((( 212 212 == [[GetTransportService>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]] == 213 213 )))