Дайджест WB API — Февраль 2026

В феврале 2026 года Wildberries выпустили 9 обновлений API. Месяц прошёл с акцентом на расширение возможностей для продавцов: новые batch-методы для Самовывоза, стикеры для DBS, отчёт по истории остатков в CSV и переход на мультивалютность в аналитике.

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

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

Коротко о главном

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

---

Отчёты

Новый ответ 204 при пустых отчётах

С 11 марта три метода получения отчётов с заданием на генерацию изменят поведение: если данных по запросу нет, вместо ответа 200 с пустым массивом [] будет возвращаться 204 Нет данных.

Затронутые отчёты:

• Остатки на складах — GET /api/v1/warehouse_remains/tasks/{task_id}/download
• Операции при приёмке — GET /api/v1/acceptance_report/tasks/{task_id}/download
• Платное хранение — GET /api/v1/paid_storage/tasks/{task_id}/download

Если ваш код обрабатывает пустой массив как «нет данных» — всё работает. Но если клиент ожидает 200 и падает на 204 — до 11 марта нужно добавить обработку этого статуса. Типичная ошибка: парсинг JSON из тела ответа 204, в котором тела нет.

---

Заказы DBS

Стикеры для сборочных заданий DBS с доставкой в ПВЗ

Добавлен метод получения стикеров — POST /api/marketplace/v3/dbs/orders/stickers — для заказов DBS с доставкой в ПВЗ. Метод возвращает стикеры в формате PDF для заданий в статусах confirm (на сборке) и deliver (в доставке).

Параллельно в ответы методов работы со сборочными заданиями DBS добавлены новые поля:

• В методе получения новых сборочных заданий (GET /api/v3/dbs/orders/new) появилось поле wbStickerId — идентификатор стикера.
• В методе получения завершённых сборочных заданий (GET /api/v3/dbs/orders) появились wbStickerId и scanPrice — цена приёмки в ПВЗ в копейках.

Для бизнеса:

• Автоматическая печать стикеров для DBS-заказов, доставляемых в ПВЗ — без необходимости генерировать их вручную
• Контроль стоимости приёмки через поле scanPrice

Для разработчиков:

• Интеграция стикеров в workflow аналогична FBS — передаёте массив ID заказов, получаете PDF
• scanPrice приходит в копейках — делите на 100 для отображения пользователю

---

Самовывоз

Batch-методы для массовой работы со сборочными заданиями

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

• Перевести на сборку — POST /api/marketplace/v3/click-collect/orders/status/confirm
• Сообщить о готовности к выдаче — POST /api/marketplace/v3/click-collect/orders/status/prepare
• Подтвердить приём покупателем — POST /api/marketplace/v3/click-collect/orders/status/receive
• Сообщить об отказе — POST /api/marketplace/v3/click-collect/orders/status/reject

Эти методы покрывают весь жизненный цикл сборочного задания Самовывоза: от подтверждения сборки до выдачи покупателю или отказа. Если у вас магазин с высоким потоком заказов на самовывоз — batch-обработка заметно сократит количество запросов к API.

---

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

Новые методы и расширенная статистика поисковых кластеров

Добавлены два метода для работы с поисковыми кластерами в рекламных кампаниях:

• Списки активных и неактивных поисковых кластеров — POST /adv/v0/normquery/list — позволяет получить полный перечень кластеров для кампании.
• Статистика по поисковым кластерам с детализацией по дням — POST /adv/v1/normquery/stats — дневная разбивка по каждому кластеру.

Кроме того, в существующий метод статистики поисковых кластеров (POST /adv/v0/normquery/stats) добавлены поля shks (количество заказанных товаров) и spend (затраты на продвижение в конкретном кластере). Теперь можно оценивать эффективность каждого кластера не только по кликам, но и по заказам и расходам — а с новым v1-методом делать это в разрезе дней.

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

Метод изменения списка карточек товаров в кампаниях (PATCH /adv/v0/auction/nms) перенесён в подраздел Управление кампаниями. Endpoint остался прежним, изменилось только расположение в документации.

---

Аналитика

Мультивалютность в отчётах

Wildberries последовательно переводит аналитику на мультивалютность. В феврале поле currency — валюта отчёта — добавлено в методы:

• Воронка продаж
• История остатков
• Аналитика продавца CSV — типы DETAIL_HISTORY_REPORT и GROUPED_HISTORY_REPORT

С 11 февраля поле currency добавлено во все оставшиеся отчёты раздела Аналитика и данные, а денежные значения возвращаются в валюте страны регистрации продавца. Если ваш код предполагал, что все суммы в рублях — проверьте поле currency и добавьте логику конвертации при необходимости.

Новый CSV-отчёт по истории остатков

Добавлен новый тип отчёта STOCK_HISTORY_DAILY_CSV в Аналитику продавца CSV. Для создания отчёта отправьте запрос на создание отчёта с reportType: "STOCK_HISTORY_DAILY_CSV", затем скачайте готовый файл.

Отчёт показывает данные об остатках по состоянию на 23:59 каждого дня. Доступен без подписки Джем — это один из немногих CSV-отчётов, для которых подписка не требуется.

---

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

Статус заказа в отзывах

В методы работы с отзывами добавлено поле orderStatus — статус заказа, к которому относится отзыв:

• Список отзывов — GET /api/v1/feedbacks
• Получить отзыв по ID — GET /api/v1/feedback
• Список архивных отзывов — GET /api/v1/feedbacks/archive

Возможные значения: buyout (выкуплен), rejected (отказ), returned (возврат), notSpecified (статус не присвоен). Теперь можно фильтровать отзывы по типу завершения заказа — например, отдельно анализировать отзывы от покупателей, вернувших товар, чтобы понять причины возвратов.

---

Общее

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

Wildberries вводит разделение доступа к методам API по типам токенов:

• Персональный — полный доступ, включая управление пользователями
• Сервисный — включая авторизацию по OAuth
• Базовый — ограниченный набор методов

Категория Управление пользователями продавца уже доступна только по персональному токену. В будущем разграничение распространится на новые методы. Если вы используете сервисные или базовые токены — проверьте, не потеряете ли доступ к нужным методам.

---

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

До 11 марта

• Добавить обработку ответа 204 в методах получения отчётов (Остатки на складах, Операции при приёмке, Платное хранение)

Без дедлайна (рекомендуется)

• Добавить обработку поля currency в отчётах аналитики — денежные значения уже возвращаются в валюте продавца
• Добавить обработку orderStatus в методах отзывов
• Добавить обработку wbStickerId и scanPrice в методах DBS-заданий
• Проверить тип используемого токена — доступ к методам управления пользователями ограничен персональным токеном

---

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

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

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