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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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