Подключение Ozon: где взять Client-Id и Api-Key

Ozon отдаёт остатки по паре значений: Client-Id — постоянный номер вашего кабинета, и Api-Key — ключ, который вы создаёте сами. Первое просто копируется, второе показывается один раз при создании.

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

Кабинет Ozon → Настройки → Seller API.

1. Название ключа — любое, оно нужно вам, а не сервису.
2. Цель использования — «Для внешнего сервиса, приложения».
3. Название сервиса — Veloseller.
4. Тип токена — Admin Read only.
5. Нажмите «Сгенерировать».
6. Скопируйте ключ и вставьте в поле Api-Key в Veloseller. Client-Id возьмите с той же страницы.

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

Что сервис читает

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

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

«Api-key is deactivated, use another one or generate a new one». Ключ отключён на стороне Ozon — чаще всего его удалили в кабинете или он был выпущен под другой аккаунт. Лечится только новым ключом: создайте по шагам выше и вставьте вместо старого на странице склада.

Ошибка сразу при подключении. Это и есть проверка ключей: первая синхронизация запускается тут же, чтобы вы узнали о проблеме сейчас, а не через сутки. Проверьте, что Client-Id и Api-Key от одного и того же кабинета и что при создании выбран тип Admin Read only.

«Слишком много запросов» (429). Ozon ограничивает частоту обращений. Это не поломка и вашего вмешательства не требует: сервис ждёт и повторяет сам, повтор идёт каждые пять минут.

Что делать, если склад уже подключён и перестал обновляться, — в части «Склад перестал обновляться».