Дайджест WB API — Май 2024

Новые API и методы

Мы рады представить три новых API и несколько новых методов.

---

Комиссии по категориям товаров

Первый в нашем списке — новый API для получения тарифов комиссий по категориям товаров:

• Эндпоинт: /api/v1/tariffs/commission
• Функция: Возвращает комиссии WB по родительским категориям товаров согласно модели продаж.
• Лимит запросов: Максимум 1 запрос в минуту.

Авторизация и параметры:

• HeaderApiKey: Требуется для авторизации.
• Параметры:
• locale: Язык полей ответа parentName и subjectName (варианты: ru, en, zh).

Подробнее можно узнать в документации.

Возврат товаров покупателями

Также Wildberries обзавелся API для обработки возвратов товаров покупателями:

• Для авторизации понадобится сгенерировать и использовать токен с опцией «Возвраты».
• Документация доступна на нашем портале.

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

• Заявки покупателей на возврат
• Ответ на заявку покупателя

Отчёт по удержаниям за смену характеристик

Ещё один новый API для получения отчётов об удержаниях за смену характеристик товара:

• Эндпоинт: /api/v1/analytics/characteristics-change
• Функция: Возвращает отчёт о штрафах за смену характеристик товара. Если товары после приёмки не соответствуют заявленным цветам и размерам, и на складе их перемаркировали с правильными характеристиками, по таким товарам назначается штраф.
• Лимит запросов: Максимум 10 запросов за 10 минут.
• Период данных: Данные можно получить за период до 31 дня, доступны с 28 декабря 2021 года.

Авторизация и параметры:

• HeaderApiKey: Нужен для авторизации.
• Параметры:
• dateFrom: Начало отчетного периода (формат: ГГГГ-ММ-ДД).
• dateTo: Конец отчетного периода (формат: ГГГГ-ММ-ДД).

Подробнее можно узнать в документации.

Новые методы: информация для формирования поставок

Появились новые API методы, с которыми можно получить информацию для формирования поставок:

• Коэффициенты приёмки
• Опции приёмки
• Список складов

Для авторизации необходимо сгенерировать и использовать токен с опцией «Поставки».

OAuth2.0 и авторизованные сервисы WB

Мы рады сообщить о поддержке стандарта OAuth2.0, который упрощает подключение сторонних сервисов к вашему аккаунту в Wildberries.

Преимущества OAuth2.0:

• Удобство: Не нужно вручную создавать и вводить токены.
• Безопасность: Доступ только к необходимым данным.
• Простое управление: Легкость подключения и отключения сервисов.

Как это работает:

1. Из Личного кабинета WB:

• Выберите сервис в каталоге и нажмите «Подключить».
• Авторизуйтесь и дайте разрешение на доступ к данным.
• Сервис автоматически получает необходимые доступы.

1. Из сервиса:

• Нажмите «Подключить к Wildberries» в личном кабинете сервиса.
• Подтвердите доступ на Портале продавца WB.

Подробнее в документации по OAuth2.0.

Изменения

Обратите внимание на изменения, которые вступили в силу в этом месяце.

Поменяли формат изображений в API контента: WEBP вместо JPG

15 мая формат изображений, URL которых передаются в массиве photos в ответах методов get/cards/list и get/cards/trash, был изменен с JPG на WEBP. Вы по-прежнему сможете загружать изображения в 5 форматах, однако по ссылке вы будете получать изображение в формате WEBP.

Заменили поля в отчёте о платном хранении

Заменили поля giDate, giFixDateFrom и giFixDateTill — даты поставок и фиксации тарифа — на tariffFixDate и tariffLowerDate — даты фиксации и понижения тарифа — в отчёте о платном хранении. Подробнее можно узнать в документации.

Добавили новое поле в отчёте о платной приёмке

В отчёт о платной приёмке добавили новое поле total — суммарную стоимость приёмки с копейками. total заменит устаревшее поле sum — суммарную стоимость приёмки в рублях без копеек. Поле sum будет отключено 10 июня. Подробнее можно узнать в документации.

Важное напоминание: новый срок действия API-токена — 180 дней

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

Это были все обновления API за май. Следите за новостями в нашей ежемесячной рубрике.