Переход финансовой интеграции Ozon с Transaction API на API начислений
Переход финансовой интеграции Ozon с Transaction API на API начислений нужен, когда отчёт по операциям, управленческая прибыль или загрузка в ERP построены на /v3/finance/transaction/list и /v3/finance/transaction/totals. Ozon сообщил, что эти методы устаревают и отключаются 8 сентября 2026 года. Для замены используются три актуальных метода: /v1/finance/accrual/postings возвращает начисления в разрезе отправлений, /v1/finance/accrual/types даёт справочник типов, а /v1/finance/accrual/by-day помогает получать данные по дням.
Структура ответа и логика обхода отличаются от списка транзакций, поэтому простая замена URL оставляет неверные группировки, пропуски либо повторные строки. Мы прослеживаем путь данных от Seller API до финансовой таблицы, определяем назначение каждого используемого поля и связываем новую модель начислений с существующими статьями.
Позиция last_id и дата обработки сохраняются в журнале, чтобы очередной запуск продолжал выгрузку с подтверждённого места. Суммы, отправления, товары и услуги доставки проходят контрольную сверку. В результате бухгалтер, финансовый аналитик или владелец магазина получает привычный отчёт на актуальном API и может открыть журнал конкретного запуска при вопросе по операции.
Когда стоит обратиться
Обычно к нам обращаются в таких ситуациях:
- В коде либо журнале присутствуют обращения к /v3/finance/transaction/list или /v3/finance/transaction/totals.
- Отчёт по прибыли, комиссиям и услугам Ozon строится из собственной базы операций Seller API.
- После пробного перехода суммы сходятся только на общем уровне, а детализация по отправлениям и услугам расходится.
- Финансовая выгрузка запускается по расписанию и должна сохранять полноту при лимитах, повторах и временных ошибках API.
Что именно мы сделаем
Находим все вызовы Transaction API, расписания, промежуточные таблицы и отчёты, которые используют старые операции и итоги.
Сопоставляем поля старого ответа с начислениями, справочником типов, отправлениями, товарами и услугами в актуальном API.
Обновляем запросы, пагинацию через last_id, преобразование сумм, защиту от повторов и журнал каждого запуска.
Загружаем контрольный период параллельно со старым маршрутом и разбираем расхождения по выбранным финансовым статьям.
Переключаем рабочее расписание, наблюдаем первые циклы и передаём карту данных, протокол сверки и инструкцию диагностики.
Что входит в стоимость
69 900 ₽ за всю работу
Разбираем действующие вызовы /v3/finance/transaction/list и /v3/finance/transaction/totals, правила группировки сумм, расписание и место хранения результатов. Строим карту типов начислений и полей новых ответов, обновляем загрузчик, пагинацию, преобразование сумм, повтор запросов и контроль полноты. Сверяем контрольный период со старым отчётом и кабинетом Ozon, документируем объяснимые расхождения и запускаем актуальный обмен.
Что будет готово
Передадим вам
- Рабочий загрузчик начислений Ozon через postings, types и by-day с расписанием и продолжением по last_id.
- Карта соответствий старых операций, новых типов начислений, внутренних статей и ключей связи с отправлением.
- Журнал запусков с датой, страницей, числом строк, результатом повтора и диагностикой ответа Seller API.
- Протокол сверки контрольного периода и инструкция для финансовой команды и разработчика.
Перед сдачей проверим
- Выбранный период загружается полностью, а повтор того же диапазона сохраняет одну запись на каждое начисление.
- Дневные итоги и детализация по отправлениям объясняются строками нового API и выбранной картой финансовых статей.
- После искусственно прерванного запуска обработка продолжается с сохранённого last_id и завершает оставшуюся выборку.
- Рабочий отчёт либо обмен получает данные по расписанию, а журнал позволяет найти источник конкретной суммы.
Как это выглядит на практике
Отчёт по прибыли продолжает получать операции Ozon после смены методов
- 01
Ночное задание запрашивает начисления за выбранную дату и последовательно проходит выдачу по last_id.
- 02
Каждое начисление связывается с отправлением, товаром и внутренней статьёй по утверждённой карте типов.
- 03
Хранилище обновляет существующие строки и добавляет новые, поэтому повтор даты сохраняет чистую выборку.
- 04
Финансовый отчёт показывает дневной итог, а специалист открывает журнал и детализацию при расхождении.
Что понадобится для работы
От вас
- Код либо модуль интеграции, конфигурация расписания и журналы вызовов Transaction API за несколько запусков.
- Доступ к тестовому или рабочему Seller API с Client-Id и Api-Key, предоставленный через защищённый канал.
- Схема таблиц, отчёта, ERP либо BI и действующая карта комиссий, услуг и финансовых статей.
- Контрольный период и несколько отправлений, по которым финансовая команда может подтвердить ожидаемую детализацию.
Если у вас немного другая ситуация
Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.
- 3 000 ₽после подписания договора через Диадок
- 66 900 ₽после выполнения, демонстрации и приёмки результата
Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.
Часто спрашивают
Об этой услуге
Когда Ozon отключает методы Transaction API?
Ozon объявил дату 8 сентября 2026 года для /v3/finance/transaction/list и /v3/finance/transaction/totals. Рабочее переключение лучше завершить с запасом на контрольную сверку.
Какие методы заменяют список и итоги транзакций?
Используются /v1/finance/accrual/postings, /v1/finance/accrual/types и /v1/finance/accrual/by-day. Конкретный набор зависит от детализации действующего отчёта.
Сохранится ли привычный финансовый отчёт?
Да. Мы сохраняем выбранный состав колонок и статей там, где новая модель содержит нужные данные, а изменившиеся понятия оформляем явной картой соответствий.
Как исключаются повторные начисления при перезапуске?
Загрузчик сохраняет устойчивый ключ строки, обработанную дату и last_id. Повторное окно обновляет ту же запись и фиксируется отдельным запуском в журнале.
Почему итог нового API может отличаться от старого totals?
Причиной бывает другая группировка типов, дата отражения услуги или состав детализации. Мы раскладываем разницу по начислениям и фиксируем выбранное правило отчёта.
Потребуется ли менять ключи Seller API?
Обычно действующие Client-Id и Api-Key сохраняются. На старте проверяем права ключа на финансовые методы и используем текущий защищённый способ хранения секретов.
Можно перенести только загрузку в ERP?
Да. В состав можно включить конкретный потребитель данных: ERP, базу, BI либо финансовую таблицу. Точки, связанные с его отчётом и журналом, фиксируем перед стартом.
Как проходит приёмка финансовой миграции?
Загружаем контрольный период, сравниваем дневные итоги и выбранные отправления, повторяем окно и прерываем один запуск. Итог подтверждается отчётом и журналом.
Цена и изменения по ходу работы
Цена на странице окончательная?
Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.
Что означает резерв незапланированных работ?
Это уже включённый в цену запас времени на небольшие связанные уточнения заказчика, которые появляются после старта: например, добавить поле, изменить формат уведомления или учесть ещё одно условие обработки.
Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.
Можно уточнять детали уже во время работы?
Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.
Начало работы и оплата
Как оформляются договор и оплата?
Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.
Когда начинается срок выполнения?
Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.
Как учитываются платные лицензии и внешние сервисы?
До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.
Проверка результата и гарантия
Как принимается готовая работа?
Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.
Какая гарантия действует после сдачи?
На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.
Связанные шаги
- 01Переход интеграции Ozon на новые методы заказов FBO и FBS
Обновить методы заказов Ozon
- 02Переход финансовой интеграции Ozon с Transaction API на API начислений
Перевести финансовые данные на API начислений
- 03Сверка отчётов Ozon с заказами и выплатами
Сверить операции Ozon с заказами и выплатами