Подключение Wildberries: токен и категории доступа

Wildberries отдаёт данные по одному токену, но у токена есть категории доступа — набор разделов API, к которым он допущен. Категории задаются в момент создания и потом не меняются. Это главное, что нужно знать заранее: ошибётесь в наборе — придётся создавать токен заново.

Как создать токен

Кабинет WB → Настройки → Доступ к API → «Создать токен».

1. Для интеграции — вручную.
2. Тип токена — Базовый токен.
3. Название — любое.
4. Категории — см. ниже, это самый важный пункт.
5. Уровень доступа — Только чтение.
6. Нажмите «Создать токен» и скопируйте его в Veloseller.

Какие категории отметить

Для своего склада (FBS) — «Контент», «Маркетплейс», «Цены и скидки».

Для склада Wildberries (FBO) — «Контент», «Аналитика», «Цены и скидки».

Дополнительно можно отметить «Тарифы»: из них подставляется комиссия площадки. Без неё расчёт не ломается — комиссия просто останется пустой, и в юнит-экономике её придётся ввести руками.

Зачем каждая:

• Контент — каталог карточек. Без него остатки не к чему привязать: площадка отдаёт числовые идентификаторы, а имя, артикул, бренд и предмет приходят отсюда.
• Маркетплейс — остатки на ваших складах. Только для FBS.
• Аналитика — отчёт по остаткам на складах Wildberries. Только для FBO.
• Цены и скидки — цены по всем товарам. Без них не считаются ни замороженные деньги, ни потерянная выручка: обе величины денежные.

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

Что означают ошибки

401 на карточках товаров. Токен отозван или истёк — площадка не узнаёт его на первом же обращении. Нужен новый токен.

403 на отчёте по остаткам. Это НЕ мёртвый токен, и разница здесь дорогая. Токен рабочий — карточки по нему приходят, — но у него нет нужной категории. Перевыпуск токена БЕЗ этой галочки даст ровно ту же ошибку, и день будет потерян зря. Отметьте недостающую категорию при создании нового токена.

Кабинет различает эти два случая и пишет, какой именно перед вами: подсказка видна на странице «Склады» под названием склада.

«Нет цен у части товаров». Токену не хватает категории «Цены и скидки»: остатки приходят, цены нет, и всё денежное считается по неполным данным. Сервис замечает это сам и говорит прямо, сколько товаров осталось без цены.

Слишком много запросов. Wildberries ограничивает частоту обращений к отчёту по остаткам. Сервис выдерживает паузы сам, вмешательства это не требует.