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

В октябре 2025 года Wildberries внедрили 12 значимых обновлений API, среди которых 5 критических изменений. Основные направления обновлений: завершение унификации рекламных кампаний, расширение аналитических возможностей и оптимизация работы с поставками и заказами.

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

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

---

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

Таблица ниже содержит все изменения, требующие обязательных действий. Обратите особое внимание на даты — некоторые изменения уже вступили в силу.

---

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

Завершение унификации кампаний Продвижения

WB завершает процесс унификации рекламных кампаний, начатый в сентябре 2025 года. Кампании с ручной и единой ставкой теперь полностью объединены в один тип 9, а устаревший тип 8 отключён с 23 октября.

Новая типология кампаний

Все новые кампании создаются с типом 9. Тип ставки теперь определяется отдельным полем bid_type с двумя возможными значениями: manual (ручная ставка) и unified (единая ставка).

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

Создание кампаний

Метод Создать кампанию теперь создаёт только кампании типа 9 с обязательным указанием bid_type.

Информация о кампаниях

Ответ метода Информация о кампаниях с ручной ставкой теперь включает поле bid_type:

{ "campaign_id": 12345, "type": 9, "bid_type": "manual", "status": "active" }

Изменение ставок

Метод переименован в Изменение ставок в кампаниях и теперь требует указания параметра placement:

{ "campaign_id": 12345, "placement": "search", "bid": 150 }

Параметр placement принимает следующие значения: search (в поиске, для ручной ставки), recommendations (в рекомендациях, для ручной ставки), combined (в поиске и рекомендациях, для единой ставки).

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

Метод переименован в Изменение списка карточек товаров в кампаниях.

Список кампаний

Ответ метода Списки кампаний обновлён с описанием всех типов кампаний и добавлением информации о bid_typeдля типа 9.

Пошаговая инструкция миграции

Если вы ещё не обновили интеграцию, выполните следующие шаги.

Шаг 1. Обновление создания кампаний

Убедитесь, что используете актуальный метод создания. Проверьте, что создаваемые кампании имеют тип 9. Всегда указывайте bid_type при создании новых кампаний.

Шаг 2. Обновление обработки информации о кампаниях

Добавьте чтение поля bid_type из ответов API. Обновите логику определения типа ставки в вашей системе. Используйте bid_type вместо type для определения стратегии управления ставками.

Шаг 3. Обновление изменения ставок

Добавьте параметр placement во все запросы на изменение ставок. Для ручных ставок указывайте search или recommendations в зависимости от места размещения. Для единых ставок используйте значение combined.

Шаг 4. Тестирование

Создайте тестовые кампании обоих типов ставок (manual и unified). Проверьте изменение ставок для разных значений placement. Убедитесь в корректном отображении данных в ваших дашбордах.

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

Преимущества для бизнеса

Единая унифицированная система упрощает управление всеми типами кампаний. Появляется возможность быстрого переключения между стратегиями без пересоздания кампаний. Улучшается гибкость управления местами размещения рекламы.

Преимущества для разработчиков

Упрощается кодовая база за счёт единого типа кампаний. Управление типом ставки через отдельное поле делает код более явным и понятным. Улучшается читаемость и поддерживаемость интеграций.

---

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

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

Новые методы

Список ставок поисковых кластеров

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

Установить ставки для поисковых кластеров

Метод позволяет установить или изменить ставки для конкретных поисковых запросов. Можно устанавливать ставки сразу для нескольких кластеров в одном запросе.

Удалить ставки поисковых кластеров

Удаление индивидуальных ставок возвращает кластеры к использованию базовой ставки кампании. Это полезно для упрощения управления малоэффективными запросами.

Статистика по поисковым кластерам

Метод доступен как для кампаний с ручной, так и с единой ставкой. Возвращает статистику эффективности по отдельным поисковым запросам: показы, клики, конверсии и расходы.

Сценарии применения

Оптимизация по эффективности

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

Сезонная оптимизация

Перед началом сезона повысьте ставки на сезонные поисковые запросы. Мониторьте эффективность через статистику в течение сезона. После окончания сезона верните ставки к базовым значениям.

Конкурентная стратегия

Определите ключевые конкурентные поисковые запросы в вашей нише. Установите повышенные ставки на эти кластеры для улучшения позиций. Отслеживайте изменение позиций и конверсии по этим запросам.

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

Преимущества для бизнеса

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

Преимущества для разработчиков

Автоматизация управления ставками на основе метрик эффективности. Интеграция с системами аналитики и BI для комплексного анализа. Создание автоматических стратегий управления ставками по правилам. Возможность A/B тестирования различных стратегий ставок.

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

Начните с анализа статистики за последние 30 дней для определения текущей ситуации. Выделите топ-20% запросов по конверсии как приоритетные для повышения ставок. Постепенно повышайте ставки на эффективных кластерах, отслеживая изменение метрик. Настройте автоматические алерты на резкие изменения эффективности ключевых кластеров.

---

Управление минус-фразами

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

Новые методы

Список минус-фраз кампаний

Метод возвращает все активные минус-фразы, установленные в кампании, с их параметрами и типами соответствия.

Установка и удаление минус-фраз

Единый метод для добавления новых минус-фраз и удаления существующих. Поддерживает массовое обновление в одном запросе.

Формат работы

При установке минус-фраз необходимо указать текст фразы и тип соответствия. Метод возвращает массив всех активных минус-фраз с их параметрами.

{ "campaign_id": 12345, "phrases": [ { "phrase": "дешево", "match_type": "exact" }, { "phrase": "китай", "match_type": "phrase" } ] }

Доступны два типа соответствия: exact (точное соответствие запросу) и phrase (фразовое соответствие, включающее дополнительные слова).

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

Преимущества для бизнеса

Защита от нецелевого трафика снижает бесполезные расходы на рекламу. Снижение расходов на клики, которые не приводят к конверсиям. Улучшение общего качества трафика на карточки товаров. Повышение ROI рекламных кампаний за счёт фокуса на целевой аудитории.

Преимущества для разработчиков

Централизованное управление минус-фразами упрощает их обслуживание. Возможность массового обновления минус-фраз в одном запросе. Синхронизация минус-фраз между несколькими кампаниями. Автоматическое добавление неэффективных запросов из статистики.

Рекомендации по использованию

Базовые минус-фразы

Создайте список общих нецелевых слов для вашей категории: "китай", "дешево", "реплика", "подделка". Исключите названия и бренды конкурентов. Заблокируйте околотематический трафик, не относящийся к вашим товарам.

Динамическая оптимизация

Анализируйте статистику кластеров еженедельно на предмет неэффективных запросов. Добавляйте в минус-фразы запросы с высоким CTR, но нулевой конверсией. Периодически проверяйте минус-фразы и удаляйте те, по которым появились конверсии.

Шаблоны по категориям

Создайте готовые наборы минус-фраз для разных категорий товаров. Применяйте эти шаблоны автоматически при создании новых кампаний. Регулярно обновляйте шаблоны на основе накопленных данных и новых трендов.

---

Поставки и логистика

Переход на ID в методах поставок FBW

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

Изменения в методах

В ответы методов Список поставок и Детали поставки добавлено новое поле statusID — числовой идентификатор статуса поставки.

С 3 ноября 2025 года из ответов API удалены следующие текстовые поля: statusName (название статуса поставки), boxTypeName (название типа поставки), virtualTypeName (название типа виртуальной поставки).

Вместо удалённых полей используйте соответствующие ID: statusID (ID статуса поставки), boxTypeID (ID типа поставки), virtualTypeID (ID типа виртуальной поставки).

Справочники значений

Статусы поставки (statusID)

Типы поставки (boxTypeID)

Типы виртуальной поставки (virtualTypeID)

Пошаговая инструкция миграции

Шаг 1. Обновление кода обработки ответов

Старый формат ответа содержал текстовые поля:

{ "supply_id": "WB-GI-12345678", "statusName": "Принята на склад WB", "boxTypeName": "Короба" }

Новый формат использует числовые ID:

{ "supply_id": "WB-GI-12345678", "statusID": 3, "boxTypeID": 3 }

Шаг 2. Создание справочников маппинга

Создайте в своей системе справочники для маппинга ID в текстовые названия. Включите справочники для всех трёх типов: статусы поставок, типы поставок, типы виртуальных поставок. Используйте таблицы выше для заполнения справочников.

Шаг 3. Обновление пользовательского интерфейса

Замените прямое отображение текстовых полей на маппинг через созданные справочники. При необходимости добавьте локализацию названий для разных языков. Убедитесь, что все места отображения статусов используют новый подход.

Шаг 4. Тестирование

Проверьте корректность маппинга для всех возможных значений ID. Убедитесь в корректном отображении статусов в пользовательском интерфейсе. Протестируйте все статусы поставок в рабочем окружении.

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

Преимущества для бизнеса

Стандартизация работы с поставками упрощает обучение персонала. Закладывается основа для мультиязычной поддержки интерфейса. Более стабильная интеграция за счёт независимости от изменений формулировок.

Преимущества для разработчиков

Упрощение обработки данных благодаря работе с числами вместо строк. Независимость от изменений текстовых формулировок в WB. Возможность гибкой локализации на стороне клиента. Уменьшение риска ошибок парсинга и сравнения строк.

Рекомендации по реализации

Создайте enum или константы для всех возможных значений ID в вашем коде. Используйте строготипизированные языки программирования для защиты от ошибок типизации. Добавьте валидацию неожиданных значений ID с логированием и оповещением. Реализуйте fallback-логику для обработки неизвестных значений ID.

---

Прямое получение стикеров кроссбордера в PDF

WB упрощает процесс получения стикеров для кроссбордерных отправлений. Теперь можно напрямую получать PDF-файлы со стикерами вместо промежуточных ссылок, что ускоряет процесс и повышает надёжность.

Изменения в методах

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

Метод получения ссылок на стикеры сборочных заданий кроссбордера отключён с 23 октября 2025 года.

21 октября в ответ метода добавлено поле parcelId — трек-номер в стикере для отслеживания сборочного задания. Этот номер необходимо сохранять и передавать клиентам для отслеживания международных отправлений.

Формат нового метода

Запрос содержит массив ID заказов:

{ "order_ids": [123456, 123457, 123458] }

Ответ включает PDF-файл в формате base64 и метаданные заказов:

{ "file": "base64_encoded_pdf", "orders": [ { "order_id": 123456, "parcelId": "WB-track-001" }, { "order_id": 123457, "parcelId": "WB-track-002" } ] }

Сравнение подходов

Старый подход (до 23 октября)

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

Новый подход (с 23 октября)

Один запрос сразу возвращает готовый PDF-файл. Не нужно обрабатывать промежуточные ссылки. Отсутствуют проблемы с истечением ссылок. Трек-номера получаются вместе со стикерами в одном запросе.

Пошаговая инструкция миграции

Шаг 1. Замена метода

Удалите использование старого метода получения ссылок. Внедрите вызов нового метода прямого получения PDF. Обновите обработку ответа для работы с base64-encoded контентом.

Шаг 2. Обновление обработки

Принимайте PDF-файл в формате base64 напрямую из ответа. Декодируйте base64-строку и сохраняйте файл локально или отправляйте на печать. Извлекайте массив трек-номеров parcelId из ответа для каждого заказа.

Шаг 3. Сохранение трек-номеров

Создайте связь между order_id и parcelId в вашей базе данных. Используйте parcelId для отслеживания статуса международного отправления. Предоставляйте parcelId клиентам для самостоятельного трекинга посылок.

Шаг 4. Тестирование

Проверьте корректность получаемого PDF-файла. Убедитесь в читаемости QR-кодов и текста на стикерах. Протестируйте массовое получение стикеров для нескольких заказов.

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

Преимущества для бизнеса

Ускорение процесса подготовки кроссбордерных отправлений за счёт устранения промежуточных шагов. Упрощение процесса печати стикеров для персонала. Надёжное получение трек-номеров в одном запросе со стикерами. Улучшение качества трекинга международных отправлений для клиентов.

Преимущества для разработчиков

Упрощение логики получения стикеров за счёт устранения многошаговости. Отсутствие необходимости обработки промежуточных ссылок и таймаутов. Автоматическое связывание заказов с трек-номерами в одном ответе. Единая точка получения всей необходимой информации.

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

