Ключ Ozon Seller API: как создать и какие роли нужны

Обновлено 02.08.2026 · Команда «В плюсе»

Ключ Seller API — это доступ, которым сервис читает ваш кабинет Ozon: отправления FBO и FBS, начисления и удержания, товары, остатки. Ключ состоит из двух частей — Client-Id (номер кабинета) и Api-Key (сама строка доступа). Создаётся он в кабинете Ozon за пару минут.

Форма подключения магазина Ozon: поля «Название магазина», Client-Id и Api-Key, инструкция по созданию ключа и блок рекламных ключей — Куда вставлять ключ: «Магазины» → «Добавить магазин» → Ozon.

Как создать ключ

1
Откройте «Профиль → Настройки → API интеграции → Seller API»
Прямая ссылка: seller.ozon.ru/app/settings/api-keys
2
Нажмите «Сгенерировать ключ»
Дайте ему понятное имя, например «В плюсе», — чтобы потом отличать его от других ключей кабинета.
3
Выберите роль «Admin read only»
Это роль только на чтение: изменить что-либо в вашем кабинете с таким ключом невозможно. Если название с «Admin» смущает — ниже есть проверенная альтернатива.
4
Скопируйте Api-Key, а Client-Id возьмите там же
Client-Id показан на той же странице, рядом со списком ключей.

Какую роль выбрать

Мы рекомендуем Admin read only. Название звучит тревожно, но это не административные права: роль открывает только методы чтения — 261 штука, и ни одного изменяющего. Она заведомо покрывает всё, что сервису нужно, включая методы, которые Ozon добавит завтра.

Не хотите давать роль со словом «Admin»?

Есть альтернатива — набор узких ролей. Мы проверили его на живом кабинете: с ним работают все данные, включая расходы. Отметьте все семь:

Company
Posting FBO
Posting FBS read-only
Product read-only
Warehouse
Report
Сервис Бухгалтерия

Отметьте все семь — пропущенная роль ломает тихо

Если одна из ролей не отмечена, ключ всё равно создастся и магазин подключится. Просто часть данных не придёт: например, раздел останется пустым, а расходы не попадут в прибыль — и цифра окажется выше настоящей. Ошибку не видно ни вам, ни нам, поэтому набор нужно скопировать целиком. Если сомневаетесь — берите Admin read only: там ошибиться нечем.

Безопасно ли отдавать ключ

Обе рекомендуемые роли — только на чтение. С таким ключом нельзя изменить цену, отменить отправление, тронуть остатки или карточку товара: изменяющих методов у него нет физически, а не «мы обещаем ими не пользоваться».

Ключ хранится зашифрованным и нигде в интерфейсе не показывается — даже вам: в настройках магазина видно только Client-Id.
Роль Admin (без «read only») мы не просим никогда — она умеет менять данные кабинета, а нам нечего в нём менять.
Отозвать доступ можно в любой момент: удалите ключ в кабинете Ozon. Сервис перестанет получать данные, уже загруженные останутся.

«Разрешённые сети» оставьте пустыми

У ключа есть вторая вкладка — ограничение доступа по IP-адресам. По умолчанию там «Нет разрешённых сетей», то есть без ограничения, и так и нужно оставить. Если список задан, а адресов сервиса в нём нет, данные просто не загрузятся — и выглядеть это будет как «неверный ключ».

Ключи рекламного кабинета — отдельно и необязательно

Реклама на Ozon живёт в отдельном сервисе со своей парой ключей (Performance API), они выдаются на соседней странице настроек. Эти ключи нужны только для отчёта «Реклама» — какие кампании окупаются, а какие жгут бюджет.

На прибыль рекламные ключи не влияют

Списания за продвижение Ozon присылает вместе с остальными начислениями кабинета, и сервис вычитает их из прибыли без этих ключей. Так что прибыль будет верной, даже если рекламные ключи вы не добавите.

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

«Ozon не принял ключ» — Ozon отвечает одинаково и на неверный Api-Key, и на неверный Client-Id, поэтому подсказать, что именно не так, мы не можем. Проверьте оба поля: Client-Id — это число, Api-Key — длинная строка с дефисами.
Данные пришли не полностью — чаще всего это пропущенная роль при создании ключа. Проще всего создать новый ключ с ролью Admin read only и заменить его в «Ключах магазина».
«Кабинет уже подключён к другому аккаунту» — один кабинет Ozon привязывается только к одному аккаунту «В плюсе». Если это ваш кабинет и доступ к старому аккаунту утрачен, напишите нам через контакты — поддержка отвяжет его.
Ключ отозвали — создайте новый и вставьте его в «Ключах магазина». Магазин, его заказы и закупочные цены сохранятся; удалять магазин не нужно.