Обновления WB API за сентябрь 2025

В сентябре мы внесли 14 значимых изменений в API, включая 6 критических обновлений. Основной фокус — унификация методов рекламного API, расширение финансовой отчётности и улучшение процессов работы с товарами.

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

---

Критические изменения: краткий обзор

---

Изменения с прошедшими сроками миграции

Для методов с прошедшими сроками миграции приведены инструкции по миграции на актуальные версии.

Что изменилось с сентября

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

Статистика v3:

• Метод: GET /adv/v3/fullstats
• URL: https://advert-api.wildberries.ru
• Обязательные параметры: ids, beginDate, endDate
• Ожидаемый ответ: HTTP 200 с полем “canceled”

Черновики v2:

• Метод: POST /content/v2/cards/error/list
• URL: https://content-api.wildberries.ru
• Обязательные параметры в теле: page, limit
• Ожидаемый ответ: HTTP 200 с пагинированным списком

---

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

В рекламном API произошли ключевые изменения: унификация создания кампаний, добавление поддержки промо-бонусов и новая версия статистики.

Унификация создания кампаний с разными типами ставок

Статус: Критическое изменение

Крайний срок: 23 октября 2025

URL: https://advert-api.wildberries.ru

Контекст изменения

WB оптимизирует рекламный API, сокращая количество эндпоинтов для снижения барьера входа новых интеграторов. Методы создания кампаний с ручной и единой ставкой объединены в один универсальный метод.

Что изменилось

Новый универсальный метод: POST /adv/v2/seacat/save-ad

Новые обязательные параметры:

{
  "bid_type": "manual",  // "manual" или "unified"
  "placement_types": ["search", "recommendations"]  // только для manual
}

Отключается 23 октября: POST /adv/v1/save-ad — метод создания кампаний с единой ставкой

Как мигрировать

Основные шаги миграции:

1. Замените endpoint: вместо /adv/v1/save-ad используйте /adv/v2/seacat/save-ad
2. Добавьте новый параметр bid_type:- “unified” — для кампаний с единой ставкой (заменяет старый метод)- “manual” — для кампаний с ручным управлением ставками
3. Для manual-кампаний добавьте placement_types: массив площадок размещения (“search”, “recommendations”)
4. Сохраните остальные параметры: name, budget и другие параметры остаются без изменений

Риски при игнорировании крайнего срока

• Полная остановка создания новых кампаний с единой ставкой
• Время на миграцию: 1-2 часа для типовой интеграции
• После 23.10 старый эндпоинт вернёт HTTP 410 Gone

Проверка успешной миграции

Что проверить:

1. Создайте тестовую кампанию через новый эндпоинт
2. Убедитесь в получении HTTP 200 с campaign_id
3. Проверьте, что поле bid_type установлено корректно
4. Убедитесь, что кампания отображается в личном кабинете

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

Для бизнеса:

• Единая точка управления всеми кампаниями
• Упрощённое переключение между стратегиями ставок без изменения интеграции

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

• Консолидация логики создания кампаний в одном методе

---

Промо-бонусы в финансовых методах

Статус: Новая функция

Дата добавления: 08 сентября 2025

URL: https://advert-api.wildberries.ru

Что добавилось

Методы управления бюджетом теперь поддерживают работу с промо-бонусами — средствами, начисленными WB за активность продавца.

Обновлённые методы:

• GET /adv/v1/balance — информация о промо-бонусах
• POST /adv/v1/budget/deposit — пополнение с использованием бонусов

Новые поля ответа /balance

{
  "balance": 10000.50,
  "cashbacks": [
    {
      "sum": 2500.00,           // Доступная сумма промо-бонусов
      "percent": 30,             // Макс. % от суммы пополнения
      "expiration_date": "2025-10-15T23:59:59Z"  // Срок действия
    }
  ]
}

Новые параметры запроса /budget/deposit

{
  "sum": 10000,                  // Общая сумма пополнения
  "cashback_sum": 3000,          // Сумма пополнения промо-бонусами
  "cashback_percent": 30         // Процент использования промо-бонусов
}

Как использовать промо-бонусы

Алгоритм работы:

1. Получите информацию о бонусах через GET /adv/v1/balance- Проверьте наличие массива cashbacks- Извлеките доступную сумму (sum) и максимальный процент (percent)- Проверьте срок действия (expiration_date)
2. Рассчитайте максимальную сумму бонусов для использования:- Возьмите минимум из: доступной суммы бонусов и лимита по проценту- Пример: при пополнении на 10,000₽ с лимитом 30% можно использовать до 3,000₽ бонусов
3. Пополните бюджет через POST /adv/v1/budget/deposit:- Укажите общую сумму в sum- Укажите сумму бонусов в cashback_sum- Укажите процент в cashback_percent
4. Настройте мониторинг сроков действия бонусов за 3-7 дней до истечения

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

Для бизнеса:

• Автоматизация использования промо-бонусов при пополнении кампаний
• Контроль сроков действия бонусов для предотвращения их сгорания
• Оптимизация рекламных расходов за счёт бонусных средств

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

• Реализация алгоритма оптимального использования бонусов с учётом процентных ограничений
• Настройка уведомлений о приближающемся сроке истечения через поле expiration_date

---

Новая версия статистики кампаний

Статус: Критическое изменение

Крайний срок: 30 сентября 2025

URL: https://advert-api.wildberries.ru

Что изменилось

Таблица миграции:

Отключён: POST /adv/v2/fullstats

Используйте: GET /adv/v3/fullstats

Как мигрировать

1. Измените HTTP-метод с POST на GET
2. Упростите параметры: ids (через запятую), beginDate, endDate в формате YYYY-MM-DD
3. Добавьте обработку нового поля canceled

Новое поле canceled

{
  "campaign_id": 12345,
  "canceled": 3,  // Отменённые заказы по техническим причинам
  "orders": 25,
  "revenue": 125000
}

Важно: Поле canceled учитывает технические отмены (недоступность товара, ошибки доставки), а НЕ отказы покупателей.

---

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

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

Статус: Новая функция

URL: https://discounts-prices-api.wildberries.ru

Метод: POST /api/v2/list/goods/filter

Лимиты: До 100 артикулов в одном запросе

Параметры:

{
  "nmIDs": [123456, 123457, ...]  // Массив до 100 артикулов
}

Преимущества:

• Сокращение запросов в 50-100 раз
• Ускорение обновления прайс-листов
• Снижение риска превышения rate limits

---

Расширенная информация о статусах складов

Статус: Изменение в методе

URL: https://marketplace-api.wildberries.ru

Метод: GET /api/v3/warehouses

Новые поля:

{
  "id": 12345,
  "isDeleting": false,    // Склад удаляется
  "isProcessing": true    // Данные обновляются
}

Как использовать:

1. Перед обновлением остатков проверьте статус склада
2. Если isProcessing: true → поставьте в очередь
3. Если isDeleting: true → отмените операцию

---

Обработка товаров под распродажей

URL: https://discounts-prices-api.wildberries.ru

Новая ошибка в GET /api/v2/history/goods/task:

You can't change the item price. Item was added to the Sale due to high inventory

Причина: Товар попал под автораспродажу по индексу остатка.

Действия: Не пытайтесь изменить цену. Отправьте уведомление менеджеру для анализа ликвидности.

---

Заказы и логистика

Расширенная информация о курьерах DBW

URL: https://marketplace-api.wildberries.ru

Метод: POST /api/v3/dbw/orders/courier

Новые поля:

{
  "courier": {
    "fullName": "Иванов Иван",     // Новое
    "pTimeFrom": "2025-09-15T14:00:00Z",  // Новое
    "pTimeTo": "2025-09-15T16:00:00Z"      // Новое
  }
}

Параметр запроса:

{
  "orders": [order_id_1, order_id_2]  // Массив ID заказов
}

Применение: Автоматическая отправка уведомлений покупателям с временем доставки и данными курьера.

---

Получение заказов DBW с обязательными параметрами

URL: https://marketplace-api.wildberries.ru

Метод: GET /api/v3/dbw/orders

Четыре обязательных параметра:

Важно:

• Все 4 параметра обязательны
• Даты в Unix timestamp (секунды)
• Максимальный период: 30 дней
• Для пагинации используйте next из ответа

Алгоритм:

1. Сформируйте даты в Unix timestamp
2. Установите next=0 для первого запроса
3. Получите orders и next из ответа
4. Если next > 0, повторите с новым значением next
5. Если next = 0, достигнута последняя страница

---

Обязательный IMEI для смартфонов

URL: https://marketplace-api.wildberries.ru

