Page History

Параметр

Условие проверки

Текст ошибки при невыполнении условия

order_id
Номер заказа в ИМ

Набор допустимых символов: a-z(A-Z), 0-9, а-я(А-Я), ёЁ, тире(-), прямой слеш(/),
точка(.), запятая(,), нижнее подчеркивание(_), №, пробел.

Номер заказа содержит запрещённые символы

Длина - 35 символов.

Значение «Номер заказа в ИМ» должно содержать максимум 35 символа.

Наличие "Номера заказа в ИМ".

Необходимо заполнить «Номер заказа в ИМ».

Уникальность в рамках одного ЛК ИМ.

Значение «…….» для «Номер заказа в ИМ» уже занято.

updateByTrack
Трек-номер посылки для обновления

Работает с посылками, созданными по API. 

По указанным данным ничего не найдено

Выбирается посылка по "updateByTrack" и "order_id".

У Вас нет прав на обновление данной посылки.

По посылке не сформирован акт.

Функционал "updateByTrack" не работает, если посылка была изменена в веб-интерфейсе (ошибка:  "err": "У Вас нет прав на обновление данной посылки.")

vid
Вид доставки

Наличие "Типа доставки".

Возможные значения:
1 - доставка до ПВЗ,
2 - курьерская доставка,
3 - доставка Почтой России.

API, XML: Неправильный вид доставки.

XLS: не распознается "вид доставки" - ноль, пусто или текст. Т.к. по данному столбцу определяется является ли строка информацией о заказе или о товаре. Т.е. если в столбец "J" одно из значений 1,2,3, то считаем, что это заказ, если любое другое число, то возвращается ошибка "Неправильный вид доставки." если столбец пустой, ноль или текст, то считается, что в строке информация о товаре. 

Неправильный вид доставки.

name
Код ПВЗ

Введен код существующего ПВЗ, осуществляющего выдачу посылок (признак у отделения IssuanceBoxberry=1 из PointsDescription).

*Возможна передача кода ПВЗ, который закрыт, при условии его наличия в базе ЛК ИМ.

Неверный код пункта выдачи.

Наличие "Пункт выдачи".

Необходимо заполнить «Пункт выдачи».

Влияет на проверку параметров: 

• phone
• phone2
• price
• payment_sum
• weight
• issue 
• items [name, price, quantity]

name1
Код пункта поступления

Введен код существующего ПВЗ, осуществляющего приём посылок (признак у отделения Reception=1 из PointsDescription), отделение должно быть действующим.

Неверный код пункта приема.

Наличие "Пункт приема" (передан в запросе на создание посылки или есть в настройках пользователя или есть в настройках магазина)

<sub>* Если не передан, используется пункт приема по умолчанию из настроек пользователя "Мой профиль" - "Доступы" 
* Если в настройках пользователя не установлен "пункт приема по умолчанию", то берется из настроек магазина "Мой профиль" - "Информация о магазине" - "Пункт приема для отправлений",</sub> 

e-mail
E-mail для оповещений

В случае установленных опций по умолчанию : "Извещение E-Mail" и/или "Дополнительное E-Mail-Извещение" почта должна быть заполнена.

Необходимо заполнить «Электронная почта получателя».

fio
ФИО получателя

1.        Наличие ФИО.

2.        Минимум 2 слова через пробел.

3.        Максимум 3 слова через пробел.

4.        ФИО доступно на кириллице и латинице.

Можно использовать дефис для указания ФИО, где есть больше чем 3 слова.

Пример,
Иванов Иван
Иванов Иван Иванович
Иванов-Петров Иван Иванович

Необходимо заполнить «Фамилия».
Необходимо заполнить «Имя».
Необходимо заполнить «Отчество».

Количество символов <= 100

Значение «ФИО» должно содержать максимум 100 символов.

phone
Телефон получателя

Если страна получения = Россия
Если телефон содержит более 10 цифр, берутся 10 цифр с конца и записываются в заказ в формате 7[10 цифр с конца].
В случае отсутствия телефона - возникает ошибка.

«Контактный телефон получателя» должен содержать 10 цифр.

Если страна = Казахстан или Беларусь, то максимальная длина номера телефона - 12 символов. В случае отсутствия телефона заказ не создаётся.

