Первые шаги
Как получить токен Wildberries
Получение API token для подключения Wildberries к SKUMETR.
Для подключения нужен отдельный API-токен Wildberries с правами на используемые данные.
#Выберите тип токена
- Сервисный — для конкретного сервиса из Каталога решений WB. Выбирайте SKUMETR, только если он доступен в каталоге; токен другого сервиса не подходит.
- Базовый — для ручного подключения, когда сервисный вариант недоступен. У него могут быть ограничения методов и частоты запросов.
- Персональный предназначен для собственной инфраструктуры продавца и не подходит для облачного SKUMETR.
- Тестовый работает с тестовыми данными.
Правила типов описаны в справке WB о подключении по API.
#Создайте токен
- В нужном профиле WB Partners откройте «Интеграции по API» и создание токена.
- Выберите нужный сервис из каталога либо ручную интеграцию с базовым токеном. Назовите токен «SKUMETR».
- Проверьте категории доступа по таблице ниже.
- Для загрузки данных выберите «Только чтение». Для отправки остатков из SKUMETR нужно «Чтение и запись».
- Создайте и сразу скопируйте токен: повторно посмотреть секрет нельзя.
| Категория | Для чего нужна в SKUMETR |
|---|---|
| Контент | Карточки и штрихкоды товаров |
| Цены и скидки | Цены |
| Аналитика | Остатки каталога |
| Маркетплейс | Склады и остатки продавца; отправка остатков при праве записи |
| Статистика | Загрузка заказов |
| Финансы | Финансовые отчёты и журнал |
Для всех этих разделов нужны все шесть категорий. «Статистика» не заменяет «Аналитику». Выбор категорий не отменяет ограничения типа токена.
#Подключите магазин
- В SKUMETR откройте Wildberries → Настройки, нажмите «+» в заголовке.
- Заполните «Название магазина» и «API-токен». Вставьте токен целиком, без подписи «Authorization:».
- Выберите нужное автообновление и нажмите «Сохранить и проверить».
- Раскройте «Права токена»: здесь показаны тип, категории, режим доступа, срок и предупреждения по сохранённому токену.
- Закройте форму и нажмите «Синхронизация» на карточке магазина. Проверьте результат загрузки товаров, заказов и журнала.
Проверка подключения подтверждает ответ WB на проверочный запрос. Она не загружает товары и остатки и не проверяет все финансовые методы или права записи. Диагностика показывает сведения из сохранённого токена; сообщение «Права на загрузку есть» не гарантирует успешную загрузку каждого раздела.
#Замените токен
Токены WB действуют 180 дней. Выпустите новый заранее; порядок создания и замены есть в инструкции WB.
В SKUMETR нажмите «Изменить» у существующего магазина, вставьте новый токен и выберите «Сохранить и проверить». Пустое поле сохраняет старый токен. После успешной загрузки отзовите прежний токен, если он больше не используется. Подключение и загруженные данные удалять не нужно.
#Если возникла ошибка
- 401: проверьте полноту токена, срок и отзыв.
- 403: проверьте категории, тип токена и соответствие сервису.
- 429: дождитесь снятия ограничения WB; частые повторные проверки не помогут.
- Не хватает данных: сопоставьте отсутствующий раздел с таблицей категорий и проверьте результат его обновления.
Не отправляйте токен в переписке и не вставляйте его в сторонние декодеры. При утечке отзовите токен в WB и создайте новый.
Была ли статья полезна?
Загружаем ваш ответ…