Sign InGet Started
All articles
СтартМенеджер маркетплейсовтокен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 дней: ближе к концу срока создайте новый и обновите его на странице «Кабинеты» (платформа заранее покажет, сколько дней осталось).

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

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

Боль: подключение выглядит технически, а разбираться приходится самому

Задача «подключи кабинет к платформе» обычно падает на менеджера маркетплейсов без пошаговой инструкции от продавца — только адрес личного кабинета и просьба «сделай, чтобы заработало». Дальше начинаются мелкие препятствия: непонятно, какие именно категории доступа отмечать в токене, где найти нужный раздел в интерфейсе WB, и что означает пустой раздел на платформе после подключения — то ли токен неправильный, то ли данные ещё не собрались.

Как выполнить подключение без ошибок

Подробно: подключение кабинета WB по шагам
  1. Убедитесь, что у вас есть право создавать API-токены в кабинете WB. Это может делать владелец кабинета WB или сотрудник с соответствующим правом — если у вас его нет, договоритесь с владельцем кабинета заранее, чтобы не упереться в этот шаг посреди процесса.
  2. Зайдите в seller.wildberries.ru → Профиль → Настройки → Доступ к API и создайте новый токен с понятным именем (например, «NeuroParse») — понятное имя поможет не перепутать токены, если их несколько.
  3. Отметьте категории доступа под задачу, а не «всё подряд не глядя». Если платформе нужна только базовая аналитика заказов и продаж — достаточно категорий «Статистика» и «Аналитика». Для полного набора разделов (включая финансовую сверку и ДРР) отметьте также «Контент», «Цены и скидки», «Маркетплейс» (если торгуете со своего склада FBS), «Финансы» и «Продвижение».
  4. Выберите «Только на чтение», если платформе не нужно менять цены или остатки напрямую. Это безопасный режим по умолчанию — токен физически не сможет ничего изменить в кабинете WB, только читать данные.
  5. Скопируйте токен сразу после создания — WB показывает его только один раз, повторно посмотреть значение нельзя, только создать новый токен взамен.
  6. На платформе откройте «Кабинеты» → «Подключение», выберите Wildberries, вставьте токен. Проверьте предпросмотр перед подключением: платформа сразу покажет тип токена (чтение/запись) и какие категории доступа реально в него включены — сверьте с тем, что вы отмечали в WB.
  7. После подключения дайте платформе время. Первые цифры появляются в течение часа, полная история подтягивается фоном — не спешите считать подключение неудачным, если сразу после «Подключить» разделы ещё пустые.
  8. Если раздел остался пустым дольше часа — вернитесь к списку категорий токена: скорее всего не отмечена нужная (например, «Продвижение» для раздела с рекламой) — создайте новый токен с недостающими категориями, старый можно отозвать.
  9. Отметьте в календаре срок жизни токена — 180 дней. Платформа заранее покажет, сколько дней осталось на странице «Кабинеты», но полезно не полагаться только на это напоминание, если подключений несколько.

Ценность

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

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

«Не удалось проверить ключ» — что не так? Токен скопирован не целиком (проверьте, что скопировали строку до конца) или уже отозван в кабинете WB — создайте новый токен и вставьте заново.

После подключения раздел «Реклама» пустой — почему? У токена не отмечена категория «Продвижение» — создайте новый токен, отметив недостающую категорию, и обновите его на странице «Кабинеты».

Можно ли сразу подключить и чтение, и запись одним токеном? Да, это опции одного токена при создании в WB — но для старта рекомендуется «Только на чтение», а доступ на запись подключать отдельно и осознанно, когда команда готова работать с согласованиями изменений.

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

Как убедиться, что я выбрал категории правильно, ещё до подключения? Посмотрите предпросмотр на экране подключения — он показывает, какие категории реально включены в токен, из его собственного содержимого, до того как вы нажмёте «Подключить».