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

Добавили метод получения стикеров для сборочных заданий DBS с доставкой в ПВЗ. Используйте этот метод, чтобы получать стикеры в формате PDF для сборочных заданий в статусах confirm — на сборке — и deliver — в доставке.

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

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

• wbStickerId — ID стикера
• scanPrice — цена приёмки в ПВЗ в копейках

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

• адрес ПВЗ для доставки — в поле address
• тип доставки dbsPickupPoint — доставка силами продавца в ПВЗ — в поле deliveryType

Добавили отчёт CSV модели InventoryHistoryReportRes. В запросе на создание отчёта reportType этой модели — STOCK_HISTORY_DAILY_CSV.

В отчёте показываются данные об остатках по состоянию на 23:59.

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

Для более гибкого управления доступом к данным продавца вводим обновление токенов WB API — теперь новые методы будут доступны в зависимости от типа токена:

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

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

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

Теперь вы можете передать сразу несколько ID сборочных заданий в одном запросе, чтобы:

• перевести сборочные задания на сборку
• сообщить, что сборочные задания готовы к выдаче
• сообщить, что заказы приняты покупателями
• сообщить об отказе от заказов
• получить статусы сборочных заданий
• отменить сборочные задания
• получить метаданные сборочных заданий
• удалить метаданные сборочных заданий
• закрепить коды маркировки товара за сборочными заданиями
• закрепить УИН за сборочными заданиями
• закрепить IMEI за сборочными заданиями
• закрепить GTIN за сборочными заданиями

Новые методы заменят устаревшие методы в разделах Сборочные задания Самовывоз и Метаданные Самовывоз.

Добавили поле orderStatus — статус заказа — в ответы методов:

• Список отзывов
• Получить отзыв по ID
• Список архивных отзывов

Возможные значения поля:

• buyout — выкуплен
• rejected — отказ
• returned — возврат
• notSpecified — статус не присвоен

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

• Списки активных и неактивных поисковых кластеров
• Статистика по поисковым кластерам с детализацией по дням

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

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

Метод изменения списка карточек товаров в кампаниях перенесли в подраздел Управление кампаниями.

Добавили поле currency — валюта отчёта — в методы:

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

До 11 февраля добавим поле currency в отчёты:

• Поисковые запросы по вашим товарам
• Аналитика продавца CSV — остальные типы отчётов

С 11 февраля:

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

Изменения появятся постепенно у всех продавцов до 16 февраля.

Добавили метод получения информации о покупателе B2B для модели DBS. Теперь с помощью WB API вы можете получить данные B2B-покупателя:

• ИНН
• КПП
• Наименование организации

Добавили поле crossBorderType с информацией, является ли сборочное задание кроссбордером, в ответы методов FBS:

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

Вы можете добавить в пустую поставку сборочное задание любого типа: кроссбордер или не кроссбордер. После этого поставка приобретает тип первого добавленного в неё сборочного задания — этот тип будет указан в поле crossBorderType в ответах методов:

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

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

10 февраля отключим неактуальное поле statusID — статус товара — в ответах методов:

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

С 5 февраля изображения в поле photoLinks будут возвращаться в формате webp вместо jpg для методов:

• Список отзывов
• Получить отзыв по ID
• Список архивных отзывов

В ответ метода Отчёт о продажах по реализации добавили поля c информацией о скидках за промокоды:

• uuid_promocode — ID промокода
• sale_price_promocode_discount_prc — скидка за промокод, %

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

2 февраля отключим неактуальное поле clientID — ID покупателя — в ответах методов:

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

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

Чтобы проверить, можно ли указать номер ГТД для сборочного задания, используйте методы получения списка новых сборочных заданий FBS и DBS:

• если в поле ответа requiredMeta будет значение customsDeclaration, вы можете указать номер ГТД
• если в ответе в поле requiredMeta нет значения customsDeclaration, вы не можете указать номер ГТД

Чтобы указать номер ГТД, используйте новые методы:

• Закрепить за сборочным заданием номер ГТД — FBS
• Закрепить за сборочными заданиями номер ГТД — DBS

Чтобы проверить указанный номер ГТД, используйте методы получения метаданных сборочных задания FBS и DBS. Указанный номер ГТД будет представлен в поле customsDeclaration.

Чтобы удалить указанный номер ГТД, используйте методы удаления метаданных сборочных заданий FBS и DBS.

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

