Дайджест WB API — Июль 2025

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

1015

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

content

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

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

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

Получайте полный набор информации по запросам клиентов

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

  • date — дата заказа
  • needRefund — запрошен ли возврат товара
  • nmID — артикул WB
  • price — фактическая цена с учётом всех скидок
  • priceCurrency — валюта
  • rid — уникальный ID заказа
  • size — размер товара
  • statusID — статус товара

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

Представьте типичную ситуацию: покупатель пишет «У меня проблема с заказом». Раньше менеджеру приходилось запрашивать номер заказа, затем искать его в системе, уточнять детали. Теперь вся информация доступна с момента обращения. Это сократит время работы над обращением, что важно как для продавца, так и для покупателя.

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

Новые поля открывают широкие возможности для создания интеллектуальных систем автоматизации:

  1. Автоматическая категоризация обращений: Используя поле needRefund, можно автоматически маршрутизировать чаты о возвратах в специализированный отдел или к конкретным специалистам.
  2. Интеграция с CRM-системами: Передавайте полный контекст заказа в вашу CRM, создавая тикеты с предзаполненными полями.
  3. Создание чат-ботов: Разработайте интеллектуальных ботов, которые могут давать персонализированные ответы, основываясь на статусе заказа и цене товара.
  4. Аналитика качества товаров: Собирайте статистику по nmID для выявления проблемных товаров, генерирующих больше всего обращений.

DBS и Самовывоз

Новые функции для песочницы

В песочнице для моделей DBS и Самовывоз появились важные поля для работы с международными продажами:

Для DBS и Самовывоз:

  • finalPrice — цена в валюте продажи с учётом всех скидок, умноженная на 100
  • convertedFinalPrice — цена в валюте страны продавца с учётом всех скидок, умноженная на 100

Дополнительно для Самовывоз:

  • convertedPrice — цена в валюте страны продавца с учётом всех скидок, кроме скидки по WB Кошельку, умноженная на 100
  • convertedCurrencyCode — код валюты страны продавца

Эти изменения затронули методы:

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

Для компаний, работающих на международных рынках Wildberries, эти поля решают проблему финансового учёта. Рассмотрим реальный кейс: российская компания продает товары в Казахстане. Покупатель платит в тенге, но бухгалтерия ведет учёт в рублях. Новые поля позволяют:

  1. Точный расчет выручки. Автоматически получать конвертированные суммы без необходимости самостоятельно отслеживать курсы валют на момент транзакции.
  2. Анализ эффективности скидок. Поле convertedPrice для Самовывоза показывает цену без учёта скидки WB Кошелька, что позволяет точно рассчитать влияние программы лояльности на маржинальность.
  3. Безопасное тестирование. Все эти данные доступны в песочнице, что позволяет полностью отладить финансовые интеграции без риска для реальных данных.

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

  1. Автоматизация бухгалтерского учёта. Создайте прямую интеграцию с 1С или другими ERP-системами, передавая уже конвертированные суммы. Это исключает необходимость в дополнительных расчётах конвертации валют.
  2. Мультивалютные дашборды. Разработайте системы отчётности, которые могут показывать выручку как в валюте продажи, так и в базовой валюте компании, без дополнительных вычислений.

Документы и бухгалтерия

Прозрачная программа лояльности в финансовой отчётности

В детализации еженедельных отчётов реализации появились два ключевых поля:

  • cashback_amount — сумма, удержанная за начисленные баллы программы лояльности
  • cashback_discount — компенсация скидки по программе лояльности

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

Программы лояльности Wildberries — это мощный инструмент привлечения покупателей. Новые поля решают эту проблему:

  1. Точный расчет unit-экономики. Теперь можно точно рассчитать, сколько стоит привлечение и удержание клиента через программу лояльности. Например, если cashback_amount составляет 5% от оборота, а конверсия повторных покупок увеличилась на 15%, ROI программы становится прозрачнее.
  2. Оптимизация ценообразования. Зная точные суммы компенсаций, можно корректировать базовые цены товаров, чтобы сохранить целевую маржинальность даже с учётом кешбэка.
  3. Налоговая оптимизация. Четкое разделение удержаний и компенсаций упрощает налоговый учёт и подготовку отчётности.

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

  1. Автоматизация финансового анализа. Интегрируйте новые поля в системы BI для создания автоматических отчётов о влиянии программ лояльности на прибыль.
  2. Предиктивная аналитика. Используйте исторические данные по кешбэку для прогнозирования будущих расходов на программу лояльности.
  3. Интеграция с ERP. Автоматически передавайте данные о кешбэке в системы учёта для корректного отражения в финансовой отчётности.

