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

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

📄 Документация: dev.wildberries.ru
💬 Сообщество: dev.wildberries.ru/forum
Download Telegram
🔔 На портале WB API появился Центр уведомлений

Разделов на портале становится всё больше — и событий, которые важно не пропустить, тоже. Теперь для этого есть Центр уведомлений: портал сам сообщит, когда произойдёт что-то важное

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

Всё настраивается в Личном кабинете — можно выбрать категории и включить браузерные push-уведомления, чтобы ничего не пропустить, даже если вкладка с порталом закрыта

Это первый шаг: в ближайшее время подключим уведомления для Профиля компании, а в дальнейшем — оповещения об обновлениях из Журнала изменений

🖥 Подробнее о Центре уведомлений →
читайте в отдельной статье
Please open Telegram to view this post
VIEW IN TELEGRAM
#fbs

Признак B2B-продажи для поставок FBS

Добавили признак B2B-продажи для поставок FBS — поле isB2b — в ответы методов:
Получить список поставок
Получить информацию о поставке

Вы можете добавить к пустой поставке любое сборочное задание. После этого поставка приобретает признак B2B-продажи добавленного сборочного задания — этот признак будет указан в поле isB2b в ответах методов получения списка поставок и получения информации о поставке.

Чтобы узнать признак B2B-продажи сборочного задания, используйте методы получения новых сборочных заданий и получения информации о сборочных заданиях.

С 19 марта к одной поставке можно будет добавлять только сборочные задания с одинаковым признаком: B2B или не B2B.

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

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

B2B Sale Indicator for FBS Supplies

Added the indicator of B2B sale for FBS supplies — the isB2b field — to responses of the methods:
Get a Supplies List
Get Supply Details

You can add any assembly order to an empty supply. After that, the supply acquires the B2B indicator of the added assembly order. The B2B indicator of the supply will be specified in the isB2b field in the responses of the methods for getting a supplies list and getting supply details.

To check the indicator of a B2B sale of an assembly order, use the methods for getting new assembly orders and getting assembly orders.

Starting from March 19, it will be possible to add to the supply only the assembly orders with the same B2B indicator value: either B2B or non-B2B.

📖 WB API Release Notes

Best regards, WB API team

#items

Новые правила объединения карточек товаров

С 11 марта для категорий Красота и Бытовая химия будут действовать новые правила объединения карточек товаров.

Изменения затронут методы:
Создание карточек товаров
Создание карточек товаров с присоединением
Редактирование карточек товаров

Если карточка в запросе не соответствует новым правилам, методы вернут ответ со статус-кодом 400 и соответствующими значениями поля errorText. В объекте additionalErrors будут перечислены vendorCode карточек товаров, не соответствующих правилам.

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

New Rules for Item Merging

Starting from March 11, new rules for item merging will apply for the Beauty and Household Chemicals categories.

The changes will affect the methods:
Create Product Cards
Create Product Cards with Merge
Update Product Cards

If аn item in a request does not comply with the new rules, the methods will return the 400 status code response and the corresponding values of the errorText field. The vendorCode of items that do not comply with the rules will be listed in the additionalErrors object.

📖 WB API Release Notes

Best regards, WB API team
#instructions

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

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

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

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

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

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

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

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

Рекомендуемые ставки для карточек товаров и поисковых кластеров

Добавили метод получения рекомендуемых ставок. Используйте этот метод, чтобы получать конкурентные и лидерские ставки для карточек товаров и поисковых кластеров по ID кампании и артикулу WB.

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

Recommended bids for items and search clusters

Added a method for getting recommended bids. Use this method to get competitive and leadership bids for items and search clusters by campaign ID and WB article.

📖 WB API Release Notes
#dbw

Новый метод DBW

Добавили метод получения информации о покупателе для модели DBW.
Используйте его, чтобы получать данные клиента по ID заказа.

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

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

New DBW Method

Added a method for getting buyer information for DBW model. Use it to get buyers data by their order ID.

📖 WB API Release Notes

Best regards, WB API team
#fbw

Изменения в поставках FBW

Добавили поле isBoxOnPallet — тип поставки Поштучная паллета — в ответы методов:
Опции приёмки
Список поставок
Детали поставки

Добавили поле boxTypeID — ID типа поставки — в  ответ метода Список поставок.

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

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

Changes in the FBW Supplies

Added the isBoxOnPallet field — Pallet with Single Items supply type — to the responses of the methods:
Acceptance Options
Supplies List
Supply Details

Added the boxTypeID — supply type ID — to the Supplies List method response.

📖 WB API Release Notes

Best regards, WB API team
#dbs

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

Теперь перевести сборочное задание в доставку можно только, если за ним закреплён обязательный IMEI.

Если за сборочным заданием не закреплён обязательный IMEI, в ответе метода POST /api/marketplace/v3/dbs/orders/status/deliver вы получите ошибку со статус-кодом 409 и "detail":"ImeiIsNotFilled".

Проверяйте метаданные сборочного задания в массиве requiredMeta ответа метода GET /api/v3/dbs/orders/new.

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

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

Orders DBS changes

Now you can transfer an assembly order to delivery only if the required IMEI is specified.

If the required IMEI is not specified for an assembly order, the method POST /api/marketplace/v3/dbs/orders/status/deliver will return an error with status code 409 and "detail":"ImeiIsNotFilled".

