Изменения документа Интеграция с трекингом (API)
Редактировал(а) Дмитрий Семёнов 2025/04/10 15:52
отредактировано Григорий Лепёшкин
на 2023/12/21 14:56
на 2023/12/21 14:56
отредактировано Григорий Лепёшкин
на 2023/12/21 11:49
на 2023/12/21 11:49
Изменить комментарий:
К данной версии нет комментариев
Комментарий
-
Свойства страницы (1 изменено, 0 добавлено, 0 удалено)
Подробности
- Свойства страницы
-
- Содержимое
-
... ... @@ -9,69 +9,6 @@ 9 9 = Список методов = 10 10 11 11 * [[CreateTrackingCallCentr>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=CreateTrackingCallCentr]] - Создание трекинга колл-центра. 12 - 13 -Входные параметры: 14 - 15 -|Название параметра|Тип параметра|Обяз.|Описание параметра 16 -|ticket|**string**|Да|Сессионный ключ 17 -|record|**record**|Да|структура содержащая данные 18 -|(% colspan="4" %)**Структура Record** 19 -|Model|**string (50)**|Да|Строка названия модели 20 -|OrderNumBrand|**string (50)**|Да|Номер заявки колл-центра 21 -|SerialNumb|**string (50)**|Нет|Серийный номер 22 -|DesRepair|**string (3000)**|Нет|Заявленная неисправность 23 -|RepairTypeUid|**guid**|Нет|((( 24 -Тип ремонта (связь с брендами (Default)). Значение берется из метода [[GetSpRepairTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpRepairTypes]]. Если не заполнено, то подставится «Клиентский гарантийный». 25 - 26 - 27 -))) 28 -|BrandUid|**guid**|Да|Бренд (торговая марка). Значение берётся из [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].BrandUid 29 -|CountryServiceCenter|**string (2)**|Нет|Стана АСЦ. Указывается страна в виде кода ALFA-2. Если страна найдена, то город будет сопоставляться с городами этой страны, иначе со страной пользователя колл-центра. 30 -|CityServiceCenter|**string (255)**|Нет|Город АСЦ. Город подбирается по тексту и стране. Если город найден, то по городу и бренду осуществляется поиск АСЦ. Если найден единственный АСЦ, то подставляется он иначе, если не единственный или если город не найден, то берется город пользователя колл-центра и в качестве АСЦ указывается пусто. Далее при редактировании данного трекинга на сайте, его не возможно сохранить с пустым АСЦ. 31 -|CName|**string (255)**|Нет|Имя клиента 32 -|CSurname|**string (255)**|Нет|Фамилия клиента 33 -|CPatronymic|**string (255)**|Нет|Отчество клиента 34 -|CCity|**string (255)**|Нет|Город клиента 35 -|CAddress|**string (255)**|Нет|Адрес клиента 36 -|CHouse|**string (5)**|Нет|Номер дома клиента 37 -|CBuild|**string (5)**|Нет|Корпус дома клиента 38 -|CFlat|**string (5)**|Нет|Номер квартиры клиента 39 -|CMobTel|**string (15)**|Нет|Мобильный телефон клиента 40 -|Cemail|**string (255)**|Нет|Email клиента 41 -|UrlQuestionnaire|**string**|Нет|URL на анкету для прохождения опроса по завершению ремонта 42 - 43 -Выходные параметры: 44 - 45 -|Название параметра|Тип параметра|Описание параметра|Пример 46 -|TrackingUid|**guid**|Уникальный идентификатор трекинга. Значение можно использовать для дальнейших вызовов метода [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]], если необходимо обновить значения трекинга.| 47 -|SysNum|**string**|Системный номер трекинга (учётный номер ремонта в системе)| 48 -|StatusName|**string**|Статус трекинга| 49 -|StatusUid|**guid**|UID статуса трекинга. Значение берётся из [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].| 50 -|Result|**Added** or **Changed** or **NotFound** or **Error** or **Unknown**|((( 51 -Результат выполнения операции: 52 - 53 -Added – трекинг создан и помещён в базу 54 - 55 -Changed – трекинг изменён 56 - 57 -NotFound – трекинг не найден по uid 58 - 59 -Error – ошибка в работе метода 60 - 61 -Unknown – неизвестная ошибка 62 -)))|Added 63 -|TrackingUri|**string**|Ссылка на трекинг, которую можно открыть в браузере| 64 - 65 -Секция Errors содержит коллекцию строк ошибок. 66 - 67 -Секция ValidationErrors содержит коллекцию ErrorItem следующего вида: 68 - 69 -|Название параметра|Тип параметра|Описание параметра|Пример 70 -|ErrorCode|**string**|Код ошибки| 71 -|ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.| 72 -|Status|**string**|Статус трекинга| 73 -|Descriptilon|**string**|Описание ошибки 74 - 75 75 * [[DeleteAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=DeleteAttachment]] -Удаляет вложение трекинга по номеру ремонта АСЦ (OrderNumAsc) и по типу вложения 76 76 * [[GetANRPInfo>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetANRPInfo]] - Получение информации по акту неремонтопригодности. 77 77 * [[GetATOInfo>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetATOInfo]] - Получение информации по акту технического освидетельствования. ... ... @@ -103,7 +103,7 @@ 103 103 104 104 1. Для начала работы требуется аутентифицироваться. Для этого нужно вызвать метод [[GetTicket>>path:#_heading=h.1fob9te]] с параметрами login и password и получить в ответ ticket. Он используются для вызова других методов сервиса. В качестве пользователя может использоваться любой созданный на сайте аккаунт с доступом к созданию трекинга. 105 105 1. Далее нужно заполнить справочники (классификаторы) вашего сервиса, чтобы передавать их в метод сохранения ремонта. Справочники заполняются вызовами соответствующих методов класса «Получение классификатора». 106 -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]]. Все детали (запчасти, з/ч) нужно передавать каждый раз при вызове метода. 107 107 1. **Важно: ** 108 108 109 109 * Ремонт в статусе «ОТЧЕТ», «ОТМЕНЁН», «ОПЛАЧЕН» не может быть обновлён. ... ... @@ -117,6 +117,21 @@ 117 117 118 118 То есть при передачи новых данных по этим полям, они будут проигнорированы. 119 119 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 + 120 120 121 121 ))) 122 122