Инструкция

Как получить ключ Ozon Seller API

Ключ создаёт владелец кабинета или сотрудник с правами администратора. Для расчёта налога достаточно доступа к финансовым отчётам — менять цены, остатки и заказы таким ключом невозможно.

1. Создание ключа

1. Войдите в кабинет продавца seller.ozon.ru.
2. Нажмите на шестерёнку в правом верхнем углу → Настройки.
3. Откройте раздел Seller API (в некоторых кабинетах он называется «API-ключи»).
4. Нажмите «Сгенерировать ключ».
5. Укажите название — например, Расчёт налога Finexpert66.
6. Выберите права доступа: Финансы (финансовые отчёты и транзакции). Если Ozon предлагает роли — подойдёт «Финансовый менеджер» или «Аналитика».
7. Скопируйте Api-Key. Ozon показывает его только один раз — если потеряли, придётся создать новый.

2. Где взять Client-Id

Client-Id — числовой идентификатор кабинета. Он показан в шапке раздела Seller API рядом со списком ключей и не является секретом сам по себе, но нужен для каждого запроса.

3. Что сервис делает вашим ключом

Сервис вызывает только методы чтения финансовых данных:

• POST /v2/finance/realization — отчёт о реализации товаров за месяц. Это основной источник дохода для УСН.
• POST /v1/finance/accrual/by-day — начисления за день: компенсации за утерю и порчу товара, удержания Ozon за услуги, прочие начисления.
• POST /v1/finance/accrual/types — справочник типов начислений, чтобы показать расшифровку понятными названиями.

Никакие данные в вашем кабинете Ozon не изменяются. Ключ хранится в базе сервиса в зашифрованном виде и расшифровывается только на время запроса.

4. Проверка подключения

После сохранения кабинета нажмите «Проверить ключ» — сервис попробует получить отчёт о реализации за последний закрытый месяц и покажет его номер и количество строк. Это значит, что подключение работает.

Если вы предпочитаете проверить самостоятельно, из командной строки:

curl -X POST https://api-seller.ozon.ru/v2/finance/realization \
  -H "Client-Id: 123456" \
  -H "Api-Key: ваш-ключ" \
  -H "Content-Type: application/json" \
  -d '{"year":2026,"month":1}'

5. Как отозвать ключ

В том же разделе Настройки → Seller API ключ можно удалить в один клик. Рекомендуем делать это при смене бухгалтера или подрядчика. После удаления ключа расчёты в сервисе перестанут выполняться — просто добавьте новый ключ в настройках кабинета.

6. Что делать при ошибках

• 401 / 403 — неверный Client-Id или у ключа нет прав на финансовые методы. Проверьте пару значений и права ключа в кабинете Ozon.
• 404 — отчёт о реализации за этот месяц ещё не сформирован. Ozon формирует его примерно к 5-му числу следующего месяца.
• 429 — слишком много запросов; сервис сам повторит попытку через паузу.
• Расхождение контрольной суммы — сумма компонентов выручки не сошлась с «цена продавца × количество». Такое бывает при нестандартных механиках лояльности: проверьте отчёт о реализации в кабинете Ozon и при необходимости напишите нам.