Сохраняйте полученные PDF-файлы локально для быстрого доступа при необходимости. Кешируйте соответствие order_id ↔ parcelId в базе данных. Настройте автоматическую отправку на печать сразу после получения стикеров. Интегрируйте parcelId в вашу систему трекинга и клиентский интерфейс.

---

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

Признак неликвидного товара

В методы работы с ценами добавлено новое поле isBadTurnover — признак неликвидного товара. Это поле помогает заранее выявлять товары с низкой оборачиваемостью и принимать корректирующие меры до попадания на автоматическую распродажу.

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

Поле isBadTurnover добавлено в ответы следующих методов: Получить товары с ценами, Получить товары с ценами по артикулам, Получить размеры товара с ценами.

Формат поля

Пример ответа с полем isBadTurnover:

{ "nmId": 123456, "price": 1500, "discount": 10, "isBadTurnover": true }

Важная особенность: поле isBadTurnover отображается только для товаров с низким индексом остатка. Если поле отсутствует в ответе, это означает, что товар не является неликвидным.

Интерпретация значения

Значение isBadTurnover: true указывает на следующие риски. Товар имеет низкий индекс остатка согласно алгоритмам WB. Высокий риск автоматического попадания товара под распродажу. Необходимость пересмотра стратегии закупок и продаж данной позиции. Возможность временной блокировки изменения цен платформой.

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

Преимущества для бизнеса

Раннее предупреждение: Выявление проблемных товаров происходит до их попадания на распродажу. Появляется время для реализации корректирующих действий. Возможность предотвращения вынужденных глубоких скидок.

Оптимизация закупок: Снижение объёмов закупки позиций, показывающих низкую оборачиваемость. Перераспределение закупочного бюджета на более ходовые товары. Анализ причин низкой оборачиваемости для корректировки ассортимента.

Маркетинговые действия: Усиление продвижения неликвидных позиций через рекламные кампании. Создание привлекательных товарных наборов с включением неликвидов. Проведение специальных акций для ускорения продаж проблемных позиций.

Преимущества для разработчиков

Автоматические действия: Автоматическое повышение рекламных ставок на неликвидные товары на 20-30%. Включение товаров в целевые акции и специальные предложения. Создание задач для категорийных менеджеров на пересмотр стратегии.

Аналитика: Создание дашборда неликвидных товаров с динамикой изменений. Отслеживание трендов оборачиваемости по категориям и брендам. Прогнозирование вероятности попадания товаров на распродажу. Измерение эффективности корректирующих мер.

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

Важные меры (1-3 дня)

При обнаружении флага isBadTurnover: true немедленно проверьте актуальность установленной цены товара. Увеличьте рекламный бюджет на 20-30% для повышения видимости. Добавьте товар в блок товарных рекомендаций на популярных позициях. Проверьте качество описания, фотографий и характеристик товара.

Краткосрочные меры (неделя)

Создайте специальную промо-акцию или временную скидку на товар. Включите позицию в привлекательные товарные наборы. Разместите информацию о товаре в push-уведомлениях и рассылках. Проанализируйте цены и предложения конкурентов по данной позиции.

Среднесрочные меры (месяц)

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

---

Заказы и доставка

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

С 5 ноября 2025 года стало обязательным указывать IMEI для всех смартфонов (subjectId: 515) в сборочных заданиях моделей DBW и DBS. Это требование направлено на борьбу с контрафактом и улучшение трекинга устройств.

Затронутые модели и методы

Требование распространяется на две модели доставки: DBW (Delivery by Wildberries) и DBS (Delivery by Seller).

Методы для передачи IMEI: PUT /api/v3/dbw/orders/{orderId}/meta/imei для модели DBW и PUT /api/v3/dbs/orders/{orderId}/meta/imei для модели DBS.

Критические последствия

С 5 ноября 2025 года без указанного IMEI невозможно перевести сборочные задания смартфонов в статус доставки. Заказы без IMEI будут автоматически отменяться системой. За нарушение SLA (невозможность отгрузки) будут начисляться штрафы. Может произойти полная блокировка отгрузок смартфонов до устранения проблемы.

Инструкция по внедрению

Технические требования

Внедрите передачу IMEI в API в вашей системе управления заказами. Настройте автоматическое или ручное считывание IMEI с упаковок устройств. Реализуйте валидацию формата IMEI (ровно 15 цифр) перед отправкой. Протестируйте процесс на тестовых заказах смартфонов.

