api wildberries • токен wb • безопасное подключение

Как подключить аналитику Wildberries по API

Пошагово разберём, как создать токен WB, выбрать категории данных, безопасно добавить кабинет в bublick и открыть дашборды по продажам, финансам, рекламе, товарам и поставкам.

API-ключ Wildberries нужен не ради технической настройки: он заменяет ручные выгрузки и связывает фактические данные магазина с рабочей аналитикой. Вы контролируете доступ, а bublick собирает показатели в понятную систему для решений.

Если сумма продаж кабинета WB за последние 4 финансовых отчёта не превышает 200 000 ₽, bublick может быть бесплатным. Подключите кабинет по API и начните с реальных данных: продаж, финансов, рекламы и остатков.
Подключение через токен Токен — цифровой ключ, с помощью которого внешний сервис получает доступ к данным магазина WB.
Доступы выбираются Категории данных задают, к какой информации сможет обращаться подключённая система.
Токен можно отозвать Если доступ больше не нужен, токен можно удалить в кабинете WB Partners.
После подключения — дашборды bublick проверяет кабинет и начинает собирать данные для аналитики продаж, финансов, рекламы и остатков.
что такое api-подключение

API — это мост между вашим кабинетом Wildberries и сервисом аналитики

Личный кабинет WB удобен для операционной работы, но профессиональная внутренняя аналитика требует связать разные данные: заказы, продажи, финансовые отчёты, рекламу, остатки, карточки и поставки. API-подключение позволяет bublick получать эти данные системно и собирать их в BI-дашборды.

без ручных выгрузок
шаг 1 Данные появляются в WB Покупатели делают заказы, реклама тратит бюджет, финансовые отчёты фиксируют расходы, остатки меняются по складам.
шаг 2 Токен даёт доступ Вы создаёте API-токен и разрешаете получать только те категории данных, которые нужны для аналитики.
шаг 3 bublick проверяет кабинет Сервис валидирует токен, определяет продавца, проверяет доступы и готовит кабинет к загрузке данных.
шаг 4 Данные собираются в систему Информация приводится к рабочему виду: периоды, SKU, кабинеты, рекламные кампании, склады и отчёты связываются между собой.
итог Вы видите аналитику В личном кабинете bublick открываются дашборды, отчёты и инструменты для управленческих решений.
категории данных

Какие доступы нужны для полноценной внутренней аналитики WB

Для качественной аналитики недостаточно одного отчёта. Чтобы увидеть реальную картину бизнеса на Wildberries, важно связать продажи, финансовые расходы, рекламу, остатки и поставки. Поэтому при создании токена нужно внимательно выбрать категории данных, которые соответствуют задачам аналитики.

только нужные данные
Конструктор доступов WB API Включайте категории и смотрите, какие разделы аналитики смогут получить данные.
01 / ИСТОЧНИКИ

Категории данных

7 из 7
02 / РЕЗУЛЬТАТ

Что откроется в аналитике

100%готовность
ОткрытоПродажи и РНПЗаказы, продажи, возвраты, динамика и аномалии по SKU.
ОткрытоФинансы и юнит-экономикаНачисления, логистика, удержания, прибыль и маржинальность.
ОткрытоРеклама и ДРРРасходы, кампании, CPO и связь продвижения с продажами.
ОткрытоОстатки и поставкиОборачиваемость, склады, дефицит и расчёт пополнения.
ОткрытоДетализация товаровКарточки, артикулы, размеры, показатели и товарные группы.
Набор подходит для полной внутренней аналитикиВсе показанные разделы смогут получать нужные данные.
Важно: конструктор объясняет связь категорий с возможностями сервиса, но не заменяет экран подключения. Точный набор и тип токена выбирайте по актуальной инструкции внутри bublick: Wildberries может менять состав методов и правила авторизации.
пошаговая инструкция

Как подключить кабинет WB к bublick по API-токену

Ниже — практичный сценарий подключения. Он специально написан для селлера, а не для разработчика: что открыть, что выбрать, что сохранить и что сделать после добавления токена в сервис аналитики.

от токена до дашборда

Откройте раздел API в кабинете WB Partners

Зайдите в профиль продавца Wildberries и откройте «Интеграции по API» → «Создать токен». По действующим правилам создавать и удалять токены может владелец личного кабинета.

Лучше заранее решить, что токен создаётся именно для bublick, а не использовать общий ключ от другой интеграции.

Выберите правильный тип подключения и создайте отдельный токен

