Дайджест обновлений WB API — Март 2026

В марте 2026 года Wildberries выпустили 12 обновлений API. Месяц прошёл под знаком повышения качества данных: проверка метаданных при отгрузке FBS, обязательный IMEI для DBS, новые правила объединения карточек. Часть изменений уже действует, ближайшие дедлайны — 7 и 9 апреля. Из новых возможностей — метод получения остатков на складах WB с расширенными лимитами, рекомендуемые ставки для рекламных кампаний и информация о покупателе DBW.

Дисклеймер: Практические рекомендации в этом дайджесте могут различаться в зависимости от специфики вашей реализации.

Готовая Postman коллекция: Для удобства тестирования и работы с API мы подготовили коллекцию методов из этого дайджеста. Импортируйте её в свой Postman, укажите API-ключ в переменной api_key и сразу начинайте работу с методами.

Коротко о главном

Критические изменения с дедлайнами

---

Заказы FBS

В марте FBS получил ряд обновлений, направленных на повышение качества данных: поэтапная валидация метаданных при переводе в доставку, разделение B2B и B2C-заданий в поставках и отслеживание статуса стикеров для кроссбордера.

Проверка метаданных при переводе поставки в доставку

Wildberries внедряет поэтапную валидацию метаданных сборочных заданий FBS. При переводе поставки в доставку через PATCH /api/v3/supplies/{supplyId}/deliver теперь проверяется корректность заполнения метаданных. Если данные указаны неверно или отсутствуют, метод вернёт ошибку 409 с кодом MetaValidationFail и детализацией по каждому сборочному заданию.

Валидация вводится в три этапа:

• 31 марта (уже действует) — IMEI
• 7 апреля (через 4 дня) — УИН
• 9 апреля (через 6 дней) — коды маркировки для B2B-заказов

Параллельно обновлён метод получения метаданных POST /api/marketplace/v3/orders/meta. В ответ добавлен массив metaDetails, который возвращает статусы валидации по каждому типу метаданных: filled, required, pending, а также конкретные причины отказа — imeiInvalidFormat, imeiAlreadySold, uinBadStatus, sgtinNotFound и другие. Используйте этот массив перед переводом поставки в доставку, чтобы заранее выявить проблемы и показать продавцу точную причину блокировки.

Устаревший объект meta в ответе этого же метода будет удалён 30 апреля. Переходите на metaDetails заблаговременно.

Подробнее о валидации — в справочном центре.

Что делать

1. Перед вызовом PATCH deliver получайте metaDetails через POST /api/marketplace/v3/orders/meta
2. Проверяйте поле decision у каждого элемента массива — если значение не filled и не optional, заказ не пройдёт валидацию
3. Замените обработку объекта meta на массив metaDetails до 30 апреля

Признак B2B-продажи для поставок

В ответы методов получения списка поставок и получения информации о поставке добавлено поле isB2b — признак B2B-продажи. Поле принимает три значения: true (B2B), false (не B2B) и null (к поставке ещё не добавлены сборочные задания).

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

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

Статус генерации стикера для кроссбордера

С 1 апреля (уже действует) в ответ метода POST /api/v3/orders/stickers/cross-border добавлено поле status со значениями:

• awaitingTrackNumber — стикер не готов, ожидается трек-номер от перевозчика
• ready — стикер готов, PDF доступен в поле file

Стикеры для кроссбордер-заказов могут генерироваться с задержкой — трек-номер поступает от перевозчика асинхронно. Повторяйте запрос, пока не получите статус ready, прежде чем использовать данные из поля file. За один запрос можно получить стикеры для 100 сборочных заданий.

---

Заказы DBS

Обязательный IMEI для перевода в доставку

Параллельно с валидацией метаданных FBS (см. выше), в DBS также расширены требования к IMEI. Перевести сборочное задание в доставку теперь можно только при наличии обязательного IMEI. Метод POST /api/marketplace/v3/dbs/orders/status/deliver вернёт ошибку 409 с "detail":"ImeiIsNotFilled", если IMEI не закреплён за заданием.