Организационные меры

Обучите складской персонал процедурам работы с IMEI. Подготовьте письменные инструкции с примерами и частыми ошибками. Организуйте систему контроля качества заполнения IMEI. Настройте систему мониторинга заказов смартфонов без IMEI.

Проверка готовности

Создайте тестовый заказ смартфона в вашей системе. Отправьте IMEI через соответствующий API метод. Переведите заказ в статус доставки. Убедитесь в успешной отгрузке без ошибок.

Требования к формату IMEI

IMEI должен содержать ровно 15 цифр. Допустимы только цифры от 0 до 9. Недопустимы пробелы, дефисы и другие специальные символы.

Примеры корректного и некорректного формата:

• Правильно: 123456789012345
• Неправильно: 123 456 789 012 345 (содержит пробелы)
• Неправильно: 12345678901234 (только 14 цифр)
• Неправильно: 123-456-789-012-345 (содержит дефисы)

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

Автоматизация процесса

Интегрируйте сканеры штрихкодов для автоматического считывания IMEI. Настройте автоматическую отправку считанного IMEI в API без ручного ввода. Реализуйте очередь отправки с повторными попытками на случай временных сбоев API.

Система контроля

Внедрите ежедневный автоматический отчёт по всем заказам смартфонов. Настройте алерты на заказы смартфонов без IMEI старше 2 часов с момента создания. Создайте дашборд с отображением процента заказов с корректно указанным IMEI.

Резервные процедуры

Предусмотрите процедуру ручного ввода IMEI при сбое сканирующего оборудования. Установите контрольные точки проверки IMEI перед финальной отгрузкой. Ведите журнал проблемных случаев с анализом причин и мерами по устранению.

---

Уточнение информации о покупателе

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

Обновлённые поля

Следующие поля могут содержать пустые строки в ответе API: replacementPhone (подменный телефон для связи с покупателем), phone (основной телефон покупателя), additionalPhoneCodes (добавочные коды для связи), phoneCode (код региона телефона).

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

Пример ответа API

{ "order_id": 123456, "customer": { "replacementPhone": "", "phone": "", "additionalPhoneCodes": "", "phoneCode": "" }, "status": "new" }

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

Преимущества для бизнеса

Правильное понимание статуса обработки заказа платформой. Корректное планирование времени для первого контакта с клиентом. Исключение ошибок при попытках связи с клиентом до готовности контактов.

Рекомендации по реализации

Всегда проверяйте наличие телефонных номеров перед попыткой звонка клиенту. Не обрабатывайте пустые строки как системную ошибку или проблему API. Опрашивайте метод периодически до получения валидных номеров. Настройте разумный таймаут ожидания назначения номеров (обычно 5-15 минут). Логируйте случаи длительного отсутствия номеров для анализа проблем.

---

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

Детализация к ежедневным отчётам реализации

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

Новый параметр запроса

Для получения ежедневной детализации используйте параметр period=daily в запросе:

{ "dateFrom": "2025-10-01", "dateTo": "2025-10-31", "period": "daily" }

Доступные значения параметра period: daily (ежедневная детализация, новая возможность), weekly (еженедельная детализация).

Формат ответа

Ответ содержит массив отчётов с разбивкой по дням:

{ "reports": [ { "date": "2025-10-01", "sales": [ { "nm_id": 123456, "quantity": 5, "revenue": 7500, "commission": 1125 } ], "total_revenue": 7500, "total_commission": 1125 }, { "date": "2025-10-02", "sales": [] } ] }

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

Преимущества для бизнеса

Ежедневный анализ: Отслеживание динамики продаж по дням в режиме, близком к реальному времени. Быстрое выявление аномалий и нестандартных ситуаций в продажах. Оперативная реакция на изменения спроса и рыночной ситуации.

Финансовое планирование: Ежедневный учёт поступающей выручки для точного cash flow. Детальный контроль движения денежных средств. Улучшенное прогнозирование платежей и поступлений.

Оперативное управление: Корректировка объёмов закупок на основе актуальных данных о продажах. Быстрое управление ценами и скидками при изменении спроса. Своевременная оценка эффективности маркетинговых акций.

