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

В ноябре 2025 года мы выпустили 12 обновлений API, из которых 7 — критические изменения с конкретными дедлайнами. Главный фокус месяца — масштабная оптимизация работы с заказами и поставками FBS: новые версии методов позволяют обрабатывать до 100 элементов вместо одного, что существенно ускоряет интеграции.

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

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

---

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

---

Заказы и поставки FBS

Ноябрь стал месяцем масштабной оптимизации FBS-методов. Wildberries последовательно переводит API на batch-обработку, что критически важно для продавцов с большим объёмом заказов.

Новая версия метода метаданных FBS

Добавлена новая версия метода Получить метаданные сборочных заданий. Ключевое изменение — теперь в одном запросе можно передать до 100 ID сборочных заданий вместо одного.

Дедлайн миграции: 24 декабря 2025 года — текущая версия метода будет отключена.

Что это даёт

Для бизнеса:

• Ускорение обработки заказов в пиковые периоды — вместо 100 запросов достаточно одного
• Снижение риска превышения лимитов API при массовой обработке
• Более стабильная работа интеграций в периоды высокой нагрузки

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

• Упрощение логики пакетной обработки заказов
• Снижение нагрузки на инфраструктуру за счёт меньшего количества HTTP-запросов
• Возможность оптимизации параллельной обработки

Миграция

Замените вызовы старого эндпоинта GET /api/v3/orders/{orderId}/meta на новый POST /api/marketplace/v3/orders/meta с массивом ID в теле запроса. Рекомендуется группировать заказы батчами по 50-100 штук для оптимальной производительности.

---

Новая версия метода добавления заданий к поставке

Аналогичное обновление получил метод Добавить сборочные задания к поставке. Теперь можно добавлять до 100 сборочных заданий к поставке одним запросом.

Дедлайн миграции: 18 декабря 2025 года.

Практическое применение

Это изменение особенно важно для продавцов, формирующих крупные поставки. Раньше добавление 500 заказов к поставке требовало 500 отдельных API-вызовов. Теперь это можно сделать за 5 запросов.

Рекомендации по внедрению:

• Реализуйте буферизацию заказов перед добавлением к поставке
• Добавьте обработку частичных ошибок — при batch-запросах часть заказов может быть добавлена успешно, а часть — нет
• Логируйте результаты каждого batch-запроса для отладки

---

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

Добавлен новый метод Получить ID сборочных заданий поставки, который возвращает только идентификаторы заданий без полных данных.

Старый метод Получить сборочные задания в поставке будет отключён 17 декабря 2025 года.

Зачем это нужно

Новый подход оптимизирует работу с большими поставками:

1. Получаете список ID через новый легковесный метод
2. Запрашиваете детали только для нужных заказов через отдельный метод

Это снижает объём передаваемых данных и ускоряет работу, особенно когда вам нужна информация только о части заказов в поставке.

---

Новое поле optionalMeta в сборочных заданиях

В ответ метода Получить список новых сборочных заданий добавлено поле optionalMeta — список необязательных метаданных.

Разница между requiredMeta и optionalMeta

• requiredMeta — метаданные, без которых сборочное задание нельзя перевести в доставку
• optionalMeta — метаданные, которые можно не указывать для перевода в доставку, но они могут потребоваться при возврате товара покупателем

Важно: Если товар подлежит обязательной маркировке, необходимо указывать метаданные независимо от того, в каком поле они получены (согласно п. 4.6 Оферты).

Рекомендация: Добавляйте в сборочные задания все метаданные из обоих полей — это снизит риск проблем при возвратах.

---

Увеличение лимита кодов маркировки

Увеличен лимит элементов в массиве sgtins при закреплении кодов маркировки за сборочным заданием. Теперь можно передавать до 100 кодов одним запросом вместо прежнего ограничения.

Это упрощает работу с товарами, требующими множественной маркировки (например, комплекты или наборы).

---

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

Ограничение в методе статистики кампаний

С 27 ноября в запросе метода Статистика кампаний можно передавать максимум 50 ID кампаний в массиве ids.

Что делать

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

---

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

Из ответов методов Списки кампаний и Информация о кампаниях удалены данные кампаний с устаревшими типами:

• 4 — в каталоге
• 5 — в карточке товара
• 6 — в поиске
• 7 — в рекомендациях на главной странице

Эти типы кампаний нельзя создать с марта 2024 года. Если ваша система всё ещё обрабатывает эти типы, можно безопасно удалить соответствующую логику.

---

Реорганизация методов поисковых кластеров

Методы для работы с поисковыми кластерами выделены в отдельный подраздел документации. Функциональность не изменилась — это чисто организационное улучшение для удобства навигации.

---

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

Временное отключение методов жалоб на отзывы

8 декабря будут отключены методы управления жалобами:

1. Получить списки причин жалоб на отзыв и проблем с товаром
2. Пожаловаться на отзыв, сообщить о проблеме с товаром

Что делать

Wildberries временно убирает эту функциональность из API для улучшения точности данных. Работа с жалобами остаётся доступной через личный кабинет продавца.

Рекомендации:

• Если у вас автоматизирована подача жалоб через API, перенесите этот процесс в ручной режим через ЛК
• О возобновлении работы методов WB обещает сообщить дополнительно
• Следите за Release Notes для получения информации о возврате функциональности

---

Удаление поля valuation в необработанных отзывах

11 декабря из ответа метода Необработанные отзывы будет удалено поле valuation (средняя оценка всех отзывов).

Если ваша система использует это поле, удалите его обработку из кода или получайте среднюю оценку другим способом.

---

Отключение методов шаблонов ответов

Напоминание о дедлайне из октября: с 19 ноября отключены методы работы с шаблонами ответов:

• Получить шаблоны ответов на вопросы и отзывы
• Создать шаблон
• Редактировать шаблон
• Удалить шаблон

Если вы ещё не мигрировали — реализуйте хранение шаблонов в собственной системе и используйте методы прямой отправки ответов.

---

Документы и аналитика

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

В детализацию к отчётам реализации добавлено поле payment_schedule — разовое изменение срока перечисления денежных средств.

Поле применяется для отображения комиссии по услуге Вывести сейчас, которая позволяет получить выплату раньше стандартного срока.

Практическое применение

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

---

Новый столбец в CSV-отчёте по остаткам

4 декабря в CSV-отчёт по остаткам модели StocksReportRes добавлен столбец ChrtID — ID размеров товаров.

Столбец расположен между SizeName и RegionName.

Что это даёт

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

Важно: Отчёт данной модели доступен без подписки Джем.

---

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

До 8 декабря

• Перенести работу с жалобами на отзывы в личный кабинет

До 11 декабря

• Удалить обработку поля valuation в методе необработанных отзывов

До 17 декабря

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

До 18 декабря

• Мигрировать на batch-версию метода добавления заданий к поставке
• Реализовать группировку заказов по 50-100 штук

До 24 декабря

• Мигрировать на batch-версию метода получения метаданных FBS
• Обновить обработку ошибок для batch-запросов

Рекомендуемые улучшения

• Добавить обработку поля optionalMeta в новых сборочных заданиях
• Внедрить обработку поля payment_schedule в финансовых отчётах
• Обновить парсинг CSV-отчётов с учётом нового столбца ChrtID
• Ограничить запросы статистики кампаний до 50 ID

---

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

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

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