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

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

• 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 нельзя будет перевести в доставку
• для сборочных заданий Самовывоз будет невозможно сообщить, что сборочное задание готово к выдаче

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

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

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

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

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

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

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

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

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

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

Разделили лимиты запросов для методов Маркетплейса по моделям продаж:

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

Отделили лимиты получения и удаления метаданных FBS, DBS и Самовывоз от лимитов методов закрепления метаданных.

Выделили отдельные лимиты запросов для методов:

• Складов продавца 
• Остатков на складах продавца

Изменения в разделе Поставки 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 июня
• Вместо него скоро добавим методы отчётов Удержания за занижение габаритов упаковки и Замеры склада. Следите за обновлениями