Преимущества для разработчиков

Автоматизация отчётности: Ежедневная автоматическая загрузка данных в учётную систему. Формирование управленческих отчётов без ручного труда. Бесшовная интеграция с BI-системами и дашбордами.

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

Рекомендации по использованию

Запрашивайте данные раз в сутки в 6:00 утра для получения полных данных за предыдущий день. Дополнительно выполняйте еженедельные запросы для сверки с недельными отчётами. В конце каждого месяца проводите полную сверку для закрытия финансового периода. Храните исторические данные для построения долгосрочных трендов и прогнозов.

---

Новые отчёты о занижении габаритов

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

Доступные отчёты

Удержания за занижение габаритов упаковки

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

Замеры склада

Детальные данные о фактических замерах габаритов, проведённых на складах WB. Позволяет сравнить заявленные размеры с измеренными и выявить систематические ошибки.

Формат отчёта

Пример данных из отчёта:

{ "penalties": [ { "nm_id": 123456, "declared_dimensions": { "length": 30, "width": 20, "height": 10 }, "actual_dimensions": { "length": 35, "width": 25, "height": 12 }, "penalty_amount": 150, "measurement_date": "2025-10-15" } ] }

Причины удержаний

Занижение габаритов фиксируется в следующих случаях. Фактические размеры упакованного товара превышают заявленные в карточке. Разница между заявленными и фактическими размерами превышает допустимую погрешность. Неправильная или нестандартная упаковка товара увеличивает его габариты.

Последствия занижения габаритов включают штрафные удержания из выплат продавцу. Неправильный расчёт логистических затрат влияет на рентабельность. Возникают проблемы с размещением товаров на складе WB.

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

Преимущества для бизнеса

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

Финансовый контроль: Учёт всех удержаний в себестоимости товаров для правильного ценообразования. Анализ причин дополнительных расходов по категориям товаров. Оптимизация процессов упаковки для снижения штрафов.

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

Преимущества для разработчиков

Автоматизация: Ежедневная автоматическая загрузка отчётов для оперативного контроля. Настройка автоматических уведомлений менеджерам о новых штрафах. Интеграция с системой контроля качества для создания задач на исправление.

Аналитика: Создание дашборда штрафов с разбивкой по категориям товаров и поставщикам. Отслеживание трендов количества удержаний для оценки эффективности мер. Формирование топа товаров с наибольшими проблемами габаритов.

Рекомендации по снижению штрафов

Точность карточек товаров

Всегда измеряйте товары в полностью упакованном виде перед внесением в карточку. Учитывайте все защитные материалы (пузырчатую плёнку, поролон, картонные уголки). Добавляйте запас 1-2 см на каждую сторону для учёта погрешности упаковки.

Стандартизация процессов

Используйте стандартные упаковочные решения для однотипных товаров. Документируйте процессы упаковки с фотоинструкциями. Регулярно обучайте и переобучайте персонал правильной упаковке. Внедрите систему контроля габаритов перед отгрузкой новых позиций.

Система мониторинга

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

---

Аналитика и данные

Воронка продаж v3

WB выпускает новую версию методов Воронки продаж с расширенным набором метрик, улучшенной пагинацией и поддержкой анализа поведения участников программы лояльности WB Клуб. Это существенное обновление, требующее миграции до 9 декабря 2025 года.

Новые методы версии v3

Статистика карточек товаров за период

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

Статистика карточек товаров по дням

Метод предоставляет посуточную детализацию всех метрик для анализа динамики показателей во времени.

Статистика групп карточек товаров по дням

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

Все методы версии v2 будут отключены 9 декабря 2025 года.

Основные нововведения версии v3

Расширенный список метрик

Добавлены новые метрики эффективности карточек товаров и более детальные показатели конверсии на каждом этапе воронки продаж.

Метрики программы лояльности WB Клуб

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

Улучшенная пагинация

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

Очистка ответов

Из успешных ответов с кодом 200 удалены поля с информацией об ошибках, что упрощает обработку данных.

Новое поле addToWishList

Добавлено отслеживание добавлений товаров в избранное. Поле присутствует в моделях SalesFunnelProductRes, SalesFunnelGroupRes и методе получения отчёта аналитики продавца в формате CSV.

