Поиск
API docs by Redocly

Заказы FBS (order)

С помощью методов раздела Заказы FBS (Fulfillment by Seller) вы можете:

Вы можете протестировать методы заказов FBS в песочнице. Также в песочнице доступны специальные методы для эмуляции действий пользователя

Узнать больше о заказах FBS можно в справочном центре

Заказы FBS

С помощью методов раздела Заказы FBS (Fulfillment by Seller) вы можете:

Вы можете протестировать методы заказов FBS в песочнице. Также в песочнице доступны специальные методы для эмуляции действий пользователя

Узнать больше о заказах FBS можно в справочном центре

Сборочные задания FBS

Для доступа к методам используйте токен для категории Маркетплейс
Узнать больше о сборочных заданиях можно в справочном центре

Когда покупатель заказывает товар, у продавца появляется сборочное задание. Сборочное задание всегда содержит 1 единицу товара. Если покупатель закажет 10 единиц одного товара одной корзиной, у продавца появятся 10 сборочных заданий. Их можно сгруппировать по одинаковому orderUid.

Для работы со сборочными заданиями FBS:

  1. Получите новые сборочные задания.
  2. Создайте поставку и добавьте в неё сборочные задания.
  3. Получите стикеры сборочных заданий, распечатайте их и промаркируйте сборочные задания.
  4. Если нужно, добавьте к сборочным заданиям код маркировки Честного знака, УИН, IMEI, GTIN, срок годности товара или номер ДТ.
  5. Если поставка доставляется в пункт выдачи заказов (ПВЗ), переходите к пункту 3 инструкции. Если на склад WB, к пункту 6.
  6. Уточните, требуется ли пропуск на склад, на который поедет поставка. Если нужен, создайте пропуск.

Получить список новых сборочных заданий{{ /api/v3/orders/new }}

Описание метода

Метод возвращает список всех новых сборочных заданий, которые есть у продавца на момент запроса.

Наличие в сборочных заданиях идентификаторов маркировки, указанных в полях requiredMeta и optionalMeta, влияет только на возможность перевести поставку в доставку. Если ваш товар подлежит обязательной маркировке средствами идентификации, необходимо указывать идентификаторы маркировки независимо от того, в каком поле они были получены (п. 4.6 Оферты).
Рекомендуем добавлять в сборочные задания все идентификаторы маркировки, полученные в полях requiredMeta и optionalMeta
Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
Период Лимит Интервал Всплеск
1 мин 300 запросов 200 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey

Responses

Response samples

Content type
application/json
{
  • "orders": [
    ]
}

Получить информацию о сборочных заданиях{{ /api/v3/orders }}

Описание метода

Метод возвращает информацию о сборочных заданиях, созданных не более 3 месяцев назад, без их актуального статуса.

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

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

Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
Период Лимит Интервал Всплеск
1 мин 300 запросов 200 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey
query Parameters
limit
required
integer [ 1 .. 1000 ]

Параметр пагинации. Устанавливает предельное количество возвращаемых данных.

next
required
integer <int64>

Параметр пагинации. Устанавливает значение, с которого надо получить следующий пакет данных. Для получения полного списка данных должен быть равен 0 в первом запросе. Для следующих запросов необходимо брать значения из одноимённого поля в ответе.

dateFrom
integer

Дата начала периода в формате Unix timestamp. По умолчанию — дата за 30 дней до запроса. Часовой пояс — UTC

dateTo
integer

Дата конца периода в формате Unix timestamp. Часовой пояс — UTC

Responses

Response samples

Content type
application/json
{
  • "next": 13833711,
  • "orders": [
    ]
}

Получить статусы сборочных заданий{{ /api/v3/orders/status }}

Описание метода

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

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

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

Статус Описание Как перевести сборочное задание в данный статус
new Новое сборочное задание
confirm На сборке Добавить сборочное задание к поставке
Перевести сборочные задания из доставки на сборку
complete В доставке Передать поставку в доставку
cancel Отменено продавцом Отменить сборочное задание
cancel_carrier Отменено перевозчиком
Только для трансграничных поставок		 Переводится перевозчиком



wbStatus — статус системы Wildberries.

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

  • waiting — сборочное задание в работе
  • sorted — сборочное задание отсортировано
  • sold — заказ получен покупателем
  • canceled — отмена сборочного задания
  • canceled_by_client — покупатель отменил заказ при получении
  • declined_by_client — покупатель отменил заказ. Отмена доступна покупателю в первый час с момента заказа, если заказ не переведён на сборку
  • defect — отмена заказа по причине брака
  • ready_for_pickup — заказ прибыл на пункт выдачи заказов (ПВЗ)
  • accepted_by_carrier — продавец передал заказ в службу доставки в своей стране
  • sent_to_carrier — заказ отправлен на склад службы доставки в стране продавца
  • canceled_by_carrier — заказ отменён перевозчиком. Только для трансграничных поставок
Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
Период Лимит Интервал Всплеск
1 мин 300 запросов 200 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey
Request Body schema: application/json
orders
required
Array of integers <int64> [ 1 .. 1000 ] items [ items <int64 > ]

Список ID сборочных заданий

Responses

Request samples

Content type
application/json
{
  • "orders": [
    ]
}

Response samples

Content type
application/json
{
  • "orders": [
    ]
}

