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

Редактировал(а) Дмитрий Семёнов 2025/04/10 15:52
От версии < 3.1 >
отредактировано Григорий Лепёшкин
на 2023/12/21 11:50
К версии < 21.1 >
отредактировано Дмитрий Семёнов
на 2025/03/19 14:42
< >
Изменить комментарий: К данной версии нет комментариев

Комментарий

Подробности

Свойства страницы
Родительский документ
... ... @@ -1,1 +1,1 @@
1 -Процессы для ремонта техники .WebHome
1 +Сервисные процессы.WebHome
Автор документа
... ... @@ -1,1 +1,1 @@
1 -XWiki.GrigoryLepeshkin
1 +XWiki.DmitriySemenov
Содержимое
... ... @@ -6,41 +6,718 @@
6 6  
7 7  Веб-сервис для интеграции систем авторизованных сервисных центров (АСЦ) с системой провайдера. Веб-сервис позволяет передавать и получать данные по ремонту/трекингу, а также загружать вложения.
8 8  
9 +Для использования API необходимо пройти аутентификацию с помощью метода `GetTicket` для получения сессионного ключа, который будет использоваться для всех последующих запросов.
10 +
9 9  = Список методов =
10 10  
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]] - Создание/обновление трекинга.
13 +== [[CreateTrackingCallCentr>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=CreateTrackingCallCentr]] ==
38 38  
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://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetSpRepairTypes]]. Если не заполнено, то подставится «Клиентский гарантийный».
29 +
30 +
31 +)))
32 +|BrandUid|**guid**|Да|Бренд (торговая марка). Значение берётся из [[GetBrands>>url:http://care.ellpa.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 +|CWorkTel|**string (15)**|Нет|Рабочий телефон клиента
45 +|CHomeTel|**string (15)**|Нет|Домашний телефон клиента
46 +|Cemail|**string (255)**|Нет|Email клиента
47 +|PurchDate|**datetime**|Нет|Дата продажи
48 +|UrlQuestionnaire|**string**|Нет|URL на анкету для прохождения опроса по завершению ремонта
49 +
50 +=== Выходные параметры: ===
51 +
52 +|Название параметра|Тип параметра|Описание параметра|Пример
53 +|TrackingUid|**guid**|Уникальный идентификатор трекинга. Значение можно использовать для дальнейших вызовов метода [[SaveOrder>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]], если необходимо обновить значения трекинга.|
54 +|SysNum|**string**|Системный номер трекинга (учётный номер ремонта в системе)|
55 +|StatusName|**string**|Статус трекинга|
56 +|StatusUid|**guid**|UID статуса трекинга. Значение берётся из [[GetSpStatuses>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].|
57 +|Result|**Added** or **Changed** or **NotFound** or **Error** or **Unknown**|(((
58 +Результат выполнения операции:
59 +
60 +Added – трекинг создан и помещён в базу
61 +
62 +Changed – трекинг изменён
63 +
64 +NotFound – трекинг не найден по uid
65 +
66 +Error – ошибка в работе метода
67 +
68 +Unknown – неизвестная ошибка
69 +)))|Added
70 +|TrackingUri|**string**|Ссылка на трекинг, которую можно открыть в браузере|
71 +
72 +Секция Errors содержит коллекцию строк ошибок.
73 +
74 +Секция ValidationErrors содержит коллекцию ErrorItem следующего вида:
75 +
76 +|Название параметра|Тип параметра|Описание параметра|Пример
77 +|ErrorCode|**string**|Код ошибки|
78 +|ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.|
79 +|Status|**string**|Статус трекинга|
80 +|Descriptilon|**string**|Описание ошибки
81 +
82 +* (((
83 +== [[DeleteAttachment>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=DeleteAttachment]] ==
84 +)))
85 +
86 +Удаляет вложение трекинга по номеру ремонта АСЦ (OrderNumAsc) и по типу вложения
87 +
88 +=== Входные параметры ===
89 +
90 +=== Выходные параметры ===
91 +
92 +* (((
93 +== [[GetANRPInfo>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetANRPInfo]] ==
94 +)))
95 +
96 +Получение информации по акту неремонтопригодности.
97 +
98 +* (((
99 +== [[GetATOInfo>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetATOInfo]] ==
100 +)))
101 +
102 +Получение информации по акту технического освидетельствования.
103 +
104 +* (((
105 +== [[GetActionPlace>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetActionPlace]] ==
106 +)))
107 +
108 +Возвращает справочник мест ремонта.
109 +
110 +* (((
111 +== [[GetAttachment>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetAttachment]] ==
112 +)))
113 +
114 +Возвращает вложение по номеру ремонта АСЦ (OrderNumAsc) и по типу вложения.
115 +
116 +* (((
117 +== [[GetAttachmentKeys>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetAttachmentKeys]] ==
118 +)))
119 +
120 +Возвращает список вложений по системному номеру трекинга (OrderNum) без самих вложений.
121 +
122 +* (((
123 +== [[GetAttachmentTypes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetAttachmentTypes]] ==
124 +)))
125 +
126 +Возвращает список типов вложений
127 +
128 +* (((
129 +== [[GetBrands>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]] ==
130 +)))
131 +
132 +Возвращает список брендов в разрезе групп брендов.
133 +
134 +**Входные параметры:**
135 +
136 +Секция message
137 +
138 +|Название параметра|Тип параметра|Обяз?|Описание параметра|Пример
139 +|ticket|**string**|Да|Сессионный ключ|Vasya
140 +
141 +**Выходные параметры:**
142 +
143 +Возвращает коллекцию BrandItem следующего вида:
144 +
145 +|Название параметра|Тип параметра|Описание параметра|Пример
146 +|MainBrandUid|**guid**|Идентификатор группы брендов|7e86699d-50a4-4b5d-8627-f8c8da56f053
147 +|MainBrandName|**string (50)**|Наименование группы брендов|PHILIPS
148 +|BrandUid|**guid**|Идентификатор бренда модели|4f94a810-2f0d-48a0-bbd0-c9617390efd3
149 +|BrandName|**string (50)**|Наименование бренда модели|PHILIPS
150 +
151 +* (((
152 +== [[GetCategIrisConditionCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]] ==
153 +)))
154 +
155 +Возвращает справочник Iris Код условий по бренду и категории модели.
156 +
157 +* (((
158 +== [[GetCategIrisDefectCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]] ==
159 +)))
160 +
161 +Возвращает справочник Iris Код дефектов по бренду и категории модели.
162 +
163 +* (((
164 +== [[GetCategIrisRepairCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]] ==
165 +)))
166 +
167 +Возвращает справочник Iris Код ремонтов по бренду и категории модели.
168 +
169 +* (((
170 +== [[GetCategIrisSectionCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]] ==
171 +)))
172 +
173 +Возвращает справочник Iris Код секций по бренду и категории модели.
174 +
175 +* (((
176 +== [[GetCategIrisSymptomCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]] ==
177 +)))
178 +
179 +Возвращает справочник Iris Код симптомов по бренду и категории модели.
180 +
181 +* (((
182 +== [[GetIrisCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetIrisCodes]] ==
183 +)))
184 +
185 +Возвращает Iris коды в разрезе типов Iris кодов (ConditionCode, DefectCode, RepairCode, sectionCode, SymptomCode), категорий моделей и брендов (в рамках активных авторизаций по брендам)
186 +
187 +* (((
188 +== [[GetModelCategories>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetModelCategories]] ==
189 +)))
190 +
191 +Возвращает справочник категорий моделей.
192 +
193 +* (((
194 +== [[GetOrderByAscKey>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetOrderByAscKey]] ==
195 +)))
196 +
197 +Возвращает трекинг по номеру ремонта АСЦ (OrderNumAsc)
198 +
199 +**Входные параметры:**
200 +
201 +|Название параметра|Тип параметра|Обяз?|Описание параметра|Пример
202 +|ticket|**string**|Да|Сессионный ключ|YOB7IG8UG687068
203 +|(((
204 +numberKey
205 +
206 +
207 +)))|**string**|Да|Собственный номер ремонта АСЦ.|1.0.0.0
208 +
209 +**Выходные параметры:**
210 +
211 +**Секция Tracking**
212 +
213 +|Название параметра|Тип параметра|Описание параметра|Пример
214 +|uid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]] в случае, если нужно обновить значения трекинга.|6e18064e-1cd3-4207-8ebe-08c4417db2be
215 +|Brand|**guid**|Группа брендов. Значение берётся из поля MainBrandUid из [[GetBrands>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b457927a-766e-44b1-a79d-508adee3a915
216 +|Model|**string (50)**|Строка названия модели|121
217 +|OrderNum|**string (50)**|Строка номера ремонта|0000018
218 +|OrderNumBrand|**string (50)**|Номер заявки колл-центра|
219 +|ReceiveDate|**datetime**|Дата получения товара в ремонт|
220 +|ReadyDate|**datetime**|Дата готовности|
221 +|ReadyOutDate|**datetime**|Дата готовности к выдаче|
222 +|OutDate|**datetime**|Дата выдачи|
223 +|PurchDate|**datetime**|Дата покупки|
224 +|SerialNumb|**string (50)**|Серийный номер|
225 +|ProductNumb|**string (50)**|Продуктовый номер|
226 +|EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|2023-04-07T18:16:10.783
227 +|TransportService|**guid**|Вид транспортировки. Значение берётся из [[GetTransportService>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]].|f34fa37d-b678-469d-9129-6ac9d9d270f7
228 +|PlanTransportDate|**datetime**|Плановая дата доставки|
229 +|Status|**guid**|Статус. Значение берётся из [[GetSpStatuses>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].|51deb04d-b307-4efc-826a-2d0e3d151d1d
230 +|MasterASC|**string (255)**|ФИО мастера|
231 +|CreateDate|**datetime**|Дата создания (в первый раз будет заменена на текущую)|2023-04-03T16:56:20.74
232 +|ComplectPack|**int**|Наличие коробки|
233 +|ComplectWarr|**int**|Наличие гарантийного талона|
234 +|ComplectCheck|**int**|Наличие чека|
235 +|PlanMasterDate|**datetime**|Планируемая дата выезда|
236 +|IsExpRep|**boolean**|Флаг экспресс-ремонта|
237 +|ServiceBulletin|**string (255)**|Сервисный бюллетень|
238 +|ActionPlace|**guid**|Место ремонта. Значение берётся из [[GetActionPlace>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetActionPlace]].|87da8c9b-61d8-4db0-825b-9c39adf1f50b
239 +|DesRepair|**string (3000)**|Заявленная неисправность|test
240 +|DescriptionCC|**string (3000)**|Результат диагностики оператором Call Центра|
241 +|DescriptionCompCent|**string (3000)**|Резюме центра компетенции|
242 +|DiagnosticResult|**string (3000)**|Результат диагностики|
243 +|Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
244 +|Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
245 +|Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]].|
246 +|Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]].|
247 +|Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]].|
248 +|LocationCode|**string (50)**|Позиционный номер|
249 +|DName|**string (255)**|Наименование дилера|
250 +|DCity|**string (255)**|Город дилера|
251 +|DAddress|**string (255)**|Адрес дилера|
252 +|DTel|**string (11)**|Телефон дилера|
253 +|Demail|**string (255)**|Email дилера|
254 +|DComments|**string (500)**|Дополнительная информация дилера|
255 +|CName|**string (255)**|Имя клиента|
256 +|CSurname|**string (255)**|Фамилия клиента|
257 +|CPatronymic|**string (255)**|Отчество клиента|
258 +|CCity|**string (255)**|Город клиента|
259 +|CAddress|**string (255)**|Адрес клиента|
260 +|CHouse|**string (5)**|Номер дома клиента|
261 +|CBuild|**string (5)**|Корпус клиента|
262 +|CFlat|**string (5)**|Номер квартиры клиента|
263 +|CHomeTel|**string (11)**|Домашний телефон клиента|
264 +|CWorkTel|**string (11)**|Рабочий телефон клиента|
265 +|CMobTel|**string (13)**|Мобильный телефон клиента|
266 +|Cemail|**string (255)**|Email клиента|
267 +|CComments|**string (500)**|Дополнительная информация клиента|
268 +|CLift|**int**|Наличие лифта в доме клиента|
269 +|CDomofon|**string (50)**|Код домофона у клиента|
270 +|OrderNumAsc|**string (50)**|Номер ремонта в системе АСЦ|
271 +|StartRepairDate|**datetime**|Дата начала ремонта АСЦ|
272 +|RegularSWnumberIN|**string (255)**|Версия прошивки "Main SW" при поступлении в ремонт|
273 +|RegularSWnumberOUT|**string (255)**|Версия прошивки "Main SW" при выдаче из ремонта|
274 +|StandBySWnumberIN|**string (255)**|Версия прошивки "Stand By SW" при поступлении в ремонт|
275 +|StandBySWnumberOUT|**string (255)**|Версия прошивки "Stand By" при выдаче из ремонта|
276 +|(((
277 +ConditionDescr
278 +
279 +
280 +)))|**string (255)**|Описание Iris кода условия|1-Постоянно
281 +|RepairTypeCurrent|**guid**|Тип ремонта текущий (связь с брендами (Default))|b7a77d5a-e95a-11d9-b44e-000476de6b1e
282 +|RepairTypeStart|**guid**|Тип ремонта начальный (связь с брендами (Default))|
283 +|TransportZone|**guid**|Зона транспортировки. Значение берётся из GetTransportZone.|85df2056-e60f-4bc1-a21c-17c9f6c9241a
284 +|UidNRP|**guid**|Uid акта НРП|
285 +|RealBrand|**guid**|Бренд (торговая марка). Значение берётся из [[GetBrands>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b8a3f06b-cacf-4a9b-b3f7-089c266ea654
286 +|(((
287 +IWS
288 +
289 +
290 +)))|**string (255)**|Номер IWS|b8a3f06b-cacf-4a9b-b3f7-089c266ea654
291 +|RegionUid|**guid**|Город АСЦ.|
292 +|Recommendation|**string (3000)**|Рекомендации мастера по эксплуатации|
293 +|IMEI1|**string (255)**|IMEI1|
294 +|IMEI2|**string (255)**|IMEI2|
295 +|IMEI3|**string (255)**|IMEI3|
296 +|IMEI4|**string (255)**|IMEI4|
297 +|IMEI1NEW|**string (255)**|IMEI1 новый|
298 +|IMEI2NEW|**string (255)**|IMEI2 новый|
299 +|IMEI3NEW|**string (255)**|IMEI3 новый|
300 +|IMEI4NEW|**string (255)**|IMEI4 новый|
301 +|RepairLevel|**string (300)**|Уровень ремонта|
302 +
303 +Подсекция Parts секции Tracking состоит из коллекции типа PartRecord следующего формата:
304 +
305 +|Название параметра|Тип параметра|Описание параметра|Пример
306 +|uid|**guid**|Уникальный идентификатор детали/з/ч. Значение берётся из предыдущего вызова метода SaveOrder в случае, если нужно обновить значения трекинга.|
307 +|CreateDate|**datetime**|Дата создания (будет заменена на текущую)|
308 +|PartNumber|**string (100)**|ПартНомер|
309 +|PartName|**string (255)**|Наименование детали|
310 +|Price|**decimal**|Цена отгрузки|
311 +|Qnt|**int**|Количество|
312 +|Compensate|**decimal**|Размер компенсации для ASC|
313 +|ASCOrderNo|**string (100)**|№ заказа ACЦ (ссылка на заказ)|
314 +|SPOrderNo|**string (100)**|№ заявки з/ч (проверка при создании акта НРП)|
315 +|OrderCreate|**datetime**|Дата заказа запчасти|
316 +|PrognoseDate|**datetime**|Ожидаемая дата получения з/ч|
317 +|OrderUid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]].|
318 +|AscItemKey|**string (50)**|Внутренний ID детали АСЦ|
319 +|TypeOrder|**guid**|Тип заказчика, в основном пустой или АСЦ|9314B01D-3D61-426C-BCAF-BFDEF25AAA56
320 +|InvoiceNum|**string (50)**|Номер накладной|
321 +|InvoiceDate|**datetime**|Дата накладной|
322 +|InvoiceRef|**guid**|Ссылка на позицию в накладной. Не используется в данное время|
323 +|AscStore|**int**|(((
324 +~=1, если деталь получена АСЦ не у провайдера, а со стороны
325 +
326 +~=0, если получена АСЦ у провайдера.
327 +
328 +Возможность указывать детали своего склада зависит от настроек авторизации по бренду.
329 +)))|
330 +|Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
331 +|Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
332 +|Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]].|
333 +|Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]].|
334 +|Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]].|
335 +|LocationCode|**string (50)**|Позиционный номер|
336 +|EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|
337 +|EditUser|**guid**|Идентификатор пользователя|
338 +|ProblemPartSerial|**string (255)**|Серийный номер неисправной детали|
339 +|SetupPartSerial|**string (255)**|Серийный номер установленной детали|
340 +
341 +**Секция Payment**
342 +
343 +|Название параметра|Тип параметра|Описание параметра|Пример
344 +|uid|**guid**|Идентификатор заказа|00000000-0000-0000-0000-000000000000
345 +|Labor|**decimal**|Стоимость работы|
346 +|BonusASC|**decimal**|Бонус АСЦ|
347 +|Handling|**decimal**|Фиксированный тариф провайдера|
348 +|BonusCSP|**decimal**|Переменное вознаграждение провайдера|
349 +|BonusCSPPercent|**decimal**|Процент ~(% от тарифа) на момент формирования инвойса|
350 +|SU|**decimal**|Оплата доставки з/ч провайдера|
351 +|Transport|**decimal**|Оплата транспортировки/выезда|
352 +|SparePartsASC|**decimal**|Сумма компенсации з/ч АСЦ|
353 +|SparePartsCSP|**decimal**|Сумма компенсации з/ч провайдера|
354 +|AdditionalLabor|**decimal**|Оплата дополнительных работ АСЦ|
355 +|ASCSumm|**decimal**|Итого оплата АСЦ|
356 +|CSPSumm|**decimal**|Итого оплата провайдера|
357 +|TotalSumm|**decimal**|Итого сумма отплаты|
358 +|LaborCSP|**decimal**|Стоимость работы провайдера|
359 +|LaborPSU|**decimal**|Стоимость ремонта PSU|
360 +|LaborSSB|**decimal**|Стоимость ремонта SSB|
361 +|AdditionalLaborTotal|**decimal**|Всего стоимость дополнительных работ|
362 +|BonusASCPercent|**decimal**|Процент бонусов АСЦ|
363 +|SparePartsTotal|**decimal**|Всего стоимость з/ч|
364 +|AdditionalLaborDescr|**String (1000)**|Описание дополнительных работ|
365 +
366 +**Отдельный параметр**
367 +
368 +|Название параметра|Тип параметра|Описание параметра|Пример
369 +|RefUri|**string**|Ссылка на трекинг, которую можно открыть в браузере|
370 +
371 +Секция ValidationErrors содержит коллекцию ErrorItem следующего вида:
372 +
373 +|Название параметра|Тип параметра|Описание параметра|Пример
374 +|ErrorCode|**string**|Код ошибки|43
375 +|ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.|1
376 +|Status|**string**|Статус трекинга|
377 +|Descriptilon|**string**|Описание ошибки|Для продолжения ремонта необходимо ввести, по крайней мере, одну запасную часть
378 +
379 +* (((
380 +== [[GetOrderBySysKey>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetOrderBySysKey]] ==
381 +)))
382 +
383 +Возвращает трекинг по системному номеру (OrderNum).
384 +
385 +**Входные параметры:**
386 +
387 +|Название параметра|Тип параметра|Обяз?|Описание параметра|Пример
388 +|ticket|**string**|Да|Сессионный ключ|YOB7IG8UG687068
389 +|(((
390 +numberKey
391 +
392 +
393 +)))|**string**|Да|Системный номер ремонта. OrderNum секции трекинг.|1.0.0.0
394 +
395 +**Выходные параметры:**
396 +
397 +**Секция Tracking**
398 +
399 +|Название параметра|Тип параметра|Описание параметра|Пример
400 +|uid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]] в случае, если нужно обновить значения трекинга.|6e18064e-1cd3-4207-8ebe-08c4417db2be
401 +|Brand|**guid**|Группа брендов. Значение берётся из поля MainBrandUid из [[GetBrands>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b457927a-766e-44b1-a79d-508adee3a915
402 +|Model|**string (50)**|Строка названия модели|121
403 +|OrderNum|**string (50)**|Строка номера ремонта|0000018
404 +|OrderNumBrand|**string (50)**|Номер заявки колл-центра|
405 +|ReceiveDate|**datetime**|Дата получения товара в ремонт|
406 +|ReadyDate|**datetime**|Дата готовности|
407 +|ReadyOutDate|**datetime**|Дата готовности к выдаче|
408 +|OutDate|**datetime**|Дата выдачи|
409 +|PurchDate|**datetime**|Дата покупки|
410 +|SerialNumb|**string (50)**|Серийный номер|
411 +|ProductNumb|**string (50)**|Продуктовый номер|
412 +|EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|2023-04-07T18:16:10.783
413 +|TransportService|**guid**|Вид транспортировки. Значение берётся из [[GetTransportService>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]].|f34fa37d-b678-469d-9129-6ac9d9d270f7
414 +|PlanTransportDate|**datetime**|Плановая дата доставки|
415 +|Status|**guid**|Статус. Значение берётся из [[GetSpStatuses>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].|51deb04d-b307-4efc-826a-2d0e3d151d1d
416 +|MasterASC|**string (255)**|ФИО мастера|
417 +|CreateDate|**datetime**|Дата создания (в первый раз будет заменена на текущую)|2023-04-03T16:56:20.74
418 +|ComplectPack|**int**|Наличие коробки|
419 +|ComplectWarr|**int**|Наличие гарантийного талона|
420 +|ComplectCheck|**int**|Наличие чека|
421 +|PlanMasterDate|**datetime**|Планируемая дата выезда|
422 +|IsExpRep|**boolean**|Флаг экспресс-ремонта|
423 +|ServiceBulletin|**string (255)**|Сервисный бюллетень|
424 +|ActionPlace|**guid**|Место ремонта. Значение берётся из [[GetActionPlace>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetActionPlace]].|87da8c9b-61d8-4db0-825b-9c39adf1f50b
425 +|DesRepair|**string (3000)**|Заявленная неисправность|test
426 +|DescriptionCC|**string (3000)**|Результат диагностики оператором Call Центра|
427 +|DescriptionCompCent|**string (3000)**|Резюме центра компетенции|
428 +|DiagnosticResult|**string (3000)**|Результат диагностики|
429 +|Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
430 +|Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
431 +|Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]].|
432 +|Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]].|
433 +|Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]].|
434 +|LocationCode|**string (50)**|Позиционный номер|
435 +|DName|**string (255)**|Наименование дилера|
436 +|DCity|**string (255)**|Город дилера|
437 +|DAddress|**string (255)**|Адрес дилера|
438 +|DTel|**string (11)**|Телефон дилера|
439 +|Demail|**string (255)**|Email дилера|
440 +|DComments|**string (500)**|Дополнительная информация дилера|
441 +|CName|**string (255)**|Имя клиента|
442 +|CSurname|**string (255)**|Фамилия клиента|
443 +|CPatronymic|**string (255)**|Отчество клиента|
444 +|CCity|**string (255)**|Город клиента|
445 +|CAddress|**string (255)**|Адрес клиента|
446 +|CHouse|**string (5)**|Номер дома клиента|
447 +|CBuild|**string (5)**|Корпус клиента|
448 +|CFlat|**string (5)**|Номер квартиры клиента|
449 +|CHomeTel|**string (11)**|Домашний телефон клиента|
450 +|CWorkTel|**string (11)**|Рабочий телефон клиента|
451 +|CMobTel|**string (13)**|Мобильный телефон клиента|
452 +|Cemail|**string (255)**|Email клиента|
453 +|CComments|**string (500)**|Дополнительная информация клиента|
454 +|CLift|**int**|Наличие лифта в доме клиента|
455 +|CDomofon|**string (50)**|Код домофона у клиента|
456 +|OrderNumAsc|**string (50)**|Номер ремонта в системе АСЦ|
457 +|StartRepairDate|**datetime**|Дата начала ремонта АСЦ|
458 +|RegularSWnumberIN|**string (255)**|Версия прошивки "Main SW" при поступлении в ремонт|
459 +|RegularSWnumberOUT|**string (255)**|Версия прошивки "Main SW" при выдаче из ремонта|
460 +|StandBySWnumberIN|**string (255)**|Версия прошивки "Stand By SW" при поступлении в ремонт|
461 +|StandBySWnumberOUT|**string (255)**|Версия прошивки "Stand By" при выдаче из ремонта|
462 +|(((
463 +ConditionDescr
464 +
465 +
466 +)))|**string (255)**|Описание Iris кода условия|1-Постоянно
467 +|RepairTypeCurrent|**guid**|Тип ремонта текущий (связь с брендами (Default))|b7a77d5a-e95a-11d9-b44e-000476de6b1e
468 +|RepairTypeStart|**guid**|Тип ремонта начальный (связь с брендами (Default))|
469 +|TransportZone|**guid**|Зона транспортировки. Значение берётся из GetTransportZone.|85df2056-e60f-4bc1-a21c-17c9f6c9241a
470 +|UidNRP|**guid**|Uid акта НРП|
471 +|RealBrand|**guid**|Бренд (торговая марка). Значение берётся из [[GetBrands>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]].|b8a3f06b-cacf-4a9b-b3f7-089c266ea654
472 +|(((
473 +IWS
474 +
475 +
476 +)))|**string (255)**|Номер IWS|b8a3f06b-cacf-4a9b-b3f7-089c266ea654
477 +|RegionUid|**guid**|Город АСЦ.|
478 +|Recommendation|**string (3000)**|Рекомендации мастера по эксплуатации|
479 +|IMEI1|**string (255)**|IMEI1|
480 +|IMEI2|**string (255)**|IMEI2|
481 +|IMEI3|**string (255)**|IMEI3|
482 +|IMEI4|**string (255)**|IMEI4|
483 +|IMEI1NEW|**string (255)**|IMEI1 новый|
484 +|IMEI2NEW|**string (255)**|IMEI2 новый|
485 +|IMEI3NEW|**string (255)**|IMEI3 новый|
486 +|IMEI4NEW|**string (255)**|IMEI4 новый|
487 +|RepairLevel|**string (300)**|Уровень ремонта|
488 +
489 +Подсекция Parts секции Tracking состоит из коллекции типа PartRecord следующего формата:
490 +
491 +|Название параметра|Тип параметра|Описание параметра|Пример
492 +|uid|**guid**|Уникальный идентификатор детали/з/ч. Значение берётся из предыдущего вызова метода SaveOrder в случае, если нужно обновить значения трекинга.|
493 +|CreateDate|**datetime**|Дата создания (будет заменена на текущую)|
494 +|PartNumber|**string (100)**|ПартНомер|
495 +|PartName|**string (255)**|Наименование детали|
496 +|Price|**decimal**|Цена отгрузки|
497 +|Qnt|**int**|Количество|
498 +|Compensate|**decimal**|Размер компенсации для ASC|
499 +|ASCOrderNo|**string (100)**|№ заказа ACЦ (ссылка на заказ)|
500 +|SPOrderNo|**string (100)**|№ заявки з/ч (проверка при создании акта НРП)|
501 +|OrderCreate|**datetime**|Дата заказа запчасти|
502 +|PrognoseDate|**datetime**|Ожидаемая дата получения з/ч|
503 +|OrderUid|**guid**|Уникальный идентификатор трекинга. Значение берётся из предыдущего вызова метода [[SaveOrder>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]].|
504 +|AscItemKey|**string (50)**|Внутренний ID детали АСЦ|
505 +|TypeOrder|**guid**|Тип заказчика, в основном пустой или АСЦ|9314B01D-3D61-426C-BCAF-BFDEF25AAA56
506 +|InvoiceNum|**string (50)**|Номер накладной|
507 +|InvoiceDate|**datetime**|Дата накладной|
508 +|InvoiceRef|**guid**|Ссылка на позицию в накладной. Не используется в данное время|
509 +|AscStore|**int**|(((
510 +~=1, если деталь получена АСЦ не у провайдера, а со стороны
511 +
512 +~=0, если получена АСЦ у провайдера.
513 +
514 +Возможность указывать детали своего склада зависит от настроек авторизации по бренду.
515 +)))|
516 +|Section|**string (3)**|Код секции. Значение берётся из [[GetCategIrisSectionCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]].|
517 +|Condition|**string (3)**|Код условия. Значение берётся из [[GetCategIrisConditionCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]].|
518 +|Symptom|**string (3)**|Код симптома. Значение берётся из [[GetCategIrisSymptomCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]].|
519 +|Defect|**string (3)**|Код дефекта. Значение берётся из [[GetCategIrisDefectCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]].|
520 +|Repair|**string (3)**|Код ремонта. Значение берётся из [[GetCategIrisRepairCodes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]].|
521 +|LocationCode|**string (50)**|Позиционный номер|
522 +|EditDate|**datetime**|Дата редактирования (будет заменена на текущую)|
523 +|EditUser|**guid**|Идентификатор пользователя|
524 +|ProblemPartSerial|**string (255)**|Серийный номер неисправной детали|
525 +|SetupPartSerial|**string (255)**|Серийный номер установленной детали|
526 +
527 +**Секция Payment**
528 +
529 +|Название параметра|Тип параметра|Описание параметра|Пример
530 +|uid|**guid**|Идентификатор заказа|00000000-0000-0000-0000-000000000000
531 +|Labor|**decimal**|Стоимость работы|
532 +|BonusASC|**decimal**|Бонус АСЦ|
533 +|Handling|**decimal**|Фиксированный тариф провайдера|
534 +|BonusCSP|**decimal**|Переменное вознаграждение провайдера|
535 +|BonusCSPPercent|**decimal**|Процент ~(% от тарифа) на момент формирования инвойса|
536 +|SU|**decimal**|Оплата доставки з/ч провайдера|
537 +|Transport|**decimal**|Оплата транспортировки/выезда|
538 +|SparePartsASC|**decimal**|Сумма компенсации з/ч АСЦ|
539 +|SparePartsCSP|**decimal**|Сумма компенсации з/ч провайдера|
540 +|AdditionalLabor|**decimal**|Оплата дополнительных работ АСЦ|
541 +|ASCSumm|**decimal**|Итого оплата АСЦ|
542 +|CSPSumm|**decimal**|Итого оплата провайдера|
543 +|TotalSumm|**decimal**|Итого сумма отплаты|
544 +|LaborCSP|**decimal**|Стоимость работы провайдера|
545 +|LaborPSU|**decimal**|Стоимость ремонта PSU|
546 +|LaborSSB|**decimal**|Стоимость ремонта SSB|
547 +|AdditionalLaborTotal|**decimal**|Всего стоимость дополнительных работ|
548 +|BonusASCPercent|**decimal**|Процент бонусов АСЦ|
549 +|SparePartsTotal|**decimal**|Всего стоимость з/ч|
550 +|AdditionalLaborDescr|**String (1000)**|Описание дополнительных работ|
551 +
552 +**Отдельный параметр**
553 +
554 +|Название параметра|Тип параметра|Описание параметра|Пример
555 +|RefUri|**string**|Ссылка на трекинг, которую можно открыть в браузере|
556 +
557 +Секция ValidationErrors содержит коллекцию ErrorItem следующего вида:
558 +
559 +|Название параметра|Тип параметра|Описание параметра|Пример
560 +|ErrorCode|**string**|Код ошибки|43
561 +|ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.|1
562 +|Status|**string**|Статус трекинга|
563 +|Descriptilon|**string**|Описание ошибки|Для продолжения ремонта необходимо ввести, по крайней мере, одну запасную часть
564 +
565 +* (((
566 +== [[GetOrderKeys>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetOrderKeys]] ==
567 +)))
568 +
569 +Возвращает список трекингов, перешедших в конечный статус в последние 35 дней и всех остальных, не перешедших в конечный статус.
570 +
571 +Входные параметры:
572 +
573 +|(% style="width:180px" %)Название параметра|(% style="width:141px" %)Тип параметра|(% style="width:79px" %)Обяз.|(% style="width:415px" %)Описание параметра|(% style="width:168px" %)Пример
574 +|(% style="width:180px" %)ticket|(% style="width:141px" %)**string**|(% style="width:79px" %)Да|(% style="width:415px" %)Сессионный ключ|(% style="width:168px" %)YOB7IG8UG687068
575 +
576 +Выходные параметры:
577 +
578 +Возвращает коллекцию TrackingShortItem следующего вида:
579 +
580 +|Название параметра|Тип параметра|Описание параметра|Пример
581 +|Uid|**guid**|Идентификатор ремонта|bf181853-8a82-4d7a-91b0-002e1105fe10
582 +|NumKey|**string (50)**|Код ремонта в системе|ET0000001
583 +|AscKey|**string (50)**|Код АСЦ ремонта|11947
584 +|Status|**guid**|Статус. Значения из [[GetSpStatuses>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]]|574fa171-5482-4979-be0f-117a3dd0dd29
585 +|LastEditDate|**dateTime**|Дата последнего редактирования ремонта|2015-03-17T15:41:39.923
586 +|MainBrandUid|**guid**|Идентификатор группы брендов. Значения из поля MainBrandUid из [[GetBrands>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]]|b457927a-766e-44b1-a79d-508adee3a915
587 +|BrandUid|**guid**|Идентификатор бренда модели. Значения из поля BrandUid из [[GetBrands>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]]|318c5448-3632-413e-ba36-16a95d85bb26
588 +
589 +* (((
590 +== [[GetRejectReasons>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetRejectReasons]] ==
591 +)))
592 +
593 +Список причин отмены трекинга
594 +
595 +* (((
596 +== [[GetSpRepairTypes>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetSpRepairTypes]] ==
597 +)))
598 +
599 +Возвращает справочник типов ремонтов по группе брендов (MainBrandUid).
600 +
601 +**Входные параметры:**
602 +
603 +|Название параметра|Тип параметра|Обяз?|Описание параметра|Пример
604 +|MainBrandUid|**guid**|Да|Ссылка на группу брендов, возвращаемую методом GetBrands|
605 +|ticket|**string**|Да|Сессионный ключ|srry8gJT2TJNZzckI6vGWwiRGZ6BcurM
606 +
607 +**Выходные параметры:**
608 +
609 +Возвращает коллекцию RefItem следующего вида:
610 +
611 +|Название параметра|Тип параметра|Описание параметра|Пример
612 +|Uid|**guid**|Идентификатор типа ремонта|b7a77d5a-e95a-11d9-b44e-000476de6b1e
613 +|Name|**string (255)**|Наименование типа ремонта|Гарантийный ремонт
614 +|Id|**int**|Id типа ремонта|
615 +|Description|**string**|Описание типа ремонта|
616 +
617 +
618 +== [[GetSpStatuses>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]] ==
619 +
620 +
621 +Возвращает список статусов трекинга.
622 +
623 +=== Входные параметры: ===
624 +
625 +|Название параметра|Тип параметра|Обяз.|Описание параметра|Пример
626 +|ticket|**string**|Да|Сессионный ключ|srry8gJT2TJNZzckI6vGWwiRGZ6BcurM
627 +
628 +=== Возвращаемое значение: ===
629 +
630 +Возвращает коллекцию StatusItem следующего вида:
631 +
632 +|Название параметра|Тип параметра|Описание параметра|Пример
633 +|Uid|**guid**|Идентификатор статуса|574fa171-5482-4979-be0f-117a3dd0dd29
634 +|Name|**string (255)**|Наименование статуса|23005
635 +|Description|**string (100)**|Описание статуса|ОТЧЕТ
636 +|IsEnd|**boolean**|Является ли статус конечным|false
637 +
638 +
639 +== [[GetTicket>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetTicket]] ==
640 +
641 +Получение бинарного идентификатора для аутентификации пользователя по логину и паролю.
642 +
643 +=== Входные параметры: ===
644 +
645 +|(% style="width:206px" %)Название параметра|(% style="width:130px" %)Тип параметра|(% style="width:70px" %)Обяз.|(% style="width:234px" %)Описание параметра|(% style="width:343px" %)Пример
646 +|(% style="width:206px" %)Login|(% style="width:130px" %)**string**|(% style="width:70px" %)Да|(% style="width:234px" %)Логин пользователя|(% style="width:343px" %)Vasya
647 +|(% style="width:206px" %)Password|(% style="width:130px" %)**string**|(% style="width:70px" %)Да|(% style="width:234px" %)Пароль пользователя|(% style="width:343px" %)123456
648 +
649 +=== Возвращаемое значение: ===
650 +
651 +|Тип параметра|Описание параметра|Пример
652 +|string|Сессионный ключ|YOB7IG8UG687068
653 +
654 +* (((
655 +== [[GetTransportService>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]] ==
656 +)))
657 +
658 +Возвращает справочник типов транспортировки по мету ремонта и бренду.
659 +
660 +* (((
661 +== [[GetTransportZone>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetTransportZone]] ==
662 +)))
663 +
664 +Возврат справочника зон транспортировки.
665 +
666 +* (((
667 +== [[SaveAttachment>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=SaveAttachment]] ==
668 +)))
669 +
670 +Создание вложения определенного типа в трекинге, с удалением всех вложений того же типа
671 +
672 +== [[SaveOrder>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]] ==
673 +
674 +Создание/обновление трекинга.
675 +
676 +=== Входные параметры: ===
677 +
678 +|Название параметра|Тип параметра|Обяз?|Описание параметра|Пример
679 +|ticket|**string**|Да|Сессионный ключ|YOB7IG8UG687068
680 +|record|**TrackingRecord**|Да|(((
681 +структура содержащая данные, идентична секции Tracking в методе [[GetOrderBySysKey>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetOrderBySysKey]]
682 +)))|
683 +
684 +=== Выходные параметры: ===
685 +
686 +|Название параметра|Тип параметра|Описание параметра|Пример
687 +|TrackingUid|**guid**|Уникальный идентификатор трекинга. Значение можно использовать для дальнейших вызовов метода SaveOrder, если нужно обновить значения трекинга.|
688 +|SysNum|**string**|Системный номер трекинга (учётный номер ремонта в системе)|
689 +|StatusName|**string**|Статус трекинга|
690 +|StatusUid|**guid**|UID статуса трекинга. Значение берётся из [[GetSpStatuses>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]].|
691 +|Result|**Added** or **Changed** or **NotFound** or **Error** or **Unknown**|(((
692 +Результат выполнения операции:
693 +
694 +Added – трекинг создан и помещён в базу
695 +
696 +Changed – трекинг изменён
697 +
698 +NotFound – трекинг не найден по uid
699 +
700 +Error – ошибка в работе метода
701 +
702 +Unknown – неизвестная ошибка
703 +)))|Added
704 +|TrackingUri|**string**|Ссылка на трекинг, которую можно открыть в браузере|
705 +
706 +Секция Errors содержит коллекцию строк ошибок.
707 +
708 +Секция ValidationErrors содержит коллекцию ErrorItem следующего вида:
709 +
710 +|Название параметра|Тип параметра|Описание параметра|Пример
711 +|ErrorCode|**string**|Код ошибки|
712 +|ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.|
713 +|Status|**string**|Статус трекинга|
714 +|Descriptilon|**string**|Описание ошибки|
715 +
39 39  = Порядок вызова методов и работы с сервисом =
40 40  
41 41  1. Для начала работы требуется аутентифицироваться. Для этого нужно вызвать метод [[GetTicket>>path:#_heading=h.1fob9te]] с параметрами login и password и получить в ответ ticket. Он используются для вызова других методов сервиса. В качестве пользователя может использоваться любой созданный на сайте аккаунт с доступом к созданию трекинга.
42 42  1. Далее нужно заполнить справочники (классификаторы) вашего сервиса, чтобы передавать их в метод сохранения ремонта. Справочники заполняются вызовами соответствующих методов класса «Получение классификатора».
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]]. Все детали (запчасти, з/ч) нужно передавать каждый раз при вызове метода.
720 +1. Ремонт создаётся методом [[SaveOrder>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]]. Любые изменения вносятся повторным вызовом этого метода. Метод возвращает в числе других параметров TrackingUid, необходим при сохранении вложений к трекингу [[SaveAttachment>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=SaveAttachment]], получении информации по акту неремонтопригодности [[GetANRPInfo>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetANRPInfo]] или акту технического освидетельствования [[GetATOInfo>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=GetATOInfo]]. Все детали (запчасти, з/ч) нужно передавать каждый раз при вызове метода.
44 44  1. **Важно: **
45 45  
46 46  * Ремонт в статусе «ОТЧЕТ», «ОТМЕНЁН», «ОПЛАЧЕН»  не может быть обновлён.
... ... @@ -54,21 +54,6 @@
54 54  
55 55  То есть при передачи новых данных по этим полям, они будут проигнорированы.
56 56  
57 -= Метод [[GetTicket>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=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 -
72 72  
73 73  )))
74 74