«Контактный телефон получателя» для заказов, доставляемых за пределы РФ, должен быть заполнен и содержать не более 12 цифр.

phone2
Доп. номер телефона

Если страна получения = Россия
Дополнительный номер телефона.
Если телефон содержит более 10 цифр, берутся 10 цифр с конца и записываются в заказ в формате 7[10 цифр с конца].

«Дополнительный контактный телефон получателя» должен содержать 10 цифр.

Если страна = НЕ Россия
Максимальная длина номера телефона - 12 символов.

«Дополнительный контактный телефон получателя» для заказов, доставляемых за пределы РФ, должен быть заполнен и содержать не более 12 цифр.

price
Объявленная стоимость посылки

Объявленная стоимость должна быть указана в заданном для страны диапазоне:

•   Для РФ диапазон от

5 до 300 000.

•   Для СНГ (код 112) диапазон от 0 до 100 000.

Объявленная стоимость должна быть не более 
300 000.00 р.

Объявленная стоимость должна быть не менее 5.00 р.

Объявленная стоимость - положительное числовое значение.

Объявленная стоимость должна быть числом.

Объявленная стоимость не может быть отрицательной.

delivery_sum
Стоимость доставки

Стоимость доставки - положительное числовое значение.

Сумма доставки должна быть числом.

Сумма доставки не может быть отрицательной.

supplier_track
Номер заказа для СМС

payment_sum
Сумма к оплате

Сумма к оплате - положительное числовое значение.

Сумма к оплате должна быть числом.

Сумма к оплате не может быть отрицательной.

Сумма к оплате в диапазоне

согласно вашему тарифу. 

Сумма к оплате должна быть не менее 0р.

Сумма к оплате должна быть не более 300000 р.

Если заказ с vid = 1 (доставка до ПВЗ) и отделение не может принять оплату (признак PrepaidOrdersOnly = true в методе PointsDescription), то сумма к оплате должна быть = 0

Для отделения получения доступна только выдача предоплаченных заказов.

addressp
Адрес получателя

Для передачи адреса КД предназначены три параметра:

·  citi (населенный пункт)

·  index (индекс)

·  addressp (адрес получателя)

передаваемые в API ParselCreate, XML  и XLS файлов.

Адрес с областью и районом писать в формате: область, район, населенный пункт.

Например:

<citi>Свердловская обл, г Кушва, поселок Баранчинский</

citi>
<addressp>ул Республики, д 4</addressp>

или без сокращений:

<citi>Свердловская, Кушва, Баранчинский</

citi>
<addressp>Республики, 4</addressp>

Невозможно определить индекс, проверьте пожалуйста указанный адрес
Курьерская доставка по индексу <index> не доступна.

Поле "адрес" должно быть заполнено.

Необходимо заполнить «Адрес получателя».
Значение «Адрес получателя» должно содержать минимум 5 символов.

Поля "город" и "адрес" должны быть кириллицей.
Разрешенные символы: ^-0-9а-яёА-ЯЁ.,:;()№/

Атрибут «Город получателя» должен быть написан кириллицей.
Атрибут «Адрес получателя» должен быть написан кириллицей.

timesfrom1
timesto1
Время доставки, от
Время доставки, до

Интервалы КД
(направление определяется только по данным посылки, по значениям "пункт приема" и "пункт выдачи")

Для направлений:
Москва - Москва
Москва - Санкт-Петербург
Санкт-Петербург - Санкт-Петербург
Санкт-Петербург - Москва
================================

Интервал доставки "ОТ-ДО" должен быть одним из перечисленных:
9:00-13:00
9:00-15:00
9:00-18:00
9:00-22:00
12:00-15:00
15:00-18:00
15:00-22:00
18:00-22:00

При проверке корректности временного интервала, он заменяется на наиболее подходящий интервал из списка, либо указывается по умолчанию. 
Если интервал не передан или не соответствует диапазону, то сохраняется по умолчанию с 9:00 до 22:00.

delivery_date
Дата доставки

(направление определяется только по данным посылки, по значениям "пункт приема" и "пункт выдачи")

Для направлений:
Москва - Москва
Москва - Санкт-Петербург
Санкт-Петербург - Санкт-Петербург
Санкт-Петербург - Москва
================================
Дата доставки должна быть в интервале от +1 день до + 5 дней от текущей даты.
Если дата не передана или не соответствует условиям, то ставим дату по умолчанию – текущая дата +1 день.

