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

С 11 марта для категорий Красота и Бытовая химия будут действовать новые правила объединения карточек товаров. Изменения затронут методы:

• Создание карточек товаров
• Создание карточек товаров с присоединением
• Редактирование карточек товаров

Если карточка в запросе не соответствует новым правилам, методы вернут ответ со статус-кодом 400 и соответствующими значениями поля errorText. В объекте additionalErrors будут перечислены vendorCode карточек товаров, не соответствующих правилам.

Добавили признак B2B-продажи для поставок FBS — поле isB2b — в ответы методов:

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

Вы можете добавить к пустой поставке любое сборочное задание. После этого поставка приобретает признак B2B-продажи добавленного сборочного задания — этот признак будет указан в поле isB2b в ответах методов получения списка поставок и получения информации о поставке.

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

С 19 марта к одной поставке можно будет добавлять только сборочные задания с одинаковым признаком: B2B или не B2B.

С 11 марта методы получения отчётов с заданием на генерацию при отсутствии данных будут возвращать ответ 204 Нет данных вместо пустого массива [] в ответе 200 Успешно.

Список отчётов с заданием на генерацию:

• Остатки на складах
• Операции при приёмке
• Платное хранение

В описание метода получения заявок покупателей на возврат добавили поля:

• origin_id_info — результат сверки IMEI для возврата через ПВЗ Wildberries, который позволяет эффективнее обрабатывать заявки по товарам Apple предмета Смартфоны ("subjectId":515) с ценой со скидкой продавца от 40000 рублей
• delivery_dt — дата и время получения заказа покупателем

Добавили отчёт CSV модели InventoryHistoryReportRes. В запросе на создание отчёта reportType этой модели — STOCK_HISTORY_DAILY_CSV.

В отчёте показываются данные об остатках по состоянию на 23:59.

Данный отчёт доступен без подписки Джем.

Добавили метод получения стикеров для сборочных заданий DBS с доставкой в ПВЗ. Используйте этот метод, чтобы получать стикеры в формате PDF для сборочных заданий в статусах confirm — на сборке — и deliver — в доставке.

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

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

• wbStickerId — ID стикера
• scanPrice — цена приёмки в ПВЗ в копейках

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

• адрес ПВЗ для доставки — в поле address
• тип доставки dbsPickupPoint — доставка силами продавца в ПВЗ — в поле deliveryType

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

Теперь вы можете передать сразу несколько ID сборочных заданий в одном запросе, чтобы:

• перевести сборочные задания на сборку
• сообщить, что сборочные задания готовы к выдаче
• сообщить, что заказы приняты покупателями
• сообщить об отказе от заказов
• получить статусы сборочных заданий
• отменить сборочные задания
• получить метаданные сборочных заданий
• удалить метаданные сборочных заданий
• закрепить коды маркировки товара за сборочными заданиями
• закрепить УИН за сборочными заданиями
• закрепить IMEI за сборочными заданиями
• закрепить GTIN за сборочными заданиями

Новые методы заменят устаревшие методы в разделах Сборочные задания Самовывоз и Метаданные Самовывоз.

Для более гибкого управления доступом к данным продавца вводим обновление токенов WB API — теперь новые методы будут доступны в зависимости от типа токена:

• Персональный
• Сервисный — включая авторизацию по OAuth
• Базовый

Категория методов Управление пользователями продавца уже доступна только по Персональному токену.

Добавили поле orderStatus — статус заказа — в ответы методов:

• Список отзывов
• Получить отзыв по ID
• Список архивных отзывов

Возможные значения поля:

• buyout — выкуплен
• rejected — отказ
• returned — возврат
• notSpecified — статус не присвоен

Добавили методы:

• Списки активных и неактивных поисковых кластеров
• Статистика по поисковым кластерам с детализацией по дням

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

• shks — количество заказанных товаров
• spend — затраты на продвижение товаров в конкретном поисковом кластере кампании

Метод изменения списка карточек товаров в кампаниях перенесли в подраздел Управление кампаниями.

Добавили поле currency — валюта отчёта — в методы:

• Воронка продаж
• История остатков
• Аналитика продавца CSV — типы отчётов DETAIL_HISTORY_REPORT и GROUPED_HISTORY_REPORT

До 11 февраля добавим поле currency в отчёты:

• Поисковые запросы по вашим товарам
• Аналитика продавца CSV — остальные типы отчётов

С 11 февраля:

• денежные значения во всех отчётах раздела Аналитика и данные будут возвращаться в валюте той страны, где зарегистрирован продавец.
• значение поля currency будет определяться страной, где зарегистрирован продавец.

Изменения появятся постепенно у всех продавцов до 16 февраля.

Добавили метод получения информации о покупателе B2B для модели DBS. Теперь с помощью WB API вы можете получить данные B2B-покупателя:

• ИНН
• КПП
• Наименование организации

Добавили поле crossBorderType с информацией, является ли сборочное задание кроссбордером, в ответы методов FBS:

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

Вы можете добавить в пустую поставку сборочное задание любого типа: кроссбордер или не кроссбордер. После этого поставка приобретает тип первого добавленного в неё сборочного задания — этот тип будет указан в поле crossBorderType в ответах методов:

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

Со 2 марта в поставку можно будет добавлять только сборочные задания того же типа, что и у поставки.

10 февраля отключим неактуальное поле statusID — статус товара — в ответах методов:

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

С 5 февраля изображения в поле photoLinks будут возвращаться в формате webp вместо jpg для методов:

• Список отзывов
• Получить отзыв по ID
• Список архивных отзывов

В ответ метода Отчёт о продажах по реализации добавили поля c информацией о скидках за промокоды:

• uuid_promocode — ID промокода
• sale_price_promocode_discount_prc — скидка за промокод, %

В ежедневных отчётах новые поля появятся начиная с отчёта за 19 января, а в еженедельных — с отчёта за 19–25 января.

2 февраля отключим неактуальное поле clientID — ID покупателя — в ответах методов:

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

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

Чтобы проверить, можно ли указать номер ГТД для сборочного задания, используйте методы получения списка новых сборочных заданий FBS и DBS:

• если в поле ответа requiredMeta будет значение customsDeclaration, вы можете указать номер ГТД
• если в ответе в поле requiredMeta нет значения customsDeclaration, вы не можете указать номер ГТД

Чтобы указать номер ГТД, используйте новые методы:

• Закрепить за сборочным заданием номер ГТД — FBS
• Закрепить за сборочными заданиями номер ГТД — DBS

Чтобы проверить указанный номер ГТД, используйте методы получения метаданных сборочных задания FBS и DBS. Указанный номер ГТД будет представлен в поле customsDeclaration.

Чтобы удалить указанный номер ГТД, используйте методы удаления метаданных сборочных заданий FBS и DBS.

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

Теперь вы можете передать сразу несколько ID сборочных заданий в одном запросе, чтобы:

• получить статусы сборочных заданий  
• отменить сборочные задания 
• перевести сборочные задания на сборку 
• перевести сборочные задания в доставку 
• сообщить, что заказы приняты покупателем 
• сообщить, что покупатель отказался от заказов 
• получить метаданные сборочных заданий 
• удалить метаданные сборочных заданий 
• закрепить коды маркировки товара за сборочными заданиями  
• закрепить УИН за сборочными заданиями 
• закрепить IMEI за сборочными заданиями 
• закрепить GTIN за сборочными заданиями  

Новые методы заменят устаревшие методы в разделах Сборочные задания DBS  и Метаданные DBS.

В ответ метода Отчёт о продажах по реализации добавили поля c информацией о скидках лояльности от продавца:

• loyalty_id — ID скидки лояльности от продавца
• loyalty_discount — размер скидки лояльности от продавца, %

В ежедневных отчётах новые поля появятся начиная с отчёта за 12 января, а в еженедельных — с отчёта за 12–18 января.

В ответ метода Отчёт о продажах по реализации добавили поля c информацией о собственных акциях продавца с дополнительными скидками:

• seller_promo_id — ID собственной акции продавца с дополнительной скидкой
• seller_promo_discount — размер дополнительной скидки по собственной акции продавца, %

В ежедневных отчётах новые поля появятся начиная с отчёта за 29 декабря, а в еженедельных — с отчёта за 29–31 декабря.

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

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

Добавили новые методы получения отчётов о занижении габаритов упаковки:

• Удержания за занижение габаритов упаковки
• Замеры склада

Неактуальный метод получения этих данных отключим 27 января.

Переходим на работу с кампаниями с ручной и единой ставкой — тип 9.

Методы для работы с кампаниями с единой ставкой — тип 8 — будут отключены 2 февраля:

• Список карточек товаров для кампании с единой ставкой 
• Изменение списка карточек товаров в кампании с единой ставкой 
• Статистика кампании с единой ставкой по кластерам фраз

Дата отключения метода Установка/удаление минус-фраз для кампании с единой ставкой переносится с 15 января на 2 февраля.

В ответ метода Список чатов добавили объект lastMessage с информацией о последнем сообщении в чате:

• text — текст сообщения
• addTimestamp — время сообщения

В детализации к отчётам реализации добавили поле delivery_method c информацией о способе продажи и типе товара. Теперь вы можете соотнести позиции в отчёте с тарифами в зависимости от способа доставки.

Поле delivery_method отображается только для моделей FBS, FBW и DBW.

В ежедневных отчётах новое поле появится начиная с отчёта за 22 декабря, а в еженедельных — с отчёта за 22–28 декабря.