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

• 29 апреля удалим из ответов методов Заказы и Продажи неактуальное поле orderType – тип заказа. Данные по заказам на возврат товаров продавцам методами Заказы и Продажи не передаются

• 28 апреля добавим поля в ответ метода Отчёт о продажах по реализации:
  • wibes_wb_discount_percent — Скидка Wibes, %
  • installment_cofinancing_amount — Скидка по программе софинансирования

• Неактуальный метод Воронки продаж Статистика групп карточек товаров за период будет отключён 29 апреля. Вместо него используйте другие методы Воронки продаж

С 30 апреля нельзя будет удалить и обновить остатки товаров на складах, если склад уже обновляется или удаляется.

В ответ на запрос по такому складу вы получите ошибку со статус-кодом 409 и текстом "The store is processing"

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

С 26 мая нельзя будет обновить остатки малогабаритных товаров ("cargoType": 1) по модели FBS, если виртуальный склад предназначен для сверх и крупногабаритных товаров. Эти остатки можно будет только удалить.

Поэтому рекомендуем перенести остатки стандартных товаров на подходящие виртуальные склады уже сейчас.

По вашим просьбам написали инструкцию по лимитам запросов в разделе Общее. Добавили ссылки на инструкцию в аннотации ко всем методам

• В описание метода Список карточек товаров добавили полe needKiz – требуется ли код маркировки для товара

• В новой версии отчёт генерируется асинхронно, отдельными методами: создания, проверки статуса и получения отчёта. Это позволяет генерировать отчеты стабильно при любом объеме данных
• Текущий метод получения отчёта будет отключён 29 мая

• Добавили методы формирования аналитики по истории остатков с данными по:
  • Группам
  • Товарам
  • Размерам
  • Складам
• Также доступна выгрузка в CSV-формате. В описания методов создания и получения отчёта добавили описания и примеры моделей:
  • запросов — StocksReportReq
  • успешных ответов (статус-код 200) — StocksReportRes
• Отчёт по истории остатков доступен без подписки Джем, в обоих форматах
• Это информация из детализированной таблицы товаров и виджета детализации по регионам. Остатки в данной версии методов — на текущий день

Добавили метод изменения ставок карточек товаров.

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

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

Поля ddate — планируемая дата доставки, dTimeFrom — время доставки "с" и dTimeTo — время доставки "до" в методе получения новых сборочных заданий будут отключены 9 апреля.

Узнать больше о работе по модели «Самовывоз» вы можете в описании.

• 24 марта мы исключим поля inWayToClient, inWayFromClient и quantityWarehousesFull из метода получения отчёта
• Вместе с данными по отдельным складам товары в пути и общая сумма остатков будут передаваться в массиве warehouses — в полях warehouseName и quantity. В warehouseName указываются названия столбцов из версии отчёта в личном кабинете. То есть, значение warehouseName может быть и "Коледино", и "В пути до получателей"

В информацию о сборочных заданиях (FBS и DBS) добавили признак B2B-продажи — поле isB2B в структуре options.

В сборочных заданиях, выполненных до 26 февраля, isB2B всегда будет false, даже если это была B2B-продажа.

Список методов, в ответы которых добавили признак:

Получить список новых сборочных заданий (FBS)

Получить информацию о сборочных заданиях (FBS)

Получить список новых сборочных заданий (DBS)

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

• Передавать вес товара с упаковкой при создании, создании с присоединением и редактировании карточек товаров теперь нужно в параметре weightBrutto объекта dimensions. Всегда в килограммах.
• Также добавили поле weightBrutto в объект dimensions списка карточек товаров и списка карточек товаров в корзине.
• 12 марта отключим передачу объектов веса товара с упаковкой в ответах метода получения характеристик предмета.
• 31 марта отключим указание веса товара с упаковкой в массиве characteristics. После, если при создании, создании с присоединением и редактировании карточек товаров в запросе будут объекты веса товара с упаковкой, вернётся ответ со статус-кодом 400.
• Также 31 марта отключим передачу веса товара с упаковкой в массиве characteristics в списке карточек товаров и списке карточек товаров в корзине.
• Данные изменения не затрагивают текущий алгоритм указания веса товара без упаковки. Он по-прежнему передаётся в массиве characteristics во всех методах, перечисленных выше.

• Добавили в документацию API ссылки на справочный центр WB. Их можно найти в аннотациях к разделам методов. Пример

• 31 марта отключим неактуальные методы получения вопросов и отзывов в формате XLSX. Вместо них используйте методы получения списков вопросов и отзывов.

• Реализовали новую версию метода получения новостей портала продавцов
• Отличия ответа от текущей версии:
  • Тело новости вместо поля text передаётся в поле content — и без HTML-форматирования
  • Добавлен массив тегов types
• Текущая версия будет отключена 7 апреля

• Изменили запрос метода создания отчётов в формате CSV.
• В модель SearchReportTextReq — тексты поисковых запросов — добавили параметры:
  • subjectIds — ID предметов для фильтрации
  • tagIds — ID ярлыков для фильтрации
• В модели SearchReportProductReq — параметры поиска — убрали обязательность параметров subjectId и tagId
• Методы Аналитики продавца CSV доступны только с подпиской Джем

