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

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

📄 Документация: dev.wildberries.ru
💬 Сообщество: dev.wildberries.ru/forum
Download Telegram
#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
#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