Ozon переводит финансовую API-аналитику на методы начислений
Вместо transaction/list и totals Ozon указал методы accrual. Что проверить в учётной системе после объявленного перехода 8 сентября.
Содержание статьи
Ozon объявил о переходе финансовых интеграций с методов /v3/finance/transaction/list и /v3/finance/transaction/totals на группу accrual. В сообщении от 15 июля 2026 года датой отключения старых методов указано 8 сентября. К октябрю объявленный срок уже прошёл: владельцам внешней аналитики важно проверить, на каком источнике работает их расчёт.
Какие методы указаны для перехода
Официальный анонс направляет разработчиков к /v1/finance/accrual/postings, /v1/finance/accrual/types и /v1/finance/accrual/by-day. Их назначение нужно учитывать при построении выгрузки: перенос не сводится к замене адреса запроса при сохранении старой структуры ответа.
Кроме того, в июньском обновлении Ozon сообщил о переименовании accruals.type_id в accruals.accrual_id в ответе by-day. Для коннектора, который разрабатывался по раннему описанию, это отдельный повод проверить схему. Фактическую доступность старых методов редакция не проверяла вызовами с ключом продавца.
Как сверить финансовый результат
До обновления полезно зафиксировать завершённый период и контрольные суммы действующего учёта. После перехода сравнивайте не только общий итог, но и группы начислений, привязку к отправлениям и операции, которые попали в соседний день.
Если разница обнаружилась, её следует разложить до исходных записей. Совпавший итог не гарантирует правильную классификацию: две ошибки разных знаков могут взаимно скрыться. Особенно важна проверка управленческих показателей, которые используют отдельные статьи затрат, а не только общий денежный результат.
Что запросить у поставщика аналитики
У внешнего сервиса можно уточнить используемые методы, дату обновления коннектора и выполненную сверку. Ответ «API подключён» не объясняет, какая финансовая модель используется и как обработаны изменения полей.
Для собственной интеграции стоит сохранить журнал версии преобразования данных. Тогда расхождение в старом отчёте можно будет связать с конкретной схемой импорта. При пересчёте истории не смешивайте необозначенные выгрузки разных версий: воспроизводимость финансового показателя важнее внешне непрерывного графика.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы