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

MVP

POST /v1/order/dbs/list

POST/v1/order/dbs/list

Получение списка заказов с фильтрацией.

Тело запроса

filter
object
required

Фильтр. Если поле фильтра не передано, равно null или передан пустой массив [], фильтрация по этому полю не применяется. При одновременном указании нескольких фильтров условия объединяются по AND.

Показать свойства
merchant_order_id
array

Фильтр по идентификаторам заказов продавца.

since
string

Фильтрация по дате создания заказа. Формат: date-time (RFC3339) с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.

to
string

Фильтрация по дате создания заказа. Формат: date-time (RFC3339) с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.

status
array

Фильтр по статусам заказа.

NEW: Новый

CONFIRMED: Подтверждён

PACKED: Упакован

DELIVERING: Доставляется

READY_FOR_PICKUP: Готов к выдаче на ПВЗ

DELIVERED: Доставлен

CANCELLED: Отменён

Допустимые значения
NEWCONFIRMEDPACKEDDELIVERINGREADY_FOR_PICKUPDELIVEREDCANCELLED
cursor
string

Курсор начала отсчёта.

limit
integer
required

Размер страницы. min = 1; max = 300; default = 100.

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

200A successful response.
application/json
object
orders
array

Элементы списка.

Если вернулись оба поля product_id и offer_id, приоритетным считается product_id.

Показать свойства
merchant_order_id
string
required

Идентификатор заказа продавца.

client_order_id
string
required

Идентификатор заказа клиента.

location_id
string
required

ID склада продавца, на который поступило сборочное задание.

status
string
required

Статус заказа (доставки).

NEW: Новый

CONFIRMED: Подтверждён

PACKED: Упакован

DELIVERING: Доставляется

READY_FOR_PICKUP: Готов к выдаче на ПВЗ

DELIVERED: Доставлен

CANCELLED: Отменён

Допустимые значения
NEWCONFIRMEDPACKEDDELIVERINGREADY_FOR_PICKUPDELIVEREDCANCELLED
actions
array

Разрешённые действия по заказу для установленного статуса.

Разрешённое действие по заказу для установленного статуса.

Показать свойства
type
string
required

Тип действия.

cancel: отменить заказ

Допустимые значения
cancel
enabled
boolean
required

Доступность действия.

handover_code
string

Код вручения заказа.

customer
object
required

Данные о покупателе.

Показать свойства
customer_id
integer

Идентификатор покупателя.

name
string

Имя покупателя.

phone
string

Контактный телефон покупателя.

email
string

Email покупателя.

recipient
object

Данные о получателе.

Показать свойства
name
string

Имя получателя.

phone
string

Контактный телефон получателя.

email
string

Email получателя.

delivery
object
required

Параметры доставки или выдачи в ПВЗ.

Показать свойства
delivery_type
string
required

Тип доставки или выдачи.

COURIER: доставка курьером — обязателен address_tail

PICKUP_POINT: доставка в пункт выдачи

CLICK_AND_COLLECT: самовывоз (Click & Collect)

  • EXPRESS: срочная курьерская доставка заказа клиенту — обязателен address_tail (аналогично COURIER)
Допустимые значения
COURIERPICKUP_POINTCLICK_AND_COLLECTEXPRESS
address_tail
string

Адрес в текстовом формате. Обязателен при delivery_type = COURIER или EXPRESS. Формат: «196653, Россия, г. Санкт-Петербург, г. Колпино, ул. Октябрьская, д. 77/27, подъезд 1, этаж 3, кв. 12».

comment
string

Комментарий к доставке или адресу.

latitude
number

Широта.

longitude
number

Долгота.

provider_location_id
string

Идентификатор локации у провайдера доставки.

provider_id
string

Идентификатор провайдера доставки.

CDEK: СДЭК

RUSSIAN_POST: Почта России

BOXBERRY: Boxberry

YANDEX: Яндекс Доставка

5POST: 5Post

DPD: DPD

HERMES: Hermes

IML: IML

TOP_DELIVERY: Top Delivery

OZON: Ozon

KSE: КСЕ

STRIZH: Стриж

DL: Деловые Линии

PEK: ПЭК

SBL: Сберлогистика

MVIDEO: М.Видео

Допустимые значения
CDEKRUSSIAN_POSTBOXBERRYYANDEX5POSTDPDHERMESIMLTOP_DELIVERYOZONKSESTRIZHDLPEKSBLMVIDEO
item_type
string

Тип позиции заказа. SERVICE — услуга из общего каталога товаров.

PRODUCT: Товар

SERVICE: Услуга

Допустимые значения
PRODUCTSERVICE
product_id
string

Идентификатор товара в системе маркетплейса.

offer_id
string

Идентификатор товара в системе продавца — артикул.

linked_merchant_order_ids
array

