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

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

Комментарий

Подробности

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