#fbs

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

1 апреля добавим поле status в ответ метода получения стикеров сборочных заданий кроссбордера POST /api/v3/orders/stickers/cross-border. Благодаря новому полю вы сможете отслеживать статус генерации стикера:

• awaitingTrackNumber — стикер не готов. Ожидается трек-номер от перевозчика.
• ready — стикер готов

Стикер может генерироваться с задержкой. Повторяйте запрос, пока не получите статус ready.

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

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

FBS Assembly Orders Changes

On April 1, we will add the status field to the response of the method for getting stickers for assembly orders POST /api/v3/orders/stickers/cross-border. The new field will allow you to track the sticker generation status:

• awaitingTrackNumber — the sticker is not ready. Waiting for a carrier's track number.
• ready — the sticker is ready

Stickers may be generated with a delay. Repeat the request until you receive the ready status.

📖 WB API Release Notes

Best regards, WB API team

#instructions

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

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

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

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

#fbs

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

Добавили проверку метаданных сборочных заданий FBS. Теперь, если метаданные сборочных заданий будут указаны некорректно, вы получите ошибку с кодом 409 при переводе поставки в доставку с помощью метода PATCH /supplies/{supply}/deliver. В ошибке будут указаны метаданные сборочных заданий, которые не прошли проверку, со статусами.

С 31 марта начнём проверять IMEI, с 7 апреля — УИН, с 9 апреля — код маркировки для B2B-заказов.

Подробнее о проверке метаданных вы можете узнать в справочном центре.

Также обновили ответ метода получения метаданных POST /api/marketplace/v3/orders/meta:
• Добавили массив metaDetails. В нём возвращаются статусы проверки метаданных сборочных заданий. Рекомендуем получить массив metaDetails перед переводом поставку в доставку.
• 30 апреля удалим неактуальный объект meta.

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

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

Changes in FBS Orders Methods

Added validation for FBS assembly order metadata. Now, if the metadata is specified incorrectly, you will receive a 409 error when moving the supply to the delivery using the PATCH /supplies/{supply}/deliver method. The error will indicate which assembly order metadata failed validation, along with their statuses.

Starting March 31, we will begin validating IMEI. Starting April 7 — UIN, and starting April 9 — data matrix codes for B2B orders.

You can learn more about metadata validation in the help center.

Also updated the response of the method for getting metadata POST /api/marketplace/v3/orders/meta:
• Added the metaDetails array. It returns the validation statuses of the assembly order metadata. We recommend getting the metaDetails array before moving the supply to the delivery.
• On April 30, we will remove the deprecated meta object.

📖 WB API Release Notes

Best regards, WB API team

📢 WB API в MAX

Мы создали канал в MAX на случай, если вы испытываете сложности с доступом к Telegram. Подписывайтесь там, где вам удобнее — так вы точно ничего не пропустите

🔗 Наш канал в MAX

#general

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

Добавили метод GET /api/common/v1/rating, с помощью которого вы можете получить пользовательский рейтинг продавца и количество отзывов.

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

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

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

🔗 Читайте в MAX

New Method in the Seller Information Section

Added the GET /api/common/v1/rating method, which allows you to get the seller user rating and feedbacks count.

The method is available by Service token of the Feedbacks and Questions category.

📖 WB API Release Notes

Best regards, WB API team

#general

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

Добавили метод GET /api/common/v1/subscriptions, с помощью которого вы можете получить подробную информацию о подписке Джем:
• Даты активации и окончания
• Способ оформления и уровень подписки
• Статус — активна ли подписка

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

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

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

🔗 Читайте в MAX

New Method in the Seller Information Section

Added the GET /api/common/v1/subscriptions method, which allows you to get detailed information about Jam subscription:
• Activation and expiration dates
• Subscription method and level
• Status — whether the subscription is active

The method is available by Service token of any category.

📖 WB API Release Notes

Best regards, WB API team

#promotion

Изменения в Статистике по продвижению

Теперь статистика в методах POST /adv/v0/normquery/stats и POST /adv/v1/normquery/stats доступна для кампаний с типом оплаты cpc — за клики.
Для этих кампаний вы можете получить все данные, кроме:
• количества просмотров — views
• кликабельности — ctr
• средней стоимости за тысячу показов — cpm

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

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

🔗 Читайте в MAX

Changes in Promotion Statistics

Now, statistics in the POST /adv/v0/normquery/stats and POST /adv/v1/normquery/stats methods is available for campaigns with the cpc payment type — pay-per-click.
For these campaigns, you can get all data except:
• impressions count — views
• click-through rate — ctr
• average cost per thousand impressions — cpm

📖 WB API Release Notes

Best regards, WB API team

На портале разработчиков появился новый раздел — База знаний

