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