Бот для уведомлений о новых заказах Ozon
На FBS каждый заказ нужно собрать и отгрузить к крайнему сроку, иначе — штраф и рост индекса ошибок. Держать кабинет Ozon открытым весь день неудобно, поэтому многие продавцы получают заказы в Telegram. Разбираем, как бот узнаёт о новых заказах через Seller API, что он может делать кроме уведомлений и на что смотреть, если вы выбираете или заказываете такого бота.
Как бот узнаёт о новом заказе
Бот работает с официальным Seller API Ozon по вашему Client-Id и API-ключу. Самый надёжный способ — опрос: раз в минуту-две бот запрашивает список отправлений FBS (/v3/posting/fbs/list) за последние часы и сравнивает его с тем, что уже видел. Новые отправления в статусе awaiting_packaging (ожидают сборки) — это новые заказы.
Чтобы не присылать один заказ дважды, бот хранит у себя номера отправлений и отметки: уведомил, собрал, отправил этикетку. После перезапуска он продолжает с того же места, а не заваливает чат старыми заказами.
Что должно быть в уведомлении
- номер отправления и магазин, если магазинов несколько;
- товар, артикул и количество;
- крайний срок отгрузки — главное поле, от него зависят штрафы;
- склад, если складов FBS несколько.
Кроме новых заказов полезно получать отмены: собрать уже отменённый покупателем заказ — потерянное время.
Что ещё может бот, кроме уведомлений
Сборка заказов
Метод /v4/posting/fbs/ship переводит отправление в статус «Ожидает отгрузки» (awaiting_deliver). Бот может делать это по кнопке — для одного заказа или для всех, что ожидают сборки. Грабли: для части товаров Ozon требует данные экземпляра (например, ГТД или код маркировки) до сборки, и без них метод отвечает ошибкой EXEMPLAR_INFO_NOT_FILLED_COMPLETELY. Какие данные нужны, видно в /v3/posting/fbs/get. Хороший бот обрабатывает это сам, а не молча пропускает заказ.
Этикетки и печать
После сборки бот забирает этикетки и присылает PDF в чат или сразу отправляет на принтер. Подробно о цепочке и подводных камнях — в статье про автопечать этикеток.
Лист подбора
Сводка «что и сколько взять со склада» по всем заказам, ожидающим сборки, с группировкой по товару. Экономит время, когда заказов десятки.
Отгрузка и акты
Формирование отгрузки и акта, напоминание о крайнем сроке, сводка «что отгружено за день». Тут есть нюанс: состав акта — не то же самое, что «отгружено за сутки», а метод списка актов /v2/posting/fbs/act/list не умеет нормальную пагинацию — при широком окне дат бот должен дробить период.
Остатки и сводки
Предупреждение, когда остаток товара подходит к нулю, утренняя сводка по заказам на сегодня, вечерняя — по итогам дня. Это напрямую снижает отмены по вине продавца: товар, которого нет, не продаётся.
Мини-приложение
Telegram Mini App со списком заказов, фильтром «ожидают сборки / готовы» и кнопками действий. Удобнее, чем листать чат, когда заказов много.
На что смотреть при выборе бота
- Где хранятся ключи. API-ключ даёт доступ к заказам и действиям в магазине. Лучше, когда бот работает на вашем сервере и код остаётся у вас.
- Права ключа. Для уведомлений достаточно чтения, для сборки и этикеток нужен ключ, которому разрешены действия с отправлениями FBS.
- Кто получает сообщения. Бот должен отвечать только вам и вашим сотрудникам, а не любому, кто его найдёт.
- Что происходит при сбоях. Ozon API иногда отвечает ошибками; бот должен повторять запрос и сообщать, если что-то не работает, а не терять заказы молча.
- Несколько магазинов. Если у вас их несколько, удобнее один бот с разбивкой по магазинам.
Зачем это всё в деньгах
Каждая просрочка и отмена попадает в индекс ошибок, а от него зависит стоимость каждой ошибки: при индексе выше 5% она удваивается. Для товаров с небольшой маржой регулярные штрафы съедают заметную часть прибыли. Проверьте, сколько остаётся с продажи у вашего товара:
Все параметры уже подставлены — поменяйте цену, закупку или категорию на свои.
Сделать такого бота можно самому на Seller API — все методы выше публичные. Если не хочется разбираться с API, статусами и граблями маркировки, бот можно заказать под ключ.
Ставки и правила маркетплейсов меняются несколько раз в год. Цифры в статье — на указанные даты; перед решением о цене сверяйте их в личном кабинете.