Ozon отключит старый API-метод отчётов о реализации 17 января: что нужно обновить в интеграцияхЗаметка · дайджест за 19 ноября
Сбалансированная композиция из кубов системной интеграции с токеном отчётов реализации и защитной пломбой.
Заметка2 раздела≈ 3 мин

Ozon отключит старый API-метод отчётов о реализации 17 января: что нужно обновить в интеграциях

В середине января бухгалтерия сводит декабрьские продажи и закрывает налоговый год, поэтому любой сбой в выгрузках сразу тормозит расчёты. Если твоя 1С, МойСклад или BI-аналитика до сих пор забирают отчёты о реализации Ozon через /v1/finance/realization/posting, 17 января 2027 года загрузка остановится. Ручные таблицы в личном кабинете продавца сохранятся, но автоматический мост между площадкой и учётом оборвётся.

API-метод — это программный адрес, по которому внешняя учётная программа сама забирает цифры из кабинета Ozon без ручного скачивания таблиц. О грядущем отключении площадка предупредила в канале Ozon Seller API 17 ноября 2026 года, оставив ровно два месяца на переезд. Продавцов, которые скачивают отчёты только руками в браузере, перемены не заденут. Всем, у кого работает автовыгрузка в ERP, 1С, сервисы финансовой аналитики или самописные скрипты, нужно перенастроить обмен до середины января.

Почему одного запроса больше недостаточно и как пойдёт новая выгрузка

Раньше учётная система ходила в Ozon по прямому сценарию: просила данные за выбранные даты одним запросом к /v1/finance/realization/posting и сразу забирала ответ. Такой прямой запрос часто расходился с итоговыми цифрами личного кабинета по выплатам, возвратам и комиссиям. Чтобы убрать разницу между двумя каналами, Ozon в новости для разработчиков и уведомлении Ozon Seller API перевёл выгрузку на асинхронную цепочку с привязкой к номеру отчёта.

Теперь интеграция должна действовать пошагово, сначала узнавая номер документа и только потом забирая готовый расчёт:

  1. Сначала программа обращается к /v1/report/finance/realization/list и получает список доступных отчётов с их номерами.
  2. Если для учёта хватает общих итогов за период, запрос уходит на /v1/report/finance/realization/number/create. Если же нужен позаказный отчёт о реализации, где суммы разбиты до каждого отдельного отправления, система запускает сборку через /v1/report/finance/realization/number/posting/create.
  3. Когда площадка сформирует документ, интеграция скачивает готовый отчёт методом /v1/report/info.

Здесь есть один практический нюанс. На момент анонса 17 ноября новые методы работают в статусе бета-версии: интерфейс уже открыт для переезда, но отдельные детали Ozon ещё может шлифовать. Как напоминает проект SellerDen, после переключения нельзя пускать учёт на самотёк — первые выгрузки придётся вручную сверить с цифрами в личном кабинете.

Какие ещё правки вышли в ноябрьском пакете API и что проверить до дедлайна

В том же релизе от 17 ноября Ozon обновил методы для работы со своего склада по схеме FBS. Площадка добавила параметр seal_number — номер защитной пломбы, которую продавец может закрепить за экземпляром товара и передать по API. Флаг sealing_allowed и действия edit_seal_number и set_seal_number появились в ответах /v4/posting/fbs/unfulfilled/list, /v4/posting/fbs/list и /v3/posting/fbs/get, а seal_number добавили в методы маркировки экземпляров fbs/posting/product/exemplar/create-or-get, status, set и validate версий v5 и v6. Метод /v2/posting/fbs/get-by-barcode тоже обновили: он получил новое описание barcode и возвращает массив result.products.exemplars.

Тем, кто автоматически запускает скидки и купоны продавца через API, стоит проверить параметр discount_type в методах /v1/seller-actions/create/discount-with-condition, /v1/seller-actions/create/multi-level-discount и /v1/seller-actions/create/voucher. Ozon удалил там значение CURRENCY, и старые запросы с ним перестанут проходить. Для метода /v2/order/create в справочнике частых ошибок также добавили расшифровки шести кодов сбоев при выборе склада, маршрута, слота доставки и состава заказа.

Чтобы январский дедлайн не сорвал закрытие года в бухгалтерии, проверь свою учётную связку заранее.

Что сделать селлеру до 17 января 2027 года

  • Уточнить у поддержки своей 1С, МойСклад или сервиса аналитики, когда они отключат /v1/finance/realization/posting и перейдут на новую схему.
  • Передать разработчику цепочку новых методов отчётов из инструкции выше, а при работе со скриптами акций и FBS проверить удаление CURRENCY и поля пломб seal_number.
  • Запустить тестовую выгрузку на новых бета-методах за уже закрытый период до дедлайна 17 января 2027 года.
  • Сверить итоговые суммы продаж, возвратов, комиссий и выплат из тестовой выгрузки с личным кабинетом Ozon Seller.
Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 4