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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Боль: страшно давать сторонней платформе доступ к своему магазину на маркетплейсе

Естественный вопрос владельца бизнеса перед подключением: что именно платформа сможет сделать с моим магазином, может ли она случайно (или намеренно) поменять цены, списать остатки, испортить карточки? Без понимания механизма API-токена это решение приходится принимать на доверии к обещаниям, а не к проверяемым фактам — а деньги и репутация магазина слишком важны, чтобы полагаться только на обещания.

Как убедиться, что подключение безопасно, прежде чем его сделать

Подробно: как убедиться в безопасности подключения по шагам

Поймите, что вы контролируете доступ, а не платформа. Токен создаёте сами вы (или ваш сотрудник с нужным правом) в личном кабинете WB — платформа получает ровно те данные, для которых вы сами отметили категории доступа при создании токена, ни байтом больше.
Начните с режима «Только на чтение». Это опция самого токена WB, не настройка платформы — с ней токен физически не может ничего изменить в вашем кабинете: ни цены, ни остатки, ни карточки, только читать данные. Для первого знакомства с платформой этого достаточно, доступ на запись можно подключить позже осознанно.
Знайте, что токен можно отозвать в любой момент. Тот же раздел «Доступ к API» в кабинете WB, где вы создали токен, — там же кнопка отзыва: доступ платформы к вашим данным прекращается сразу, без обращения в поддержку и без ожидания.
Понимайте, что токен хранится зашифрованным и используется только для сбора данных именно вашего кабинета — это не общий ключ, который применяется к чужим магазинам или передаётся куда-то ещё.
Знайте, что даже при доступе на запись изменения не происходят автоматически. Любое изменение в маркетплейсе (цена, остаток) проходит через раздел «Согласования» — вы явно подтверждаете каждое предложенное изменение, прежде чем оно применится, вне зависимости от того, что умеет токен технически.
Не забывайте про срок жизни токена — 180 дней. Это ограничение самого WB, не платформы: ближе к истечению создайте новый и замените его на странице «Кабинеты», иначе сбор данных остановится (не изменится что-то в магазине без вашего ведома — именно перестанет обновляться аналитика).

Ценность

Механизм токена даёт проверяемый, а не декларативный контроль: вы сами решаете, что именно платформа видит (категории доступа), можете ли она вообще что-то менять (чтение/запись) и в любой момент можете полностью прекратить доступ одной кнопкой в собственном кабинете WB, без зависимости от платформы. Это принципиально отличается от передачи логина и пароля — токен ограничен именно теми правами, которые вы дали, и его можно отозвать без последствий для остального аккаунта.

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

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

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

Насколько безопасно хранится мой токен? Токен хранится в зашифрованном виде и используется только для сбора данных вашего конкретного кабинета — не общий ключ для всех клиентов платформы.

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

Что произойдёт, если токен истечёт и я не успею его обновить? Данные перестанут обновляться (не более того) — никаких изменений в магазине не произойдёт; создайте новый токен и замените его на странице «Кабинеты», чтобы возобновить сбор.