Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Параметр

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

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

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

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

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

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

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

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

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

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

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

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

 Обновление доступно для:

  • всех свойств заказа
  • всех типов доставки, созданных по API (JSON, SOAP)
  • отправлений только в статусе "не в акте"


 В связке token + updateByTrack данных не найдено

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

Корректный трек-номер (пример некорректного, BBR13790374BBR)

Ошибочный номер для проведения обновления

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

  1. Значение параметра updateByTrack не найдено в ИС
  2. По посылке уже сформирован акт.
  3. Заказ создан не по API
  4. Заказ изменен через веб-интерфейс
У Вас нет прав на обновление данной посылки.

Корректный трек-номер (формата boxberry)

Ошибочный номер для проведения обновления

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

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

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


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), отделение должно быть действующим.

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


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

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

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

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

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

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


Раскрыть
titleТребования к локальной и доменной частям 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 цифр, берутся 10 цифр с конца и записываются в заказ в формате 7[10 цифр с конца].
В случае отсутствия телефона - возникает ошибка.

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

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

В случае отсутствия телефона заказ не создаётся.

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

phone2
Дополнительный номер телефона.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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)

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

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

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

·         Сумма к оплате (payment_sum) = Стоимость всех товаров (price*quantity) + стоимость доставки (delivery_sum), либо

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

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

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

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

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

2.        Для СНГ:

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

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

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

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

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


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


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


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

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

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


Для СНГ:

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

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

price

Цена за товар

Типы выдачи "без вскрытия" и "со вскрытием" - если создается заказ без товаров то передается один товар с price = "сумма к оплате" (payment_sum) минус "стоимость доставки" (delivery_sum) (если вычисленная стоимость товара отрицательная, то приравниваем к 0).

Стоимость - числовое значение и больше или равно 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.

Интерфейс

API/XML/XLS

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

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

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

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

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


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

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

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


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


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

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

 



marking_crpt

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

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

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

Если маркировка <> 28 или 127 символов, она считается не валидной и не
сохраняется, но заказ все равно создается.

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

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

Для каждого вложения items [0..∞] маркировка должна быть уникальна

«Маркировка ЦРПТ» должна быть уникальным значением у вложения №

При работе посредством 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.

Если одна из сторон габаритов (x, y, z ) >120, то максимальный вес заказа - 15кг

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

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

Вес грузового места №1 превышает установленный максимальный лимит в 15 кг.

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

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

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

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

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

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

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

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


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

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

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


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

Значение «Баркод для этикетки» должно содержать максимум 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) в совокупности:

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

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

Оказание услуги "Примерка" невозможно при типе выдачи "Без вскрытия".
fitting

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

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

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

Оказание услуги "Примерка" невозможно при типе выдачи "Без вскрытия".
sender_name
Наименование магазина отправителя для sms/e-mail оповещений
  • Максимальное количество символов - 25 
  • Допустимые символы: a-z(A-Z), 0-9, а-я(А-Я), ёЁ, тире(-), амперсанд(&), нижнее подчеркивание ( _ ), точка, пробел
  • Максимально количество технических символов - 2 (тире, амперсанд, нижнее подчеркивание, точка, пробел)

...