Массив идентификаторов merchant_order_id с товарами, к которым относится услуга. Заполняется для SERVICE, если услуга была выбрана к конкретным товарам.

product_name
string
required

Название товара.

prices
array
required

Цены товара.

OrderListLinePrice

Показать свойства

OrderListLinePrice

price_type
string
required

Тип цены.

CUSTOMER_PRICE: Цена покупателя до скидок в валюте списания

CUSTOMER_FINAL_PRICE: Цена покупателя с учётом скидок, пробивается в итоговом чеке

MERCHANT_PRICE: Цена продавца до скидок в валюте страны продавца

MERCHANT_FINAL_PRICE: Цена продавца с учётом скидок в валюте страны продавца

Допустимые значения
CUSTOMER_PRICECUSTOMER_FINAL_PRICEMERCHANT_PRICEMERCHANT_FINAL_PRICE
value
integer
required

Значение цены, умноженное на 100.

currency_code
string

Валюта.

RUB: Российский рубль

BYN: Белорусский рубль

KZT: Тенге

EUR: Евро

USD: Доллар США

CNY: Юань

Допустимые значения
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
integer

Идентификатор экземпляра.

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

Инициатор изменения.

MERCHANT: Продавец

CLIENT: Покупатель

MARKET: Площадка

Допустимые значения
MERCHANTCLIENTMARKET
changed_at
string

Время изменения (date-time, RFC3339). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.

status
string

Статус заказа (доставки).

NEW: Новый

CONFIRMED: Подтверждён

PACKED: Упакован

DELIVERING: Доставляется

READY_FOR_PICKUP: Готов к выдаче на ПВЗ

DELIVERED: Доставлен

CANCELLED: Отменён

Допустимые значения
NEWCONFIRMEDPACKEDDELIVERINGREADY_FOR_PICKUPDELIVEREDCANCELLED
comment
string

Описание причины изменения.

delivery_date_history
array

История изменения даты доставки.

OrderDeliveryDateHistory

Показать свойства

OrderDeliveryDateHistory

changed_by
string

Инициатор.

MERCHANT: Продавец

CLIENT: Покупатель

MARKET: Площадка

Допустимые значения
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

Класс транспортной ошибки запроса (HTTP 4xx/5xx).

Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.

  • ERROR_TYPE_UNSPECIFIED: не используется
  • ERROR_TYPE_UNAUTHORIZED: HTTP 401
  • ERROR_TYPE_RATE_LIMIT: HTTP 429
  • ERROR_TYPE_INTERNAL: HTTP 500
  • ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string

Машинный код ошибки. Уточняет error_type.

message
string

Человекочитаемое сообщение об ошибке.

details
object
401Ошибка авторизации
application/json
object
error_type
string

Класс транспортной ошибки запроса (HTTP 4xx/5xx).

Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.

  • ERROR_TYPE_UNSPECIFIED: не используется
  • ERROR_TYPE_UNAUTHORIZED: HTTP 401
  • ERROR_TYPE_RATE_LIMIT: HTTP 429
  • ERROR_TYPE_INTERNAL: HTTP 500
  • ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string

Машинный код ошибки. Уточняет error_type.

message
string

Человекочитаемое сообщение об ошибке.

details
object
429Превышен лимит запросов
application/json
object
error_type
string

Класс транспортной ошибки запроса (HTTP 4xx/5xx).

Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.

  • ERROR_TYPE_UNSPECIFIED: не используется
  • ERROR_TYPE_UNAUTHORIZED: HTTP 401
  • ERROR_TYPE_RATE_LIMIT: HTTP 429
  • ERROR_TYPE_INTERNAL: HTTP 500
  • ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string

Машинный код ошибки. Уточняет error_type.

message
string

Человекочитаемое сообщение об ошибке.

details
object
500Внутренняя ошибка сервера
application/json
object
error_type
string

Класс транспортной ошибки запроса (HTTP 4xx/5xx).

Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.

  • ERROR_TYPE_UNSPECIFIED: не используется
  • ERROR_TYPE_UNAUTHORIZED: HTTP 401
  • ERROR_TYPE_RATE_LIMIT: HTTP 429
  • ERROR_TYPE_INTERNAL: HTTP 500
  • ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string

Машинный код ошибки. Уточняет error_type.

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    "merchant_order_id": [7      "string"8    ],9    "since": "2026-07-02T10:25:00+02:00",10    "to": "2026-07-02T10:25:00+02:00",11    "status": [12      "NEW"13    ]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",
        "email": "string"
      },
      "recipient": {
        "name": "Иван",
        "phone": "+79004445566",
        "email": "ivan@example.com"
      },
      "delivery": {
        "delivery_type": "string",
        "address_tail": "string",
        "comment": "string",
        "latitude": 0,
        "longitude": 0,
        "provider_location_id": "string",
        "provider_id": "string"
      },
      "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": 0,
        "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.