Интеграции

Client ID и API Key Ozon: где взять, какие права нужны и как подключить кабинет Ozon Seller к системе учёта

Ozon авторизует внешние системы парой значений — Client ID и API Key. Оба выдаёт кабинет продавца, оба вводятся один раз. Разбираем на примере NeoIT Hub: где их взять, почему ключ «только для чтения» подключится, но остатки публиковать не будет, что значит «ключ действует 90 дней», какие склады Ozon сейчас поддерживаются и зачем нужен (и почему необязателен) Performance API.

Источники сверены Автор: Редакция NeoIT7 официальных источниковНе покрывает: Склады моделей Express и rFBS, а также FBO (Ozon отгружает со своих складов) в этой статье не описываются: интеграция протестирована для обычной модели FBS, остальные будут добавляться по мере тестирования. Рекламные функции Performance API не разбираются — только сам факт, что он необязателен.

Два значения вместо пароля

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

После подключения кабинет Ozon становится одним из каналов: остаток на него уходит из общего единого остатка, цену считает репрайсер, заказы FBS приходят в общее окно вместе с заказами Wildberries и Яндекс Маркета.

Схема: планшет, карточка-идентификатор и ключ слева, склад-хаб в центре, справа коробки, ценник и коробка-заказ; стрелка от пары ключей к хабу и три стрелки от хаба
Ozon авторизует запросы парой Client ID + API Key — оба значения вводятся один раз

Где взять Client ID и API Key

Оба значения выдаёт кабинет продавца seller.ozon.ru в разделе Настройки → API ключи. Client ID показан там постоянно — это просто номер магазина. API Key создаётся кнопкой создания ключа и показывается один раз: скопируйте его сразу, повторно посмотреть ключ нельзя, только создать новый.

Права ключа

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

Что система читает из кабинета и что пишет обратно

НаправлениеЧто передаётсяОт чего зависит
Ozon → NeoITтовары, заказы FBS, остатки и склады кабинетаправа ключа; каталог целиком загружается, если Ozon выбран основным источником
NeoIT → Ozonостатки — единый свободный остаток из модуля «Склады»; цены — из репрайсераключ с правом изменения + переключатель «Публикация остатков» на карточке Ozon в «Интеграциях»
Главное

Модель размещения определяется складом, а не кабинетом. У Ozon один кабинет может одновременно держать обычные FBS‑склады, Express и rFBS. NeoIT Hub протестирован для обычной модели FBS; склады других моделей не скрываются — они видны в списке с пометкой, по которой понятно, почему система их пока не обслуживает.

Подключение кабинета в NeoIT Hub: по шагам

Страница «Ozon» в разделе «Интеграции» NeoIT Hub: поля «Client ID» и «API Key», необязательное поле «Ключ действует до» с кнопкой «Создан сегодня — 90 дней», свёрнутый блок «Performance API» с пометкой «Необязательно», справа шаги «Как подключить»
Подключение Ozon: пара Client ID + API Key, дата истечения ключа по желанию, Performance API — только для рекламы (данные демонстрационные)

Откройте карточку Ozon

Раздел «Интеграции» → карточка Ozon → «Подключить» (у подключённого кабинета — «Настроить»). Справа на странице — памятка «Как подключить», подробный FAQ — в меню «Поддержка» в шапке, пункт «Вопросы и ответы» по этой странице.

Вставьте Client ID и API Key

Оба поля обязательны. «Название подключения» — только для вас, чтобы различать кабинеты.

При желании укажите, до какой даты действует ключ

Поле «Ключ действует до» необязательное. Ozon не отдаёт срок ключа через API, поэтому без него система показывает «?» вместо счётчика. Дату видно в кабинете Ozon: Настройки → Seller API, колонка «Истекает через». Если ключ только что выпущен, кнопка «Создан сегодня — 90 дней» подставит дату сама.

Почему 90 дней

Ключи Ozon перестали быть бессрочными: созданные с 3 сентября 2026 действуют 90 дней. У выпущенных раньше срок другой, поэтому единой формулы нет — дату лучше скопировать из кабинета.

Нажмите «Проверить»

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

Выберите основной источник каталога

Ozon — каталог берётся из кабинета, карточки загружаются автоматически; Виртуальный склад — каталог и остатки вы ведёте у себя, а Ozon остаётся каналом продаж. Основной источник в компании один: выбрать Ozon здесь значит снять эту роль с прежнего источника.

Нажмите «Подключить»

Настройки сохраняются, включается регулярный обмен. API Key после сохранения показывается замаскированным; чтобы заменить его, вставьте новый и сохраните, а если оставить поле как есть — сохранённое значение не изменится.

Performance API: зачем он и почему необязателен

Performance API — отдельный интерфейс Ozon для рекламы и расширенной аналитики продвижения. У него собственная пара доступа: Performance Client ID и Performance Client Secret. Товары, заказы, остатки и цены через него не ходят — для них достаточно Seller API, то есть обычных Client ID и API Key. Поэтому блок «Performance API» на странице подключения свёрнут и помечен «Необязательно»: его можно заполнить позже, вернувшись на эту страницу, — без него не будет только рекламной аналитики.

Сохранённый Performance‑секрет тоже показывается замаскированным. Пустое поле его не стирает: секрет удаляется только вместе с отключением интеграции.

