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

#fbs #dbw #dbs #in_store_pickup #items

Технические работы в сервисе Маркетплейс

В ночь с 5 на 6 октября с 2:00 до 2:45 по Москве проведём технические работы в сервисе Маркетплейс.

Будут недоступны методы:
• Заказов FBS
• Заказов DBW
• DBS
• Самовывоз
• Складов продавца
• Остатков на складах продавца

До 5:30 по Москве данные будут обновляться с задержкой.

Рекомендация: дождитесь, когда технические работы закончатся, прежде чем работать с методами сервиса.

Статус сервисов можно проверить в Статусе API.

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

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

Technical maintenance in Marketplace service

On the night of October 5 to 6 from 2:00 to 2:45 Moscow time, we will conduct technical maintenance in the Marketplace service.

Methods that will be unavailable:
• FBS Orders
• DBW Orders
• DBS
• In-Store Pickup
• Seller Warehouses
• Seller Warehouses Inventory

Data will be updated with a delay until 5:30 Moscow time.

Recommendation: please wait until the technical maintenance is complete before using the service methods.

You can check the service status in the API Status.

Best regards, WB API team

#items

Дополнительный GTIN в карточках товаров

Добавили параметр gtin в методы:
• POST content/v2/cards/upload
• POST content/v2/cards/update
• POST content/v2/cards/upload/add
Указывайте дополнительный GTIN в новом параметре только если такое же значение GTIN вы ранее указывали в одной из карточек товара в параметре skus. Нельзя указывать один и тот же GTIN в skus для разных карточек или размеров товаров

Дополнительный gtin теперь также возвращается в ответе метода POST content/v2/get/cards/list — поле gtin.

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

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

Additional GTIN in Listings

Added the gtin parameter to the following methods:
• POST /content/v2/cards/upload
• POST /content/v2/cards/update
• POST /content/v2/cards/upload/add
Specify the additional GTIN in the new parameter only if you have previously indicated the same GTIN value in the skus parameter of one of the listings. It is not possible to specify the same GTIN in skus for different listings or item sizes.

The additional GTIN is now also returned in the response of the POST /content/v2/get/cards/list method — the gtin field.

📖 WB API Release Notes

Best regards, WB API team

#analytics

Изменения в Аналитике продавца CSV

С 12 октября в отчёте по текстам поисковых запросов по вашим товарам — SEARCH_QUERIES_PREMIUM_REPORT_TEXT — метода GET /api/v2/nm-report/downloads/file/{downloadId} отключим поля:
• OpenCardPercentile — процент, на который показатель количества открытий карточки товара выше, чем у карточек других продавцов по поисковому запросу
• AddToCartPercentile — процент, на который показатель добавлений в корзину выше, чем у карточек других продавцов по поисковому запросу
• OpenToCartPercentile — процент, на который показатель конверсии в корзину выше, чем у карточек других продавцов по поисковому запросу
• OrdersPercentile — процент, на который показатель заказов выше, чем у карточек других продавцов по поисковому запросу
• CartToOrderPercentile — процент, на который показатель конверсии в заказ выше, чем у карточек других продавцов по поисковому запросу

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

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

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

Changes in the Seller Analytics CSV

Starting from October 12, in the Search Texts Report — SEARCH_QUERIES_PREMIUM_REPORT_TEXT — of the GET /api/v2/nm-report/downloads/file/{downloadId} method, we will disable the following fields:
• OpenCardPercentile — the percentage by which click-throughs is higher than that of other sellers' pages for the search text
• AddToCartPercentile — the percentage by which adds-to-Cart is higher than that of other sellers' pages for the search text
• OpenToCartPercentile — the percentage by which conversion to cart is higher than that of other sellers' pages for the search text
• OrdersPercentile — the percentage by which items ordered is higher than that of other sellers' pages for the search text
• CartToOrderPercentile — the percentage by which conversion to order is higher than that of other sellers' pages for the search text

📖 WB API Release Notes

Best regards, WB API team

#items

Новые методы для работы с товарами

Добавили методы для работы с карточками товаров. Теперь с помощью WB API вы можете получить:
• Список кодов ТН ВЭД — GET /api/content/v2/directory/tnved/all
• Код ОКПД2 предмета — GET /api/content/v2/directory/okpd
• Список кодов ОКПД2 — GET /api/content/v2/directory/okpd/all

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

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

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

New Methods for Item Management

Added methods for working with listings. Now, using the WB API, you can get:
• HS-codes List — GET /api/content/v2/directory/tnved/all
• Subcategory OKPD2 Code — GET /api/content/v2/directory/okpd
• OKPD2 Codes List — GET /api/content/v2/directory/okpd/all

📖 WB API Release Notes

Best regards, WB API team

#reports

Новые поля в детализациях к отчётам реализации

