Исходный код вики Интеграция с трекингом (API)

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