Получение обновлений статусов заказов

POST /v1/order/dbs/status/list

POST/v1/order/dbs/status/list

Тело запроса

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

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

200A successful response.
application/json
object
order_updates
array
required
Элементы списка. Заказы с недоступными или несуществующими merchant_order_id в ответ не возвращаются.
Элемент ответа: идентификатор заказа и его статус.
Показать свойства
merchant_order_id
string
required
Идентификатор заказа продавца.
client_order_id
string
required
Идентификатор заказа клиента.
status
string
required
Статус заказа (доставки).
Допустимые значения
NEWCONFIRMEDPACKEDDELIVERINGREADY_FOR_PICKUPDELIVEREDCANCELLED
changed_at
string
required
Время изменения статуса. Формат: date-time (RFC3339). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
changed_by
string
required
Инициатор изменения статуса.
Допустимые значения
MERCHANTCLIENTMARKET
actions
array
Разрешённые действия по заказу для установленного статуса.
Разрешённое действие по заказу для установленного статуса.
Показать свойства
type
string
required
Тип действия.
Допустимые значения
cancel
enabled
boolean
required
Доступность действия.
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
POST/v1/order/dbs/status/list
1curl https://api.omninet.ru/v1/order/dbs/status/list \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "filter": {6    "merchant_order_id": [7      "string"8    ],9    "status": [10      "NEW"11    ],12    "updated_at": "2026-07-02T10:25:00+02:00"13  },14  "cursor": "string",15  "limit": 016}'
{
  "order_updates": [
    {
      "merchant_order_id": "string",
      "client_order_id": "string",
      "status": "NEW",
      "changed_at": "2026-07-02T10:25:00+02:00",
      "changed_by": "MERCHANT",
      "actions": [
        {
          "type": "cancel",
          "enabled": true
        }
      ]
    }
  ],
  "next_cursor": "string",
  "total": 0
}

A successful response.