Добавили новые поля в детализации к отчётам реализации POST /api/finance/v1/sales-reports/detailed/{reportId} и POST api/finance/v1/sales-reports/detailed:
• buyerTaxRegistrationReasonCode — КПП B2B-покупателя
• utdUcdNumber — номер УПД или УКД
• utdUcdDate — дата УПД или УКД

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

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

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

New Fields in Details for the Realization Reports

Added new fields to details for the realization reports POST /api/finance/v1/sales-reports/detailed/{reportId} and POST api/finance/v1/sales-reports/detailed:
• buyerTaxRegistrationReasonCode — tax registration reason code of B2B-buyer
• utdUcdNumber — universal transfer or adjustment document number
• utdUcdDate — universal transfer or adjustment document date

📖 API Release Notes

Best regards, WB API team

#analytics

Изменение времени обновления данных в Воронке продаж и Аналитике продавца CSV

С 24 сентября данные обновляются 1 раз в 2 часа в следующих отчётах:
• Статистика карточек товаров за период
• Статистика карточек товаров по дням
• Статистика групп карточек товаров по дням
• DETAIL_HISTORY_REPORT — отчёт воронки продаж по артикулам WB в методе POST /api/v2/nm-report/downloads
• GROUPED_HISTORY_REPORT — отчёт воронки продаж по предметам, брендам и ярлыкам в методе POST /api/v2/nm-report/downloads

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

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

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

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

Change in Data Update Time for the Sales Funnel and Seller Analytics CSV

Starting from September 24, data is updated once every 2 hours in the following reports:
• Listings Statistics per Period
• Listings Statistics per Days
• Grouped Listings Statistics per Days
• DETAIL_HISTORY_REPORT — sales funnel report by WB item numbers in the POST /api/v2/nm-report/downloads method
• GROUPED_HISTORY_REPORT — sales funnel report by subjects, brands and tags in the POST /api/v2/nm-report/downloads method

To get current data without the update delay, use the POST /api/analytics/v1/order-feed method.

📖 WB API Release Notes

Best regards, WB API team

#reports

Новая версия отчёта по возвратам и перемещению товаров

Добавили новую версию метода получения отчёта Возврат и перемещение товаров — GET /api/analytics/v1/goods-return. C её помощью вы можете получать данные как по активным, так и по архивным возвратам за любой период времени.

В новом методе:
• добавили параметр status:
• укажите active, чтобы получить в отчёте только активные возвраты
• укажите archive, чтобы получить в отчёте только архивные возвраты
• добавили пагинацию — параметры limit и offset

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

Текущий метод GET /api/v1/analytics/goods-return будет отключен 26 октября.

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

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

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

New Version of the Returns and Item Movement Report

Added a new version of the Returns and Item Movement Report method — GET /api/analytics/v1/item-returns. With this method, you can get data on both active and archived returns for any period of time.

In the new method:
• We added the status parameter:
• specify active to get only active returns in the report
• specify archive to get only archived returns in the report
• We added pagination — the limit and offset parameters

The method is available with a token of any type for the Analytics category.

The current method GET /api/v1/analytics/goods-return will be disabled on October 26.

📖 WB API Release Notes

Best regards, WB API team

#fbw

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

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

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

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

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

Discrepancies in FBW supplies

Added the method GET /api/supplies/v1/discrepancies/{supplyId}. With this method, you can get the discrepancies between the declared and actual quantity of items identified during supply acceptance.

We have also added the discrepancies field to the response of the method for getting supply details — GET /api/v1/supplies/{ID}. This field contains the discrepancies between the declared and actual quantity of items in the supply.

📖 WB API Release Notes

Best regards, WB API team

#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

🔗 Читайте в МАКС

Changing the Data Update Time for the Stocks Report

Starting from September 17, the report data will be updated once every 2 hours in the following reports:
• Group Data
• Item Data
• Size Data
• Warehouse Data
• STOCK_HISTORY_REPORT_CSV — inventory metrics report in the POST /api/v2/nm-report/downloads method
• STOCK_HISTORY_DAILY_CSV — inventory history report in the POST /api/v2/nm-report/downloads method

To get the current inventory data without delaying the update, use the methods POST /api/analytics/v1/stocks-report/wb-warehouses and POST /api/analytics/v1/stocks-report/seller-warehouses.

📖 WB API Release Notes

Best regards, WB API team

Изменения в API Продвижения

Добавили новую версию метода получения бюджета кампаний — POST /api/advert/v2/budget. Теперь с помощью WB API вы можете получить остатки бюджетов по нескольким кампаниям одним запросом.

Текущий метод GET /adv/v1/budget будет отключён 16 ноября.

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

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

🔗 Читайте в MAX

Changes in the Promotion API

