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

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

Publication date: 09.07.2025

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

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

Заказы FBS и Самовывоз

Новые инструкции и тестовые среды

В июне команда WB API выпустила детализированную инструкцию по FBS и Самовывоз.

Новые инструкции включает в себя:

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

Новая инструкция должна упростить интеграцию и понимание принципов работы с моделью FBS даже для тех, кто не имеет богатого опыта работы с API.

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

Немаловажным дополнением стал запуск песочницы для тестирования заказов FBS. Теперь разработчики могут проверять работу всех методов в тестовом окружении, прежде чем интегрировать их в свои рабочие процессы.

Что именно вы можете протестировать в новой песочнице:

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

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

Появление песочницы для заказов Самовывоз

Как и в случае с FBS, Wildberries представил отдельную песочницу для заказов Самовывоз. Теперь перед началом полноценной интеграции все методы можно проверить в безопасной тестовой среде, избегая ошибок и сбоев.

Что доступно для тестирования:

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

Кроме того, в рамках песочницы вы можете протестировать и другие полезные методы управления складами и остатками товаров, аналогично песочнице для модели FBS.

Для удобства разработчиков были добавлены отдельные тестовые методы создания и отмены сборочных заданий Самовывоз:

Новые инструкции и песочницы позволят вам с минимальными усилиями и рисками интегрировать заказы по моделям FBS и Самовывоз в ваши рабочие процессы и значительно ускорить подготовку и запуск новых проектов.

Заказы DBS

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

В июне команда WB API добавила в DBS-заказы важное нововведение, которое упрощает коммуникацию с покупателями. Теперь в методе получения информации о клиенте доступно дополнительное поле — replacementPhone. Оно содержит основной контактный номер покупателя и полностью избавляет от необходимости использовать добавочные номера, что ранее могло приводить к путанице или неудобствам.

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

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

Дополнительные данные о ценах в сборочных заданиях DBS и Самовывоз

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

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

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

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

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

Новые поля добавлены в следующие методы API:

Изменения в бухгалтерии и отчётности

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

Ещё одно важное обновление — появление нового метода для работы с балансом продавца через API. Теперь баланс, который вы видите в личном кабинете продавца на главной странице, доступен и через специальный API-метод. Доступ к методу осуществляется по токену с категорией «Финансы».

Подробности использования нового метода описаны в Журнале изменений и в документации WB API.

Обновления в еженедельных отчётах реализации

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

sale_percent (итоговая скидка)
product_discount_for_report (продуктовый дисконт)
supplier_promo (промокод)
ppvz_spp_prc (скидка постоянного покупателя)
ppvz_kvw_prc_base (базовый коэффициент вознаграждения WB без НДС)
ppvz_kvw_prc (итоговый коэффициент вознаграждения WB без НДС)
sup_rating_prc_up (снижение вознаграждения из-за рейтинга)
Также из отчёта удалено устаревшее поле rid, ставшее ненужным из-за изменений внутренней логики отчёта.

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

Новые возможности аналитики

Расширенные возможности поиска товаров по подменным артикулам

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

В методах поиска и аналитики появились следующие параметры:

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

Важно, что оба параметра не могут одновременно принимать значение false.

Кроме того, в ответы добавлено специальное поле:

isSubstitutedSKU — показывает, искали ли товар по подменному артикулу. Это позволяет лучше понимать, по каким именно запросам товар чаще всего находят покупатели.

Эти нововведения поддерживаются в следующих методах:

Повышенные лимиты для продвинутых продавцов и новые условия доступа

Помимо новых фильтров, Wildberries также расширил лимиты по аналитическим запросам для пользователей, которые подключили тариф «Продвинутый». Теперь максимально допустимые значения:

100 запросов — лимит по количеству поисковых запросов, которые можно получать по каждому товару.
100 элементов — максимальное количество элементов в массиве searchTexts в запросах на получение данных о количестве заказов и позициях по поисковым запросам покупателей.

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

Подробнее об изменениях можно почитать в официальной документации WB API.

Отключение устаревшего метода `/storage-coefficient`

Ещё одним важным изменением стало объявленное отключение устаревшего метода /storage-coefficient, который предоставлял отчёты по удержаниям за логистику и хранение. Метод полностью перестал работать 23 июня 2025 года.

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

Взаимодействие с покупателями

Упрощение работы с чатами: отказ от объекта refund в событиях

Мы внесли изменения в метод получения событий чата с покупателями. Ранее в ответах API присутствовал объект refund, который информировал продавцов о заявках на возвраты через чат. Теперь этот объект полностью убран, а все события чата получили единый тип message.

Если продавцу нужно работать с возвратами, то теперь следует использовать отдельные методы API, предназначенные специально для обработки возвратов. Такое разделение поможет чётко разграничивать коммуникацию с покупателями и работу с заявками на возврат, избежав путаницы и обеспечив прозрачность работы службы поддержки.

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

Следите за новыми публикациями, читайте кейсы, используйте инструкции, и обязательно подписывайтесь на канал WB API в Telegram, чтобы не пропускать всё самое важное