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

Любой сервис аналитики для Ozon — и SellOps в том числе — получает данные о вашем магазине через официальный Seller API: это механизм самого Ozon, через который кабинет продавца отдаёт товары, заказы, остатки и финансы внешним программам. Чтобы подключиться, нужны два значения из кабинета: Client ID и Api-Key. Вся процедура занимает две-три минуты, но у того, кто делает это впервые, обычно возникают одни и те же вопросы: где именно лежат эти ключи, какую роль выбрать из огромного списка и не получит ли сторонний сервис контроль над магазином. Разберём всё по шагам.

Главное, что стоит знать заранее: у Ozon есть роль ключа «Admin read only» — доступ только на чтение. Ключ с этой ролью физически не может ничего изменить в вашем кабинете: ни цены, ни остатки, ни заказы. Именно такой ключ и нужен сервису аналитики.

Шаг 1. Откройте раздел Seller API

Зайдите в кабинет продавца seller.ozon.ru. В меню настроек слева найдите группу «API интеграции» и откройте пункт «Seller API». Если не хочется искать по меню — просто перейдите по прямой ссылке seller.ozon.ru/app/settings/api-keys, она ведёт ровно туда же.

Шаг 2. Скопируйте Client ID и нажмите «Сгенерировать ключ»

Вверху страницы Seller API есть поле Client ID — это число, идентификатор вашего кабинета. Скопируйте его кнопкой рядом с полем: это первое из двух значений, которые понадобятся. Ниже, в блоке «API key», нажмите синюю кнопку «Сгенерировать ключ».

Шаг 3. Назовите ключ и выберите роль «Admin read only»

В открывшемся окне «Генерация ключа» два обязательных действия. Первое — название: оно нужно только вам, чтобы потом понимать, какой ключ для чего выпущен (например, «SellOps»). Второе — роль, и вот здесь легко растеряться: список длинный, несколько десятков ролей. Прокрутите его в самый низ и отметьте одну-единственную — «Admin read only», 269 методов. Это все информационные методы Seller API без права что-либо менять.

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

Шаг 4. Скопируйте ключ сразу — он показывается один раз

После нажатия «Сгенерировать» Ozon покажет сам Api-Key — длинную строку из букв и цифр. Скопируйте её сразу: из соображений безопасности повторно ключ не показывается нигде, в списке ключей видна только маскированная версия. Если всё-таки закрыли окно, не скопировав, — ничего страшного: выпустите новый ключ тем же способом, это ни на что не влияет.

Шаг 5. Вставьте оба значения в SellOps

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

Частые вопросы

• Это безопасно? Да: ключ с ролью «Admin read only» умеет только читать данные. Изменить цену, остаток или заказ им нельзя — таких методов в роли просто нет. В SellOps ключ дополнительно шифруется перед сохранением и никогда не показывается в интерфейсе повторно.
• Ключ действует 6 месяцев — Ozon пишет об этом прямо в окне генерации. Когда срок закончится, выпустите новый ключ тем же способом и обновите его в настройках магазина; Client ID при этом остаётся прежним.
• Несколько магазинов? У каждого кабинета Ozon свой Client ID и свои ключи — повторите шаги для каждого кабинета и добавьте их в SellOps как отдельные магазины: смотреть можно и по отдельности, и все вместе.
• А реклама? Ключи рекламного кабинета (Performance API) — отдельная пара Client ID и Client Secret, они выпускаются в том же разделе настроек, пункт «Performance API». Для основной аналитики они не нужны — только если хотите видеть в SellOps расходы на рекламу и ДРР по кампаниям.
• Ключ перестал работать? Проверьте срок действия в списке ключей на странице Seller API — возможно, истёк. Выпустите новый и обновите в SellOps: вся история и данные при этом сохраняются.

На этом всё: две минуты в кабинете Ozon — и аналитика работает на ваших реальных данных, без ручных выгрузок и таблиц. Такая же пошаговая инструкция с интерактивной демонстрацией есть в базе знаний SellOps на странице sellops.ru/guide — раздел «Магазины».