Раньше информацию о WB API приходилось собирать из разных мест. Теперь всё собрано в одном разделе

Мы написали 64 совершенно новые статьи в 10 тематических разделах — от базовой авторизации до работы с большими данными. А чтобы всё было в одном месте, добавили ещё 2 раздела, куда бережно перенесли все гайды и кейсы

Для продавцов, разработчиков и SaaS-партнёров подготовлены отдельные маршруты — стартовые статьи, которые сэкономят время и проведут по самым важным материалам для вашей роли

База знаний доступна без авторизации

🔗 Читайте подробности в анонсе

📘 Перейти в Базу знаний

💬 Мы в MAX

A new section has been added to the developer portal — the Knowledge Base

Previously, information about the WB API had to be gathered from various sources. Now, everything is collected in one section

We have written 64 completely new articles across 10 thematic sections — from basic authorization to working with big data. And to keep everything in one place, we added 2 more sections, where we carefully transferred all the guides and case studies

Separate paths have been prepared for sellers, developers, and SaaS partners — starting articles that will save you time and guide you through the most important materials for your role

The Knowledge Base is accessible without authorization

🔗 Read the details in the announcement

📘 Go to the Knowledge Base

💬 We are on MAX

#items

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

Теперь с помощью WB API вы можете узнать дату и время, когда карточка товара попала в черновики. Для этого добавили в ответ метода POST /content/v2/cards/error/list поле updatedAt для каждого пакета данных — дата и время создания или изменения пакета.

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

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

🔗 Читайте в MAX

Changes in Listings

Now you can use the WB API to check the date and time when the listing was added to the drafts. To do this, we added the updatedAt field for each data batch to the response of the POST /content/v2/cards/error/list method. The field contains the date and time when the package was created or edited.

📖 WB API Release Notes

Best regards, WB API team

#documents

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

В детализации к отчётам реализации — GET /api/v5/supplier/reportDetailByPeriod — добавили поля c информацией о подменных артикулах и оптовой скидке для бизнеса:

• article_substitution — ID подменного артикула
• sale_price_affiliated_discount_prc — скидка по подменному артикулу, %
• sale_price_wholesale_discount_prc — оптовая скидка для бизнеса, %

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

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

🔗 Читайте в MAX

New Fields in Details for the Realization Reports

Added the fields with information about promo items and wholesale discount for businesses to details for the realization reports — GET /api/v5/supplier/reportDetailByPeriod:

• article_substitution — promo item article ID
• sale_price_affiliated_discount_prc — promo item article discount (%)
• sale_price_wholesale_discount_prc — wholesale discount for businesses (%)

📖 WB API Release Notes

Best regards, WB API team

#fbs

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

Добавили поля в ответ метода получения стикеров сборочных заданий кроссбордера POST /api/v3/orders/stickers/cross-border. В полях указаны данные для печати стикеров:

• partA — первая часть ID стикера для печати подписи
• partB — вторая часть ID стикера для печати подписи
• barcode — закодированное значение стикера

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

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

🔗 Читайте в MAX

FBS Orders Changes

Added fields to the response of the method for getting stickers for cross-border assembly orders POST /api/v3/orders/stickers/cross-border. The fields contain data for printing stickers:

• partA — the first part of the sticker identifier for printing the signature
• partB — the second part of the sticker identifier for printing the signature
• barcode — the encoded value of the sticker

📖 WB API Release Notes

Best regards, WB API team

#items

Изменения в Работе с товарами

Теперь с помощью WB API вы можете подтвердить, что на товар нанесён обязательный код маркировки. Для этого передайте значение true для параметра kizMarked в запросах методов:
• POST /content/v2/cards/upload
• POST /content/v2/cards/upload/add
• POST /content/v2/cards/update

По умолчанию в запросах этих методов будет передано значение false — это означает, что вы не подтверждаете, что на товар нанесён обязательный код маркировки. В этом случае карточка товара, для которой требуется код маркировки, не пройдёт модерацию и будет заблокирована.

Чтобы проверить, является ли код маркировки обязательным для товара, используйте метод POST /content/v2/get/cards/list, поле ответа needKiz:
• true — код маркировки требуется
• false — код маркировки не требуется

Чтобы проверить, подтвердили ли вы, что обязательный код маркировки нанесён на товар, используйте поле ответа kizMarked в методах POST /content/v2/get/cards/list и POST /content/v2/get/cards/trash.

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

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

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

🔗 Читайте в MAX

Changes in Item Management

Now you can use the WB API to confirm that required labeling code is applied to the product. To do this, pass the true value for the kizMarked parameter in the requests for the methods:
• POST /content/v2/cards/upload
• POST /content/v2/cards/upload/add
• POST /content/v2/cards/update

