Управление запасами· обновлено ·5 мин чтения

API Ozon из личного кабинета

Через склад OZON FBS вы передаете остатки со своего склада. Мы делаем расчеты по из изменениям.


Для подключения склада Ozon используются два значения из личного кабинета продавца:

  • Client-Id — идентификатор кабинета Ozon.
  • Api-Key — ключ доступа, который необходимо создать в личном кабинете.

Client-Id можно скопировать со страницы Seller API. Api-Key отображается после создания ключа, поэтому его необходимо сразу сохранить и перенести в Veloseller.

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

В личном кабинете Ozon перейдите в раздел Настройки → Seller API.

  1. Укажите любое удобное название ключа.
  2. В качестве цели использования выберите «Для внешнего сервиса, приложения».
  3. В поле названия сервиса укажите Veloseller.
  4. Выберите тип токена Admin Read only.
  5. Нажмите «Сгенерировать».
  6. Скопируйте созданный ключ и вставьте его в поле Api-Key в Veloseller.
  7. Скопируйте Client-Id с этой же страницы и укажите его в соответствующем поле Veloseller.
Форма подключения Ozon FBS: шаги получения ключа, поля «Название склада», Client-Id и Api-Key
Форма подключения Ozon FBS: шаги получения ключа, поля «Название склада», Client-Id и Api-Key

Для Veloseller необходимо использовать ключ только для чтения — Admin Read only.

Сервис не вносит изменения в кабинет Ozon. Ключ используется только для получения данных, необходимых для анализа склада. Предоставлять Veloseller права на изменение данных не требуется.

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

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

Какие данные получает Veloseller

Через Seller API сервис получает данные о товарах, их характеристиках и категориях, остатках по складам и ценах.

На основании полученных данных Veloseller ежедневно сохраняет состояние склада. По мере накопления истории сервис рассчитывает скорость продаж, покрытие запасами, периоды отсутствия товара, упущенную выручку и другие показатели.

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

«Api-key is deactivated, use another one or generate a new one».

Ключ деактивирован на стороне Ozon. Например, он мог быть удалён или отключён в личном кабинете. Создайте новый ключ по инструкции выше и замените старый Api-Key в настройках склада Veloseller.

Ошибка при подключении склада.

При добавлении склада Veloseller сразу проверяет указанные данные. Если подключение не выполнено, убедитесь, что Client-Id и Api-Key относятся к одному кабинету Ozon, а для ключа выбран тип Admin Read only.

«Слишком много запросов» (429).

Ozon ограничивает допустимую частоту запросов к API. Такая ошибка не означает, что ключ указан неверно. Veloseller автоматически повторит запрос; дополнительное действие со стороны пользователя не требуется.

Если ранее подключённый склад перестал получать новые данные, воспользуйтесь инструкцией «Склад перестал обновляться».