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

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

• 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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