#items #fbs #dbw #dbs #in_store_pickup

Изменения методов категории Маркетплейс

17 июня изменим лимиты для всех методов с доменом marketplace-api.wildberries.ru:

1. Склады продавца и Остатки на складах продавца
2. Заказы FBS
3. Заказы DBW
4. Заказы DBS
5. Заказы Самовывоз

Один запрос с кодами ответов 4XX будет учитываться как 10 запросов.

Рекомендуем внимательно изучать ошибки, которые возвращаются в ответах. Исправляйте ошибки перед отправкой следующего запроса.

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

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

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

Changes in the Methods for Marketplace Category

On June 17, we will change the limits for all methods with the marketplace-api.wildberries.ru domain:

1. Seller Warehouses and Seller Warehouses Inventory
2. FBS Orders
3. DBW Orders
4. DBS Orders
5. In-Store Pickup Orders

One request with a 4XX response code will be counted as 10 requests.

We recommend carefully checking the errors returned in the responses. Fix errors before sending the next request.

📖 WB API Release Notes

Best regards, WB API team

#fbs

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

Коды маркировки Честного знака для B2C-заказов по модели FBS в России пока проверяются по API не у всех продавцов — мы внедряем это обновление поэтапно.

Если для продавца пока недоступна проверка кодов маркировки, в ответе метода POST /api/marketplace/v3/orders/meta для идентификатора sgtin возвращаются статусы:

• filled — код маркировки Честного знака закреплён за сборочным заданием, проверка пока не требуется и не проводится. Вы можете перевести поставку с этим сборочным заданием в доставку. Если вам необходимо проверить код маркировки этого сборочного задания, вы можете добавить его к сборочному заданию на портале продавца
• optional — код маркировки не закреплён за сборочным заданием и не обязателен. Вы можете перевести поставку с этим сборочным заданием в доставку
• required — код маркировки обязателен и не закреплён за сборочным заданием. Вы не можете перевести поставку с этим сборочным заданием в доставку. Закрепите код маркировки за сборочным заданием и повторите запрос — в ответе вернётся статус проверки filled

Если проверка кодов маркировки доступна, возвращаются все остальные статусы проверки — подробнее в описании ответа 200 метода POST /api/marketplace/v3/orders/meta.

Подробнее о проверке кодов маркировки при работе по FBS читайте в инструкции.

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

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

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

Changes in FBS Orders

Validation of labeling codes Chestny ZNAK for B2C FBS orders in Russia with WB API is now available not for all sellers — we are rolling out this update incrementally.

If validation of the labeling codes is not yet available for the seller, the following statuses are returned for the sgtin label identifier in the response of the POST /api/marketplace/v3/orders/meta method:
• filled — the labeling code Chestny ZNAK is added to the assembly order, validation is not required yet and is not performed. You can transfer the supply with this assembly order to the delivery. If you need to check the labeling code of this assembly order, you can add it to the assembly order on the seller's portal
• optional — the labeling code is added to the assembly order and is not required. You can transfer the supply with this assembly order to the delivery
• required — the labeling code is required and is not added to the assembly order. You cannot transfer the supply with this assembly order to the delivery. Add the labeling code to the assembly order and repeat the request — you will get the filled validation status in the response

If validation of the labeling code is available for the seller, all other validation statuses are returned. For more information, see the description of the response 200 of the POST /api/marketplace/v3/orders/meta method.

For more information about checking labeling codes when using FBS, see the instructions.

📖 WB API Release Notes

Best regards, WB API team

#items

Рекомендации в WB API

Добавили методы управления рекомендациями:
• Список рекомендаций в карточках товаров POST /api/content/v1/recommendations/list
• Установить рекомендации для товаров POST /api/content/v1/recommendations/set

При частичной успешности запроса метод POST /api/content/v1/recommendations/set возвращает в ответе 200 детали ошибок в массиве errors.

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

Вы можете использовать эти методы только с тарифом Продвинутый или Премиальный в подписке Джем либо с опцией Блок «Продавец рекомендует» в карточке товара в Конструкторе тарифов.

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

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

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

Recommendations in WB API

Added the recommendations management methods:
• Item Recommendation List POST /api/content/v1/recommendations/list
• Set Item Recommendations POST /api/content/v1/recommendations/set

If request is partially successful, the POST /api/content/v1/recommendations/set method will return error details in the errors array of the 200 response.

The methods are available by Personal or Service token for the Content category.

You can use these methods only with the Advanced or Premium tariffs of the Jam subscription or with the Seller Recommendations in listings option of Plan Builder.

📖 WB API Release Notes

Best regards, WB API team

#dbw

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

C 15 июня начнём проверять коды маркировки Честного знака для B2C-заказов по модели DBW.

Если коды маркировки сборочных заданий будут указаны некорректно, вы получите ошибку MetaValidationFail в массиве errors при переводе сборочного задания в доставку методом POST /api/marketplace/v3/dbw/orders/status/deliver. В ошибке будут указаны статусы проверки кодов маркировки Честного знака по каждому сборочному заданию. Перевести в доставку сборочные задания с некорректными кодами маркировки Честного знака будет невозможно.

Чтобы узнать статус проверки кода маркировки до перевода сборочного задания в доставку, используйте метод POST /api/marketplace/v3/dbw/orders/meta/details, поле ответа metaDetails.

Подробнее о маркировке — в справочном центре.

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

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

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

Changes in DBW Orders

Starting from June 15 we will begin to validate labeling codes Chestny ZNAK for B2C DBW orders.

