#analytics

Новая версия Оценки товара и отключение метода Скрытые из каталога

Добавили новую версию метода получения отчёта Оценка товара — POST /api/analytics/v2/item-rating. C её помощью вы можете получать данные отдельно по скрытым из каталога товарам.

В новом методе:
• добавили параметр onlyShadowedNms:
• укажите true, чтобы получить в отчёте только скрытые из каталога товары
• укажите false, чтобы получить в отчёте все товары, если не указаны другие параметры
• добавили поле isShadowed — является ли товар скрытым из каталога
• изменили наименование массива ответа cards на items
• изменили наименование параметра isNotIncludeNMsWithoutSales на isNotIncludeNmsWithoutSales

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

Текущие методы POST /api/analytics/v1/item-rating и GET /api/v1/analytics/banned-products/shadowed будут отключены 30 июля.

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

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

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

New Version of Item Rating and Disabling the Hidden from Catalog Method

Added new version of the method for getting the Item Rating report — POST /api/analytics/v2/item-rating. Using one, you can get data separately for items hidden from catalog.

In the new method we:

• added the onlyShadowedNms parameter:
• specify true to get only items hidden from catalog in the report
• specify false to get all items unless other parameters are specified
• added the isShadowed field — is the item hidden from catalog
• changed the name of the cards response array to items
• changed the name of the isNotIncludeNMsWithoutSales parameter to isNotIncludeNmsWithoutSales

The method is available by Personal or Service token for the Analytics category.

The POST /api/analytics/v1/item-rating and GET /api/v1/analytics/banned-products/shadowed current methods will be disabled on July 30.

📖 WB API Release Notes

#promotion

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

В ответ метода GET /api/advert/v1/config добавили информацию о минимальной сумме пополнения бюджета кампании — поле minTopUp.

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

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

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

Changes in Promotion service

In the response of the GET /api/advert/v1/config added the minTopUp field — information about the minimum campaign budget top-up amount.

📖 WB API Release Notes

#fbs

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

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

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

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

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

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

Auto-Return Settings for FBS Orders

Added auto-return settings methods for FBS orders for small-sized items — "cargoType":1.

Now you can:
• Get auto-return seller settings — GET /api/marketplace/v3/fbs/settings/autoreturns
• Update seller auto-return settings — PATCH /api/marketplace/v3/fbs/settings/autoreturns
• Get item auto-return settings — POST /api/marketplace/v3/fbs/settings/autoreturns/items
• Update item auto-return settings — PATCH /api/marketplace/v3/fbs/settings/autoreturns/items
• Get subcategories that can't be returned to the warehouse — GET /api/marketplace/v3/fbs/settings/autoreturns/subcategories/restricted

📖 WB API Release Notes
Best regards, WB API team

#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

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

Change in Seller Warehouses Methods

Starting from August 5, you will not be able to create and edit seller warehouses for over dimensional cargo (ODC) using the API. This feature will only be available in seller account.

What will be changed in the methods:
• Get Offices — GET /api/v3/offices — WB warehouses for ODC will no longer be returned in the response
• Create Warehouse — POST /api/v3/warehouses — when you create an ODC warehouse, you will get the error 404
• Update Warehouse — PUT /api/v3/warehouses/{warehouseId} — when you edit ODC warehouse details, you will get the error 404

📖 WB API Release Notes

Best regards, WB API team

#fbs

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

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

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

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

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

Moved the update date to the night of August 5-6. Please note that the GET /api/v3/orders method will return information only about assembly orders created less than 3 months ago.

You can get assembly orders created more than 3 months ago only with the GET/api/marketplace/v3/fbs/orders/archive method.

📖 WB API Release Notes

Best regards, WB API team

#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

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

Order Feed in WB API

Using WB API you can now get the Order Feed report with the POST /api/analytics/v1/order-feed method.
Use it as substitution for the methods:
• GET /api/v1/supplier/orders — Orders
• GET /api/v1/supplier/sales — Sales
Share your feedback with us in WB API Community. Based on your comments, we can make the transition to the new method as comfortable as possible.

