Токен Wildberries: как получить и какие галочки ставить
Токен — это ключ, по которому WMSdb получает из вашего кабинета Wildberries карточки товаров и заказы ФБС и передаёт обратно остатки и сборку. Создаёт его владелец кабинета продавца за 2 минуты. Токен живёт 180 дней, потом его нужно создать заново.
1. Откройте раздел «Интеграции по API»
- Войдите в кабинет продавца и откройте seller.wildberries.ru/api-integrations.
- Нажмите «Создать токен». Рядом видно, сколько токенов уже занято: всего их можно держать 20, лишние придётся удалить.
2. Вкладка «Для интеграции вручную»
Вкладка «Для сервиса из каталога» — для сервисов, которые Wildberries включил в свой каталог. WMSdb подключается вручную.
3. Вид токена — «Базовый»
Wildberries сам подписывает виды токена, и выбор следует из этих подписей:
- Базовый — «для сторонних решений». WMSdb для вашего кабинета — стороннее решение: программа работает на наших серверах, а не на ваших. Это наш вариант.
- Персональный — «только для своих решений». Для программ, которые продавец держит у себя сам. Wildberries прямо пишет: «Токен нельзя использовать со сторонними сервисами» — и просит подтвердить, что вы не передадите его третьим лицам. Передать такой токен нам — нарушить правила площадки.
- Тестовый — «только для разработчика». Работает с учебной площадкой, настоящих товаров и заказов там нет.
Разница в скорости: по базовому токену площадка принимает 150 обращений в минуту, по персональному — 300. Нам 150 хватает с запасом.
4. Название и галочки
- Название — любое, чтобы потом узнать токен в списке, например WMSdb.
- Поставьте две галочки: Контент и Маркетплейс. Остальные не ставьте.
Почему только две. Каждая галочка открывает свой раздел API Wildberries. Чем меньше галочек, тем меньше сможет тот, к кому токен попадёт по ошибке, — об этом просит и сама площадка. WMSdb сейчас обращается только к двум разделам:
| Галочка | Что открывает (по описанию API Wildberries) | Нужна WMSdb? |
|---|---|---|
| Контент | Карточки товаров, их создание и правка, характеристики, медиафайлы, ярлыки | Да — товары, размеры, штрихкоды, фото |
| Маркетплейс | Склады продавца, остатки на них, заказы FBS, DBW, DBS и «Самовывоз» | Да — заказы ФБС, поставки, передача остатков |
| Статистика | Основные отчёты: продажи, заказы, остатки на складах WB, отчёт о реализации | Нет |
| Финансы | Баланс, финансовые отчёты | Нет |
| Аналитика | Аналитика и отчёты: остатки на складах, платная приёмка и хранение, продажи по регионам, маркировка | Нет |
| Продвижение | Рекламные кампании, ставки, расходы на рекламу | Нет |
| Вопросы и отзывы | Вопросы и отзывы покупателей, ответы на них | Нет |
| Цены и скидки | Цены, скидки, календарь акций | Нет |
| Чат с покупателем | Переписка с покупателями | Нет |
| Поставки | Поставки FBW — на склады Wildberries (не ФБС) | Нет |
| Возвраты | Заявки покупателей на возврат | Нет |
| Документы | Документы кабинета: акты, отчёты | Нет |
| Пользователи | Сотрудники кабинета и их доступы; у базового токена недоступна | Нет |
Когда в WMSdb появятся разделы, которым нужны другие галочки, мы предупредим заранее — токен тогда создаётся заново.
5. Уровень доступа — «Чтение и запись»
Пролистайте окно вниз. Нужен уровень «Чтение и запись»: с «Только чтение» мы увидим заказы, но не сможем передать на Wildberries ни остатки, ни сборку. Комментарий можно не заполнять.
6. Создайте и скопируйте токен
- Нажмите «Создать токен».
- Wildberries покажет токен один раз. Нажмите «Скопировать и закрыть» — токен окажется в буфере обмена. Посмотреть его потом нельзя: если потеряли, создайте новый.
7. Вставьте токен в WMSdb
В кабинете WMSdb: Настройки → Компании → Новая компания. Вставьте токен и нажмите «Проверить» — мы спросим у Wildberries, чей это кабинет, и покажем название, ИНН и все галочки токена. Если нужной галочки нет, это будет видно сразу.
