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

Добавили новую версию метода получения детализаций к отчётам реализации за период — POST /api/finance/v1/sales-reports/detailed.

В новой версии:

• добавили настройку полей отчёта: теперь вы можете получать только те поля, которые указываете в запросе в массиве fields
• изменили стиль названий полей на camelCase
• стандартизировали названия полей, чтобы они совпадали с другими методами WB API
• изменили с number на string значения полей, в которых передаются данные о суммах денег
• добавили поле title — название товара
• не использовали аналоги неактуальных полей suppliercontract_code и ppvz_supplier_id

Метод доступен по токену для категории Финансы.

Текущая версия — GET /api/v5/supplier/reportDetailByPeriod — будет отключена 15 июля.

Также добавили методы получения:

• списка отчётов реализации — POST /api/finance/v1/sales-reports/list
• детализаций к отчётам реализации по ID отчётов — POST /api/finance/v1/sales-reports/detailed/{reportId}

Методы доступны по Персональному или Сервисному токену для категории Финансы.

Рекомендуем изучить таблицу сопоставления названий полей в методах получения детализаций к отчётам реализации. Пометка S означает, что в новых методах тип поля — string.

Добавили методы получения:

• списка отчётов об издержках на приём платежей — POST /api/finance/v1/acquiring/list
• детализаций к отчётам об издержках на приём платежей по ID отчётов — POST /api/finance/v1/acquiring/detailed/{reportId}
• детализаций к отчётам об издержках на приём платежей за период — POST /api/finance/v1/acquiring/detailed

Методы доступны только для продавцов из России по Персональному или Сервисному токену для категории Финансы.

Теперь с помощью WB API вы можете подтвердить, что на товар нанесён обязательный код маркировки. Для этого передайте значение true для параметра kizMarked в запросах методов:

• POST /content/v2/cards/upload
• POST /content/v2/cards/upload/add
• POST /content/v2/cards/update

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

Чтобы проверить, является ли код маркировки обязательным для товара, используйте метод POST /content/v2/get/cards/list, поле ответа needKiz:

• true — код маркировки требуется
• false — код маркировки не требуется

Чтобы проверить, подтвердили ли вы, что обязательный код маркировки нанесён на товар, используйте поле ответа kizMarked в методах POST /content/v2/get/cards/list и POST /content/v2/get/cards/trash.

Подробнее о кодах маркировки — в справочном центре.

Добавили поля в ответ метода получения стикеров сборочных заданий кроссбордера POST /api/v3/orders/stickers/cross-border. В полях указаны данные для печати стикеров:

• partA — первая часть ID стикера для печати подписи
• partB — вторая часть ID стикера для печати подписи
• barcode — закодированное значение стикера

В детализации к отчётам реализации — GET /api/v5/supplier/reportDetailByPeriod — добавили поля c информацией о подменных артикулах и оптовой скидке для бизнеса:

• article_substitution — ID подменного артикула
• sale_price_affiliated_discount_prc — скидка по подменному артикулу, %
• sale_price_wholesale_discount_prc — оптовая скидка для бизнеса, %

Теперь с помощью WB API вы можете узнать дату и время, когда карточка товара попала в черновики. Для этого добавили в ответ метода POST /content/v2/cards/error/list поле updatedAt для каждого пакета данных — дата и время создания или изменения пакета.

Теперь статистика в методах POST /adv/v0/normquery/stats и POST /adv/v1/normquery/stats доступна для кампаний с типом оплаты cpc — за клики.

Для этих кампаний вы можете получить все данные, кроме:

• количества просмотров — views
• кликабельности — ctr
• средней стоимости за тысячу показов — cpm

Добавили метод GET /api/common/v1/subscriptions, с помощью которого вы можете получить подробную информацию о подписке Джем:

• Даты активации и окончания
• Способ оформления и уровень подписки
• Статус — активна ли подписка

Метод доступен через Сервисный токен любой категории.

Добавили метод GET /api/common/v1/rating, с помощью которого вы можете получить пользовательский рейтинг продавца и количество отзывов.

Метод доступен через Сервисный токен категории Вопросы и отзывы.

Добавили проверку метаданных сборочных заданий FBS. Теперь, если метаданные сборочных заданий будут указаны некорректно, вы получите ошибку с кодом 409 при переводе поставки в доставку PATCH /supplies/{supply}/deliver. В ошибке будут указаны статусы метаданных по каждому сборочному заданию.

С 31 марта начнёт проверяться IMEI, с 7 апреля — УИН, с 9 апреля — код маркировки для B2B-заказов.

Подробнее о проверке метаданных вы можете узнать в справочном центре.

Также обновили ответ метода получения метаданных POST /api/marketplace/v3/orders/meta:

• Добавили массив metaDetails. В нём возвращаются статусы проверки метаданных сборочных заданий. Используйте этот метод перед переводом поставки в доставку.
• 30 апреля удалим неактуальный объект meta.

Расширили список разделов личного кабинета, к которым можно настроить доступ сотрудникам:

• oldAnalyticsReports — Отчёты
• marketplace — Свой склад

Указывайте новые разделы в запросах методов:

• Создать приглашение для нового пользователя POST /api/v1/invite
• Изменить права доступа пользователей PUT /api/v1/users/access

Обновлённый список разделов можно получить в ответе метода GET /api/v1/users.

1 апреля добавим поле status в ответ метода получения стикеров сборочных заданий кроссбордера POST /api/v3/orders/stickers/cross-border. Благодаря новому полю вы сможете отслеживать статус генерации стикера:

• awaitingTrackNumber — стикер не готов. Ожидается трек-номер от перевозчика.
• ready — стикер готов

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

В ответ метода получения информации о продавце GET /api/v1/seller-info добавили поле tin — ИНН.

Добавили метод получения текущих остатков на складах WB — POST /api/analytics/v1/stocks-report/wb-warehouses.

В новом методе:

• расширили лимит запросов на один аккаунт продавца до 1 раза в 20 секунд
• увеличили количество строк в ответе до 250 000
• реализовали отображение всех остатков одного размера на одном складе строго в одной строке
• ввели офсетную пагинацию
• изменили сортировку: данные выдаются по возрастанию значений артикулов WB
• добавили в ответы ID складов и регионы отгрузки
• добавили возможность получения данных по конкретным товарам

Метод доступен по Персональному или Сервисному токену для категории Аналитика.

Текущий метод GET /api/v1/supplier/stocks будет отключён 23 июня.

Теперь методы управления пользователями доступны для всех стран продавцов. С помощью этих методов вы можете:

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

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

Для авторизации используйте Персональный токен с категорией Пользователи.

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

Если за сборочным заданием не закреплён обязательный IMEI, в ответе метода POST /api/marketplace/v3/dbs/orders/status/deliver вы получите ошибку со статус-кодом 409 и "detail":"ImeiIsNotFilled".

Проверяйте метаданные сборочного задания в массиве requiredMeta ответа метода GET /api/v3/dbs/orders/new.

Добавили поле isBoxOnPallet — тип поставки Поштучная паллета — в ответы методов:

• Опции приёмки
• Список поставок
• Детали поставки

Добавили поле boxTypeID — ID типа поставки — в ответ метода Список поставок.

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

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

С 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

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

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

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

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

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

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

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

Добавили поле 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 декабря.

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

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

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

Добавили ответы со статусами модерации файла для метода Получить файл из сообщения:

• 202 Файл на модерации
• 451 Файл не прошёл модерацию

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

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

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

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

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

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

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

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

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