Получить все сборочные задания для повторной отгрузки{{ /api/v3/supplies/orders/reshipment }}

Описание метода

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

Повторная отгрузка требуется, если поставка была отсканирована в пункте приёмки, но при этом в ней всё ещё есть неотсканированные товары. Спустя определённое время необходимо доставить эти товары заново. Данные сборочные задания можно перевести в другую активную поставку.

Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
Период Лимит Интервал Всплеск
1 мин 300 запросов 200 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey

Responses

Response samples

Content type
application/json
{
  • "orders": [
    ]
}

Отменить сборочное задание{{ /api/v3/orders/{orderId}/cancel }}

Описание метода

Метод отменяет сборочное задание и переводит в статус cancel — отменено продавцом.

Сборочное задание можно отменить до его передачи Wildberries. Чтобы проверить, можно ли отменить сборочное задание, используйте метод POST /api/v3/orders/status, поле isCancellable.
Лимит запросов на один профиль продавца:
Период Лимит Интервал Всплеск
1 мин 100 запросов 600 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64>
Example: 5632423

ID сборочного задания

Responses

Response samples

Content type
application/json
{
  • "code": "IncorrectParameter",
  • "message": "Передан некорректный параметр"
}

Получить стикеры сборочных заданий{{ /api/v3/orders/stickers }}

Описание метода

Метод возвращает список стикеров для сборочных заданий в статусах confirm — на сборке и complete — в доставке.

Если за сборочным заданием не закреплён обязательный номер декларации на товары (ДТ), получить стикеры для этого сборочного задания невозможно.

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

  • SVG
  • ZPLV (вертикальный)
  • ZPLH (горизонтальный)
  • PNG

Доступны размеры:

  • 580x400 px при width=58&height=40 в запросе
  • 400x300 px при width=40&height=30 в запросе
Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
Период Лимит Интервал Всплеск
1 мин 300 запросов 200 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey
query Parameters
type
required
string
Enum: svg zplv zplh png

Тип стикера

width
required
integer
Enum: 58 40

Ширина стикера

height
required
integer
Enum: 40 30

Высота стикера

Request Body schema: application/json
orders
Array of integers <int64> [ 1 .. 100 ] items [ items <int64 > ]

Список ID сборочных заданий

Responses

Request samples

Content type
application/json
{
  • "orders": [
    ]
}

Response samples

Content type
application/json
{
  • "stickers": [
    ]
}

Получить стикеры сборочных заданий трансграничных поставок{{ /api/v3/orders/stickers/cross-border }}

Описание метода

Метод возвращает список стикеров сборочных заданий трансграничных поставок в формате PDF.

Для каждого сборочного задания в ответе указывается статус генерации стикера:

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

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

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

В песочнице этот метод всегда возвращает ответ 200.

Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
Период Лимит Интервал Всплеск
1 мин 300 запросов 200 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов

Authorizations:
HeaderApiKey
Request Body schema: application/json
orders
Array of integers <int64> [ 1 .. 100 ] items [ items <int64 > ]

Список ID сборочных заданий

Responses

Request samples

Content type
application/json
{
  • "orders": [
    ]
}

Response samples

Content type
application/json
{
  • "stickers": [
    ]
}

История статусов для сборочных заданий трансграничных поставок{{ /api/v3/orders/status/history }}

Описание метода

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

В песочнице этот метод всегда возвращает ответ 200.

Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
Период Лимит Интервал Всплеск
1 мин 300 запросов 200 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey
Request Body schema: application/json
orders
Array of integers [ 1 .. 100 ] items

ID сборочных заданий

Responses

Request samples

Content type
application/json
{
  • "orders": [
    ]
}

Response samples

Content type
application/json
{
  • "orders": [
    ]
}

Заказы с информацией по клиенту{{ /api/v3/orders/client }}

Описание метода

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

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

Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
Период Лимит Интервал Всплеск
1 мин 300 запросов 200 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey
Request Body schema: application/json
required
orders
Array of integers

Список заказов

Responses

Request samples

Content type
application/json
{
  • "orders": [
    ]
}

Response samples

Content type
application/json
{
  • "orders": [
    ]
}

Получить список архивных сборочных заданий{{ /api/marketplace/v3/fbs/orders/archive }}

Описание метода

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

Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
Период Лимит Интервал Всплеск
1 мин 300 запросов 200 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов

Authorizations:
HeaderApiKey
query Parameters
year
required
integer
Example: year=2023

Год создания заказа

month
required
integer [ 1 .. 12 ]
Example: month=2

Месяц создания заказа

next
required
integer <int64>

Параметр пагинации. Устанавливает значение, с которого надо получить следующий пакет данных. Для получения полного списка данных должен быть равен 0 в первом запросе. Для следующих запросов необходимо брать значения из одноимённого поля в ответе.

limit
required
integer <int32> [ 100 .. 1000 ]
Example: limit=150

Количество сборочных заданий в ответе

Responses

Response samples

Content type
application/json
{
  • "next": 0,
  • "orders": [
    ]
}

Идентификаторы маркировки FBS

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

С помощью этих методов вы можете получить, удалить и отредактировать идентификаторы маркировки сборочных заданий:

Заполнять идентификаторы маркировки сборочных заданий в песочнице необязательно

Получить идентификаторы маркировки сборочных заданий{{ /api/marketplace/v3/orders/meta }}

