ВБ Интеграция | WB API
9.71K subscribers
150 photos
399 links
Официальный канал портала разработчиков Wildberries — WB API

Обновления • Новости • Кейсы для бизнеса и разработчиков

📄 Документация: dev.wildberries.ru
💬 Сообщество: dev.wildberries.ru/forum
Download Telegram
#items #promotion

Разные цены для размеров товара в WB API

В Конструктор тарифов добавили опцию Разные цены для размеров товара. На данный момент опция доступна только продавцам из России.

При включённой опции и наличии у товара более чем одного размера вы получите "editableSizePrice":true в ответах методов, аналогично товарам категорий с возможностью поразмерной установки цен:
GET /api/v2/list/goods/filter — Получить товары с ценами
POST /api/v2/list/goods/filter — Получить товары с ценами по артикулам

С помощью опции можно устанавливать разные цены для размеров одного товара методами:
POST /content/v2/cards/upload — Создание карточек товаров
POST /content/v2/cards/upload/add — Создание карточек товаров с присоединением
POST /content/v2/cards/update — Редактирование карточек товаров (только при создании новых размеров)
POST /api/v2/upload/task/size — Установить цены для размеров

Если опция не включена или для этой категории товаров невозможно установить разные цены для размеров, то карточки товаров c разными ценами размеров в запросах методов POST /content/v2/cards/upload, POST /content/v2/cards/upload/add и POST /content/v2/cards/update попадут в черновики. Список черновиков вы можете получить методом POST /content/v2/cards/error/list.

Товары с разными ценами размеров невозможно добавить в акции методом POST /api/v1/calendar/promotions/upload — в ответе вернётся ошибка 400. Вы можете создать загрузку с одинаковой ценой для всех размеров и затем установить разные цены размеров методом POST /api/v2/upload/task/size. Во время проведения акции товар будет участвовать в ней, если наибольшая цена размера этого товара соответствует условиям акции. При этом акционная скидка будет применена ко всем размерам товара, даже если они не соответствуют условиям акции.

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

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

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

Size-Based Prices in WB API

Added the Size-Based Prices option to Plan Builder. The option is currently available only to sellers from Russia.

If the option is enabled and item has more than one size, you will receive "editableSizePrice":true in responses of the methods, similar to items of categories with the possibility of size-based prices setting:
GET /api/v2/list/goods/filter — Get Items with Prices
POST /api/v2/list/goods/filter — Get Items with Prices by Item Numbers

Using the option, you can set size-based prices using the following methods:
POST /content/v2/cards/upload — List Items
POST /content/v2/cards/upload/add — List Items with Merge
POST /content/v2/cards/update — Update Listings (only when to list new sizes)
POST /api/v2/upload/task/size — Set Size Prices

If the option is not enabled or it is impossible to set size-based prices for this item category, then item listings with size-based prices in requests of the POST /content/v2/cards/upload, POST /content/v2/cards/upload/add, and POST /content/v2/cards/update methods will fall into drafts. You can get list of drafts using the POST /content/v2/cards/error/list method.

Items with size-based prices cannot be added to promos using the POST /api/v1/calendar/promotions/upload method — error 400 will be returned in response. You can create an upload with the same price for all sizes and then set size-based prices using the POST /api/v2/upload/task/size method. During promo, the item will participate in it if the highest size price of the item meets the promo terms. In this case, the promo discount will be applied to all item sizes, even if they do not comply with the promo terms.

📖 WB API Release Notes
#general

Изменения в Управлении пользователями продавца

Удалили неактуальные доступы wbPoint и feedbacksQuestions в параметрах запроса методов POST /api/v1/invite и PUT /api/v1/users/access, а также в ответе метода GET /api/v1/users.

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

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

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

Changes in Seller User Management

Deleted the deprecated wbPoint and feedbacksQuestions accesses in the request parameters of the POST /api/v1/invite and PUT/api/v1/users/access methods, and in the response of the GET /api/v1/users method.

📖 WB API Release Notes

Best regards, WB API team
#items

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

В ответ метода PUT /api/v3/stocks/{warehouseId} добавили ошибку 406 WarehouseStocksUpdateBlockThe warehouse is processing. Метод возвращает ошибку во время технических работ на складе, обновить остатки до окончания работ невозможно.

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

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

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

Changes in the Update Inventory Method

Added an error 406 WarehouseStocksUpdateBlockThe warehouse is processing — in response of the PUT /api/v3/stocks/{warehouseId} method. The method returns this error during maintenance work at warehouse, and it is impossible to update inventory before the work is completed.

📖 WB API Release Notes

Best regards, WB API team
#general

Новый метод в разделе Информация о продавце

