Перейти к содержимому
Размах

Подключение токена WB

Какие токены нужны (Phase 1.5)

НазначениеТипГде взять
Аналитика продажStatistics APIseller.wildberries.ru → API → Создать ключ
Карточки и остаткиContent APIseller.wildberries.ru → API → Создать ключ

В Phase 2+ потребуются также Advertising, Marketplace, Tariffs — но не сейчас.

Получение ключа

  1. Войдите в кабинет селлера WB: seller.wildberries.ru.

  2. Откройте Профиль → Доступ к API (правый верхний угол → Настройки).

  3. Создайте новый ключ. Параметры:

    • Тип: Statistics
    • Срок действия: 1 год (после — обновим вместе)
    • Без ограничения по IP (Размах ходит через российские прокси с динамическими IP)

  4. Скопируйте полный токен. Это JWT длиной ~300 символов, начинается с eyJ.

  5. Повторите для типа Content — отдельный ключ.

Подключение в Размах

  1. Откройте https://razmakh.ru/settings/marketplaces.

  2. Нажмите “Подключить WB” → выберите тип магазина (FBO / FBS).

  3. Вставьте оба токена (Statistics + Content) в соответствующие поля.

  4. Нажмите “Проверить и сохранить” — Размах сделает тестовый запрос к WB API. Если токен невалидный — увидите сразу, иначе токен зашифруется и попадёт в Infisical.

  5. Через 5-10 минут увидите свои продажи на главной странице.

Проверка сбора

Откройте https://razmakh.ru/settings/marketplaces/wb/<id> — там есть блок “Статус сбора” с last-collected timestamps по каждому коллектору:

  • wb_orders — заказы (last 30 дней) — обновляется каждые 5 минут.
  • wb_sales — фактические продажи — каждые 5 минут.
  • wb_stocks — остатки — каждый час.
  • wb_content — карточки SKU — раз в сутки + при ручном refresh.

Если статус “Ошибка” — там же будет краткое описание (например, 429 Too Many Requests — это нормально, ретраим автоматически через rate limiter F-06).

Что делать при ротации токена

  • WB autoматически продлевает токены, если вы заходите в кабинет.
  • Если токен expired — Размах сообщит на email + в кабинете, попросит обновить.
  • Старый токен инвалидируется через Infisical, новый шифруется и сохраняется — без downtime сбора.

Известные ограничения

  • WB Statistics API имеет rate limit 300 req/min per token. При большом каталоге первый full-history сбор может занять до 30 минут.
  • Возвраты в данных WB запаздывают на 14-30 дней — P&L по периоду меньше месяца всегда чуть оптимистичен.

Дальше