Теперь вы можете передать сразу несколько ID сборочных заданий в одном запросе, чтобы:

• получить статусы сборочных заданий  
• отменить сборочные задания 
• перевести сборочные задания на сборку 
• перевести сборочные задания в доставку 
• сообщить, что заказы приняты покупателем 
• сообщить, что покупатель отказался от заказов 
• получить метаданные сборочных заданий 
• удалить метаданные сборочных заданий 
• закрепить коды маркировки товара за сборочными заданиями  
• закрепить УИН за сборочными заданиями 
• закрепить IMEI за сборочными заданиями 
• закрепить GTIN за сборочными заданиями  

Новые методы заменят устаревшие методы в разделах Сборочные задания DBS  и Метаданные DBS.

В ответ метода Отчёт о продажах по реализации добавили поля c информацией о скидках лояльности от продавца:

• loyalty_id — ID скидки лояльности от продавца
• loyalty_discount — размер скидки лояльности от продавца, %

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

В ответ метода Отчёт о продажах по реализации добавили поля c информацией о собственных акциях продавца с дополнительными скидками:

• seller_promo_id — ID собственной акции продавца с дополнительной скидкой
• seller_promo_discount — размер дополнительной скидки по собственной акции продавца, %

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

С 11 марта отключим метод получения отчёта Поставки.

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

Добавили новые методы получения отчётов о занижении габаритов упаковки:

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

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

Добавили ответы со статусами модерации файла для метода Получить файл из сообщения:

• 202 Файл на модерации
• 451 Файл не прошёл модерацию

Переходим на работу с кампаниями с ручной и единой ставкой — тип 9.

Методы для работы с кампаниями с единой ставкой — тип 8 — будут отключены 2 февраля:

• Список карточек товаров для кампании с единой ставкой 
• Изменение списка карточек товаров в кампании с единой ставкой 
• Статистика кампании с единой ставкой по кластерам фраз

Дата отключения метода Установка/удаление минус-фраз для кампании с единой ставкой переносится с 15 января на 2 февраля.

В ответ метода Список чатов добавили объект lastMessage с информацией о последнем сообщении в чате:

• text — текст сообщения
• addTimestamp — время сообщения

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Переместили метод Коэффициенты приёмки в раздел Тарифы. Теперь он будет доступен по домену 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 октября.

В ответы методов получения списка поставок и деталей поставки добавили полеstatusID — ID статуса поставки.

3 ноября отключим поля с названиями типов и статусов поставок:

• statusName — статус поставки
• boxTypeName — тип поставки
• virtualTypeName — тип виртуальной поставки

Теперь для уточнения статуса и типа поставки используйте ID:

• statusID — ID статуса поставки
• boxTypeID — ID типа поставки
• virtualTypeID — ID типа виртуальной поставки

Расшифровка значений приведена в описании ID.

Кампании с ручной и единой ставкой объединили в один тип — 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 сентября.

В ответ метода получения информации о курьере добавили поля:

• fullName — ФИО курьера
• pTimeFrom — дата и время, с которого прибудет курьер
• pTimeTo — дата и время, по которое прибудет курьер

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

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

Прежние условия неактуальны.

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

• Установка/удаление минус-фраз фразового соответствия
• Установка/удаление минус-фраз точного соответствия

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

• order_uid — ID транзакции. Заказы в одной корзине покупателя будут иметь одинаковый order_uid

Добавили в песочницу новые методы создания тестовых отзывов и вопросов. Созданные вопросы и отзывы хранятся 5 дней.

Добавили новую ошибку ответа 200 в метод Детализация обработанной загрузки:

You can't change the item price. Item was added to the Sale due to high inventory

Ошибка возникает, если товар попал под распродажу по индексу остатка.

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

• isDeleting — склад удаляется: false — нет, true — да.
  После удаления склад пропадёт из списка
• isProcessing — данные склада обновляются: false — нет, true — да.
  Обновление данных может занимать несколько минут. При true обновление и удаление остатков будет недоступно

Добавили новую версию метода получения несозданных карточек товаров с ошибками (черновиков). В новой версии метода реализовали пагинацию и передачу данных пакетами.

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

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

Все остатки малогабаритных товаров на неподходящих складах ("cargoType": 2 и "cargoType": 3) будут автоматически удалены 10 сентября. Рекомендуем перенести остатки на подходящие виртуальные склады ("cargoType": 1) до этой даты.

