Дайджест обновлений WB API за январь 2026

В январе 2026 года Wildberries выпустили 7 обновлений API. Ключевые темы: новый метод для получения данных B2B-покупателей в DBS, поддержка кроссбордера в сборочных заданиях и поставках FBS, а также продолжение расширения отчёта реализации новыми полями скидок.

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

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

---

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

---

Напоминания из прошлых дайджестов

Если вы пропустили дайджест за декабрь, обратите внимание — ряд дедлайнов всё ещё впереди:

---

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

---

Заказы DBS

Новый метод: информация о B2B-покупателе

Добавлен метод получения информации о покупателе B2B для модели DBS. Через API теперь можно получить данные B2B-покупателя: ИНН, КПП и наименование организации.

Метод принимает массив ID сборочных заданий и возвращает реквизиты покупателя по каждому из них. Определить, является ли заказ B2B-продажей, можно по полю options.isB2b в ответе метода Получить новые сборочные задания DBS. Если isB2b: true — вызывайте новый метод для получения реквизитов.

Что это даёт

Для бизнеса:

• Автоматическое формирование закрывающих документов для юридических лиц
• Ускорение обработки B2B-заказов без ручного запроса реквизитов
• Возможность вести раздельный учёт B2B и B2C продаж

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

• Интеграция с бухгалтерскими системами (1С, МойСклад) для автоматического создания счетов-фактур
• Обогащение данных заказа реквизитами покупателя без ручного ввода

---

Заказы FBS

Поле crossBorderType в сборочных заданиях и поставках

В ответы четырёх методов FBS добавлено поле crossBorderType, которое показывает, является ли сборочное задание или поставка кроссбордером.

Поле появилось в методах сборочных заданий:

• Получить список новых сборочных заданий
• Получить информацию о сборочных заданиях

И в методах поставок:

• Получить список поставок
• Получить информацию о поставке

Логика работы с поставками: в пустую поставку можно добавить сборочное задание любого типа — кроссбордер или не кроссбордер. Поставка приобретает тип первого добавленного задания, после чего в неё можно добавлять только задания того же типа. Это поведение аналогично тому, как поставка наследует габаритный тип (cargoType) от первого задания.

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

---

Документы и бухгалтерия

Новые поля в детализации отчётов реализации

Метод Отчёт о продажах по реализации продолжает обрастать данными — в январе добавлены два набора полей. Напомним, в декабре в этот же метод были добавлены поля delivery_method, seller_promo_id и seller_promo_discount.

Скидки лояльности (с 12 января)

В ответ добавлены поля loyalty_id и loyalty_discount — они показывают ID и процент скидки лояльности от продавца. Подробнее о механике скидок лояльности: анонс.

Скидки за промокоды (с 19 января)

Аналогично появились uuid_promocode и sale_price_promocode_discount_prc — ID промокода и процент скидки за него. Подробнее о промокодах: анонс.

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

---

Общение с покупателями

Удаление устаревших полей из чатов

Wildberries продолжает чистку устаревших полей в методах Список чатов и События чатов. Поле clientID (ID покупателя) будет удалено 2 февраля, а поле statusID (статус товара) — 10 февраля.

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

Формат изображений в отзывах

С 5 февраля изображения в поле photoLinks будут возвращаться в формате webp вместо jpg для методов:

• Список отзывов
• Получить отзыв по ID
• Список архивных отзывов

Формат URL в полях fullSize и miniSize изменится — расширение файлов в ссылках будет .webp вместо .jpg. Если вы сохраняете или обрабатываете фотографии из отзывов, убедитесь, что ваш код корректно работает с форматом webp. Большинство современных библиотек для работы с изображениями поддерживают webp, но если вы проверяете расширение файла или MIME-тип — обновите эти проверки.

---

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

До 2 февраля

• Удалить обработку поля clientID в методах чатов
• (из декабря) Завершить переход с кампаний типа 8 на тип 9

До 5 февраля

• Обновить обработку формата изображений в photoLinks (webp вместо jpg)

До 9 февраля

• (из декабря) Заменить баркоды на chrtId во всех методах работы с остатками

До 10 февраля

• Удалить обработку поля statusID в методах чатов

До 11 марта

• (из декабря) Мигрировать с метода «Поставки» на методы раздела «Информация о поставках»

Возможные улучшения

• Интегрировать метод получения данных B2B-покупателя в обработку DBS-заказов
• Использовать crossBorderType для маршрутизации кроссбордерных заказов FBS
• Добавить поля loyalty_id, loyalty_discount, uuid_promocode и sale_price_promocode_discount_prc в финансовую отчётность

---

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

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

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