Теперь с помощью WB API вы можете получить информацию обо всех опциях и пакетах опций, которые продавец подключил в Конструкторе тарифов. Для этого используйте новый метод GET /api/common/v1/tariff-constructor/options.

Метод доступен через Сервисный токен любой категории.

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

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

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

New Method in the Seller Information Section

Now, using WB API, you can get information about all options and option packages that the seller activated in the Plan Builder. For this, use the new method GET /api/common/v1/tariff-constructor/options.

The method is available by Service token of any category.

📖 WB API Release Notes

Best regards, WB API team
#fbs

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

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

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

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

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

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

Changes in FBS Orders

Starting on July 21, you can get assembly orders created more than 3 months ago only with the GET/api/marketplace/v3/fbs/orders/archive method.

The GET /api/v3/orders method will return information only about assembly orders created less than 3 months ago.

📖 WB API Release Notes

Best regards, WB API team
#analytics #dbs

Обновление доступов к методам

Обновили доступы к методам:
• Отчёт об остатках на складах WB POST /api/analytics/v1/stocks-report/wb-warehouses
• Получить стикеры для сборочных заданий с доставкой в ПВЗ POST /api/marketplace/v3/dbs/orders/stickers

Теперь эти методы доступны для зарегистрированных и авторизованных сервисов по базовому токену с секретом.

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

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

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

Updated Access to Methods

Updated access to methods:
• WB Warehouses Inventory Report POST /api/analytics/v1/stocks-report/wb-warehouses
• Get Stickers for Assembly Orders with Delivery to Pickup Point POST /api/marketplace/v3/dbs/orders/stickers

These methods are now available for registered and authorized services using a basic token with a secret.

📖 WB API Release Notes

Best regards, WB API team
#general

Изменения в методах Управления пользователями продавца


Расширили список разделов личного кабинета, к которым можно настроить доступ сотрудникам:
brandzone — Бренд-зона. Публикация изменений
brandzoneSubscribe — Управление подпиской бренд-зоны

Указывайте новые разделы в запросах методов:
• Создать приглашение для нового пользователя POST /api/v1/invite
• Изменить права доступа пользователей PUT /api/v1/users/access

Обновлённый список разделов можно получить в ответе метода GET /api/v1/users.

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

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

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

Changes in Seller User Management Methods

Expanded the list of seller account sections for which user access can be configured:
brandzone — Edit Brand Zone
brandzoneSubscribe — Manage Brand Zone Subscription

Specify the new sections in the method requests:
• Create an Invitation for a New User POST /api/v1/invite
• Update User's Access Permissions PUT /api/v1/users/access

You can get the updated sections list in the response of the GET /api/v1/users method.

📖 WB API Release Notes

Best regards, WB API team
#instructions

📚 Продолжаем публиковать материалы по работе с WB API. На этот раз написали инструкцию про раздел История остатков.

Внутри вас ждут:
• Подробное объяснение, как использовать API Истории остатков
• Списки методов с рекомендациями по их вызову
• Наглядные блок-схемы процессов

📖 Ищите ссылки на инструкции в документации API — в блоках с иконкой книги
#documents

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

Добавили поле b2bCustomerTin с информацией об ИНН B2B-покупателя в детализации к отчётам реализации — POST /api/finance/v1/sales-reports/detailed/{reportId} и POST api/finance/v1/sales-reports/detailed.

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

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

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

New Field in Details for the Realization Reports

Added the b2bCustomerTin field — taxpayer identification number (TIN, or INN in Russian) of B2B buyer — to details for the realization reports — POST /api/finance/v1/sales-reports/detailed/{reportId} and POST api/finance/v1/sales-reports/detailed.

📖 WB API Release Notes
Новости и обновление в Сообществе WB API

Наша команда продолжает развивать форум для разработчиков WB API. Рассказали о нескольких важных новостях о площадке в отдельном анонсе.

💬 Перейти на форум
#dbs #in_store_pickup

Изменения в заказах DBS и Самовывоз


С 8 июля при закреплении за сборочными заданиями номеров деклараций на товары (ДТ) будет обязательно указывать код страны происхождения товара по Общероссийскому классификатору стран мира для B2B-заказов DBS и Самовывоз. Без корректного кода страны закрепить за сборочным заданием номер ДТ станет невозможно.

Мы обновили документацию уже сейчас, чтобы вы заранее внесли изменения в свои интеграции. Обновление методов WB API состоится не ранее 8 июля, мы сообщим об этом дополнительно.

