Журнал изменений

В детализации к отчётам реализации добавили поле delivery_method c информацией о способе продажи и типе товара. Теперь вы можете соотнести позиции в отчёте с тарифами в зависимости от способа доставки.

Поле delivery_method отображается только для моделей FBS, FBW и DBW.

В ежедневных отчётах новое поле появится начиная с отчёта за 22 декабря, а в еженедельных — с отчёта за 22–28 декабря.

Обновили ответы метода Отчёт о продажах по реализации. Теперь при отсутствии данных метод возвращает ответ 204 Нет данных, а не пустой массив [] в ответе 200 Успешно.

Добавили метод получения отчёта Подмены и неверные вложения.

Неактуальные методы получения этих данных отключим 20 января:

• Подмена товара
• Смена характеристик

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

Поле sellerDate отображается только для сборочных заданий со сверхгабаритными товарами СГТ, cargoType: 2.

Доставка сверхгабаритных товаров на склад в рекомендованную дату ускоряет приёмку и помогает своевременно отгружать товары покупателям. Если товары СГТ доставлены на склад раньше, продавец оплачивает хранение до рекомендованной даты. Если товары доставлены позже рекомендованной даты, действует повышенный коэффициент.

Теперь с помощью WB API вы можете создавать кампании с типом оплаты cpc — оплата за клики, и управлять ими.

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

• Информация о кампаниях
• Минимальные ставки для карточек товаров
• Изменение ставок в кампаниях

Добавили параметр payment_type — тип оплаты кампании — в методы:

• Создать кампанию
• Предметы для кампаний

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

• Информация о кампаниях
• Минимальные ставки для карточек товаров
• Изменение ставок в кампаниях

Также 2 февраля отключим неактуальные методы:

• Информация о кампаниях с ручной ставкой
• Изменение ставок
• Установка/удаление минус-фраз в поиске
• Конфигурационные значения Продвижения

В ответ метода История статусов для сборочных заданий кроссбордера добавили новые статусы для отправок DPX:

• dispatched_to_delivery_service — продавец передал заказ в службу доставки в своей стране
• on_way_to_delivery_service — заказ отправлен на склад службы доставки в стране продавца

Добавили методы для работы с закреплёнными отзывами. Теперь с помощью WB API вы можете:

• Получить список закреплённых и откреплённых отзывов 
• Закрепить отзывы
• Открепить отзывы 
• Получить количество закреплённых и откреплённых отзывов 
• Получить лимиты закреплённых отзывов по подписке и тарифной опции 

Метод закрепления отзывов доступен только по подписке Джем или c тарифной опцией Закрепление отзыва.

Добавили метод получения брендов товаров по ID предмета.

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

Теперь с помощью WB API вы можете получить cтикеры для сборочных заданий FBS не только в статусе confirm — на сборке, но и в статусе complete — в доставке.

В поле wbStatusв ответе метода Получить статусы сборочных заданий добавили значения статусов для отправок товаров DPX кроссбордера:

• accepted_by_carrier — принят перевозчиком. Продавец передал заказ в службу доставки в своей стране
• sent_to_carrier — отправлен перевозчику. Заказ отправлен на склад службы доставки в стране продавца

В методы работы с остатками добавили chrtId — ID размера товара:

• Получить остатки товаров — в запрос и ответ
• Обновить остатки товаров — в запрос
• Удалить остатки товаров — в запрос

У товара может быть только один chrtId. Его можно получить методом Список карточек товаров

С 9 февраля перестанем использовать баркод для работы с остатками.

• 15 января отключим неактуальные методы:
  • Установка/удаление фиксированных фраз
  • Управление активностью фиксированных фраз
  • Установка/удаление минус-фраз для кампании с единой ставкой
  • Статистика кампании c ручной ставкой по ключевым фразам
  • Статистика по ключевым фразам Для работы с поисковыми кластерами и минус-фразами используйте актуальные методы из раздела Поисковые кластеры.
• Метод получения статистики поисковых кластеров перенесли в подраздел Статистика

Добавили новые методы Управление пользователями продавца. С помощью этих методов вы можете:

• Создать приглашение для пользователя с доступом к профилю
• Получить список активных или приглашённых пользователей продавца
• Изменить права доступа пользователей к профилю продавца
• Закрыть доступ пользователю к профилю продавца

