ВБ Интеграция | WB API

Наша команда создала официальный канал в WB Chat. На новой площадке мы также будем делиться новостями и обновлениями API. Подписывайтесь и следите за новостями там, где вам удобнее.

🔗 Наш канал в WB Chat

❗В ближайшее время мы прекратим поддерживать этот канал в MAX. Актуальную информацию, новости и контент вы сможете найти на других наших площадках:

— Портал для разработчиков
— Документация
— Журнал изменений
— Telegram-канал
— Сообщество

С уважением, команда WB API

#fbw

Расхождения в поставках FBW

Добавили метод GET /api/supplies/v1/discrepancies/{supplyId}. С его помощь вы можете получить расхождения между заявленным и фактическим количеством товара, выявленные при приёмке поставки.

В ответ метода получения деталей поставки — GET /api/v1/supplies/{ID} добавили поле discrepancies — расхождения между заявленным и фактическим количеством товара в поставке.

📖 Журнал изменений WB API
💬 Сообщество WB API

С уважением, команда WB API

#analytics

Изменение времени обновления данных в Истории остатков

С 17 сентября данные по остаткам будут обновляться 1 раз в 2 часа в следующих отчётах:
• Данные по группам
• Данные по товарам
• Данные по размерам
• Данные по складам
• STOCK_HISTORY_REPORT_CSV — отчёт по статистике остатков в методе POST /api/v2/nm-report/downloads
• STOCK_HISTORY_DAILY_CSV — отчёт по истории остатков в методе POST /api/v2/nm-report/downloads

Чтобы получить текущие данные по остаткам без задержки обновления, используйте методы POST /api/analytics/v1/stocks-report/wb-warehouses и POST /api/analytics/v1/stocks-report/seller-warehouses.

📖 Журнал изменений WB API
💬 Сообщество WB API

С уважением, команда WB API

#fbw

Черновики поставок FBW

Добавили методы для работы с черновиками поставок FBW. Теперь с помощью WB API вы можете:
• Создать черновик — POST /api/supplies/v1/drafts
• Добавить товары в черновик — POST /api/supplies/v1/drafts/{draftId}/items
• Получить список черновиков — GET /api/supplies/v1/drafts
• Получить список товаров в черновике — GET /api/supplies/v1/drafts/{draftId}/items
• Удалить товары из черновика — DELETE /api/supplies/v1/drafts/{draftId}/items
• Удалить черновик — DELETE /api/supplies/v1/drafts/{draftId}

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


📖 Журнал изменений WB API
💬 Сообщество WB API

С уважением, команда WB API

#reports

Изменения в Отчётах об удержании

Добавили новые поля в отчёт об удержаниях за занижение габаритов упаковки GET /api/analytics/v1/measurement-penalties:
• dateStart — дата начала действия коэффициента
• dateEnd — дата окончания действия коэффициента

📖 Журнал изменений WB API
💬 Сообщество WB API

С уважением, команда WB API

#items

Документы в методах Работы с товарами

Теперь с помощью WB API вы можете указать документы в карточке товара:
• Сертификат соответствия
• Декларация о соответствии
• Свидетельство о государственной регистрации (СГР)
• Регистрационное удостоверение (РУ) на медицинские изделия
• Регистрационное удостоверение республики Беларусь
• Данные о регистрации пестицида
• Данные о регистрации агрохимиката
• Регистрационное удостоверение (РУ) на лекарственные препараты

Чтобы указать документы в карточке товара, используйте объект documents в запросах методов:
• Создание карточек товаров — POST /content/v2/cards/upload
• Создание карточек товаров с присоединением — POST /content/v2/cards/upload/add
• Редактирование карточек товаров — POST /content/v2/cards/update

Чтобы получить информацию о документах, указанных в карточке товара, используйте объект documents в ответах метода Список карточек товаров — POST /content/v2/get/cards/list.

Передавать документы в массиве characteristics теперь можно только:
• если вы ещё ни разу не указывали в запросах объект documents
• если вы не указывали документы в личном кабинете в обновлённом блоке Документы в карточке товара