The Orders and Sales methods continue to work, but, as we reported earlier, we will disable them in the future. We will inform you about the disabling date in advance.

Order Feed advantages in comparison with the Orders and Sales methods:
• the data is updated in real time
• no division into orders and purchases, the data is given within the same method.
• there are order statuses and cancellation reasons
• the report includes orders with delayed payments
• sale type — B2B or B2C — is defined for every order
• only statuses can be changed
• offset pagination and item filters — WB item numbers, brands, subcategories, labels — are used

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

📖 WB API Release Notes

#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

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

Changes for DBS and In-Store Pickup Orders

Added methods for getting seller prices excluding discounts and amounts charged to the buyer including all discounts and cashback by assembly order IDs:
• DBS — POST /api/marketplace/v3/dbs/orders/final-price
• In-Store Pickup — POST /api/marketplace/v3/click-collect/orders/final-price

For calculations, use the sums charged to the buyer from the responses of the new methods, fields:
• originalFinalPrice — the amount charged to the buyer in the sale currency including all discounts and cashback, multiplied by 100.
• convertedOriginalFinalPrice — the amount charged to the buyer in the seller’s country currency including all discounts and cashback, multiplied by 100.

Use the values of the finalPrice and convertedFinalPrice fields from the methods for getting assembly orders only when the response of the new methods returns "data": null for the specified assembly orders.

📖 WB API Release Notes

Best regards, WB API team

#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

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

Changes in FBS Orders

Starting from August 18, you will only be able to add a customs declaration number to assembly orders with the confirm status.

Also, starting from August 18, sellers from Armenia will be required to specify a customs declaration number for items produced outside the EAEU if an order from Armenia is being delivered to the Russian Federation.

To check whether it is required to add a customs declaration to an assembly order, use the GET /api/v3/orders/new method. The required label identifiers are listed in the requiredMeta field.

To add a customs declaration number to an assembly order, pass it in the request of the PUT /api/marketplace/v3/orders/{orderId}/meta/customs-declaration method in the customsDeclaration parameter.

Without the required customs declaration number, it is impossible to get assembly order stickers using the POST /api/v3/orders/stickers method — if the required customs declaration number is not specified for at least one assembly order, you will receive error 409 CustomsDeclarationIsRequired.

Also, if the required customs declaration number is not added to the assembly order, the supply with this assembly order cannot be transferred to delivery. In the response of the PATCH /api/v3/supplies/{supplyId}/deliver method, you will receive error 409 MetaValidationFail, and the decision field for customsDeclaration will return the required value.

To check whether the required customs declaration number is added to the assembly order before transferring the supply to delivery, use the POST /api/marketplace/v3/orders/meta method. You can transfer a supply to delivery if the decision field for customsDeclaration returns filled or optional statuses.

📖 WB API Release Notes

Best regards, WB API team

#promotion

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

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

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

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

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

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

Recommended Bids for CPC Campaigns

The GET /api/advert/v0/bids/recommendations method now returns recommended bids not only for campaigns with the CPM payment type — per impressions, but also for CPC — per clicks.

📖 WB API Release Notes

Best regards, WB API team

#fbw #rates #reports #analytics #documents

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

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

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

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

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

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

🔗 Читайте в MAX

Temporary Сhanges in the Work of WB API with WB Warehouses Starting from August 15

Starting from August 15 we are making temporary changes to how WB API works. Some information about WB warehouses is not available, see more in the news on Sellers Portal.

The list of changes in the work of WB API is available in Release Notes.

We will inform you about further changes later.

We are ready to answer questions about these changes in WB API Community.

Best regards, WB API team

#analytics

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

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

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

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

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

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

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

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

New Inventory Report on Seller Warehouses

Added a report on the seller warehouses inventory — POST /api/analytics/v1/stocks-report/seller-warehouses.

Use the new report instead of the POST /api/v3/stocks/{warehouseId} method to get the inventory without specifying the seller warehouse ID and size ID in the request.

The data in the report is updated once every 30 minutes.

The method is available for Personal and Service tokens of the Analytics category.

📖 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

#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