Как получить ключ API Wildberries
Пошагово: где в кабинете WB создать токен, какие категории отметить и почему нужен уровень «Чтение и запись».
Чтобы UnitPlace видел ваши товары, заказы, остатки и деньги на Wildberries, нужен один ключ — токен API. Создаётся он в вашем кабинете продавца за пару минут и вводится у нас один раз.
Шаг 1. Откройте раздел с ключами
Зайдите в кабинет продавца seller.wildberries.ru под аккаунтом с правами администратора — обычным сотрудникам Wildberries создавать токены не даёт.
Нажмите на профиль в правом верхнем углу и выберите «Настройки» → «Доступ к API».
Шаг 2. Создайте новый токен
Нажмите «Создать новый токен». Появится форма из трёх частей: имя, категории доступа и уровень доступа.
Имя
Любое понятное вам — например, UnitPlace. Оно нужно только чтобы вы потом отличали этот токен от других.
Категории — отметьте все девять
Это самый важный шаг. Wildberries раздаёт доступ по разделам, и если какой-то не отметить, соответствующая часть UnitPlace просто не заработает — вы увидите пустые таблицы вместо данных. Отметьте:
- Контент — карточки товаров, фото, штрихкоды.
- Маркетплейс — заказы FBS, сборка, этикетки, поставки, остатки.
- Статистика — продажи и остатки на складах WB.
- Цены и скидки — текущие цены и скидки.
- Вопросы и отзывы — отзывы покупателей и ответы на них.
- Продвижение — расходы на рекламу и календарь акций (без него реклама WB в аналитике будет нулевой).
- Финансы — отчёт о реализации: комиссия, логистика, хранение.
- Поставки — поставки на склады Wildberries.
- Аналитика — остатки в разбивке по складам WB.
Уровень доступа — «Чтение и запись»
Wildberries спросит, что можно делать токеном: только читать или ещё и менять. Нужен вариант «Чтение и запись» (то есть галочку «Только на чтение» ставить не надо).
Почему: UnitPlace не только показывает данные, но и работает за вас — собирает заказы, печатает этикетки, отправляет коды маркировки и сроки годности, публикует ответы на отзывы и вопросы. С токеном «только чтение» всё это откажет.
Шаг 3. Скопируйте токен
После создания Wildberries один раз покажет длинную строку — это и есть ключ. Скопируйте её сразу: повторно посмотреть токен нельзя, при потере придётся создавать новый.
Шаг 4. Вставьте ключ в UnitPlace
- Откройте Настройки → Магазины и ключи и в карточке магазина нажмите «+ Wildberries» (если откроется выбор площадки — выберите Wildberries).
- Вставьте токен в поле «Ключ API».
- Придумайте название интеграции — по нему вы будете отличать её от других.
- Нажмите «Подключить».
Мы сразу проверим ключ и покажем «Подключено, соединение работает». Если ключ не прошёл проверку, он не сохранится. Увидите «Ключ недействителен или отозван» — скорее всего, токен скопирован не целиком или отмечены не все категории.
Что произойдёт дальше
Начнётся первая загрузка: подтянутся товары, заказы и остатки. Каталог обычно появляется за несколько минут. Деньги и реклама приходят позже — Wildberries отдаёт их отдельными отчётами.
Что важно знать заранее
Токен живёт 180 дней
Через полгода Wildberries его аннулирует, и данные перестанут обновляться. Это не поломка сервиса: в Настройках → Магазины и ключи появится блок «Нужно ваше действие». Создайте новый токен и нажмите «Заменить ключ». Ничего не потеряется.
Склады WB, финансы и реклама обновляются с задержкой
Wildberries ограничивает частоту таких запросов для токенов внешних сервисов. Поэтому остатки и заказы со складов WB обновляются примерно раз в 3 часа, отчёт о реализации — пару раз в сутки, реклама — раз в сутки. Обойти эти ограничения нельзя. Ваши собственные заказы FBS и остатки обновляются быстро — на них ограничение не распространяется.
Один кабинет Wildberries — один магазин
В один магазин UnitPlace можно подключить только один кабинет Wildberries. Если кабинетов два (например, на два ИП), заведите для второго отдельный магазин.
Ключ хранится в зашифрованном виде
Мы шифруем токен и используем его только для получения ваших данных. Приостановить или удалить подключение можно в любой момент: Настройки → Магазины и ключи → «⋯» в строке Wildberries.