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

Редактировал(а) Дмитрий Семёнов 2025/04/10 15:52
От версии < 4.1 >
отредактировано Григорий Лепёшкин
на 2023/12/21 12:02
К версии < 31.1 >
отредактировано Дмитрий Семёнов
на 2025/04/10 15:51
< >
Изменить комментарий: К данной версии нет комментариев

Комментарий

Подробности

Свойства страницы
Родительский документ
... ... @@ -1,1 +1,1 @@
1 -Процессы для ремонта техники .WebHome
1 +Сервисные процессы.WebHome
Автор документа
... ... @@ -1,1 +1,1 @@
1 -XWiki.GrigoryLepeshkin
1 +XWiki.DmitriySemenov
Содержимое
... ... @@ -6,41 +6,855 @@
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]] - Создание трекинга колл-центра.
12 -* [[DeleteAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=DeleteAttachment]] -Удаляет вложение трекинга по номеру ремонта АСЦ (OrderNumAsc) и по типу вложения
13 -* [[GetANRPInfo>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetANRPInfo]] - Получение информации по акту неремонтопригодности.
14 -* [[GetATOInfo>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetATOInfo]] - Получение информации по акту технического освидетельствования.
15 -* [[GetActionPlace>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetActionPlace]] - Возвращает справочник мест ремонта.
16 -* [[GetAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachment]] - Возвращает вложение по номеру ремонта АСЦ (OrderNumAsc) и по типу вложения.
17 -* [[GetAttachmentKeys>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachmentKeys]] - Возвращает список вложений по системному номеру трекинга (OrderNum) без самих вложений.
18 -* [[GetAttachmentTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetAttachmentTypes]] - Возвращает список типов вложений
19 -* [[GetBrands>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetBrands]] - Возвращает список брендов в разрезе групп брендов.
20 -* [[GetCategIrisConditionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisConditionCodes]] - Возвращает справочник Iris Код условий по бренду и категории модели.
21 -* [[GetCategIrisDefectCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisDefectCodes]] - Возвращает справочник Iris Код дефектов по бренду и категории модели.
22 -* [[GetCategIrisRepairCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisRepairCodes]] - Возвращает справочник Iris Код ремонтов по бренду и категории модели.
23 -* [[GetCategIrisSectionCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSectionCodes]] - Возвращает справочник Iris Код секций по бренду и категории модели.
24 -* [[GetCategIrisSymptomCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetCategIrisSymptomCodes]] - Возвращает справочник Iris Код симптомов по бренду и категории модели.
25 -* [[GetIrisCodes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetIrisCodes]] - Возвращает Iris коды в разрезе типов Iris кодов (ConditionCode, DefectCode, RepairCode, sectionCode, SymptomCode), категорий моделей и брендов (в рамках активных авторизаций по брендам)
26 -* [[GetModelCategories>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetModelCategories]] - Возвращает справочник категорий моделей.
27 -* [[GetOrderByAscKey>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderByAscKey]] - Возвращает трекинг по номеру ремонта АСЦ (OrderNumAsc)
28 -* [[GetOrderBySysKey>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderBySysKey]] - Возвращает трекинг по системному номеру (OrderNum).
29 -* [[GetOrderKeys>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetOrderKeys]] - Возвращает список трекингов, перешедших в конечный статус в последние 35 дней и всех остальных, не перешедших в конечный статус.
30 -* [[GetRejectReasons>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetRejectReasons]] - Список причин отмены трекинга
31 -* [[GetSpRepairTypes>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpRepairTypes]] - Возвращает справочник типов ремонтов по группе брендов (MainBrandUid).
32 -* [[GetSpStatuses>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetSpStatuses]] - Возвращает список статусов трекинга.
33 -* [[GetTicket>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTicket]] - Получение бинарного идентификатора для аутентификации пользователя по логину и паролю.
34 -* [[GetTransportService>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportService]] - Возвращает справочник типов транспортировки по мету ремонта и бренду.
35 -* [[GetTransportZone>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=GetTransportZone]] - Возврат справочника зон транспортировки.
36 -* [[SaveAttachment>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveAttachment]] - Создание вложения определенного типа в трекинге, с удалением всех вложений того же типа
37 -* [[SaveOrder>>url:http://cc.tpvrussia.ru:84/TrackingExchangeSoap.asmx?op=SaveOrder]] - Создание/обновление трекинга.
13 +== [[CreateTrackingCallCentr>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?op=CreateTrackingCallCentr]] ==
38 38  
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 +
39 39  = Порядок вызова методов и работы с сервисом =
40 40  
41 41  1. Для начала работы требуется аутентифицироваться. Для этого нужно вызвать метод [[GetTicket>>path:#_heading=h.1fob9te]] с параметрами login и password и получить в ответ ticket. Он используются для вызова других методов сервиса. В качестве пользователя может использоваться любой созданный на сайте аккаунт с доступом к созданию трекинга.
42 42  1. Далее нужно заполнить справочники (классификаторы) вашего сервиса, чтобы передавать их в метод сохранения ремонта. Справочники заполняются вызовами соответствующих методов класса «Получение классификатора».
43 -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]]. Все детали (запчасти, з/ч) нужно передавать каждый раз при вызове метода.
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]]. Все детали (запчасти, з/ч) нужно передавать каждый раз при вызове метода.
44 44  1. **Важно: **
45 45  
46 46  * Ремонт в статусе «ОТЧЕТ», «ОТМЕНЁН», «ОПЛАЧЕН»  не может быть обновлён.