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

Отключили возможность обновлять остатки малогабаритных товаров для модели 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Добавили 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 — Комиссия по модели Бронирование, %