• Исключили параметр section из запроса метода редактирования предложения. Изменение не требует обязательного обновления с вашей стороны, так как не влияет на работу API-интеграций. Если не удалить параметр из запроса, он будет проигнорирован системой.

Планируем отключить все поддомены с окончанием wb.ru, которые были указаны на портале openapi.wb.ru — в новой документации они не используются. Вместо поддержки двух доменов — wildberries.ru и wb.ru — мы оставим только wildberries.ru.

Сейчас на домене wb.ru работают сервисы:

1. Продвижения
2. Цен и скидок  
3. Вопросов и отзывов 

По домену wildberries.ru доступны те же методы и данные, что и по wb.ru.

Необходимо переключиться с wb.ru на актуальный домен wildberries.ru до 15 апреля, поскольку отключение домена wb.ru повлияет на работу интеграции.

• Добавили получение отчётов по текстам поисковых запросов в формате CSV
• В описания методов создания и получения отчёта добавили описания и примеры моделей:
  • запросов — SearchReportTextReq
  • успешных ответов (статус-код 200) — SearchReportTextRes
• В ответ метода поисковых запросов по товару добавили восемь полей и две структуры:
  • nmId — артикул WB
  • subjectName — название предмета
  • brandName — название бренда
  • vendorCode — артикул продавца
  • name — название товара
  • isCardRated — есть ли рейтинг у карточки товара
  • rating — рейтинг карточки товара
  • feedbackRating — рейтинг по отзывам
  • price — цена
  • medianPosition — медианная позиция
• Данные методы доступны только с подпиской Джем

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

• В описание метода Отчёт о продажах по реализации добавили поля:
  • dlv_prc – Фиксированный коэффициент склада по поставке
  • fix_tariff_date_from – Дата начала действия фиксации
  • fix_tariff_date_to – Дата окончания действия фиксации
  • payment_processing – Тип платежа за Эквайринг/Комиссии за организацию платежей
  • srv_dbs – Признак услуги платной доставки
  • assembly_id – Номер сборочного задания
  • is_legal_entity – Признак B2B-продажи
  • trbx_id – Номер короба для платной приёмки

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

• В описания методов заказов и продаж добавили поле warehouseType. У поля могут быть значения:
  • Склад WB
  • Склад продавца
• Таким образом можно определить модель продаж без получения информации о сборочных заданиях и сопоставления ответов методов 
• Применяется для операций после 23 сентября 2024

Добавили отображение ставок товаров Аукциона в метод получения информации о кампаниях. Структура — auction_multibids

Добавили метод получения данных по ежедневной динамике

В ответ метода получения заявок покупателей на возврат внесено поле srid — уникальный ID заказа, по товару которого создана заявка

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

• Добавили массив ranging в ответы метода детальной информации по акциям, если подключено ранжирование товаров в акциях. Массив состоит из объектов по условиям ранжирования. Объекты состоят из полей:
• condition — тип ранжирования
• participationRate — количество товаров продавца для перехода на следующий уровень ранжирования, %
• boost — текущий уровень поднятия в поиске, %

• Поменяли термины в разделе Работа с товарами на актуальные в соответствии с личным кабинетом продавца:
  • Тег заменили на Ярлык
  • Номенклатура на Карточка товара
  • Карточка товара на Объединённая карточка товара
• Обновили описание всех методов, где были заменены термины.
• Перенесли методы складов продавца из раздела Заказы FBS в раздел Работа с товарами.

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

• Коэффициенты хранения и логистики
• Стоимость логистики и хранения коробов и монопаллет
• Информацию о доступности приёмки
• Информацию о типе склада
• Изменим текст ошибки warehouseIDs param is incorrect на Неверный формат warehouseIDs

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

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

• Добавили получение отчётов по поисковым параметрам в формате CSV. Отчёты выгружаются теми же методами, что и отчёты по воронке продаж, в формате CSV внутри ZIP-архива
• В описания методов создания и получения отчёта добавили описания и примеры моделей:
  • запросов: SearchReportGroupReq и SearchReportProductReq
  • успешных ответов (статус-код 200): SearchReportGroupRes и SearchReportProductRes
• Раздел Воронка продаж (Джем) теперь называется Аналитика продавца CSV. Данные методы доступны только с подпиской Джем
• Изменения не затрагивают методы раздела Воронка продаж

C 13 февраля работать со сборочными заданиями схемы DBS (Доставка силами продавца) можно будет только по выделенным URL вида https://marketplace-api.wildberries.ru/api/v3/dbs/... Все dbs-методы собрали в отдельном разделе документации

• Метод Работа с отзывом будет отключён 11 декабря. Вместо него добавили три новых метода:
  • Пожаловаться на отзыв, сообщить о проблеме с товаром 
  • Ответить на отзыв 
  • Отредактировать ответ на отзыв 
• Переименовали метод Получить список оценок в Получить списки причин жалоб на отзыв и проблем с товаром 
• 28 ноября отключим неактуальные методы:
  • Часто спрашиваемые товары 
  • Средняя оценка товара по артикулу WB 
  • Родительские категории товаров 
  • Товары с наибольшей и наименьшей средней оценкой по родительской категории 
  • Средняя оценка товаров по родительской категории 
• Все методы вопросов теперь собраны в разделе Вопросы, все методы отзывов — в разделе Отзывы