# Подключение кабинета WB: пошаговая инструкция для менеджера маркетплейсов

> Для менеджера маркетплейсов — точная последовательность создания и вставки API-токена WB, какие категории доступа выбрать под конкретные разделы и что делать, если что-то не заработало.

published: 2026-08-05T22:32:00+03:00
updated: 2026-08-05T22:32:00+03:00

Платформа получает данные вашего магазина через официальный 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 дней**: ближе к концу срока создайте новый и обновите его на странице
«Кабинеты» (платформа заранее покажет, сколько дней осталось).

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

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

## Коротко

- Убедитесь, что у вас есть право создавать API-токены в кабинете WB — это может владелец кабинета или сотрудник с соответствующим правом.
- Отметьте категории доступа под задачу, а не «всё подряд не глядя» — для полного набора разделов отметьте «Контент», «Цены и скидки», «Маркетплейс», «Финансы» и «Продвижение».
- Выберите «Только на чтение», если платформе не нужно менять цены или остатки напрямую — безопасный режим по умолчанию.
- Скопируйте токен сразу после создания — WB показывает его только один раз.
- После подключения дайте платформе время: первые цифры появляются в течение часа, полная история подтягивается фоном.

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

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

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

<details>
<summary>Подробно: подключение кабинета WB по шагам</summary>

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

</details>

## Ценность

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

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

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

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

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

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

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