Wiki · Интеграции

Wildberries

5 мин чтенияАвтор: Дмитрий КолесниковСоавторы: Евгений Баев

Интеграция с Wildberries – это обмен данными между вашим сайтом или учётной системой и кабинетом продавца Wildberries через API: карточки товаров, цены, остатки, заказы и отчёты о продажах передаются без ручного ввода.

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

Wildberries и RWB: что изменилось для продавца

Wildberries объединился с рекламной группой Russ. Объединённая компания называется RWB, на её сайте rwb.ru перечислены маркетплейс Wildberries, рекламный бизнес RWB Media, WB Банк, WB Travel и другие направления. Сам маркетплейс по-прежнему называется Wildberries (на октябрь 2026 года), кабинет продавца и документация API остались на доменах wildberries.ru. Для интеграции ребрендинг ничего не меняет: договор, токены и адреса API прежние.

Модели FBW, FBS и DBS и что они значат для остатков

Модель	Где товар	Кто везёт покупателю	Что синхронизировать
FBW	На складе Wildberries, вы отправляете поставку	Wildberries	Цены, карточки, отчёты. Остаток на складе WB живёт отдельно
FBS	На вашем складе	Wildberries, вы собираете и сдаёте заказ	Общий остаток, цены, сборочные задания
DBS	На вашем складе	Вы сами	Остаток, заказы, статусы доставки

При FBS и DBS сайт и маркетплейс продают из одного склада. Значит, остаток нужно отправлять на WB сразу после каждой продажи, а не раз в сутки. Удобный приём, который есть в готовых интеграциях: задать страховой запас, и при остатке ниже порога выгружать на маркетплейс ноль.

Схема моделей работы продавца на Wildberries: FBW со склада маркетплейса, FBS со склада продавца, DBS с доставкой силами продавца — Модели работы на Wildberries

Как устроен API продавца Wildberries

Документация лежит на портале dev.wildberries.ru. API разделён на категории, у каждой свой адрес: контент (content-api), цены и скидки (discounts-prices-api), маркетплейс для заказов FBS (marketplace-api), статистика (statistics-api), аналитика, продвижение, вопросы и отзывы, поставки, возвраты, документы. В старых инструкциях и библиотеках ещё встречается suppliers-api, но в текущей документации адреса разбиты по категориям, поэтому при поддержке старой интеграции проверяйте, куда она обращается.

Доступ даёт токен. Его создаёт сам продавец в кабинете: «Настройки», затем «Доступ к API». При создании отмечают категории, к которым у токена будет доступ, и при желании ставят «Только на чтение». Токен действует 180 дней, передаётся в заголовке Authorization и показывается один раз, при создании.

GET https://statistics-api.wildberries.ru/...
Authorization: токен из кабинета продавца

Wildberries советует делать отдельный токен для каждой интеграции и давать ему только нужные категории. Тогда отчётам для бухгалтерии хватит токена на чтение, и менять цены он не сможет.

Для отладки есть тестовый контур: токен с отметкой «Тестовый контур» работает только с адресами песочницы и не трогает боевые данные.

Почему интеграция с WB перестаёт работать

Истёк токен. Через 180 дней обмен остановится, поэтому дату замены ставят в календарь.
У токена нет нужной категории. Остатки идут, а цены нет: значит, при создании не отметили «Цены и скидки».
Слишком частые запросы. У методов есть лимиты, и при превышении API отвечает ошибкой 429. Обмен делают пакетами и с паузами, а не запросом на каждый товар.
Не совпадают артикулы. Если артикул продавца на WB отличается от кода в 1С, остаток уходит не тому товару.

Откуда брать остатки: 1С, МойСклад или сайт

Для 1С:Предприятие есть встроенный обмен с маркетплейсами в торговых конфигурациях и модули партнёров 1С. МойСклад подключает Wildberries готовыми приложениями и базовой интеграцией. Сайт на 1С-Битрикс тоже может отдавать остатки через модуль, если учёт ведётся в нём. Выбирайте ту систему, где остаток точнее всего, и делайте её единственным источником. Подробно про связку сайта и учёта в статье Интеграция сайта с 1С.

Пять шагов подключения API Wildberries: токен, категории доступа, тестовый контур, сверка артикулов и замена токена через 180 дней — Как подключить API Wildberries

Свой сайт и маркетплейс: как не отдать площадке своих покупателей

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

Комиссия и логистика Wildberries зависят от категории и модели и меняются, поэтому считайте по тарифам из кабинета продавца. Для сравнения с сайтом пригодится ДРР: на маркетплейсе к комиссии добавляются расходы на продвижение внутри площадки.

Токен, ошибки и остатки: как подключить маркетплейс к сайту и учёту

Как получить токен API Wildberries?

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

Сколько действует токен API Wildberries?

Токен API Wildberries действует 180 дней с момента создания. Когда срок выходит, интеграция перестаёт получать ответы, поэтому новый токен лучше выпустить заранее и заменить в настройках обмена.

Почему API Wildberries возвращает ошибку 401?

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

Что делать с ошибкой 429 в API Wildberries?

Код 429 означает, что интеграция отправила больше запросов, чем разрешает лимит метода. Нужно увеличить паузы между запросами, объединять товары в пакеты и повторять запрос после ожидания, а не сразу.

Чем statistics-api отличается от marketplace-api Wildberries?

Statistics-api Wildberries отдаёт данные о продажах, заказах, остатках на складах и отчёты, их используют для аналитики и бухгалтерии. Marketplace-api нужен для работы с заказами FBS: сборочные задания, поставки, остатки на складе продавца. Для каждой категории в токене отмечают отдельный доступ.

Чем RWB отличается от Wildberries?

RWB – это объединённая компания Wildberries и Russ, а Wildberries – её маркетплейс. Для продавца на октябрь 2026 года меняется немногое: кабинет, договор и API остались прежними.

Как связать Wildberries с 1С и МойСклад?

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

Подключаем Wildberries к сайту и учёту при разработке интернет-магазина и на работающих проектах при доработке сайта: общий остаток, выгрузка цен, заказы и отчёты маркетплейса в 1С.

Документация маркетплейса и RWB

Wildberries: портал документации API для продавцов (dev.wildberries.ru), раздел «Общее»
RWB: официальный сайт компании (rwb.ru)
МойСклад: новость об интеграциях с маркетплейсами

См. также: Ozon, Яндекс Маркет, API.