Отчёты

Полный цикл управления возвратами

Метод Отчёт о возвратах и перемещении товаров дополнился пятью полями:

  • reason — причина возврата
  • orderId — номер сборочного задания
  • readyToReturnDt — дата и время готовности возврата к выдаче
  • expiredDt — дата и время истечения срока хранения возврата
  • completedDt — дата и время выдачи возврата продавцу

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

Возвраты — это ценный источник данных о качестве товаров и удовлетворённости клиентов. Новые поля трансформируют управление возвратами:

  1. Анализ причин возвратов. Поле reason позволяет систематизировать причины и выявлять паттерны. Если 30% возвратов конкретного товара происходит из-за несоответствия размера, это сигнал к корректировке размерной сетки или описания.
  2. Оптимизация логистики возвратов. Поля с временными метками (readyToReturnDt, expiredDt, completedDt) позволяют отслеживать SLA и оптимизировать процессы. Если средний срок между readyToReturnDt и completedDt составляет 5 дней, а срок хранения — 7 дней, следует обратить внимание на логистику.
  3. Минимизация потерь. Отслеживание expiredDt критично для предотвращения утери товаров из-за истечения срока хранения. Автоматические уведомления за 2-3 дня до истечения срока могут сэкономить большие суммы.

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

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

Заказы FBS

Добавили сроки годности для товаров

С 21 июля появилась возможность указывать срок годности товаров в метаданных сборочных заданий FBS. Это решение включает несколько методов:

Важное ограничение: удалить срок годности из метаданных невозможно, только изменить на новую дату.

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

Для продавцов продуктов питания, косметики, БАДов это нововведение по-настоящему революционно:

  1. Снижение рисков. Автоматическое отслеживание сроков годности минимизирует риск отправки просроченных товаров, что может привести к большим штрафам.
  2. Управление ротацией товаров: Система позволяет реализовывать принцип FIFO (First In, First Out) на уровне API, автоматически приоритизируя отправку залежавшихся товаров

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

  1. Автоматизация контроля качества: Создайте систему, которая автоматически проверяет наличие поля expiration в requiredMeta и блокирует отправку просроченных товаров.
  2. Интеллектуальная приоритизация. Разработайте алгоритмы, которые автоматически сортируют заказы по остатку сроку годности и предлагают оптимальную последовательность сборки.

Синхронизация складов: предотвращение проблем с логистикой

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

  1. Поле officeID (ID склада WB, к которому привязан склад продавца) в методах:
  1. Поле destinationOfficeId (ID склада назначения поставки) в методах:

Важное изменение с 1 сентября 2025: Метод добавления сборочных заданий в поставку будет возвращать ошибку 409, если officeID сборочного задания не совпадает с destinationOfficeID поставки.

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

Это изменение предотвращает логистические ошибки:

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

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

Географическая детализация по складам

В методе получения складов WB появилось поле federalDistrict — федеральный округ РФ для склада WB. Значение null указывает на расположение склада за пределами РФ или отсутствие информации об округе.

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

Географическая сегментация открывает новые возможности для оптимизации:

  1. Региональное планирование поставок. Анализируйте распределение складов по федеральным округам для оптимального размещения товарных запасов. Если 40% ваших продаж приходится на ЦФО, а складов там только 20% — это сигнал к перераспределению.
  2. Снижение логистических затрат: Выбирайте склады в тех округах, где сконцентрирована ваша целевая аудитория, сокращая расходы на «последнюю милю».

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

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

Поставки FBW

Новые флаги для складов

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

  • isActive — доступен ли склад в качестве склада назначения
  • isTransitActive — доступен ли склад в качестве транзитного

Также с 14 июля установлен лимит для метода получения опций приёмки — 6 запросов в минуту.

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

Динамические флаги доступности решают операционные задачи:

  1. Адаптивная логистика. В периоды пиковых нагрузок (чёрная пятница, Новый год, гендерные праздники) склады могут быть временно переполнены. Флаги позволяют автоматически перенаправлять потоки на доступные локации.
  2. Оптимизация транзитных маршрутов: Флаг isTransitActive позволяет строить сложные маршруты через транзитные склады, сокращая время доставки на 20-30%.

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

  1. Принцип «устойчивой деградации». При недоступности основных складов автоматически переключайтесь на транзитные, обеспечивая непрерывность операций.
  2. Соблюдайте rate limit. Установите exponential backoff и очереди запросов для соблюдения лимитов без потери функциональности.

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

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

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

  • Проверьте все интеграции на совпадение officeID и destinationOfficeId

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

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

Заключение

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

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

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