GetReferenceData: ErrorCodes — Коды ошибок
Функция позволяет получить список кодов ошибок, возвращаемых другими функциями при вызове web-сервиса.
Полный список кодов ошибок с их описаниями:
| Код ошибки | Описание |
|---|---|
| 01010 | Web-сервис в текущий момент отключен |
| 02010 | Отсутствуют параметры для получения данных |
| 02011 | Неверно сформированы параметры для получения данных |
| 02013 | Отсутствует информация по чекам/Отказано в доступе к данному методу |
| 02020 | Отсутствует структура для получения данных |
| 02021 | Неверно сформирована структура для получения данных |
| 02030 | Отсутствуют параметры для записи данных |
| 02031 | Неверно сформированы параметры для записи данных |
| 02040 | Отсутствует структура для записи данных |
| 02041 | Неверно сформирована структура для записи данных |
| 02050 | Выбранный склад не доступен по Вашему договору |
| 02051 | Сервис работы со складом хранения не доступен по Вашему договору |
| 02053 | По указанным данным информация не найдена, попробуйте изменить географию отправителя или географию получателя |
| 02054 | Пустая таблица составного груза |
| 02060 | Отсутствует доступ к сервису отмены заказов |
| 02061 | Для выбранной географии сервис «Согласованная дата доставки» не осуществляется |
| 02062 | Выбранный населенный пункт отправителя не обслуживается |
| 03010 | Ошибка авторизации доступа к базе |
| 03020 | Отсутствует информация по правам доступа |
| 03030 | Нарушение прав доступа |
| 03040 | По договору заблокировано выполнение операций |
| 03041 | У клиента не определён основной договор |
| 03050 | Документ нельзя изменить |
| 03060 | Изменение пароля запрещено |
| 03061 | Изменение пароля возможно только при входе с административным паролем |
| 04010 | Не указан номер документа |
| 04011 | Неверный формат номера документа (должен состоять из 20 символов и иметь префикс, назначенный клиенту) |
| 04012 | Не указан номер упаковки |
| 04020 | Не найден такой документ в базе |
| 04030 | Номер документа уже используется |
| 04031 | Номер упаковки уже используется |
| 04032 | Клиентский номер уже используется |
| 04040 | Документ принадлежит другому клиенту |
| 04050 | Не указан выгружаемый справочник |
| 04051 | Неверно указан выгружаемый справочник |
| 04060 | Не указан загружаемый справочник |
| 04061 | Неверно указан загружаемый справочник |
| 04070 | Некорректный код группы |
| 05010 | Не указана срочность |
| 05011 | Срочность заполнена некорректно. Используйте срочность в соответствии с договором |
| 05020 | Не указана услуга |
| 05021 | Некорректный код услуги |
| 05022 | Документ не может включать страхование, так как в договоре не предусмотрена данная услуга |
| 05023 | Не указана страховая стоимость груза |
| 05024 | Документ не может включать объявленную стоимость груза, так как в договоре не предусмотрена данная услуга |
| 05025 | Не указана объявленная стоимость груза |
| 05026 | Не указана сумма, которую необходимо взять с получателя (COD) |
| 05027 | Некорректный код валюты |
| 05028 | Объявленная стоимость груза превышает максимальную сумму |
| 05029 | Страховая стоимость груза превышает максимальную сумму |
| 05030 | Не указан вид груза |
| 05031 | Некорректный код вида груза |
| 05040 | Не указана география отправителя |
| 05041 | Некорректный код географии отправителя |
| 05042 | Указан некорректный код географии |
| 05050 | Не указана география получателя |
| 05051 | Некорректный код географии получателя |
| 05060 | Не указано контактное лицо |
| 05061 | Некорректный код контактного лица |
| 05062 | По условиям договора необходимо указать контактное лицо |
| 05063 | Не указано контактное лицо отправителя |
| 05064 | Не указано контактное лицо получателя |
| 05066 | Заказ не может быть размещен: вес по заказу превышает установленное ограничение |
| 05070 | Не указан офис |
| 05071 | Некорректный код офиса |
| 05080 | Не указано подразделение |
| 05081 | Некорректный код подразделения |
| 05082 | По условиям договора необходимо указать подразделение |
| 05083 | По условиям договора необходимо указать подразделение только из списка предопределённых |
| 05090 | Не указано проект |
| 05091 | Некорректный код проекта |
| 05092 | По условиям договора необходимо указать проект |
| 05093 | По условиям договора номер клиента обязателен для заполнения |
| 05098 | Указан некорректный код пункта выдачи заказов |
| 05099 | Выбранный ПВЗ не используется или помечен на удаление |
| 05100 | Не указано отправитель |
| 05101 | Некорректный код отправителя |
| 05102 | Указан некорректный дополнительный код клиента |
| 05103 | Необходимо передать другую дату забора для данного региона |
| 05104 | Некорректная дата забора груза |
| 05105 | Некорректная дата доставки груза, получить список доступных дат и интервалов можно через функцию GetReferenceData: AvailableDeliveryDates |
| 05106 | Некорректное время забора груза |
| 05107 | Не заполнена дата забора груза |
| 05110 | Не указано получатель |
| 05111 | Некорректный код получателя |
| 05120 | Не указан адрес |
| 05121 | Не указан адрес забора |
| 05122 | Не указан адрес доставки |
| 05130 | Не указан телефон |
| 05131 | Не указан телефон отправителя |
| 05132 | Не указан телефон получателя |
| 05140 | Не указан адрес электронной почты |
| 05141 | Не указан адрес электронной почты отправителя |
| 05142 | Не указан адрес электронной почты получателя |
| 05143 | Некорректно заполнен Email для уведомлений. Необходимо заполнять данные в соответствии с форматом: 'имя_пользователя@имя_сервера' |
| 05144 | Некорректно заполнен Email отправителя. Необходимо заполнять данные в соответствии с форматом: 'имя_пользователя@имя_сервера' |
| 05145 | Некорректно заполнен Email получателя. Необходимо заполнять данные в соответствии с форматом: 'имя_пользователя@имя_сервера' |
| 05150 | Не указан плательщик |
| 05151 | Некорректный код плательщика |
| 05152 | Плательщиком может быть только отправитель или получатель |
| 05160 | Не указан способ оплаты |
| 05161 | Некорректный код способа оплаты |
| 05170 | Не указан способ доставки |
| 05171 | Некорректный код способа доставки, Указан некорректный вид доставки |
| 05180 | Не указан уникальный код (GUID) документа |
| 05181 | Не указан вид документа |
| 05182 | Некорректный вид документа |
| 05183 | Некорректные данные |
| 05190 | Не указан товар |
| 05191 | Некорректный код товара |
| 05192 | Не указана партия товаров |
| 05193 | Некорректный код партии товаров |
| 05194 | Не указан серийный номер товара |
| 05195 | Некорректный код серийного номера товара |
| 05195 | У товара отключён учёт по серийным номерам. Артикул: 'артикул' |
| 05195 | UIN можно передавать только для ювелирной продукции. Артикул: 'артикул' |
| 05195 | Указан некорректный UIN для товара: 'артикул' |
| 05195 | Не найден серийный номер для переданного товара: 'артикул' |
| 05196 | Не указана характеристика товара |
| 05197 | Некорректный код характеристики товара |
| 05198 | Не указано действие обработки товаров |
| 05199 | По условиям договора необходимо заполнять описание груза |
| 05200 | Не указана единица измерения |
| 05201 | Некорректный код единицы измерения |
| 05202 | Некорректно указаны ВГХ |
| 05210 | Не указана ставка НДС |
| 05211 | Некорректный код ставки НДС |
| 05220 | Некорректный адрес отправителя |
| 05221 | Некорректный адрес получателя |
| 05222 | Такого банка не найдено в списке существующих |
| 05223 | Некорректно заполнен ИНН/КПП, с расшифровкой «ИНН не заполнена или не равно 10 символам», «КПП не заполнено или не равно 9 символам» |
| 05224 | Для создания грузовых мест необходимо указать номер документа с типом «Waybill» |
| 05225 | Не заполнен индекс отправителя. Для международных отправлений необходимо заполнить индекс |
| 05226 | Не заполнен индекс получателя. Для международных отправлений необходимо заполнить индекс |
| 05227 | Превышено кол-во символов в индексе отправителя, допустимо 10 |
| 05228 | Превышено кол-во символов в индексе получателя, допустимо 10 |
| 05500 | Не указан вид получаемого списка документов |
| 05501 | Некорректный вид получаемого списка документов |
| 05510 | Не указан вид контрагента |
| 05511 | Некорректный вид контрагента |
| 05555 | Для сохранения документа с параметром «DescriptionForTheVPDreturn» необходимо заполнить услугу в блоке ADDITIONALSERVICES |
| 06000 | Некорректный вид получаемой формы документа (допустимо: «print», «image» или «scan») |
| 06010 | Не найдена печатная форма |
| 06020 | Не удалось сформировать печатную форму |
| 06030 | Скан документа недоступен |
| 07000 | Контрагент не является интернет-магазином |
| 07010 | Некорректный код партнёра, выполняющего доставку |
| 07011 | Клиент не работает с этим партнёром |
| 08010 | Отключена регистрация изменений состояний документов |
| 08011 | Нельзя удалить запись изменений, по которой не было запроса информации |
| 10010 | Некорректный формат файла |
| 10020 | Некорректный код ошибки |
| 99010 | Неизвестная ошибка |
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
| login | string | логин | |
| password | string | пароль | |
| parameters | Element | список параметров |
Параметр parameters содержит настройки запроса в виде иерархической структуры, соответствующей XML-представлению.
Он должен включать:
Key: строка со значением parameters (обязательное);
List: непустой массив элементов, каждый из которых представляет отдельный параметр и сам является структурой с тремя полями:
- Key: имя параметра (например, Reference);
- Value: значение параметра указывающая на то какой parameters описывается;
- ValueType: тип значения — строка, указывающая тип Value(string, int и т.д.).
Пример одного элемента из List:
<car:List>
<car:Key>Reference</car:Key>
<car:Value>ErrorCodes</car:Value>
<car:ValueType>string</car:ValueType>
</car:List>Каждый такой элемент — независимый узел внутри parameters. Если List отсутствует или пуст — запрос отклоняется.
Иерархия структуры parameters:
parameters → List (массив) → каждый элемент List → Key, Value, ValueType.
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
| Reference | string | Имя справочника, должно быть равно «ErrorCodes» | |
| Search | string | Код ошибки, информацию по которому мы хотим получить (если параметр указан, то в ответе будет информация только по этому коду ошибки) |
Параметр Element в ответе содержит информацию о видах грузов.
Он включает элементы справочника:
Key: идентификатор справочника, к которому относится запись (например, ErrorCodes);
List: контейнер записи справочника, каждая запись соответствует одному коду ошибки.
Каждая блок List в виде структуры Element описывает одну ошибку и содержит в себе:
- Key: код ошибки (цифровой строковый идентификатор) (например, 03060);
- Value: текстовое описание ошибки на русском языке;
- ValueType: тип значения — строка, указывающая тип Value (string, dateTime и т.п.).
Структура ответа иерархична:
Element → Key + List (массив) → каждый элемент List → Key + Value +ValueType.
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
| Key | string | Код ошибки | |
| Value | string | Описание ошибки |
<soap:Envelope
xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
xmlns:car="http://www.cargo3.ru">
<soap:Header/>
<soap:Body>
<car:GetReferenceData>
<car:login>test</car:login>
<car:password>2016</car:password>
<car:parameters>
<car:Key>parameters</car:Key>
<car:List>
<car:Key>Reference</car:Key>
<car:Value>ErrorCodes</car:Value>
<car:ValueType>string</car:ValueType>
</car:List>
<car:List>
<car:Key>Search</car:Key>
<car:Value>03060</car:Value>
<car:ValueType>string</car:ValueType>
</car:List>
</car:parameters>
</car:GetReferenceData>
</soap:Body>
</soap:Envelope> <soap:Envelope
xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
<soap:Body>
<m:GetReferenceDataResponse
xmlns:m="http://www.cargo3.ru">
<m:return
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<m:Key>ErrorCodes</m:Key>
<m:List>
<m:Key>03060</m:Key>
<m:Value xsi:type="xs:string">Изменение пароля запрещено</m:Value>
<m:ValueType>string</m:ValueType>
</m:List>
</m:return>
</m:GetReferenceDataResponse>
</soap:Body>
</soap:Envelope> 