Перейти к основному содержимому

Wildberries Seller API — Полная документация

Дата генерации: 2026-02-10 22:10:27

Всего API секций: 14 Всего endpoints: 294

Аутентификация​

HeaderApiKey​

  • Тип: apiKey
  • Расположение: header
  • Используется в секциях: general, content, orders-fbs, orders-dbw, orders-dbs, in-store-pickup, orders-fbw, promotion, communications, tariffs, analytics, reports, finances

ApiKeyAuth​

  • Тип: apiKey

  • Расположение: header

  • Описание: Добавьте в заголовок запроса Authorization: Bearer api_token.
    В разделе Авторизация вы можете ознакомиться с инструкцией по получению и применению токена

  • Используется в секциях: wbd

Base URLs​

Базовые URL для различных API секций:

  • https://common-api.wildberries.ru

    • Секции: general, tariffs

  • https://user-management-api.wildberries.ru

    • Секции: general

  • https://content-api.wildberries.ru

    • Секции: content

  • https://discounts-prices-api.wildberries.ru

    • Секции: content

  • https://marketplace-api.wildberries.ru

    • Секции: content, orders-fbs, orders-dbw, orders-dbs, in-store-pickup

  • https://supplies-api.wildberries.ru

    • Секции: orders-fbw

  • https://advert-api.wildberries.ru

    • Секции: promotion

  • https://advert-media-api.wildberries.ru

    • Секции: promotion

  • https://dp-calendar-api.wildberries.ru

    • Секции: promotion

  • https://feedbacks-api.wildberries.ru

    • Секции: communications

  • https://buyer-chat-api.wildberries.ru

    • Секции: communications

  • https://returns-api.wildberries.ru

    • Секции: communications

  • https://seller-analytics-api.wildberries.ru

    • Секции: analytics, reports

  • https://statistics-api.wildberries.ru

    • Секции: reports, finances

  • https://finance-api.wildberries.ru

    • Секции: finances

  • https://documents-api.wildberries.ru

    • Секции: finances

  • https://devapi-digital.wildberries.ru

    • Секции: wbd

Rate Limits​

Информация о лимитах запросов (найдено в описаниях endpoints):

GENERAL​

  • GET /ping
    • Метод проверяет:
    1. Успешно ли запрос доходит до WB API
    2. Валидность токена авторизации и URL запроса
    3. Совпадают ли категория токена и сервис
Метод не п...

  • GET /api/communications/v2/news

    • Метод позволяет получать новости портала продавцов.
      Для получения успешного ответа необходимо указать один из параметров from или fromID.
      За один запрос можно получить не более 100 новос...

  • GET /api/v1/seller-info

    • Метод позволяет получать наименование продавца и ID его профиля.
      В запросе можно использовать любой токен, у которого не выбрана опция Тестовый контур.

  • POST /api/v1/invite

    • Метод создаёт приглашение для нового пользователя с настройкой доступов к разделам профиля продавца.
      Как выдаются права доступа:

  • Если access пустой ([]) или не указан — по умолчанию выдаются...

  • GET /api/v1/users

    • Метод возвращает список активных или приглашённых пользователей профиля продавца.

      Чтобы выбрать список, укажите значение параметра isInviteOnly:
    • isInviteOnly=true — список приглашённых...

  • PUT /api/v1/users/access

    • Метод меняет права доступа одному или нескольким пользователям.

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

CONTENT​

  • GET /content/v2/object/parent/all

    • Метод возвращает названия и ID всех родительских категорий для создания карточек товаров: например, Электроника, Бытовая химия, `Рукод...

  • GET /content/v2/object/all

  • GET /content/v2/object/charcs/{subjectId}

    • Метод возвращает параметры характеристик предмета: названия, типы данных, единицы измерения и так далее. В запросе необходимо указать ID [предмета](/openapi/work-with-products#tag/Kategorii-predmety-i...

  • GET /content/v2/directory/colors

<di...

  • GET /content/v2/directory/kinds

<div...

  • GET /content/v2/directory/countries

    • Метод возвращает возможные значения характеристики предмета `Страна прои...

  • GET /content/v2/directory/seasons

<d...

  • GET /content/v2/directory/vat

  • GET /content/v2/directory/tnved

    • Метод возвращает список ТНВЭД-кодов по ID предмета и фрагменту ТНВЭД-кода.
  • GET /api/content/v1/brands
    • Метод возвращает список брендов по ID предмета.
Лимит запросов на один аккаунт продавца:

| Период ...

  • GET /content/v2/tags
    • Метод возвращает список и характеристики всех ярлыков продавца для группировки и фильтрации товаров.
