Page tree
Skip to end of metadata
Go to start of metadata

При создании посылки для входящих параметров выполняются условия и проверки, указанные в таблице. При невыполнении условия проверки - сообщения об ошибке во всех способах создания одинаковые (ParselCreate, вручную, импорт из XLS и XML).

Таблица 1

Параметр

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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


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

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

ParselCreate: Необходимо заполнить «Вид доставки».

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

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

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

Для СНГ возможные значения:
1 - доставка до ПВЗ

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

name
Код ПВЗ

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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


локальная часть 

1) прописные и строчные латинские буквы 

2) цифры от 0 до 9

3) символы
 ! $ & * = ^ ` | ~ # % ' + / ? _ { }

4) точка (.) если не последний и не первый и не появляется последовательно

5) дефис ( - ) 

при проверке обращаем внимание, что проходят буквы, цифры, точки, подчеркивания, дефисы, апострофы и плюсы.

====

допустимые символы в домене 

1) прописные и строчные буквы (латиница, кириллица)

2) цифры от 0 до 9 (но не полностью числовые)

3) дефис (-) при условии, что не 1-ый и не последний символ

4) точка (.) при условии, что не 1-ый и не последний символ и не появляется последовательно

"Значение «Электронная почта получателя» не является правильным email адресом. Неправильный адрес электронной почты."
Количество символов <= 45Значение «Электронная почта получателя» должно содержать максимум 45 символов.

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


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

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
Объявленная стоимость посылки

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

•   Для РФ диапазон от 0 до 300 000.

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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

Сумма к оплате в диапазоне, указанном в настройках ЛК ИМ (административная часть) - "Минимальная сумма к оплате" и "Максимальная сумма к оплате".

Сумма к оплате должна быть не менее <минимальная сумма> р.

Сумма к оплате должна быть не более <максимальная сумма> р.

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

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

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

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

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

·  index (индекс)

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

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

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

Например:
<city>Свердловская обл, г Кушва, поселок Баранчинский</city>
<addressp>ул Республики, д 4</addressp>

или без сокращений:
<city>Свердловская, Кушва, Баранчинский</city>
<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

Количество

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

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

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

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

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

name

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

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


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


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

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

Для СНГ:

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

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

id

Артикул

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

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

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

nds

Процент НДС

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

Интерфейс

API/XML/XLS

НДС не указанполе НЕ передано
Без НДС-1
0%
10%
18%
20%
целое число (от 0 до 20)

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

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

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

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


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

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

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


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


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

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

 

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

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


marking_crpt

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

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

marking_crpt > 28 символов.

«Маркировка ЦРПТ» должно содержать максимум 28 символов у вложения №1...n

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

marking_crpt <= 28 символов.

Количество не должно превышать 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

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

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

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

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

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

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

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

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

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

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


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

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

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


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.

sender_name
Наименование магазина отправителя для sms/e-mail оповещений

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

  • No labels