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

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