Как Ozon изменил финансовый API: что нужно знать продавцам

8 сентября 2026 года Ozon отключил метод /v3/finance/transaction/list, который был единственным способом для продавцов узнать, сколько денег по каждому отправлению реально доходит до них. Это решение было анонсировано 6 мая на dev.ozon.ru, где обещали отключить метод 6 июля. Однако, 6 июля метод не был отключен, и в августе он продолжал работать без пометок о предстоящем отключении. В итоге, 8 сентября метод стал отвечать ошибкой HTTP 400 с сообщением о том, что он устарел.

Уровни финансовой информации для продавцов

Продавцы на маркетплейсе Ozon имеют доступ к трем уровням информации о финансах: 1. Методы заказов (/v3/posting/fbs/list и аналогичные) — показывают цену товара и статус "оплачено покупателем", но не отражают реальные доходы продавца. 2. Отчёт о реализации — приходит раз в месяц, одной суммой, что подходит для бухгалтерии, но не для оперативного управления. 3. Финансовые операции — здесь отображаются все начисления и удержания по каждому заказу, что позволяет точно определить, является ли конкретный заказ прибыльным или убыточным. На практике, разница между суммой, уплаченной покупателями, и суммой, которая дойдет до продавца, может быть значительной. Например, за 14 дней покупатели заплатили 1 616 172 ₽, но до счёта дойдёт только 1 289 065 ₽, что составляет 79,8 %.

Как работал старый API

Метод /v3/finance/transaction/list принимал период и возвращал операции постранично, по 1000 штук. Каждая операция содержала такие поля, как operation_id, operation_type, operation_date, posting_number и другие. Важно отметить, что поле amount является источником истины, и его не следует пересчитывать, так как это может привести к ошибкам. Например, на выборке в 400 операций были расхождения в 35 случаях.

Проблемы с мониторингом

Синк, который использовался для мониторинга, работал корректно, но не сигнализировал о проблемах, так как общий статус был "зелёным". Ошибки, связанные с отключением метода, накапливались, и их количество достигло трех тысяч. Это произошло потому, что синк не отслеживал возраст последних данных, что могло бы помочь выявить проблему раньше.

Замена отключенного метода

После отключения метода /v3/finance/transaction/list, продавцам следует использовать новый метод /v1/finance/accrual/by-day. Этот метод имеет несколько отличий:

Запросы можно делать только на один день.

Пагинация осуществляется курсором, а не страницами.

Структура данных стала вложенной, что требует дополнительных усилий для обработки.

Важно отметить, что Ozon сохранил прежние идентификаторы, что позволяет избежать проблем с историей данных.

Яма на 1,2 %

Существует соблазнительный метод /v1/finance/accrual/postings, который позволяет запрашивать начисления по номерам отправлений. Однако он не включает приём платежа, что приводит к расхождению в 1,2 % по сравнению с данными из нового метода. Для получения чистого дохода необходимо использовать метод by-day, который возвращает данные с учётом всех вычетов.

Услуги в новом API

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

Заключение

В итоге, отключение метода /v3/finance/transaction/list и переход на новый API потребовали от продавцов адаптации и пересмотра подходов к мониторингу финансовых данных. Важно не только следить за статусом синка, но и учитывать возраст последних данных для каждого шага. Также стоит быть внимательными к изменениям в структуре данных и проверять соответствие данных из разных методов.