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

POST /v1/order/dbs/list

POST/v1/order/dbs/list

Тело запроса

filter

object

required

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

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

merchant_order_id

array

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

since

string

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

string

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

status

array

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

Статусы доставки заказа. - NEW: Новый. - CONFIRMED: Подтверждён. - PACKED: Упакован. - DELIVERING: Доставляется. - READY_FOR_PICKUP: Готов к выдаче на ПВЗ. - DELIVERED: Доставлен. - CANCELLED: Отменён.

cursor

string

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

limit

integer

required

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

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

200A successful response.

application/json

object

orders

array

Элементы списка. Заказы с недоступными или несуществующими merchant_order_id в ответ не возвращаются.

Если вернулись оба поля product_id и offer_id, приоритетным считается product_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

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

recipient

object

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

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

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

Широта.

longitude

number

Долгота.

provider_location_id

string

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

provider_id

string

Идентификатор провайдера доставки. Используется в POST /v1/order/dbs/list → orders[].delivery.

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

CDEKRUSSIAN_POSTBOXBERRYYANDEX5POSTDPDHERMESIMLTOP_DELIVERYOZONKSESTRIZHDLPEKSBLMVIDEO

item_type

string

Тип позиции заказа. 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

Цены товара.

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

price_type

string

required

Тип цены.

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

CUSTOMER_PRICECUSTOMER_FINAL_PRICEMERCHANT_PRICEMERCHANT_FINAL_PRICE

value

integer

required

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

currency_code

string

Валюта.

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

RUBBYNKZTEURUSDCNY

vat

string

НДС.

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

VAT_0VAT_5VAT_7VAT_10VAT_22NO_VAT

exemplar

object

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

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

exemplar_id

integer

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

gtd

string

Номер грузовой таможенной декларации (ГТД).

marks

array

Контрольные знаки и другие маркировки.

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

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

История статусов заказа.

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

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

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

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

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

delivery_date_end

string

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_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_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_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    "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"
      },
      "recipient": {
        "name": "Иван",
        "phone": "+79004445566"
      },
      "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.