Как получить API-ключ Ozon: пошаговая инструкция для селлеров

API-ключ Ozon нужен селлеру не ради «технологичности», а чтобы перестать руками выгружать отчёты. Один раз настроили подключение — и аналитика, остатки, заказы, расход на рекламу подтягиваются автоматически. Ниже — пошаговая инструкция: где взять ключи, какие роли выдать и что делать, если что-то отвалилось.

Какие ключи вообще нужны

У Ozon две независимые системы и два разных набора ключей. Первый — Seller API: seller.ozon.ru, откуда вы получаете данные по товарам, заказам, остаткам и финансам. Понадобятся Client ID (число вида 12345) и API-ключ (длинная строка). Второй — Performance API: отдельный кабинет performance.ozon.ru, откуда подтягиваются расходы на рекламу и статистика кампаний. Тут другие учётные данные: Client ID (вида 24681234-1234567@advertising.performance.ozon.ru) и Client Secret. Один без другого полную картину не даёт: без Seller API нет продаж, без Performance — нет ДРР.

Шаг 1. Создаём ключ Seller API

Откройте seller.ozon.ru → Настройки (шестерёнка) → Seller API. На экране «API-ключи» нажмите «Сгенерировать ключ». Ozon попросит ввести название (например, «VelesRadar») и выбрать роли. После генерации ключ показывается один раз — скопируйте его сразу и не закрывайте вкладку, пока не сохраните. Client ID лежит здесь же, в шапке раздела.

Шаг 2. Какие роли выдать

Чтобы аналитика была полной, нужны три роли: «Аналитика» (продажи, заказы, метрики), «Контент» (карточки и атрибуты SKU) и «Финансы» (отчёты по транзакциям и удержаниям). Без «Финансов» вы не увидите фактическую сумму, которую Ozon перечисляет на счёт после всех комиссий, логистики и эквайринга — то есть чистую прибыль посчитать не получится. Если боитесь «лишних прав» — спокойно: эти роли read-only и не позволяют менять цены, остатки или карточки.

Шаг 3. Получаем Performance API

Перейдите в performance.ozon.ru (логин тот же, что в Seller, но кабинет отдельный) → Настройки → API. Нажмите «Создать аккаунт» — Ozon выдаст связку Client ID и Client Secret. Client ID будет в формате длинной строки с суффиксом @advertising.performance.ozon.ru — это нормально, вставлять нужно целиком. Secret тоже показывается один раз, копируйте сразу.

Шаг 4. Вставляем ключи в VelesRadar

В VelesRadar откройте «Магазины» → «Добавить магазин», выберите Ozon. В форме поля: Название магазина, Client ID (Ozon), API-ключ (Ozon). Вставьте Client ID и API-ключ и нажмите «Подключить магазин». Если статус «OK» — данные начнут синхронизироваться, исторические продажи подтянутся за 30 дней. Performance API (для статистики рекламы) подключается отдельно — в карточке магазина «Реклама и ДРР». Подробности по подключению маркетплейсов собраны на странице интеграции.

Безопасность ключей

Несколько правил, которые экономят нервы: не давайте ключу прав больше, чем нужно (нам не требуется ничего на запись); не отправляйте ключ в чаты и письма открытым текстом; при увольнении подрядчика — сразу отзывайте ключ и генерируйте новый. В VelesRadar ключи хранятся в зашифрованном виде (AES-256-GCM) и расшифровываются только в момент запроса — подробности на странице безопасность. Если ключ всё же утёк — нажмите «Удалить» в кабинете Ozon, перевыпустите новый и обновите в VelesRadar.

Частые ошибки

• 401 Unauthorized — перепутаны Client ID и API-ключ местами, либо ключ удалили в Ozon.
• 403 Forbidden — у ключа не выбрана нужная роль (чаще всего «Финансы»). Перевыпускать не нужно: добавьте роль в Seller API → редактирование ключа.
• Performance отдельно: если ДРР пустой, проверьте, что вставлены ключи именно с performance.ozon.ru, а не Seller.
• Срок действия: Seller API-ключи не истекают, но при смене пароля ЛК их лучше перевыпустить.
• 429 Too Many Requests — лимит запросов; в норме мы сами держим частоту, но если подключаете несколько сервисов, лимит делится между ними.

Когда ключи подключены, открываются и более тонкие вещи: например, корректное разделение расхода на рекламу по моделям оплаты (статья про ДРР и долю рекламных расходов) и аналитика по каждому SKU в разделе аналитика Ozon.

Коротко

• Нужны два набора: Seller API (seller.ozon.ru) и Performance API (performance.ozon.ru).
• Роли для Seller: Аналитика + Контент + Финансы — иначе чистая прибыль будет неполной.
• Все нужные роли read-only, ничего в кабинете не меняют.
• Ключ показывается один раз — копируйте сразу при создании.
• 401/403 — почти всегда проблема ролей или путаницы Client ID / Secret.

VelesRadar подтягивает Ozon Seller и Performance в одно окно, считает чистую прибыль и ДРР по каждому SKU и шлёт утренний бриф с ключевыми цифрами. Подключите магазин — Месяц Pro бесплатно, годовая подписка со скидкой −50% до 31 августа.