Поиск
API docs by Redocly

Заказы DBW (ordersdbw)

Управление сборочными заданиями DBW (Доставка курьером WB)


Порядок работы:

  1. Получите новое сборочное задание.
  2. Переведите его на сборку.
  3. После перевода на сборку для заказа становится доступной информация о курьере (телефон, номер автомобиля).
    Чтобы курьер мог связаться с вами привяжите свои контакты к складу. Вы так же можете получить текущий список своих контактов.
  4. Получите, распечатайте и прикрепите стикеры.
  5. Переведите сборочное задание в доставку.
  6. Дождитесь курьера.
  7. Курьер забирает заказ и отвозит клиенту.
  8. Клиент принимает заказ или отказывается от него.
  9. Если клиент принимает заказ, курьер переводит сборочное задание в статус receive. Если отказывается — в reject.
Узнать больше о сборочных заданиях DBW можно в справочном центре

Заказы DBW

Управление сборочными заданиями DBW (Доставка курьером WB)


Порядок работы:

  1. Получите новое сборочное задание.
  2. Переведите его на сборку.
  3. После перевода на сборку для заказа становится доступной информация о курьере (телефон, номер автомобиля).
    Чтобы курьер мог связаться с вами привяжите свои контакты к складу. Вы так же можете получить текущий список своих контактов.
  4. Получите, распечатайте и прикрепите стикеры.
  5. Переведите сборочное задание в доставку.
  6. Дождитесь курьера.
  7. Курьер забирает заказ и отвозит клиенту.
  8. Клиент принимает заказ или отказывается от него.
  9. Если клиент принимает заказ, курьер переводит сборочное задание в статус receive. Если отказывается — в reject.
Узнать больше о сборочных заданиях DBW можно в справочном центре

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

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

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

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

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

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

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

Исключение — методы:

Authorizations:
HeaderApiKey

Responses

Response samples

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

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

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

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

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

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

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

Исключение — методы:

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

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

next
required
integer <int64>

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

dateFrom
required
integer

Дата начала периода в формате Unix timestamp

dateTo
required
integer

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

Responses

Response samples

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

Дата и время доставки{{ /api/v3/dbw/orders/delivery-date }}

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

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

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

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

Исключение — методы:

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

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

Responses

Request samples

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

Response samples

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

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

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

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

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

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

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



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

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

  • waiting — сборочное задание в работе
  • sold — заказ получен покупателем
  • canceled — отмена сборочного задания
  • canceled_by_client — покупатель отменил заказ при получении
  • declined_by_client — покупатель отменил заказ в первый чаc
    Отмена доступна покупателю в первый час с момента заказа, если заказ не переведен на сборку
  • defect — отмена заказа по причине брака
  • canceled_by_missed_call — отмена заказа по причине недозвона
  • postponed_delivery — курьерская доставка отложена
Лимит запросов на один аккаунт продавца для всех методов модели DBW:
Период Лимит Интервал Всплеск
1 минута 300 запросов 200 миллисекунд 20 запросов

Один запрос с кодом ответа 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/dbw/orders/{orderId}/confirm }}

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

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

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

Один запрос с кодом ответа 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/dbw/orders/stickers }}

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

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

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

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

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

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

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

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

Один запрос с кодом ответа 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/dbw/orders/{orderId}/assemble }}

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

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

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

Один запрос с кодом ответа 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/dbw/orders/courier }}

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

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

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

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

Исключение — методы:

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

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

Responses

Request samples

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

Response samples

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

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

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

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

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

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

Исключение — методы:

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

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

Responses

Response samples

Content type
application/json
{
  • "code": "IncorrectParameter",
  • "message": ""
}

Метаданные DBW

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

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

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

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

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

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

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

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

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

Исключение — методы:

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

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

Responses

Response samples

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

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

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

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

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

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

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

Один запрос с кодом ответа 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": "IncorrectParameter",
  • "message": ""
}

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

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

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

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

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

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

Один запрос с кодом ответа 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/dbw/orders/{orderId}/meta/uin }}

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

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

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

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

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

Один запрос с кодом ответа 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/dbw/orders/{orderId}/meta/imei }}

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

Метод обновляет IMEI в метаданных сборочного задания.

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

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

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

Один запрос с кодом ответа 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/dbw/orders/{orderId}/meta/gtin }}

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

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

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

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

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

Один запрос с кодом ответа 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": ""
}