# Wildberries API

Разбирайте продажи и остатки Wildberries прямо в чате

Управление товарами, заказами и аналитикой на маркетплейсе Wildberries

## Как агент работает с Wildberries API

Агент подключается к Wildberries одним API-токеном и закрывает весь контур продавца: остатки FBS и FBW, реализацию, юнит-экономику, рекламу, отзывы, вопросы, чаты, цены и отгрузки. По остаткам он собирает сводку по всем складам продавца и FBW-остатки по артикулам одним вызовом, а не циклом по складам, и на этой основе строит план пополнения с учётом скорости продаж и страхового запаса. Разделы у WB разнесены по разным API — контент, статистика, аналитика, цены, отзывы, — и агент сам решает, куда идти за ответом, вместо того чтобы держать это в голове у вас.

Деньги агент считает по отчёту реализации v5 — с правильной курсорной пагинацией: WB кладёт в ответ поле, похожее на курсор, но настоящий курсор — идентификатор последней строки, и агент это знает, поэтому не зацикливается и не теряет строки. Отчёт отдаётся не чаще раза в минуту, так что длинные периоды агент собирает частями и сам держит паузы, а не упирается в 429. Комиссию, логистику и хранение он берёт из того же отчёта, а не из прайса, поэтому маржа по SKU считается по фактически удержанным суммам.

Юнит-экономика по каждому артикулу собирается с реальным рекламным расходом. У WB реклама живёт в двух независимых контурах — стандартные кампании в advert-api и медийная реклама в advert-media-api, — и агент опрашивает оба, иначе половина расходов просто пропала бы из отчёта. Поверх считается ДРР по SKU с уровнями тревоги и помесячный P&L по кабинету.

Отзывы, вопросы и чаты покупателей агент собирает в единую ленту неотвеченного: отвечает на отзыв и на вопрос, закрепляет лучший отзыв на карточке и считает скорость вашей реакции. Раздел отзывов у WB ограничен одним запросом в секунду, поэтому длинную ленту агент разбирает порциями; о новом отзыве или вопросе он узнаёт по вебхуку, а не опросом по кругу. Ленту неотвеченного можно поставить на расписание, чтобы сводка приходила сама.

Самое ценное — агент знает характер WB API. WB может ответить «успешно» на запрос с опечаткой и молча ничего не сделать, поэтому после каждой записи агент перечитывает состояние и убеждается, что изменение применилось. Обновление карточки — полная перезапись, и частичную агент не отправляет; загрузка медиа падает целиком из-за одного битого URL, поэтому ссылки проверяются заранее. Пока асинхронная загрузка карточек не завершилась (до 30 минут), агент не трогает цены и остатки — иначе изменения применятся частично. Жёсткие лимиты вроде пропуска FBS раз в 10 минут и смены привязки склада раз в сутки он учитывает при планировании. И всё, что меняет данные — цены, ставки, ответы, — сначала показывается как план и применяется только после вашего явного подтверждения.

## Сценарии интеграции

### Найти, где просела выручка на WB
Агент сравнит продажи по неделям, разложит падение по категориям и SKU и отделит сезонность от проблем с карточкой или остатками.

### Разбор возвратов по причинам
Агент соберёт возвраты за период, сгруппирует по причинам и артикулам и покажет, какие карточки генерируют убыток.

### Мониторинг отзывов и рейтинга
Агент проверит новые отзывы, подготовит ответы и предупредит, если рейтинг карточки пошёл вниз.

### Юнит-экономика по артикулам
Агент сведёт продажи, комиссии, логистику и хранение WB в одну таблицу и посчитает реальную маржу по каждому SKU.

### План пополнения складов
Агент соберёт остатки FBS и FBW по всем складам, сопоставит их со скоростью продаж и покажет, что и в каком объёме пора отгружать, чтобы не уйти в ноль.

### Куда уходит рекламный бюджет
Агент сложит расходы стандартных и медийных кампаний, посчитает ДРР по каждому артикулу и отметит, где реклама съедает маржу сильнее нормы.

## Как подключить

**Перед подключением**

- Активный кабинет продавца на seller.wildberries.ru.
- Решение, что делает агент: только аналитика или ещё отзывы и цены.
- Токен хранится зашифрованным и отзывается в кабинете WB в любой момент.

### Войдите в WB Partners владельцем кабинета
Откройте seller.wildberries.ru и войдите под учётной записью владельца кабинета: выпускать и удалять API-токены может только он, другим ролям раздел не виден.

### Откройте «Настройки → Доступ к API»
Наведите курсор на имя продавца в правом верхнем углу и перейдите «Настройки → Доступ к API» → «Создать новый токен».

### Создайте токен типа «Сервисный»
Задайте имя токена, выберите тип «Сервисный» и найдите наш сервис в каталоге решений — категории подставятся сами.

### Если выбран «Базовый» — отметьте категории
У типа «Базовый» категории отмечаются руками: «Контент», «Статистика», «Аналитика», «Цены и скидки», «Вопросы и отзывы».

### Скопируйте токен сразу после создания
Токен показывается один раз — закрыли окно, останется выпустить заново. Строка с началом eyJ живёт 180 дней.

## Частые вопросы

### Какой токен нужен для подключения Wildberries?
API-токен из личного кабинета продавца: «Настройки → Доступ к API», выпускает владелец кабинета. Для аналитики достаточно прав на чтение категорий «Статистика», «Аналитика» и «Контент». Тип токена выбирайте «Сервисный» и найдите наш сервис в каталоге решений — категории подставятся сами: у типа «Базовый» WB с 30.03.2026 занизил лимиты запросов, и длинные отчёты собираются неделями.

### Токен даёт доступ ко всему кабинету?
Нет. WB выпускает токены с гранулярными правами по категориям — вы сами выбираете, какие разделы открыть. Токен хранится в зашифрованном виде и отзывается в кабинете WB в любой момент.

### Какие задачи агент делает по Wildberries чаще всего?
Анализ продаж и остатков, разбор возвратов, мониторинг отзывов, сверку поставок и расчёт юнит-экономики с учётом комиссий и логистики. Результат — таблица, отчёт или регулярная сводка в Telegram.

### Обновляются ли данные автоматически?
Агент запрашивает API при каждой задаче, поэтому работает с актуальными данными. Регулярные отчёты можно поставить по расписанию — агент сам соберёт и пришлёт сводку.

[Открыть Wildberries API](https://seller.wildberries.ru)