Описание метода

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

Перечень идентификаторов маркировки, доступных для сборочного задания, можно получить в списке новых сборочных заданий, поля requiredMeta и optionalMeta. Если поля requiredMeta и optionalMeta не содержат какой-либо идентификатор маркировки, значит, у сборочного задания не может быть этого идентификатора — и добавить его нельзя.
Возможные идентификаторы маркировки:

Лимит запросов на один профиль продавца для всех методов получения и удаления идентификаторов маркировки FBS:
Период Лимит Интервал Всплеск
1 мин 300 запросов 200 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey
Request Body schema: application/json
required
orders
required
Array of integers <= 100 items

Responses

Request samples

Content type
application/json
{
  • "orders": [
    ]
}

Response samples

Content type
application/json
{
  • "orders": [
    ]
}

Удалить идентификаторы маркировки сборочного задания{{ /api/v3/orders/{orderId}/meta }}

Описание метода

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

Возможные идентификаторы маркировки:

Можно передать только один ключ.

Лимит запросов на один профиль продавца для всех методов получения и удаления идентификаторов маркировки FBS:
Период Лимит Интервал Всплеск
1 мин 300 запросов 200 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64>
Example: 5632423

ID сборочного задания

query Parameters
key
required
string
Enum: imei uin gtin sgtin customsDeclaration

Название идентификаторов маркировки для удаления. Передаётся только одно значение.

Responses

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectRequest",
  • "message": "Переданы некорректные данные"
}

Закрепить код маркировки Честного знака за сборочным заданием{{ /api/v3/orders/{orderId}/meta/sgtin }}

Описание метода

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

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

Лимит запросов на один профиль продавца для всех методов закрепления идентификаторов маркировки FBS:
Период Лимит Интервал Всплеск
1 мин 1000 запросов 60 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64>
Example: 5632423

ID сборочного задания

Request Body schema: application/json
required
sgtins
required
Array of strings [ 1 .. 100 ] items

Массив кодов маркировки Честного знака.
Вы можете передать коды маркировки:

  • полностью — с GS-разделителями и кодом проверки подлинности (криптохвостом)
  • в коротком формате — с GS-разделителями без кода проверки подлинности (криптохвоста)

GS-разделители необходимо передавать в кодировке Unicode с экранированием — \u001D

Responses

Request samples

Content type
application/json
{
  • "sgtins": [
    ]
}

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectRequestBody",
  • "message": "Некорректное тело запроса"
}

Закрепить УИН за сборочным заданием{{ /api/v3/orders/{orderId}/meta/uin }}

Описание метода

Метод обновляет УИН, уникальный идентификационный номер, в идентификаторах маркировки сборочного задания. У одного сборочного задания может быть только один УИН.
Закрепить УИН можно только за сборочным заданием в статусе confirm и если в идентификаторах маркировки сборочного задания есть поле uin.

Лимит запросов на один профиль продавца для всех методов закрепления идентификаторов маркировки FBS:
Период Лимит Интервал Всплеск
1 мин 1000 запросов 60 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64>
Example: 5632423

ID сборочного задания

Request Body schema: application/json
required
uin
required
string = 16 characters

УИН

Responses

Request samples

Content type
application/json
{
  • "uin": "1234567890123456"
}

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectRequestBody",
  • "message": "Некорректное тело запроса"
}

Закрепить IMEI за сборочным заданием{{ /api/v3/orders/{orderId}/meta/imei }}

Описание метода

Метод обновляет IMEI в идентификаторах маркировки сборочного задания.
У одного сборочного задания может быть только один IMEI. Если у устройства два IMEI — IMEI и IMEI2 или IMEI1 и IMEI2 — укажите только IMEI или IMEI1. IMEI2 указывать не нужно.
Закрепить IMEI можно только за сборочным заданием в статусе confirm и если в идентификаторах маркировки сборочного задания есть поле imei.

Лимит запросов на один профиль продавца для всех методов закрепления идентификаторов маркировки FBS:
Период Лимит Интервал Всплеск
1 мин 1000 запросов 60 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64>
Example: 5632423

ID сборочного задания

Request Body schema: application/json
required
imei
required
string = 15 characters

IMEI

Responses

Request samples

Content type
application/json
{
  • "imei": "123456789012345"
}

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectRequestBody",
  • "message": "Некорректное тело запроса"
}

Закрепить GTIN за сборочным заданием{{ /api/v3/orders/{orderId}/meta/gtin }}

Описание метода

Метод обновляет GTIN, уникальный ID товара в Беларуси, в идентификаторах маркировки сборочного задания. У одного сборочного задания может быть только один GTIN.
Закрепить GTIN можно только за сборочным заданием в статусе confirm и если в идентификаторах маркировки сборочного задания есть поле gtin.

Лимит запросов на один профиль продавца для всех методов закрепления идентификаторов маркировки FBS:
Период Лимит Интервал Всплеск
1 мин 1000 запросов 60 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64>
Example: 5632423

ID сборочного задания

Request Body schema: application/json
required
gtin
required
string = 13 characters

GTIN

Responses

Request samples

Content type
application/json
{
  • "gtin": "1234567890123"
}

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectRequestBody",
  • "message": "Некорректное тело запроса"
}

Закрепить за сборочным заданием срок годности товара{{ /api/v3/orders/{orderId}/meta/expiration }}

