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

Добавили метод получения 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

Теперь с помощью метода Отчёт о продажах по реализации можно получить детализации к ежедневным отчётам реализации. Для этого укажите period=daily в запросе.

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

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

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

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

Метод получения ссылок на стикеры сборочных заданий, которые требуются при кроссбордере, будет отключен 23 октября.

Кампании с ручной и единой ставкой объединили в один тип — 9. Тип кампании 8 устарел, создавать кампании этого типа с 23 октября будет невозможно. Тип ставки в кампании теперь указываем в отдельном поле. Для работы с кампаниями типа 9 обновили методы кампаний Продвижения:

• Метод Создать кампанию теперь создаёт кампании с типом 9 с ручной или единой ставкой. Тип ставки указан в поле bid_type в ответе метода Информация о кампаниях с ручной ставкой 
• В ответ метода Информация о кампаниях с ручной ставкой добавили поле bid_type — тип ставки:
  • manual — ручная ставка
  • unified — единая ставка
• Метод Изменение ставок в кампаниях с ручной ставкой теперь называется Изменение ставок в кампаниях. В запрос этого метода добавили параметр placement — места размещения:
  • search — в поиске (для кампаний с ручной ставкой)
  • recommendations — в рекомендациях (для кампаний с ручной ставкой)
  • combined — в поиске и рекомендациях (для кампаний с единой ставкой)
• В ответе метода Списки кампаний в описание поля type добавили информацию о типе кампании:
  • 4 — в каталоге (устаревший тип)
  • 5 — в карточке товара (устаревший тип)
  • 6 — в поиске (устаревший тип)
  • 7 — в рекомендациях на главной странице (устаревший тип)
  • 8 — кампания с единой ставкой (устаревший тип)
  • 9 — кампания с единой или ручной ставкой. Тип ставки указан в поле bid_type в ответе метода  Информация о кампаниях с ручной ставкой 
• Метод Изменение списка карточек товаров в кампаниях с ручной ставкой теперь называется Изменение списка карточек товаров в кампаниях

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

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

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

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

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

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

24 октября удалим поле needRefund с информацией о возврате товара из методов:

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

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

Создать кампанию с ручной или единой ставкой теперь можно одним методом. Чтобы указать тип ставки в кампании, передайте его в запросе метода в параметре bid_type:

• manual — ручная ставка, указана по умолчанию
• unified — единая ставка

Для кампаний с ручной ставкой укажите зоны показа в параметре placement_types:

• search — показ в поиске, указан по умолчанию
• recommendations — показ в рекомендациях

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

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

• cashback_commission_change — стоимость участия в программе лояльности

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

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

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

Перенесли Статистику по продвижению из раздела Аналитика и данные в раздел Маркетинг и продвижение.

Реализовали новую версию Статистики кампаний:

• Изменили схему запроса метода — в запросе необходимо указывать только ID кампаний и временной интервал.
• Изменили тип HTTP-запроса — теперь для получения статистики нужно использовать метод GET.
• Добавили поле canceled — отмены, шт. Количество продвигаемых товаров, которые заказали, но по техническим причинам не доставили покупателю.

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

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

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

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

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

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

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

• sum — промо-бонусы, ₽
• percent — процент от общей суммы пополнения бюджета кампании, который можно пополнить промо-бонусами за один раз
• expiration_date — дата истечения срока действия промо-бонусов

Добавили параметры для пополнения бюджета кампании промо-бонусами:

• cashback_sum — сумма пополнения бюджета промо-бонусами
• cashback_percent — процент от суммы пополнения, который можно пополнить промо-бонусами

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Сборочные задания, поставки и пропуска 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)
• Получить список новых сборочных заданий  (Самовывоз)
• Получить информацию о завершённых сборочных заданиях (Самовывоз)