Главная / Магазин и интеграции

Seller API — основной канал данных Ozon¶

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

Получение ключей занимает 5–10 минут в кабинете Ozon Seller. Этот раздел проведёт через все шаги: где найти Client ID, как создать API Key с правильной ролью и как избежать самой частой ошибки (неправильно выбранная роль ключа, из-за которой данные перестают приходить через несколько недель).

1. Где найти Seller API Client ID¶

Client ID — это ваш постоянный идентификатор в Ozon, не секретный, его можно копировать спокойно.

Войдите в личный кабинет Ozon Seller.
Перейдите: Профиль → Настройки → Seller API.
Найдите строку Ozon ID (это и есть Client ID).
Скопируйте значение и вставьте в поле Seller API Client ID в карточке магазина в STPulse.

2. Как создать Seller API Key¶

Это секретный ключ — что-то вроде пароля для доступа к API. Показывается один раз при создании, потом увидеть его нельзя.

На той же странице Профиль → Настройки → Seller API в Ozon нажмите «Создать ключ».
Укажите любое понятное имя — например, STPulse Seller или STPulse аналитика.
Выберите роль ключа:
✅ Admin read only — это правильный вариант для STPulse
❌ Action read only, Performance, остальные — не подходят
Нажмите «Сгенерировать».
Скопируйте ключ сразу и вставьте в поле Seller API Key в STPulse.

Важно

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

Пример

Анна подключает магазин «Анна Декор» в STPulse:

Зашла в Ozon Seller → Профиль → Настройки → Seller API. Скопировала Ozon ID 12345678.
Нажала «Создать ключ», назвала его STPulse-Анна-Декор, выбрала Admin read only.
Скопировала сгенерированный ключ (длинная строка из 64 символов). Закрыла окно.
В STPulse в карточке магазина вставила: Client ID 12345678 и Key — скопированный.
Нажала «Сохранить». Через 30 минут начали приходить первые данные в отчёты.

3. Почему именно «Admin read only», а не другая роль¶

Это не ограничение STPulse, а требование Ozon API: ряд эндпоинтов (финансовые транзакции, отчёты по продажам, складские остатки) доступны только ключам с ролью admin read only. Если вы выберете другую роль — ключ создастся, импорт может пройти частично, но через неделю-две начнут пропадать данные финансовой части (комиссии, удержания, выкупы Озоном).

«Read only» в названии — это плюс с точки зрения безопасности: ключ может только читать ваши данные, ничего не меняет. Если ключ когда-нибудь утечёт — никто не сможет с его помощью изменить цены, удалить товары или что-то подобное.

4. Проверка подключения¶

После сохранения настроек в STPulse импорт запустится автоматически в течение нескольких минут.

Статус загрузки виден в карточке магазина:

Профиль → Магазины → Название магазина → Импорт данных

Там будет прогресс-бар или зелёная отметка «Импорт завершён». Первичный импорт может занять от 30 минут до нескольких часов в зависимости от объёма истории.

После завершения импорта откройте Дашборд «Пульс» — это главный экран после входа. Если на нём появились цифры — значит, ключи Seller API подключены правильно и данные пошли.

5. Что важно помнить¶

Подсказка

Используйте отдельные ключи для каждого магазина Ozon. Если у вас два магазина и вы попытаетесь использовать один Seller API на оба — данные одного из них в STPulse будут показываться в обоих, что приведёт к каше в отчётах. Создавайте по отдельному ключу на каждый магазин.

Важно

Никогда не передавайте Seller API Key в открытом виде в Telegram, почту или мессенджеры — даже поддержке STPulse. С его помощью можно скачать всю вашу финансовую и продуктовую историю. Если ключ скомпрометирован — удаляйте его в Ozon и создавайте новый.

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

Выбрана роль не «Admin read only» — самая распространённая ошибка. На первый взгляд работает, но через 1–2 недели начинают пропадать финансовые данные. Решение: удалить ключ, создать новый с правильной ролью.
Ключ перепутан с Performance API — Seller API и Performance API — это два разных набора ключей, они не взаимозаменяемы. Seller выглядит как длинная строка, Performance — это пара Client ID + Client Secret.
Ключ удалён в Ozon — если вы по ошибке удалили ключ в Ozon (или сервис автоматически отключил неактивный ключ), данные перестают приходить. Решение: создать новый, обновить в STPulse.
Ключ скопирован не полностью — иногда из-за выделения теряется первый или последний символ. STPulse сообщит «неверные ключи». Решение: повторить копирование внимательно.
Ключ создан в чужом магазине — у Ozon у одного юрлица могут быть разные кабинеты. Убедитесь, что вы создаёте ключ именно для того магазина, который добавляете в STPulse.

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

Сколько ключей Seller API нужно? Один ключ на магазин. Этого достаточно для всех основных отчётов.

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

Можно ли восстановить потерянный ключ? Нет. Ozon показывает ключ только один раз при создании. Если потеряли — создавайте новый.

Что если у меня сменился владелец магазина или юрлицо? Создайте новые ключи Seller API в обновлённом кабинете Ozon, обновите их в карточке магазина STPulse. Старые данные останутся, новые начнут приходить с новых ключей.

Что считается «инвалидным ключом»? Если STPulse вернёт ошибку «ключ недействителен», возможные причины: ключ удалён в Ozon, выбрана неправильная роль, ключ скопирован не полностью, или Ozon отключил ключ за неактивность. Проверьте по этому списку и при необходимости создайте новый.

Подключение Seller API — самый ответственный шаг настройки магазина. От правильности этих ключей зависит, увидите ли вы свои финансы и продажи в STPulse. После подключения переходите к Performance API для рекламной аналитики.