#fbs
Изменения в Заказах FBS
Добавили поля в ответ метода получения стикеров сборочных заданий кроссбордера POST /api/v3/orders/stickers/cross-border. В полях указаны данные для печати стикеров:
•
•
•
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в MAX
Изменения в Заказах 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 вы можете подтвердить, что на товар нанесён обязательный код маркировки. Для этого передайте значение
• POST /content/v2/cards/upload
• POST /content/v2/cards/upload/add
• POST /content/v2/cards/update
По умолчанию в запросах этих методов будет передано значение
Чтобы проверить, является ли код маркировки обязательным для товара, используйте метод POST /content/v2/get/cards/list, поле ответа
•
•
Чтобы проверить, подтвердили ли вы, что обязательный код маркировки нанесён на товар, используйте поле ответа
Подробнее о кодах маркировки — в справочном центре.
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в MAX
Изменения в Работе с товарами
Теперь с помощью 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.
В новой версии:
• добавили настройку полей отчёта: теперь вы можете получать только те поля, которые указываете в запросе в массиве
• изменили стиль названий полей на camelCase
• стандартизировали названия полей, чтобы они совпадали с другими методами WB API
• изменили с
• добавили поле
• не использовали аналоги неактуальных полей
Метод доступен по токену для категории Финансы.
Текущая версия — GET /api/v5/supplier/reportDetailByPeriod — будет отключена 15 июля.
Также добавили методы получения:
• списка отчётов реализации — POST /api/finance/v1/sales-reports/list
• детализаций к отчётам реализации по ID отчётов — POST /api/finance/v1/sales-reports/detailed/{reportId}
Методы доступны по Персональному или Сервисному токену для категории Финансы.
Рекомендуем изучить таблицу сопоставления названий полей в методах получения детализаций к отчётам реализации в Журнале изменений. Пометка
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в MAX
Новые методы отчётов реализации
Добавили новую версию метода получения детализаций к отчётам реализации за период — 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 thefieldsarray
• 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 fromnumbertostring
• added thetitlefield — item name
• did not use analogues of the deprecated fieldssuppliercontract_codeandppvz_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. TheSmark 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
Отчёты об издержках на приём платежей
Добавили методы получения:
• списка отчётов об издержках на приём платежей — 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} возвращается сочетание полей
Обновление касается 10 предметов:
• Карты памяти —
• Фитнес-браслеты —
• Выпрямители волос —
• Блендеры —
• Неттопы и Мини ПК —
• Фоторамки —
• Калькуляторы —
• Крышки —
• Наволочки —
• Салфетки для уборки —
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Обязательные ключевые характеристики для отдельных предметов
С 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
Продолжаем обновлять лимиты для Базовых токенов.
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 можно будет только в статусах
Чтобы проверить статус сборочного задания, используйте метод POST /api/marketplace/v3/dbs/orders/status/info.
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Изменения в Сборочных заданиях 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 thenewandconfirmstatuses. It will be not possible to cancel an assembly order in thedeliverstatus.
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
ВБ Интеграция | WB API
#general Продолжаем обновлять лимиты для Базовых токенов. 23 апреля обновятся методы категории Продвижение. 28 апреля обновятся методы оставшихся категорий: • Статистика • Аналитика • Контент • Цены и скидки • Маркетплейс После 28 апреля Базовый токен…
Ошибка 429 и превышение лимитов
У некоторых пользователей может наблюдаться рост ответов с кодом 429 из-за обновления лимитов запросов.
Рекомендуем ознакомиться с подробным разбором причины и решениями данной ситуации в отдельной публикации на форуме.
Если у вас останутся вопросы, можете задать их в комментариях под сообщением на форуме. Наша команда будет готова на них ответить.
У некоторых пользователей может наблюдаться рост ответов с кодом 429 из-за обновления лимитов запросов.
Рекомендуем ознакомиться с подробным разбором причины и решениями данной ситуации в отдельной публикации на форуме.
Если у вас останутся вопросы, можете задать их в комментариях под сообщением на форуме. Наша команда будет готова на них ответить.
#items
Изменения в Работе с товарами
В ответ метода GET /content/v2/object/charcs/{subjectId} для каждой характеристики добавили поле
Используйте эту информацию при cоздании объединённых карточек товара и создании карточек товара с присоединением.
Подробнее об объединении карточек товаров — в справочном центре.
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Изменения в Работе с товарами
В ответ метода 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
🔗 Читайте в МАКС
Изменения в метаданных 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
🔗 Читайте в МАКС
Новый метод в Песочнице Цен и скидок
Теперь в Песочнице Цен и скидок вы можете протестировать метод получения товаров с ценами по артикулам 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
#fbs
Новый метод Заказов FBS
Добавили метод получения архивных сборочных заданий FBS — GET /api/marketplace/v3/fbs/orders/archive.
Метод возвращает список сборочных заданий, созданных более 3 месяцев назад, и информацию о них. Часть сборочных заданий попадает в архив позже, чем через 3 месяца после создания, так как поставка переходит в архив только после того, как все заказы в ней будут завершены.
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Новый метод Заказов FBS
Добавили метод получения архивных сборочных заданий FBS — GET /api/marketplace/v3/fbs/orders/archive.
Метод возвращает список сборочных заданий, созданных более 3 месяцев назад, и информацию о них. Часть сборочных заданий попадает в архив позже, чем через 3 месяца после создания, так как поставка переходит в архив только после того, как все заказы в ней будут завершены.
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
New FBS Orders Method
Added a method for getting archived FBS assembly orders — GET /api/marketplace/v3/fbs/orders/archive.
The method returns a list of assembly orders created more than 3 months ago and information about them. Some assembly orders are archived later than 3 months after creation, as the supply is archived only after all orders in it are completed.
📖 WB API Release Notes
Best regards, WB API team
#fbs
Рекомендация склада для поставок FBS
Добавили поле
• GET /api/v3/supplies
• GET /api/v3/supplies/{supplyId}
Рекомендуемый склад определяется автоматически как ближайший к покупателю с учётом параметров всех сборочных заданий в поставке. Это позволяет быстрее доставить товары покупателю. Если рекомендуемый склад не определён, в поле
Если рекомендуемый склад находится вне зоны доставки продавца, штраф за доставку конкретной поставки на него не применяется. Вы также сможете выбрать склад, который вам удобен, а не из рекомендаций. В этом случае склад по-прежнему должен быть в вашей зоне доставки, иначе штраф начислят.
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Рекомендация склада для поставок FBS
Добавили поле
recommendedWhId — рекомендуемый склад для поставки для Москвы и Московской области — в ответы методов:• GET /api/v3/supplies
• GET /api/v3/supplies/{supplyId}
Рекомендуемый склад определяется автоматически как ближайший к покупателю с учётом параметров всех сборочных заданий в поставке. Это позволяет быстрее доставить товары покупателю. Если рекомендуемый склад не определён, в поле
recommendedWhId вернётся значение 0.Если рекомендуемый склад находится вне зоны доставки продавца, штраф за доставку конкретной поставки на него не применяется. Вы также сможете выбрать склад, который вам удобен, а не из рекомендаций. В этом случае склад по-прежнему должен быть в вашей зоне доставки, иначе штраф начислят.
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Recommended Warehouse for FBS Supplies
Added therecommendedWhIdfield — recommended warehouse for supply for Moscow and Moscow region — to the responses of the methods:
• GET /api/v3/supplies
• GET/api/v3/supplies/{suppliId}
The recommended warehouse is defining automatically as the closest to the buyer, taking into account the parameters of all assembly orders in the supply. This allows you to deliver the items to the buyer faster. If the recommended warehouse is not defined, the value0will be returned in therecommendedWhIdfield.
If the recommended warehouse is located outside the seller's delivery area, there is no fine for delivering this supply to it. You can also choose a warehouse that is convenient for you, rather than from recommendations. In this case, it must still be in your delivery area, otherwise a fine will be charged.
📖 WB API Release Notes
Best regards, WB API team
#items
Изменения в Работе с товарами
В ответ метода GET /content/v2/object/charcs/{subjectId} для каждой характеристики добавили поле
•
•
Теперь в ответе метода GET /content/v2/object/charcs/{subjectId} возвращаются характеристики, которые передаются отдельными параметрами в запросах на cоздание, создание с присоединением и редактирование карточек товаров:
• Бренд — параметр запроса
• Наименование товара — параметр запроса
• Описание товара — параметр запроса
• Вес товара с упаковкой — параметр запроса
• Ширина упаковки — параметр запроса
• Высота упаковки — параметр запроса
• Длина упаковки — параметр запроса
При работе с карточками товаров обращайте внимание на сочетание полей в ответе GET /content/v2/object/charcs/{subjectId}, чтобы проверить обязательность характеристики:
•
•
Значение
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Изменения в Работе с товарами
В ответ метода GET /content/v2/object/charcs/{subjectId} для каждой характеристики добавили поле
existNamedField с информацией о том, как передавать характеристику в запросах на cоздание, создание с присоединением и редактирование карточек товаров:•
false — в массиве characteristics. Например, чтобы указать цвет для механической кофемолки, передайте в массиве characteristics ID характеристики ("id":14177449) и её значение ("value":серый).•
true — отдельным параметром в запросе. Например, чтобы указать указать наименование товара, передайте его в параметре title.Теперь в ответе метода GET /content/v2/object/charcs/{subjectId} возвращаются характеристики, которые передаются отдельными параметрами в запросах на cоздание, создание с присоединением и редактирование карточек товаров:
• Бренд — параметр запроса
brand• Наименование товара — параметр запроса
title• Описание товара — параметр запроса
description• Вес товара с упаковкой — параметр запроса
weightBrutto• Ширина упаковки — параметр запроса
width• Высота упаковки — параметр запроса
height• Длина упаковки — параметр запроса
lengthПри работе с карточками товаров обращайте внимание на сочетание полей в ответе GET /content/v2/object/charcs/{subjectId}, чтобы проверить обязательность характеристики:
•
"isVariable":true и "required":true — меняющаяся характеристика, необходима для создания карточки.•
"hasFilter":true и "required":true — ключевая характеристика, необходима для создания карточки для 10 предметов.Значение
hasFilter для любой характеристики может меняться. Поэтому перед каждым созданием или редактированием карточки рекомендуем запрашивать актуальный справочник характеристик.📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Changes in Item Management
In the GET /content/v2/object/charcs/{subjectId} response added the existNamedField field for each characteristic. The field provides information on how to transfer the characteristic in requests for creating, creating with merge, and editing listings:
• false — in the characteristics array. For example, to specify the color for a mechanical coffee grinder, pass the characteristics ID ("id":14177449) and its value ("value":gray) in the characteristics array.
• true — as a separate parameter in the request. For example, to specify the item name, pass it in the title parameter.
Also, in the response of the GET /content/v2/object/charcs/{subjectId} method added new characteristics. These characteristics are transferred as separate parameters in requests for creating, creating with merge, and editing listings:
• Brand — request parameter brand
• Item title — request parameter title
• Item description — request parameter description
• Weight of the item with packaging — request parameter weightBrutto
• Width — request parameter width
• Height — request parameter height
• Length — request parameter length
When working with listings, pay attention to the combination of fields in the response of the GET /content/v2/object/charcs/{subjectId} method to check if the characteristic is required:
• "isVariable":true and "required":true — variable characteristic, required for creating listings.
• "hasFilter":true and "required":true — key characteristic, required for creating listings for 10 subjects.
The hasFilter value for any characteristic may be changed. Therefore, before creating or editing of a listing, we recommend requesting an up-to-date list of characteristics.
📖 WB API Release Notes
Best regards, WB API team
#dbw #dbs
Изменения в заказах DBW и DBS
Добавили методы для работы со списками сборочных заданий модели DBW:
• Удалить метаданные сборочных заданий — POST /api/v3/public/dbw/orders/meta/delete
• Закрепить коды маркировки Честного знака за сборочными заданиями — POST /api/v3/public/dbw/orders/meta/sgtin
• Перевести сборочные задания в доставку — POST /api/v3/public/dbw/orders/status/deliver
Теперь при переводе в доставку сборочных заданий моделей DBW и DBS проверяем маркировку Честного знака для B2B-заказов. Сборочные задания, маркировка которых будет указана некорректно, не получится перевести в доставку. Ошибка валидации
• POST /api/v3/public/dbw/orders/status/deliver
• POST /api/marketplace/v3/dbs/orders/status/deliver
В массиве ответа
• POST /api/marketplace/v3/dbw/orders/meta/details
• POST /api/marketplace/v3/dbs/orders/meta/details
5 июня отключим неактуальные методы:
• PATCH /api/v3/dbw/orders/{orderId}/assemble
• DELETE /api/v3/dbw/orders/{orderId}/meta
• PUT /api/v3/dbw/orders/{orderId}/meta/sgtin
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Изменения в заказах DBW и DBS
Добавили методы для работы со списками сборочных заданий модели DBW:
• Удалить метаданные сборочных заданий — POST /api/v3/public/dbw/orders/meta/delete
• Закрепить коды маркировки Честного знака за сборочными заданиями — POST /api/v3/public/dbw/orders/meta/sgtin
• Перевести сборочные задания в доставку — POST /api/v3/public/dbw/orders/status/deliver
Теперь при переводе в доставку сборочных заданий моделей DBW и DBS проверяем маркировку Честного знака для B2B-заказов. Сборочные задания, маркировка которых будет указана некорректно, не получится перевести в доставку. Ошибка валидации
MetaValidationFail с кодом 409 будет указана в массиве errors в ответах методов:• POST /api/v3/public/dbw/orders/status/deliver
• POST /api/marketplace/v3/dbs/orders/status/deliver
В массиве ответа
metaDetails будут указаны статусы валидации маркировки по каждому сборочному заданию. Перед переводом в доставку проверяйте статусы валидации метаданных в ответах методов:• POST /api/marketplace/v3/dbw/orders/meta/details
• POST /api/marketplace/v3/dbs/orders/meta/details
5 июня отключим неактуальные методы:
• PATCH /api/v3/dbw/orders/{orderId}/assemble
• DELETE /api/v3/dbw/orders/{orderId}/meta
• PUT /api/v3/dbw/orders/{orderId}/meta/sgtin
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Changes in DBW and DBS Orders
Added methods for working with lists of DBW assembly orders:
• Delete Assembly Orders Metadata — POST /api/v3/public/dbw/orders/meta/delete
• Add Labeling Codes Chestny ZNAK to Assembly Orders — POST /api/v3/public/dbw/orders/meta/sgtin
• Transfer Assembly Orders to Delivery — POST /api/v3/public/dbw/orders/status/deliver
Now, when transferring the assembly orders of DBW and DBS models to delivery, Chestny ZNAK labeling is validated for B2B orders.
Assembly orders with incorrectly specified labeling cannot be transferred to delivery. A validation error MetaValidationFail with code 409 will be returned in the errors array in the responses of the following methods:
• POST /api/v3/public/dbw/orders/status/deliver
• POST /api/marketplace/v3/dbs/orders/status/deliver
The metaDetails array in the response will contain the labeling validation status for each assembly order. Before transferring assembly orders to delivery, check the metadata validation statuses in the responses of these methods:
• POST /api/marketplace/v3/dbw/orders/meta/details
• POST /api/marketplace/v3/dbs/orders/meta/details
On June 5, we will disable the outdated methods:
• PATCH /api/v3/dbw/orders/{orderId}/assemble
• DELETE /api/v3/dbw/orders/{orderId}/meta
• PUT /api/v3/dbw/orders/{orderId}/meta/sgtin
📖 WB API Release Notes
Best regards, WB API team
#fbs
Изменения в заказах FBS
Теперь вы можете отменить сборочные задания до их передачи Wildberries.
Чтобы проверить, можно ли отменить сборочное задание, используйте метод POST /api/v3/orders/status, новое поле
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Изменения в заказах FBS
Теперь вы можете отменить сборочные задания до их передачи Wildberries.
Чтобы проверить, можно ли отменить сборочное задание, используйте метод POST /api/v3/orders/status, новое поле
isCancellable.📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Changes in FBS Orders
Now you can cancel assembly orders before handing them over to Wildberries.
To check whether an assembly order can be canceled, use the POST /api/v3/orders/status method and the new fieldisCancellable.
📖 WB API Release Notes
Best regards, WB API team
#items
Изменения в работе с Остатками на складах продавца
В ответы методов работы с остатками добавили пример ошибки при использовании устаревшего параметра
• POST /api/v3/stocks/{warehouseId}
• PUT /api/v3/stocks/{warehouseId}
• DELETE /api/v3/stocks/{warehouseId}
Вместо параметра
С 13 часов по московскому времени 20 мая управлять остатками через
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Изменения в работе с Остатками на складах продавца
В ответы методов работы с остатками добавили пример ошибки при использовании устаревшего параметра
sku:• POST /api/v3/stocks/{warehouseId}
• PUT /api/v3/stocks/{warehouseId}
• DELETE /api/v3/stocks/{warehouseId}
Вместо параметра
sku в запросах методов необходимо передавать chrtId — ID размера товара. Чтобы получить chrtId, используйте метод POST /content/v2/get/cards/list.С 13 часов по московскому времени 20 мая управлять остатками через
sku будет невозможно.📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Changes in Seller Warehouses Inventory Methods
Added an error example when using decpecated sku parameter to the inventory management methods responses:
• POST /api/v3/stocks/{warehouseId}
• PUT /api/v3/stocks/{warehouseId}
• DELETE /api/v3/stocks/{warehouseId}
Instead of the sku parameter in the method requests, you should pass the chrtId — item size ID. To get the chrtId, use the POST /content/v2/get/cards/list method.
From 1 pm Moscow time on May 20, it will be impossible to manage the inventory using sku parameter.
📖 WB API Release Notes
Best regards, WB API team
#general
Изменения в методах Управления пользователями продавца
Расширили список разделов личного кабинета, к которым можно настроить доступ сотрудникам:
•
•
•
•
Указывайте новые разделы в запросах методов:
• Создать приглашение для нового пользователя POST /api/v1/invite
• Изменить права доступа пользователей PUT /api/v1/users/access
Обновлённый список разделов можно получить в ответе метода GET /api/v1/users.
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Изменения в методах Управления пользователями продавца
Расширили список разделов личного кабинета, к которым можно настроить доступ сотрудникам:
•
brandsFlow — Мои бренды•
copyrightComplaints — Обращения правообладателей•
pretrialClaims — Досудебные претензии•
sellersChat — Чат с покупателямиУказывайте новые разделы в запросах методов:
• Создать приглашение для нового пользователя 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 personal account sections for which user access can be configured:
•brandsFlow— My brands
•copyrightComplaints— Copyright Claims
•pretrialClaims— Out-of-Court Claims
•sellersChat— Chat with Users
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
ВБ Интеграция | WB API
Новый метод получения остатков на складах WB Добавили метод получения текущих остатков на складах WB — POST /api/analytics/v1/stocks-report/wb-warehouses. В новом методе: • расширили лимит запросов на один аккаунт продавца до 1 раза в 20 секунд • увеличили…
ВБ Интеграция | WB API
#items Изменения в работе с Остатками на складах продавца В ответы методов работы с остатками добавили пример ошибки при использовании устаревшего параметра sku: • POST /api/v3/stocks/{warehouseId} • PUT /api/v3/stocks/{warehouseId} • DELETE /api/v3/st…
#items
Изменения в работе с Остатками на складах продавца
Напоминаем, что 20 мая с 13 часов по московскому времени мы начинаем отключать управление остатками через баркоды, параметр
В запросах методов управления остатками необходимо передавать только
При использовании устаревшего параметра
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Изменения в работе с Остатками на складах продавца
Напоминаем, что 20 мая с 13 часов по московскому времени мы начинаем отключать управление остатками через баркоды, параметр
sku. Отключение будет постепенным, от 10 минут в час каждый день. Продолжительность отключения может быть изменена без дополнительных уведомлений.В запросах методов управления остатками необходимо передавать только
chrtId — ID размера товара. Чтобы получить chrtId, используйте метод POST /content/v2/get/cards/list.При использовании устаревшего параметра
sku в ответах методов работы с остатками вы получите ошибку 400 со значением "code":"SKUUploadDisabled", при этом остатки не будут обновлены.📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Changes in Inventory Methods
Please note, that on May 20, from 1 pm Moscow time we will start disabling inventory management via barcodes, the sku parameter. The disabling will be gradual, from 10 minutes per hour every day. The duration of the disabling can be changed without additional notification.
In requests for inventory management methods, you should transfer only the chrtId — item size ID. To get the chrtId, use the POST /content/v2/get/cards/list method.
If you use the deprecated sku parameter, in the responses of inventory management methods, you will receive error 400 with the value "code":"SKUUploadDisabled", and the inventory will not be updated.
📖 WB API Release Notes
Best regards, WB API team
#communication
Изменения в методах Чат с покупателями
По техническим причинам обновили формат поля
Поле
До 4 июня в запросе метода POST /api/v1/seller/message можно будет указывать
После 4 июня отправить сообщение в чат можно будет только с
📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Изменения в методах Чат с покупателями
По техническим причинам обновили формат поля
replySign — подпись чата — в методе получения списков чатов GET /api/v1/seller/chats. Чтобы получить поле replySign нового формата, обновите список чатов с помощью метода GET /api/v1/seller/chats.Поле
replySign необходимо указывать в запросе метода POST /api/v1/seller/message, чтобы отправить сообщение в чат.До 4 июня в запросе метода POST /api/v1/seller/message можно будет указывать
replySign и старого, и нового формата.После 4 июня отправить сообщение в чат можно будет только с
replySign нового формата. Старый формат не будет поддерживаться.📖 Журнал изменений WB API
💬 Сообщество WB API
С уважением, команда WB API
🔗 Читайте в МАКС
Changes in Buyers Chat Methods
Due to technical reasons, we updated the format of thereplySignfield — the chat signature — in the method for getting chat lists GET /api/v1/seller/chats. To receive thereplySignfield in the new format, update the chat list using the GET /api/v1/seller/chats method.
ThereplySignfield should be specified in the request of the POST /api/v1/seller/message method in order to send a message to a chat.
Until June 4, you can specifyreplySignin the POST /api/v1/seller/message request in both the old and new formats.
After June 4, you will only be able to send a message to a chat using the new format ofreplySign. The old format will no longer be supported.
📖 WB API Release Notes
Best regards, WB API team