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

• Добавили фильтры по подменным артикулам:
  • Параметры в запросы методов получения основного отчёта, данных к основному отчёту с пагинацией по группам, данных к основному отчёту с пагинацией по товарам в группе и топа поисковых запросов по товару, а также в модель 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. Для получения заявок на возврат используйте методы возвратов покупателями.

• Добавили API-версию виджета баланса продавца на главной странице личного кабинета
• Доступ — по токену с категорией Финансы

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

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

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

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

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

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

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

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

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

Изменения:

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

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

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

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

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

• Добавили возможность получать информацию о платной доставке:
  • в ответы методов получения новых и завершённых сборочных заданий добавили поле groupId — ID группы сборочных заданий, которые поступили на один склад продавца (warehouseId) в рамках одной транзакции покупателя (orderUid). По groupId предоставляются данные платной доставки.
  • реализовали метод получения информации о платной доставке

• Добавили новую песочницу для тестирования методов заказов DBS (доступна по токену с опцией Тестовый контур). В песочнице реализованы методы управления:
  • сборочными заданиями
  • метаданными
  • складами и остатками на складах
• Также добавили отдельный тестовый метод создания сборочных заданий DBS

• В примерах ответов методов цен и скидок значения errorText были обновлены (см. подробно ниже)

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

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

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

С 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 доступны только с подпиской Джем

Планируем отключить все поддомены с окончанием 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 повлияет на работу интеграции.

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

• Добавили получение отчётов по текстам поисковых запросов в формате 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 в раздел Работа с товарами.

• Добавили метод установки скидок WB Клуба
• В ответы методов детализации обработанной загрузки, детализации необработанной загрузки, получения цен и скидок товаров и получения цен и скидок размеров внесли поле clubDiscount — скидка WB Клуба
• В ответы методов получения цен и скидок товаров и получения цен и скидок размеров внесли поле clubDiscountedPrice — цена со скидкой, включая скидку WB Клуба

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 
  • Родительские категории товаров 
  • Товары с наибольшей и наименьшей средней оценкой по родительской категории 
  • Средняя оценка товаров по родительской категории 
• Все методы вопросов теперь собраны в разделе Вопросы, все методы отзывов — в разделе Отзывы

• С 14 ноября в ответах со статус-кодом 200, в методах создания отчёта, получения списка отчётов и повторной генерации отчёта, будет только массив data. Поля error, errorText и массив additionalErrors будут исключены. Информация об ошибках будет отдаваться в только ответах с другими статус-кодами

• 19 ноября расширим список ошибок со статус-кодом 409 в методе обновления остатков.
  Вместо "message": "Выбранный склад не предназначен для крупногабаритных товаров. Добавьте их на соответствующий склад" будут возвращаться более детальные ошибки:
  • Выбранный склад не подходит для товаров с типом «СГТ». Загрузите остатки на склад с отметкой — СГТ
  • Выбранный склад не подходит для товаров с типом «КГТ+». Загрузите остатки на склад с отметкой — КГТ+
  • Выбранный склад не подходит для товаров с типом «СГТ/КГТ+». Загрузите остатки на склад с меткой — СГТ или КГТ+
  • Выбранный склад не подходит для товаров с типом «МГТ (малогабаритные товары)». Загрузите остатки на склад без метки СГТ или КГТ+

• Добавили методы формирования аналитики по поисковым запросам:
  • Основная страница
  • Пагинация по группам
  • Пагинация по товарам в группе
  • Поисковые запросы по товару
  • Заказы и позиции по поисковым запросам товара
• Методы доступны только с подпиской Джем

• Добавили описание методов для работы по схеме Доставка курьером WB
• В ответы методов получения новых сборочных заданий и информации о сборочных заданиях добавили поле comment — комментарий покупателя
• В ответ метода получения новых сборочных заданий добавили поле salePrice — цена в валюте продажи с учётом скидки продавца, без учёта скидки WB Клуба, умноженная на 100

• Добавили метод удаления ключей активации
• Увеличили максимальную длину названия предложения и контента до 500 символов

• Теперь в песочнице Цен и скидок доступны методы Календаря акций

• Добавили новый вариант ответа продавца: отклонение заявки на возврат с комментарием, код rejectcustom. Его можно:
  • получить в массиве actions в ответе метода получения заявок покупателей
  • передать в параметре action в запросе метода ответа на заявку.
    При "action":"rejectcustom" нужно указать комментарий, объясняющий решение продавца, в параметре comment. Покупатель получит его вместе с ответом: Здравствуйте! К сожалению, продавец отклонил заявку на возврат. Если вы не согласны с решением продавца, то можете оспорить его в профиле в течение 5 дней с помощью кнопки «Оспорить решение».