Подключение занимает 3–5 минут на каждый маркетплейс. Ниже — пошаговая инструкция, нужные роли ключа и список endpoints, которые VelesRadar использует.

Ozon — получение Client ID и API-ключа

Зайдите в кабинет продавца Ozon → «Настройки → Seller API».
Нажмите «Сгенерировать ключ». Откроется окно выбора ролей — отметьте «Продавец», «Контент-менеджер», «Аналитик». Этого набора достаточно для всей аналитики; admin-роль давать не нужно.
Скопируйте Client-Id и Api-Key — ключ показывается один раз. Если потеряли, придётся создать новый.
В VelesRadar откройте «Магазины → Добавить магазин → Ozon», вставьте Client ID и Api-Key, нажмите «Проверить». Если связка валидна — магазин появится в списке, начнётся первичная синхронизация.
Реклама Performance. Для подсчёта ДРР, CTR и CPO по кампаниям ОЗК/ОЗЗ нужна вторая связка — Performance API. В кабинете Performance.Ozon перейдите в «Настройки → API → Создать клиент», получите Client ID и Client Secret и вставьте их в магазине Ozon в VelesRadar, поле «Performance».

Wildberries — получение JWT-токена

Войдите в кабинет продавца Wildberries → «Настройки → Доступ к API».
Нажмите «Создать новый токен».
Отметьте категории доступа:
- Контент (только чтение);
- Статистика;
- Аналитика;
- Продвижение.
Если в форме нет отдельной галочки «Только на чтение» — ничего страшного: VelesRadar не делает write-запросов независимо от прав токена.
Срок жизни — 180 дней, изменить нельзя. Скопируйте токен (показывается один раз) и вставьте в VelesRadar: «Магазины → Добавить магазин → Wildberries → Токен».
Нажмите «Проверить». Если токен валиден, запустится первичная загрузка отчётов о продажах и остатках.

Что делать, если токен истёк

JWT-токены Wildberries живут 180 дней и продлить их нельзя — нужно выпустить новый. VelesRadar следит за сроком и присылает уведомление за неделю до истечения: на email владельца аккаунта и в Telegram-бот, если он подключён. Получив уведомление, повторите процедуру выпуска и обновите токен в «Магазины → ваш WB-магазин → Обновить токен».

У ключей Ozon Seller API срока истечения нет — они работают, пока вы их не удалите вручную или не отзовёте через кабинет.

Какие данные мы тянем

Полный список endpoints, к которым обращается VelesRadar — для прозрачности. Все запросы — только на чтение.

Ozon Seller API:

заказы FBO/FBS и их статусы — для выручки и заказов по дням;
финансовые отчёты — комиссии маркетплейса, удержания, логистика, эквайринг (это основа подсчёта чистой прибыли);
остатки на складах Ozon — для контроля out-of-stock;
карточки товаров — атрибуты, бренд, цена (только чтение, для сопоставления с себестоимостью);
аналитика воронки — показы, клики, добавления в корзину, конверсия в заказ.

Ozon Performance API:

список кампаний и их статусы — ОЗК (трафареты, оплата за клик) и ОЗЗ (поиск, оплата за заказ);
ежедневная статистика расходов, показов, кликов, заказов — для расчёта ДРР и CPO.

Wildberries:

отчёт о продажах и реализациях (Statistics) — для выручки, возвратов и комиссий;
остатки на складах WB — для контроля запасов;
карточки и цены (Content, только чтение) — для сопоставления SKU с себестоимостью;
рекламные кампании и расходы (Promotion) — для расчёта ДРР по WB.

Конкуренты — это отдельный поток данных: цены, рейтинг, отзывы и остатки тянутся из публичных карточек товаров Ozon и Wildberries. API-ключ для этого не нужен — мы парсим только то, что видит любой покупатель.

Частые ошибки подключения

401 Unauthorized. Чаще всего — у ключа Ozon не хватает ролей. Удалите ключ, создайте новый с ролями «Продавец», «Контент-менеджер», «Аналитик» и подставьте заново. На Wildberries 401 означает, что токен отозван или истёк.
429 Too Many Requests. Wildberries жёстко лимитирует некоторые endpoints — около 1 запроса в минуту. Это нормальное поведение API, VelesRadar сам подстраивается под лимит и повторяет запрос позже. Никаких действий с вашей стороны не нужно.
Пустой ответ или нули в дашборде. Возможно, в выбранном окне просто не было продаж, либо первичная синхронизация ещё идёт (она занимает 5–30 минут в зависимости от объёма истории).
Истёк WB-токен. Через 180 дней токен автоматически отзывается на стороне Wildberries. Выпустите новый и обновите в кабинете VelesRadar.

Часто задаваемые вопросы

Можно ли подключить несколько магазинов?

Да. Количество магазинов зависит от тарифа — лимиты описаны на странице тарифов. Каждый магазин — это отдельная пара API-ключей.

Сервис будет менять мои цены и остатки?

Нет. VelesRadar — аналитический сервис и принципиально не делает write-запросов к API. Подробнее, какие операции мы НЕ используем, описано на странице «Безопасность».

Сколько времени занимает первичная синхронизация?

Обычно от 5 до 30 минут в зависимости от объёма истории заказов и числа SKU. Дашборд начинает показывать данные постепенно — по мере прихода ответов от API маркетплейса.

Что будет, если я отзову ключ в кабинете маркетплейса?

VelesRadar моментально потеряет доступ — следующий запрос вернёт 401, и в кабинете магазин будет помечен как «требует обновления ключа». Уже загруженные данные останутся, новые перестанут приходить.

Связанное

Безопасность данных и API-ключей — как мы шифруем и храним ключи.
Тарифы — лимиты на количество магазинов и SKU.
Юнит-экономика на Wildberries и Ozon — зачем нужны финансовые отчёты из API.
Калькулятор юнит-экономики — посчитать маржу без подключения, в браузере.

Подключение Ozon и Wildberries по API