Описание метода

Метод закрепляет за сборочным заданием срок годности товара. Товар годен до указанной даты.
Закрепить срок годности можно только за сборочным заданием в статусе confirm и если в идентификаторах маркировки сборочного задания есть поле expiration.

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

Лимит запросов на один профиль продавца для всех методов закрепления идентификаторов маркировки FBS:
Период Лимит Интервал Всплеск
1 мин 1000 запросов 60 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64>
Example: 5632423

ID сборочного задания

Request Body schema: application/json
required
expiration
required
string <date (dd.mm.yyyy)>

Дата, до которой годен товар. Не менее 30 дней с текущей даты

Responses

Request samples

Content type
application/json
{
  • "expiration": "12.09.2030"
}

Response samples

Content type
application/json
Example

Указан срок меньше допустимого

{
  • "code": "LowExpirationDate",
  • "message": "Не удалось обновить срок годности. Указан срок меньше допустимого"
}

Закрепить номер ДТ за сборочным заданием{{ /api/marketplace/v3/orders/{orderId}/meta/customs-declaration }}

Описание метода

Метод обновляет номер ДТ — декларации на товары — в идентификаторах маркировки сборочного задания. У одного сборочного задания может быть только один номер ДТ.
Закрепить номер ДТ можно только за сборочным заданием в статусе confirm и если в идентификаторах маркировки сборочного задания есть поле customsDeclaration.

Продавцам из Армении необходимо обязательно указывать номер декларации на товары (ДТ), произведённые вне ЕАЭС, если заказ из Армении доставляется в РФ.
Лимит запросов на один профиль продавца для всех методов закрепления идентификаторов маркировки FBS:
Период Лимит Интервал Всплеск
1 мин 1000 запросов 60 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64>
Example: 5632423

ID сборочного задания

Request Body schema: application/json
required
customsDeclaration
required
string [ 17 .. 29 ] characters

Номер ДТ

Responses

Request samples

Content type
application/json
{
  • "customsDeclaration": "10704010/010624/0000302"
}

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectRequestBody",
  • "message": "Некорректное тело запроса"
}

Поставки FBS

Для доступа к методам используйте токен для категории Маркетплейс
Узнать больше о поставках FBS можно в справочном центре

Для работы с поставками:

Пункты 3-5 обязательны к выполнению при доставке поставки на пункт выдачи заказов (ПВЗ).

  1. Создайте новую поставку. В ответ вернется ID созданной поставки в формате WB-GI-1234567.

  2. В текущую новую поставку добавьте сборочные задания, которые вы повезёте на склад или ПВЗ. После того, как сборочные задания будут добавлены к поставке, они будут переведены в статус confirm — на сборке.

  3. Добавьте грузоместа в поставку.

  4. Проверьте список грузомест.

  5. Получите стикеры грузомест. Распечатайте и наклейте стикеры на грузоместа.

  6. После того как поставка будет укомплектована нужными сборочными заданиями, необходимо передать её в доставку. Если поставка не была передана в доставку, то при сканировании её QR-кода или приёмке первого товара на ПВЗ поставка автоматически закроется. При передаче сборочных заданий в доставку они будут автоматически собраны и переведены в статус complete — в доставке.

  7. Для поставок из стран ЕАЭС добавьте данные СПОТ. Получите список стран ОКСМ для добавления данных СПОТ в поставку. Вы можете получать данные СПОТ для списка поставок и QR-коды СПОТ. Сейчас методы доступны только для продавцов из Кыргызстана. В дальнейшем методы будут доступны продавцам из любой страны ЕАЭС кроме РФ, следите за обновлениями.

  8. Если поставка была отсканирована в пункте приёмки, но при этом в ней всё ещё есть неотсканированные товары, спустя определённое время необходимо доставить их повторно. Проверьте все сборочные задания, требующие повторной отгрузки на данный момент. Данные сборочные задания можно перевести в другую активную поставку. Сборочное задание также будет переведено в статус confirm — на сборке.

Также вы можете:

Создать новую поставку{{ /api/v3/supplies }}

Описание метода

Метод создаёт новую поставку.

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

  • Только для сборочных заданий по модели FBS.
  • При добавлении в поставку все передаваемые сборочные задания в статусе new будут автоматически переведены в статус confirm — на сборке.
  • Если вы переведёте сборочное задание в статус cancel — отмена продавцом, прикрепленное сборочное задание автоматически удалится из поставки.
  • Поставку можно собрать только из сборочных заданий (заказов) одного габаритного типа cargoType. Новая поставка не обладает габаритным признаком, она приобретает габаритный признак первого заказа, добавленного в поставку.
Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
Период Лимит Интервал Всплеск
1 мин 300 запросов 200 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey
Request Body schema: application/json
required
name
string [ 1 .. 128 ] characters

Наименование поставки

Responses

Request samples

Content type
application/json
{
  • "name": "Тестовая поставка"
}

Response samples

Content type
application/json
{
  • "id": "WB-GI-1234567"
}

Получить список поставок{{ /api/v3/supplies }}

Описание метода

Метод возвращает список поставок.

Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
Период Лимит Интервал Всплеск
1 мин 300 запросов 200 мс 20 запросов

Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

Authorizations:
HeaderApiKey
query Parameters
limit
required
integer [ 1 .. 1000 ]