Чтобы добавить код страны, используйте методы:
• DBS — POST /api/marketplace/v3/dbs/orders/meta/customs-declaration, укажите числовой код страны происхождения товара в параметре originCountryCode. Доступно для сборочных заданий в статусах confirm или deliver. Сборочные задания без корректного кода страны вернутся в ответе 200 с ошибкой InvalidOriginCountryCode в массиве errors.
• Самовывоз — POST /api/marketplace/v3/click-collect/orders/meta/customs-declaration, укажите числовой код страны происхождения товара в параметре originCountryCode. Доступно для сборочных заданий в статусах confirm или prepare. Сборочные задания без корректного кода страны вернутся в ответе 200 с ошибкой InvalidOriginCountryCode в массиве errors.

Чтобы проверить код страны, используйте методы:
• DBS — POST /api/marketplace/v3/dbs/orders/meta/details. Метод доступен для сборочных заданий в статусах confirm или deliver.
• Самовывоз — POST /api/marketplace/v3/click-collect/orders/meta/details. Метод доступен для сборочных заданий в статусах confirm или prepare.

Чтобы удалить код страны, используйте методы:
• DBS — POST /api/marketplace/v3/dbs/orders/meta/delete
• Самовывоз — POST /api/marketplace/v3/click-collect/orders/meta/delete

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

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

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

Changes for DBS and In-Store Pickup Orders

Starting July 8, when linking customs declarations number to assembly orders, it will be required to specify the country of origin code according to the Russian classification of countries of the world for DBS and In-store Pickup B2B orders. Without a correct country code, it will be impossible to link a customs declaration number to assembly orders.

We have already updated the documentation so that you can make changes to your integrations in advance. The update of the WB API methods will take place no earlier than July 8; we will notify you additionally.

To add the country code, use the following methods:
• DBS — POST /api/marketplace/v3/dbs/orders/meta/customs-declaration. Specify the numeric country of origin code in the originCountryCode parameter. Available for assembly orders in confirm or deliver statuses. Assembly orders without a correct country code will return with the error InvalidOriginCountryCode in the errors array of the 200 response.
• In-store Pickup — POST /api/marketplace/v3/click-collect/orders/meta/customs-declaration. Specify the numeric country of origin code in the originCountryCode parameter. Available for assembly orders in confirm or prepare statuses. Assembly orders without a correct country code will return with the error InvalidOriginCountryCode in the errors array of the 200 response.

To check the country code, use the following methods:
• DBS — POST /api/marketplace/v3/dbs/orders/meta/details. The method is available for assembly orders in confirm or deliver statuses.
• In-store Pickup — POST /api/marketplace/v3/click-collect/orders/meta/details. The method is available for assembly orders in confirm or prepare statuses.

To delete the country code, use the following methods:
• DBS — POST /api/marketplace/v3/dbs/orders/meta/delete
• In-store Pickup — POST /api/marketplace/v3/click-collect/orders/meta/delete

📖 WB API Release Notes

Best regards, WB API team
#promotion

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

API Продвижения уже работает в валюте аккаунта продавца.

Добавили информацию о валюте аккаунта продавца — поле currency— в ответы методов:
GET /api/advert/v2/adverts
POST /api/advert/v1/bids/min
PATCH /api/advert/v1/bids
GET /adv/v1/balance
GET /adv/v1/budget
POST /adv/v1/budget/deposit
GET /adv/v1/payments
POST /adv/v0/normquery/stats
GET /adv/v3/fullstats

В ответ метода получения списка ставок поисковых кластеров POST /adv/v0/normquery/get-bids добавили поля:
id_kopecks — текущая ставка в разменных денежных единицах — 0,01 от базовой единицы валюты аккаунта продавца за тысячу показов.
currency — валюта аккаунта продавца.

Добавили метод GET /api/advert/v1/config. С его помощью вы можете получить валюту вашего аккаунта и допустимые шаги ставок.

Чтобы установить ставки для поисковых кластеров в валюте вашего аккаунта используйте новый метод POST /api/advert/v1/normquery/bids.

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

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

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

Promotion API now works in the seller account currency.

We added information about the seller account currency — the currency field — to the responses of the methods:
GET /api/advert/v2/adverts
POST /api/advert/v1/bids/min
PATCH /api/advert/v1/bids
GET /adv/v1/balance
GET /adv/v1/budget
POST /adv/v1/budget/deposit
GET /adv/v1/payments
POST /adv/v0/normquery/stats
GET /adv/v3/fullstats

In the response of the method for getting search cluster bids POST /adv/v0/normquery/get-bids, we added the fields:
id_kopecks — current bid in minor currency units — 0.01 of the base unit of the seller account currency per mille
currency seller account currency.

Added the method GET /api/advert/v1/config. Use it to get the currency of your account and the allowed bid steps.

To set bids for search clusters in the currency of your account, use the new method POST /api/advert/v1/normquery/bids.

📖 WB API Release Notes

