Получение списка заказов

POST /v1/order/dbs/list

POST/v1/order/dbs/list

Тело запроса

filter
object
Фильтр. Если поле фильтра не передано, равно null или передан пустой массив [], фильтрация по этому полю не применяется. При одновременном указании нескольких фильтров условия объединяются по AND.
Показать свойства
status
array
Фильтр по статусам заказа (опционально).
Статусы доставки заказа. - NEW: Новый. - CONFIRMED: Подтверждён. - PACKED: Упакован. - DELIVERING: Доставляется. - READY_FOR_PICKUP: Готов к выдаче на ПВЗ. - DELIVERED: Доставлен. - CANCELLED: Отменён.
merchant_order_id
array
Фильтр по идентификаторам заказов продавца (опционально).
since
string
Начало периода по дате создания. Формат: date-time (RFC3339, опционально). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
to
string
Конец периода по дате создания. Формат: date-time (RFC3339, опционально). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
cursor
string
Курсор начала отсчёта.
limit
integer
Размер страницы. min = 1; max = 300; default = 100.

Успешный ответ

200A successful response.
application/json
object
orders
array
Элементы списка. Заказы с недоступными или несуществующими merchant_order_id в ответ не возвращаются.
Draft-вариант DBS one item / one order: в заказе один товар, поэтому поля товара возвращаются на верхнем уровне элемента orders[] (без вложенного объекта product и без массива products). Идентификаторы offer_id и product_id используются с приоритезацией. Если заполнены оба идентификатора, то используется только offer_id.
Показать свойства
merchant_order_id
string
required
Идентификатор заказа продавца.
client_order_id
string
required
Идентификатор заказа клиента.
location_id
string
required
ID склада продавца, на который поступило сборочное задание.
status
string
required
Статус заказа (доставки).
Допустимые значения
NEWCONFIRMEDPACKEDDELIVERINGREADY_FOR_PICKUPDELIVEREDCANCELLED
actions
array
Разрешённые действия по заказу для установленного статуса.
Разрешённое действие по заказу для установленного статуса.
Показать свойства
type
string
required
Тип действия.
Допустимые значения
cancel
enabled
boolean
required
Доступность действия.
handover_code
string
Код вручения заказа.
customer
object
required
Данные о покупателе.
Показать свойства
customer_id
integer
Идентификатор покупателя.
name
string
Имя покупателя.
phone
string
Контактный телефон покупателя.
delivery
object
required
Параметры доставки или выдачи в ПВЗ.
Показать свойства
delivery_type
string
required
Тип доставки или выдачи. - COURIER: доставка курьером — обязателен address_tail. - PICKUP_POINT: доставка в пункт выдачи. - CLICK_AND_COLLECT: самовывоз (Click & Collect).
Допустимые значения
COURIERPICKUP_POINTCLICK_AND_COLLECT
address_tail
string
Адрес в текстовом формате. Обязателен при delivery_type = COURIER. Формат: «196653, Россия, г. Санкт-Петербург, г. Колпино, ул. Октябрьская, д. 77/27, подъезд 1, этаж 3, кв. 12».
comment
string
Комментарий к доставке или адресу.
latitude
number
Широта.
provider_location_id
string
Идентификатор локации у провайдера доставки.
longitude
number
Долгота.
item_type
string
Тип позиции заказа. PRODUCT — товар, SERVICE — услуга из общего каталога товаров.
Допустимые значения
PRODUCTSERVICE
product_id
string
required
Идентификатор товара в системе маркетплейса.
offer_id
string
required
Идентификатор товара в системе продавца — артикул.
linked_merchant_order_ids
array
Массив идентификаторов merchant_order_id с товарами, к которым относится услуга. Заполняется для SERVICE, если услуга была выбрана к конкретным товарам (опционально).
product_name
string
required
Название товара.
prices
array
required
Цены товара.
OrderListLinePrice
Показать свойства
OrderListLinePrice
price_type
string
Тип цены.
Допустимые значения
CUSTOMER_PRICECUSTOMER_FINAL_PRICEMERCHANT_PRICEMERCHANT_FINAL_PRICE
value
integer
Значение цены, умноженное на 100.
currency_code
string
Валюта.
Допустимые значения
RUBBYNKZTEURUSDCNY
vat
string
НДС (опционально). - VAT_0: Ставка НДС 0%. - VAT_5: Ставка НДС 5%. - VAT_7: Ставка НДС 7%. - VAT_10: Ставка НДС 10%. - VAT_22: Ставка НДС 22%. - NO_VAT: Без НДС.
Допустимые значения
VAT_0VAT_5VAT_7VAT_10VAT_22NO_VAT
exemplar
object
Информация об экземпляре товара.
Показать свойства
exemplar_id
string
Идентификатор экземпляра.
gtd
string
Номер грузовой таможенной декларации (ГТД).
marks
array
Контрольные знаки и другие маркировки.
OrderExemplarMark
Показать свойства
OrderExemplarMark
mark
string
Значение кода маркировки.
mark_type
string
Тип маркировки: mandatory_mark, jw_uin, imei.
rnpt
string
Регистрационный номер партии товара (РНПТ).
weight
number
Фактический вес экземпляра (опционально), кг.
requirements
object
Требования к товарам для смены статуса.
Показать свойства
requires_change_country
boolean
Требуется изменить страну-изготовитель.
requires_gtd
boolean
Требуется передать номер ГТД.
requires_country
boolean
Требуется передать страну-изготовителя.
requires_mandatory_mark
boolean
Требуется маркировка «Честный знак».
requires_jw_uin
boolean
Требуется УИН ювелирного изделия.
requires_rnpt
boolean
Требуется РНПТ.
requires_weight
boolean
Требуется передать вес.
requires_imei
boolean
Требуется передать IMEI.
prr_option
string
Код услуги ПРР: lift, stairs, none, delivery_default (опционально).
status_history
array
История статусов заказа.
OrderStatusHistory
Показать свойства
OrderStatusHistory
changed_by
string
Инициатор изменения.
Допустимые значения
MERCHANTCLIENTMARKET
changed_at
string
Время изменения (date-time, RFC3339). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
status
string
Статус заказа (доставки).
Допустимые значения
NEWCONFIRMEDPACKEDDELIVERINGREADY_FOR_PICKUPDELIVEREDCANCELLED
comment
string
Описание причины изменения.
delivery_date_history
array
История изменения даты доставки.
OrderDeliveryDateHistory
Показать свойства
OrderDeliveryDateHistory
changed_by
string
Инициатор.
Допустимые значения
MERCHANTCLIENTMARKET
changed_at
string
Когда менял (date-time, RFC3339). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
delivery_date_begin
string
Дата и время начала доставки (date-time, RFC3339). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
delivery_date_end
string
Ожидаемая дата доставки (date-time, RFC3339). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
comment
string
Описание причины изменения.
delivery_date
object
required
Слот доставки: дата и время начала и окончания.
Показать свойства
delivery_date_begin
string
Дата и время начала доставки (date-time, RFC3339). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
delivery_date_end
string
Ожидаемая дата доставки (date-time, RFC3339). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
created_at
string
required
Дата и время создания заказа (date-time, RFC3339). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
next_cursor
string
Курсор начала отсчёта.
total
integer
Общее количество записей.

