Получение сведений о заказе DBS
POST /v1/billing/dbs/order/get
POST
/v1/billing/dbs/order/getВозвращает сведения о заказе DBS, включённом в отчётный период, включая состав заказа, стоимость товаров, начисления, удержания и связанные финансовые операции.
Тело запроса
merchant_order_ids
array
required Элементы списка. Идентификаторы строк заказа из delivery/shipment fact или состава отчёта. Максимальное количество элементов в одном запросе — 1000. Если в одном запросе передано несколько одинаковых merchant_order_id, при обработке учитывается последняя запись, предыдущие игнорируются.
cursor
string
Курсор следующей страницы, если источник требует постраничную выдачу.
limit
integer
Размер страницы. min = 1; max = 300; default = 100.
Успешный ответ
200DBS-строки заказа и delivery envelope для биллинга. application/json
object
merchant_orders
array
required Элементы списка. Строки заказа с недоступными или несуществующими merchant_order_id в ответ не возвращаются.
Расчётные суммы строки заказа, пригодные для сверки отчёта.
Показать свойстваСкрыть свойства
merchant_order_id
string
required Идентификатор заказа продавца.
client_order_id
string
required Идентификатор заказа клиента.
gross_amount
object
required Сумма строки заказа до удержаний.
Показать свойстваСкрыть свойства
value
integer
required Значение суммы, умноженное на 100.
currency_code
string
required Код валюты в формате ISO-like, ожидаемо
RUB для текущего scope.fees
array
required Удержания витрины по sale line; уже отражены в
net_amount.Удержание или комиссия витрины в закрытом billing fee dictionary.
Показать свойстваСкрыть свойства
fee_type
string
required Закрытый набор fee Seller API. PLATFORM_COMMISSION сюда не входит: это внутренний расчёт биллинга, а не факт витрины.
SALE_COMMISSION: комиссия за продажу.
ACQUIRING_FEE: комиссия эквайринга.
DELIVERY_COMMISSION: комиссия за доставку.
SHIPMENT_COMMISSION: комиссия за отгрузку.
RETURN_COMMISSION: комиссия за возврат.
REFUND_FEE: комиссия за обработку возврата.
Допустимые значения
SALE_COMMISSIONACQUIRING_FEEDELIVERY_COMMISSIONSHIPMENT_COMMISSIONRETURN_COMMISSIONREFUND_FEE
amount
object
required Сумма удержания или комиссии.
Показать свойстваСкрыть свойства
value
integer
required Значение суммы, умноженное на 100.
currency_code
string
required Код валюты в формате ISO-like, ожидаемо
RUB для текущего scope.net_amount
object
required Итоговая сумма строки заказа после удержаний.
Показать свойстваСкрыть свойства
value
integer
required Значение суммы, умноженное на 100.
currency_code
string
required Код валюты в формате ISO-like, ожидаемо
RUB для текущего scope.status
string
required Статус заказа (доставки).
Допустимые значения
NEWCONFIRMEDPACKEDDELIVERINGREADY_FOR_PICKUPDELIVEREDCANCELLED
status_changed_at
string
required Переход в терминальный статус, по которому строка попадает в период. Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам со сверкой.
deliveries
array
required Элементы списка. Информация о доставке с недоступными или несуществующими merchant_order_id в ответ не возвращается.
DBS delivery envelope вокруг связанных sale lines. Из-за отсутствия
отдельного
delivery_id identity строится из состава merchant_order_ids[].
Показать свойстваСкрыть свойства
client_order_id
string
required Идентификатор заказа клиента.
merchant_order_ids
array
required Полный состав sale lines в delivery envelope.
gross_amount
object
required Сумма строки заказа до удержаний.
Показать свойстваСкрыть свойства
value
integer
required Значение суммы, умноженное на 100.
currency_code
string
required Код валюты в формате ISO-like, ожидаемо
RUB для текущего scope.fees
array
required Удержания витрины по delivery envelope.
Удержание или комиссия витрины в закрытом billing fee dictionary.
Показать свойстваСкрыть свойства
fee_type
string
required Закрытый набор fee Seller API. PLATFORM_COMMISSION сюда не входит: это внутренний расчёт биллинга, а не факт витрины.
SALE_COMMISSION: комиссия за продажу.
ACQUIRING_FEE: комиссия эквайринга.
DELIVERY_COMMISSION: комиссия за доставку.
SHIPMENT_COMMISSION: комиссия за отгрузку.
RETURN_COMMISSION: комиссия за возврат.
REFUND_FEE: комиссия за обработку возврата.
Допустимые значения
SALE_COMMISSIONACQUIRING_FEEDELIVERY_COMMISSIONSHIPMENT_COMMISSIONRETURN_COMMISSIONREFUND_FEE
amount
object
required Сумма удержания или комиссии.
Показать свойстваСкрыть свойства
value
integer
required Значение суммы, умноженное на 100.
currency_code
string
required Код валюты в формате ISO-like, ожидаемо
RUB для текущего scope.net_amount
object
required Итоговая сумма строки заказа после удержаний.
Показать свойстваСкрыть свойства
value
integer
required Значение суммы, умноженное на 100.
currency_code
string
required Код валюты в формате ISO-like, ожидаемо
RUB для текущего scope.status
string
required Статус заказа (доставки).
Допустимые значения
NEWCONFIRMEDPACKEDDELIVERINGREADY_FOR_PICKUPDELIVEREDCANCELLED
status_changed_at
string
required Переход в терминальный статус, по которому деньги envelope попадают в период. Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам со сверкой.
next_cursor
string
Курсор следующей страницы.
Ошибки
400Некорректный запрос application/json
object
error_type
string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code
string
код ошибки
message
string
сообщение
details
object
401Ошибка авторизации application/json
object
error_type
string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code
string
код ошибки
message
string
сообщение
details
object
429Превышен лимит запросов application/json
object
error_type
string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code
string
код ошибки
message
string
сообщение
details
object
500Внутренняя ошибка сервера application/json
object
error_type
string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code
string
код ошибки
message
string
сообщение
details
object
defaultОшибка (неожиданная или прочие) application/json
object
error_type
string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code
string
код ошибки
message
string
сообщение
details
object
POST/v1/billing/dbs/order/get
1curl https://api.omninet.ru/v1/billing/dbs/order/get \2 --request POST \3 --header 'Content-Type: application/json' \4 --data '{5 "merchant_order_ids": [6 "string"7 ],8 "cursor": "string",9 "limit": 10010}'{
"merchant_orders": [
{
"merchant_order_id": "string",
"client_order_id": "string",
"gross_amount": {
"value": 44350,
"currency_code": "RUB"
},
"fees": [
{
"fee_type": "string",
"amount": {
"value": 44350,
"currency_code": "RUB"
}
}
],
"net_amount": {
"value": 44350,
"currency_code": "RUB"
},
"status": "NEW",
"status_changed_at": "string"
}
],
"deliveries": [
{
"client_order_id": "string",
"merchant_order_ids": [
"string"
],
"gross_amount": {
"value": 44350,
"currency_code": "RUB"
},
"fees": [
{
"fee_type": "string",
"amount": {
"value": 44350,
"currency_code": "RUB"
}
}
],
"net_amount": {
"value": 44350,
"currency_code": "RUB"
},
"status": "NEW",
"status_changed_at": "string"
}
],
"next_cursor": "string"
}DBS-строки заказа и delivery envelope для биллинга.