Как заменить или обновить токен WB?

Создайте в кабинете WB новый персональный токен и замените им старый: в боте через «Токены WB» - «Заменить», на сайте через «Настройки» - «WB API ключи» - «Обновить». Старый токен после замены отключается.

Когда токен нужно менять

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

Как заменить в боте

1. Создайте новый токен в кабинете WB (Профиль - Настройки - «Доступ к API»): тип «Персональный», категории «Статистика», «Контент», «Аналитика» и по возможности остальные. Подробно - в статье Как подключить кабинет WB.
2. В боте откройте «Настройки кабинета». Если кабинетов несколько, выберите нужный. Если подписка истекла, этого пункта в меню нет: откройте кнопку «Токен WB».
3. Откройте «Токены WB».
4. Рядом с токеном нажмите «Заменить», затем «Понятно, продолжить».
5. Пришлите новый токен одним сообщением и нажмите «Заменить токен».

Бот сначала проверяет новый токен: не истёк ли срок, выдана ли ему хоть одна категория доступа и выпущен ли он для этого же кабинета. Какие именно категории выданы, бот не сверяет - проверьте их до отправки по статье Какие категории токена WB нужны. Если новый не принят, старый продолжает работать - пришлите другой.

Бот ответит «Токен заменён» и напомнит про старый токен (см. ниже). Заменить токен может владелец кабинета и менеджер.

Как заменить на сайте

1. Откройте «Настройки» и вкладку «WB API ключи».
2. В карточке токена нажмите «Обновить».
3. В панели «Обновить ключ» вставьте токен в поле «Персональный ключ Wildberries» и нажмите «Обновить».

Сначала сервис проверяет тип, срок и категории нового токена. Если он не подошёл, старый продолжит работать. Если подошёл, появится сообщение «Ключ обновлён», а старый отключится у нас автоматически.

Отключение старого токена касается только сервиса: в личном кабинете Wildberries он остаётся действующим, пока вы не удалите его там (Профиль - Настройки - «Доступ к API»). Если токен утёк или вы его больше не используете, удалите его и в WB.

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

Как понять, что новый токен заработал

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

Сколько ждать данных после того, как обновили ключ (токен)

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

• Заказы и продажи при персональном токене опрашиваются раз в минуту, обычно они появляются в течение нескольких минут.
• Остатки обновляются раз в 5 минут.
• Баланс при персональном токене обновляется раз в час.
• Если перед заменой у кабинета не было рабочего токена, часть данных могла ждать следующей попытки до часа. После неё всё идёт по обычному расписанию.
• Если вы заменили старый базовый токен персональным, сервис сокращает интервалы: заказы опрашиваются раз в минуту вместо одного раза в 3 часа, продажи - вместо одного раза в 2 часа. Финансовую историю он заново загружает в фоне, начиная с недели подключения кабинета: около 2 минут на неделю, поэтому у кабинета с долгой историей это несколько часов. Потом сервис пересчитывает прибыль, это занимает минуты. Ход загрузки виден на плашке «Загружаем историю ОПиУ» на главной и в «Прибыли и убытках».

Данные идут только при действующей подписке. Если через час после замены заказов и остатков всё ещё нет, откройте «Здоровье кабинета» и проверьте токен и подписку. Подробнее о частоте обновления - в статье Как часто обновляются данные.

Что означают уведомления о токене

В уведомлении об отозванном токене есть кнопка «Перевыпустить токен». Если вы сами удалили токен в кабинете WB, пока сервис работал, такое уведомление ожидаемо.