Управлять доступом пользователей можно только с токеном активного владельца профиля продавца.

Для авторизации сгенерируйте Персональный токен с категорией Пользователи.

Переместили метод Коэффициенты приёмки в раздел Тарифы. Теперь он будет доступен по домену https://common-api.wildberries.ru. Это значит, что получить тарифы на поставку вы можете с токеном любой категории.

В разделе Тарифы метод называется так же, как подраздел на портале продавца, — Тарифы на поставку, адрес GET /api/tariffs/v1/acceptance/coefficients.

Доступ к тарифам на поставку с доменом https://supplies-api.wildberries.ru будет отключен 3 февраля.

С 8 декабря максимальное значение параметра limit в запросе метода Статистика карточек товаров за период Воронки продаж будет 1000. Изменения не затронут параметр offset.

11 декабря отключим неактуальное поле valuation — средняя оценка всех отзывов — в ответе метода Необработанные отзывы.

Из ответов методов Списки кампаний и Информация о кампаниях удалили данные кампаний с устаревшими типами:

• 4 — в каталоге
• 5 — в карточке товара
• 6 — в поиске
• 7 — в рекомендациях на главной странице

Кампании данных типов нельзя создать с марта 2024 года.

В детализации к отчётам реализации добавили:

• payment_schedule — разовое изменение срока перечисления денежных средств

Поле применяется для отображения комиссии по услуге Вывести сейчас.

Временно убираем из API управление жалобами. 8 декабря отключим методы:

1. Получить списки причин жалоб на отзыв и проблем с товаром
2. Пожаловаться на отзыв, сообщить о проблеме с товаром

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

О возобновлении работы с жалобами по API сообщим дополнительно.

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

Список метаданных, без которых сборочное задание невозможно перевести в доставку, указан в поле requiredMeta.

Если ваш товар подлежит обязательной маркировке, необходимо указывать метаданные независимо от того, в каком поле с метаданными они получены (п. 4.6 Оферты).

Рекомендуем добавлять в сборочные задания все метаданные, полученные в полях requiredMeta и optionalMeta.

Добавили новую версию метода Получить метаданные сборочных заданий FBS. Теперь в запросе можно передавать до 100 ID сборочных заданий вместо одного.

Текущая версия метода будет отключена 24 декабря.

С 27 ноября в запросе метода Статистика кампаний в массиве ids можно будет передать максимум 50 ID кампаний.

4 декабря добавим столбец ChrtID с ID размеров в отчёт модели StocksReportRes. В запросе на создание отчёта reportType этой модели — STOCK_HISTORY_REPORT_CSV.

Столбец будет находиться между SizeName и RegionName.

Отчёт данной модели доступен без подписки Джем.

Добавили новую версию метода Добавить сборочные задания к поставке. Теперь в запросе можно передавать до 100 ID сборочных заданий вместо одного.

Текущая версия метода будет удалена 18 декабря.

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

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

Увеличили максимально допустимый лимит элементов в массиве sgtins. Теперь вы можете закрепить за сборочным заданием FBS до 100 кодов маркировки товара одним запросом.

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

С 19 ноября отключим методы:

• Получить шаблоны ответов на вопросы и отзывы 
• Создать шаблон 
• Редактировать шаблон 
• Удалить шаблон

Добавили методы Воронки продаж с новой версией v3:

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

В новой версии:

• Расширили список основных метрик
• Добавили метрики воронки продаж с WB Клубом
• Изменили пагинацию в методе Статистика карточек товаров за период
• Убрали поля с информацией об ошибках из успешных ответов 200
• Добавили поле addToWishList в ответы моделей SalesFunnelProductRes и SalesFunnelGroupRes метода Получить отчёт Аналитики продавца CSV

Методы с текущей версией v2 будут отключены 9 декабря.

В ответ метода Информация о покупателе добавили описание пустого значения строки в полях:

• replacementPhone
• phone
• additionalPhoneCodes
• phoneCode

Если в этих полях нет значений (""), это означает, что покупателю ещё не назначены подменные телефонные номера или добавочные коды.

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

• для управления ставками поисковых кластеров
  • Список ставок поисковых кластеров
  • Установить ставки для поисковых кластеров
  • Удалить ставки поисковых кластеров
• для управления минус-фразами
  • Список минус-фраз кампаний
  • Установка и удаление минус-фраз

