WB API: обзор для бизнеса

Что такое WB API

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

Чтобы пользоваться преимуществами API, не обязательно быть разработчиком. Обычно задачи распределяют так: бизнес решает, что автоматизировать, разработчик или партнёр по интеграции реализует решение, а на этом портале есть всё необходимое для работы — документация, история изменений и практические материалы.

---

Что можно автоматизировать

Ориентируйтесь на результат, а не на отдельные методы:

• Поддерживайте актуальные цены и остатки — устанавливайте цены и скидки для сотен товаров одной загрузкой и обновляйте остатки на складе продавца, вместо того чтобы редактировать товары по одному.
• Обрабатывайте заказы — для FBS получайте новые сборочные задания по мере поступления и проводите их через сборку и передачу в доставку.
• Следите за продажами — выгружайте данные о продажах, заказах и остатках в свои дашборды и отчёты.
• Масштабируйте продвижение — запускайте кампании, управляйте ставками и бюджетами и оценивайте результаты.
• Быстро отвечайте покупателям — работайте с отзывами, вопросами, чатами и заявками на возврат в своих программах.
• Ведите финансовый учёт — загружайте баланс и финансовые отчёты прямо в свою учётную систему.

Начать удобно с цен и заказов — там ручная работа отнимает больше всего времени. Разобраться в методах поможет «Карта вызовов WB API».

---

Как API сокращает ручную работу

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

---

Подойдёт ли вам API?

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

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

---

Как получить доступ

1. Личный кабинет WB Партнёры. API даёт доступ к данным вашего кабинета, поэтому сначала нужен аккаунт продавца. Как стать продавцом и создать токен — в материале «Как начать работать с WB API: от регистрации до токена».
2. Токен API. Токен создаётся в личном кабинете WB Партнёры, в разделе «Интеграции по API». При создании Базового или Персонального токена выбирают категории данных и уровень доступа — «Только чтение» или «Чтение и запись». Выбирайте только нужные категории, чтобы каждая интеграция получала минимально необходимый доступ. Для Сервисного токена категории и уровень доступа заполняются автоматически при выборе сервиса.
3. Запросы с токеном. Далее вы отправляете обычные HTTPS-запросы с токеном — подробнее в разделе «Авторизация».

---

С чего начинается интеграция

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

Передайте разработчику материал «Первый запрос за 15 минут», чтобы выполнить первый запрос. Затем пригодится «Карта вызовов WB API» — она поможет выстроить дальнейшую работу.

---

Что есть на этом портале

• Документация — справочник по каждому методу: параметры, форматы запросов и ответов, коды ошибок и лимиты.
• Swagger — интерактивное описание методов API.
• Release Notes — изменения API: что поменялось и кого это касается; об устаревании методов тоже сообщают здесь.
• Статьи и новости — практические материалы, которые можно передать разработчику, и анонсы.