Чтобы определить, требуется ли IMEI для конкретного заказа, проверяйте массив requiredMeta в ответе метода GET /api/v3/dbs/orders/new. Если массив содержит "imei", закрепите IMEI через метод POST /api/marketplace/v3/dbs/orders/meta/imei перед переводом в доставку. На один заказ можно привязать только один IMEI, и только для заказов в статусе confirm.

Валидация идентификаторов при отгрузке теперь работает и в FBS, и в DBS. Если вы работаете с обеими моделями, унифицируйте проверку IMEI в едином флоу перед вызовом deliver.

---

Аналитика

Новый метод получения остатков на складах WB

Добавлен метод POST /api/analytics/v1/stocks-report/wb-warehouses для получения текущих остатков на складах WB. Данные обновляются раз в 30 минут — одна строка ответа содержит данные об одном размере товара на одном складе.

Метод заменяет устаревший GET /api/v1/supplier/stocks, который будет отключён 23 июня.

Ключевые отличия от старого метода:

• Лимит строк — до 250 000 в одном ответе
• Частота запросов — 1 раз в 20 секунд на аккаунт (вместо 1 раза в минуту)
• Офсетная пагинация — для обхода больших объёмов данных
• Дедупликация — все остатки одного размера на одном складе строго в одной строке
• Фильтрация — можно запросить данные по конкретным nmIds и chrtIds (до 1000 позиций)
• Новые поля — ID складов (warehouseId), названия складов (warehouseName) и регионы отгрузки (regionName)
• Сортировка — по возрастанию артикулов WB

Метод доступен по Персональному или Сервисному токену для категории Аналитика.

Для бизнеса

• Точный мониторинг остатков по складам и регионам без ручной обработки дублей
• Фильтрация по конкретным товарам — не нужно загружать весь каталог для проверки нескольких SKU

Для разработчиков

• Офсетная пагинация позволяет корректно обрабатывать каталоги любого размера
• Одна строка на размер/склад упрощает агрегацию и снижает объём обработки

Что меняется при миграции

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

---

Работа с товарами

Новые правила объединения карточек

С 11 марта (уже действует) для категорий Красота и Бытовая химия применяются новые правила объединения карточек товаров. Обновлённые правила уточняют, какие товары можно объединять в одну карточку, — это повышает качество каталога и корректность отображения для покупателей.

Изменения затронули три метода:

• Создание карточек товаров
• Создание карточек с присоединением — до 29 карточек за запрос
• Редактирование карточек — до 3000 карточек за запрос

Если карточка в запросе не соответствует новым правилам, метод вернёт 400 с описанием ошибки в errorText. В объекте additionalErrors будут перечислены vendorCode карточек, не прошедших проверку — это позволяет точечно исправить проблемные позиции, не перебирая весь запрос.

Если вы работаете с категориями «Красота» или «Бытовая химия» и создаёте или объединяете карточки через API, добавьте обработку статус-кода 400 с проверкой additionalErrors. Правила уже действуют, так что существующие интеграции могут начать получать ошибки без изменений с вашей стороны.

---

Заказы DBW

Информация о покупателе

Добавлен метод POST /api/marketplace/v3/dbw/orders/client для модели DBW. Метод возвращает данные покупателя по ID заказа: имя, полное имя для документов (fullName), основной телефон с добавочным кодом (phone + phoneCode), резервный телефон (replacementPhone) и дополнительные контактные номера.

Для бизнеса

• Автоматическое формирование документов с данными покупателя без ручного запроса реквизитов
• Оперативная связь с клиентом при вопросах по заказу — доступны все контактные данные

Для разработчиков

• Интеграция с CRM и системами документооборота: fullName подходит для печатных форм, phone + phoneCode — для автодозвона
• Поддержка нескольких телефонов — учитывайте additionalPhones при реализации логики обзвона

---