Добавили метод получения статистики по поисковым кластерам для кампаний с ручной и единой ставкой.

С 5 ноября будет обязательным указывать IMEI для предмета Смартфоны, "subjectId":515 в сборочных заданиях моделей DBW и DBS.

Если IMEI не будет указан, сборочные задания нельзя будет перевести в доставку.

Добавили метод Занижение габаритов упаковки. Используйте его, чтобы получить новые отчёты:

• Удержания за занижение габаритов упаковки
• Замеры склада

В ответ метода получения стикеров сборочных заданий кроссбордера добавили поле parcelId — трек-номер в стикере для отслеживания сборочного задания.

27 октября отключим неиспользуемое поле size в ответах методов получения:

• списка вопросов
• вопроса по ID

Добавили поле isBadTurnover — признак неликвидного товара — в ответы методов:

• Получить товары с ценами
• Получить товары с ценами по артикулам
• Получить размеры товара с ценами

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

Теперь с помощью метода Отчёт о продажах по реализации можно получить детализации к ежедневным отчётам реализации. Для этого укажите period=daily в запросе.

Добавили метод получения стикеров сборочных заданий кроссбордера. Используйте этот метод, чтобы напрямую получать стикеры в формате PDF.

Метод получения ссылок на стикеры сборочных заданий, которые требуются при кроссбордере, будет отключен 23 октября.

Кампании с ручной и единой ставкой объединили в один тип — 9. Тип кампании 8 устарел, создавать кампании этого типа с 23 октября будет невозможно. Тип ставки в кампании теперь указываем в отдельном поле. Для работы с кампаниями типа 9 обновили методы кампаний Продвижения:

• Метод Создать кампанию теперь создаёт кампании с типом 9 с ручной или единой ставкой. Тип ставки указан в поле bid_type в ответе метода Информация о кампаниях с ручной ставкой 
• В ответ метода Информация о кампаниях с ручной ставкой добавили поле bid_type — тип ставки:
  • manual — ручная ставка
  • unified — единая ставка
• Метод Изменение ставок в кампаниях с ручной ставкой теперь называется Изменение ставок в кампаниях. В запрос этого метода добавили параметр placement — места размещения:
  • search — в поиске (для кампаний с ручной ставкой)
  • recommendations — в рекомендациях (для кампаний с ручной ставкой)
  • combined — в поиске и рекомендациях (для кампаний с единой ставкой)
• В ответе метода Списки кампаний в описание поля type добавили информацию о типе кампании:
  • 4 — в каталоге (устаревший тип)
  • 5 — в карточке товара (устаревший тип)
  • 6 — в поиске (устаревший тип)
  • 7 — в рекомендациях на главной странице (устаревший тип)
  • 8 — кампания с единой ставкой (устаревший тип)
  • 9 — кампания с единой или ручной ставкой. Тип ставки указан в поле bid_type в ответе метода  Информация о кампаниях с ручной ставкой 
• Метод Изменение списка карточек товаров в кампаниях с ручной ставкой теперь называется Изменение списка карточек товаров в кампаниях

24 октября удалим поле needRefund с информацией о возврате товара из методов:

• Списка чатов
• Событий чатов

Чтобы получить заявки покупателей на возврат, используйте отдельный метод.

Создать кампанию с ручной или единой ставкой теперь можно одним методом. Чтобы указать тип ставки в кампании, передайте его в запросе метода в параметре bid_type:

• manual — ручная ставка, указана по умолчанию
• unified — единая ставка

Для кампаний с ручной ставкой укажите зоны показа в параметре placement_types:

• search — показ в поиске, указан по умолчанию
• recommendations — показ в рекомендациях

Метод создания кампаний с единой ставкой отключим 23 октября.

В детализацию к еженедельному отчёту реализации добавили:

• cashback_commission_change — стоимость участия в программе лояльности

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

Перенесли Статистику по продвижению из раздела Аналитика и данные в раздел Маркетинг и продвижение.

Реализовали новую версию Статистики кампаний:

• Изменили схему запроса метода — в запросе необходимо указывать только ID кампаний и временной интервал.
• Изменили тип HTTP-запроса — теперь для получения статистики нужно использовать метод GET.
• Добавили поле canceled — отмены, шт. Количество продвигаемых товаров, которые заказали, но по техническим причинам не доставили покупателю.

Текущая версия будет доступна до 30 сентября.