Ориентируйтесь на вариант, который указан в актуальном экране добавления кабинета bublick. Сервисный токен WB применяется для облачного сервиса из Каталога, Базовый — для других сторонних интеграций; Персональный предназначен для собственных программ и локальных on-premise решений.

Если название вводится вручную, используйте понятный вариант вроде «bublick аналитика». Так проще обновлять и отзывать именно этот доступ.

Выберите нужные категории данных

Для полноценной аналитики используются официальные категории WB API: Статистика, Аналитика, Финансы, Продвижение, Контент, Маркетплейс и Поставки. Конкретный набор зависит от подключённых модулей и указан в интерфейсе bublick.

Если часть категорий не выбрать, некоторые разделы дашборда могут быть пустыми или неполными.

Скопируйте токен сразу после создания

Токен показывается в кабинете WB только один раз. Сразу скопируйте его и добавьте в личный кабинет bublick. Ручной токен действует 180 дней, после чего его нужно перевыпустить и заменить в интеграции.

Не отправляйте токен в открытые чаты, публичные таблицы и документы. Если ключ потерян, создайте новый.

Добавьте токен в bublick

В личном кабинете bublick откройте раздел подключения кабинетов WB, вставьте API-токен и запустите проверку. Сервис определит кабинет и подскажет, если доступы настроены некорректно.

После успешной проверки кабинет можно активировать для загрузки данных и построения аналитики.

Дождитесь первичной загрузки данных

После активации bublick начинает собирать данные по кабинетам, товарам, продажам, рекламе, остаткам, финансовым отчётам и другим разделам. Время загрузки зависит от объёма данных и доступности API WB.

Когда первичная загрузка завершится, дашборды начнут показывать рабочую картину бизнеса.
Актуализация WB APIWildberries разделяет Сервисные, Базовые, Персональные и Тестовые токены. Если в bublick появится подключение через OAuth 2.0, токен вручную копировать не потребуется — продавец подтвердит доступ в WB Partners.
Официальная справка WB API
безопасность api-ключа wb

Токен WB API — это доступ к данным магазина. С ним нужно работать аккуратно

API-токен не нужно бояться, но его нельзя воспринимать как обычный текст. Правильная практика — отдельный токен под каждую интеграцию, понятные категории данных, контроль срока действия и возможность быстро отозвать доступ.

контроль доступа

Безопасное подключение начинается не с сервиса, а с дисциплины работы с токеном

Если у вас несколько интеграций, не используйте один общий токен для всех. Создайте отдельный доступ для bublick, чтобы в любой момент понимать, какие данные использует сервис аналитики и как быстро отключить подключение при необходимости.

Добавить кабинет безопасно
  • Создавайте отдельный API-токен под bublick, а не переиспользуйте ключ от другой системы.
  • Выбирайте только те категории данных, которые нужны для аналитики и подключённых модулей.
  • Категории готового токена изменить нельзя: если доступов не хватило, создайте новый токен с корректным набором.
  • Не передавайте Персональный токен облачному сервису: этот тип предназначен для собственных программ и on-premise решений продавца.
  • Не публикуйте токен в чатах, скриншотах, Google Sheets, открытых документах и коде сайта.
  • Не вставляйте рабочий токен в случайные онлайн-декодеры и сторонние формы проверки.
  • Следите за сроком действия токена и заранее обновляйте его, чтобы дашборды не перестали получать данные.
  • Если сотрудник или подрядчик больше не должен иметь доступ к интеграции, проверьте токены и отзовите лишние.
  • Если есть подозрение, что токен мог попасть не туда, удалите его в WB Partners и создайте новый.
что вы получаете после подключения

API-токен нужен не ради подключения. Он нужен, чтобы ваши данные стали рабочей аналитикой

После добавления кабинета bublick превращает данные Wildberries в понятные разделы: продажи, финансы, остатки, реклама, оборачиваемость, РНП, поставки и контроль эффективности товаров.

от доступа к решениям
РНП по показателям Wildberries после подключения кабинета по API
РНП по показателямОбщая динамика заказов, продаж и связанных метрик по подключённому кабинету.
Расширенная аналитика финансовых отчётов Wildberries
Финансовые отчётыРасходы WB, логистика, хранение, удержания, прибыль и маржинальность.
География заказов и продаж Wildberries в bublick
География заказов и продажРегионы, склады, локализация спроса и детализированные показатели по направлениям.
Детализация показателей заказов и продаж по товарам Wildberries
Детализация товаровЗаказы, продажи и производные метрики по SKU за любой период и в нужном разрезе.
частые проблемы подключения

Почему токен может не подключиться с первого раза