Рекомендуем передавать документы только с помощью объекта documents, поскольку, если вы передаёте документы в массиве characteristics, эти документы могут быть обработаны некорректно для любых карточек.

Документы, которые уже были в карточках товаров, будут автоматически продублированы в объекте documents в ответах метода POST /content/v2/get/cards/list.

Напоминаем, что карточки товаров перезаписываются при обновлении. Поэтому передавайте в запросах метода POST /content/v2/cards/update в том числе те документы, которые вы не собираетесь обновлять.

📖 Журнал изменений WB API
💬 Сообщество WB API

С уважением, команда WB API

#fbs

Новые методы Поставок FBS

Добавили методы для работы с данными СПОТ — системы ввоза товаров автомобильным транспортом из стран ЕАЭС. Заполнять данные СПОТ обязательно для всех поставок из ЕАЭС в РФ.

С помощью новых методов вы можете:
• Получать список стран ОКСМ — GET /api/marketplace/v3/fbs/dictionaries/countries/oksm
• Добавлять данные СПОТ в поставку — PUT /api/marketplace/v3/fbs/supplies/{supplyId}/spot
• Получать данные СПОТ для списка поставок — POST /api/marketplace/v3/fbs/supplies/spot/list
• Получать сформированные QR-коды СПОТ — GET /api/marketplace/v3/fbs/supplies/{supplyId}/stickers/spot

Также добавили поле spotAvailable — доступен ли СПОТ для данной поставки — в методы:
• Получить список поставок — GET /api/v3/supplies
• Получить информацию о поставке — GET /api/v3/supplies/{supplyId}

Сейчас методы доступны только для продавцов из Кыргызстана. В дальнейшем методы будут доступны продавцам из любой страны ЕАЭС кроме РФ, следите за обновлениями.

📖 Журнал изменений WB API
💬 Сообщество WB API

С уважением, команда WB API

🔔 Вышел дайджест WB API за август

Проверьте себя:
☐ с 18 августа — закрепить номер ДТ в FBS можно только за сборочными заданиями в статусе confirm
☐ с 1 октября — у продавцов из России параметры отгрузки поставок FBS (способ, дата, пункт), а для транспортной компании и ID ЭТрН, станут обязательными: без них поставку не перевести в доставку

Главное в выпуске:
• продавцы из России теперь задают параметры отгрузки поставок FBS по API
• «Лента заказов» — новый отчёт в реальном времени, придёт на смену методам «Заказы» и «Продажи»
• временные изменения в данных по складам WB в России: часть методов отключена, в отчётах суммарные строки и константы

📄 Читать дайджест

#fbs

Новые методы Поставок FBS

С 1 сентября с помощью WB API продавцы из РФ смогут указывать параметры отгрузки поставок в РФ. Для этого добавили методы:
• Получить список мест отгрузки поставок — GET /api/marketplace/v3/fbs/shipping-points
• Установить параметры отгрузки поставок — PATCH /api/marketplace/v3/fbs/supplies/shipping-method

Для доставки транспортной компанией можно будет указывать ID ЭТрН — электронной транспортной накладной. Чтобы добавить ID ЭТрН в поставку, нужно будет использовать метод PATCH /api/marketplace/v3/fbs/supplies/waybill. Пока метод находится в доработке, о его доступности сообщим дополнительно.

С 1 октября добавление параметров отгрузки и ID ЭТрН станет обязательным. Без этого нельзя будет перевести поставку в доставку — вы получите ошибку 409 в методе PATCH /api/v3/supplies/{supplyId}/deliver.

📖 Журнал изменений WB API
💬 Сообщество WB API

С уважением, команда WB API

#analytics

Новый отчёт по остаткам на складах продавца

Добавили отчёт по остаткам на складах продавца — POST /api/analytics/v1/stocks-report/seller-warehouses.

Используйте новый отчёт вместо метода POST /api/v3/stocks/{warehouseId}, чтобы получить остатки без указания ID складов продавца и ID размеров в запросе.

Данные в отчёте обновляются 1 раз в 30 минут.

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

📖 Журнал изменений WB API
💬 Сообщество WB API

С уважением, команда WB API