Дайджест WB API — Ноябрь 2024
В свежем выпуске нашего ежемесячного дайджеста мы расскажем о новых функциях и обновлениях, которые вышли в ноябре
Дата публикации: 11.12.2024
Обновления WB API за ноябрь
В этом месяце команда WB API продолжила оптимизацию методов получения аналитики, обновила инструменты работы с отзывами, расширила возможности для работы со сборочными заданиями в DBS, упростила процессы управления остатками и улучшила API для цифровых товаров. Все изменения направлены на повышение прозрачности, удобства и эффективности работы с платформой. Остановимся на каждом из них подробнее.
Аналитика и данные
В ноябре была расширена функциональность методов, связанных с отчётами по поисковым запросам. Теперь в метод, отвечающий за получение основной страницы отчёта, добавлены параметры limit и offset, что позволяет более гибко управлять постраничной выдачей данных. Аналогичная логика внесена и в метод поиска по конкретным товарам: параметр nmId заменён на массив nmIds, что упрощает работу с несколькими товарами одновременно. Кроме того, эти параметры стали обязательными, что призвано стандартизировать запросы и обеспечить предсказуемость результатов. Подробные сведения о новых параметрах и структуре запросов можно найти в разделе «Поисковые запросы».
Также были внесены улучшения в отчёты формата «Воронка продаж (Джем)». Теперь при успешных запросах (статус-код 200) ответ содержит только массив data, а дополнительные поля для ошибок исключены. Это делает структуру ответа более лаконичной и понятной: информация об ошибках теперь возвращается только при нестандартных статус-кодах. Такой подход позволяет быстрее анализировать корректные ответы и с меньшей путаницей обрабатывать ошибки. Подробности доступны в разделе «Аналитика продавца CSV».
Дополнительным новшеством стало добавление возможности выгружать отчёты в формате CSV, что делает интеграцию с аналитическими системами и BI-инструментами ещё удобнее. Теперь партнёрам предоставляется более гибкая аналитика, которую можно легко импортировать в любые внешние системы. В документации по «Аналитике продавца CSV» подробно описаны модели запросов и ответы, а также примеры для быстрой интеграции.
Работа с товарами: Остатки
Чтобы упростить работу с остатками и улучшить качество обратной связи при ошибках, были расширены коды ответов в методе обновления остатков. Вместо одного универсального сообщения о неподходящем складе теперь возвращаются детальные ошибки, различающиеся в зависимости от типа товара (СГТ, КГТ+, СГТ/КГТ+ или МГТ). Это даёт разработчикам более точные указания для корректировки данных и упрощает отладку. Узнать больше о работе с остатками можно в разделе «Остатки».
Общение с покупателями: Вопросы и отзывы
Теперь мы используем более современный подход к работе с отзывами. Вместо устаревшего метода «Работа с отзывом» появились три новых, более специализированных метода, позволяющих подать жалобу на отзыв или товар, ответить на отзыв и отредактировать уже оставленный ответ. Такой более детальный и разделённый по функционалу подход улучшает процесс работы с обратной связью покупателей. Подробные инструкции и примеры использования доступны в разделах «Вопросы» и «Отзывы».
Одновременно были упразднены методы, неактуальные в текущем контексте анализа потребительского фидбэка. Консолидация методов в чётко структурированные разделы призвана сократить время разработки и тестирования и упростить навигацию по документации.
Отдельный контур для DBS-схемы
Важным изменением стало выделение отдельного контура для работы со сборочными заданиями по схеме DBS (доставка силами продавца). Теперь все DBS-методы сгруппированы в отдельном разделе и доступны только по адресам вида marketplace-api.wildberries.ru/api/v3/dbs/. Этот шаг направлен на повышение безопасности, управляемости и понимания логики работы DBS. Подробности и описание методов представлены в разделе «DBS».
Цифровые товары
Для поставщиков цифровых товаров добавлены параметры пагинации и фильтрации при получении списка ключей активации. Это делает процесс выдачи и управления большим массивом данных более удобным, позволяя разработчикам получать нужную информацию быстрее. Подробности в «WB Цифровой».
Поставки FBW
В части работы с поставками по модели FBW были улучшены методы получения коэффициентов приёмки. Теперь разработчики могут видеть дополнительные параметры, такие как коэффициенты хранения и доставки, стоимость логистики для коробов и монопаллет, а также информацию о типе склада. Это обеспечивает более точное планирование, позволяет снизить ошибки при расчёте логистических затрат и повышает предсказуемость при подготовке поставок. Дополнительные сведения доступны в разделе «Поставки».