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

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