8 сентября:

• в метод получения списка документов добавим параметры пагинации limit и offset. Можно будет запросить максимум 50 строк
• в методе получения документов можно будет запросить максимум 50 документов

С 1 сентября отключим метод получения отчёта о Динамике оборачиваемости.

Данные динамики оборачиваемости можно получить в отчёте История остатков: объекты saleRate и avgStockTurnover.

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

• nm_id — список артикулов WB
• advert_id — ID кампании
• payment_type — тип оплаты
• placement_types — зоны показов

Отключим метод получения конфигурационных значений Продвижения 16 сентября. О новом методе получения конфигурационных значений сообщим позднее.

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

• finalPrice — фактическая сумма к оплате покупателем в валюте продажи с учетом всех скидок, умноженная на 100
• convertedFinalPrice — фактическая сумма к оплате покупателем в валюте страны продавца с учетом всех скидок, умноженная на 100

Коды валют указаны в поляхcurrencyCode и convertedСurrencyCode. Суммы к оплате предоставляются в информационных целях.

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

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

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

• Информация о кампаниях с ручной ставкой
• Изменение мест размещения в кампаниях с ручной ставкой
• Изменение ставок в кампаниях с ручной ставкой
• Изменение списка карточек товаров в кампаниях с ручной ставкой

С 9 сентября будет невозможно получать кампании с ручной ставкой и менять в них ставки с помощью методов Информация о кампаниях и Изменение ставок.

В ответ метода получения списка причин жалоб на отзыв и проблем с товаром добавили список причин жалоб, оставленных через портал продавцов:

• 11 — Отзыв не относится к товару
• 12 — Отзыв оставили конкуренты
• 13 — Спам-реклама в тексте
• 14 — Спам-реклама на фото или видео
• 15 — Нецензурное содержимое в фото или видео
• 16 — Нецензурная лексика
• 17 — Фото или видео не имеет отношения к товару
• 18 — Отзыв с политическим контекстом
• 19 — Другое
• 20 — Угрозы оскорбления

Списки причин жалоб на портале продавцов и в API различаются. При этом подать жалобу по API по причине с портала продавца невозможно.

Если жалоба подана через портал продавцов (например, 13 — Спам-реклама в тексте), в ответах методов получения отзыва по ID, списка отзывов и списка архивных отзывов будет отображаться причина, указанная на портале (13 — Спам-реклама в тексте).

Если жалоба подана по API (например, с причиной 3 — Спам), в ответах тех же методов будет отображаться причина, переданная по API, а на портале продавцов отобразится соответствующая причина из списка портала (13 — Спам-реклама в тексте).

С 1 сентября будет обязательным указывать IMEI для товаров от 20 000 рублей для сборочных заданий моделей DBW, DBS и Самовывоз.

Если IMEI не будет заполнен:

• сборочные задания DBW и DBS нельзя будет перевести в доставку
• для сборочных заданий Самовывоз будет невозможно сообщить, что сборочное задание готово к выдаче

Теперь при формировании поставки для отгрузки в ПВЗ достаточно указать количество коробов при их добавлении в поставку. Добавлять список заказов в короб больше не требуется.

С 18 августа отключим:

• методы добавления и удаления заказов из коробов
• получение списка заказов в методе получения списка коробов. Массив orders будет удален из ответа метода

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

• boxDeliveryCoefExpr — коэффициент Логистика, %. На него умножается стоимость логистики. Уже учтён в тарифах
• boxDeliveryMarketplaceBase — логистика FBS, первый литр, ₽
• boxDeliveryMarketplaceCoefExpr — коэффициент FBS, %. На него умножается стоимость логистики FBS. Уже учтён в тарифах
• boxDeliveryMarketplaceLiter — логистика FBS, дополнительный литр, ₽
• boxStorageCoefExpr — коэффициент Хранение, %. На него умножается стоимость хранения в день. Уже учтён в тарифах
• geoName — страна, для РФ — округ

Поле boxDeliveryAndStorageExpr будет удалено из ответа метода с 19 августа.

Теперь в песочнице сборочным заданиям автоматически назначается одинаковый orderCode, если вы создаёте несколько сборочных заданий Самовывоз одним запросом. Назначенный orderCode передаётся в ответе метода получения новых сборочных заданий.

Отдельный контур для работы с методами модели DBW:

• C 7 ноября работать со сборочными заданиями DBW можно будет только по выделенным URL вида https://marketplace-api.wildberries.ru/api/v3/dbw/...
• Добавили метод получения информации о курьере

Информация обо всех методах DBW — в новом разделе документации Заказы DBW

Изменения в разделе Поставки FBW:

• Добавили метод транзитных направлений для формирования поставок
• Добавили методы получения информации о поставках:
  • Список поставок
  • Детали поставки
  • Товары поставки
  • Упаковка поставки

В ответ метода Список чатов добавили новый объект goodCard c информацией о карточке товара, по которой покупатель начал чат:

• date — дата заказа
• needRefund — запрошен ли возврат товара
• nmID — артикул WB
• price — фактическая цена с учетом всех скидок. Взимается с покупателя
• priceCurrency — валюта
• rid — уникальный ID заказа
• size — размер товара
• statusID — статус товара

1. Добавили поле officeID — ID склада WB, к которому привязан склад продавца — в методы:
   • Получить список новых сборочных заданий
   • Получить информацию о сборочных заданиях
2. Добавили поле destinationOfficeId — ID склада назначения поставки — в методы:
   • Получить список поставок
   • Получить информацию о поставке

С 1 сентября, в методе добавления сборочных заданий в поставку будет возвращаться ошибка 409, если officeID сборочного задания не совпадает с destinationOfficeID поставки.

Поле destinationOfficeId будет только у новых поставок. Если в поставке есть поле cargoType, изменения её не затронут.

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

• finalPrice — цена в валюте продажи с учетом всех скидок, умноженная на 100

• convertedFinalPrice — цена в валюте страны продавца с учетом всех скидок, умноженная на 100

В информацию о сборочных заданиях Самовывоз в песочнице добавили поля:

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

• convertedCurrencyCode — код валюты страны продавца

Цены предоставляются в информационных целях.

Методы, в ответы которых добавили поля:

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

• Добавили 2 поля в детализации к еженедельным отчётам реализации:   
  • cashback_amount — cумма, удержанная за начисленные баллы программы лояльности
  • cashback_discount — компенсация скидки по программе лояльности

Подробнее о кешбэке на товары — на портале продавцов

• Добавили 5 полей в Отчёт о возвратах и перемещении товаров:   
  • reason — причина возврата
  • orderId — номер сборочного задания
  • readyToReturnDt — дата и время готовности возврата к выдаче
  • expiredDt — дата и время истечения срока хранения возврата
  • completedDt — дата и время выдачи возврата продавцу

С 21 июля в метаданных сборочного задания FBS вы сможете указывать срок годности — дату, до которой годен товар.

Чтобы проверить, можно ли указать срок годности товара для сборочного задания, используйте метод Получить список новых сборочных заданий. Если в ответе метода в поле requiredMeta получено значение expiration, вы можете указать срок годности. Если в ответе метода не возвращается значение expiration, добавить срок годности для этого задания невозможно.

Чтобы указать срок годности товара, используйте новый метод Закрепить за сборочным заданием срок годности товара . Минимальный срок — 30 дней от текущей даты. Установить срок годности товара можно только для сборочных заданий в статусе confirm. Чтобы изменить срок годности, отправьте запрос с новой датой.

Чтобы проверить указанный срок годности товара, используйте метод Получить метаданные сборочного задания. Установленный срок годности будет указан в поле expiration. Если поле expiration пустое — срок годности товара ещё не установлен.

Удалить срок годности из метаданных сборочного задания невозможно.

В ответ метода получения складов WB добавили новое поле federalDistrict — федеральный округ склада WB. Если значение поля null, склад находится за пределами РФ или федеральный округ не указан.

В ответ метода получения списка складов добавили поля:

• isActive — доступен ли склад в качестве склада назначения
• isTransitActive — доступен ли склад в качестве транзитного

С 14 июля лимит для метода получения опций приёмки — 6 запросов в минуту.

В новой песочнице вы можете тестировать методы заказов Самовывоз. Песочница доступна по токену с опцией Тестовый контур.

В песочницу добавили методы управления:

• сборочными заданиями
• метаданными

Также доступны методы управления складами и остатками на складах.

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