Ошибки

400Некорректный запрос
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
401Ошибка авторизации
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
429Превышен лимит запросов
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
500Внутренняя ошибка сервера
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
defaultОшибка (неожиданная или прочие)
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
POST/v1/order/dbs/list
1curl https://api.omninet.ru/v1/order/dbs/list \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "filter": {6    "status": [7      "NEW"8    ],9    "merchant_order_id": [10      "string"11    ],12    "since": "2026-07-02T10:25:00+02:00",13    "to": "2026-07-02T10:25:00+02:00"14  },15  "cursor": "string",16  "limit": 017}'
{
  "orders": [
    {
      "merchant_order_id": "string",
      "client_order_id": "string",
      "location_id": "string",
      "status": "NEW",
      "actions": [
        {
          "type": "cancel",
          "enabled": true
        }
      ],
      "handover_code": "string",
      "customer": {
        "customer_id": 0,
        "name": "string",
        "phone": "string"
      },
      "delivery": {
        "delivery_type": "string",
        "address_tail": "string",
        "comment": "string",
        "latitude": 0,
        "provider_location_id": "string",
        "longitude": 0
      },
      "item_type": "string",
      "product_id": "string",
      "offer_id": "string",
      "linked_merchant_order_ids": [
        "string"
      ],
      "product_name": "string",
      "prices": [
        {
          "price_type": "CUSTOMER_PRICE",
          "value": 0,
          "currency_code": "RUB",
          "vat": "string"
        }
      ],
      "exemplar": {
        "exemplar_id": "string",
        "gtd": "string",
        "marks": [
          {
            "mark": "string",
            "mark_type": "string"
          }
        ],
        "rnpt": "string",
        "weight": 0
      },
      "requirements": {
        "requires_change_country": true,
        "requires_gtd": true,
        "requires_country": true,
        "requires_mandatory_mark": true,
        "requires_jw_uin": true,
        "requires_rnpt": true,
        "requires_weight": true,
        "requires_imei": true
      },
      "prr_option": "string",
      "status_history": [
        {
          "changed_by": "MERCHANT",
          "changed_at": "2026-07-02T10:25:00+02:00",
          "status": "NEW",
          "comment": "string"
        }
      ],
      "delivery_date_history": [
        {
          "changed_by": "MERCHANT",
          "changed_at": "2026-07-02T10:25:00+02:00",
          "delivery_date_begin": "2026-07-02T10:25:00+02:00",
          "delivery_date_end": "2026-07-02T10:25:00+02:00",
          "comment": "string"
        }
      ],
      "delivery_date": {
        "delivery_date_begin": "2026-07-02T10:25:00+02:00",
        "delivery_date_end": "2026-07-02T10:25:00+02:00"
      },
      "created_at": "2026-07-02T10:25:00+02:00"
    }
  ],
  "next_cursor": "string",
  "total": 0
}

A successful response.