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