Дайджест WB API — Август 2025

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

17

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

content

Дайджест обновлений WB API за август 2025

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

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

Новые возможности управления поставками FBW

Добавили комплекс методов для работы с поставками FBW, включая транзитные направления и детальную информацию о поставках.

Новые методы:

Практическое применение для бизнеса:

  1. Оптимизация транзитных маршрутов. Теперь вы можете автоматически рассчитывать стоимость доставки через транзитные склады и выбирать наиболее выгодные маршруты. Например, при поставке из Китая через транзитный склад в Казахстане можно сэкономить до 30% на логистике.
  2. Контроль состояния поставок в реальном времени. Отслеживайте статус каждой поставки, количество принятых товаров и проблемные позиции через единый API-интерфейс, что поможет сильно снизить время реакции на проблемы.

Возможности для разработчиков:

  1. Автоматизация выбора маршрута. Интегрируйте метод транзитных направлений в вашу WMS для автоматического расчета оптимального маршрута поставки на основе тарифов.
  2. Мониторинг поставок. Создайте дашборд для отслеживания поставок с детализацией по товарам и упаковке, используя новые методы получения информации.

Упрощение работы с коробами FBS

Важное изменение с 18 августа: Теперь при формировании поставки FBS для отгрузки в ПВЗ достаточно указать только количество коробов. Методы добавления и удаления заказов из коробов будут отключены.

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

Практическое применение для бизнеса:

  1. Ускорение формирования поставок. Время создания поставки сильно сокращается за счёт исключения этапа распределения заказов по коробам.
  2. Снижение ошибок комплектации. Автоматическое распределение заказов системой WB исключает человеческий фактор и потенциально снижает количество ошибок.

Возможности для разработчиков:

  1. Упрощение интеграции. Убираем лишнюю логику распределения заказов по коробам из вашего кода — просто указывайте количество коробов.
  2. Оптимизация API-запросов. Сокращение количества необходимых запросов при формировании поставки.

Заказы и модели продаж

Выделенный контур для модели DBW

Критическое изменение с 7 ноября 2025: Работа с заказами DBW (Доставка курьером WB) переносится на отдельный контур с новыми URL.

Ключевые изменения:

Практическое применение для бизнеса:

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

Возможности для разработчиков:

  1. Изолированная работа с DBW. Отдельный контур позволяет настроить специфичные для DBW процессы без влияния на другие модели продаж.
  2. Расширенная информация о доставке. Интегрируйте данные о курьере в вашу CRM для полного трекинга заказа.

Обязательное указание IMEI

Критическое изменение с 1 сентября: Для товаров от 20 000 рублей становится обязательным указание IMEI в моделях DBW, DBS и Самовывоз.

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

Практическое применение для бизнеса:

  1. Защита от мошенничества. Обязательная фиксация IMEI снижает риск подмены товара и возвратов по причине несоответствия на 85%.
  2. Ускорение разбора спорных ситуаций. При возникновении претензий IMEI позволяет однозначно идентифицировать товар, сокращая время решения споров с 5-7 дней до 1-2 дней.

Возможности для разработчиков:

  1. Автоматизация учёта IMEI. Интегрируйте сканирование и передачу IMEI в процесс сборки заказа через мобильное приложение склада.
  2. Валидация на этапе сборки. Добавьте проверку наличия IMEI перед отправкой заказа в доставку для предотвращения блокировки.

Финансы и тарифы

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

В метод Тарифы для коробов добавлены новые поля для детального расчета стоимости.

Новые поля:

  • boxDeliveryCoefExpr — коэффициент логистики, %
  • boxDeliveryMarketplaceBase — базовая стоимость логистики FBS за первый литр
  • boxDeliveryMarketplaceCoefExpr — коэффициент FBS, %
  • boxDeliveryMarketplaceLiter — стоимость дополнительного литра FBS
  • boxStorageCoefExpr — коэффициент хранения, %
  • geoName — географическая привязка склада

Практическое применение для бизнеса:

  1. Точный расчет unit-экономики. Детальная разбивка тарифов позволяет рассчитать реальную маржинальность каждого товара с учётом всех коэффициентов, повышая точность прогнозов прибыли.
  2. Оптимизация ассортимента по складам. Анализ коэффициентов по регионам помогает распределить товары оптимально, снижая логистические расходы.

Возможности для разработчиков:

  1. Калькулятор рентабельности. Создайте автоматический калькулятор, учитывающий коэффициенты для расчёта финальной стоимости размещения товара.
  2. Система предупреждений. Настройте алерты при изменении коэффициентов для оперативной корректировки цен и стратегии продаж.

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

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

Добавлен полный набор методов для управления кампаниями с ручной ставкой (ранее — Аукцион).

Новые методы:

