Дайджест WB API — Декабрь 2025

В свежем выпуске нашего ежемесячного дайджеста мы расскажем о новых функциях и обновлениях, которые вышли в декабре 2025

Дата публикации: 06.01.2026

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

В декабре 2025 года Wildberries выпустили 18 обновлений API — это самый насыщенный месяц года. Ключевые темы: поддержка CPC-кампаний (оплата за клики), переход с баркодов на chrtId в методах остатков, новый сервис управления пользователями и множество улучшений в финансовых отчётах.

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

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

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

Срок изменения	Что меняется	Требуемые действия
15 января	Отключение методов фиксированных фраз и статистики по ключевым фразам	Переход на методы поисковых кластеров
20 января	Отключение методов «Подмена товара» и «Смена характеристик»	Миграция на новый метод «Подмены и неверные вложения»
27 января	Отключение старого метода замеров габаритов	Миграция на новые методы отчётов о габаритах
2 февраля	Отключение методов кампаний с единой ставкой (тип 8)	Переход на кампании типа 9
9 февраля	Отказ от баркодов в методах остатков	Переход на использование chrtId
11 марта	Отключение метода «Поставки»	Использование методов раздела «Информация о поставках»

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

Поддержка CPC-кампаний (оплата за клики)

Главное обновление месяца в рекламном API — теперь вы можете создавать и управлять кампаниями с типом оплаты cpc — оплата за клики.

Новые и обновлённые методы

Информация о кампаниях — новая версия
Минимальные ставки для карточек товаров — новая версия
Изменение ставок в кампаниях — новая версия
Создать кампанию — добавлен параметр payment_type

Что это даёт

Для бизнеса:

Альтернативная модель оплаты рекламы — платите только за реальные клики
Более предсказуемый рекламный бюджет при фиксированной цене за клик
Возможность тестировать разные стратегии оплаты для разных товаров

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

Единый API для работы с обоими типами оплаты (CPM и CPC)
Параметр payment_type позволяет явно указать тип оплаты при создании кампании

Отключение методов кампаний типа 8

Wildberries продолжает унификацию рекламных кампаний. 2 февраля будут отключены методы для кампаний с единой ставкой (тип 8):

Список карточек товаров для кампании с единой ставкой
Изменение списка карточек товаров в кампании с единой ставкой
Статистика кампании с единой ставкой по кластерам фраз
Установка/удаление минус-фраз для кампании с единой ставкой — дата перенесена с 15 января на 2 февраля

Используйте кампании типа 9 с параметром bid_type для указания типа ставки.

Отключение устаревших методов фраз и статистики

15 января будут отключены:

Для работы с поисковыми кластерами и минус-фразами используйте актуальные методы из раздела Поисковые кластеры.

Также метод получения статистики поисковых кластеров перенесён в подраздел Статистика.

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

Переход с баркодов на chrtId в методах остатков

Важное изменение для всех, кто работает с остатками на складах продавца. В методы добавлен chrtId — ID размера товара:

Получить остатки товаров — в запрос и ответ
Обновить остатки товаров — в запрос
Удалить остатки товаров — в запрос

Дедлайн миграции: С 9 февраля баркоды перестанут использоваться для работы с остатками.

Как получить chrtId

У товара может быть только один chrtId. Получить его можно методом Список карточек товаров.

Новый метод получения брендов

Добавлен метод получения брендов товаров по ID предмета.

Используйте его при создании карточек товаров — можно указать любой бренд, который есть в нужном предмете.

Заказы FBS и кроссбордер

Новые статусы для DPX-отправок

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

accepted_by_carrier — принят перевозчиком (продавец передал заказ в службу доставки в своей стране)
sent_to_carrier — отправлен перевозчику (заказ отправлен на склад службы доставки в стране продавца)

Аналогичные статусы добавлены в метод История статусов для сборочных заданий кроссбордера:

dispatched_to_delivery_service — продавец передал заказ в службу доставки
on_way_to_delivery_service — заказ отправлен на склад службы доставки

Стикеры для заказов в доставке

Расширены возможности получения стикеров — теперь метод Получить стикеры работает не только для заказов в статусе confirm (на сборке), но и в статусе complete (в доставке).

Это полезно, если нужно перепечатать потерянный или повреждённый стикер для заказа, который уже передан в доставку.

Общее

Новый сервис управления пользователями продавца

Добавлен новый раздел API — Управление пользователями продавца. Теперь через API можно:

Важно: Управлять доступом можно только с токеном активного владельца профиля продавца.

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

Для бизнеса:

Автоматизация онбординга новых сотрудников
Централизованное управление доступами из корпоративных систем
Аудит и контроль доступа к аккаунту продавца

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

Интеграция с корпоративными системами управления доступом (IAM)
Автоматическое создание/отзыв доступа при изменениях в HR-системах

Документы и отчёты

Декабрь принёс множество обновлений в финансовых отчётах.

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

Поле delivery_method (с 23 декабря)

В детализации к отчётам реализации добавлено поле delivery_method с информацией о способе продажи и типе товара.

Теперь можно соотнести позиции в отчёте с тарифами в зависимости от способа доставки. Поле отображается только для моделей FBS, FBW и DBW.

В ежедневных отчётах — начиная с отчёта за 22 декабря
В еженедельных — с отчёта за 22–28 декабря

Поля seller_promo_* (с 30 декабря)

Добавлены поля с информацией о собственных акциях продавца:

seller_promo_id — ID собственной акции продавца с дополнительной скидкой
seller_promo_discount — размер дополнительной скидки по собственной акции, %
В ежедневных отчётах — начиная с отчёта за 29 декабря
В еженедельных — с отчёта за 29–31 декабря

Изменение ответа при отсутствии данных

Метод Отчёт о продажах по реализации теперь возвращает 204 No Content при отсутствии данных вместо пустого массива [] в ответе 200.

Что делать: Обновите обработку ответов — добавьте проверку статуса 204 как корректного ответа без данных.

Новые отчёты об удержаниях

Отчёт «Подмены и неверные вложения»

Добавлен новый метод Подмены и неверные вложения.

20 января будут отключены старые методы:

Отчёты о занижении габаритов упаковки

Добавлены новые методы:

Старый метод будет отключён 27 января.

text — текст последнего сообщения
addTimestamp — время сообщения

Это позволяет отображать превью чатов без дополнительных запросов на получение истории сообщений.

Статусы модерации файлов

В метод Получить файл из сообщения добавлены новые ответы:

202 — файл на модерации
451 — файл не прошёл модерацию

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

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

До 20 января

Мигрировать на новый метод «Подмены и неверные вложения»

До 27 января

Перейти на новые методы отчётов о габаритах упаковки

До 2 февраля

Завершить переход с кампаний типа 8 на тип 9
Обновить работу с минус-фразами для кампаний с единой ставкой

До 9 февраля

Заменить баркоды на chrtId во всех методах работы с остатками
Создать маппинг баркод → chrtId для всех товаров

До 11 марта

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

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

Внедрить поддержку CPC-кампаний (payment_type)
Добавить обработку новых статусов DPX в кроссбордере
Обновить обработку ответа 204 в отчёте о продажах
Добавить поля delivery_method и seller_promo_* в финансовую отчётность
Интегрировать сервис управления пользователями с корпоративными системами
Использовать lastMessage для превью чатов

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

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