Большинство проблем решается быстро: токен скопирован не полностью, не выбрана нужная категория данных, срок действия истёк или WB API временно отвечает с задержкой. Важно не паниковать, а понять причину.

диагностика без паники
ошибка токенаКлюч вставлен не полностьюПроверьте, что токен скопирован целиком, без пробелов в начале/конце и без лишних символов.
нет данныхНе выбраны нужные категорииЕсли нет доступа к рекламе, финансам или остаткам, соответствующие разделы аналитики не смогут заполниться.
истёк доступТокен нужно обновитьПри окончании срока действия токена сервис не сможет получать новые данные, пока вы не создадите или не обновите доступ.
доступ отозванТокен удалили в WB PartnersЕсли токен удалён или заменён, старое подключение перестанет работать. Добавьте актуальный токен в bublick.
кабинет не тотТокен создан не в нужном магазинеПроверьте, что вы создаёте токен именно в том кабинете WB, который хотите подключить к аналитике.
тип доступаДля интеграции выбран неподходящий токенПерсональный, Сервисный, Базовый и Тестовый токены предназначены для разных сценариев. Используйте вариант, который указан в bublick.
ошибка 401Категория токена не совпадает с методом APIWB может отклонить запрос, если в токене нет категории, к которой относится вызываемый метод.
ошибка 429Сработал лимит запросов WB APIЭто не означает потерю данных: сервис должен выдержать паузу и повторить загрузку в рамках лимитов конкретного метода.
временная задержкаОтвет WB API занимает больше времениИногда проверка или загрузка данных может идти дольше обычного из-за задержки ответа внешнего API. В таком случае помогает повторная проверка позже.
faq

Частые вопросы про подключение аналитики Wildberries по API

Ответы на вопросы, которые обычно возникают перед добавлением API-токена WB в сервис аналитики.

коротко и по делу
Да, если кабинет WB подходит под условие бесплатного использования: сумма продаж за последние 4 финансовых отчёта не превышает 200 000 ₽. В этом случае можно подключить кабинет по API и начать смотреть продажи, финансы, рекламу и остатки в bublick без платы за сервис.
API-токен Wildberries — это цифровой ключ, который позволяет внешнему сервису получать доступ к данным вашего магазина WB в рамках выбранных категорий данных. Для bublick он нужен, чтобы строить аналитику продаж, финансов, рекламы, остатков и поставок.
Используйте тип, который указан в актуальном экране подключения bublick. Сервисный токен предназначен для облачного сервиса из Каталога, Базовый токен — для остальных сторонних интеграций, Персональный — для собственных и on-premise решений, Тестовый — для песочницы.
Ручной токен WB API действует 180 дней, затем его нужно перевыпустить и заменить в интеграции. При подключении через OAuth 2.0 обновление происходит автоматически, но этот вариант доступен только если его поддерживает подключаемый сервис.
Да, если работать с токеном правильно: создать отдельный ключ для bublick, выбрать нужные категории данных, не публиковать токен в открытых местах и при необходимости отозвать доступ в WB Partners.
Для полной внутренней аналитики могут использоваться категории Статистика, Аналитика, Финансы, Продвижение, Контент, Маркетплейс и Поставки. Точный набор зависит от модулей bublick и указан в интерфейсе подключения. Если часть доступов не выбрать, некоторые разделы дашборда могут быть неполными.
Так проще контролировать интеграции. Вы сразу понимаете, какой токен относится к bublick, можете отдельно обновить его, удалить или заменить, не ломая другие сервисы и внутренние процессы.
Сервис проверит токен, определит кабинет WB, проверит доступы и после активации начнёт загружать данные для аналитики. После первичной загрузки вы сможете смотреть дашборды и рабочие разделы сервиса.
Создайте или обновите токен в WB Partners, затем замените его в личном кабинете bublick. Если токен удалён, истёк или создан без нужных категорий данных, сервис не сможет получать актуальные данные.
Да. Для каждого кабинета WB нужен корректный API-токен. После подключения bublick сможет показывать аналитику по нескольким кабинетам в рамках выбранного тарифа и настроек сервиса.
подключите кабинет wb

Добавьте API-токен Wildberries в bublick и откройте аналитику по своим данным

Зарегистрируйтесь, подключите кабинет WB по API и откройте BI-дашборды: продажи, финансы, реклама, остатки, оборачиваемость, поставки и ключевые показатели будут собраны в одном сервисе. Если кабинет подходит под условие до 200 000 ₽ за последние 4 финансовых отчёта, bublick может быть бесплатным.