comentk
Комментарий

Комментарий курьеру доступен для направлений:
Москва - Москва
Москва - Санкт-Петербург
Санкт-Петербург - Санкт-Петербург
Санкт-Петербург - Москва

Проверки товарного состава в зависимости от типа выдачи

Проверяется корректность заполнения обязательных и необязательных полей.

Обязательные поля для заполнения:

1.        Для РФ:

Тип выдачи "частичная выдача":

·         Наименование товара (name),payment_sum

·         Количество (quantity),

·         Цена за товар (price).

Проверка стоимостей товаров:

·         Сумма к оплате = Стоимость всех товаров + стоимость доставки, либо

·         Сумма к оплате = 0 (предоплаченный заказ)

Типы выдачи "без вскрытия" и "со вскрытием" (либо не передавать ни одного из обязательных параметров):

·         Количество (quantity),

·         Цена за товар (price).

Проверка стоимостей товаров отсутствует.

2.        Для СНГ:

Любой тип выдачи:

·         Наименование товара (name),

·         Количество (quantity),

·         Цена за товар (price).

Проверка стоимостей товаров отсутствует.

Наличие товарного состава.

Для РФ:
Типы выдачи "без вскрытия" и "со вскрытием" - создается заказ

.

Для РФ:
Тип выдачи "частичная выдача" - пользователь получает ошибку и заказ не создается.

Для вашего набора услуг заполнение вложений обязательно.

Отсутствуют товары.

Для СНГ:

При любом типе выдачи пользователь получает ошибку и заказ не создается.

Для выбранной страны получения требуется заполнить вложения.

price

Цена за товар

Стоимость - числовое значение и больше или равно 0.

Все типы выдачи - пользователь получает ошибку и заказ не создается

Стоимость не может быть отрицательной у вложения №1...n

Некорректно указана стоимость у вложения №1...n

Не указана стоимость у вложения №1....n

quantity

Количество

Типы выдачи "без вскрытия" и "со вскрытием" - если создается заказ без товаров то передается один товар, quantity=1

Кол-во товаров - числовое значение и больше 0.

Все типы выдачи - пользователь получает ошибку и заказ не создается

Количество должно быть больше 0 у вложения №1...n

Количество товаров должно быть указано целым числом №1...n

Не указано количество у вложения №1.

name

Наименование товара

Наличие наименования товарного вложения.

Для РФ:
Типы выдачи "без вскрытия" и "со вскрытием" - заказ создается.

Если создается заказ без товаров то передается товар с:
name="товары интернет-магазина",

Для РФ:
Тип выдачи "частичная выдача" - пользователь получает ошибку и заказ не создается.

Не указано наименование у вложения №1...n

Для СНГ:

При любом типе выдачи пользователь получает ошибку и заказ не создается.

Не указано наименование у вложения №1...n

id

Артикул

Артикул максимум 40 символов, не обязателен для передачи, но в случае наличия длина проверяется.

Все типы выдачи - пользователь получает ошибку и заказ не создается

Значение «Артикул товара» должно содержать максимум 40 символов.

nds

Процент НДС

НДС - число от 0 до 20. Если передан пустой приравнивается к 0.

Все типы выдачи - пользователь получает ошибку и заказ не создается

НДС не может быть меньше 0 у вложения №1...n

НДС не может быть больше 20 у вложения №1...n

Некорректно указан НДС у вложения №1...n

Проверка стоимостей товаров:

Сумма к оплате = Стоимость всех товаров + стоимость доставки, либо

Сумма к оплате = 0 (предоплаченный заказ)

Типы выдачи "без вскрытия" и "со вскрытием" - заказ создается, товары сохраняются.

Тип выдачи "частичная выдача" - пользователь получает ошибку и заказ не создается.

Стоимость всех товаров (<сумма>) + стоимость доставки (<сумма>) должна быть равна сумме к оплате (<сумма>).

marking_crpt

Маркировка товара

Код маркировки состоит из

28  или 127 символов и включает данные: GTIN+"+"+ISN товара

или полную маркировку.

Способы создания посылки: API, XLS, XML.

