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

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