Автопечать этикеток для Ozon FBS
Когда FBS-заказов десятки в день, ручной цикл «открыть кабинет → собрать → скачать этикетки → распечатать» отнимает много времени и даёт ошибки: перепутанные этикетки, забытые заказы, просрочки. Этот цикл автоматизируется через Seller API Ozon. Разбираем последовательность шагов, где она ломается и как устроить печать без кабинета.
Цепочка: от заказа до этикетки на коробке
- Новый заказ. Отправление появляется в статусе
awaiting_packaging— ожидает сборки. Бот видит его в списке/v3/posting/fbs/list. Как бот узнаёт о заказах. - Сборка. Метод
/v4/posting/fbs/shipсобирает отправление, и оно переходит в статусawaiting_deliver— ожидает отгрузки. Без сборки этикетки нет. - Этикетка. Для собранных отправлений Ozon отдаёт этикетку в PDF (метод
/v2/posting/fbs/package-label, несколько отправлений за запрос). Этикетка может быть готова не мгновенно после сборки, поэтому запрос нужно уметь повторять с паузой. - Печать. PDF уходит на принтер или в Telegram. Дальше — наклеить и отгрузить.
Автоматизация может закрыть шаги 2–4 одной кнопкой «Собрать и напечатать» — или вообще без кнопки, если заказы собираются по мере поступления.
Где цепочка ломается
Данные экземпляров и маркировка
Для части товаров Ozon требует данные экземпляра до сборки — например, код маркировки «Честного знака» или номер ГТД. Без них /v4/posting/fbs/ship отвечает ошибкой EXEMPLAR_INFO_NOT_FILLED_COMPLETELY: заказ не собирается, значит, у него нет ни этикетки, ни строки в листе подбора. Что именно нужно, видно в /v3/posting/fbs/get (блок требований к товарам). Цепочка заполнения — /v6/fbs/posting/product/exemplar/create-or-get, затем /v6/fbs/posting/product/exemplar/set, проверка статуса и только потом сборка.
Обратная ситуация: в карточке выключен атрибут «Нужен код маркировки» (id 23536), а код передают. Тогда Ozon отклоняет код ошибкой MANDATORY_MARK_REDUNDANT. Включайте атрибут, только когда коды на этот товар уже есть — иначе сборка встанет.
И не забывайте про вывод из оборота: на FBS его оформляет продавец, а не Ozon — документ «Вывод из оборота», причина «Дистанционная продажа», в течение 3 рабочих дней после статуса «Доставлен».
Перепутанные этикетки
Этикетка Ozon содержит номер отправления и штрихкод, но по ней не всегда сразу понятно, какой товар в коробке. Помогает печать артикула поверх этикетки и одинаковый порядок этикеток и листа подбора: взял лист, собрал по порядку, наклеил по порядку.
Несколько магазинов
Если магазинов несколько, этикетки лучше выдавать отдельным файлом на каждый магазин — меньше шансов отгрузить заказ одного магазина в акте другого.
Повторная печать
Принтер зажевал ленту, этикетка порвалась — нужна перепечатка по номеру отправления, а не повторная сборка.
Как печатать без кабинета
- PDF в Telegram. Бот присылает файл с этикетками, вы открываете его и печатаете. Просто и работает с любого устройства.
- Автопечать. На компьютере рядом с принтером работает небольшая программа: получает PDF от бота и сразу отправляет его в очередь печати. Этикетки выходят сами, как только заказ собран.
- Две пачки. Если коды маркировки печатаются на отдельном принтере, этикетки Ozon и коды можно выдавать двумя файлами в одном порядке.
- Пачкой по отгрузке. Все этикетки за отгрузку одним PDF — удобно, когда собираете партию раз в день.
Сколько это экономит
Главная экономия — не минуты на скачивание файла, а меньше ошибок: заказ не забыт, собран вовремя, этикетка на нужной коробке. Каждая просрочка и отмена попадает в индекс ошибок, а при индексе выше 5% стоимость каждой ошибки удваивается. Если штрафы уже стали регулярными, посмотрите, сколько они забирают с продажи: впишите средний штраф на продажу в поле «Прочее».
Все параметры уже подставлены — поменяйте цену, закупку или категорию на свои.
Сделать самому или заказать
Все методы выше — публичные методы Seller API, и цепочку можно собрать самостоятельно. Основное время уходит не на сам вызов методов, а на обработку исключений: маркировку, данные экземпляров, повторы при ошибках API, перепечатку и несколько магазинов. Если такой работы не хочется, бот с автопечатью можно заказать под ключ — он ставится на ваш сервер, и код остаётся у вас.
Если отгрузка закрывается с опозданием и пришёл штраф — как его оспорить.
Ставки и правила маркетплейсов меняются несколько раз в год. Цифры в статье — на указанные даты; перед решением о цене сверяйте их в личном кабинете.