• С 14 июля в отчётах о продажах по реализации:   
  • в 7 полях будем передавать данные в процентах, а не в долях. Значение в процентах в 100 раз больше значения в долях
    • sale_percent — Согласованный продуктовый дисконт, %
    • product_discount_for_report — Итоговая согласованная скидка, %
    • supplier_promo — Промокод, %
    • ppvz_spp_prc — Скидка постоянного Покупателя (СПП), %
    • ppvz_kvw_prc_base — Размер кВВ без НДС, % Базовый
    • ppvz_kvw_prc — Итоговый кВВ без НДС, %
    • sup_rating_prc_up — Размер снижения кВВ из-за рейтинга, %
  • исключим неактуальное поле rid
• Отчет за период с 7 по 13 июля будет сформирован с учётом этих изменений

• Добавили фильтры по подменным артикулам:
  • Параметры в запросы методов получения основного отчёта, данных к основному отчёту с пагинацией по группам, данных к основному отчёту с пагинацией по товарам в группе и топа поисковых запросов по товару, а также в модель SearchReportProductReq метода создания отчётов в формате CSV:
    • includeSubstitutedSKUs — Показать данные по прямым запросам с подменным артикулом
    • includeSearchTexts — Показать данные по поисковым запросам без учёта подменного артикула
    • Оба параметра не могут иметь значение false одновременно
  • Поле в ответы методов получения основного отчёта, данных к основному отчёту с пагинацией по группам и данных к основному отчёту с пагинацией по товарам в группе, а также в модель SearchReportProductRes отчётов в формате CSV:
    • isSubstitutedSKU — Искали ли товар по подменному артикулу. Отображается, если в запросе есть параметры includeSubstitutedSKUs и/или includeSearchTexts
• Для продавцов с тарифом Продвинутый теперь максимально 100:
  • Значение параметра limit запроса метода получения топа поисковых запросов по товару и модели SearchReportTextReq метода создания отчётов в формате CSV
  • Количество элементов в массиве searchTexts запроса метода получения данных по количеству заказов и позиций в поиске по запросам покупателя
• Методы поисковых запросов доступны только с подпиской Джем

• Неактуальный метод отчёта об удержаниях Коэффициент логистики и хранения будет отключён 23 июня
• Вместо него скоро добавим методы отчётов Удержания за занижение габаритов упаковки и Замеры склада. Следите за обновлениями

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

• finalPrice — цена в валюте продажи с учетом всех скидок, умноженная на 100

• convertedFinalPrice — цена в валюте страны продавца с учетом всех скидок, умноженная на 100

В информацию о сборочных заданиях Самовывоз добавили поля:

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

• convertedCurrencyCode — код валюты страны продавца

Цены предоставляются в информационных целях.

Методы, в ответы которых добавили поля:

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

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

В новой песочнице вы можете тестировать методы заказов FBS. Песочница доступна по токену с опцией Тестовый контур.

В песочницу добавили методы управления:

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

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

В ответ метода получения информации о покупателе добавили полеreplacementPhone – основной номер телефона для связи с покупателем. Он избавляет от необходимости использовать добавочные коды.

Текущий способ связи остаётся резервным, на случай, еслиreplacementPhoneнедоступен.

• С 5 июня методы создания, создания с присоединением и редактирования карточек товаров будут исключены из общего лимита категории Контент — максимум 100 запросов в минуту для всех методов. Теперь для каждого из трех методов лимит составит 10 запросов в минуту. Для остальных методов категории Контент лимит останется прежним
• Напоминаем, что одним запросом можно создавать или редактировать до 3000 карточек товаров. Рекомендуем указывать как можно больше карточек товаров в запросе, чтобы отправлять как можно меньше запросов.
• Обращаем внимание, что в рамках лимита не следует отправлять все запросы одновременно. Распределяйте запросы равномерно по единице времени лимита (в данном случае, 1 минуте). Подробнее в лимитах запросов

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

Сейчас новый механизм затрагивает небольшую часть файлов. ID файла передается вместе с "url":"". Постепенно файлы всех новых сообщений будут доступны только по ID.

Изменения:

• в структуры сообщений files и images добавили поле downloadID — ID файла.

• добавили метод получения файла из сообщения — используйте ID файла из тела сообщения, чтобы получить файл через этот метод.

Сообщим, когда переход на новый механизм получения файлов завершится.

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

• В ответ метода получения комиссий по категориям товаров добавили поля:
  • kgvpPickup — Комиссия по модели Самовывоз из магазина продавца (C&C), %
  • kgvpBooking — Комиссия по модели Бронирование, %