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

POST /v1/order/dbs/status/list

POST/v1/order/dbs/status/list

Тело запроса

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

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

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

A successful response.