By default, the false value will be passed in the requests of these methods. This means that you do not confirm that the item has required labeling code. In this case, the item that requires labeling code will not pass moderation and will be blocked.

To check, whether labeling code is required for the item, use the POST /content/v2/get/cards/list method, the needKiz response field:
• true — labeling code is required
• false — labeling code not required

To check, whether you have confirmed that required labeling code is applied to the item, use the response field kizMarked in the POST /content/v2/get/cards/list and POST /content/v2/get/cards/trash methods.

📖 WB API Release Notes

Best regards, WB API team

#documents_and_accounting

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

Добавили новую версию метода получения детализаций к отчётам реализации за период — POST /api/finance/v1/sales-reports/detailed.

В новой версии:
• добавили настройку полей отчёта: теперь вы можете получать только те поля, которые указываете в запросе в массиве fields
• изменили стиль названий полей на camelCase
• стандартизировали названия полей, чтобы они совпадали с другими методами WB API
• изменили с number на string значения полей, в которых передаются данные о суммах денег
• добавили поле title — название товара
• не использовали аналоги неактуальных полей suppliercontract_code и ppvz_supplier_id

Метод доступен по токену для категории Финансы.

Текущая версия — GET /api/v5/supplier/reportDetailByPeriod — будет отключена 15 июля.

Также добавили методы получения:
• списка отчётов реализации — POST /api/finance/v1/sales-reports/list
• детализаций к отчётам реализации по ID отчётов — POST /api/finance/v1/sales-reports/detailed/{reportId}

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

Рекомендуем изучить таблицу сопоставления названий полей в методах получения детализаций к отчётам реализации в Журнале изменений. Пометка S означает, что в новых методах тип поля — string.

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

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

🔗 Читайте в MAX

New Sales Reports Methods

Added new version of the method for getting details for the sales reports by period — POST /api/finance/v1/sales-reports/detailed.

In the new version we:
• added report fields customization: now you can get only the fields that you specify in request in the fields array
• changed the style of field names to camelCase
• standardized field names to match other WB API methods
• changed the value type of the fields in which data on amounts of money from number to string
• added the title field — item name
• did not use analogues of the deprecated fields suppliercontract_code and ppvz_supplier_id

The method is available by token for the Finance category.

The current version — GET /api/v5/supplier/reportDetailByPeriod — will be disabled on July 15.

Also added methods for getting:
• sales report list — POST /api/finance/v1/sales-reports/list
• details for the sales reports by report IDs — POST /api/finance/v1/sales-reports/detailed/{reportId}

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

We recommend that you study the table for matching field names in methods for getting details for the sales reports in Release Notes. The S mark means that in the new methods the field type is string.

📖 WB API Release Notes

Best regards, WB API team

#documents

Отчёты об издержках на приём платежей

Добавили методы получения:
• списка отчётов об издержках на приём платежей — POST /api/finance/v1/acquiring/list
• детализаций к отчётам об издержках на приём платежей по ID отчётов — POST /api/finance/v1/acquiring/detailed/{reportId}
• детализаций к отчётам об издержках на приём платежей за период — POST /api/finance/v1/acquiring/detailed

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

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

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

🔗 Читайте в MAX

Acquiring Expenses Reports

Added methods for getting:
• acquiring expenses report list — POST /api/finance/v1/acquiring/list
• details for the acquiring expenses reports by IDs — POST /api/finance/v1/acquiring/detailed/{reportId}
• details for the acquiring expenses reports by period — POST /api/finance/v1/acquiring/detailed

The methods are available only for sellers from Russia by Personal or Service token for the Finance category.

📖 WB API Release Notes

Best regards, WB API team

#items

Обязательные ключевые характеристики для отдельных предметов

С 29 апреля в запросах на cоздание, создание с присоединением и редактирование карточек товаров для некоторых предметов будет обязательным указание ключевых характеристик, которые являются значимыми для покупателей. Для таких характеристик в ответе метода GET /content/v2/object/charcs/{subjectId} возвращается сочетание полей "hasFilter":true и "required":true.

Обновление касается 10 предметов:
• Карты памяти — "subjectId": 1260
• Фитнес-браслеты — "subjectId": 1514
• Выпрямители волос — "subjectId": 2314
• Блендеры — "subjectId": 614
• Неттопы и Мини ПК — "subjectId": 8992
• Фоторамки — "subjectId": 28
• Калькуляторы — "subjectId": 977
• Крышки — "subjectId": 819
• Наволочки — "subjectId": 605
• Салфетки для уборки — "subjectId": 1202

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

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

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

Required Key Characteristics for Some Subcategories