Added a new version of the method for getting campaign budgets — POST /api/advert/v2/budget. Now, using the WB API, you can get the budget balances for multiple campaigns with a single request.
The current method GET /adv/v1/budget will be disabled on November 16.

The methods are available for Personal and Service tokens of the Supplies category.

📖 WB API Release Notes

Best regards, WB API team

#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

🔗 Читайте в MAX

FBW Supply Drafts

Added the methods for working with FBW supply drafts. Now, using the WB API, you can:
• Create a draft — POST /api/supplies/v1/drafts
• Add items to a draft — POST /api/supplies/v1/drafts/{draftId}/items
• Get a list of drafts — GET /api/supplies/v1/drafts
• Get a list of items in a draft — GET /api/supplies/v1/drafts/{draftId}/items
• Delete items from a draft — DELETE /api/supplies/v1/drafts/{draftId}/items
• Delete a draft — DELETE /api/supplies/v1/drafts/{draftId}

The methods are available for Personal and Service tokens of the Supplies category.

📖 WB API Release Notes

Best regards, WB API team

#reports

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

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

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

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

🔗 Читайте в MAX

Changes in Retention Reports

Added new fields to the logistics and storage costs multiplier report GET /api/analytics/v1/measurement-penalties:
• dateStart — warehouse multipier start date and time
• dateEnd — warehouse multipier end date and time

📖 WB API Release Notes

Best regards, WB API team

#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

🔗 Читайте в MAX

Documents in Item Management methods

Now you can use the WB API to specify documents in the listing:
• Certificate of Conformity
• The Correspondence Declaration
• Certificate of Registration of SGR
• Registration Certificate
• Certificate of Registration of the Republic of Belarus
• Registration of a Pesticide
• Registration of an Agrochemical
• Medicine Registration Certificate

To specify the documents in the listing, use the documents object in the requests for methods :
• List Items — POST /content/v2/cards/upload
• List Items with Merge — POST /content/v2/cards/upload/add
• Update Listings — POST /content/v2/cards/update

To get information about the documents specified in the listing, use the documents object in the responses for the Listings method — POST /content/v2/get/cards/list.

You can now only pass documents in the characteristics array:
• if you have never specified the documents object in your requests
• if you have not specified documents in your personal account in the updated Documents section in listings.

We recommend passing documents only using the documents object, because if you pass documents in the characteristics array, these documents may be processed incorrectly for any listings.

Documents that have already been in listings will be automatically duplicated in the documents object in the responses for the POST /content/v2/get/cards/list method.

We remind you that listings are overwritten during updates. Therefore, in the requests for the POST /content/v2/cards/update method, include those documents that you are not going to update.

📖 WB API Release Notes

Best regards, WB API team

#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

🔗 Читайте в МАКС

New FBS Supplies Methods

Added the methods for working with SPOT data — the system for importing goods by road from EAEU countries. Filling in SPOT data is mandatory for all supplies from EAEU countries to the Russian Federation.

With the new methods, you can:
• Get the OKSM country list — GET /api/marketplace/v3/fbs/dictionaries/countries/oksm
• Add SPOT data to supply — PUT /api/marketplace/v3/fbs/supplies/{supplyId}/spot
• Get SPOT data for supply list — POST /api/marketplace/v3/fbs/supplies/spot/list
• Get the supply generated SPOT QR codes — GET /api/marketplace/v3/fbs/supplies/{supplyId}/stickers/spot

Also added the spotAvailable field — indicating whether SPOT is available for the supply — to the following methods:
• Get supplies list — GET /api/v3/supplies
• Get supply details — GET /api/v3/supplies/{supplyId}

Currently, the methods are available only to sellers from Kyrgyzstan. In the future, the methods will be available to sellers from any EAEU country except the Russian Federation. Stay tuned for updates.

📖 WB API Release Notes

Best regards, WB API team

#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

🔗 Читайте в МАКС

New FBS Supplies Methods

Starting September 1, the Russian Federation sellers will be able to specify shipping method for supplies within the Russian Federation using WB API. To enable this, added the following methods:
• Get Supply Shipping Points — GET /api/marketplace/v3/fbs/shipping-points
• Set Supply Shipping Method — PATCH /api/marketplace/v3/fbs/supplies/shipping-method

For shipping by a transport company, you will be able to specify the electronic waybill ID. To add the waybill ID to a supply, you will need to use the PATCH /api/marketplace/v3/fbs/supplies/waybill method. This method is currently under development. We will provide an update regarding its availability.

Starting October 1, specifying shipping parameters and waybill IDs will become mandatory. Without this data, you will not be able to transfer supply to delivery — you will receive a 409 error in the PATCH /api/v3/supplies/{supplyId}/deliver method.

📖 WB API Release Notes

Best regards, WB API team