API-токен Wildberries: как создать и какие права нужны
Обновлено · Команда «В плюсе»
API-токен — это ключ, которым сервис читает статистику вашего кабинета Wildberries: заказы, продажи, отчёты о реализации, удержания, остатки и расходы на рекламу. Создаётся он в самом кабинете Wildberries за минуту.
Как создать токен
- 1
Откройте раздел «Настройки → Доступ к API»
Прямая ссылка: seller.wildberries.ru/api-integrations - 2
Нажмите «Создать новый токен»
Дайте ему понятное имя, например «В плюсе». - 3
Включите режим «Только чтение»
Это важный пункт: такой токен физически не может менять цены, карточки или заказы — только читать данные. - 4
Отметьте категории и скопируйте токен
Нужные категории — в таблице ниже. Wildberries показывает токен один раз: не закрывайте окно, пока не вставите его в «В плюсе».
Какие категории отметить
| Категория | Зачем нужна | Обязательна |
|---|---|---|
| Статистика | Заказы и продажи — в том числе свежие, ещё до недельного отчёта | Да |
| Финансы | Отчёт о реализации: комиссия, фактическая логистика, удержания, выплаты и статус выкупа | Очень желательна |
| Контент | Фотографии и названия товаров в отчётах — чтобы вы узнавали товар не только по артикулу | Да |
| Продвижение | Расходы на внутреннюю рекламу Wildberries: учёт в прибыли, ДРР и отчёт «Реклама» — какая кампания окупается, а какая тратит впустую | Нет |
| Аналитика | Остатки на складах FBO и «заморожено в товаре» — сколько денег лежит в остатках | Да |
| Маркетплейс | Остатки на ваших собственных складах (FBS) — они приходят другим отчётом, чем остатки FBO | Нет |
«Аналитика» обязательна для подключения
Остатки на складах Wildberries и «заморожено в товаре» приходят только из отчёта категории «Аналитика» — это одна из основных функций сервиса, поэтому токен без неё не подойдёт. При подключении сервис покажет, что категория не отмечена, и токен нужно будет перевыпустить. Отмечайте её вместе со «Статистикой» и «Контентом».Отметьте «Финансы» — без неё скоро перестанет приходить отчёт о реализации
Wildberries переводит отчёт о реализации в новый раздел API, и открывает его категория «Финансы». Пока старый отчёт работает, мы берём данные из него, если категории нет, — но Wildberries его отключает. После этого токен без «Финансов» перестанет получать комиссию, фактическую логистику, удержания и выплаты, а прибыль станет неточной. Если ваш токен выпущен без этой категории, перевыпустите его и замените в разделе «Магазины».Возите по FBS — отметьте «Маркетплейс»
Остатки на ваших собственных складах Wildberries отдаёт отдельным отчётом, и открывает его другая категория — «Маркетплейс». Без неё раздел «Остатки» покажет только товар со складов площадки, а «заморожено в товаре» окажется занижено ровно на стоимость вашего склада. Категория необязательная: если вы возите только по FBO, отмечать её незачем. А если возите и категории не окажется, мы скажем об этом прямо на карточке магазина — после первой же синхронизации.Реклама со счёта учитывается только с категорией «Продвижение»
Рекламу Wildberries оплачивают двумя способами. Оплату с баланса WB удерживает прямо в отчёте о реализации, и сервис учитывает её рекламой без всяких категорий. А оплата с рекламного счёта в отчёт не входит — её сервис читает отдельной категорией. Без неё такая реклама в прибыли не учтётся, а вкладка «Реклама» в отчётах останется без кампаний и товаров. Если рекламу вы не ведёте, категорию можно не отмечать.ДРР при этом может и не быть пустым: продвижение на Ozon и Яндекс.Маркете приходит начислениями и в метрику попадает без всяких ключей. Пустой ДРР на смешанном аккаунте — признак того, что не хватает именно этой категории у токена Wildberries.
Без «Статистики» прибыль не посчитается
Именно из этой категории приходят фактическая комиссия и стоимость логистики по каждому заказу. Если категория не отмечена, сервис при подключении покажет, каких прав не хватает, — токен нужно будет перевыпустить.Безопасно ли отдавать токен
- Токен «Только чтение» не позволяет ничего изменить в вашем кабинете: ни цены, ни поставки, ни заказы.
- В нашей базе токен хранится в зашифрованном виде (AES-256-GCM). В открытом виде мы его не храним и нигде не показываем — даже вам после сохранения.
- Отозвать доступ можно в любой момент в том же разделе кабинета Wildberries — сервис сразу перестанет получать данные.
Частые ошибки
- «Токен недействителен» — чаще всего скопирована не вся строка. Токен длинный, скопируйте его целиком, лишние пробелы и переносы сервис уберёт сам.
- «Слишком много запросов» — Wildberries ограничивает частоту обращений. Подождите минуту и повторите: сервис сам повторяет запрос с паузой, которую называет сам маркетплейс.
- «Кабинет уже подключён к другому аккаунту» — один кабинет Wildberries может быть привязан только к одному аккаунту «В плюсе». Если это ваш кабинет и доступ к старому аккаунту утрачен, напишите нам через контакты — поддержка отвяжет его.
- Срок действия токена истёк — Wildberries выдаёт токены с ограниченным сроком. Создайте новый и обновите его в карточке магазина.
Читайте также
Посмотрите на своих цифрах
Прикиньте прибыль по своему товару прямо на калькуляторе — без регистрации и карты.