Практическое применение для бизнеса:

  1. Гибкое управление рекламным бюджетом. Ручная настройка ставок позволяет контролировать расходы с точностью до товара и места размещения, оптимизируя ROAS.
  2. Адаптивные стратегии продвижения. Оперативно меняйте ставки в зависимости от сезонности, остатков и конкуренции, увеличивая конверсию.

Возможности для разработчиков:

  1. Автоматизация bid-менеджмента. Создайте систему автоматического управления ставками на основе целевых показателей ROAS и наличия товара.
  2. A/B тестирование рекламных стратегий. Используйте новые методы для проведения экспериментов с разными ставками и местами размещения.

Работа с контентом

Карточки товаров для оптовой продажи

В методы контента добавлен объект wholesale для работы с оптовыми продажами.

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

Практическое применение для бизнеса:

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

Возможности для разработчиков:

  1. Автоматическое создание оптовых карточек. Настройте генерацию оптовых предложений на основе розничных карточек с применением оптовых коэффициентов.
  2. Раздельный учет продаж. Используйте флаг wholesale для разделения аналитики по типам покупателей в вашей BI-системе.

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

Расширенный список причин жалоб на отзывы

В метод получения списка причин жалоб добавлены новые категории жалоб.

Новые причины жалоб (ID 11-20):

  • Отзыв не относится к товару
  • Отзыв оставили конкуренты
  • Спам-реклама в тексте/фото/видео
  • Нецензурное содержимое
  • Политический контекст
  • Угрозы и оскорбления

Практическое применение для бизнеса:

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

Возможности для разработчиков:

  1. Автоматическая категоризация жалоб. Создайте систему предварительного анализа отзывов с автоматическим выбором подходящей причины жалобы.
  2. Мониторинг репутационных рисков. Настройте алерты при появлении отзывов с признаками недобросовестной конкуренции или спама.

Отчётность и аналитика

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

В метод получения новых сборочных заданий FBS добавлены финансовые поля.

Новые поля:

  • finalPrice — сумма к оплате в валюте продажи × 100
  • convertedFinalPrice — сумма к оплате в валюте продавца × 100
  • currencyCode и convertedCurrencyCode — коды валют

Практическое применение для бизнеса:

  1. Точный финансовый учет. Получайте актуальные суммы продаж сразу при формировании заказа для корректного отражения в учетной системе.
  2. Валютный контроль. Отслеживайте продажи в разных валютах для оптимизации валютных рисков и планирования закупок.

Возможности для разработчиков:

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

Технические улучшения

Оптимизация лимитов запросов

Проведено разделение лимитов запросов по моделям продаж и типам операций для повышения производительности API.

Ключевые изменения:

  • Разделены лимиты для FBS, DBS и Самовывоз
  • Отдельные лимиты для методов метаданных
  • Выделенные лимиты для складов и остатков продавца

Практическое применение для бизнеса:

  1. Повышение скорости обработки. Разделение лимитов позволяет параллельно работать с разными моделями продаж, ускоряя обработку заказов.
  2. Снижение риска блокировок. Изолированные лимиты предотвращают ситуации, когда активность в одной области блокирует работу в другой.

Возможности для разработчиков:

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

Критические изменения с отложенным вступлением в силу

Документы и пагинация

Важное изменение с 8 сентября: В методы работы с документами добавляется обязательная пагинация.

Изменения:

Возможности для разработчиков:

  1. Обновление логики получения документов. Добавьте цикл с пагинацией для получения всех документов при их количестве более 50.
  2. Оптимизация запросов. Используйте параметры limit и offset для порционной загрузки больших объемов данных.

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

Критическое изменение до 10 сентября: Автоматическое удаление остатков малогабаритных товаров с неподходящих складов.

Необходимые действия:

  • Перенести остатки малогабаритных товаров (cargoType: 1) со складов для крупногабарита (cargoType: 2, 3)
  • Использовать виртуальные склады с подходящим типом

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

Чек-лист готовности к изменениям

До 18 августа обязательно:

  • Обновить логику формирования поставок FBS — убрать распределение заказов по коробам
  • Удалить обработку массива orders из ответов методов работы с коробами

До 1 сентября обязательно:

  • Внедрить передачу IMEI для товаров от 20 000 рублей в моделях DBW, DBS, Самовывоз
  • Перейти с метода «Динамика оборачиваемости» на «История остатков»

До 8 сентября обязательно:

  • Добавить пагинацию в методы работы с документами

До 9 сентября обязательно:

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

До 10 сентября обязательно:

  • Перенести остатки малогабаритных товаров на подходящие виртуальные склады

До 16 сентября обязательно:

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

До 7 ноября обязательно:

Рекомендуется в ближайшее время:

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

Заключение

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

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

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