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