Поиск
API docs by Redocly

DBS (dbs)

Узнать больше о модели DBS можно в справочном центре

Управление сборочными заданиями и идентификаторами маркировки DBS (Delivery by Seller).

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

DBS

Узнать больше о модели DBS можно в справочном центре

Управление сборочными заданиями и идентификаторами маркировки DBS (Delivery by Seller).

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

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

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

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

  1. Получите новое сборочное задание и сохраните его до перевода на сборку. Если вы не сохраните информацию о сборочном задании заранее, вы сможете получить ее только после завершения задания (отмены или продажи). Проверяйте дату и время доставки.
  2. Переведите его на сборку.
  3. После перевода на сборку для заказа становится доступной информация о покупателе (имя, телефон).
  4. Переведите в доставку.
  5. После доставки задания покупателю вам необходимо сообщить на наш сервер, что сборочное задание принято покупателем или, что покупатель отказался от сборочного задания.

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

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

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

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

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

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

Authorizations:
HeaderApiKey

Responses

Response samples

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

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

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

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

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

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

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

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

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/marketplace/v3/dbs/orders/final-price }}

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

Метод возвращает:

  • цены продавца без учёта скидок
  • суммы к оплате покупателем с учетом всех скидок и кэшбека
Лимит запросов на один профиль продавца для всех методов получения и удаления идентификаторов маркировки DBS:
Период Лимит Интервал Всплеск
1 мин 150 запросов 400 мс 20 запросов

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

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

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

Responses

Request samples

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

Response samples

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

Получить информацию о платной доставке{{ /api/v3/dbs/groups/info }}

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

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

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

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

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

Authorizations:
HeaderApiKey
Request Body schema: application/json
required
groups
Array of strings <= 1000 items

Список значений groupId. Можно получить из новых и завершенных сборочных заданий

Responses

Request samples

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

Response samples

Content type
application/json
[
  • {
    }
]

Информация о покупателе{{ /api/v3/dbs/orders/client }}

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

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

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

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

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

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/dbs/orders/delivery-date }}

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

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

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

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

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

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/marketplace/v3/dbs/orders/status/info }}

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

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

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

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

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



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

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

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

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

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

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

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

Responses

Request samples

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

Response samples

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

Отменить сборочные задания{{ /api/marketplace/v3/dbs/orders/status/cancel }}

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

Метод переводит сборочные задания из статусов new и confirm в статус cancel — отменено продавцом. Отменить сборочные задания в статусе deliver невозможно.

Лимит запросов на один профиль продавца:
Период Лимит Интервал Всплеск
1 сек 1 запрос 1 сек 10 запросов

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

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

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

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

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
  • "results": [
    ]
}

Перевести сборочные задания на сборку{{ /api/marketplace/v3/dbs/orders/status/confirm }}

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

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

Лимит запросов на один профиль продавца:
Период Лимит Интервал Всплеск
1 сек 1 запрос 1 сек 10 запросов

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

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

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

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

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
  • "results": [
    ]
}

Перевести сборочные задания в доставку{{ /api/marketplace/v3/dbs/orders/status/deliver }}

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

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

Лимит запросов на один профиль продавца:
Период Лимит Интервал Всплеск
1 сек 1 запрос 1 сек 10 запросов

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

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

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

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

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
  • "results": [
    ]
}

Сообщить о получении заказов{{ /api/marketplace/v3/dbs/orders/status/receive }}

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

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

Лимит запросов на один профиль продавца:
Период Лимит Интервал Всплеск
1 сек 1 запрос 1 сек 10 запросов

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

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

Authorizations:
HeaderApiKey
Request Body schema: application/json
required
Array of objects <= 1000 items

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
  • "results": [
    ]
}

Сообщить об отказе от заказов{{ /api/marketplace/v3/dbs/orders/status/reject }}

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

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

Лимит запросов на один профиль продавца:
Период Лимит Интервал Всплеск
1 сек 1 запрос 1 сек 10 запросов

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

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

Authorizations:
HeaderApiKey
Request Body schema: application/json
required
Array of objects <= 1000 items

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
  • "results": [
    ]
}

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

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

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

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

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

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

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

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

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

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

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

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

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "requestId": "f1787bd2d1fdс35d6f537316514у4a05",
  • "orders": [
    ]
}

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

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

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

В одном запросе можно удалить идентификаторы маркировки только одного типа. Укажите тип идентификаторов маркировки в запросе:

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

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

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

Authorizations:
HeaderApiKey
Request Body schema: application/json
required
key
required
string
Enum: imei uin gtin sgtin customsDeclaration

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

orderIds
required
Array of integers <= 1000 items

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

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
  • "results": [
    ]
}

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

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

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

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

Лимит запросов на один профиль продавца для всех методов закрепления идентификаторов маркировки DBS:
Тип Период Лимит Интервал Всплеск
Персональный 1 мин 500 запросов 120 мс 20 запросов
Сервисный 1 мин 500 запросов 120 мс 20 запросов
Базовый с секретом 1 мин 500 запросов 120 мс 20 запросов
Базовый 1 ч 10 запросов 6 мин 1 запрос

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

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

Authorizations:
HeaderApiKey
Request Body schema: application/json
required
required
Array of objects <= 1000 items

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
  • "results": [
    ]
}

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

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

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

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

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

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

Authorizations:
HeaderApiKey
Request Body schema: application/json
required
required
Array of objects <= 1000 items

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
  • "results": [
    ]
}

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

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

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

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

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

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

Authorizations:
HeaderApiKey
Request Body schema: application/json
required
required
Array of objects <= 1000 items

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
  • "results": [
    ]
}

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

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

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

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

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

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

Authorizations:
HeaderApiKey
Request Body schema: application/json
required
required
Array of objects <= 1000 items

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
  • "results": [
    ]
}

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

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

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

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

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

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

Authorizations:
HeaderApiKey
Request Body schema: application/json
required
required
Array of objects <= 1000 items

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
  • "results": [
    ]
}