Расскажем о том как правильно создавать посылки с помощью XLS/XML файлов
Процедура ручной загрузки XLS-файла
1) Выбрать файл. После выбора файла появится информация о нем.
2) Установите галочку «Игнорировать первую строку файла» (чтобы игнорировать при загрузке первую строку файла, содержащую заголовки).
3) Установите галочку «Если объявленная стоимость составляет менее 5 рублей, произвести автозамену на 5 рублей (согласно условиям договора)» (это автоматически изменит "Объявленная стоимость" на 5 при импорте)
Подменный телефон – это телефон ИМ, который будет устанавливаться, если указан некорректный или пустое значение в файле загрузки. В зависимости от выбранного кода страны выполняется подбор маски ввода номера телефона в поле «Телефон получателя».
Есть справочный раздел «Описание структуры XLS», в котором подробно описаны поля и правила их заполнения для корректной загрузки, а также добавлены примеры с разными типами доставки.
4) Начать импорт соответствующей клавишей.
После загрузки файла выводится результат загрузки: количество обработанных посылок и ошибки, если они возникают.
Если есть ошибка, то отображаются поля, которые не получилось обработать. Внесите необходимые корректировки в XLS-файл и снова выполните загрузку. Повторяйте данные действия до тех пор, пока для импорта не станет доступно необходимое количество посылок.
Если для посылок в xls-файле были указаны штрих-коды, система считает, что Вы сами формируете этикетки, и не предлагает их Вам для печати.
Если нет ошибок, посылки автоматически буду добавлены, и вы будете перенаправлены на страницу «Отправления», где будет отображена добавленная вами посылка.
Общие требования к XLS-файлу
Ниже прописаны требования к загружаемому файлу XLS:
- Кодировка данных UTF-8;
- Заполнение данных в XLS необходимо выполнять на основе шаблона (бланка) сохраняя формат таблицы;
- Суммы в ЗП не должны быть отрицательными и превышать 300 000 р.
- Общее количество заказов не должно превышать 1000
Для корректной обработки файла все ячейки должны быть быть преобразованы в формат "текстовый", по аналоги с форматом ячеек в предоставленных шаблонах.
Описание передаваемых данных:
В описании все данные представлены в виде одного столбца для удобства отображения. На самом деле, это отдельные столбцы.
Столбец | Наименование поля | Описание | Обяз. для заполнения | ||
ПВЗ | КД | КД (НеРФ) | |||
A | Дата посылки (ГГГГММДД) | Дата создания ЗП, используется текущая дата. Дата задается в формате: ГГГГММДД = 20180718. | Нет | Нет | Нет |
B | Номер заказа в ИМ | Идентификатор (номер) заказа в БД ИМ (должен быть уникальным в рамках одного ЛК). 35 символов. | Да | Да | Да |
C | Объявленная стоимость | Объявленная стоимость - общая (оценочная) стоимость ЗП. | Нет | Нет | Да |
D | Сумма к оплате | Сумма к оплате (сумма, которую необходимо взять с получателя), руб. Для полностью предоплаченного заказа указывать 0. | Нет | Нет | Нет |
E | Стоимость доставки | Стоимость доставки, которую ИМ объявил получателю, руб. | Нет | Нет | Нет |
F | Дата передачи ЗП | Дата передачи ЗП - планируемая дата передачи ЗП на склад Боксберри, используется текущая дата. Дата задается в формате: ГГГГММДД = 20180718. | Нет | Нет | Нет |
G | Штрих-код ЗП | Штрих-код ЗП. Передается в случае собственной маркировки посылок. | Нет | Нет | Нет |
H | Номер паллеты | Номер паллеты, передается в том случае, если отправляете посылки в паллетах. | Нет | Нет | Нет |
I | Номер акта передачи | Номер акта передачи - идентификатор партии заказов – номер Акта приёма-передачи, с которым заказы передаются на склад Боксберри. Обратите внимание: при импорте в ЛК значение данного поля будет заменено! | Нет | Нет | Нет |
J | Вид доставки | Вид доставки. 1 – самовывоз (доставка до ПВЗ), 2 – КД (экспресс-доставка до получателя) | Да | Да | Да |
K | Код ПВЗ | Код отделения, в котором получатель будет забирать ЗП. Заполняется для самовывоза, для КД – оставить пустым. | Да | - | - |
L | Код пункта поступления | Код пункта поступления (код ПВЗ, в который ИМ сдаёт посылки для доставки). Заполняется всегда, независимо от вида доставки. | Да | Да | Да |
M | ФИО | ФИО Получателя ЗП. | Да | Да | Да |
N | Номер телефона | Номер мобильного телефона получателя Для РФ: в формате 10 цифр. | Да | Да | Да |
O | Доп. номер телефона | Дополнительный номер телефона. | Нет | Нет | Нет |
P | E-mail для оповещений | E-mail Получателя. Обязателен, если по заказу подключены опции "Извещение E-Mail" и(или) "Дополнительное E-Mail-Извещение". | Нет | Нет | Нет |
| Следующие значения передаются для получателя юр.лица. | Нет | Нет | Нет | |
Q | Наименование организации | Наименование организации | Да | Да | Нет |
R | Адрес | Юридический адрес организации | Нет | Нет | Нет |
S | ИНН | ИНН | Да | Да | Нет |
T | КПП | КПП | Нет | Нет | Нет |
U | Расчетный счет | Расчетный счет | Нет | Нет | Нет |
V | Наименование банка | Банк организации | Нет | Нет | Нет |
W | Кор. счет | Кор. счет | Нет | Нет | Нет |
X | БИК | БИК | Нет | Нет | Нет |
Y | Вес 1-го места | Информация о весе ЗП: · Вес 1-ого места - вес первого или единственного тарного места, в граммах. Минимальное значение 5 г, максимальное – 30000 г. · Вес 2-ого места, Вес 3-ого места, Вес 4-ого места, Вес 5-ого места - вес второго и последующих тарных мест, в граммах. Внимание, данные строки добавляются только в случае, если ЗП отправляется двумя и более тарными местами. | Да | Да | Да |
Z | Вес 2-го места | Нет | Нет | Нет | |
AA | Вес 3-го места | Нет | Нет | Нет | |
AB | Вес 4-го места | Нет | Нет | Нет | |
AC | Вес 5-го места | Нет | Нет | Нет | |
Блок с информацией о курьерской доставке (Вид доставки=2) | - | Да | - | ||
AD | Индекс | Почтовый индекс получателя. Внимание! Если передан почтовый индекс, то валидация адреса доставки не выполняется. Рекомендуем оставлять поле Индекс пустым, для автоматического определения индекса. | - | Нет | - |
AE | Город | Наименование города получателя ЗП, в котором будет курьерская доставка. Для небольших населенных пунктов указывать дополнительно Область, Район, Город, адрес проверяется сторонним сервисом и должен определяться однозначно. Допустимые варианты: · Свердловская, Кушва, Баранчинский. · Свердловская обл, г Кушва, поселок Баранчинский. · Екатеринбург. · г Екатеринбург. | - | Да | - |
AF | Адрес получателя | Адрес Получателя ЗП (улица, дом, квартира/офис). | - | Да | - |
Следующие значения передаются только для Курьерской доставки по направлениям: · Москва - Москва | - | Нет | - | ||
AG | Время доставки, от | Время курьерской доставки ОТ. Формат заполнения: ЧЧ:ММ. Значение по умолчанию 09:00 | - | Нет | - |
AH | Время доставки, до | Время курьерской доставки ДО. Формат заполнения: ЧЧ:ММ. Значение по умолчанию 22:00. Интервал доставки "ОТ-ДО" должен быть одним из перечисленных: 9:00-13:00 При проверке корректности временного интервала, он заменяется на интервал по умолчанию. | - | Нет | - |
AI | Дата доставки | Дата доставки указывается в интервале +1 день до +5 дней от текущей даты. Формат заполнения: ГГГГ-ММ-ДД. | - | Нет | - |
AJ | Комментарий | Комментарии курьеру (не используется). | Нет | Нет | Нет |
AK | Баркод 1-го места | Баркод 1-ого места Баркод 2-ого места, Баркод 3-ого места, Баркод 4-ого места, Баркод 5-ого места. Информация о штрих-кодах мест, передается в случае собственной маркировки уникальными ШК каждого тарного места: · Каждый баркод должен заполняться в соответствующей строке веса. · Если у заполненных мест указан хотя бы один баркод, то и остальные необходимо указать. · Если у мест указан баркод, то "Штрих-код ЗП" заполнять необязательно. | Нет | Нет | Нет |
AL | Баркод 2-го места | Нет | Нет | Нет | |
AM | Баркод 3-го места | Нет | Нет | Нет | |
AN | Баркод 4-го места | Нет | Нет | Нет | |
AO | Баркод 5-го места | Нет | Нет | Нет | |
AT | Длина, см | Габариты тарного места (см). | Нет | Нет | Нет |
AU | Ширина, см | Нет | Нет | Нет | |
AV | Высота, см | Нет | Нет | Нет | |
AY | Тип выдачи | Вид выдачи, возможные значения: 0 - выдача без вскрытия, 1- выдача со вскрытием и проверкой комплектности, 2 - выдача части вложения. Если не передается, используется значение по умолчанию, установленное в Профиле магазина - раздел "Услуги". | Нет | Нет | Нет |
AZ | Примечание | Примечание к заказу. Текст выводится в печатную форму этикетки. Если у заказа несколько мест (несколько этикеток), то данные по примечанию выводятся на каждой этикетке. | Нет | Нет | Нет |
BA | Примерка | Возможные значения: 0 - нет примерки | Нет | Нет | - |
BB | Зарубежный индекс | Почтовый индекс получателя | Нет | - | Да |
BC | Зарубежный код страны получения | Код страны | Нет | - | Да |
BD | Зарубежный код города получения | Код города | Нет | - | Да |
BE | Зарубежная область/штат | Наименование области/штата | Нет | - | Нет |
BF | Зарубежная улица | Наименование улицы | Нет | - | Да |
BG | Зарубежный дом | Номер дома | Нет | - | Да |
BH | Зарубежная квартира | Номер квартиры | Нет | - | Нет |
BI | GUID тарифа | Идентификатор службы перевозчика, 36 символов (GUID) На данный момент, рекомендуем передавать значение по умолчанию: fd85a8b6-4688-404f-9993-30b9e55d2950 | Нет | - | Да |
Блок с информацией по товарным позициям, включённым в заказ, обязателен при услуге частичная выдача заказа и авиа-доставке. *Внимание: для отображения товарных позиций в заказе необходимо заполнить поля корректно, и должна выполняться проверка по суммам при услуге «выдача части вложения». Товарные позиции добавляются в подстроке основной информации. | Нет* | Нет* | Да | ||
A | Наименование товара | Наименование товара. | Нет | Нет | Да |
B | Артикул | Идентификатор/артикул товарной позиции. 40 символов. | Да | Да | Нет |
C | Единица измерения | Единица измерения, по умолчанию используется шт. | Нет | Нет | Нет |
D | Процент НДС | Процент НДС. Возможные значения: от 0 до 20. | Нет | Нет | Нет |
E | Количество | Количество единиц товара в товарной позиции. | Да | Да | Да |
F | Цена за товар | Цена товарной позиции (т.е цена за единицу товара). | Да | Да | Да |
G | Маркировка товара | Маркировка одежды и обуви. Код маркировки состоит из 28 знаков и включает данные: GTIN (14 символов) + "+" + ISN (13 символов) товара | Нет | Нет | Нет |
Обязательно к ознакомлению: Проверки и условия при загрузке заказов.