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

POST /v1/order/dbs/status/list

POST/v1/order/dbs/status/list

Позволяет получить заказы, требующие обработки. Основной сценарий — получение заказов в статусе NEW для последующего запроса развернутой информации.

Для отменённых заказов, которые не требуют подтверждения со стороны мерчанта (например, если отмена разрешена по статусу или выполнена до начала сборки), метод также возвращает заказы в статусе CANCELLED.

Тело запроса

filter
object
required

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

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

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

status
array

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

NEW: Новый

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

PACKED: Упакован

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

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

DELIVERED: Доставлен

CANCELLED: Отменён

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

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

NEW: Новый

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

PACKED: Упакован

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

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

DELIVERED: Доставлен

CANCELLED: Отменён

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

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

changed_by
string
required

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

MERCHANT: Продавец

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

MARKET: Площадка

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

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

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

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

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

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

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

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

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/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.