Как подключить кабинет Ozon: ключи Seller API

Где взять Client-Id и Api-Key, какую роль выбрать, зачем нужен Performance API и что делать, если ключ не принимается.

Чтобы mpvalue считал вашу чистую прибыль, ему нужен доступ к данным кабинета Ozon: заказы, продажи, комиссии, логистика, остатки, начисления. Всё это сервис забирает по API — вы один раз вставляете два ключа, дальше данные подтягиваются сами. Занимает 5 минут.

Шаг 1. Получите ключи Seller API

1. Откройте Ozon Seller → Настройки → Seller API.
2. Нажмите «Сгенерировать ключ».
3. Роль — «Администратор». Подойдёт и «Только чтение», но тогда после подключения проверьте, что все нужные API отметились как доступные (см. шаг 3).
4. Скопируйте Client Id (короткий номер, например 9305) и Api Key (длинная строка вида xxxxxxxx-xxxx-...).

Api Key показывается один раз при создании. Не успели скопировать — просто сгенерируйте новый ключ, старый можно удалить.

Шаг 2. Добавьте кабинет в mpvalue

1. В сервисе откройте раздел «Кабинет» и нажмите «+ Добавить кабинет».
2. Название кабинета — любое понятное вам (например, название бренда). Если кабинетов несколько, вы будете переключаться между ними по этому имени.
3. Площадка — OZON.
4. Тариф OZON — если знаете (Premium, Premium Plus, Premium Pro), выберите; если нет — оставьте «Не знаю / определить автоматически». Поле справочное, на подключение не влияет.
5. Вставьте Client-Id и Api-Key в блок Seller API.
6. Нажмите «Сохранить».

Если забудете, где что брать — прямо в форме есть сворачиваемая подсказка «❓ Где взять ключи Ozon? — пошагово» со ссылками в личный кабинет Ozon.

Шаг 3. Performance API — для раздела «Реклама»

Seller API не отдаёт рекламные расходы. Без Performance API вы увидите продажи и себестоимость, но не увидите ДРР и не поймёте, съедает ли реклама маржу конкретного SKU. Раздел «Реклама» и рекламные метрики в других отчётах работать не будут.

1. Откройте Ozon Performance → Настройки → API.
2. Создайте аккаунт API.
3. Скопируйте Client Id (выглядит как XXX@advertising.performance.ozon.ru) и Client Secret.
4. Вставьте их в блок Performance API (опционально) в той же форме и сохраните.

Performance API можно добавить и позже — просто откройте кабинет и допишите два поля.

Что происходит после сохранения

Сервис сразу проверяет ключи и в таблице кабинетов показывает, какие API доступны: Seller, Analytics, Finance, Reports, Performance. Это ваш чек-лист — если какой-то блок не подтвердился, часть отчётов будет пустой. Перепроверить доступы в любой момент можно кнопкой «Probe» рядом с кабинетом.

Чтобы начать работать в кабинете, нажмите «Активировать» — все разделы сервиса будут показывать данные именно этого кабинета.

Безопасность

• Ключи хранятся в зашифрованном виде (AES-256).
• Сервис работает только на чтение: он ничего не меняет в вашем кабинете Ozon — не правит цены, не создаёт поставки, не запускает кампании.
• Ключ можно отозвать в любой момент на стороне Ozon — доступ сразу прекратится.

Что дальше

Себестоимость, МРЦ, классификация и коллекции не приходят по API Ozon — площадка их не отдаёт. Загрузите их файлом (xlsx) в разделе «Юнит-экономика». Без себестоимости чистая прибыль не посчитается: сервис покажет выручку и комиссии, но не маржу.

Если не получилось

«Укажи Client-Id и Api-Key для Seller API» / ключ не принимается. Чаще всего в поле попал лишний пробел или строка скопировалась не целиком. Вставьте значения заново, без пробелов по краям. Проверьте, что не перепутали местами Client-Id (короткий номер) и Api-Key (длинная строка), и что ключ не удалён в кабинете Ozon.

Подключилось, но часть API не подтвердилась. Обычно причина — роль ключа или тариф Ozon: часть отчётов (аналитика, финансы) доступна не на всех подписках. Сгенерируйте новый ключ с ролью «Администратор», обновите его в форме и нажмите «Probe».

Нет раздела «Реклама» / ДРР пустой. Не заполнены Performance Client ID и Client Secret — это отдельные ключи из performance.ozon.ru, ключи Seller API сюда не подходят. Добавьте их в форме кабинета.

Не решилось — напишите в поддержку: Telegram @mpvalue_ru или mpvalue@yandex.ru.