Поиск
API docs by Redocly

Заказы FBS (order)

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

В разделе заказов FBS (Fulfillment by Seller) вам доступны методы:

  1. Управления сборочными заданиями: информация о сборочных заданиях, метаданные, стикеры и так далее.
  2. Управления поставками заказов продавца на склады WB.
  3. Заказа пропусков на склады WB.
  4. Доставки заказов курьером WB (DBW).

Заказы FBS

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

В разделе заказов FBS (Fulfillment by Seller) вам доступны методы:

  1. Управления сборочными заданиями: информация о сборочных заданиях, метаданные, стикеры и так далее.
  2. Управления поставками заказов продавца на склады WB.
  3. Заказа пропусков на склады WB.
  4. Доставки заказов курьером WB (DBW).

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

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

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey

Responses

Response samples

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

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

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

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
query Parameters
limit
required
integer [ 1 .. 1000 ]

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

next
required
integer <int64>

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

dateFrom
integer

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

dateTo
integer

Дата конца периода в формате Unix timestamp

Responses

Response samples

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

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

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

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

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

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

Статус Описание Как перевести сборочное задание в данный статус
new Новое сборочное задание
confirm На сборке
Для доставки силами Wildberries fbs		 Добавить сборочное задание к поставке
complete В доставке
Для доставки силами Wildberries fbs и курьером WB wbgo		 Для fbs — передать поставку в доставку
Для wbgo — перевести сборочное задание в доставку
cancel Отменено продавцом Отменить сборочное задание
receive Получено клиентом
Для доставки курьером WB wbgo		 Статус меняется автоматически
reject Отказ клиента при получении
Для доставки курьером WB wbgo		 Статус меняется автоматически



wbStatus — статус сборочного задания в системе WB.

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

  • waiting — сборочное задание в работе
  • sorted — сборочное задание отсортировано
  • sold — сборочное задание получено покупателем
  • canceled — отмена сборочного задания
  • canceled_by_client — покупатель отменил заказ при получении
  • declined_by_client — покупатель отменил заказ. Отмена доступна покупателю в первый час с момента заказа, если заказ не переведён на сборку
  • defect — отмена сборочного задания по причине брака
  • ready_for_pickup — сборочное задание прибыло на пункт выдачи заказов (ПВЗ)
  • postponed_delivery — курьерская доставка отложена
Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
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 }}

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

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey

Responses

Response samples

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

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

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
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 }}

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

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

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

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

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

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

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

  • 580x400 px при параметрах "width": 58, "height": 40
  • 400x300 px при параметрах "width": 40, "height": 30
Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
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/files/orders/external-stickers }}

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

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

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

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

Один запрос с кодом ответа 409 учитывается как 5 запросов
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
{}

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

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
requestBody: content: application/json: schema: type: object properties: orders: description: ID сборочных заданий type: array items: type: integer maxItems: 100 minItems: 1 example: - 123456789 - 987654321
Authorizations:
HeaderApiKey

Responses

Response samples

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

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

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

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
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/v3/orders/{orderId}/meta }}

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

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

Возможные метаданные:

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64>
Example: 5632423

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

Responses

Response samples

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

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

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

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

Возможные метаданные:

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64>
Example: 5632423

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

query Parameters
key
string

Название метаданных для удаления (imei, uin, gtin, sgtin). Передается только одно значение.

Responses

Response samples

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

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

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

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

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

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

Максимум 1 000 запросов в минуту суммарно на один аккаунт продавца для методов:
1. Закрепить за сборочным заданием УИН
2. Закрепить за сборочным заданием IMEI
3. Закрепить за сборочным заданием GTIN
4. Закрепить за сборочным заданием код маркировки

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64>
Example: 5632423

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

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

Массив кодов маркировки. Допускается от 16 до 135 символов для кода одной маркировки.

Responses

Request samples

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

Response samples

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

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

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

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

У одного сборочного задания может быть только один УИН.

Добавлять маркировку можно только для заказов, которые доставляются WB и находятся в статусе confirm.

Максимум 1 000 запросов в минуту суммарно на один аккаунт продавца для методов:
1. Закрепить за сборочным заданием УИН
2. Закрепить за сборочным заданием IMEI
3. Закрепить за сборочным заданием GTIN
4. Закрепить за сборочным заданием код маркировки

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64>
Example: 5632423

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

Request Body schema: application/json
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.

Добавлять маркировку можно только для заказов, которые доставляются WB и находятся в статусе confirm.

Максимум 1 000 запросов в минуту суммарно на один аккаунт продавца для методов:
1. Закрепить за сборочным заданием УИН
2. Закрепить за сборочным заданием IMEI
3. Закрепить за сборочным заданием GTIN
4. Закрепить за сборочным заданием код маркировки

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64>
Example: 5632423

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

Request Body schema: application/json
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.