Дата вступления: 17 сентября 2025

Для кого: Категория “Смартфоны” (subjectId: 515) в DBW и DBS

Методы:

• PUT /api/v3/dbw/orders/{orderId}/meta/imei
• PUT /api/v3/dbs/orders/{orderId}/meta/imei

Формат IMEI: 15 цифр, без букв и спецсимволов

Последствия без IMEI:

• Заказы “залипают” на этапе сборки
• Автоматические отмены
• Штрафы за нарушение SLA

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

1. Интеграция со сканерами штрихкодов
2. Валидация формата (15 цифр)
3. Мониторинг заказов без IMEI
4. Обучение персонала

---

Финансовая отчётность

Расширение детализации отчёта о реализации

URL: https://statistics-api.wildberries.ru

Метод: GET /api/v5/supplier/reportDetailByPeriod

Новые поля:

{
  "order_uid": "a1b2c3d4",           // ID транзакции (добавлено 08.09)
  "cashback_commission_change": 150  // Комиссия лояльности (добавлено 22.09)
}

Применение order_uid:

• Группировка товаров из одной корзины
• Анализ средней корзины покупателя
• Расчёт кросс-продаж

Метрики для расчёта:

• Средний чек = сумма retail_amount по корзине
• Товаров в корзине = количество записей с одним order_uid
• Доля кросс-продаж = (корзины с >1 товаром) / (все корзины) × 100%
• Расходы на кешбэк = сумма cashback_commission_change

---

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

Оптимизация работы с чатами

Статус: Критическое изменение

Дата: 02 октября 2025

Что изменилось: Поле needRefund удалено из методов чатов.

Затронутые методы:

• GET /api/v1/seller/chats (URL: https://buyer-chat-api.wildberries.ru)
• GET /api/v1/seller/events

Альтернатива: GET /api/v1/claims (URL: https://returns-api.wildberries.ru)

Обязательный параметр is_archive:

• Тип: строка (не boolean!)
• Значения: “false” (активные) или “true” (архивные)
• Без параметра → ошибка 400

Структура ответа:

{
  "claims": [{
    "id": "fe3e9337-...",
    "claim_type": 1,
    "status": 2,
    "nm_id": 196320101,
    "user_comment": "..."
  }],
  "total": 1309
}

Миграция:

1. Разделите обработчики чатов и возвратов
2. Для возвратов используйте отдельный метод с is_archive
3. Настройте раздельный мониторинг

---

Тестовая среда для отзывов и вопросов

URL: https://sandbox-api.wildberries.ru

Методы:

• POST /api/v1/test/make/feedbacks
• POST /api/v1/test/make/questions

Параметры тестового отзыва:

{
  "nmId": 123456,
  "rating": 4,
  "text": "Текст отзыва",
  "userName": "Имя пользователя"
}

Особенности:

• Данные хранятся 5 дней
• Только для песочницы
• Полная имитация реальных отзывов

---

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

Новая версия работы с черновиками

Статус: Критическое изменение

Крайний срок: 30 сентября 2025

URL: https://content-api.wildberries.ru

Миграция:

Отключён: GET /content/v2/cards/error/list

Используйте: POST /content/v2/cards/error/list

Параметры:

{
  "page": 1,      // Номер страницы
  "limit": 500    // Карточек на странице (100-1000)
}

Алгоритм:

1. Начните с page: 1
2. Получите данные
3. Если есть результаты → увеличьте page на 1
4. Повторяйте до пустого ответа

---

Чек-лист по обновлению интеграции

С 17 сентября:

• Внедрена передача IMEI для смартфонов

С 30 сентября:

• Мигрировали на статистику v3 (GET)
• Прекращено использование методов минус-фраз
• Перешли на черновики v2 с пагинацией
• Удалено needRefund из чатов
• Внедрён /api/v1/claims с is_archive
• Разделены обработчики

До 23 октября:

• Переход на универсальный метод создания кампаний
• Добавить параметр bid_type
• Протестировать оба типа

Рекомендуется:

• Промо-бонусы при пополнении
• Новые поля финансовой отчётности
• Метод массового получения цен
• Мониторинг статусов складов
• Обязательные параметры DBW orders

---

---

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

• Документация WB API
• Песочница
• Сообщество
• Release Notes

---

Успешной интеграции! Следите за обновлениями в наших ежемесячных дайджестах.