При создании посылки для входящих параметров выполняются условия и проверки, указанные в таблице. При невыполнении условия проверки - сообщения об ошибке во всех способах создания одинаковые (ParselCreate, вручную, импорт из XLS и XML).
| Параметр | Условие для проверки | Если проверка не выполнена | Текст ошибки |
|---|---|---|---|
Выполнять указанные проверки, только если страна получения заказа не Россия:
| |||
| order_id Номер заказа в ИМ | Набор допустимых символов: a-z(A-Z), 0-9, а-я(А-Я), ёЁ, тире(-), прямой слеш(/), точка(.), запятая(,), нижнее подчеркивание(_), №, пробел, скобки (). | заказ не создаётся, выводится сообщение об ошибке | Номер заказа содержит запрещённые символы |
| Длина - 35 символов. | Значение «Номер заказа в ИМ» должно содержать максимум 35 символа. | ||
| Наличие "Номера заказа в ИМ"/"order_id". | Необходимо заполнить «Номер заказа в ИМ». | ||
| Уникальность в рамках одного ЛК ИМ. | Значение «…….» для «Номер заказа в ИМ» уже занято. | ||
| price Объявленная стоимость | По countryCode определять страну получения заказа и проверять максимальное ограничение объявленной стоимости для данной страны согласно тарифам:. Если страна не найдена, то конвертировать данные, указанные в price, в евро и проверять, что "price" в евро </= 200 евро | заказ не создаётся, выводится сообщение об ошибке | 1) Объявленная стоимость не должна превышать [Максимальная объявленная стоимость] рублей 2) Объявленная стоимость не должна превышать 200 евро |
| price = сумме стоимостей всех товаров заказа | Объявленная стоимость должна совпадать с суммарной стоимостью товаров | ||
| price > 0 | |||
| payment_sum Сумма к оплате | Сумма к оплате - положительное числовое значение. | заказ не создаётся, выводится сообщение об ошибке | Сумма к оплате должна быть числом. |
| Сумма к оплате не может быть отрицательной. | |||
| Если заказ с vid = 1 (доставка до ПВЗ) и отделение с признаком Acquiring = false И PrepaidOrdersOnly = true , то сумма к оплате должна быть = 0 | На выбранное отделение доступна только доставка предоплаченных заказов | ||
| payment_sum передан | Заказ создаётся с payment_sum = 0. | ||
| Если payment_sum > 0, то сумма к оплате должна быть равна "delivery_sum" + "price" | заказ не создаётся, выводится сообщение об ошибке | Сумма к оплате должна быть равна сумме товаров и доставки | |
| delivery_sum Стоимость доставки | Стоимость доставки - положительное числовое значение. | заказ не создаётся, выводится сообщение об ошибке | Сумма доставки должна быть числом. |
| Сумма доставки не может быть отрицательной. | |||
| issue Вид выдачи | Числовое значение. | заказ не создаётся, выводится сообщение об ошибке | Значение «Issue» должно быть целым числом. |
Возможные значения: 0 - Выдача отправлений без вскрытия, | Заказ создаётся с типом выдачи = 0 | ||
| Если у отделения получения EnablePartialDelivery = false, то доступно указание типа выдачи "Без вскрытия" (0) | заказ не создаётся, выводится сообщение об ошибке | Для выбранного отделения данный вид выдачи недоступен | |
| Если у отделения получения EnablePartialDelivery = true, то доступно указание типа выдачи "Частичная выдача" (2) или "Со вскрытием" (1) или "Без вскрытия" (0) | Заказ создаётся с типом выдачи = 0 | ||
| vid Вид доставки | Вид доставки передан | ParselCreate: Необходимо заполнить «Вид доставки». XML: Неправильный вид доставки. XLS: | |
Возможные значения: 1 - до ПВЗ, Если в выбранном городе получения PickupPoint = 1, то доступно указание вида доставки ПВЗ (1) или КД (2), иначе только КД (2). | заказ не создаётся, выводится сообщение об ошибке | Для выбранного города данный вид доставки недоступен | |
| Параметры массива export. Проверяются, только если vid = 2, страна-получения не Россия (643) и Таможенный союз = да | |||
| index Зарубежный индекс | зарубежный индекс передан | заказ не создаётся, выводится сообщение об ошибке | Необходимо заполнить "Зарубежный индекс" |
| countryСode Код страны получения | Код страны получения передан | заказ не создаётся, выводится сообщение об ошибке | Необходимо заполнить "Код страны получения" |
| Код страны получения не 643 (Россия) | Значение Россия для страны получения недопустимо | ||
| Передан существующий код страны получения | Неверный код страны получения | ||
| В страну доступна доставка | Доставка в выбранную страну не осуществляется | ||
| cityCode Код города получения | Код города получения передан | заказ не создаётся, выводится сообщение об ошибке | Необходимо заполнить "Код города получения" |
| Код города получения принадлежит стране, указанной в countryСode | Город должен принадлежать стране получения | ||
| street Улица | Улица передана | заказ не создаётся, выводится сообщение об ошибке | Необходимо заполнить "Улица" |
Если таможенный союз = да | заказ не создаётся, выводится сообщение об ошибке | Для выбранной страны доступен ввод данных только русских символов, цифр и символов точка, запятая, дефис | |
| house Дом | Дом передан | заказ не создаётся, выводится сообщение об ошибке | Необходимо заполнить"Дом" |
| transporterGuid GUID тарифа | GUID тарифа передан | заказ не создаётся, выводится сообщение об ошибке | Необходимо заполнить "GUID тарифа" |
| GUID тарифа содержит 36 символов (соответствует формату guid) | Некорректный GUID тарифа | ||
| name Код ПВЗ | Введен код существующего ПВЗ, осуществляющего выдачу посылок ("IssuanceBoxberry" = true) | заказ не создаётся, выводится сообщение об ошибке | Неверный код пункта выдачи |
| Код ПВЗ передан | Необходимо заполнить «Пункт выдачи» | ||
| Отделение открыто | Доставка на выбранное отделение недоступна | ||
| name1 Код пункта поступления | Код пункта поступления передан | Заказ создаётся * Если не передан, используется пункт приема по умолчанию из настроек пользователя "Мой профиль" - "Доступы", https://account.boxberry.ru/client/profile/index?tab=accesses * Если в настройках пользователя не установлен "пункт приема по умолчанию", то берется из настроек магазина "Мой профиль" - "Информация о магазине" - "Пункт приема для отправлений", https://account.boxberry.ru/client/profile/index?tab=store-info Если "Мой профиль" - "Информация о магазине" - "Пункт приема для отправлений" не заполнен, то заказ не создаётся, выводится сообщение об ошибке. | Необходимо заполнить «Пункт приема». |
| Введен код существующего ПВЗ, осуществляющего приём посылок (Reception=true), отделение должно быть действующим (Closed = 0). | заказ не создаётся, выводится сообщение об ошибке | Неверный код пункта приема. | |
| fio ФИО получателя | Если у страны-получателя признак таможенный союз = да, то Набор допустимых символов: a-z(A-Z), 0-9, а-я(А-Я), ёЁ, тире(-), прямой слеш(/), | заказ не создаётся, выводится сообщение об ошибке | ФИО содержит запрещённые символы. |
Если таможенный союз = нет, то Набор допустимых символов: a-z(A-Z), 0-9, тире(-), прямой слеш(/), | Ввод данных на кириллице запрещен | ||
Пример, | Необходимо заполнить «Фамилия». Необходимо заполнить «Имя». Необходимо заполнить «Отчество». | ||
| Количество символов <= 100 | Значение «ФИО» должно содержать максимум 100 символов. | ||
phone Телефон получателя | Телефон передан | заказ не создаётся, выводится сообщение об ошибке | Необходимо заполнить "Теленфон получателя" |
| Количество символов номера телефона для выбранной страны получения | Номер телефона получателя для выбранной страны должен состоять из [x] цифр | ||
| phone2 Доп. номер телефона | Количество символов номера телефона для выбранной страны получения | заказ не создаётся, выводится сообщение об ошибке | Дополнительный номер телефона получателя для выбранной страны должен состоять из [x] цифр |
| name Наименование товара | Наименование товара передано | заказ не создаётся, выводится сообщение об ошибке | Не указано наименование у вложения №1...n |
| price Цена за товар | Стоимость - числовое значение и больше 0 | заказ не создаётся, выводится сообщение об ошибке | Стоимость должна быть больше нуля |
| Стоимость передана | Не указана стоимость у вложения №1....n | ||
| quantity Количество | Кол-во товаров - числовое значение и больше 0. | заказ не создаётся, выводится сообщение об ошибке | Количество должно быть больше 0 у вложения №1...n Количество товаров должно быть указано целым числом №1...n |
| Количество передано | Не указано количество у вложения №1. | ||
| id Артикул | Артикул 40 символов, не обязателен для передачи, но в случае наличия длина проверяется. | заказ не создаётся, выводится сообщение об ошибке | Значение «Артикул товара» должно содержать максимум 40 символов. |
| weight Вес места | Должен быть заполнен вес 1-го места. | заказ не создаётся, выводится сообщение об ошибке | Необходимо заполнить «Вес коробки (кг)» у места №1...n. Отсутствуют места. |
| Вес - числовое значение. | Вес коробки должен быть указан числом у места №1...n | ||
| Вес тарного места не должен превышать лимит веса отделения, на которое оформляется заказ. | Значение «Вес коробки (кг)» не должно превышать 15 (31) кг. для выбранного ПВЗ у места №1...n. | ||
| Вес тарного места не должен быть меньше минимального веса = 5 гр. | Вес коробки не может быть меньше 5 гр. у места №1...n | ||
| Вес для КД не должен превышать 31 кг. | Вес коробки не должен превышать 31 кг. у места №1...n | ||
| Ограничения - 100 мест (API, XML-файл). | Количество мест в одной посылке не может превышать 100 | ||
| barcode Баркод посылки | Штрих-код ИМ не должен быть 13 символов с лидирующим 0. | заказ не создаётся, выводится сообщение об ошибке | Баркод не может состоять из 13 символов с лидирующим 0. |
| barcode Баркоды мест | Если указан баркод хотя бы для одного тарного места, то все остальные обязательны к заполнению. | заказ не создаётся, выводится сообщение об ошибке | Баркод у <1...n> места должен быть заполнен. |
| Если указаны баркоды мест, то баркод посылки игнорируется. | |||
Не нашли ответ?
Обратитесь к нам на портал Service Desk
Краткую справку по нему можно найти в этой статье.