Сервис развивается: тестируем формат, собираем идеи, улучшаем сервис. Есть идеи? Написать
Дайджесты новостей
Редакционная иллюстрация: разработчик обновляет связку API, а справа на конвейере сканируют посылку с новой этикеткой; схема внизу показывает переход к новой структуре списка.

Обновления Ozon Seller API: дедлайн по акциям v2 до 13 октября и новые этикетки FBS

Разработчикам учетных систем, IT-отделам крупных селлеров и создателям сервисов автоматизации для Ozon предстоит плотный график обновлений в первой половине осени 2026 года. Маркетплейс объявил о синхронном переходе на новые протоколы взаимодействия сразу по трем ключевым направлениям: управлению скидками и промо-акциями, формированию маркировочных этикеток для схемы FBS и базовой структуре ответов методов каталога.

Если проигнорировать эти изменения, магазины рискуют столкнуться с внезапной остановкой автоматического ценообразования, сбоями при добавлении товаров в распродажи и отказом сортировочных центров принимать заказы.

Переход на методы акций v2 до 13 октября

Самым критичным по срокам является обновление блока работы с промо-акциями. 22 сентября команда Ozon представила вторую версию методов API для управления скидочными механиками (версия v2).

В течение переходного периода до 13 октября 2026 года методы v2 работают параллельно со старыми эндпоинтами v1 и воспроизводят прежнее поведение. Однако 13 октября Ozon безвозвратно отключит устаревшие методы v1 и переведет все промо-активности на обновленную архитектуру.

Риск потери контроля над ценами

Если внешняя интеграция или внутренний скрипт магазина продолжит обращаться к методам версии v1 после 13 октября, API начнет возвращать ошибки. В результате селлер не сможет вовремя включить скидки на старте распродажи либо, напротив, не сможет оперативно вывести товар из невыгодной акции, что грозит прямыми финансовыми убытками.

Разработчикам необходимо провести ревизию используемых эндпоинтов и перенаправить запросы на обновленные маршруты, протестировав добавление и исключение артикулов из промо-кампаний:

POST /v2/actions/products/activate
Content-Type: application/json
Client-Id: <client_id>
Api-Key: <api_key>

{
  "action_id": 12345,
  "products": [
    {
      "product_id": 987654321,
      "action_price": 1490
    }
  ]
}

Обновление формата этикеток для заказов FBS с 5 октября

Второе обязательное изменение касается схемы Fulfillment by Seller (продажи со склада продавца). Начиная с 5 октября 2026 года методы формирования этикеток Ozon Seller API переходят на генерацию маркировочных наклеек нового формата.

Новый регламент оптимизирует расположение штрихкодов и служебных полей для ускорения автоматического сканирования на конвейерных линиях логистических хабов. Складским программам и термопринтерам селлеров требуется адаптация к обновленной верстке PDF-файлов. Отгрузка отправлений со старыми этикетками после 5 октября приведет к сбоям на этапе приемки в сортировочных центрах и пунктах сдачи грузов.

Замена поля total на total_items до 23 ноября

Третье системное изменение затрагивает разработчиков, обрабатывающих списки и пагинацию в ответах методов каталога и складских остатков. Поле total, ранее использовавшееся для указания общего количества записей в выборке, признано устаревшим (deprecated).

Вместо него внедряется стандартизированная структура total_items:

{
  "result": {
    "items": [],
    "total_items": 150
  }
}

Маркетплейс установил окончательный дедлайн по полному удалению поля total из ответов API на 23 ноября 2026 года. Разработчикам рекомендуется заблаговременно проверить парсеры JSON-ответов и обновить обращения к объектам пагинации, чтобы предотвратить появление ошибок обращения к неопределенным полям в фоновых процессах синхронизации.