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

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

Комментарий

Подробности

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