Публикация остатков: включить, выключить, «Только чтение»

Раздел «Интеграции» NeoIT Hub: сводка «Источник каталога» и «Публикация остатков»; карточки Wildberries, Ozon и Яндекс Маркета со статусом «Подключено», переключателем публикации остатков и кнопками «Настроить», «Сделать основным», «Отключить»
Раздел «Интеграции»: у каждого маркетплейса своя карточка со статусом, переключателем публикации остатков и кнопкой «Сделать основным» (данные демонстрационные)

Право системы записывать остатки в кабинет — отдельный переключатель на карточке Ozon в разделе «Интеграции». «Публикация остатков включена» — система перезаписывает остатки в кабинете своими значениями ближайшим циклом; «Только чтение» — данные из Ozon загружаются, обратно ничего не отправляется. Над карточками строка сводки показывает, в какие каналы публикация разрешена сейчас.

Переключатель не заменяет права ключа

Если ключ выдан только для чтения, включённый переключатель ничего не изменит — Ozon отклонит запись. Права меняются только выпуском нового ключа в кабинете.

Замена ключа, отзыв и отключение

  • Заменить ключ. Создайте новый в кабинете Ozon, вставьте его в поле «API Key» и сохраните. Обновите и дату в «Ключ действует до» — старая относится к прежнему ключу, и система об этом предупредит.
  • Отозвать доступ. Удалите ключ в кабинете Ozon и отключите интеграцию кнопкой «Отключить» на карточке.
  • Отключить интеграцию. Обмен с Ozon прекратится: заказы, товары и остатки загружаться не будут, публикация остановится. Загруженные ранее данные останутся в системе. Если Ozon был основным источником, сначала выберите другой.

Состояния карточки в «Интеграциях»

СостояниеЧто означаетЧто делать
Не подключенопара Client ID + API Key не сохранена«Подключить»
Подключеноключ сохранён, регулярный обмен идётследить за сроком ключа (счётчик или «?») и переключателем публикации
Основнойэтот кабинет — источник каталога и остатков для всей компаниименять через «Сделать основным» у другого источника или «Переключить источник» у виртуального склада
Ошибкаканал отвечает с ошибками — истёк или удалён ключ, не хватает прав, площадка недоступнапрочитать текст ошибки в блоке диагностики, устранить причину, нажать «Сбросить ошибки»

Чего подключение не делает

  • Не создаёт карточки на Ozon. Карточки заводятся в кабинете; система сопоставляет их со своими товарами и работает с остатками, ценами и заказами.
  • Не обслуживает склады Express и rFBS. Они видны в списке с пометкой; поддержка добавляется по мере тестирования.
  • Не знает срок ключа сама. Ozon не отдаёт его через API — дата берётся из кабинета и вводится продавцом.
  • Не требует Performance API. Без него работает всё, кроме рекламной аналитики.

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

Где посмотреть Client ID в кабинете Ozon?

В том же разделе, где создаются ключи: Настройки → API ключи. Client ID показан постоянно, копировать его можно сколько угодно раз; одноразово показывается только API Key.

Кнопка «Проверить» показала чужой магазин. Что это значит?

Пара Client ID + API Key принадлежит другому кабинету. Проверка ничего не сохраняет — исправьте значения и нажмите «Проверить» ещё раз; подключить чужой кабинет по ошибке не получится, потому что «Подключить» повторяет ту же проверку.

Почему рядом с интеграцией стоит «?» вместо количества дней?

Ozon не отдаёт срок ключа через API. Заполните поле «Ключ действует до» датой из кабинета (Настройки → Seller API, колонка «Истекает через») — счётчик начнёт показывать настоящий остаток: зелёный, пока больше 30 дней, красный — когда меньше.

У меня в кабинете и обычные FBS‑склады, и Express. Что будет?

Обычные FBS‑склады система обслуживает; Express‑склады останутся в списке с пометкой и в обмен не попадут, пока поддержка не будет добавлена.

Публикация включена, а остатки на Ozon не меняются. Что проверить?

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

Можно ли подключить Performance API позже?

Да. Блок на странице подключения свёрнут именно для этого: заполните Performance Client ID и Secret, когда понадобится рекламная аналитика, — остальное продолжит работать как раньше.

Источники

  1. NeoIT Hub — справка «Ozon»: Client ID и API Key, права ключа, модели FBS/Express/rFBS, срок действия ключа 90 дней, кнопка «Проверить», Performance API, основной источник, отключение neoit.ru
  2. NeoIT Hub — страница подключения Ozon (integration-ozon.html) и раздел «Интеграции»: названия полей, кнопок и состояний проверены на production 12.09.2026 neoit.ru
  3. Ozon — кабинет продавца Ozon Seller (Настройки → API ключи) seller.ozon.ru
  4. Ozon — документация Seller API docs.ozon.ru
  5. NeoIT Hub — База знаний: «Единые остатки для Wildberries, Ozon и Яндекс Маркета» neoit.ru
  6. NeoIT Hub — База знаний: «Репрайсер для Wildberries, Ozon и Яндекс Маркета» neoit.ru
  7. NeoIT Hub — База знаний: «API‑токен Wildberries: где взять, какие категории доступа нужны и как подключить кабинет» neoit.ru

Материал подготовлен NeoIT Hub. Источники сверены 12.09.2026. Это не юридическая консультация.