Структура новых метрик

Базовые метрики карточки

{ "nm_id": 123456, "period": { "start": "2025-10-01", "end": "2025-10-31" }, "metrics": { "views": 15000, "addToCart": 450, "orders": 120, "addToWishList": 230 } }

Метрики участников WB Клуба

{ "wb_club": { "views": 3000, "addToCart": 120, "orders": 35, "conversion_rate": 1.17 } }

Пошаговая инструкция миграции

До 9 декабря 2025 года необходимо выполнить следующие шаги.

Шаг 1. Обновление эндпоинтов

Замените версию v2 на v3 во всех запросах к воронке продаж. Старый формат: /api/v2/sales-funnel/products. Новый формат: /api/v3/sales-funnel/products.

Шаг 2. Обновление механизма пагинации

Старая пагинация в v2 использовала страницы:

{ "page": 1, "limit": 100 }

Новая курсорная пагинация в v3:

{ "cursor": "eyJwYWdlIjoxfQ==", "limit": 100 }

Шаг 3. Добавление обработки новых метрик

Добавьте в вашу систему обработку метрики addToWishList для анализа интереса к товарам. Если ваш бизнес использует программу WB Клуб, внедрите обработку метрик участников программы. Обновите хранилище данных для сохранения расширенных метрик конверсии.

Шаг 4. Обновление логики обработки ошибок

В версии v3 ошибки не возвращаются в теле успешных ответов. Обрабатывайте HTTP-статусы для определения успешности запроса. Читайте информацию об ошибках из тела ответа только при статусах 4xx и 5xx.

Шаг 5. Тестирование

Запросите одни и те же данные через v2 и v3 для сравнения результатов. Проверьте корректность работы курсорной пагинации на больших датасетах. Убедитесь в правильной обработке всех новых полей в вашей системе.

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

Преимущества для бизнеса

Анализ программы лояльности: Сравнение покупательского поведения участников WB Клуба и обычных покупателей. Количественная оценка эффективности программы лояльности для вашего бизнеса. Возможность создания целевых акций и предложений для участников программы.

Оптимизация воронки продаж: Отслеживание добавлений товаров в избранное как дополнительный индикатор интереса. Выявление узких мест конверсии на каждом этапе воронки. Проведение A/B тестирования различных вариантов карточек товаров.

Стратегическое планирование: Анализ долгосрочных трендов по различным категориям товаров. Выявление сезонности и цикличности продаж по группам товаров. Улучшенное прогнозирование спроса на основе расширенных метрик.

Преимущества для разработчиков

Расширенная аналитика: Создание детальных дашбордов с метриками поведения участников WB Клуба. Когортный анализ покупателей по различным сегментам. Построение полных воронок продаж с учётом добавлений в избранное.

Оптимизация производительности: Использование курсорной пагинации для эффективной работы с большими объёмами данных. Возможность параллельной загрузки данных по разным товарам. Инкрементальные обновления данных вместо полной перезагрузки.

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

Начните миграцию заранее, за месяц до дедлайна 9 декабря, для выявления возможных проблем. Запускайте запросы к v2 и v3 параллельно в течение переходного периода для сравнения данных. Настройте мониторинг и алерты на новые метрики для отслеживания изменений. Обучите аналитиков и менеджеров работе с новыми метриками WB Клуба.

---

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

Упрощение методов вопросов

27 октября 2025 года из ответов методов Получение списка вопросов и Получение вопроса по ID отключено неиспользуемое поле size.

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

Если ваша система использовала поле size, удалите его обработку из кода. Поле больше не возвращается в ответах API. Это изменение не влияет на основную функциональность работы с вопросами покупателей.

---

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

WB оптимизирует API общения с покупателями, отключая устаревшие методы управления шаблонами ответов. Это требует перехода на альтернативные решения до 19 ноября 2025 года.

Отключаемые методы

С 19 ноября 2025 года будут недоступны следующие методы: получить шаблоны ответов на вопросы и отзывы, создать новый шаблон ответа, редактировать существующий шаблон, удалить шаблон из системы.

Альтернативные решения

Локальное хранение шаблонов

Храните все шаблоны ответов в собственной системе управления. Варианты хранения: реляционная или документоориентированная база данных, CRM-система с функционалом шаблонов, специализированное файловое хранилище.