Now, if labeling codes are specified incorrectly, you will receive MetaValidationFail in errors array when tranferring the assembly order to the delivery using the POST /api/marketplace/v3/dbw/orders/status/deliver method. The error will indicate which assembly order failed label identifiers validation, along with the statuses. It will be impossible to transfer assembly orders with incorrect labeling codes Chestny ZNAK to delivery.

To find out the validation status of the labeling code before transferring the assembly order to delivery, use the POST /api/marketplace/v3/dbw/orders/meta/details method, the metaDetails response field.

📖 WB API Release Notes

Best regards, WB API team

#dbs

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

В ответ метода POST /api/v3/dbs/orders/delivery-date добавили новые поля:
• dDateFrom — дата начала интервала для доставки
• dDateTo — дата окончания интервала для доставки

Теперь с помощью WB API вы можете получить интервал для доставки заказа, если покупатель указал его.

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

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

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

Delivery Interval for DBS Orders

Added new fields to the response of the POST /api/v3/dbs/orders/delivery-date method:
• dDateFrom — start date of the delivery interval
• dDateTo — end date of the delivery interval

Now, using the WB API, you can get the order delivery interval, if specified by the buyer.

📖 WB API Release Notes

Best regards, WB API team

#dbw

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

С 25 июня в запросе метода POST /api/marketplace/v3/dbw/orders/client вы сможете передавать не более 1000 ID заказов в параметре orders.

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

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

Changes in DBW Orders

Starting from June 25, you will be able to pass no more than 1000 order IDs in the orders parameter in the POST/api/marketplace/v3/dbw/orders/client request.

📖 WB API Release Notes

Best regards, WB API team

#in_store_pickup

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

Добавили проверку кодов маркировки Честного знака B2B-заказов по модели Самовывоз в России.

Если коды маркировки сборочных заданий будут указаны некорректно, вы получите ошибку MetaValidationFail в массиве errors при переводе сборочного задания в статус prepare — готово к выдаче — методом POST /api/marketplace/v3/click-collect/orders/status/prepare. В ошибке будут указаны статусы проверки всех добавленных идентификаторов маркировки по каждому сборочному заданию.

Чтобы узнать статус проверки кода маркировки до перевода сборочного задания в статус prepare, используйте новую версию метода POST /api/marketplace/v3/click-collect/orders/meta/details, поле ответа metaDetails.

Устаревший метод POST /api/marketplace/v3/click-collect/orders/meta/info отключим 15 июля.

Подробнее о маркировке — в справочном центре.

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

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

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

Changes for In-Store Pickup Orders

Added labeling codes Chestny ZNAK validation for B2B In-Store Pickup orders in Russia.

Now, if labeling codes are specified incorrectly, you will get the MetaValidationFail error in the errors array when transferring the assembly order to the prepare status using the POST /api/marketplace/v3/click-collect/orders/status/prepare method. The error will indicate the validation statuses of all added labeling identifiers for each assembly order.

To find out the validation status of the labeling code before transferring the assembly order to the prepare status, use the new version of the POST /api/marketplace/v3/click-collect/orders/meta/details method, metaDetails response field.

The deprecated method POST /api/marketplace/v3/click-collect/orders/meta/info will be disabled on July 15.

📖 WB API Release Notes

Best regards, WB API team

#fbs

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

Добавили поле isPickupPointShipmentAllowed с информацией о том, можно ли отгрузить заказ на ПВЗ, в ответы методов:
• GET /api/v3/orders/new
• GET /api/v3/supplies
• GET /api/v3/supplies/{supplyId}

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

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

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

Changes in FBS Orders

Added isPickupPointShipmentAllowed field with information whether you can dispatch the order to a pickup point in the responses of the methods:
• GET /api/v3/orders/new
• GET /api/v3/supplies
• GET /api/v3/supplies/{supplyId}

📖 WB API Release Notes

Best regards, WB API team

#items

Изменения в методах карточек товаров

С 3 августа методы POST /content/v2/get/cards/list и POST /content/v2/get/cards/trash не будут доступны по токену с категорией Продвижение.

Если в запросах к этим методам вы используете токен с категорией Продвижение без категории Контент, рекомендуем создать новый токен с категорией Контент.

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

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

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

Changes in the Listings Methods

Starting August 3, the methods POST /content/v2/get/cards/list and POST /content/v2/get/cards/trash will no longer be available using a token with the Promotion category.

If you use a token with the Promotion category but without the Content category in the requests to these methods, we recommend creating a new token with the Content category.

📖 WB API Release Notes

Best regards, WB API team

#instructions

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

Внутри вас ждут:

• Подробное объяснение, какие бывают идентификаторы маркировки
• Детальные описания статусов проверки идентификаторов
• Наглядная блок-схема процесса работы с маркировкой

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

#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 WarehouseStocksUpdateBlock — The warehouse is processing. Метод возвращает ошибку во время технических работ на складе, обновить остатки до окончания работ невозможно.

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

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

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

Changes in the Update Inventory Method

Added an error 406 WarehouseStocksUpdateBlock — The 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

Метод GET /api/v1/supplier/stocks будет окончательно отключён 14 июля.
Для получения текущих остатков на складах WB используйте метод POST /api/analytics/v1/stocks-report/wb-warehouses.

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

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

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

The GET /api/v1/supplier/stocks method will be permanently disabled on July 14.
To get current inventory at WB warehouses, use the POST /api/analytics/v1/stocks-report/wb-warehouses method.

📖 WB API Release Notes

#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. Рассказали о нескольких важных новостях о площадке в отдельном анонсе.

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