Маркетинг и продвижение

Рекомендуемые ставки для кампаний

Добавлен метод GET /api/advert/v0/bids/recommendations для получения рекомендуемых ставок по ID кампании и артикулу WB. Метод работает только для кампаний с оплатой за показы (CPM).

Ответ содержит два уровня рекомендаций:

Для карточки товара — три ориентира в копейках:

• competitiveBid — средняя ставка других продавцов в категории
• leadersBid — средняя ставка лидеров категории
• top2 — ставка для попадания в топ

Для поисковых кластеров (normQueries) — рекомендуемые ставки с разбивкой по уровню охвата:

• Максимальный (76–100%) — reachMax
• Средний (61–75%) — reachMedium
• Минимальный (50–60%) — reachMin

Каждый уровень содержит рекомендуемую ставку (bidKopecks) и минимальную ставку (bidKopecksMin).

На практике метод позволяет автоматизировать управление ставками: например, периодически сверять текущую ставку кампании с competitiveBid и корректировать до конкурентного уровня, или алертить, когда ставка опускается ниже bidKopecksMin для целевого охвата. Лимит — 5 запросов в минуту, что достаточно для мониторинга десятков кампаний с интервалом в несколько минут.

---

Поставки FBW

Новые поля для типов поставок

В ответы методов Опции приёмки, Список поставок и Детали поставки добавлено поле isBoxOnPallet — тип поставки Поштучная паллета. Поле возвращается только при boxTypeID: 2 (коробки): true означает, что коробки размещены на паллете поштучно.

В метод Список поставок также добавлено поле boxTypeID — числовой идентификатор типа поставки:

Если ваша система автоматически формирует или маршрутизирует поставки, эти поля позволяют точнее определять тип и корректно обрабатывать разные форматы приёмки.

---

Общее

Управление пользователями продавца

Два обновления в разделе Управление пользователями.

Во-первых, методы управления пользователями теперь доступны для продавцов из всех стран. Ранее функциональность была ограничена отдельными регионами. Через API можно:

• Создать приглашение для нового пользователя с доступом к профилю продавца
• Получить список пользователей — активных и приглашённых
• Изменить права доступа
• Закрыть доступ к профилю

Для авторизации нужен Персональный токен с категорией Пользователи от активного владельца профиля.

Во-вторых, расширен список разделов личного кабинета, к которым можно настроить доступ сотрудников:

• oldAnalyticsReports — Отчёты
• marketplace — Свой склад

Указывайте новые разделы при создании приглашений и изменении прав доступа. Обновлённый перечень доступных разделов можно получить через GET /api/v1/users.

ИНН в информации о продавце

В ответ метода GET /api/v1/seller-info добавлено поле tin — ИНН продавца. Метод доступен по токену любой категории.

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

---

Чек-лист миграции

Уже действует

• Обработка ошибки 409 при валидации IMEI в поставках FBS — проверять decision в metaDetails перед вызовом deliver
• Обработка ошибки 409 (ImeiIsNotFilled) при переводе DBS-заказов в доставку без IMEI
• Обработка ошибки 400 при объединении карточек «Красота» и «Бытовая химия» — проверять additionalErrors
• Учёт поля status в стикерах кроссбордера FBS — повторять запрос до ready

До 7 апреля (через 4 дня)

• Добавить обработку валидации УИН при переводе поставки FBS в доставку — проверять decision в metaDetails

До 9 апреля (через 6 дней)

• Добавить обработку валидации кодов маркировки для B2B-заказов FBS

До 30 апреля

• Мигрировать с объекта meta на массив metaDetails в ответе POST /api/marketplace/v3/orders/meta

До 23 июня

• Мигрировать с GET /api/v1/supplier/stocks на POST /api/analytics/v1/stocks-report/wb-warehouses

---

Полезные ссылки

Официальная документация и ресурсы

• Официальная документация WB API
• Release Notes со всеми обновлениями
• Песочница для тестирования API
• База знаний WB API