Прямая отправка ответов

Используйте методы прямой отправки ответов без промежуточного сохранения в WB. Доступные методы: Ответить на вопрос и Ответить на отзыв.

Интеграция с внешними системами

Рассмотрите возможность использования внешних решений для управления шаблонами. Варианты: специализированные helpdesk системы, CRM с встроенным функционалом шаблонов, сервисы для работы с обратной связью клиентов.

Пошаговая инструкция миграции

До 19 ноября 2025 года выполните следующие действия.

Шаг 1. Выгрузка существующих шаблонов

Получите все текущие шаблоны через API WB пока он доступен. Сохраните полное содержимое каждого шаблона. Сохраните все метаданные: категории, теги, статистику использования.

Шаг 2. Реализация локального хранения

Создайте структуру таблицы или коллекции для хранения шаблонов в вашей БД. Реализуйте полный набор CRUD операций для управления шаблонами. Добавьте функционал поиска и фильтрации шаблонов по различным критериям.

Шаг 3. Обновление процесса ответов

Реализуйте выбор подходящего шаблона из локального хранилища. Добавьте возможность адаптации текста шаблона перед отправкой. Настройте прямую отправку ответов через методы API WB.

Шаг 4. Тестирование

Проверьте доступность всех сохранённых шаблонов в новой системе. Убедитесь в корректной отправке ответов покупателям. Протестируйте функции поиска и подстановки шаблонов.

Рекомендуемая структура хранения

Пример структуры записи шаблона:

{ "template_id": "local_001", "category": "shipping", "title": "Срок доставки", "text": "Здравствуйте! Обычно доставка занимает 3-5 дней...", "variables": ["shipping_days", "city"], "usage_count": 145, "last_used": "2025-10-30T10:00:00Z" }

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

Преимущества для бизнеса

Полный контроль над содержимым и структурой шаблонов ответов. Возможность создания расширенной аналитики использования шаблонов. Гибкая кастомизация системы шаблонов под специфику вашего бизнеса. Независимость от изменений в API WB.

Преимущества для разработчиков

Максимальная гибкость в управлении и организации шаблонов. Возможность версионирования шаблонов и отката к предыдущим версиям. Простая интеграция с существующими системами и процессами. Расширенная функциональность: условная логика, переменные, автоподстановка.

Рекомендации по реализации

Добавьте многоуровневую категоризацию шаблонов для удобной навигации. Реализуйте полнотекстовый поиск по содержимому и ключевым словам. Ведите детальную статистику использования каждого шаблона для оптимизации. Настройте гранулярные права доступа по ролям пользователей. Внедрите систему предложений новых шаблонов от сотрудников.

---

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

Критические изменения

С 23 октября 2025

Переход на создание кампаний типа 9 с обязательным указанием bid_type. Миграция на прямое получение PDF стикеров кроссбордера без промежуточных ссылок.

С 3 ноября 2025

Замена обработки текстовых полей на числовые ID в методах поставок FBW. Создание внутренних справочников для маппинга ID в читаемые названия.

С 5 ноября 2025

Внедрение обязательной передачи IMEI для всех заказов смартфонов. Настройка системы мониторинга и контроля заказов смартфонов без IMEI.

До 19 ноября 2025

Выгрузка всех шаблонов ответов из API WB до их отключения. Реализация локального хранилища шаблонов в собственной системе.

До 9 декабря 2025

Миграция на воронку продаж v3 со всеми новыми методами. Обновление логики пагинации на курсорную модель. Добавление обработки метрик программы лояльности WB Клуба.

Меры по внедрению

Использование новых методов управления ставками поисковых кластеров для точной оптимизации бюджета. Настройка централизованного управления минус-фразами через обновлённые методы. Внедрение системы мониторинга поля isBadTurnover для раннего выявления неликвидов. Подключение ежедневной детализации отчётов реализации для оперативного учёта. Настройка регулярного мониторинга отчётов о занижении габаритов упаковки. Обработка и сохранение трек-номеров parcelId в стикерах кроссбордера. Работа с новым полем addToWishList в аналитике воронки продаж.

---

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

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

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

Готовая Postman коллекция

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

---

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