Внешние системы работают с кабинетом Ozon через Seller API. Каждый запрос он авторизует парой заголовков: Client‑Id — числовой идентификатор магазина — и Api‑Key — секретный ключ, который продавец создаёт сам. Логин и пароль от кабинета внешней системе не нужны, и NeoIT Hub их не запрашивает: на странице подключения ровно два поля, Client ID и API Key.
После подключения кабинет Ozon становится одним из каналов: остаток на него уходит из общего единого остатка, цену считает репрайсер, заказы FBS приходят в общее окно вместе с заказами Wildberries и Яндекс Маркета.
Оба значения выдаёт кабинет продавца seller.ozon.ru в разделе Настройки → API ключи. Client ID показан там постоянно — это просто номер магазина. API Key создаётся кнопкой создания ключа и показывается один раз: скопируйте его сразу, повторно посмотреть ключ нельзя, только создать новый.
Ключ должен позволять и чтение, и изменение данных: система загружает товары, заказы и остатки, а при разрешённой публикации отправляет остатки и цены обратно. Ключ, выданный только для чтения, подключить можно — но публикация остатков и цен работать не будет, и это обнаружится не при подключении, а при первой попытке отправить остаток.
| Направление | Что передаётся | От чего зависит |
|---|---|---|
| Ozon → NeoIT | товары, заказы FBS, остатки и склады кабинета | права ключа; каталог целиком загружается, если Ozon выбран основным источником |
| NeoIT → Ozon | остатки — единый свободный остаток из модуля «Склады»; цены — из репрайсера | ключ с правом изменения + переключатель «Публикация остатков» на карточке Ozon в «Интеграциях» |
Модель размещения определяется складом, а не кабинетом. У Ozon один кабинет может одновременно держать обычные FBS‑склады, Express и rFBS. NeoIT Hub протестирован для обычной модели FBS; склады других моделей не скрываются — они видны в списке с пометкой, по которой понятно, почему система их пока не обслуживает.
Откройте карточку Ozon
Раздел «Интеграции» → карточка Ozon → «Подключить» (у подключённого кабинета — «Настроить»). Справа на странице — памятка «Как подключить», подробный FAQ — в меню «Поддержка» в шапке, пункт «Вопросы и ответы» по этой странице.
Вставьте Client ID и API Key
Оба поля обязательны. «Название подключения» — только для вас, чтобы различать кабинеты.
При желании укажите, до какой даты действует ключ
Поле «Ключ действует до» необязательное. Ozon не отдаёт срок ключа через API, поэтому без него система показывает «?» вместо счётчика. Дату видно в кабинете Ozon: Настройки → Seller API, колонка «Истекает через». Если ключ только что выпущен, кнопка «Создан сегодня — 90 дней» подставит дату сама.
Ключи Ozon перестали быть бессрочными: созданные с 3 сентября 2026 действуют 90 дней. У выпущенных раньше срок другой, поэтому единой формулы нет — дату лучше скопировать из кабинета.
Нажмите «Проверить»
Блок «Проверка соединения» обращается к Ozon с введённой парой и показывает, чей это кабинет и сколько в нём активных FBS‑складов, а ниже — блок «Склады кабинета» со списком складов и их моделями. Проверка ничего не сохраняет: ошибка в ключе видна сразу, а не через сутки в логах синхронизации. Если ключ отозван или создан в другом кабинете, Ozon ответит отказом.
Выберите основной источник каталога
Ozon — каталог берётся из кабинета, карточки загружаются автоматически; Виртуальный склад — каталог и остатки вы ведёте у себя, а Ozon остаётся каналом продаж. Основной источник в компании один: выбрать Ozon здесь значит снять эту роль с прежнего источника.
Нажмите «Подключить»
Настройки сохраняются, включается регулярный обмен. API Key после сохранения показывается замаскированным; чтобы заменить его, вставьте новый и сохраните, а если оставить поле как есть — сохранённое значение не изменится.
Performance API — отдельный интерфейс Ozon для рекламы и расширенной аналитики продвижения. У него собственная пара доступа: Performance Client ID и Performance Client Secret. Товары, заказы, остатки и цены через него не ходят — для них достаточно Seller API, то есть обычных Client ID и API Key. Поэтому блок «Performance API» на странице подключения свёрнут и помечен «Необязательно»: его можно заполнить позже, вернувшись на эту страницу, — без него не будет только рекламной аналитики.
Сохранённый Performance‑секрет тоже показывается замаскированным. Пустое поле его не стирает: секрет удаляется только вместе с отключением интеграции.
Право системы записывать остатки в кабинет — отдельный переключатель на карточке 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, когда понадобится рекламная аналитика, — остальное продолжит работать как раньше.
- NeoIT Hub — справка «Ozon»: Client ID и API Key, права ключа, модели FBS/Express/rFBS, срок действия ключа 90 дней, кнопка «Проверить», Performance API, основной источник, отключение neoit.ru
- NeoIT Hub — страница подключения Ozon (integration-ozon.html) и раздел «Интеграции»: названия полей, кнопок и состояний проверены на production 12.09.2026 neoit.ru
- Ozon — кабинет продавца Ozon Seller (Настройки → API ключи) seller.ozon.ru
- Ozon — документация Seller API docs.ozon.ru
- NeoIT Hub — База знаний: «Единые остатки для Wildberries, Ozon и Яндекс Маркета» neoit.ru
- NeoIT Hub — База знаний: «Репрайсер для Wildberries, Ozon и Яндекс Маркета» neoit.ru
- NeoIT Hub — База знаний: «API‑токен Wildberries: где взять, какие категории доступа нужны и как подключить кабинет» neoit.ru
Материал подготовлен NeoIT Hub. Источники сверены 12.09.2026. Это не юридическая консультация.