Check the assembly order metadata in the requiredMeta array in the response of the method GET /api/v3/dbs/orders/new.

📖 WB API Release Notes
#general

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

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

Управлять доступом пользователей можно только с токеном активного владельца профиля продавца. Для авторизации используйте Персональный токен с категорией Пользователи.

📖 Журнал изменений WB API

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

Changes in User Management Methods

The Seller User Management methods are available for all sellers countries now.

You can manage user access only with a token from the active owner of the seller account. To authorize, use a Personal token with the Users category.

📖 WB API Release Notes

Best regards, WB API team
💬 Оставайтесь на связи с командой WB API

Наш Telegram-канал продолжает работу, но, в связи с усилением технических ограничений, мы работаем над альтернативными каналами коммуникации с нашими пользователями.

Тем временем вся актуальная информация о WB API доступна на портале для разработчиков: dev.wildberries.ru

На портале вас ждут:
Журнал изменений – полный список актуальных изменений в функционале WB API;
• Новости и материалы – статьи, инструкции, кейсы и другой полезный контент;
Сообщество – площадка для общения с другими разработчиками-интеграторами;
• А также множество иных функций для комфортной и стабильной работы с WB API.

О любых новостях, касающихся новых каналов коммуникации или изменений в работе текущих, мы сообщим дополнительно.
ВБ Интеграция | WB API
#fbs Признак B2B-продажи для поставок FBS Добавили признак B2B-продажи для поставок FBS — поле isB2b — в ответы методов: • Получить список поставок • Получить информацию о поставке Вы можете добавить к пустой поставке любое сборочное задание. После этого…
#fbs

Напоминаем, что с 19 марта к одной поставке можно будет добавлять только сборочные задания с одинаковым признаком: B2B или не B2B.

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

Please note that starting from March 19 it will be possible to add to the supply only the assembly orders with the same B2B indicator value: either B2B or non-B2B.

Best regards, WB API team
#instructions

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

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

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

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

С 30 марта начнём вводить разные лимиты запросов в зависимости от типа токена. Это необходимо, чтобы сбалансировать нагрузку на WB API и получить стабильную работу интеграций с учётом потребностей продавцов.

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

Подробнее о новых лимитах вы можете прочитать в статье.

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

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

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

Request Limits by Token Types

Starting from March 30, we will begin implementing different request limits depending on the token type. This is necessary to balance the load on the WB API and ensure stable integration performance, taking into account sellers' needs.

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.

You can learn more about the new limits in the article.

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
#general

Новое поле в ответе метода получения информации о продавце

В ответ метода получения информации о продавце GET /api/v1/seller-info добавили поле tinИНН.

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

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

New Field in The Seller Information Method

Added the tin field — Taxpayer identification number of the partner (INN in Russian) — to the response of the seller information method GET /api/v1/seller-info method.

📖 WB API Release Notes

Best regards, WB API team
Новый метод получения остатков на складах WB

Добавили метод получения текущих остатков на складах WB — POST /api/analytics/v1/stocks-report/wb-warehouses.

В новом методе:
• расширили лимит запросов на один аккаунт продавца до 1 раза в 20 секунд
• увеличили количество строк в ответе до 250 000
• реализовали отображение всех остатков одного размера на одном складе строго в одной строке
• ввели офсетную пагинацию
• изменили выдачу данных на по возрастанию значений артикулов WB
• добавили в ответы ID складов и регионы отгрузки
• добавили возможность получения данных по конкретным товарам

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

Текущий метод GET /api/v1/supplier/stocks будет отключён 23 июня.

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

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

New Method for WB Warehouses Inventory

Added method for getting current WB warehouses inventory — POST /api/analytics/v1/stocks-report/wb-warehouses.

In this method we:
• expanded request limit per one seller's account to 1 request per 20 seconds
• increased number of rows in response to 250,000
• made all inventory of the same size in the same warehouse is strictly in one row
• introduced offset pagination
• changed sorting: data is displayed in ascending order of Wildberries article values
• added warehouse IDs and shipping regions to the responses
• added the ability to get data on specific items

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

The current method GET /api/v1/supplier/stocks will be disabled on June 23.

📖 WB API Release Notes

Best regards, WB API team
Работа с WB API для сторонних сервисов

В продолжение обновления лимитов запросов — рассказываем о порядке действий для сторонних сервисов

Для сервисов, которые не представлены в Каталоге решений, мы предусмотрели возможность работать с базовыми токенами без сниженных лимитов. Для этого необходимо идентифицировать трафик.

Как идентифицировать трафик

Отправьте заявку на business-solutions@rwb.ru и укажите:

• Название сервиса
• Краткое описание задачи, которую сервис решает для продавца
• Ссылка на сайт сервиса
• Количество продавцов
• ИНН и название юридического лица
• Почему на данном этапе не подаётесь в Каталог
• Контакт для связи (почта или Telegram)

После рассмотрения заявки мы свяжемся и расскажем о дальнейших шагах и условиях доступа.

Важно учитывать

Подача заявки — это идентификация трафика, а не авторизация сервиса и не добавление в Каталог решений. Сервисные токены в рамках этого процесса не выдаются.

Если остались вопросы — пишите на почту business-solutions@rwb.ru
#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