Ли...
  • PATCH /content/v2/tag/{id}
    • Метод заменяет данные ярлыка: имя и цвет.
      Новые данные можно получить в общем списке.

  • POST /content/v2/tag/nomenclature/link

    • Метод добавляет или снимает ярлык с карточки товара. К карточке можно добавить максимум 15 ярлыков.
      При удалении ярлыка из карточки товара он не удаляется из [списка ярлыков](/openapi/work-with-pr...

  • POST /content/v2/get/cards/list

    Метод доступен по токену с категорией Контент</strong...

  • POST /content/v2/cards/error/list

    • Метод возвращает список карточек товаров (черновиков), при создании или редактировании которых произошли ошибки, с описанием этих ошибок.
      <br...

  • POST /content/v2/cards/update

    • Метод обновляет данные карточек товаров. Также используйте его, чтобы добавлять новые размеры.
Карточка товара перезаписывается при обновлении. Поэтому в запросе...
Карточка това...

  • POST /content/v2/get/cards/trash

    Метод доступен по токену с категорией Контент</strong...

  • GET /content/v2/cards/limits

Формула для...

  • POST /content/v2/barcodes

    • Метод генерирует массив уникальных баркодов для создания размера в карточке товара. Можно использо...

  • POST /content/v2/cards/upload

    • Метод создаёт карточки товаров c указанием описаний и характеристик товаров.
Есть две формы запроса: для создания отдельных и объединённых карточек товаров <...

  • POST /content/v2/cards/upload/add

    • Метод создаёт карточки товаров, присоединяя их к существующим отдельным карточкам и группам объединённых карточек. В...

  • POST /content/v3/media/file

    • Метод загружает и добавляет один медиафайл к карточке товара.

Требования к изображениям:

  • максимум изображений для одной карточки товара — 30
  • минимальное разрешение — 700x900 px
  • максимальн...
  • POST /content/v3/media/save
    • Метод загружает набор медиафайлов в карточку товара через указание ссылок в запросе.
Новые медиафайлы полностью заменяют старые. Чтобы добавить новые медиафайлы,...

  • POST /api/v2/upload/task

    • Метод устанавливает цены и скидки для товаров.

      Чтобы установить цены для размеров товара, используйте [отдельный метод](/openapi/work-with-products#tag/Ceny-i-skidki/paths/1api1v21upload1...

  • POST /api/v2/upload/task/size

    • Метод устанавливает цены отдельно для размеров товаров.

Работает только для товаров из категорий, где можно устанавливать цены отдельно для разных размеров. Для [таких товаров](/openapi/work-with-pro...

  • POST /api/v2/upload/task/club-discount
    • Устанавливает скидки для товаров в рамках подписки WB Клуб.
Получить информацию о процессе установки ц...
  • GET /api/v2/history/tasks
    • Метод возвращает информацию об обработанной загрузке цен и скидок.
Обработанная загрузка — это загрузка цен и скидок для
  • GET /api/v2/history/goods/task
    • Метод возвращает информацию о товарах и об ошибках в товарах в обработанной загрузке.
Обработанная загрузка — это загрузка цен и скидок для
  • GET /api/v2/buffer/tasks
    • Метод возвращает информацию про загрузку скидок в обработке.
Необработанная загрузка — это загрузка скидок в кале...
  • GET /api/v2/buffer/goods/task
    • Метод возвращает информацию о товарах и ошибках в товарах из загрузки в обработке.
Необработанная загрузка — это загрузка скидок в
  • PUT /api/v3/stocks/{warehouseId}
    • Метод обновляет количество остатков товаров продавца в списке.
  • DELETE /api/v3/stocks/{warehouseId}

  • GET /api/v3/offices

    • Метод возвращает список всех складов WB для привязки к складам продавца. Предназначен для определения складов WB, чтобы сдавать готовые заказы по модели FBS (Fulf...

  • GET /api/v3/warehouses

    • Метод возвращает список всех складов продавца. Может использоваться для получения [остатков товаров](/openapi/work-with-products#tag/Ostatki-na-skladah-prodavca/paths/1api1v31stocks1%7BwarehouseId...

  • POST /api/v3/warehouses

    • Метод создаёт склад продавца для работы с остатками товаров. Нужно привязать к складу про...

  • PUT /api/v3/warehouses/{warehouseId}

    • Метод обновляет данные склада продавца в списке складов. Данные о привязанном [складе WB](/openapi/work-with-products...

  • DELETE /api/v3/warehouses/{warehouseId}

  • GET /api/v3/dbw/warehouses/{warehouseId}/contacts

Только для складов с типом доставки 3 — дост...

Список контактов перезаписыв...

ORDERS-FBS​

Данные, которые возвращает ...
  • GET /api/v3/passes
    • Метод возвращает список всех созданных пропусков продавца.

Пропуск действует 48 часов со времени создания.

  • PUT /api/v3/passes/{passId}
    • Метод обновляет данные пропуска продавца. В том числе, можно обновить данные привязанного склада WB.
  • DELETE /api/v3/passes/{passId}
  • GET /api/v3/orders/new
    • Метод возвращает список всех новых сборочных заданий, которые есть у продавца на момент запроса.
  • GET /api/v3/orders
    • Метод возвращает информацию о сборочных заданиях без их актуального статуса.

Можно получить данные за заданный ...

  • POST /api/v3/orders/status

    • Метод возвращает статусы сборочных заданий по их ID.

      supplierStatus — статус сборочного задания. Триггер его и...

  • GET /api/v3/supplies/orders/reshipment

    • Метод возвращает все сборочные задания, требующие повторной отгрузки.

      Повторная отгрузка требуется, если поставк...

  • PATCH /api/v3/orders/{orderId}/cancel

    • Метод отменяет сборочное задание и переводит в [статус](/openapi/orders-fbs#tag/Sborochnye-zadaniya-FBS/paths/1api1v3~1...

  • POST /api/v3/orders/stickers

Можно получить стикер в форматах:

Добавить срок годности м...

У одного сбо...

  • POST /api/v3/orders/stickers/cross-border

Ограничения:

  • За один запрос ...

  • POST /api/v3/orders/status/history

    • Метод возвращает историю статусов для [сборочных заданий](/openapi/orders-fbs#tag/Sborochnye-zadaniya-FBS/paths/...

  • POST /api/v3/orders/client

    • Метод позволяет получать информацию о покупателе по ID сборочного задания.

Только для кроссбордера из Турции.

  • GET /api/v3/supplies

Ограничения:

  • Только для [сборочных заданий](/openapi/orders-fbs#tag/Sborochnye-za...

  • PATCH /api/marketplace/v3/supplies/{supplyId}/orders

    • Метод добавляет до 100 сборочных заданий к поставке и переводит их в [статус](/openapi/orders-fbs#tag/Sborochnye-zadaniya...

  • GET /api/v3/supplies/{supplyId}

    • Метод возвращает подробную информацию о поставке.
Лимит запросов на один аккаунт продавца для метод...

  • DELETE /api/v3/supplies/{supplyId}

    • Метод удаляет поставку, если она активна и за ней не закреплено ни одно [сборочное задание](/openapi/orders-fbs#ta...

  • GET /api/marketplace/v3/supplies/{supplyId}/order-ids

    • Метод возвращает список ID сборочных заданий, закреплённых за поставкой.
Лимит запросов на один акк...

  • PATCH /api/v3/supplies/{supplyId}/deliver

    • Метод закрывает поставку и переводит все [сборочные задания](/openapi/orders-fbs#tag/Sborochnye-zadaniya-FBS/paths...

  • GET /api/v3/supplies/{supplyId}/barcode

    • Метод возвращает QR-код поставки в форматах:
    • SVG
    • ZPLV (вертикальный)
    • ZPLH (горизонтальный)
    • PNG

QR...

  • GET /api/v3/supplies/{supplyId}/trbx
    • Возвращает список коробов поставки.
Лимит запросов на один аккаунт продавца для методов сбо...

  • POST /api/v3/supplies/{supplyId}/trbx

    • Метод добавляет требуемое количество коробов в [поставку](/openapi/orders-fbs#tag/Postavki-FBS/paths/1api1...

  • DELETE /api/v3/supplies/{supplyId}/trbx

    • Метод удаляет короба из поставки.

      Можно удалить только пока поставка на сборке.
Лимит запросов...
  • POST /api/v3/supplies/{supplyId}/trbx/stickers
    • Метод возвращает QR-стикеры в форматах:
    • SVG
    • ZPLV (вертикальный)
    • ZPLH (горизонтальный)
    • PNG

      Размер стикеров — 580x400 px.

ORDERS-DBW​

  • GET /api/v3/dbw/orders

    • Метод возвращает информацию о завершенных сборочных заданиях.

      Можно получить данные за заданный период, максимум 30 календарных дней одним з...

  • POST /api/v3/dbw/orders/delivery-date

    • Метод возвращает информацию о выбранных покупателем дате и времени доставки сборочных заданий.
Лим...
  • POST /api/v3/dbw/orders/status
    • Метод возвращает статусы сборочных заданий по их ID.

      supplierStatus — статус сборочного задания. Триггер его изменения — действие самого продавца.

Возможные значения supplierStatus: | Ст...

Можно получить стикер в форматах:

  • SVG

  • ZPLV (ве...

  • PATCH /api/v3/dbw/orders/{orderId}/assemble

  • POST /api/v3/dbw/orders/courier

    • Метод возвращает контактные данные и номер автомобиля курьера по ID сборочного задания.
      Для сборочных заданий в статусах confirm, complete.

ORDERS-DBS​

  • GET /api/v3/dbs/orders/new
    • Метод возвращает список всех новых сборочных заданий, которые есть у продавца на момент запроса.

  • GET /api/v3/dbs/orders

    • Метод возвращает информацию о завершенных сборочных заданиях после продажи или отмены заказа.

      Можно получить данные за заданный период, макс...

  • POST /api/v3/dbs/groups/info

    • Метод возвращает информацию о платной доставке сборочных заданий, которые поступили на один склад (warehouseId) в рамках одной транзакции покупателя (orderUid).
  • POST /api/v3/dbs/orders/client
    • Метод возвращает информацию о покупателе по ID сборочных заданий.
Лимит запросов на один аккаунт пр...
  • POST /api/marketplace/v3/dbs/orders/b2b/info
    • Метод возвращает данные B2B-покупателей по ID сборочных заданий:
    • ИНН
    • КПП
    • Наименование организации
  • POST /api/v3/dbs/orders/delivery-date
    • Метод возвращает информацию о выбранных покупателем дате и времени доставки сборочных заданий.
Лим...

  • POST /api/marketplace/v3/dbs/orders/status/info

  • POST /api/marketplace/v3/dbs/orders/status/cancel

    • Метод переводит сборочные задания из [статусов](/openapi/orders-dbs#tag/Sborochnye-zadaniya-DBS/paths/1api1marketplace1v31dbs1orders1status~1in...

  • POST /api/marketplace/v3/dbs/orders/status/confirm

    • Метод переводит сборочные задания из [статуса](/openapi/orders-dbs#tag/Sborochnye-zadaniya-DBS/paths/1api1marketplace1v31dbs1orders1status~1inf...

  • POST /api/marketplace/v3/dbs/orders/status/deliver

    • Метод переводит сборочные задания из [статуса](/openapi/orders-dbs#tag/Sborochnye-zadaniya-DBS/paths/1api1marketplace1v31dbs1orders1status~1inf...

  • POST /api/marketplace/v3/dbs/orders/status/receive

    • Метод переводит сборочные задания из [статуса](/openapi/orders-dbs#tag/Sborochnye-zadaniya-DBS/paths/1api1marketplace1v31dbs1orders1status~1inf...

  • POST /api/marketplace/v3/dbs/orders/status/reject

    • Метод переводит сборочные задания из [статуса](/openapi/orders-dbs#tag/Sborochnye-zadaniya-DBS/paths/1api1marketplace1v31dbs1orders1status~1inf...

  • POST /api/marketplace/v3/dbs/orders/meta/info

    • Метод возвращает метаданные сборочных заданий.
      Перечень метаданных, доступных для сборочного задания, можно получить в [списке новых сборочных з...

  • POST /api/marketplace/v3/dbs/orders/meta/delete

    • Метод удаляет значение указанных метаданных для нескольких сборочных заданий.

      В одном запр...

  • POST /api/marketplace/v3/dbs/orders/meta/sgtin

  • POST /api/marketplace/v3/dbs/orders/meta/uin

  • POST /api/marketplace/v3/dbs/orders/meta/imei

    • Метод обновляет IMEI в метаданных нескольких сборочных заданий.
      У одного сборочного задания мож...

  • POST /api/marketplace/v3/dbs/orders/meta/gtin

    • Метод обновляет GTIN, уникальный ID товара в Беларуси, в метаданных нескольких сборочных заданий.<b...

  • POST /api/marketplace/v3/dbs/orders/meta/customs-declaration

IN-STORE-PICKUP​

  • GET /api/v3/click-collect/orders/new
    • Метод возвращает список всех новых сборочных заданий, которые есть у продавца на момент запроса.
  • PATCH /api/v3/click-collect/orders/{orderId}/confirm
    • Метод переводит сборочное задание в статус confirm — на сборке.
Лимит запросов на один аккаунт пр...
  • PATCH /api/v3/click-collect/orders/{orderId}/prepare
    • Метод переводит сборочное задание в статус prepare — готово к выдаче.
Лимит запросов на один акка...
  • POST /api/v3/click-collect/orders/client
    • Метод возвращает информацию о покупателе по ID сборочного задания.

      Доступно только для сборочных заданий в статусах:
    • confirm — на сборке
    • prepare — готов к выдаче

  • POST /api/v3/click-collect/orders/client/identity

    • Метод сообщает, принадлежит ли проверяемый заказ покупателю или нет по переданному коду.

      Доступно, если хотя бы одно сборочное задание из заказа находится в статусе prepare - готов к выдаче. ...

  • PATCH /api/v3/click-collect/orders/{orderId}/receive

    • Метод переводит сборочное задание в статус receive — получено покупателем.
Лимит запросов на один...
  • PATCH /api/v3/click-collect/orders/{orderId}/reject
    • Метод переводит сборочное задание в статус reject — отказ при получении.
Лимит запросов на один а...
  • POST /api/v3/click-collect/orders/status
    • Метод возвращает статусы сборочных заданий по их ID.

      supplierStatus — статус сборочного задания. Триггер его изменения - действие самого продавца.

Возможные значения supplierStatus: | Ст...

  • GET /api/v3/click-collect/orders
    • Метод возвращает информацию о завершённых сборочных заданиях после продажи или отмены заказа.

Можно получить данные за заданный период, максимум 30 календарных дней одним запросом.

  • PATCH /api/v3/click-collect/orders/{orderId}/cancel
    • Метод отменяет сборочное задание и переводит в статус cancel — отменено продавцом.
Лимит запросов...

  • GET /api/v3/click-collect/orders/{orderId}/meta

  • DELETE /api/v3/click-collect/orders/{orderId}/meta

    • Метод удаляет значение метаданных сборочного задания для переданного ключа. Возможные метаданные: imei, uin, gtin, sgtin Передается только одно значение.

  • PUT /api/v3/click-collect/orders/{orderId}/meta/sgtin

    • Метод закрепляет за сборочным заданием код маркировки Честный знак.

      Закрепить код маркировки можно только, если в [метаданных сборочного задания](/openapi/in-store-p...

  • PUT /api/v3/click-collect/orders/{orderId}/meta/uin

    • Метод обновляет УИН сборочного задания. У одного сборочного задания может быть только один УИН. Добавлять маркировку можно только для сборочных заданий в статусе confirm и доставка которых осуществл...

  • PUT /api/v3/click-collect/orders/{orderId}/meta/imei

    • Метод обновляет IMEI сборочного задания. У одного сборочного задания может быть только один IMEI. Добавлять маркировку можно только для сборочных заданий в статусе confirm и доставка которых осущест...

  • PUT /api/v3/click-collect/orders/{orderId}/meta/gtin

    • Метод обновляет GTIN (уникальный ID товара в Беларуси) сборочного задания. У одного сборочного задания может быть только один GTIN. Добавлять маркировку можно только для сборочных заданий в статусе `c...

ORDERS-FBW​

  • GET /api/v1/acceptance/coefficients

    • Метод находится в разделе Тарифы и называется Тарифы на поставку `GET /api/tariffs/v1/acceptanc...

  • POST /api/v1/acceptance/options

    • Метод возвращает информацию о том, какие склады и типы упаковки доступны для поставки. Список складов определяется по баркоду и количеству товара.
  • GET /api/v1/warehouses
    • Метод возвращает список складов WB.
Лимит запросов на один аккаунт продавца:

| Период | Лимит | Ин...

  • GET /api/v1/transit-tariffs
    • Метод возвращает информацию о доступных транзитных направлениях.
Лимит запросов на один аккаунт про...
  • POST /api/v1/supplies
    • Метод возвращает список поставок, по умолчанию — последние 1000 поставок.
Лимит запросов на один ак...
  • GET /api/v1/supplies/{ID}
    • Метод возвращает детали поставки по ID.
Лимит запросов на один аккаунт продавца:

| Период | Лимит ...

  • GET /api/v1/supplies/{ID}/goods
    • Метод возвращает информацию о товарах в поставке.
Лимит запросов на один аккаунт продавца:

| Перио...

  • GET /api/v1/supplies/{ID}/package
    • Метод возвращает информацию об упаковке поставки.
Лимит запросов на один аккаунт продавца:

| Перио...

PROMOTION​

  • GET /adv/v1/promotion/count

    • Метод возвращает списки всех рекламных кампаний продавца с их ID. Кампании сгруппированы по типу и статусу, у каждой указана дат...

  • GET /api/advert/v2/adverts

    • Метод возвращает информацию о рекламных кампаниях с единой или ручной ставкой по их статусам, типам оплаты и ID.
  • POST /api/advert/v1/bids/min
    • Метод возвращает минимальные ставки для карточек товаров в копейках по типу оплаты и местам размещения.
  • POST /adv/v2/seacat/save-ad
    • Метод создаёт кампанию:
    • с ручной ставкой для продвижения товаров в поиске и/или рекомендациях
    • с единой ставкой для продвижения товаров одновременно в поиске и рекомендациях

  • GET /adv/v1/supplier/subjects

    • Метод возвращает список предметов, которые можно добавить в рекламную [кампанию](/openapi/pr...

  • POST /adv/v2/supplier/nms

    • Метод возвращает список карточек товаров, которые можно добавить в рекламную [кампанию](/openapi/promoti...

  • GET /adv/v0/delete

    • Метод удаляет кампании в статусе 4 — готова к запуску.

После удаления кампания некоторое время будет находиться в ста...

  • POST /adv/v0/rename
    • Метод меняет название кампании. Это можно сделать в любой момент существования кампании.

  • GET /adv/v0/start

    • Метод запускает кампании в статусах 4 — готово к запуску — или 11 — пауза. Чтобы запустить кампанию, проверьте ее бюджет. Ес...

  • GET /adv/v0/pause

    • Метод ставит кампании в статусе 9 — активна — на паузу.
  • GET /adv/v0/stop
    • Метод завершает кампании в статусах:
    • 4 — готово к запуску
    • 9 — активна
    • 11 — пауза
  • PUT /adv/v0/auction/placements
    • Метод меняет места размещения в кампаниях с ручной ставкой и моделью оплаты за показы — cpm.

      Для кампаний в статусах 4, 9 и 11.

  • PATCH /api/advert/v1/bids

    • Метод меняет ставки карточек товаров по артикулам WB в кампаниях с единой или ручной ставкой.

      Для кампаний в статусах 4, 9 и 11.

      В запросе укажите место размещения в параметре ...

  • GET /adv/v1/balance

    • Метод возвращает информацию о:
    • счёте кабинета Продвижения WB. Его пополняет продавец.
    • балансе — максимальной сумме для оплаты кампании по взаиморасчету: удержании средств из будущих продаж. Ба...

  • GET /adv/v1/budget

    • Метод возвращает информацию о бюджете кампании — максимальной сумме затрат на кампанию. Бюджет кампании можно [пополнить](/opena...

  • POST /adv/v1/budget/deposit

    • Метод пополняет бюджет кампании.
      Чтобы запустить кампанию после пополнения бюджета, используйте метод [Запуск кампании](/openapi/prom...

  • GET /adv/v1/upd

    • Метод формирует список фактических затрат на рекламные кампании за заданный период.
Лимит запросов ...
  • GET /adv/v1/payments
    • Метод возвращает историю пополнений счёта WB Продвижение за заданный период.
Лимит запросов на ...
  • PATCH /adv/v0/auction/nms
    • Метод добавляет и удаляет карточки товаров в кампаниях.

      Для кампаний в статусах 4, 9 и 11.

      Для добавляемых товаров устанавливается текущая минимальная ставка.
  • POST /adv/v0/normquery/stats
    • Метод возвращает статистику по поисковым кластерам за указанный период.
      Можно использовать только для кампаний с моделью оплаты cpm — за показы.
  • POST /adv/v0/normquery/get-bids
    • Метод возвращает список поисковых кластеров со ставками по:
    • ID кампаний
    • артикулам WB
Лимит запр...
  • POST /adv/v0/normquery/bids
    • Метод устанавливает ставки на поисковые кластеры.
      Можно использовать только для кампаний с:
    • ручной ставкой
    • моделью оплаты cpm — за показы
  • DELETE /adv/v0/normquery/bids
    • Метод удаляет ставки с поисковых кластеров.
      Можно использовать только для кампаний с:
    • ручной ставкой
    • моделью оплаты cpm — за показы
  • POST /adv/v0/normquery/get-minus
    • Метод возвращает список минус-фраз по:
    • ID кампаний
    • артикулам WB
Лимит запросов на один акк...
  • POST /adv/v0/normquery/set-minus
    • Метод устанавливает и удаляет минус-фразы в кампаниях c:
    • ручной ставкой
    • моделью оплаты cpm — за показы
Отправка пустого массива удаляет все минус-фразы...
  • GET /adv/v1/count
    • Метод возвращает количество медиакампаний продавца с группировкой по статусам.
  • GET /adv/v1/adverts
    • Метод возвращает список всех медиакампаний продавца по их типам и статусам.
  • GET /adv/v1/advert
    • Метод возвращает информацию о кампании WB Медиа. Вместо карточек товаров в медиакампаниях продвигаются рекламные баннеры продавца на сайте и в приложении WB.

<...

  • GET /adv/v3/fullstats
    • Метод формирует статистику для кампаний независимо от типа.

      Максимальный период в запросе — 31 день.

      Для кампаний в статусах 7, 9 и 11.
  • POST /adv/v1/stats
    • Метод формирует статистику кампаний сервиса WB Медиа. Статистику можно группировать по датам и/или интервалам.
  • GET /api/v1/calendar/promotions
    • Метод возвращает список акций в WB с датами и временем проведения.
  • GET /api/v1/calendar/promotions/details
    • Метод возвращает подробную информацию об акции по ID.

  • GET /api/v1/calendar/promotions/nomenclatures

    • Метод формирует список товаров, подходящих для участия в акции. Эти товары можно добавить в акцию с помощью ...

  • POST /api/v1/calendar/promotions/upload

    • Метод создаёт задание на загрузку товара в акцию.
      Состояние загрузки можно проверить с помощью [отдельны...

COMMUNICATIONS​

  • GET /api/v1/new-feedbacks-questions

    • Метод проверяет наличие непросмотренных вопросов и [отзывов](/openapi/user-communication#tag/Otzyvy/paths/1api1v1~1feedbacks...

  • GET /api/v1/questions/count-unanswered

    • Метод возвращает общее количество неотвеченных вопросов и количество неотвеченных вопросов за сегодня.
  • GET /api/v1/questions/count
    • Метод возвращает количество отвеченных или неотвеченных вопросов за заданный период.

  • GET /api/v1/questions

    • Метод возвращает список вопросов по заданным фильтрам. Вы можете:
    • получить данные отвеченных и неотвеченных вопросов
    • сортировать вопросы по дате
    • настроить пагинацию и количество вопросов в...

  • PATCH /api/v1/questions

    • В зависимости от тела запроса, метод позволяет:
    • отметить вопрос как просмотренный
    • отклонить вопрос
    • ответить на воп...

  • GET /api/v1/question

    • Метод возвращает данные вопроса по его ID. Далее вы можете [работать с этим вопросом](/openapi/user-communication#tag/Voprosy/...

  • GET /api/v1/feedbacks/count-unanswered

    • Метод возвращает:
    • количество необработанных отзывов за сегодня и за всё время
  • GET /api/v1/feedbacks/count
    • Метод возвращает количество обработанных или необработанных отзывов за заданный период.

  • GET /api/v1/feedbacks

    • Метод возвращает список отзывов по заданным фильтрам. Вы можете:
    • получить данные обработанных и необработанных отзывов
    • сортировать отзывы по дате
    • настроить пагинацию и количество отзывов в...

  • POST /api/v1/feedbacks/answer

    • Метод позволяет ответить на отзыв покупателя.
ID отзыва не валидируется. Если в запросе ...

  • PATCH /api/v1/feedbacks/answer

    • Метод позволяет отредактировать уже отправленный ответ на отзыв покупателя.

      Отредактировать ответ можно тольк...

  • POST /api/v1/feedbacks/order/return

    • Метод запрашивает возврат товара, по которому оставлен отзыв.

      Возврат доступен для отзывов с полем `"isAbleReturnProdu...

  • GET /api/v1/feedback

    • Метод возвращает данные отзыва по его ID.

  • GET /api/v1/feedbacks/archive

    • Метод возвращает список архивных отзывов.

      Отзыв становится архивным, если:
    • на отзыв получен ответ
    • на отзыв не ...

  • GET /api/feedbacks/v1/pins

    • Метод предоставляет список закреплённых и откреплённых отзывов.

Откреплёнными считаются только отзывы, которые были откреплены автоматически по причинам, указанным в ответе в поле unpinnedCause...

  • POST /api/feedbacks/v1/pins

    • Метод позволяет закрепить отзывы в карточке товара или в группе объединённых карточек.
      Чтобы получить ID отзыво...

  • DELETE /api/feedbacks/v1/pins

    • Метод позволяет открепить отзывы в карточке товара или в группе объединённых карточек.
      Чтобы получить pinId — ...

  • GET /api/feedbacks/v1/pins/count

    • Метод возвращает количество закреплённых и откреплённых отзывов за заданный период.
Лимит запросов ...
  • GET /api/feedbacks/v1/pins/limits
    • Метод возвращает лимиты закреплённых отзывов по тарифу и подписке.
Лимит запросов на один аккаунт п...

  • GET /api/v1/seller/chats

    • Метод возвращает список всех чатов продавца. По этим данным можно получить события чатов или [отправить сооб...

  • GET /api/v1/seller/events

Чтобы получить все события:

  1. Сделайте первый ...
  • GET /api/v1/seller/download/{id}
    • Метод возвращает файл или изображение из сообщения по его ID.
Лимит запросов на один аккаунт продав...
  • GET /api/v1/claims

<...

  • PATCH /api/v1/claim
    • Метод отправляет ответ на заявку покупателя на возврат товаров.

TARIFFS​

  • GET /api/v1/tariffs/commission

    • Метод возвращает данные о комиссии WB по [родительским категориям товаров](/openapi/work-with-products#tag/Kategorii-predmety-i-h...

  • GET /api/v1/tariffs/box

    • Для товаров, которые поставляются на склад в коробах, метод возвращает тарифы на остаток:
    • доставка со склада или пункта приёма до покупа...

  • GET /api/v1/tariffs/pallet

    • Для товаров, которые поставляются на склад WB на монопаллетах, метод возвращает стоимость:
    • доставки со склада до покупателя
    • доставки...

  • GET /api/tariffs/v1/acceptance/coefficients

    • Метод возвращает тарифы на поставку для конкретных складов на ближайшие 14 дней.
Приёмка для поставки доступна только при сочетании: 
coefficient

    

  • GET /api/v1/tariffs/return

      

    • Метод возвращает тарифы:
      • 

    • на перевозку товаров со склада WB или из пункта приёма до продавца
      • 

    • на обратную перевозку возвра...
      • 

    

    • 



ANALYTICS​


    

  • POST /api/analytics/v3/sales-funnel/products

      

    • Метод формирует отчёт о товарах, сравнивая ключевые показатели — например, добавления в корзину, заказы и переходы в карточку товара — за текущий период с аналогичным прошлым.

      • 

    

    • 



Параметры `bran...


    

  • POST /api/analytics/v3/sales-funnel/products/history

      

    • Метод возвращает статистику карточек товаров по дням или неделям. Доступны данные по добавлениям в корзину, заказам, переходам в карточку товара и так далее.
      • 

    

    • 



Можно получить данные максимум за последн...


    

  • 

    POST /api/analytics/v3/sales-funnel/grouped/history
    

      

    • Метод возвращает статистику карточек товаров по дням или неделям. Карточки товаров сгруппированы по предметам, брендам и ярлыкам. Доступны данные по добавлениям в корзину, заказам, переходам в карточк...
      • 

    

    • 

  • 

    GET /api/v2/nm-report/downloads
    

      

    • Метод возвращает список отчётов с расширенной аналитикой продавца. Ответ содержит ID созданных отчётов и ста...
      • 

    

    • 

  • 

    POST /api/v2/nm-report/downloads
    

      

    • Метод создаёт задание на генерацию отчёта с расширенной аналитикой продавца.

      • 

    

    • 



Вы можете создать CSV-версии отчётов по воронке продаж или [параметрам п...


    

  • 

    POST /api/v2/nm-report/downloads/retry
    

      

    • Метод создает повторное задание на генерацию отчёта с расширенной аналитикой продавца. Необходимо, если при ...
      • 

    

    • 

  • 

    GET /api/v2/nm-report/downloads/file/{downloadId}
    


    • 

  • 

    POST /api/v2/search-report/report
    

      

    • Метод формирует набор данных для основной страницы отчёта по поисковым запросам с:
      • 

    

    • 

  • 

    общей информацией
    

    • 

  • 

    позициями товаров
    

    • 

  • 

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

    • 

  • 

    данными для таблицы по гр...
    

    • 

  • 

    POST /api/v2/search-report/table/groups
    

      

    • Метод формирует дополнительные данные к основному отчёту с пагинацией по группам. Пагинация во...
      • 

    

    • 

  • 

    POST /api/v2/search-report/table/details
    

      

    • Метод формирует дополнительные данные к основному отчёту с пагинацией по товарам в группе. Паг...
      • 

    

    • 

  • 

    POST /api/v2/search-report/product/search-texts
    

      

    • Метод формирует топ поисковых запросов по товару.
      • 

    

    • 



Параметры выбора поисковых запросов:


    

  • 

    limit — количество запросов, максимум 30 (для тарифа [Продвинутый](https://seller.wildberries.ru/monetizati...
    

    • 

  • 

    POST /api/v2/search-report/product/orders
    

      

    • Метод формирует данные для таблицы по количеству заказов и позиций в поиске по запросам покупателя. Данные указаны в рамках периода для [запрошенного товара](/openapi/analytics#tag/Poiskovye-zaprosy-p...
      • 

    

    • 

  • 

    POST /api/v2/stocks-report/products/groups
    

      

    • Метод формирует набор данных об остатках по группам товаров.


      
Группа товаров описывается кортежем subjectID, brandName, tagID.
      • 

    

    • 






    

  • 

    POST /api/v2/stocks-report/products/products
    

      

    • Метод формирует набор данных об остатках по товарам.


      
Можно получить данные как по отдельным товарам, так и в рамках всего отчёта — если в запросе отсутствуют фильтры: nmIDs, subjectID, `b...
      • 

    

    • 

  • 

    POST /api/v2/stocks-report/products/sizes
    

      

    • Метод формирует набор данных об остатках по размерам товара.


      
Возможны случаи:
      • 

    

    • 



    

  1. Товар имеет размеры и "includeOffice":true, тогда в ответе будут данные об остатках по каждому из размеров с...
    2. 



    

  • POST /api/v2/stocks-report/offices

      

    • Метод формирует набор данных об остатках по складам.


      
Данные по складам продавца приходят в агрегированном виде — по всем сразу, без детализации по конкретным складам — эти записи будут с `"re...
      • 

    

    • 



REPORTS​


    

  • GET /api/v1/supplier/stocks

      

    • Метод возвращает остатки товаров на складах WB.
      • 

    

    • 




  Данные этого отчёта могут обновляться с задержкой в несколько часов относительно реальных изменений



Не ре...


    

  • GET /api/v1/supplier/orders

      

    • Метод возвращает информацию о заказах.
      Данные обновляются раз в 30 минут.

      • 

    

    • 



1 строка = 1 заказ = 1 сборочное задание = 1 единица товара.
Для определения заказа рекомендуем использовать по...


    

  • GET /api/v1/supplier/sales

      

    • Метод возвращает информацию о продажах и возвратах.
      Данные обновляются раз в 30 минут.

      • 

    

    • 



1 строка = 1 заказ = 1 сборочное задание = 1 единица товара.
Для определения заказа рекомендуем ис...



Данный отчёт можно сохранить в [формате таблиц](htt...














    

  • GET /api/v1/analytics/antifraud-details

      

    • Метод возвращает отчёт об удержаниях за самовыкупы. Отчёт формируется каждую неделю по средам, до 7:00 по московскому времени, и содержит данные за одну неделю.

      • 

    

    • 



Удержание за самовыкуп — 30% о...


    

  • GET /api/v1/analytics/goods-labeling

      

    • Метод возвращает отчёт о штрафах за отсутствие обязательной маркировки товаров.
      • 

    

    • 



В отчёте представлены фотографии товаров, на которых маркировка отсутствует либо не считывается.



Можно пол...



Можно получить отчёт максимум за 31 день.




Можно получить только бренды, которые:


    

  • 

    Продавал...
    

    • 

  • 

    GET /api/v1/analytics/brand-share/parent-subjects
    


    • 



Можно получить отчёт максимум за 36...



Можно получить отчёт максимум за 365 дней. Данные доступны с 1 ноября...











Можно получить отчёт максимум за 31 день.



FINANCES​


    

  • GET /api/v1/account/balance


    • 






    

  • GET /api/v5/supplier/reportDetailByPeriod


    • 




  ...



    

  • 

    GET /api/v1/documents/list
    

      

    • Метод возвращает список документов продавца. Вы можете получить один или [несколько](/openapi/financ...
      • 

    

    • 

  • 

    GET /api/v1/documents/download
    


    • 










WBD​


    

  • POST /api/v1/keys-api/keys

      

    • Метод позволяет добавить ключи для предложения по ID.
      • 

    

    • 




  Предложение должно быть из категории (section):
  
    
      
  • Ключи активации — 
    3

      

    • DELETE /api/v1/keys-api/keys

        

      • Метод позволяет удалить ключи активации по их ID.
        • 

      

      • 

    

    
  Доступ к методу предоставляется через заявку в 

      

    • GET /api/v1/keys-api/keys/redeemed

        

      • Метод позволяет получить список купленных ключей с использованием фильтрации.

        • 

      

      • 

    

    Описание параметров фильтрации
    

      

    • 

      offer_id — Фильтрация по ID предложения. Позволяет выбрать ключи, связанн...
      

      • 

    • 

      GET /api/v1/offer/keys/{offer_id}
      

        

      • Метод позволяет получить информацию о количестве ключей у конкретного предложения.
        • 

      

      • 

    

    
  Максимум 100 запросов в секунду

    
 Получить количество ключей для предложения

      

    • GET /api/v1/offer/keys/{offer_id}/list

        

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

      

      • 

    

    
  Доступ к методу предоставляется через заявку в 

      

    • POST /api/v1/offers

        

      • Метод позволяет создать новое предложение.

        • 

      

      • 

    

    Обязательные поля
    

      

    • 

      title — Название предложения
      

      • 

    • 

      description — Описание предложения
      

      • 

    • 

      tags — Теги предложения
      

      • 

    • 

      section — Категория пр...
      

      • 

    • 

      POST /api/v1/offers/thumb
      

        

      • Метод позволяет добавить или обновить обложку предложения.
        
Для добавления более привлекательной карточки предложения, мы рекомендуем:
        • 

      

        

      1. Добавлять изображения с соотношением сторон 1:1.
        2. 

      2. Ми...
        3. 

      

      • 

    • 

      GET /api/v1/offers/{offer_id}
      

        

      • Метод позволяет получить информацию о конкретном предложении.
        • 

      

      • 

    

    
  Максимум 100 запросов в секунду

    
 Получить информацию о предложении

      

    • POST /api/v1/offers/{offer_id}

        

      • Метод позволяет редактировать информацию о предложении.

        • 

      

      • 

    

    Категория и подкатегория предложения

    

    Воспользуйтесь методом [Получить категории и их подкатегории](/openapi/wbd#tag/Predlo...
    

      

    • GET /api/v1/offers/author

        

      • Метод позволяет получить список своих предложений с использованием фильтрации.

        • 

      

      • 

    

    Описание параметров фильтрации
    

      

    • 

      search — Поиск предложений по названию. Укажите часть или полное названи...
      

      • 

    • 

      POST /api/v1/offer/price/{offer_id}
      

        

      • Метод позволяет изменить цену предложения и цену с учетом скидок.

        • 

      

      • 

    

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

      

    • POST /api/v1/offer/{offer_id}

        

      • Метод позволяет обновить статус вашего предложения.

        • 

      

      • 

    

    Возможные значения:
    

      

    • 0 — Черновик
      • 

    • 1 — Опубликован
      • 

    • 2 — Приостановлен
      • 

    • 3 — Удалён
      • 

    

    
  Максимум 5...

      

    • GET /api/v1/catalog

        

      • Метод позволяет получить дерево (структуру данных) с категориям и их подкатегориями.

        • 

      

      • 

    

    Иерархия структуры данных

    

    В нашей структуре есть три уровня иерархии:
    

      

    1. Корневой узел — ...
      2. 

    

      

    • POST /api/v1/content/illustration

        

      • Метод позволяет загрузить обложку контента.
        • 

      

      • 

    

    
  Максимальный размер файла: 5 Мб
    
  Допустимые форматы: PNG, JPEG
    
  Рекомендации:
  
      
      
    • Соотношение ...

        

      • POST /api/v1/content/upload/init

          

        • Метод позволяет инициализировать (загрузить) информацию нового контента.

          • 

        

        • 

      

      Типы контента и требования к ним вы можете посмотреть в оглавлении Работа с контентом.
      ...
      

        

      • POST /api/v1/content/upload/chunk

          

        • Метод позволяет загрузить контент (файл) по частям.

          • 

        

        • 

      

      Краткая инструкция по применению:
      

        

      1. Разбейте файл на части размером не более 2 Мб.
        2. 

      2. Для каждой части файла:
        3. 

      

        

      • 

        Убедитесь, что заголовок...
        

        • 

      • 

        GET /api/v1/content/author/{content_id}
        

          

        • Метод позволяет получить информацию о конкретном контенте.
          • 

        

        • 

      

      
  Максимум 50 запросов в секунду

      
 Получить информацию о контенте

        

      • POST /api/v1/content/author/{content_id}

          

        • Метод позволяет редактировать информацию о контенте.
          • 

        

        • 

      

      
  Максимум 50 запросов в секунду

      
 Редактировать контент

        

      • GET /api/v1/content/author

          

        • Метод позволяет получить список своего контента с использованием фильтрации.

          • 

        

        • 

      

      Описание параметров фильтрации
      

        

      • 

        search — Поиск контента по названию. Укажите часть или полное название кон...
        

        • 

      • 

        GET /api/v1/content/download/{uri}
        

          

        • Метод позволяет скачать контент по URI.

          • 

        

        • 

      

      Получение URI-адреса контента
      

        

      1. Воспользуйтесь одним из методов для получения информации о контенте.

          

        • [Получить информацию о контенте](/opena...
          • 

        

        2. 

      

        

      • POST /api/v1/content/delete

          

        • Метод позволяет удалить контент по ID.
          • 

        

        • 

      

      
  Максимум 50 запросов в секунду

      
 Удалить контент

        

      • POST /api/v1/content/gallery

          

        • Метод позволяет загружать медиафайлы на сервер.

          • 

        

        • 

      

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

      API Sections Overview​
      

















































































      СекцияEndpointsОписание
      general7Общая информация и базовые операции
      content49Управление товарами и контентом
      orders-fbs34Заказы FBS (Fulfillment by Seller)
      orders-dbw15Заказы DBW (Delivery by Wildberries)
      orders-dbs31Заказы DBS (Delivery by Seller)
      in-store-pickup16Самовывоз из магазинов
      orders-fbw8Заказы FBW (Fulfillment by Wildberries)
      promotion34Продвижение и реклама
      communications25Коммуникации с покупателями
      tariffs5Тарифы и комиссии
      analytics16Аналитика и статистика
      reports26Отчеты и выгрузки
      finances6Финансы и платежи
      wbd22WBD (Wildberries Delivery) операции
      

      Detailed Endpoints​
      

      GENERAL API (7 endpoints)​
      














































      MethodPathDescription
      GET/pingПроверка подключения
      GET/api/communications/v2/newsПолучение новостей портала продавцов
      GET/api/v1/seller-infoПолучение информации о продавце
      POST/api/v1/inviteСоздать приглашение для нового пользователя
      GET/api/v1/usersПолучить список активных или приглашённых пользователей продавца
      PUT/api/v1/users/accessИзменить права доступа пользователей
      DELETE/api/v1/userУдалить пользователя
      

      CONTENT API (49 endpoints)​
      
































































































































































































































































      MethodPathDescription
      GET/content/v2/object/parent/allРодительские категории товаров
      GET/content/v2/object/allСписок предметов
      GET/content/v2/object/charcs/{subjectId}Характеристики предмета
      GET/content/v2/directory/colorsЦвет
      GET/content/v2/directory/kindsПол
      GET/content/v2/directory/countriesСтрана производства
      GET/content/v2/directory/seasonsСезон
      GET/content/v2/directory/vatСтавка НДС
      GET/content/v2/directory/tnvedТНВЭД-код
      GET/api/content/v1/brandsБренды
      GET/content/v2/tagsСписок ярлыков
      POST/content/v2/tagСоздание ярлыка
      DELETE/content/v2/tag/{id}Удаление ярлыка
      PATCH/content/v2/tag/{id}Изменение ярлыка
      POST/content/v2/tag/nomenclature/linkУправление ярлыками в карточке товара
      POST/content/v2/get/cards/listСписок карточек товаров
      POST/content/v2/cards/error/listСписок несозданных карточек товаров с ошибками
      POST/content/v2/cards/updateРедактирование карточек товаров
      POST/content/v2/cards/moveNmОбъединение и разъединение карточек товаров
      POST/content/v2/cards/delete/trashПеренос карточек товаров в корзину
      POST/content/v2/cards/recoverВосстановление карточек товаров из корзины
      POST/content/v2/get/cards/trashСписок карточек товаров в корзине
      GET/content/v2/cards/limitsЛимиты карточек товаров
      POST/content/v2/barcodesГенерация баркодов
      POST/content/v2/cards/uploadСоздание карточек товаров
      POST/content/v2/cards/upload/addСоздание карточек товаров с присоединением
      POST/content/v3/media/fileЗагрузить медиафайл
      POST/content/v3/media/saveЗагрузить медиафайлы по ссылкам
      POST/api/v2/upload/taskУстановить цены и скидки
      POST/api/v2/upload/task/sizeУстановить цены для размеров
      POST/api/v2/upload/task/club-discountУстановить скидки WB Клуба
      GET/api/v2/history/tasksСостояние обработанной загрузки
      GET/api/v2/history/goods/taskДетализация обработанной загрузки
      GET/api/v2/buffer/tasksСостояние необработанной загрузки
      GET/api/v2/buffer/goods/taskДетализация необработанной загрузки
      GET/api/v2/list/goods/filterПолучить товары с ценами
      POST/api/v2/list/goods/filterПолучить товары с ценами по артикулам
      GET/api/v2/list/goods/size/nmПолучить размеры товара с ценами
      GET/api/v2/quarantine/goodsПолучить товары в карантине
      POST/api/v3/stocks/{warehouseId}Получить остатки товаров
      PUT/api/v3/stocks/{warehouseId}Обновить остатки товаров
      DELETE/api/v3/stocks/{warehouseId}Удалить остатки товаров
      GET/api/v3/officesПолучить список складов WB
      GET/api/v3/warehousesПолучить список складов продавца
      POST/api/v3/warehousesСоздать склад продавца
      PUT/api/v3/warehouses/{warehouseId}Обновить склад продавца
      DELETE/api/v3/warehouses/{warehouseId}Удалить склад продавца
      GET/api/v3/dbw/warehouses/{warehouseId}/contactsСписок контактов
      PUT/api/v3/dbw/warehouses/{warehouseId}/contactsОбновить список контактов
      

      ORDERS-FBS API (34 endpoints)​
      





















































































































































































      MethodPathDescription
      GET/api/v3/passes/officesПолучить список складов, для которых требуется пропуск
      GET/api/v3/passesПолучить список пропусков
      POST/api/v3/passesСоздать пропуск
      PUT/api/v3/passes/{passId}Обновить пропуск
      DELETE/api/v3/passes/{passId}Удалить пропуск
      GET/api/v3/orders/newПолучить список новых сборочных заданий
      GET/api/v3/ordersПолучить информацию о сборочных заданиях
      POST/api/v3/orders/statusПолучить статусы сборочных заданий
      GET/api/v3/supplies/orders/reshipmentПолучить все сборочные задания для повторной отгрузки
      PATCH/api/v3/orders/{orderId}/cancelОтменить сборочное задание
      POST/api/v3/orders/stickersПолучить стикеры сборочных заданий
      POST/api/marketplace/v3/orders/metaПолучить метаданные сборочных заданий
      DELETE/api/v3/orders/{orderId}/metaУдалить метаданные сборочного задания
      PUT/api/v3/orders/{orderId}/meta/sgtinЗакрепить за сборочным заданием код маркировки товара
      PUT/api/v3/orders/{orderId}/meta/uinЗакрепить за сборочным заданием УИН
      PUT/api/v3/orders/{orderId}/meta/imeiЗакрепить за сборочным заданием IMEI
      PUT/api/v3/orders/{orderId}/meta/gtinЗакрепить за сборочным заданием GTIN
      PUT/api/v3/orders/{orderId}/meta/expirationЗакрепить за сборочным заданием срок годности товара
      PUT/api/marketplace/v3/orders/{orderId}/meta/customs-declarationЗакрепить за сборочным заданием номер ГТД
      POST/api/v3/orders/stickers/cross-borderПолучить стикеры сборочных заданий кроссбордера
      POST/api/v3/orders/status/historyИстория статусов для сборочных заданий кроссбордера
      POST/api/v3/orders/clientЗаказы с информацией по клиенту
      GET/api/v3/suppliesПолучить список поставок
      POST/api/v3/suppliesСоздать новую поставку
      PATCH/api/marketplace/v3/supplies/{supplyId}/ordersДобавить сборочные задания к поставке
      GET/api/v3/supplies/{supplyId}Получить информацию о поставке
      DELETE/api/v3/supplies/{supplyId}Удалить поставку
      GET/api/marketplace/v3/supplies/{supplyId}/order-idsПолучить ID сборочных заданий поставки
      PATCH/api/v3/supplies/{supplyId}/deliverПередать поставку в доставку
      GET/api/v3/supplies/{supplyId}/barcodeПолучить QR-код поставки
      GET/api/v3/supplies/{supplyId}/trbxПолучить список коробов поставки
      POST/api/v3/supplies/{supplyId}/trbxДобавить короба к поставке
      DELETE/api/v3/supplies/{supplyId}/trbxУдалить короба из поставки
      POST/api/v3/supplies/{supplyId}/trbx/stickersПолучить стикеры коробов поставки
      

      ORDERS-DBW API (15 endpoints)​
      






















































































      MethodPathDescription
      GET/api/v3/dbw/orders/newПолучить список новых сборочных заданий
      GET/api/v3/dbw/ordersПолучить информацию о завершенных сборочных заданиях
      POST/api/v3/dbw/orders/delivery-dateДата и время доставки
      POST/api/v3/dbw/orders/statusПолучить статусы сборочных заданий
      PATCH/api/v3/dbw/orders/{orderId}/confirmПеревести на сборку
      POST/api/v3/dbw/orders/stickersПолучить стикеры сборочных заданий
      PATCH/api/v3/dbw/orders/{orderId}/assembleПеревести в доставку
      POST/api/v3/dbw/orders/courierИнформация о курьере
      PATCH/api/v3/dbw/orders/{orderId}/cancelОтменить сборочное задание
      GET/api/v3/dbw/orders/{orderId}/metaПолучить метаданные сборочного задания
      DELETE/api/v3/dbw/orders/{orderId}/metaУдалить метаданные сборочного задания
      PUT/api/v3/dbw/orders/{orderId}/meta/sgtinЗакрепить за сборочным заданием код маркировки товара
      PUT/api/v3/dbw/orders/{orderId}/meta/uinЗакрепить за сборочным заданием УИН (уникальный идентификационный номер)
      PUT/api/v3/dbw/orders/{orderId}/meta/imeiЗакрепить за сборочным заданием IMEI
      PUT/api/v3/dbw/orders/{orderId}/meta/gtinЗакрепить за сборочным заданием GTIN
      

      ORDERS-DBS API (31 endpoints)​
      






































































































































































      MethodPathDescription
      GET/api/v3/dbs/orders/newПолучить список новых сборочных заданий
      GET/api/v3/dbs/ordersПолучить информацию о завершенных сборочных заданиях
      POST/api/v3/dbs/groups/infoПолучить информацию о платной доставке
      POST/api/v3/dbs/orders/clientИнформация о покупателе
      POST/api/marketplace/v3/dbs/orders/b2b/infoИнформация о покупателе B2B
      POST/api/v3/dbs/orders/delivery-dateДата и время доставки
      POST/api/marketplace/v3/dbs/orders/status/infoПолучить статусы сборочных заданий
      POST/api/marketplace/v3/dbs/orders/status/cancelОтменить сборочные задания
      POST/api/marketplace/v3/dbs/orders/status/confirmПеревести сборочные задания на сборку
      POST/api/marketplace/v3/dbs/orders/status/deliverПеревести сборочные задания в доставку
      POST/api/marketplace/v3/dbs/orders/status/receiveСообщить о получении заказов
      POST/api/marketplace/v3/dbs/orders/status/rejectСообщить об отказе от заказов
      POST/api/v3/dbs/orders/statusПолучить статусы сборочных заданий
      PATCH/api/v3/dbs/orders/{orderId}/cancelОтменить сборочное задание
      PATCH/api/v3/dbs/orders/{orderId}/confirmПеревести на сборку
      PATCH/api/v3/dbs/orders/{orderId}/deliverПеревести в доставку
      PATCH/api/v3/dbs/orders/{orderId}/receiveСообщить, что заказ принят покупателем
      PATCH/api/v3/dbs/orders/{orderId}/rejectСообщить, что покупатель отказался от заказа
      POST/api/marketplace/v3/dbs/orders/meta/infoПолучить метаданные сборочных заданий
      POST/api/marketplace/v3/dbs/orders/meta/deleteУдалить метаданные сборочных заданий
      POST/api/marketplace/v3/dbs/orders/meta/sgtinЗакрепить коды маркировки за сборочными заданиями
      POST/api/marketplace/v3/dbs/orders/meta/uinЗакрепить УИН за сборочными заданиями
      POST/api/marketplace/v3/dbs/orders/meta/imeiЗакрепить IMEI за сборочными заданиями
      POST/api/marketplace/v3/dbs/orders/meta/gtinЗакрепить GTIN за сборочными заданиями
      POST/api/marketplace/v3/dbs/orders/meta/customs-declarationЗакрепить за сборочными заданиями номер ГТД
      GET/api/v3/dbs/orders/{orderId}/metaПолучить метаданные сборочного задания
      DELETE/api/v3/dbs/orders/{orderId}/metaУдалить метаданные сборочного задания
      PUT/api/v3/dbs/orders/{orderId}/meta/sgtinЗакрепить за сборочным заданием код маркировки товара
      PUT/api/v3/dbs/orders/{orderId}/meta/uinЗакрепить за сборочным заданием УИН (уникальный идентификационный номер)
      PUT/api/v3/dbs/orders/{orderId}/meta/imeiЗакрепить за сборочным заданием IMEI
      PUT/api/v3/dbs/orders/{orderId}/meta/gtinЗакрепить за сборочным заданием GTIN
      

      IN-STORE-PICKUP API (16 endpoints)​
      



























































































      MethodPathDescription
      GET/api/v3/click-collect/orders/newПолучить список новых сборочных заданий
      PATCH/api/v3/click-collect/orders/{orderId}/confirmПеревести на сборку
      PATCH/api/v3/click-collect/orders/{orderId}/prepareСообщить, что сборочное задание готово к выдаче
      POST/api/v3/click-collect/orders/clientИнформация о покупателе
      POST/api/v3/click-collect/orders/client/identityПроверить, что заказ принадлежит покупателю
      PATCH/api/v3/click-collect/orders/{orderId}/receiveСообщить, что заказ принят покупателем
      PATCH/api/v3/click-collect/orders/{orderId}/rejectСообщить, что покупатель отказался от заказа
      POST/api/v3/click-collect/orders/statusПолучить статусы сборочных заданий
      GET/api/v3/click-collect/ordersПолучить информацию о завершённых сборочных заданиях
      PATCH/api/v3/click-collect/orders/{orderId}/cancelОтменить сборочное задание
      GET/api/v3/click-collect/orders/{orderId}/metaПолучить метаданные сборочного задания
      DELETE/api/v3/click-collect/orders/{orderId}/metaУдалить метаданные сборочного задания
      PUT/api/v3/click-collect/orders/{orderId}/meta/sgtinЗакрепить за сборочным заданием код маркировки товара
      PUT/api/v3/click-collect/orders/{orderId}/meta/uinЗакрепить за сборочным заданием УИН (уникальный идентификационный номер)
      PUT/api/v3/click-collect/orders/{orderId}/meta/imeiЗакрепить за сборочным заданием IMEI
      PUT/api/v3/click-collect/orders/{orderId}/meta/gtinЗакрепить за сборочным заданием GTIN
      

      ORDERS-FBW API (8 endpoints)​
      



















































      MethodPathDescription
      GET/api/v1/acceptance/coefficientsКоэффициенты приёмки
      POST/api/v1/acceptance/optionsОпции приёмки
      GET/api/v1/warehousesСписок складов
      GET/api/v1/transit-tariffsТранзитные направления
      POST/api/v1/suppliesСписок поставок
      GET/api/v1/supplies/{ID}Детали поставки
      GET/api/v1/supplies/{ID}/goodsТовары поставки
      GET/api/v1/supplies/{ID}/packageУпаковка поставки
      

      PROMOTION API (34 endpoints)​
      





















































































































































































      MethodPathDescription
      GET/adv/v1/promotion/countСписки кампаний
      GET/api/advert/v2/advertsИнформация о кампаниях
      POST/api/advert/v1/bids/minМинимальные ставки для карточек товаров
      POST/adv/v2/seacat/save-adСоздать кампанию
      GET/adv/v1/supplier/subjectsПредметы для кампаний
      POST/adv/v2/supplier/nmsКарточки товаров для кампаний
      GET/adv/v0/deleteУдаление кампании
      POST/adv/v0/renameПереименование кампании
      GET/adv/v0/startЗапуск кампании
      GET/adv/v0/pauseПауза кампании
      GET/adv/v0/stopЗавершение кампании
      PUT/adv/v0/auction/placementsИзменение мест размещения в кампаниях с ручной ставкой
      PATCH/api/advert/v1/bidsИзменение ставок в кампаниях
      GET/adv/v1/balanceБаланс
      GET/adv/v1/budgetБюджет кампании
      POST/adv/v1/budget/depositПополнение бюджета кампании
      GET/adv/v1/updПолучение истории затрат
      GET/adv/v1/paymentsПолучение истории пополнений счёта
      PATCH/adv/v0/auction/nmsИзменение списка карточек товаров в кампаниях
      POST/adv/v0/normquery/statsСтатистика поисковых кластеров
      POST/adv/v0/normquery/get-bidsСписок ставок поисковых кластеров
      POST/adv/v0/normquery/bidsУстановить ставки для поисковых кластеров
      DELETE/adv/v0/normquery/bidsУдалить ставки поисковых кластеров
      POST/adv/v0/normquery/get-minusСписок минус-фраз кампаний
      POST/adv/v0/normquery/set-minusУстановка и удаление минус-фраз
      GET/adv/v1/countКоличество медиакампаний
      GET/adv/v1/advertsСписок медиакампаний
      GET/adv/v1/advertИнформация о медиакампании
      GET/adv/v3/fullstatsСтатистика кампаний
      POST/adv/v1/statsСтатистика медиакампаний
      GET/api/v1/calendar/promotionsСписок акций
      GET/api/v1/calendar/promotions/detailsДетальная информация об акциях
      GET/api/v1/calendar/promotions/nomenclaturesСписок товаров для участия в акции
      POST/api/v1/calendar/promotions/uploadДобавить товар в акцию
      

      COMMUNICATIONS API (25 endpoints)​
      








































































































































      MethodPathDescription
      GET/api/v1/new-feedbacks-questionsНепросмотренные отзывы и вопросы
      GET/api/v1/questions/count-unansweredНеотвеченные вопросы
      GET/api/v1/questions/countКоличество вопросов
      GET/api/v1/questionsСписок вопросов
      PATCH/api/v1/questionsРабота с вопросами
      GET/api/v1/questionПолучить вопрос по ID
      GET/api/v1/feedbacks/count-unansweredНеобработанные отзывы
      GET/api/v1/feedbacks/countКоличество отзывов
      GET/api/v1/feedbacksСписок отзывов
      POST/api/v1/feedbacks/answerОтветить на отзыв
      PATCH/api/v1/feedbacks/answerОтредактировать ответ на отзыв
      POST/api/v1/feedbacks/order/returnВозврат товара по ID отзыва
      GET/api/v1/feedbackПолучить отзыв по ID
      GET/api/v1/feedbacks/archiveСписок архивных отзывов
      GET/api/feedbacks/v1/pinsСписок закреплённых и откреплённых отзывов
      POST/api/feedbacks/v1/pinsЗакрепить отзывы
      DELETE/api/feedbacks/v1/pinsОткрепить отзывы
      GET/api/feedbacks/v1/pins/countКоличество закреплённых и откреплённых отзывов
      GET/api/feedbacks/v1/pins/limitsЛимиты закреплённых отзывов
      GET/api/v1/seller/chatsСписок чатов
      GET/api/v1/seller/eventsСобытия чатов
      POST/api/v1/seller/messageОтправить сообщение
      GET/api/v1/seller/download/{id}Получить файл из сообщения
      GET/api/v1/claimsЗаявки покупателей на возврат
      PATCH/api/v1/claimОтвет на заявку покупателя
      

      TARIFFS API (5 endpoints)​
      




































      MethodPathDescription
      GET/api/v1/tariffs/commissionКомиссия по категориям товаров
      GET/api/v1/tariffs/boxТарифы для коробов
      GET/api/v1/tariffs/palletТарифы для монопаллет
      GET/api/tariffs/v1/acceptance/coefficientsТарифы на поставку
      GET/api/v1/tariffs/returnТарифы на возврат
      

      ANALYTICS API (16 endpoints)​
      



























































































      MethodPathDescription
      POST/api/analytics/v3/sales-funnel/productsСтатистика карточек товаров за период
      POST/api/analytics/v3/sales-funnel/products/historyСтатистика карточек товаров по дням
      POST/api/analytics/v3/sales-funnel/grouped/historyСтатистика групп карточек товаров по дням
      GET/api/v2/nm-report/downloadsПолучить список отчётов
      POST/api/v2/nm-report/downloadsСоздать отчёт
      POST/api/v2/nm-report/downloads/retryСгенерировать отчёт повторно
      GET/api/v2/nm-report/downloads/file/{downloadId}Получить отчёт
      POST/api/v2/search-report/reportОсновная страница
      POST/api/v2/search-report/table/groupsПагинация по группам
      POST/api/v2/search-report/table/detailsПагинация по товарам в группе
      POST/api/v2/search-report/product/search-textsПоисковые запросы по товару
      POST/api/v2/search-report/product/ordersЗаказы и позиции по поисковым запросам товара
      POST/api/v2/stocks-report/products/groupsДанные по группам
      POST/api/v2/stocks-report/products/productsДанные по товарам
      POST/api/v2/stocks-report/products/sizesДанные по размерам
      POST/api/v2/stocks-report/officesДанные по складам
      

      REPORTS API (26 endpoints)​
      













































































































































      MethodPathDescription
      GET/api/v1/supplier/incomesПоставки
      GET/api/v1/supplier/stocksСклады
      GET/api/v1/supplier/ordersЗаказы
      GET/api/v1/supplier/salesПродажи
      POST/api/v1/analytics/excise-reportПолучить отчёт
      GET/api/v1/warehouse_remainsСоздать отчёт
      GET/api/v1/warehouse_remains/tasks/{task_id}/statusПроверить статус
      GET/api/v1/warehouse_remains/tasks/{task_id}/downloadПолучить отчёт
      GET/api/analytics/v1/measurement-penaltiesУдержания за занижение габаритов упаковки
      GET/api/analytics/v1/warehouse-measurementsЗамеры склада
      GET/api/analytics/v1/deductionsПодмены и неверные вложения
      GET/api/v1/analytics/antifraud-detailsСамовыкупы
      GET/api/v1/analytics/goods-labelingМаркировка товара
      GET/api/v1/acceptance_reportСоздать отчёт
      GET/api/v1/acceptance_report/tasks/{task_id}/statusПроверить статус
      GET/api/v1/acceptance_report/tasks/{task_id}/downloadПолучить отчёт
      GET/api/v1/paid_storageСоздать отчёт
      GET/api/v1/paid_storage/tasks/{task_id}/statusПроверить статус
      GET/api/v1/paid_storage/tasks/{task_id}/downloadПолучить отчёт
      GET/api/v1/analytics/region-saleПолучить отчёт
      GET/api/v1/analytics/brand-share/brandsБренды продавца
      GET/api/v1/analytics/brand-share/parent-subjectsРодительские категории бренда
      GET/api/v1/analytics/brand-shareПолучить отчёт
      GET/api/v1/analytics/banned-products/blockedЗаблокированные карточки
      GET/api/v1/analytics/banned-products/shadowedСкрытые из каталога
      GET/api/v1/analytics/goods-returnПолучить отчёт
      

      FINANCES API (6 endpoints)​
      









































      MethodPathDescription
      GET/api/v1/account/balanceПолучить баланс продавца
      GET/api/v5/supplier/reportDetailByPeriodОтчёт о продажах по реализации
      GET/api/v1/documents/categoriesКатегории документов
      GET/api/v1/documents/listСписок документов
      GET/api/v1/documents/downloadПолучить документ
      POST/api/v1/documents/download/allПолучить документы
      

      WBD API (22 endpoints)​
      

























































































































      MethodPathDescription
      POST/api/v1/keys-api/keysДобавить ключи активации
      DELETE/api/v1/keys-api/keysУдалить ключи активации
      GET/api/v1/keys-api/keys/redeemedПолучить купленные ключи
      GET/api/v1/offer/keys/{offer_id}Получить количество ключей для предложения
      GET/api/v1/offer/keys/{offer_id}/listПолучить список ключей
      POST/api/v1/offersСоздать новое предложение
      POST/api/v1/offers/thumbДобавить или обновить обложку предложения
      GET/api/v1/offers/{offer_id}Получить информацию о предложении
      POST/api/v1/offers/{offer_id}Редактировать предложение
      GET/api/v1/offers/authorПолучить список своих предложений
      POST/api/v1/offer/price/{offer_id}Обновить цену
      POST/api/v1/offer/{offer_id}Обновить статус
      GET/api/v1/catalogПолучить категории и их подкатегории
      POST/api/v1/content/illustrationЗагрузить обложку контента
      POST/api/v1/content/upload/initИнициализировать новый контент
      POST/api/v1/content/upload/chunkЗагрузить контент (файл)
      GET/api/v1/content/author/{content_id}Получить информацию о контенте
      POST/api/v1/content/author/{content_id}Редактировать контент
      GET/api/v1/content/authorПолучить список своего контента
      GET/api/v1/content/download/{uri}Скачать контент
      POST/api/v1/content/deleteУдалить контент
      POST/api/v1/content/galleryЗагрузить медиафайлы для предложения
      

      Error Codes​
      

      Коды ошибок, возвращаемые API:
      


































      КодОписание
      400Bad Request — Неверный запрос
      401Unauthorized — Не авторизован
      403Forbidden — Доступ запрещен
      404Not Found — Не найдено
      429Too Many Requests — Слишком много запросов
      500Internal Server Error — Внутренняя ошибка сервера
      

      Downloaded Files​
      

      Скачанные файлы спецификаций:
      

        

      • general: 01-general.yaml (47.5 KB)
        • 

      • content: 02-products.yaml (318.5 KB)
        • 

      • orders-fbs: 03-orders-fbs.yaml (152.7 KB)
        • 

      • orders-dbw: 04-orders-dbw.yaml (76.9 KB)
        • 

      • orders-dbs: 05-orders-dbs.yaml (121.0 KB)
        • 

      • in-store-pickup: 06-in-store-pickup.yaml (65.3 KB)
        • 

      • orders-fbw: 07-orders-fbw.yaml (50.8 KB)
        • 

      • promotion: 08-promotion.yaml (201.9 KB)
        • 

      • communications: 09-communications.yaml (168.4 KB)
        • 

      • tariffs: 10-tariffs.yaml (40.0 KB)
        • 

      • analytics: 11-analytics.yaml (220.0 KB)
        • 

      • reports: 12-reports.yaml (152.9 KB)
        • 

      • finances: 13-finances.yaml (44.6 KB)
        • 

      • wbd: 14-wbd.yaml (127.3 KB)
        • 

      

      

      Документация сгенерирована на основе OpenAPI спецификаций с https://dev.wildberries.ru/api/swagger/yaml/ru