ВБ Интеграция | 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

#fbw #rates #reports #analytics #documents

Временные изменения в работе WB API со складами WB с 15 августа

C 15 августа вносим временные изменения в работу WB API. Часть информации по складам WB будет недоступна, подробнее — в новости на Портале продавцов.

Список изменений в работе WB API — в Журнале изменений.

О дальнейших изменениях мы сообщим дополнительно.

Мы готовы ответить на вопросы по этим изменениям в Сообществе WB API.

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

#promotion

Рекомендованные ставки для CPC-кампаний

Добавили отображение рекомендованных ставок для CPC-кампаний — по предложениям пользователей в Сообществе WB API.

Теперь метод GET /api/advert/v0/bids/recommendations возвращает рекомендованные ставки не только для кампаний с типом оплаты CPM за показы, но и для CPC — за клики.

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

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

#fbs

Изменения в заказах FBS

С 18 августа добавить номер декларации на товары (ДТ) можно будет только к сборочным заданиям в статусе confirm.

Также с 18 августа продавцам из Армении будет обязательно указывать номер ДТ для товаров, произведённых вне ЕАЭС, если заказ из Армении доставляется в РФ.

Чтобы проверить, обязательно ли закреплять номер ДТ за сборочным заданием, используйте метод GET /api/v3/orders/new. Обязательные идентификаторы маркировки указаны в поле requiredMeta.

Чтобы добавить номер ДТ к сборочному заданию, передайте его в запросе метода PUT /api/marketplace/v3/orders/{orderId}/meta/customs-declaration в параметре customsDeclaration.

Без обязательного номера ДТ невозможно получить стикеры сборочных заданий методом POST /api/v3/orders/stickers — если хотя бы для одного сборочного не будет указан обязательный номер ДТ, вы получите ошибку 409 CustomsDeclarationIsRequired.

Также, если к сборочному заданию не добавлен обязательный номер ДТ, поставку с этим сборочным заданием невозможно перевести в доставку. В ответе метода PATCH /api/v3/supplies/{supplyId}/deliver вы получите ошибку 409 MetaValidationFail, при этом в поле decision для customsDeclaration вернётся значение required.

Чтобы проверить, добавлен ли обязательный номер ДТ к сборочному заданию, до перевода поставки в доставку, используйте метод POST /api/marketplace/v3/orders/meta. Перевести поставку в доставку можно со статусами filled или optional в поле decision для customsDeclaration.

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

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

#dbs #in_store_pickup

Изменения в сборочных заданиях DBS и Самовывоз

Добавили методы получения данных о ценах продавца без учёта скидок и суммах к оплате покупателем с учетом всех скидок и кэшбека по ID сборочных заданий:
• DBS — POST /api/marketplace/v3/dbs/orders/final-price
• Самовывоз — POST /api/marketplace/v3/click-collect/orders/final-price

Для расчётов используйте суммы к оплате покупателем из ответов новых методов, поля:
• originalFinalPrice — сумма к оплате покупателем в валюте продажи с учетом всех скидок и кэшбека, умноженная на 100.
• convertedOriginalFinalPrice — сумма к оплате покупателем в валюте страны продавца с учетом всех скидок и кэшбека, умноженная на 100.

Значения полей finalPrice и convertedFinalPrice из ответов методов получения сборочных заданий используйте только в случае, когда в ответе новых методов для переданных сборочных заданий возвращается "data": null.

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

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

#analytics #reports

Лента заказов в WB API

Получить отчёт Лента заказов теперь можно с помощью WB API — методом POST /api/analytics/v1/order-feed.
Используйте его в качестве замены методов:
• GET /api/v1/supplier/orders — Заказы
• GET /api/v1/supplier/sales — Продажи
Делитесь с нами обратной связью в Сообществе WB API. На основе ваших комментариев мы сможем сделать переход на новый метод максимально комфортным.

Методы Заказы и Продажи продолжают работать, но, как мы сообщали ранее, в будущем они будут отключены. О дате отключения сообщим заранее.

Преимущества Ленты заказов в сравнении с методами Заказы и Продажи:
• данные обновляются в режиме реального времени
• нет разделения на заказы и выкупы, данные отдаются в рамках одного метода
• есть статусы заказов и причины отмен
• отчёт содержит заказы с отложенной оплатой
• для каждого заказа определён тип продажи: B2B или B2C
• изменяться могут только статусы
• используется офсетная пагинация и товарные фильтры: артикулы WB, бренды, предметы, ярлыки

Метод доступен по токену любого типа для категории Аналитика.

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

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

#fbs

Перенесли дату обновления на ночь с 5 по 6 августа. Напоминаем, что метод GET /api/v3/orders будет возвращать информацию только о сборочных заданиях, созданных менее 3 месяцев назад.

Получить сборочные задания, созданные более 3 месяцев назад, вы сможете только методом GET /api/marketplace/v3/fbs/orders/archive.

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

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

Вышел дайджест WB API за июль

Проверьте себя на этой неделе:
• с 3 августа карточкам товаров нужен токен категории «Контент» вместо «Продвижения»
• с 5 августа склады продавца для сверхгабаритных товаров (СГТ) заводятся и правятся только в личном кабинете

Что ещё изменилось:
• Оценка товара: новая версия отчёта, с данными по скрытым из каталога товарам
• Заказы DBS и Самовывоз: код страны происхождения в номерах ДТ для B2B
• Песочница Вопросов и отзывов: пакетное создание и удаление тестовых отзывов и вопросов
• Продвижение: суммы в валюте аккаунта продавца, ставки в разменных единицах
• Автовозвраты FBS: новые методы — настройки автовозврата продавца и по отдельным товарам

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

#items

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

С 5 августа с помощью API нельзя будет создавать и редактировать склады продавца для сверхгабаритных товаров (СГТ). Данная возможность будет только в личном кабинете.

Что изменится в методах:
• Получить список складов WB — GET /api/v3/offices — в ответе теперь не будут возвращаться СГТ-склады WB
• Создать склад продавца — POST /api/v3/warehouses — при создании СГТ-склада вы получите ошибку 404
• Обновить склад продавца — PUT /api/v3/warehouses/{warehouseId} — при изменении данных СГТ-склада вы получите ошибку 404

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

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

#fbs

Настройки автовозврата для заказов FBS

Добавили методы для работы с автовозвратами FBS для малогабаритных товаров — "cargoType":1 — по предложениям пользователей в Сообществе WB API.

Теперь с помощью WB API вы можете:
• Получить настройки автовозврата продавца — GET /api/v3/settings/autoreturns
• Обновить настройки автовозврата продавца — PATCH /api/v3/settings/autoreturns
• Получить настройки автовозврата товаров — POST /api/v3/settings/autoreturns/items
• Обновить настройки автовозврата товаров — PATCH /api/v3/settings/autoreturns/items
• Получить предметы, которые не хранятся на складах WB — GET /api/v3/settings/autoreturns/subcategories/restricted

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

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