Ozon закрывает старые методы финансовых транзакций
14 июля Ozon пометил /v3/finance/transaction/list и /totals устаревшими с переходом на новый accrual-контур.
Финансовый API меняет саму модель получения данных. Это не тот случай, где достаточно подменить версию endpoint и оставить старую бизнес-логику.
- не использовать v3 finance transaction в новом коде
- хранить accrual_id и тип начисления отдельно
- сверить итоги старого и нового контура на закрытом периоде
Что изменилось
В качестве замены Ozon указал /v1/finance/accrual/postings, /v1/finance/accrual/types и /v1/finance/accrual/by-day. Старые методы были назначены к отключению 8 сентября.
Почему это важно продавцу
Старая модель транзакций и новая модель начислений по-разному группируют финансовые сущности. Если пытаться натянуть новые ответы на старую таблицу без переосмысления, можно получить дубли, пропуски или неверную связь с заказом. Особенно опасно это для маржинальности и сверки выплат.
Что проверить на практике
Миграцию лучше вести как отдельный финансовый контур: сначала сохранять raw-данные начислений, затем построить нормализацию и только после сверки нескольких периодов переключать отчёты.
- не использовать v3 finance transaction в новом коде
- хранить accrual_id и тип начисления отдельно
- сверить итоги старого и нового контура на закрытом периоде