Добавлять маркировку можно только для заказов, которые доставляются WB и находятся в статусе confirm.

Максимум 1 000 запросов в минуту суммарно на один аккаунт продавца для методов:
1. Закрепить за сборочным заданием УИН
2. Закрепить за сборочным заданием IMEI
3. Закрепить за сборочным заданием GTIN
4. Закрепить за сборочным заданием код маркировки

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64>
Example: 5632423

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

Request Body schema: application/json
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": "Некорректное тело запроса"
}

Поставки FBS

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

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

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

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

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

Один запрос с кодом ответа 409 учитывается как 5 запросов
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 }}

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
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/v3/supplies/{supplyId}/orders/{orderId} }}

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

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

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

  • между активными поставками.
  • из закрытой поставки в активную, если сборочное задание требует повторной отгрузки.
В пустую поставку можно добавить сборочное задание любого габаритного типа. Поставка приобретает габаритный тип первого добавленного сборочного задания из поля cargoType.
После этого в поставку можно добавить сборочные задания только того же габаритного типа, что и у поставки.
Максимум 1 000 запросов в минуту на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
supplyId
required
string
Example: WB-GI-1234567

ID поставки

orderId
required
integer <int64>
Example: 5632423

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

Responses

Response samples

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

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

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
supplyId
required
string
Example: WB-GI-1234567

ID поставки

Responses

Response samples

Content type
application/json
{
  • "id": "WB-GI-1234567",
  • "done": true,
  • "createdAt": "2022-05-04T07:56:29Z",
  • "closedAt": "2022-05-04T07:56:29Z",
  • "scanDt": "2022-05-04T07:56:29Z",
  • "name": "Тестовая поставка",
  • "cargoType": 0
}

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

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
supplyId
required
string
Example: WB-GI-1234567

ID поставки

Responses

Response samples

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

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

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
supplyId
required
string
Example: WB-GI-1234567

ID поставки

Responses

Response samples

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

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

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

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

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

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

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

Один запрос с кодом ответа 409 учитывается как 5 запросов
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.

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
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 }}

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

Метод предоставляет список коробов и ID заказов, входящих в эти короба.

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
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 }}

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

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
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 }}

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

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
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/{trbxId} }}

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

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
supplyId
required
string
Example: WB-GI-1234567

ID поставки

trbxId
required
string
Example: WB-TRBX-1234567

ID короба

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

Список заказов, которые необходимо добавить в короб.

Responses

Request samples

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

Response samples

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

Удалить заказ из короба{{ /api/v3/supplies/{supplyId}/trbx/{trbxId}/orders/{orderId} }}

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

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
supplyId
required
string
Example: WB-GI-1234567

ID поставки

trbxId
required
string
Example: WB-TRBX-1234567

ID короба

orderId
required
integer <int64>
Example: 5632423

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

Responses

Response samples

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

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

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

Метод предоставляет QR-стикеры в форматах:

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

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
supplyId
required
string
Example: WB-GI-1234567

ID поставки

query Parameters
type
required
string
Enum: "svg" "zplv" "zplh" "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/v3/passes/offices }}

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

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

Данные, которые возвращает метод, могут меняться. Рекомендуем периодически синхронизировать список
Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey

Responses

Response samples

Content type
application/json
[
  • {
    }
]

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

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey

Responses

Response samples

Content type
application/json
[
  • {
    }
]

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

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

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

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

Максимум 1 запрос в 10 минут на один аккаунт продавца
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.

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
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} }}

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
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": "s2s-api-auth-catalog",
  • "status": 401,
  • "statusText": "Unauthorized",
  • "timestamp": "2024-09-30T06:52:38Z"
}

Доставка курьером WB (DBW)

Перевести на сборку{{ /api/v3/orders/{orderId}/confirm }}

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

Метод переводит сборочное задание в статус confirm — на сборке.

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64>
Example: 5632423

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

Responses

Response samples

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

Перевести в доставку{{ /api/v3/orders/{orderId}/assemble }}

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

Метод переводит сборочное задание в статус complete — в доставке.

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64>
Example: 5632423

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

Responses

Response samples

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

Список контактов{{ /api/v3/warehouses/{warehouseId}/contacts }}

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
warehouseId
required
integer <int64>
Example: 1

ID склада продавца

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Обновить список контактов{{ /api/v3/warehouses/{warehouseId}/contacts }}

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

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

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

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

К складу можно добавить максимум 5 контактов. Чтобы удалить контакты, отправьте пустой массив contacts.

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца.

Один запрос с кодом ответа 409 учитывается как 5 запросов
Authorizations:
HeaderApiKey
path Parameters
warehouseId
required
integer <int64>
Example: 1

ID склада продавца

Request Body schema: application/json
required
Array of objects <= 5 items

Responses

Request samples

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

Response samples

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