Заказы DBS (order)
Управление сборочными заданиями и метаданными заказов DBS (Delivery by Seller).
Управление сборочными заданиями и метаданными заказов DBS (Delivery by Seller).
Для работы со сборочными заданиями DBS:
- Получите новое сборочное задание и сохраните его до перевода на сборку. Если вы не сохраните информацию о сборочном задании заранее, вы сможете получить ее только после завершения задания (отмены или продажи). Проверяйте дату и время доставки.
- Переведите его на сборку.
- После перевода на сборку для заказа становится доступной информация о покупателе (имя, телефон).
- Переведите в доставку.
- После доставки задания покупателю вам необходимо сообщить на наш сервер, что сборочное задание принято покупателем или, что покупатель отказался от сборочного задания.
Получить список новых сборочных заданий{{ /api/v3/dbs/orders/new }}
Метод возвращает список всех новых сборочных заданий, которые есть у продавца на момент запроса.
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 300 запросов | 200 мс | 20 запросов |
Authorizations:
Responses
Response samples
- 200
- 401
- 403
- 429
{- "orders": [
- {
- "salePrice": 504658,
- "requiredMeta": [
- "uin"
], - "comment": "Упакуйте в пленку, пожалуйста",
- "options": {
- "isB2b": true
}, - "address": {
- "fullAddress": "Челябинская область, г. Челябинск, 51-я улица Арабкира, д. 10А, кв. 42",
- "longitude": 44.519068,
- "latitude": 40.20192
}, - "orderUid": "165918930_629fbc924b984618a44354475ca58675",
- "groupId": "7a2c8810-1db2-4011-9682-5c7fa33afd83",
- "article": "one-ring-7548",
- "colorCode": "RAL 3017",
- "rid": "f884001e44e511edb8780242ac120002",
- "createdAt": "2022-05-04T07:56:29Z",
- "deliveryType": "dbs",
- "skus": [
- "6665956397512"
], - "id": 13833711,
- "warehouseId": 658434,
- "nmId": 123456789,
- "chrtId": 987654321,
- "price": 1014,
- "finalPrice": 1014,
- "convertedFinalPrice": 1014,
- "convertedPrice": 1014,
- "currencyCode": 643,
- "convertedCurrencyCode": 643,
- "cargoType": 1,
- "isZeroOrder": false
}
]
}Получить информацию о завершенных сборочных заданиях{{ /api/v3/dbs/orders }}
Метод возвращает информацию о завершенных сборочных заданиях после продажи или отмены заказа.
Можно получить данные за заданный период, максимум 30 календарных дней одним запросом.
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 300 запросов | 200 мс | 20 запросов |
Authorizations:
query Parameters
| limit required | integer [ 1 .. 1000 ] Параметр пагинации. Устанавливает предельное количество возвращаемых данных. |
| next required | integer <int64> Параметр пагинации. Устанавливает значение, с которого надо получить следующий пакет данных. Для получения полного списка данных должен быть равен |
| dateFrom required | integer Дата начала периода в формате Unix timestamp |
| dateTo required | integer Дата конца периода в формате Unix timestamp |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "next": 13833711,
- "orders": [
- {
- "address": {
- "fullAddress": "Челябинская область, г. Челябинск, 51-я улица Арабкира, д. 10А, кв. 42",
- "longitude": 44.519068,
- "latitude": 40.20192
}, - "deliveryType": "string",
- "options": {
- "isB2b": true
}, - "orderUid": "165918930_629fbc924b984618a44354475ca58675",
- "groupId": "7a2c8810-1db2-4011-9682-5c7fa33afd83",
- "article": "one-ring-7548",
- "colorCode": "RAL 3017",
- "rid": "f884001e44e511edb8780242ac120002",
- "createdAt": "2022-05-04T07:56:29Z",
- "skus": [
- "6665956397512"
], - "id": 13833711,
- "warehouseId": 658434,
- "nmId": 12345678,
- "chrtId": 987654321,
- "price": 1014,
- "convertedPrice": 1014,
- "currencyCode": 643,
- "convertedCurrencyCode": 643,
- "convertedFinalPrice": 1014,
- "finalPrice": 1014,
- "cargoType": 1,
- "comment": "Упакуйте в пленку, пожалуйста",
- "isZeroOrder": false
}
]
}Получить информацию о платной доставке{{ /api/v3/dbs/groups/info }}
Метод возвращает информацию о платной доставке сборочных заданий, которые поступили на один склад (warehouseId) в рамках одной транзакции покупателя (orderUid).
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 300 запросов | 200 мс | 20 запросов |
Один запрос с кодом ответа 409 учитывается как 10 запросов
Authorizations:
Request Body schema: application/jsonrequired
| groups | Array of strings <= 1000 items Список значений |
Responses
Request samples
- Payload
{- "groups": [
- "7a2c8810-1db2-4011-9682-5c7fa33afd83",
- "5a8f4523-4cf2-5691-9682-5a7fd33afd73"
]
}Response samples
- 200
- 400
- 401
- 403
- 429
[- {
- "groupID": "0596a30a-d11c-4210-a231-ee1c39d61fe4",
- "deliveryCost": 1108,
- "convertedDeliveryCost": 29803,
- "currencyCode": 933,
- "convertedCurrencyCode": 643
}
]Информация о покупателе{{ /api/v3/dbs/orders/client }}
Метод возвращает информацию о покупателе по ID сборочных заданий.
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 300 запросов | 200 мс | 20 запросов |
Один запрос с кодом ответа 409 учитывается как 10 запросов
Authorizations:
Request Body schema: application/jsonrequired
| orders | Array of integers Список ID сборочных заданий |
Responses
Request samples
- Payload
{- "orders": [
- 987654321,
- 123456789
]
}Response samples
- 200
- 400
- 401
- 403
- 404
- 429
{- "orders": [
- {
- "replacementPhone": "79871234567",
- "firstName": "string",
- "fullName": "Иван Иван Иванович",
- "orderID": 134567,
- "phone": "+79871234567",
- "phoneCode": 1234567,
- "additionalPhoneCodes": [
- "12345",
- "65498"
]
}
]
}Информация о покупателе B2B{{ /api/marketplace/v3/dbs/orders/b2b/info }}
Метод возвращает данные B2B-покупателей по ID сборочных заданий:
- ИНН
- КПП
- Наименование организации
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 300 запросов | 200 мс | 20 запросов |
Authorizations:
Request Body schema: application/jsonrequired
| ordersIds | Array of integers <= 1000 items Список ID сборочных заданий |
Responses
Request samples
- Payload
{- "ordersIds": [
- 123456,
- 234567
]
}Response samples
- 200
- 400
- 401
- 403
- 429
{- "requestId": "03615778-eb9e-4f55-b4O4-fd3ac0fad2сc",
- "results": [
- {
- "orderId": 4299281547,
- "isError": true,
- "errors": [
- {
- "code": 404,
- "detail": "NotFound"
}
]
}, - {
- "orderId": 4279781545,
- "isError": false,
- "data": {
- "orgName": "ИП Иванов И.И.",
- "inn": "8888888888",
- "kpp": ""
}
}
]
}Дата и время доставки{{ /api/v3/dbs/orders/delivery-date }}
Метод возвращает информацию о выбранных покупателем дате и времени доставки сборочных заданий.
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 300 запросов | 200 мс | 20 запросов |
Authorizations:
Request Body schema: application/jsonrequired
| orders | Array of integers[ items [ 1 .. 1000 ] items ] Список ID сборочных заданий |
Responses
Request samples
- Payload
{- "orders": [
- 1234567890
]
}Response samples
- 200
- 400
- 401
- 403
- 429
{- "orders": [
- {
- "dTimeFrom": "11:11",
- "dTimeTo": "22:22",
- "dTimeFromOld": "12:30",
- "dTimeToOld": "22:30",
- "dDateOld": "2025-01-28",
- "dDate": "2025-02-20",
- "id": 1234567890
}
]
}Получить статусы сборочных заданий{{ /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— отмена по причине недозвона
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 300 запросов | 200 мс | 20 запросов |
Authorizations:
Request Body schema: application/json
| ordersIds | Array of integers <= 1000 items Список ID сборочных заданий |
Responses
Request samples
- Payload
{- "ordersIds": [
- 123456,
- 234567
]
}Response samples
- 200
- 400
- 401
- 403
- 404
- 429
{- "orders": [
- {
- "supplierStatus": "confirm",
- "wbStatus": "waiting",
- "errors": [ ],
- "orderId": 123456
}, - {
- "supplierStatus": "",
- "wbStatus": "",
- "errors": [
- {
- "code": 404,
- "detail": "NotFound"
}
], - "orderId": 789012
}
]
}Отменить сборочные задания{{ /api/marketplace/v3/dbs/orders/status/cancel }}
Метод переводит сборочные задания из статусов new, confirm и deliver в статус cancel — отменено продавцом.
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 сек | 1 запрос | 1 сек | 10 запросов |
Один запрос с кодом ответа 409 учитывается как 10 запросов
Authorizations:
Request Body schema: application/json
| ordersIds | Array of integers <= 1000 items Список ID сборочных заданий |
Responses
Request samples
- Payload
{- "ordersIds": [
- 123456,
- 234567
]
}Response samples
- 200
- 400
- 401
- 403
- 429
{- "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
- "results": [
- {
- "orderId": 4299281547,
- "isError": true,
- "errors": [
- {
- "code": 404,
- "detail": "NotFound"
}
]
}, - {
- "orderId": 4279781545,
- "isError": false
}
]
}Перевести сборочные задания на сборку{{ /api/marketplace/v3/dbs/orders/status/confirm }}
Метод переводит сборочные задания из статуса new в статус confirm — на сборке.
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 сек | 1 запрос | 1 сек | 10 запросов |
Один запрос с кодом ответа 409 учитывается как 10 запросов
Authorizations:
Request Body schema: application/json
| ordersIds | Array of integers <= 1000 items Список ID сборочных заданий |
Responses
Request samples
- Payload
{- "ordersIds": [
- 123456,
- 234567
]
}Response samples
- 200
- 400
- 401
- 403
- 429
{- "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
- "results": [
- {
- "orderId": 4299281547,
- "isError": true,
- "errors": [
- {
- "code": 404,
- "detail": "NotFound"
}
]
}, - {
- "orderId": 4279781545,
- "isError": false
}
]
}Перевести сборочные задания в доставку{{ /api/marketplace/v3/dbs/orders/status/deliver }}
Метод переводит сборочные задания из статуса confirm в статус deliver — в доставке.
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 сек | 1 запрос | 1 сек | 10 запросов |
Один запрос с кодом ответа 409 учитывается как 10 запросов
Authorizations:
Request Body schema: application/json
| ordersIds | Array of integers <= 1000 items Список ID сборочных заданий |
Responses
Request samples
- Payload
{- "ordersIds": [
- 123456,
- 234567
]
}Response samples
- 200
- 400
- 401
- 403
- 429
{- "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
- "results": [
- {
- "orderId": 4299281547,
- "isError": true,
- "errors": [
- {
- "code": 404,
- "detail": "NotFound"
}
]
}, - {
- "orderId": 4279781545,
- "isError": false
}
]
}Сообщить о получении заказов{{ /api/marketplace/v3/dbs/orders/status/receive }}
Метод переводит сборочные задания из статуса deliver в статус receive — получено покупателем.
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 сек | 1 запрос | 1 сек | 10 запросов |
Один запрос с кодом ответа 409 учитывается как 10 запросов
Authorizations:
Request Body schema: application/json
required | Array of objects (api.OrderCodeRequest) <= 1000 items |
Responses
Request samples
- Payload
{- "orders": [
- {
- "code": "741852",
- "orderId": 123456
}
]
}Response samples
- 200
- 400
- 401
- 403
- 429
{- "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
- "results": [
- {
- "orderId": 4299281547,
- "isError": true,
- "errors": [
- {
- "code": 404,
- "detail": "NotFound"
}
]
}, - {
- "orderId": 4279781545,
- "isError": false
}
]
}Сообщить об отказе от заказов{{ /api/marketplace/v3/dbs/orders/status/reject }}
Метод переводит сборочные задания из статуса deliver в статус reject — отказ покупателя при получении.
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 сек | 1 запрос | 1 сек | 10 запросов |
Один запрос с кодом ответа 409 учитывается как 10 запросов
Authorizations:
Request Body schema: application/json
required | Array of objects (api.OrderCodeRequest) <= 1000 items |
Responses
Request samples
- Payload
{- "orders": [
- {
- "code": "741852",
- "orderId": 123456
}
]
}Response samples
- 200
- 400
- 401
- 403
- 429
{- "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
- "results": [
- {
- "orderId": 4299281547,
- "isError": true,
- "errors": [
- {
- "code": 404,
- "detail": "NotFound"
}
]
}, - {
- "orderId": 4279781545,
- "isError": false
}
]
}Получить статусы сборочных заданий{{ /api/v3/dbs/orders/status }} Deprecated
Данный метод устарел. Он будет удалён 13 апреля
Authorizations:
Request Body schema: application/json
| orders required | Array of integers <int64> [ 1 .. 1000 ] items [ items <int64 > ] Список ID сборочных заданий |
Responses
Request samples
- Payload
{- "orders": [
- 5632423
]
}Response samples
- 200
- 400
- 401
- 403
- 429
{- "orders": [
- {
- "id": 5632423,
- "supplierStatus": "new",
- "wbStatus": "string"
}
]
}Отменить сборочное задание{{ /api/v3/dbs/orders/{orderId}/cancel }} Deprecated
Данный метод устарел. Он будет удалён 13 апреля
Authorizations:
path Parameters
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
Responses
Response samples
- 400
- 401
- 403
- 404
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}Перевести на сборку{{ /api/v3/dbs/orders/{orderId}/confirm }} Deprecated
Данный метод устарел. Он будет удалён 13 апреля
Authorizations:
path Parameters
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
Responses
Response samples
- 400
- 401
- 403
- 404
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}Перевести в доставку{{ /api/v3/dbs/orders/{orderId}/deliver }} Deprecated
Данный метод устарел. Он будет удалён 13 апреля
Authorizations:
path Parameters
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
Responses
Response samples
- 400
- 401
- 403
- 404
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}Сообщить, что заказ принят покупателем{{ /api/v3/dbs/orders/{orderId}/receive }} Deprecated
Данный метод устарел. Он будет удалён 13 апреля
Authorizations:
path Parameters
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
Request Body schema: application/jsonrequired
| code | string Код подтверждения. |
Responses
Request samples
- Payload
{- "code": "123456"
}Response samples
- 400
- 401
- 403
- 404
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}Сообщить, что покупатель отказался от заказа{{ /api/v3/dbs/orders/{orderId}/reject }} Deprecated
Данный метод устарел. Он будет удалён 13 апреля
Authorizations:
path Parameters
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
Request Body schema: application/jsonrequired
| code | string Код подтверждения. |
Responses
Request samples
- Payload
{- "code": "123456"
}Response samples
- 400
- 401
- 403
- 404
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}С помощью этих методов вы можете получать, удалять и редактировать метаданные сборочных заданий:
Получить метаданные сборочных заданий{{ /api/marketplace/v3/dbs/orders/meta/info }}
Метод возвращает метаданные сборочных заданий.
Перечень метаданных, доступных для сборочного задания, можно получить в списке новых сборочных заданий, поле requiredMeta.
Возможные метаданные:
imei— IMEIuin— УИНgtin— GTINsgtin— код маркировкиcustomsDeclaration— номер ГТД
Если ответ вернулся с пустой структурой meta, значит у сборочного задания нет метаданных и добавить их нельзя.
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 150 запросов | 400 мс | 20 запросов |
Один запрос с кодом ответа 409 учитывается как 10 запросов
Authorizations:
Request Body schema: application/json
| ordersIds | Array of integers <= 1000 items Список ID сборочных заданий |
Responses
Request samples
- Payload
{- "ordersIds": [
- 123456,
- 234567
]
}Response samples
- 200
- 400
- 401
- 403
- 429
{- "meta": [
- {
- "error": "",
- "gtin": "123456789012345",
- "imei": "123456789012345",
- "orderId": 654321,
- "sgtin": [
- "123456789012345"
], - "uin": "123456789012345",
- "customsDeclaration": {
- "value": "10704010/010624/0000302"
}
}
]
}Удалить метаданные сборочных заданий{{ /api/marketplace/v3/dbs/orders/meta/delete }}
Метод удаляет значение указанных метаданных для нескольких сборочных заданий.
В одном запросе можно удалить метаданные только одного типа. Укажите тип метаданных в запросе:
imei— IMEIuin— УИНgtin— GTINsgtin— код маркировкиcustomsDeclaration— номер ГТД
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 150 запросов | 400 мс | 20 запросов |
Один запрос с кодом ответа 409 учитывается как 10 запросов
Authorizations:
Request Body schema: application/json
| key required | string Название метаданных для удаления (imei, uin, gtin, sgtin). Передаётся только одно значение |
| orderIds required | Array of integers <= 1000 items Список ID сборочных заданий |
Responses
Request samples
- Payload
{- "key": "imei",
- "orderIds": [
- 123456,
- 234567
]
}Response samples
- 200
- 400
- 401
- 403
- 409
- 429
{- "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
- "results": [
- {
- "orderId": 4299281547,
- "isError": true,
- "errors": [
- {
- "code": 404,
- "detail": "NotFound"
}
]
}, - {
- "orderId": 4279781545,
- "isError": false
}
]
}Закрепить коды маркировки за сборочными заданиями{{ /api/marketplace/v3/dbs/orders/meta/sgtin }}
Метод обновляет код маркировки Честный знак в метаданных нескольких сборочных заданий.
Закрепить код маркировки можно, только если в метаданных сборочного задания есть поле sgtin, а сборочное задание находится в статусе confirm.
Получить загруженные маркировки можно в метаданных сборочного задания.
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 500 запросов | 120 мс | 20 запросов |
Один запрос с кодом ответа 409 учитывается как 10 запросов
Authorizations:
Request Body schema: application/json
required | Array of objects (api.SGTINs) <= 1000 items |
Responses
Request samples
- Payload
{- "orders": [
- {
- "orderId": 123456,
- "sgtins": [
- "123456789012345678",
- "1234567890123456"
]
}
]
}Response samples
- 200
- 400
- 401
- 403
- 409
- 429
{- "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
- "results": [
- {
- "orderId": 4299281547,
- "isError": true,
- "errors": [
- {
- "code": 404,
- "detail": "NotFound"
}
]
}, - {
- "orderId": 4279781545,
- "isError": false
}
]
}Закрепить УИН за сборочными заданиями{{ /api/marketplace/v3/dbs/orders/meta/uin }}
Метод обновляет УИН, уникальный идентификационный номер, в метаданных сборочных заданий.
У одного сборочного задания может быть только один УИН.
Добавлять УИН можно только для сборочных заданий, которые доставляются WB и находятся в статусе confirm.
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 500 запросов | 120 мс | 20 запросов |
Один запрос с кодом ответа 409 учитывается как 10 запросов
Authorizations:
Request Body schema: application/json
required | Array of objects (api.UIN) <= 1000 items |
Responses
Request samples
- Payload
{- "orders": [
- {
- "orderId": 123456,
- "uin": "1234568909091232"
}
]
}Response samples
- 200
- 400
- 401
- 403
- 409
- 429
{- "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
- "results": [
- {
- "orderId": 4299281547,
- "isError": true,
- "errors": [
- {
- "code": 404,
- "detail": "NotFound"
}
]
}, - {
- "orderId": 4279781545,
- "isError": false
}
]
}Закрепить IMEI за сборочными заданиями{{ /api/marketplace/v3/dbs/orders/meta/imei }}
Метод обновляет IMEI в метаданных нескольких сборочных заданий.
У одного сборочного задания может быть только один IMEI.
Добавлять IMEI можно только для сборочных заданий, которые доставляются WB и находятся в статусе confirm.
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 500 запросов | 120 мс | 20 запросов |
Один запрос с кодом ответа 409 учитывается как 10 запросов
Authorizations:
Request Body schema: application/json
required | Array of objects (api.IMEI) <= 1000 items |
Responses
Request samples
- Payload
{- "orders": [
- {
- "orderId": 123456,
- "imei": "654321741987258"
}
]
}Response samples
- 200
- 400
- 401
- 403
- 409
- 429
{- "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
- "results": [
- {
- "orderId": 4299281547,
- "isError": true,
- "errors": [
- {
- "code": 404,
- "detail": "NotFound"
}
]
}, - {
- "orderId": 4279781545,
- "isError": false
}
]
}Закрепить GTIN за сборочными заданиями{{ /api/marketplace/v3/dbs/orders/meta/gtin }}
Метод обновляет GTIN, уникальный ID товара в Беларуси, в метаданных нескольких сборочных заданий.
У одного сборочного задания может быть только один GTIN.
Добавлять GTIN можно только для сборочных заданий, которые доставляются WB и находятся в статусе confirm.
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 500 запросов | 120 мс | 20 запросов |
Один запрос с кодом ответа 409 учитывается как 10 запросов
Authorizations:
Request Body schema: application/json
required | Array of objects (api.GTIN) <= 1000 items |
Responses
Request samples
- Payload
{- "orders": [
- {
- "gtin": "1234567890123",
- "orderId": 123456
}
]
}Response samples
- 200
- 400
- 401
- 403
- 409
- 429
{- "requestId": "03615778-eb9e-4f55-b4Of-fd3ac0fad2сc",
- "results": [
- {
- "orderId": 4299281547,
- "isError": true,
- "errors": [
- {
- "code": 404,
- "detail": "NotFound"
}
]
}, - {
- "orderId": 4279781545,
- "isError": false
}
]
}Закрепить за сборочными заданиями номер ГТД{{ /api/marketplace/v3/dbs/orders/meta/customs-declaration }}
Метод обновляет номер ГТД — грузовой таможенной декларации — в метаданных сборочных заданий.
У одного сборочного задания может быть только один ГТД.
Добавлять номер ГТД можно только для сборочных заданий, которые находятся в статусе deliver.
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 500 запросов | 120 мс | 20 запросов |
Один запрос с кодом ответа 409 учитывается как 10 запросов
Authorizations:
Request Body schema: application/json
Array of objects <= 1000 items |
Responses
Request samples
- Payload
{- "orders": [
- {
- "customsDeclaration": "10704010/010624/0000302",
- "orderId": 0
}
]
}Response samples
- 400
- 401
- 403
- 404
- 409
- 429
Некорректное тело запроса
{- "code": "IncorrectRequestBody",
- "message": "Некорректное тело запроса"
}Получить метаданные сборочного задания{{ /api/v3/dbs/orders/{orderId}/meta }} Deprecated
Данный метод устарел. Он будет удалён 13 апреля
Authorizations:
path Parameters
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
Responses
Response samples
- 200
- 401
- 403
- 404
- 429
{- "meta": {
- "imei": {
- "value": "123456789012345"
}, - "uin": {
- "value": "123456789012345"
}, - "gtin": {
- "value": "123456789012345"
}, - "sgtin": {
- "value": [
- "123456789012345"
]
}, - "customsDeclaration": {
- "value": "10704010/010624/0000302"
}
}
}Удалить метаданные сборочного задания{{ /api/v3/dbs/orders/{orderId}/meta }} Deprecated
Данный метод устарел. Он будет удалён 13 апреля
Authorizations:
path Parameters
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
query Parameters
| key | string Название метаданных для удаления (imei, uin, gtin, sgtin). Передаётся только одно значение |
Responses
Response samples
- 400
- 401
- 403
- 409
- 429
{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}Закрепить за сборочным заданием код маркировки товара{{ /api/v3/dbs/orders/{orderId}/meta/sgtin }} Deprecated
Данный метод устарел. Он будет удалён 13 апреля
Authorizations:
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
- Payload
{- "sgtins": [
- "1234567890123456"
]
}Response samples
- 400
- 401
- 403
- 404
- 409
- 429
Некорректное тело запроса
{- "code": "IncorrectRequestBody",
- "message": "Некорректное тело запроса"
}Закрепить за сборочным заданием УИН (уникальный идентификационный номер){{ /api/v3/dbs/orders/{orderId}/meta/uin }} Deprecated
Данный метод устарел. Он будет удалён 13 апреля
Authorizations:
path Parameters
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
Request Body schema: application/json
| uin required | string = 16 characters УИН |
Responses
Request samples
- Payload
{- "uin": "1234567890123456"
}Response samples
- 400
- 401
- 403
- 404
- 409
- 429
Некорректное тело запроса
{- "code": "IncorrectRequestBody",
- "message": "Некорректное тело запроса"
}Закрепить за сборочным заданием IMEI{{ /api/v3/dbs/orders/{orderId}/meta/imei }} Deprecated
Данный метод устарел. Он будет удалён 13 апреля
Authorizations:
path Parameters
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
Request Body schema: application/json
| imei required | string = 15 characters IMEI |
Responses
Request samples
- Payload
{- "imei": "123456789012345"
}Response samples
- 400
- 401
- 403
- 404
- 409
- 429
Некорректное тело запроса
{- "code": "IncorrectRequestBody",
- "message": "Некорректное тело запроса"
}Закрепить за сборочным заданием GTIN{{ /api/v3/dbs/orders/{orderId}/meta/gtin }} Deprecated
Данный метод устарел. Он будет удалён 13 апреля
Authorizations:
path Parameters
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
Request Body schema: application/json
| gtin required | string = 13 characters GTIN |
Responses
Request samples
- Payload
{- "gtin": "1234567890123"
}Response samples
- 400
- 401
- 403
- 404
- 409
- 429
Некорректное тело запроса
{- "code": "IncorrectRequestBody",
- "message": "Некорректное тело запроса"
}