Обновление статуса заказа

POST /v1/order/dbs/status/update

POST/v1/order/dbs/status/update

Тело запроса

merchant_order_id
string
Идентификатор заказа продавца.
status
string
Новый статус доставки.
Допустимые значения
CONFIRMEDPACKEDDELIVERINGREADY_FOR_PICKUPDELIVEREDCANCELLED
comment
string
Комментарий (опционально).
changed_at
string
Время изменения статуса. Формат: date-time (RFC3339). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
changed_by
string
Инициатор изменения статуса.
Допустимые значения
MERCHANTCLIENT
actions
array
Разрешённые действия по заказу для установленного статуса (опционально).
Разрешённое действие по заказу для установленного статуса.
Показать свойства
type
string
required
Тип действия.
Допустимые значения
cancel
enabled
boolean
required
Доступность действия.

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

200A successful response.
application/json
object
merchant_order_id
string
Идентификатор заказа мерчанта.
failed
object
Ошибка обновления статуса. Если отсутствует — успех.
Показать свойства
merchant_order_id
string
Идентификатор заказа продавца.
error_message
string
Текст ошибки (compat). Предпочтительно использовать errors.
errors
array
Структурированные ошибки. Коды: OrderStatusUpdateValidationErrorCode.
Ошибка валидации/бизнеса поля для scope «OrderStatusUpdate». Допустимые field: merchant_order_id, status, comment, changed_at, changed_by, actions. Для бизнес-правил витрины: code=STOREFRONT_RULE_VIOLATION.
Показать свойства
field
string
required
Путь к полю. Ожидаемые: merchant_order_id, status, comment, changed_at, changed_by, actions.
code
string
required
Коды ошибок ручки (scope OrderStatusUpdate). Допустимые field: merchant_order_id, status, comment, changed_at, changed_by, actions. - REQUIRED: Поле отсутствует или пустое, но обязательно - INVALID_TYPE: Неверный JSON-тип - INVALID_FORMAT: Общий сбой формата значения - INVALID_ENUM: Значение не из допустимого enum - INVALID_DATE_TIME: Не RFC3339 или отсутствует timezone - NOT_FOUND: Сущность не найдена (уточняется полем field) - INVALID_STATUS_TRANSITION: Недопустимый переход статуса - STATUS_NOT_ALLOWED: Статус недоступен в текущем контексте - CONFLICT: Конфликт состояния ресурса - STOREFRONT_RULE_VIOLATION: Запрос синтаксически валиден, но отклонён бизнес-правилом витрины (детали в message)
Допустимые значения
REQUIREDINVALID_TYPEINVALID_FORMATINVALID_ENUMINVALID_DATE_TIMENOT_FOUNDINVALID_STATUS_TRANSITIONSTATUS_NOT_ALLOWEDCONFLICTSTOREFRONT_RULE_VIOLATION
message
string
required
Текст для клиента. Для STOREFRONT_RULE_VIOLATION — описание правила.

Ошибки

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/update
1curl https://api.omninet.ru/v1/order/dbs/status/update \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "merchant_order_id": "string",6  "status": "string",7  "comment": "string",8  "changed_at": "2026-07-02T10:25:00+02:00",9  "changed_by": "string",10  "actions": [11    {12      "type": "cancel",13      "enabled": true14    }15  ]16}'
{
  "merchant_order_id": "string",
  "failed": {
    "merchant_order_id": "string",
    "error_message": "string",
    "errors": [
      {
        "field": "status",
        "code": "INVALID_STATUS_TRANSITION",
        "message": "Переход в указанный статус недопустим"
      }
    ]
  }
}

A successful response.