Ключ Ozon
Как выпустить API-ключ Ozon, куда вставить и что сервис проверит.
На этой странице
Работа с Ozon FBS — бета-версия: подключиться можно уже сейчас, коды Ozon входят в документы вывода и возврата так же, как коды Wildberries.
Ключ Ozon — пара «Client-Id и API-ключ», по которой Биркадо читает данные вашего кабинета Ozon: отправления FBS, коды маркировки в них, возвраты и карточки товаров. Сервис только читает: менять что-то в Ozon он не будет.
Как выпустить ключ
- Войдите в кабинет продавца Ozon Seller.
- Откройте Настройки → Seller API.
- Нажмите «Сгенерировать ключ».
- Уровни доступа — Admin read only и Posting FBS.
- Цель — для внешнего сервиса, название — «Биркадо».
- Разрешённые сети не задавайте.
- Скопируйте ключ сразу: Ozon показывает его один раз. Client-Id — номер на той же странице.
Куда вставить
Владелец или администратор организации вставляет ключ в «Настройки → Подключения → Ozon» и нажимает «Проверить и сохранить». На первой настройке ключ вставляется в карточку организации (строка Ozon → «Подключить» → «Проверить»): если организации ещё нет, она заведётся по ключу — с названием и ИНН магазина.
Сервис проверит ключ двумя запросами на чтение:
- срок действия ключа и уровни доступа Admin read only и Posting FBS;
- ИНН магазина Ozon — он должен совпасть с ИНН организации. Магазин другой организации подключить нельзя.
Сразу после сохранения начинается первый сбор Ozon — отправления за последние 90 дней (на тарифе «Старт» — 30, на «Бизнесе» — 60).
Срок действия ключа
Ключ Ozon «для внешнего сервиса» действует три месяца. Срок виден в «Настройки → Подключения»:

Когда ключ истечёт, сбор Ozon остановится, а в подключении появится просьба выпустить новый ключ: выпустите его так же и нажмите «Заменить ключ». Удалить ключ — кнопка «Удалить ключ»: собранное останется, новые данные перестанут приходить.
Что сервис делает с данными Ozon
- Коды из отправлений Ozon ложатся в те же корзины, что и коды Wildberries: к выводу, к возврату, вопросы, без действий. В таблицах у таких кодов — знак Ozon.
- Срок вывода — по закону: три рабочих дня после передачи отправления в доставку, но не позже доставки покупателю.
- Имена, телефоны и адреса покупателей и курьеров, которые Ozon присылает в ответе об отправлении, сервис отбрасывает при получении и не хранит.
Коды Ozon в документах
Коды Ozon «к выводу» и «к возврату» входят в новый документ вместе с кодами Wildberries той же товарной группы с первого сбора. Если подача по Ozon приостановлена, на «Операциях» у числа Ozon стоит метка «подача приостановлена», а окно документа говорит, сколько кодов Ozon в документ не входит. Коды Wildberries это не затрагивает.
Если ключ не принимается
Сервис называет причину отказа:
- «у ключа нет уровня доступа…» — отметьте уровни Admin read only и Posting FBS в настройках ключа (Настройки → Seller API → ⋮ → Редактировать) или выпустите новый ключ.
- «ключ от магазина Ozon с ИНН …, а организация — с ИНН …» — ключ выпущен в магазине другой организации. Подключите его в организации с тем же ИНН.
- «срок действия ключа истёк» или «Ключ отключён в кабинете Ozon» — выпустите новый ключ.
- «У ключа заданы «Разрешённые сети»…» — уберите сети в настройках ключа или выпустите ключ без них.
- «в кабинете Ozon не принята актуальная оферта» — примите оферту в кабинете Ozon и сохраните ключ снова.
Не получается — напишите в поддержку.
Остался вопрос? Напишите в поддержку или в Telegram — ответим и дополним статью.
