Как подключить кабинет WB и второй кабинет

Чтобы подключить кабинет, вставьте персональный токен Wildberries в боте (Telegram или MAX) или на сайте. Второй кабинет добавляется так же, отдельным токеном.

Какой токен создать в кабинете WB

Токен создаётся в личном кабинете продавца Wildberries: Профиль - Настройки - «Доступ к API». Создавать токены может только владелец кабинета WB. Если вы сотрудник, попросите владельца создать токен и передать его вам.

При создании укажите:

• Тип токена - «Персональный». Базовый, тестовый (для песочницы) и сервисный токены сервис не принимает.
• Только чтение - включите. Сервис только читает данные и ничего не меняет в кабинете WB.
• Категории доступа - обязательны «Статистика», «Контент» и «Аналитика». Без любой из них токен не примут. Остальные категории лучше отметить сразу, иначе часть отчётов не заработает. Подробности - в статье Какие категории токена WB нужны.

Wildberries показывает токен один раз, поэтому скопируйте его сразу. Токен - длинная строка без пробелов и переносов, она начинается с eyJ. Токен даёт доступ к данным кабинета, поэтому храните его как пароль и никому не показывайте.

В боте

1. Откройте главное меню бота. Если кабинетов ещё нет, нажмите «Подключить кабинет Wildberries». Если кабинет уже есть, нажмите «Подключить ещё кабинет».
2. На экране «Прежде чем начать» нажмите «Понятно, продолжить».
3. Пришлите токен одним сообщением.
4. На экране «Подтверждение токена» проверьте ID кабинета WB, категории, срок действия и тип, затем нажмите «Сохранить токен». Обязательные категории бот проверяет именно после этого нажатия, а не на экране подтверждения.
5. Для нового кабинета бот напишет, что кабинет подключён и загружается история; для уже известного ответ другой.

Токен можно прислать в чат и без первых двух шагов: бот распознает его, покажет экран «Прежде чем начать», а затем тот же предпросмотр.

Если токен принят, бот удалит сообщение с ним (в Telegram и MAX). Если бот токен отклонил или сообщение осталось, удалите его сами.

На сайте

1. Войдите на сайт.
2. Первый кабинет добавляется кнопкой «Подключить кабинет» на главной или «Создать первый» на странице «Мои кабинеты». Когда кабинеты уже есть, выберите «Добавить кабинет» в переключателе вверху или кнопку «+ Добавить кабинет» на «Мои кабинеты».
3. Вставьте токен в поле «Персональный токен Wildberries» и нажмите «Подключить кабинет».

Из токена сервис берёт только номер кабинета, а название запрашивает у WB.

Как добавить второй кабинет

Каждый кабинет WB подключается своим токеном: сервис определяет кабинет по самому токену, поэтому токен первого кабинета для второго не подойдёт. Выпустите токен во втором кабинете WB и пройдите те же шаги, что и для первого, - в боте через «Подключить ещё кабинет», на сайте через «Добавить кабинет».

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

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

Когда появятся данные и отчёты

Данные идут только при действующей подписке. Когда вы подключаете кабинет впервые, ему автоматически включается пробный период на 7 дней, если у кабинета ещё не было ни одной подписки.

• Заказы, продажи, остатки. Расписание создаётся при подключении, первый запуск - в течение минуты. Заказы и продажи за последние 90 дней догружаются постепенно, по одному дню за запуск, поэтому полная глубина появляется не сразу. Остатки обновляются раз в 5 минут. Подробнее - в статье Как часто обновляются данные.
• Финансовые отчёты (прибыль и убытки, недельные сводки) требуют категории «Финансы». Сервис принимает недельный отчёт не раньше чем через 48 часов после конца недели, поэтому первый отчёт появится после того, как закроется неделя (понедельник - воскресенье), в которую вы подключились. Недельные финансовые отчёты, на которых строится «Прибыль и убытки», сервис загружает с недели подключения: более ранние недели для нового кабинета не догружаются, и плашки «Загружаем историю ОПиУ» у него нет. Баланс начинает обновляться после того, как сервис отметит, что догружать историю нечего. Обычно это первые минуты, а если задача не запустилась, проверка повторяется каждые 15 минут.
• Уведомления о заказах за время до подключения не приходят: при первой загрузке данных они не отправляются.

Если через сутки после подключения нет никаких данных, откройте «Здоровье кабинета» и проверьте подписку и токен.

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

• В боте: «Настройки кабинета» - экран «Выберите кабинет» - нужный кабинет. Там же открываются токены, команда и подписка этого кабинета. При одном кабинете «Настройки кабинета» сразу открывают его хаб. При нескольких кабинетах экран «Подписка и оплата» тоже начинается с выбора кабинета.
• На сайте: переключатель кабинетов в верхней панели. Если есть и активные кабинеты, и кабинеты без подписки, последние собраны в отдельной группе «Без подписки». Сам переключатель появляется, когда кабинеты уже есть.

Если токен не принят

Тексты ошибок в боте и на сайте различаются, поэтому здесь они описаны по смыслу.

Если подключить не получается, напишите в поддержку: в боте или через раздел поддержки на сайте.