Параметр пагинации. Устанавливает предельное количество возвращаемых данных.

next
required
integer <int64>

Параметр пагинации. Устанавливает значение, с которого надо получить следующий пакет данных. Для получения полного списка данных должен быть равен 0 в первом запросе. Для следующих запросов необходимо брать значения из одноимённого поля в ответе.

Responses

Response samples

Content type
application/json
{
  • "next": 13833711,
  • "supplies": [
    ]
}

Добавить сборочные задания к поставке{{ /api/marketplace/v3/supplies/{supplyId}/orders }}

Описание метода

Метод добавляет до 100 сборочных заданий к поставке и переводит их в статус confirm — на сборке.

Может перемещать сборочные задания:

  • между активными поставками
  • из закрытой поставки в активную, если сборочные задания требуют повторной отгрузки
В пустую поставку можно добавить любые сборочные задания, поступившие на один и тот же склад.
Поставка приобретает признаки первого добавленного в неё сборочного задания из полей:
  • crossBorderType — трансграничная или внутренняя поставка
  • cargoType — габаритный тип
  • isB2b — B2B-продажа
    • После этого в поставку можно добавить сборочные задания только с такими же признаками crossBorderType, cargoType, isB2b, как у поставки.
    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

    Authorizations:
    HeaderApiKey
    path Parameters
    supplyId
    required
    string
    Example: WB-GI-1234567

    ID поставки

    Request Body schema: application/json
    required
    orders
    Array of integers [ 1 .. 100 ] items

    ID сборочных заданий

    Responses

    Request samples

    Content type
    application/json
    {
    • "orders": [
      ]
    }

    Response samples

    Content type
    application/json
    {
    • "code": "IncorrectParameter",
    • "message": "Передан некорректный параметр"
    }

    Перевести сборочные задания из доставки на сборку{{ /api/marketplace/v3/fbs/supplies/{supplyId}/orders/transfer }}

    Описание метода

    Метод переводит сборочные задания из статуса complete — в доставке в статус confirm — на сборке.
    Используйте метод, чтобы переместить сборочное задание из закрытой поставки в открытую.
    Сборочное задание можно перевести из доставки на сборку, если выполнены все условия:

    • сборочное задание находится в статусе complete — в доставке
    • поставка, в которую нужно перенести сборочное задание, не передана в доставку
    • сборочное задание ранее не переносили из доставки на сборку Чтобы проверить, можно ли перевести сборочное задание из доставки на сборку, используйте статусы сборочных заданий, поле isTransferable.
    Authorizations:
    HeaderApiKey
    path Parameters
    supplyId
    required
    string

    ID поставки, из которой будут перемещены заказы

    Request Body schema: application/json
    required
    orderIds
    required
    Array of integers

    Список ID сборочных заданий, которые нужно перевести на сборку

    newSupplyId
    required
    string

    ID поставки, в которую будут перемещены сборочные задания. Поставка не должна быть в доставке

    Responses

    Request samples

    Content type
    application/json
    {
    • "orderIds": [
      ],
    • "newSupplyId": "string"
    }

    Response samples

    Content type
    application/json
    {
    • "transferredOrders": [
      ]
    }

    Получить информацию о поставке{{ /api/v3/supplies/{supplyId} }}

    Описание метода

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

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

    Authorizations:
    HeaderApiKey
    path Parameters
    supplyId
    required
    string
    Example: WB-GI-1234567

    ID поставки

    Responses

    Response samples

    Content type
    application/json
    {
    • "id": "WB-GI-1234567",
    • "isB2b": true,
    • "isPickupPointShipmentAllowed": true,
    • "done": true,
    • "createdAt": "2022-05-04T07:56:29Z",
    • "closedAt": "2022-05-04T07:56:29Z",
    • "scanDt": "2022-05-04T07:56:29Z",
    • "name": "Тестовая поставка",
    • "cargoType": 1,
    • "crossBorderType": 1,
    • "destinationOfficeId": 123,
    • "recommendedWhId": 123569,
    • "shippingDt": "2026-08-31",
    • "shippingPointId": 100,
    • "shippingType": "selfShipping",
    • "waybillUuid": "550e8400-e29b-41d4-a716-384579387429",
    • "spotAvailable": true
    }

    Удалить поставку{{ /api/v3/supplies/{supplyId} }}

    Описание метода

    Метод удаляет поставку, если она активна и за ней не закреплено ни одно сборочное задание.

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

    Authorizations:
    HeaderApiKey
    path Parameters
    supplyId
    required
    string
    Example: WB-GI-1234567

    ID поставки

    Responses

    Response samples

    Content type
    application/json
    {
    • "code": "IncorrectParameter",
    • "message": "Передан некорректный параметр"
    }

    Получить ID сборочных заданий поставки{{ /api/marketplace/v3/supplies/{supplyId}/order-ids }}

    Описание метода

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

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

    Authorizations:
    HeaderApiKey
    path Parameters
    supplyId
    required
    string

    ID поставки

    Responses

    Response samples

    Content type
    application/json
    {
    • "orderIds": [
      ]
    }

    Передать поставку в доставку{{ /api/v3/supplies/{supplyId}/deliver }}

    Описание метода

    Метод закрывает поставку и переводит все сборочные задания в ней в статус complete — в доставке. После закрытия поставки добавить новые сборочные задания к ней нельзя.

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

    Передать поставку в доставку можно, только если в ней:

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

    Если поставка содержит сборочные задания с обязательным УИН, убедитесь, что вы заранее создали и загрузили спецификацию с договором на доставку. ГИИС ДМДК требуется около 30 минут для обработки изменений в статусах УИН.

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

    Authorizations:
    HeaderApiKey
    path Parameters
    supplyId
    required
    string
    Example: WB-GI-1234567

    ID поставки

    Responses

    Response samples

    Content type
    application/json
    {
    • "code": "IncorrectParameter",
    • "message": "Передан некорректный параметр"
    }

    Получить QR-код поставки{{ /api/v3/supplies/{supplyId}/barcode }}

    Описание метода

    Метод возвращает QR-код поставки в форматах:

    • SVG
    • ZPLV (вертикальный)
    • ZPLH (горизонтальный)
    • PNG

    QR-код поставки можно получить, только если поставка передана в доставку.

    Размер — 580x400 px.

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

    Authorizations:
    HeaderApiKey
    path Parameters
    supplyId
    required
    string
    Example: WB-GI-1234567

    ID поставки

    query Parameters
    type
    required
    string
    Enum: svg zplv zplh png

    Тип стикера

    Responses

    Response samples

    Content type
    application/json
    {
    • "barcode": "WB-GI-12345678",
    • "file": "U3dhZ2dlciByb2Nrcw=="
    }

    Получить список грузомест поставки{{ /api/v3/supplies/{supplyId}/trbx }}

    Описание метода

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

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

    Authorizations:
    HeaderApiKey
    path Parameters
    supplyId
    required
    string
    Example: WB-GI-1234567

    ID поставки

    Responses

    Response samples

    Content type
    application/json
    {
    • "trbxes": [
      ]
    }

    Добавить грузоместа к поставке{{ /api/v3/supplies/{supplyId}/trbx }}

    Описание метода

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

    Грузоместа необходимо добавлять только в поставки, отгружаемые на ПВЗ.
    Грузоместа можно добавить только в открытую поставку. В одном грузоместе может быть несколько заказов. Например, если в поставке 10 заказов, распределите их по коробам: система позволит создать не больше 5 грузомест. Для 20 заказов — не больше 10 грузомест, для 100 — не больше 50.

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

    Authorizations:
    HeaderApiKey
    path Parameters
    supplyId
    required
    string
    Example: WB-GI-1234567

    ID поставки

    Request Body schema: application/json
    amount
    required
    integer [ 1 .. 1000 ]

    Количество грузомест, которые необходимо добавить к поставке

    Responses

    Request samples

    Content type
    application/json
    {
    • "amount": 4
    }

    Response samples

    Content type
    application/json
    {
    • "trbxIds": [
      ]
    }

    Удалить грузоместа из поставки{{ /api/v3/supplies/{supplyId}/trbx }}

    Описание метода

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

    Можно удалить только пока поставка на сборке.

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

    Authorizations:
    HeaderApiKey
    path Parameters
    supplyId
    required
    string
    Example: WB-GI-1234567

    ID поставки

    Request Body schema: application/json
    trbxIds
    required
    Array of strings

    Список ID грузомест, которые необходимо удалить

    Responses

    Request samples

    Content type
    application/json
    {
    • "trbxIds": [
      ]
    }

    Response samples

    Content type
    application/json
    {
    • "code": "IncorrectParameter",
    • "message": "Передан некорректный параметр"
    }

    Получить стикеры грузомест поставки{{ /api/v3/supplies/{supplyId}/trbx/stickers }}

    Описание метода

    Метод возвращает QR-стикеры в форматах:

    • SVG
    • ZPLV (вертикальный)
    • ZPLH (горизонтальный)
    • PNG

      Размер стикеров — 580x400 px.
    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

    Authorizations:
    HeaderApiKey
    path Parameters
    supplyId
    required
    string
    Example: WB-GI-1234567

    ID поставки

    query Parameters
    type
    required
    string
    Example: type=png

    Формат стикера

    Request Body schema: application/json
    trbxIds
    required
    Array of strings

    Список ID грузомест, по которым необходимо вернуть стикеры

    Responses

    Request samples

    Content type
    application/json
    {
    • "trbxIds": [
      ]
    }

    Response samples

    Content type
    application/json
    {
    • "stickers": [
      ]
    }

    Получить список стран ОКСМ{{ /api/marketplace/v3/fbs/dictionaries/countries/oksm }}

    Описание метода

    Метод возвращает список стран ОКСМ — Общероссийского классификатора стран мира — с полными названиями и кодами.

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов

    Authorizations:
    HeaderApiKey

    Responses

    Response samples

    Content type
    application/json
    {
    • "countries": [
      ]
    }

    Добавить данные СПОТ в поставку{{ /api/marketplace/v3/fbs/supplies/{supplyId}/spot }}

    Описание метода

    Метод добавляет данные СПОТ в поставку.

    СПОТ можно добавить только в поставку с признаком "spotAvailable":true.

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов

    Authorizations:
    HeaderApiKey
    path Parameters
    supplyId
    required
    string
    Example: WB-GI-123456789

    ID поставки

    Request Body schema: application/json
    required
    carrierName
    required
    string [ 1 .. 1000 ] characters

    Наименование перевозчика

    carrierTaxNumber
    required
    string [ 1 .. 50 ] characters

    ИНН перевозчика

    carrierCountryCode
    required
    string = 3 characters

    Код страны перевозчика по ОКСМ

    vehicleRegistrationNumber
    required
    string [ 1 .. 30 ] characters

    Регистрационный номер транспортного средства

    trailerRegistrationNumber
    string [ 1 .. 30 ] characters

    Регистрационный номер прицепа

    Responses

    Request samples

    Content type
    application/json
    {
    • "carrierName": "ООО СПОТ",
    • "carrierTaxNumber": "7588179007",
    • "carrierCountryCode": "112",
    • "vehicleRegistrationNumber": "А123АА100",
    • "trailerRegistrationNumber": "АА000100"
    }

    Response samples

    Content type
    application/problem+json
    {
    • "detail": "Not Found",
    • "title": "NotFound"
    }

    Получить данные СПОТ для списка поставок{{ /api/marketplace/v3/fbs/supplies/spot/list }}

    Описание метода

    Метод возвращает данные СПОТ для списка поставок.

    Вы можете получить данные СПОТ, только если выполняются все условия:

    • поставка находится на этапе доставки
    • продавец зарегистрирован в любой стране ЕАЭС кроме РФ
    • склад назначения находится в РФ
    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов

    Authorizations:
    HeaderApiKey
    Request Body schema: application/json
    required
    supplyIds
    required
    Array of strings [ 1 .. 100 ] characters

    Список ID поставок

    Responses

    Request samples

    Content type
    application/json
    {
    • "supplyIds": [
      ]
    }

    Response samples

    Content type
    application/json
    {
    • "supplies": [
      ]
    }

    Получить QR-код СПОТ{{ /api/marketplace/v3/fbs/supplies/{supplyId}/stickers/spot }}

    Описание метода

    Метод возвращает сформированный QR-код СПОТ для поставки в формате PNG, кодировка base64.

    Вы можете получить QR-код, когда в методе получения данных СПОТ будет признак "status":"completed".

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов

    Authorizations:
    HeaderApiKey
    path Parameters
    supplyId
    required
    string
    Example: WB-GI-123456789

    ID поставки

    Responses

    Response samples

    Content type
    application/json
    {
    • "qrCode": "U3dhZ2dlciByb2Nrcw=="
    }

    Пропуска FBS

    Для доступа к методам используйте токен для категории Маркетплейс

    С помощью методов этого раздела вы можете:

    Получить список складов, для которых требуется пропуск{{ /api/v3/passes/offices }}

    Описание метода

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

    Данные, которые возвращает метод, могут меняться. Рекомендуем периодически синхронизировать список
    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

    Authorizations:
    HeaderApiKey

    Responses

    Response samples

    Content type
    application/json
    [
    • {
      }
    ]

    Получить список пропусков{{ /api/v3/passes }}

    Описание метода

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

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

    Authorizations:
    HeaderApiKey

    Responses

    Response samples

    Content type
    application/json
    [
    • {
      }
    ]

    Создать пропуск{{ /api/v3/passes }}

    Описание метода

    Метод создаёт пропуск продавца с привязкой к складу WB.

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

    Максимум 1 запрос в 10 минут на один профиль продавца.

    Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

    Authorizations:
    HeaderApiKey
    Request Body schema: application/json
    required

    Общая длина ФИО ограничена от 6 до 100 символов. В номере машины могут быть только буквы и цифры

    firstName
    required
    string non-empty

    Имя водителя

    lastName
    required
    string non-empty

    Фамилия водителя

    carModel
    required
    string [ 1 .. 100 ] characters

    Марка машины

    carNumber
    required
    string [ 6 .. 9 ] characters

    Номер машины

    officeId
    required
    integer <int64> >= 1

    ID склада

    Responses

    Request samples

    Content type
    application/json
    {
    • "firstName": "Александр",
    • "lastName": "Петров",
    • "carModel": "Lamborghini",
    • "carNumber": "A456BC123",
    • "officeId": 15
    }

    Response samples

    Content type
    application/json
    {
    • "id": 2
    }

    Обновить пропуск{{ /api/v3/passes/{passId} }}

    Описание метода

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

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

    Authorizations:
    HeaderApiKey
    path Parameters
    passId
    required
    integer <int64>
    Example: 45

    ID пропуска

    Request Body schema: application/json
    required

    Общая длина ФИО ограничена от 6 до 100 символов. В номере машины могут быть только буквы и цифры.

    firstName
    required
    string non-empty

    Имя водителя

    lastName
    required
    string >= 6 characters

    Фамилия водителя

    carModel
    required
    string [ 1 .. 100 ] characters

    Марка машины

    carNumber
    required
    string [ 6 .. 9 ] characters

    Номер машины

    officeId
    required
    integer <int64> >= 1

    ID склада

    Responses

    Request samples

    Content type
    application/json
    {
    • "firstName": "Александр",
    • "lastName": "Петров",
    • "carModel": "Lamborghini",
    • "carNumber": "A456BC123",
    • "officeId": 15
    }

    Response samples

    Content type
    application/json
    Example
    {
    • "code": "IncorrectRequestBody",
    • "message": "Некорректное тело запроса"
    }

    Удалить пропуск{{ /api/v3/passes/{passId} }}

    Описание метода

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

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов.

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

    Authorizations:
    HeaderApiKey
    path Parameters
    passId
    required
    integer <int64>
    Example: 45

    ID пропуска

    Responses

    Response samples

    Content type
    application/json
    {
    • "title": "unauthorized",
    • "detail": "token problem; token is malformed: could not base64 decode signature: illegal base64 data at input byte 84",
    • "code": "07e4668e--a53a3d31f8b0-[UK-oWaVDUqNrKG]; 03bce=277; 84bd353bf-75",
    • "requestId": "7b80742415072fe8b6b7f7761f1d1211",
    • "origin": "ag-marketplace",
    • "status": 401,
    • "statusText": "Unauthorized",
    • "timestamp": "2024-09-30T06:52:38Z"
    }

    Настройки автовозврата

    Для доступа к методам используйте токен для категории Маркетплейс

    С помощью методов этого раздела вы можете управлять настройками автовозврата малогабаритных товаров:

    Получить настройки автовозврата продавца{{ /api/marketplace/v3/fbs/settings/autoreturns }}

    Описание метода
    Метод доступен по Персональному токену, Сервисному токену, Базовому токену с секретом

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

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов

    Authorizations:
    HeaderApiKey

    Responses

    Response samples

    Content type
    application/json
    {
    • "type": "allToWarehouse"
    }

    Обновить настройки автовозврата продавца{{ /api/marketplace/v3/fbs/settings/autoreturns }}

    Описание метода
    Метод доступен по Персональному токену, Сервисному токену, Базовому токену с секретом

    Метод устанавливает настройки автовозврата продавца для малогабаритных товаров — "cargoType":1.

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов

    Authorizations:
    HeaderApiKey
    Request Body schema: application/json
    type
    required
    string
    Enum: allToWarehouse allToPickupPoint manual

    Тип автовозврата малогабаритных товаров:

    • allToWarehouse — отправлять все товары на склад WB, кроме товаров тех предметов, которые автоматически возвращаются в ПВЗ
    • allToPickupPoint — отправлять все товары на пункт выдачи заказов
    • manual — использовать ручные настройки

    Responses

    Request samples

    Content type
    application/json
    {
    • "type": "allToWarehouse"
    }

    Response samples

    Content type
    application/problem+json
    {
    • "detail": "Not Found",
    • "title": "NotFound"
    }

    Получить настройки автовозврата товаров{{ /api/marketplace/v3/fbs/settings/autoreturns/items }}

    Описание метода
    Метод доступен по Персональному токену, Сервисному токену, Базовому токену с секретом

    Метод возвращает настройки автовозврата товаров.

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов

    Authorizations:
    HeaderApiKey
    Request Body schema: application/json
    chrtIds
    required
    Array of integers <uint64> [ 1 .. 1000 ] items [ items <uint64 > ]

    Список ID размеров товаров в системе WB

    Responses

    Request samples

    Content type
    application/json
    {
    • "chrtIds": [
      ]
    }

    Response samples

    Content type
    application/json
    {
    • "results": [
      ]
    }

    Обновить настройки автовозврата товаров{{ /api/marketplace/v3/fbs/settings/autoreturns/items }}

    Описание метода
    Метод доступен по Персональному токену, Сервисному токену, Базовому токену с секретом

    Метод устанавливает настройки автовозврата малогабаритных товаров — "cargoType":1.

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов

    Authorizations:
    HeaderApiKey
    Request Body schema: application/json
    chrtIds
    required
    Array of integers <uint64> <= 1000 items [ items <uint64 > ]

    Список ID размеров товаров в системе WB

    type
    required
    string
    Enum: byWarehouse byPickupPoint

    Тип автовозврата малогабаритных товаров:

    • byWarehouse — все товары отправляются на склад WB
    • byPickupPoint — все товары отправляются на пункт выдачи заказов

    Responses

    Request samples

    Content type
    application/json
    {
    • "chrtIds": [
      ],
    • "type": "byWarehouse"
    }

    Response samples

    Content type
    application/json
    {
    • "results": [
      ]
    }

    Получить предметы, которые не хранятся на складах WB{{ /api/marketplace/v3/fbs/settings/autoreturns/subcategories/restricted }}

    Описание метода
    Метод доступен по Персональному токену, Сервисному токену, Базовому токену с секретом

    Метод возвращает список ID предметов, товары которых не могут храниться на складах WB и будут возвращены в ПВЗ автоматически.

    Лимит запросов на один профиль продавца для методов сборочных заданий, поставок, пропусков и настроек автовозврата FBS:
    Период Лимит Интервал Всплеск
    1 мин 300 запросов 200 мс 20 запросов

    Один запрос с кодами ответов 4XX учитывается как 10 запросов

    Authorizations:
    HeaderApiKey
    query Parameters
    next
    required
    integer <int64>

    Параметр пагинации. Устанавливает значение, с которого надо получить следующий пакет данных. Для получения полного списка данных должен быть равен 0 в первом запросе. Для следующих запросов необходимо брать значения из одноимённого поля в ответе.

    limit
    required
    integer <int32> [ 100 .. 1000 ]
    Example: limit=1000

    Количество предметов в ответе

    Responses

    Response samples

    Content type
    application/json
    {
    • "next": 300,
    • "data": [
      ]
    }