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

Добавили метод 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 — ИНН.

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

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

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

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

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