«Маркировка ЦРПТ» должно содержать

28 или 127 символов у вложения №1...n

Поле marking_crpt заполнено у товара с quantity > 1

Количество не должно превышать 1 у вложения №1...n.

При работе посредством REST API необходимо экранировать все специальные символы.

Некорретный формат json-данных в sdata.

При работе посредством XML и API в формате SOAP, данные маркировки в значении которого используются специальные символы, необходимо передавать в теге <![CDATA[ ... ]]>, иначе маркировка товара не сохранится.

Пример заполнения,<marking_crpt><![CDATA[02900000217553+lVfTHoca%>km&]]></marking_crpt>

notice
Примечание

Способы создания посылки: API, XLS, XML.

Количество символов <= 100

Значение «Примечание» должно содержать максимум 100 символов.

weight
Вес места

Должен быть заполнен вес 1-го места.

Необходимо заполнить «Вес коробки (кг)» у места №1...n.
Отсутствуют места.

Вес - числовое значение.

Вес коробки должен быть указан числом у места №1...n

Вес тарного места не должен превышать лимит веса отделения, на которое оформляется заказ.

Получить информацию о лимите веса можно используя ListPoints или PointsDescription параметр LoadLimit

Значение «Вес коробки (кг)» не должно превышать 15 (31) кг. для выбранного ПВЗ у места №1...n.

Неверно указаны габариты места №1...n для посылок со стороной, превышающей 120см, максимальный вес - 15кг

Вес тарного места не должен быть меньше минимального веса = 5 гр.

Вес коробки не может быть меньше 5 гр. у места №1...n

Общий вес мест при КД превышает допустимый лимит веса для заданного направления.
РФ - 15 кг (МСК, СПБ - 30 кг)

Вес мест превышает максимально допустимый: <Вес, кг>

Ограничения - 100 мест (API, XML-файл).

Количество мест в одной посылке не может превышать 100

barcode
Баркод посылки

Способы создания посылки: API, XLS, XML.

Штрих-код ИМ не должен состоять из 13 символов с лидирующим 0.

Баркод не может состоять из 13 символов с лидирующим 0.

Если передан баркод, не генерируется ШК и не доступна печать этикетки.

Значение «Баркод для этикетки» должно содержать максимум 250 символов.

barcode
Баркоды мест

Способы создания посылки: API, XLS, XML.

Если указан баркод хотя бы для одного тарного места, то для остальных указанных мест баркоды обязательны к заполнению.

Баркод у <1...n> места должен быть заполнен.

Если указаны баркоды мест, то баркод посылки игнорируется.

issue
Вид выдачи

Числовое значение.

Значение «Issue» должно быть целым числом.

Возможные значения:
0 - Выдача отправлений без вскрытия,
1 - Выдача со вскрытием и проверкой комплектности,
2  - Выдача части вложения.

Если переданное значение не [0,1,2] устанавливается тип выдачи, указанный в разделе ЛК "Мой профиль" - "Услуги", https://account.boxberry.ru/client/profile/index?tab=services

·         РФ (создание заказа через веб-интерфейс)

·         Для стран Казахстан и Беларусь (все способы создания заказа):

если отделение получатель не оказывает частичную выдачу (признак EnablePartialDelivery = false в методе PointsDescription), то Тип выдачи может быть только в значении 0 - Без вскрытия.

Если тип выдачи не передан, то по умолчанию подставляется = 0.

Доставка за пределы

РФ доступна только для заказов с типом выдачи = 0.

Проверяем значение полей "Тип выдачи" (issue) и "Примерка (fitting) в совокупности:

ЕСЛИ при создании отправления "Тип выдачи"* = "Без вскрытия" И флаг "Примерка"* установлен
ТО заказ создан не будет И возвращается ошибка.

* данное значение поля указано по умолчанию в профиле ИМ или явно в запросе

Возможные значения:

0 - нет примерки
1 - подключена примерка

Проверка: см. описание поля issue

• Максимальное количество символов - 25 
• Допустимые символы: a-z(A-Z), 0-9, а-я(А-Я), ёЁ, тире(-), амперсанд(&), нижнее подчеркивание ( _ ), точка, пробел
• Максимально количество технических символов - 2 (тире, амперсанд, нижнее подчеркивание, точка, пробел)