При создании При создании посылки для входящих параметров выполняются условия и условия и проверки, указанные в таблице. При невыполнении условия проверки - сообщения об ошибке во всех способах создания одинаковые (ParselCreate, вручную web-сервис, импорт из XLS и XML).
Отображение дочерних | ||
---|---|---|
|
Таблица 1
Параметр | Условие проверки | Текст ошибки при невыполнении условия |
order_id | Набор допустимых символов: a-z(A-Z), 0-9, а-я(А-Я), ёЁ, тире(-), прямой слеш(/), |
. | Номер заказа содержит запрещённые символы |
Длина - 35 символов. | Значение «Номер заказа в ИМ» должно содержать максимум 35 символа. |
Наличие "Номера заказа в ИМ". | Необходимо заполнить «Номер заказа в ИМ». |
Уникальность в рамках одного ЛК ИМ. |
Значение «…….» для «Номер заказа в ИМ» уже занято. |
updateByTrack |
Трек
-номер посылки для обновления |
Обновление доступно для:
| |
В связке token + updateByTrack данных не найдено | По указанным данным ничего не найдено |
Корректный трек-номер (пример некорректного, BBR13790374BBR) | Ошибочный номер для проведения обновления |
Выбирается |
посылка по "updateByTrack" и "order_id". |
|
|
| У Вас нет прав на обновление данной посылки. |
Корректный трек-номер (формата boxberry) | Ошибочный номер для проведения обновления |
vid | Наличие "Типа доставки". |
ParselCreate: Необходимо заполнить «Вид доставки».
XML: Неправильный вид доставки.
Возможные значения: | API, XML: Неправильный вид доставки. XLS: не распознается "вид доставки" - ноль, пусто или текст. Т.к. по данному столбцу определяется является ли строка информацией о заказе или о товаре. Т.е. если в столбец "J" одно из значений 1,2,3, то считаем, что это заказ, если любое другое число, то возвращается ошибка "Неправильный вид доставки." если столбец пустой, ноль или текст, то считается, что в строке информация о товаре. |
Для РФ возможные значения:
1 - доставка до ПВЗ,
2 - курьерская доставка,
3 - доставка Почтой России.
Для Казахстана и Беларуси возможные значения:
1 - доставка до ПВЗ
Неправильный вид доставки.
name
Код ПВЗ
Неправильный вид доставки. | |
name | Введен код существующего ПВЗ, осуществляющего выдачу |
посылок (признак у отделения IssuanceBoxberry=1 из PointsDescription). *Возможна передача кода ПВЗ, который закрыт, при условии его наличия в базе ЛК ИМ. | Неверный код пункта выдачи. |
Наличие "Пункт выдачи". | Необходимо заполнить «Пункт выдачи». |
Код пункта поступления
Влияет на проверку параметров:
| |
name1 | Введен код существующего ПВЗ, |
осуществляющего приём посылок (признак у отделения Reception=1 из PointsDescription), отделение должно быть действующим. | Неверный код пункта приема. |
Наличие "Пункт приема" (передан в запросе на создание посылки или есть в настройках пользователя или есть в настройках магазина) * Если не передан, используется пункт приема по умолчанию из настроек пользователя "Мой профиль" - "Доступы" |
*
|
Необходимо заполнить «Пункт приема». | |
e-mail | В случае установленных опций по умолчанию |
: "Извещение E-Mail" и/или "Дополнительное E-Mail-Извещение" почта должна быть заполнена |
ФИО получателя
Набор допустимых символов: a-z(A-Z), 0-9, а-я(А-Я), ёЁ, тире(-), прямой слеш(/),
точка(.), запятая(,), нижнее подчеркивание(_), №, пробел, скобки ()
- Наличие ФИО.
- Минимум 2 слова через пробел или дефис.
- Максимум 3 слова через пробел или дефис.
- ФИО доступно на кириллице и латинице.
Пример,
Иванов Иван
Иванов Иван Иванович
Иванов-Петров Иван Иванович
Необходимо заполнить «Имя».
Необходимо заполнить «Отчество».
phone
Телефон получателяВ случае отсутствия телефона - возникает ошибка.
. | Необходимо заполнить «Электронная почта получателя». | |||||
| "Значение «Электронная почта получателя» не является правильным email адресом. Неправильный адрес электронной почты." | |||||
Количество символов <= 45 | Значение «Электронная почта получателя» должно содержать максимум 45 символов. | |||||
fio | Набор допустимых символов: a-z(A-Z), 0-9, а-я(А-Я), ёЁ, тире(-), прямой слеш(/), точка(.), запятая(,), нижнее подчеркивание(_), №, пробел, скобки () | ФИО содержит запрещённые символы. | ||||
1. Наличие ФИО. 2. Минимум 2 слова через пробел. 3. Максимум 3 слова через пробел. 4. ФИО доступно на кириллице и латинице. Можно использовать дефис для указания ФИО, где есть больше чем 3 слова. Пример, | Необходимо заполнить «Фамилия». | |||||
Количество символов <= 100 | Значение «ФИО» должно содержать максимум 100 символов. | |||||
phone | Страна получения = Россия ТО Проверка по маске: Длина ≥ 10 цифр. | «Контактный телефон получателя» должен содержать 10 цифр. | ||||
Если страна = НЕ Россия ТО Проверка по маске: В случае отсутствия телефона заказ не создаётся. | «Контактный телефон получателя» для заказов, доставляемых за пределы РФ, должен быть заполнен и содержать не более 12 цифр. | |||||
phone2 | Страна получения = Россия ТО Проверка по маске: Длина ≥ 10 цифр. | «Дополнительный контактный телефон получателя» должен содержать 10 цифр. | ||||
Если страна = НЕ Россия ТО Проверка по маске: | «Дополнительный контактный телефон получателя» для заказов, доставляемых за пределы РФ, должен быть заполнен и содержать не более 12 цифр. | |||||
price | Объявленная стоимость должна быть указана в заданном для страны диапазоне: • Для РФ диапазон от 5 до 300 000. • Для СНГ (код 112) диапазон от 0 до 100 000. | Объявленная стоимость должна быть не более | ||||
Объявленная стоимость должна быть не менее 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 файлов. | Адрес с областью и районом писать в формате: область, район, населенный пункт. |
| ||||
Поле "адрес" должно быть заполнено. | Необходимо заполнить «Адрес получателя». | |||||
Поля "город" и "адрес" должны быть кириллицей. | Атрибут «Город получателя» должен быть написан кириллицей. | |||||
timesfrom1 |
phone2
Доп. номер телефона
Если телефон содержит более 10 цифр, берутся 10 цифр с конца и записываются в заказ в формате 7[10 цифр с конца].
price
Объявленная стоимость посылки
Для РФ диапазон от 0 до 300 000.
Для Казахстана и Беларуси диапазон от 0 до 100 000.
Если в настройках ЛК ИМ (административная часть) установлен флаг "Не проверять объявленную стоимость", проверка не осуществляется.
Объявленная стоимость должна быть не более 300 000.00 р.
Объявленная стоимость - положительное числовое значение.
delivery_sum
Стоимость доставки
Стоимость доставки - положительное числовое значение.
payment_sum
Сумма к оплате
Сумма к оплате - положительное числовое значение.
Сумма к оплате должна быть не менее <минимальная сумма> р.
Сумма к оплате должна быть не более <максимальная сумма> р.
Адрес получателя
Для передачи адреса КД предназначены 3 параметра:
- city (населенный пункт)
- index (индекс)
- addressp (адрес получателя)
передаваемые в API ParselCreate, XML и XLS файлов.
Алгоритм проверки адреса:
=========
1.1 получили индекс - проверяем его на возможность КД.
1.2 индекс не получили от dadata, то проверяем передан ли "index" (на случай некорректного города и/или адреса):
1.2.1 "index" указан - по этому индексу определяем город, отправляем в dadata "вычисленный город"+ "addressp "- получили индекс - проверяем на возможность КД. Не получили индекс от dadata, возвращаем ошибку "Невозможно определить индекс, проверьте пожалуйста указанный адрес."
1.2.2 "index" отсутствует - возвращаем ошибку "Невозможно определить индекс, проверьте пожалуйста указанный адрес."
2.1 "index" указан - по индексу определяем город, отправляем в dadata "вычисленный город"+ "addressp "- получили индекс - проверяем на возможность КД. Не получили индекс от dadata, возвращаем ошибку "Невозможно определить индекс, проверьте пожалуйста указанный адрес."
2.2 "index" отсутствует - ошибка "Невозможно определить индекс, проверьте пожалуйста указанный адрес."
Например:
<city>Свердловская обл, г Кушва, поселок Баранчинский</city>
<addressp>ул Республики, д 4</addressp>
или без сокращений:
<city>Свердловская, Кушва, Баранчинский</city>
<addressp>Республики, 4</addressp>Невозможно определить индекс, проверьте пожалуйста указанный адрес
Курьерская доставка по индексу <index> не доступна.
Значение «Адрес получателя» должно содержать минимум 5 символов.
Разрешенные символы: ^-0-9а-яёА-ЯЁ.,:;()№/
Атрибут «Адрес получателя» должен быть написан кириллицей.
timesto1
Время доставки, от | Для направлений: Интервал |
1. Если ИМ передает интервал, который не соответствует условиям, то подбирается интервал – а не выводится ошибка.
Например, передан интервал 09:00-11:00, то интервал подберем след.образом - сдвинем на час начало 10:00 и прибавим 3 часа, в итоге записываем интервал 10:00-13:00.
Например, передан интервал 20:00-22:00, то интервал подберем след.образом - берем крайнее время доставки 22:00 и от него рассчитываем начало интервала для КД 3 часа, в итоге записываем интервал 19
доставки "ОТ-ДО" должен быть одним из перечисленных: |
Например, передан интервал 11:
|
22:00 |
3.
При проверке корректности временного интервала, он заменяется на наиболее подходящий интервал из списка, либо указывается по умолчанию. |
сохраняется по умолчанию |
с 9:00 |
до 22:00. | |
delivery_date | Для направлений: |
5 дней от текущей даты. |
comentk | Комментарий курьеру доступен для направлений: | |
Проверки товарного состава в зависимости от типа выдачи |
Проверяется корректность заполнения обязательных и необязательных полей. Обязательные поля для заполнения: 1. |
Для РФ: Тип выдачи "частичная выдача": · Наименование товара (name) |
· Количество (quantity), · Цена за товар (price). Проверка стоимостей товаров: · Сумма к оплате (payment_sum) = Стоимость всех товаров (price*quantity) + стоимость доставки (delivery_sum), либо · Сумма к оплате = 0 ( |
для предоплаченных заказов) Типы выдачи "без вскрытия" и "со вскрытием" (либо |
не передавать ни |
одного из |
обязательных параметров): · Количество (quantity), · Цена за товар (price). Проверка стоимостей товаров отсутствует. 2. |
Для СНГ: Любой тип выдачи: · Наименование товара (name), · Количество (quantity), · Цена за товар (price). Проверка стоимостей товаров отсутствует. | ||
Наличие товарного состава. |
Обязательная опись вложения = Нет
Для РФ: |
наименование="товары интернет-магазина",
количество=1,
стоимость = сумма к оплате - стоимость доставки (если вычисленная стоимость товара отрицательная, то приравниваем к 0).Тип выдачи "частичная выдача" -
. | ||
Для РФ: | Для вашего набора услуг заполнение вложений обязательно. Отсутствуют товары. | |
Для СНГ: При любом типе выдачи пользователь получает ошибку и заказ не создается. | Для |
Отсутствуют товары.
Обязательная опись вложения = Да
Наименование товара
Обязательная опись вложения = Нет
выбранной страны получения требуется заполнить вложения. | |
price Цена за товар | Типы выдачи "без вскрытия" и "со вскрытием" - |
если создается заказ без товаров то передается один товар с price = "сумма к оплате" (payment_sum) минус "стоимость доставки" (delivery_sum) (если вычисленная стоимость товара отрицательная, то приравниваем к 0). | |
Стоимость - числовое значение и больше или равно 0. Все типы выдачи - пользователь получает ошибку и заказ не создается |
Стоимость не может быть отрицательной у вложения №1...n |
Обязательная опись вложения = Да
Некорректно указана стоимость у вложения №1...n Не указана стоимость у вложения №1. |
...n |
nds
Процент НДС
quantity Количество | Типы выдачи "без вскрытия" и "со вскрытием" - если создается заказ без товаров то передается один товар, quantity=1 | |
Кол-во товаров - числовое значение и больше 0. |
Все типы выдачи - пользователь получает ошибку и заказ не создается |
Количество должно быть больше 0 у вложения №1...n |
Количество товаров должно быть указано целым числом №1...n |
Сумма к оплате = Стоимость всех товаров + стоимость доставки, либо
Сумма к оплате = 0 (предоплаченный заказ)
Не указано количество у вложения №1. | ||
name Наименование товара | Наличие наименования товарного вложения. | |
Для РФ: Если создается |
заказ без товаров то передается товар с: | |
Для РФ: |
пользователь получает ошибку и заказ не создается. |
Цена за товар
Стоимость - числовое значение и больше или равно 0.
Не указано наименование у вложения №1...n |
Для СНГ: При любом типе выдачи пользователь |
получает ошибку и заказ не создается |
. | Не указано наименование |
Количество
Кол-во товаров - числовое значение и больше 0.
у вложения №1...n |
Не указана стоимость у вложения №1....n
id Артикул | Артикул максимум 40 символов, не обязателен для передачи, но в случае наличия длина проверяется. |
Все типы выдачи - |
пользователь получает ошибку и заказ не создается |
Количество товаров должно быть указано целым числом №1...n
Не указано количество у вложения №1.
id
Артикул
Значение «Артикул товара» должно содержать максимум 40 символов. | |||||||||
nds Процент НДС | НДС - число от 0 до 20. Если передан пустой приравнивается к 0.
Все типы выдачи - пользователь |
Артикул 40 символов, не обязателен для передачи, но в случае наличия длина проверяется.
Все типы выдачи - пользовательполучает ошибку и заказ не создается |
Маркировка товара
Код маркировки состоит из 28 знаков и включает данные: GTIN+"+"+ISN товара.
Способы создания посылки: API, XLS, XML.
поле marking_crpt заполнено у товара с quantity = 1
marking_crpt > 28 символов
marking_crpt <= 28 символов
При работе посредством XML и API в формате SOAP, данные маркировки в значении которого используются специальные символы, необходимо передавать в теге <![CDATA[ ... ]]>, иначе маркировка товара не сохранится.
Пример заполнения,<marking_crpt><![CDATA[02900000217553+lVfTHoca%>km&]]></marking_crpt>
Примечание
weight
Вес места
Отсутствуют места.
Вес коробки не может быть меньше 5 гр. у места №1...n
barcode
Баркод посылки
Способы создания посылки: API, XLS, XML.
barcode
Баркоды мест
Вид выдачи
Возможные значения:
0 - Выдача отправлений без вскрытия,
1 - Выдача со вскрытием и проверкой комплектности,
2 - Выдача части вложения,
если отделение получатель не оказывает частичную выдачу (признак EnablePartialDelivery = false в методе PointsDescription), то Тип выдачи может быть только в значении 0 - Без вскрытия.
Если тип выдачи не передан, то по умолчанию подставляется = 0.Доставка за пределы РФ доступна только для заказов с типом выдачи = 0
НДС не может быть меньше 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. | |
При работе посредством 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 | |
Общий вес мест при КД превышает допустимый лимит веса для заданного направления. | Вес мест превышает максимально допустимый: <Вес, кг> | |
Ограничения - 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] устанавливается тип выдачи, указанный в разделе ЛК "Мой профиль" - "Услуги", https://account.boxberry.ru/client/profile/index?tab=services | ||
· РФ (создание заказа через веб-интерфейс) · Для стран Казахстан и Беларусь (все способы создания заказа): если отделение получатель не оказывает частичную выдачу (признак EnablePartialDelivery = false в методе PointsDescription), то Тип выдачи может быть только в значении 0 - Без вскрытия. Если тип выдачи не передан, то по умолчанию подставляется = 0. | Доставка за пределы РФ доступна только для заказов с типом выдачи = 0. | |
Проверяем значение полей "Тип выдачи" (issue) и "Примерка (fitting) в совокупности: ЕСЛИ при создании отправления "Тип выдачи"* = "Без вскрытия" И флаг "Примерка"* установлен * данное значение поля указано по умолчанию в профиле ИМ или явно в запросе | Оказание услуги "Примерка" невозможно при типе выдачи "Без вскрытия". | |
fitting | Возможные значения: 0 - нет примерки Проверка: см. описание поля issue | Оказание услуги "Примерка" невозможно при типе выдачи "Без вскрытия". |
sender_name Наименование магазина отправителя для sms/e-mail оповещений |
|
панель | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Не нашли ответ? |