Поиск

Заказы 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.
Чтобы получить статусы сборочных заданий, созданных более 3 месяцев назад, используйте метод получения архивных сборочных заданий.

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 — заказ прибыл на пункт выдачи заказов (ПВЗ)
  • postponed_delivery — доставка курьером отложена
  • accepted_by_carrier — продавец передал заказ в службу доставки в своей стране. C 12 ноября заменён на delivering_by_carrier. Только для трансграничных поставок
  • sent_to_carrier — заказ отправлен на склад службы доставки в стране продавца. C 12 ноября заменён на delivering_by_carrier. Только для трансграничных поставок
  • delivering_by_carrier — заказ передан перевозчику и находится в пути на склад WB. Только для трансграничных поставок
  • 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. Чтобы проверить, можно ли отменить сборочное задание, используйте метод получения статусов сборочных заданий, поле 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. Если поставка была отсканирована в пункте приёмки, но при этом в ней всё ещё есть неотсканированные товары, спустя определённое время необходимо доставить их повторно. Проверьте все сборочные задания, требующие повторной отгрузки на данный момент. Данные сборочные задания можно перевести в другую активную поставку. Сборочное задание также будет переведено в статус 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.

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

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

    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": [
      ]
    }

    Пропуска 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": [
      ]
    }