Starting from April 29 requests for creating, creating with merge, and editing some subcategories listings will require specifying key characteristics that are important for buyers. For these characteristics the combination of "hasFilter":true and "required":true will return in responses of the GET /content/v2/object/charcs/{subjectId} method.

The update concerns 10 subcategories:
• Memory Cards — "subjectId": 1260
• Fitness Bracelets — "subjectId": 1514
• Hair Straighteners — "subjectId": 2314
• Blenders — "subjectId": 614
• Nettops & Mini PCs — "subjectId": 8992
• Photo Frames — "subjectId": 28
• Calculators — "subjectId": 977
• Lids — "subjectId": 819
• Pillowcases — "subjectId": 605
• Cleaning Wipes — "subjectId": 1202

📖 API Release Notes

Best regards, WB API team

#general

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

23 апреля обновятся методы категории Продвижение.

28 апреля обновятся методы оставшихся категорий:
• Статистика
• Аналитика
• Контент
• Цены и скидки
• Маркетплейс

После 28 апреля Базовый токен можно будет использовать только с минимальным лимитом.

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

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

Мы не рекомендуем передавать Персональные токены сторонним сервисам. Это не соответствует правилам использования WB API, а также несёт риски потери данных и сбоев в работе токена.

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

Request Limits by Token Types

We continue to update the limits for Basic Tokens.

On April 23, we will update the methods in the Promotion category.

On April 28, we will update the methods in the remaining categories:
• Statistics
• Analytics
• Content
• Prices and Discounts
• Marketplace

After April 28, the Basic Token can only be used with the minimum limit.

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.

We do not recommend sharing Personal tokens with third-party services. This violates the WB API terms of use and carries risks of data loss and token malfunction.

Best regards, WB API team

#dbs

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

С 4 мая отменить сборочные задания DBS можно будет только в статусах new и confirm. Отменить сборочное задание в статусе deliver будет невозможно.

Чтобы проверить статус сборочного задания, используйте метод POST /api/marketplace/v3/dbs/orders/status/info.

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

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

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

Changes in DBS Assembly Orders

Starting from May 4, you will be able to cancel DBS assembly orders only in the new and confirm statuses. It will be not possible to cancel an assembly order in the deliver status.

To check the status of the assembly order, use the POST /api/marketplace/v3/dbs/orders/status/info method.

📖 WB API Release Notes

Best regards, WB API team

Ошибка 429 и превышение лимитов

У некоторых пользователей может наблюдаться рост ответов с кодом 429 из-за обновления лимитов запросов.

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

Если у вас останутся вопросы, можете задать их в комментариях под сообщением на форуме. Наша команда будет готова на них ответить.

#items

Изменения в Работе с товарами

В ответ метода GET /content/v2/object/charcs/{subjectId} для каждой характеристики добавили поле isVariable с информацией о том, могут ли варианты товара отличаться по этой характеристике.
Используйте эту информацию при cоздании объединённых карточек товара и создании карточек товара с присоединением.

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

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

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

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

Changes in Item Management

Added isVariable field to the response of the GET /content/v2/object/charcs/{subjectId} method for each characteristic. The field provides information whether the item variants may differ in this characteristic.
Use this information when creating merged listings and listings with merge.

📖 WB API Release Notes

Best regards, WB API team

#dbs #dbw

Изменения в метаданных DBS и DBW

Теперь с помощью WB API вы можете получить метаданные и статусы их валидации для сборочных заданий DBW и DBS. Для этого используйте новые методы:
• POST /api/marketplace/v3/dbw/orders/meta/details для модели DBW
• POST /api/marketplace/v3/dbs/orders/meta/details для модели DBS

Неактуальные методы получения метаданных POST /api/marketplace/v3/dbs/orders/meta/info и GET /api/v3/dbw/orders/{orderId}/meta будут отключены 27 июля.

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

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

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

Changes in DBS and DBW Metadata

Now, using WB API, you can get assembly orders metadata and their validation statuses for DBW and DBS assembly orders. To do this, use new methods:
• POST /api/marketplace/v3/dbw/orders/meta/details for DBW model
• POST /api/marketplace/v3/dbs/orders/meta/details for DBS model

The deprecated methods for getting metadata POST /api/marketplace/v3/dbs/orders/meta/info and GET/api/v3/dbw/orders/{OrderID}/meta will be disabled on July 27.

📖 WB API Release Notes

Best regards, WB API team

#items

Новый метод в Песочнице Цен и скидок

Теперь в Песочнице Цен и скидок вы можете протестировать метод получения товаров с ценами по артикулам POST /api/v2/list/goods/filter.

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

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

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

New Method in the Prices and Discounts Sandbox

Now you can test the method for getting items with prices by articles POST /api/v2/list/goods/filter in the Prices and Discounts Sandbox.

📖 WB API Release Notes

Best regards, WB API team