Best regards, WB API team
ВБ Интеграция | WB API
#documents_and_accounting Новые методы отчётов реализации Добавили новую версию метода получения детализаций к отчётам реализации за период — POST /api/finance/v1/sales-reports/detailed. В новой версии: • добавили настройку полей отчёта: теперь вы можете…
15 июля начнём отключать метод GET /api/v5/supplier/reportDetailByPeriod.

Используйте метод POST /api/finance/v1/sales-reports/detailed, чтобы получить детализации к отчётам реализации за период.

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

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

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

On July 15, we will start disabling the GET /api/v5/supplier/reportDetailByPeriod method.

Use the POST /api/finance/v1/sales-reports/detailed method to get details for the sales reports by period.

📖 WB API Release Notes
#general

Продолжаем обновлять лимиты для Базовых токенов.

9 июля обновятся лимиты методов Работа с товарами, доступных по категории Контент.

Новые лимиты запросов будут учитывать особенности разных типов токенов:
Для Персональных и Сервисных токенов лимиты запросов не изменятся.
Для Базовых и Тестовых токенов лимиты запросов будут ниже, так как эти токены должны использоваться как вспомогательные.

Рекомендуем перевести интеграцию на Персональные и Сервисные токены. Управлять токенами можно в личном кабинете.

Обсудить или задать вопрос в Сообществе WB API

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

Request Limits by Token Types

We continue to update the limits for Basic Tokens.

On July 9, we will update the limits in the Item Management methods available under the Content category.

The new request limits will consider the specifics of different token types:
For Personal and Service tokens, the request limits will not change.
For Basic and Test tokens, the request limits will be lower, as these tokens are intended for auxiliary use.

We recommend migrating your integration to Personal and Service tokens. You can manage tokens in your personal account.

Best regards, WB API team
Видим обращения пользователей по поводу ошибок токена API в интеграции 1С. Чтобы исправить проблему, сервис 1С рекомендует установить патч EF_60033229. Если это не исправит проблему, обратитесь напрямую в поддержку 1С.

WB API не имеет отношения к ошибкам интеграций сторонних сервисов.

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

Новые методы в Песочнице Вопросов и отзывов


Расширили песочницу вопросов и отзывов. Теперь вы можете:
создавать несколько тестовых отзывов одним запросом POST /api/v1/test/make/feedbacks/batch
удалять тестовые отзывы — POST /api/v1/test/delete/feedbacks
создавать несколько тестовых вопросов одним запросом — POST /api/v1/test/make/questions/batch
удалять тестовые вопросы — POST /api/v1/test/delete/questions

27 июля отключим неактуальные методы:
POST /api/v1/test/make/feedbacks
POST /api/v1/test/make/questions

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

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

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

New Methods in the Questions and Feedbacks Sandbox

We have expanded the sandbox for feedbacks and questions. Now you can:
create multiple test feedbacks with a single request — POST /api/v1/test/make/feedbacks/batch
delete test feedbacks — POST /api/v1/test/delete/feedbacks
create multiple test questions with a single request — POST /api/v1/test/make/questions/batch
delete test questions — POST /api/v1/test/delete/questions

On July 27 we will disable the deprecated methods:
POST /api/v1/test/make/feedbacks
POST /api/v1/test/make/questions

📖 WB API Release Notes
#promotion

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


В ответ метода GET /api/advert/v2/adverts добавили признак возможности изменения списка товаров в кампании поле — can_change_nms в объекте restrictions.

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

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

Changes in Promotion service

Added the can_change_nms field to the restrictions object in the response of the GET /api/advert/v2/adverts method. This flag indicates whether it is possible to change the list of items in the campaign.

📖 WB API Release Notes
ВБ Интеграция | WB API
#dbs #in_store_pickup Изменения в заказах DBS и Самовывоз С 8 июля при закреплении за сборочными заданиями номеров деклараций на товары (ДТ) будет обязательно указывать код страны происхождения товара по Общероссийскому классификатору стран мира для B2B…
#dbs #in_store_pickup

Изменения в заказах DBS и Самовывоз

Обновили методы WB API согласно анонсу от 2 июля. Теперь, при закреплении за сборочными заданиями номеров деклараций на товары (ДТ), обязательно указывать код страны происхождения товара по Общероссийскому классификатору стран мира для B2B-заказов DBS и Самовывоз. Без корректного кода страны закрепить за сборочным заданием номер ДТ невозможно.

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

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

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

Changes for DBS and In-Store Pickup Orders

Updated WB API methods according to the announcement dated July 2. Now, when linking customs declarations number to assembly orders, it is required to specify the country of origin code according to the Russian classification of countries of the world for DBS and In-store Pickup B2B orders. Without a correct country code, it is not possible to link a customs declaration number to assembly orders.

📖 WB API Release Notes

Best regards, WB API team
#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