Изменения документа Интеграция с трекингом (API)
Редактировал(а) Дмитрий Семёнов 2025/04/10 15:52
отредактировано Дмитрий Семёнов
на 2025/03/28 13:46
на 2025/03/28 13:46
отредактировано Дмитрий Семёнов
на 2025/03/19 14:29
на 2025/03/19 14:29
Изменить комментарий:
К данной версии нет комментариев
Комментарий
-
Свойства страницы (1 изменено, 0 добавлено, 0 удалено)
Подробности
- Свойства страницы
-
- Содержимое
-
... ... @@ -6,11 +6,11 @@ 6 6 7 7 Веб-сервис для интеграции систем авторизованных сервисных центров (АСЦ) с системой провайдера. Веб-сервис позволяет передавать и получать данные по ремонту/трекингу, а также загружать вложения. 8 8 9 -Для использования API необходимо пройти аутентификацию с помощью метода `GetTicket` для получения сессионного ключа, который будет использоваться для всех последующих запросов. 10 - 11 11 = Список методов = 12 12 11 +((( 13 13 == [[CreateTrackingCallCentr>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=CreateTrackingCallCentr]] == 13 +))) 14 14 15 15 Предназначен для создания трекинга из системы колл-центра. 16 16 ... ... @@ -26,6 +26,7 @@ 26 26 |DesRepair|**string (3000)**|Нет|Заявленная неисправность 27 27 |RepairTypeUid|**guid**|Нет|((( 28 28 Тип ремонта (связь с брендами (Default)). Значение берется из метода [[GetSpRepairTypes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetSpRepairTypes]]. Если не заполнено, то подставится «Клиентский гарантийный». 29 + 29 29 30 30 ))) 31 31 |BrandUid|**guid**|Да|Бренд (торговая марка). Значение берётся из [[GetBrands>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].BrandUid ... ... @@ -56,20 +56,20 @@ 56 56 |Result|**Added** or **Changed** or **NotFound** or **Error** or **Unknown**|((( 57 57 Результат выполнения операции: 58 58 59 -+ Added – трекинг создан и помещён в базу 60 -+ Changed – трекинг изменён 61 -+ NotFound – трекинг не найден по uid 62 -+ Error – ошибка в работе метода 63 -+ Unknown – неизвестная ошибка 60 +Added – трекинг создан и помещён в базу 61 + 62 +Changed – трекинг изменён 63 + 64 +NotFound – трекинг не найден по uid 65 + 66 +Error – ошибка в работе метода 67 + 68 +Unknown – неизвестная ошибка 64 64 )))|Added 65 65 |TrackingUri|**string**|Ссылка на трекинг, которую можно открыть в браузере| 66 66 67 -=== Сообщения об ошибках === 68 - 69 69 Секция Errors содержит коллекцию строк ошибок. 70 70 71 -=== Сообщения о валидационных проверках === 72 - 73 73 Секция ValidationErrors содержит коллекцию ErrorItem следующего вида: 74 74 75 75 |Название параметра|Тип параметра|Описание параметра|Пример ... ... @@ -78,56 +78,22 @@ 78 78 |Status|**string**|Статус трекинга| 79 79 |Descriptilon|**string**|Описание ошибки 80 80 82 +* ((( 81 81 == [[DeleteAttachment>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=DeleteAttachment]] == 84 +))) 82 82 83 83 Удаляет вложение трекинга по номеру ремонта АСЦ (OrderNumAsc) и по типу вложения 84 84 85 85 === Входные параметры === 86 86 87 -|Название параметра|Тип параметра|Описание параметра|Пример 88 -|numberKey|string|Идентификатор вложения| 89 -|typeUid|string|Идентификатор типа вложения (GUID)| | 90 - 91 91 === Выходные параметры === 92 92 93 -Возвращает логическое в поле //DeleteAttachmentResult //значение об успешности выполнения операции 94 - 92 +* ((( 95 95 == [[GetANRPInfo>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetANRPInfo]] == 94 +))) 96 96 96 +Получение информации по акту неремонтопригодности. 97 97 98 -Получение информации по акту неремонтопригодности с поиском по номеру АНРП (NSExxxxxxx), номеру ремонта (ETxxxxxxx) или GUID ремонта. 99 - 100 -== Входные параметры == 101 - 102 -|Название параметра|Тип параметра|Обяз.|Описание параметра 103 -|ticket|string|Да|Сессионный ключ 104 -|actID|string|Нет|Номер АНРП (NSExxxxx) 105 -|trackingId|string|Нет|Номер ремонта (ETxxxxxxx) 106 -|trackingUid|guid|Нет|GUID ремонта (b63f5255-198d-46d6-aaa5-9f9255f3de9b) 107 - 108 -== Возвращаемое значение == 109 - 110 -|**Название параметра**|**Тип параметра**|**Описание параметра** 111 -|GetANRPInfoResult|**record**|Структура, содержащая в себе возвращаемые данные 112 -|(% colspan="3" %)**Структура GetANRPInfoResult** 113 -|ASCCodeNoSystem| |(не используется) 114 -|uid|guid|GUID акта 115 -|ActId|string|Номер акта 116 -|CreateDate|dateTime|Дата создания 117 -|ApprovalDate|dateTime|Дата утверждения акта (если он утверждён) 118 -|Brand|string|Бренд 119 -|BrandUid|guid|GUID бренда 120 -|Model|string|Наименование модели 121 -|SerialNumber|string|Серийный номер аппарата (если предусмотрен) 122 -|TrackingId|string|Номер трекинга 123 -|TrackingId|guid|GUID трекинга 124 -|ASCCode|string|Код АСЦ 125 -|ASCName|string|Наименование АСЦ 126 -|ASCCity|string|Город АСЦ 127 -|isApproved|boolean|Утверждён ли акт? 128 -|ErrorText|string|Сообщение об ошибке в акте 129 - 130 - 131 131 * ((( 132 132 == [[GetATOInfo>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetATOInfo]] == 133 133 ))) ... ... @@ -647,17 +647,18 @@ 647 647 |Id|**int**|Id типа ремонта| 648 648 |Description|**string**|Описание типа ремонта| 649 649 617 +* ((( 650 650 == [[GetSpStatuses>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]] == 619 +))) 651 651 652 - 653 653 Возвращает список статусов трекинга. 654 654 655 - ===Входные параметры:===623 +**Входные параметры:** 656 656 657 657 |Название параметра|Тип параметра|Обяз.|Описание параметра|Пример 658 658 |ticket|**string**|Да|Сессионный ключ|srry8gJT2TJNZzckI6vGWwiRGZ6BcurM 659 659 660 - ===Возвращаемоезначение:===628 +**Выходные параметры:** 661 661 662 662 Возвращает коллекцию StatusItem следующего вида: 663 663 ... ... @@ -667,17 +667,19 @@ 667 667 |Description|**string (100)**|Описание статуса|ОТЧЕТ 668 668 |IsEnd|**boolean**|Является ли статус конечным|false 669 669 638 +* ((( 670 670 == [[GetTicket>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetTicket]] == 640 +))) 671 671 672 672 Получение бинарного идентификатора для аутентификации пользователя по логину и паролю. 673 673 674 - ===Входные параметры:===644 +Входные параметры: 675 675 676 676 |(% style="width:206px" %)Название параметра|(% style="width:130px" %)Тип параметра|(% style="width:70px" %)Обяз.|(% style="width:234px" %)Описание параметра|(% style="width:343px" %)Пример 677 677 |(% style="width:206px" %)Login|(% style="width:130px" %)**string**|(% style="width:70px" %)Да|(% style="width:234px" %)Логин пользователя|(% style="width:343px" %)Vasya 678 678 |(% style="width:206px" %)Password|(% style="width:130px" %)**string**|(% style="width:70px" %)Да|(% style="width:234px" %)Пароль пользователя|(% style="width:343px" %)123456 679 679 680 - ===Возвращаемое значение:===650 +Возвращаемое значение: 681 681 682 682 |Тип параметра|Описание параметра|Пример 683 683 |string|Сессионный ключ|YOB7IG8UG687068 ... ... @@ -700,11 +700,13 @@ 700 700 701 701 Создание вложения определенного типа в трекинге, с удалением всех вложений того же типа 702 702 673 +* ((( 703 703 == [[SaveOrder>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]] == 675 +))) 704 704 705 705 Создание/обновление трекинга. 706 706 707 - ===Входные параметры:===679 +Входные параметры: 708 708 709 709 |Название параметра|Тип параметра|Обяз?|Описание параметра|Пример 710 710 |ticket|**string**|Да|Сессионный ключ|YOB7IG8UG687068 ... ... @@ -712,7 +712,7 @@ 712 712 структура содержащая данные, идентична секции Tracking в методе [[GetOrderBySysKey>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetOrderBySysKey]] 713 713 )))| 714 714 715 - ===Выходные параметры:===687 +Выходные параметры: 716 716 717 717 |Название параметра|Тип параметра|Описание параметра|Пример 718 718 |TrackingUid|**guid**|Уникальный идентификатор трекинга. Значение можно использовать для дальнейших вызовов метода SaveOrder, если нужно обновить значения трекинга.|