ВойтиНачать
Все статьи
СтарттокенAPIподключениекабинетWBдоступбезопасностьстарт

Как подключить кабинет WB: API-токен по шагам

Платформа получает данные вашего магазина через официальный API Wildberries. Для этого нужен API-токен — ключ, который вы создаёте сами в личном кабинете продавца и вставляете на странице «Кабинеты» (раздел «Подключение»). Занимает 3–5 минут.

Шаг 1. Создайте токен в кабинете WB

  1. Зайдите в личный кабинет продавца WB (seller.wildberries.ru) под профилем владельца кабинета — создавать API-токены может владелец или сотрудник с соответствующим правом.
  2. Откройте Профиль → Настройки → Доступ к API (раздел интеграций).
  3. Нажмите «Создать новый токен» и дайте ему понятное имя, например «NeuroParse».

Шаг 2. Выберите категории доступа

Токену назначаются категории — что именно ему разрешено читать. Для полной аналитики отметьте:

  • Статистика — заказы, продажи, остатки (основа всех отчётов);
  • Аналитика — воронка продаж, отчёты по товарам;
  • Контент — карточки товаров (названия, фото, характеристики);
  • Цены и скидки — текущие цены для юнит-экономики;
  • Маркетплейс — остатки и заказы FBS (если торгуете со своего склада);
  • Финансы — финансовые отчёты для сверки прибыли;
  • Продвижение — рекламные кампании и ДРР.

Чем меньше категорий отмечено, тем меньше разделов платформы сможет наполниться данными.

Шаг 3. Только чтение — безопасный режим

При создании токена есть опция «Только на чтение». С ней токен физически не может ничего изменить в вашем кабинете — только читать данные. Для старта рекомендуем именно её.

  • платформа видит только те данные, которые разрешены категориями токена;
  • токен хранится в зашифрованном виде;
  • токен можно отозвать в любой момент в том же разделе — доступ прекратится сразу;
  • изменения в маркетплейсе (цена/остаток) возможны только с write-токеном и только через заявки, которые вы сами подтверждаете на странице «Согласования».

Шаг 4. Вставьте токен на платформе

  1. Скопируйте токен сразу после создания — WB показывает его только один раз.
  2. На платформе откройте «Кабинеты» (раздел «Подключение»), выберите Wildberries, вставьте токен и нажмите «Подключить». На экране предпросмотра сразу видно тип токена (только чтение/на запись) и какие из категорий доступа реально включены в токен — из его собственного содержимого, ещё до подключения.
  3. Платформа проверит ключ и сразу запустит сбор данных: первые цифры появляются в течение часа, полная история подтягивается фоном.

Срок жизни токена WB — 180 дней: ближе к концу срока создайте новый и обновите его на странице «Кабинеты» (платформа заранее покажет, сколько дней осталось).

Частые проблемы

  • «Не удалось проверить ключ» — токен скопирован не целиком или уже отозван: создайте новый.
  • Пустые разделы после подключения — у токена не отмечена нужная категория: создайте токен с недостающими категориями.
  • Токен истёк — данные перестают обновляться; создайте новый токен и замените его в карточке кабинета.