Получение данных Express-tracking по заказу

POST /v1/dbs/tracking/get

POST/v1/dbs/tracking/get

Возвращает информацию о выполнении экспресс-доставки: статус поиска и движения курьера, данные назначенного курьера, его текущее местоположение и координаты места доставки. Метод применяется только для заказов с экспресс-доставкой (delivery_type = EXPRESS). Рекомендуемый интервал polling со стороны витрины — около одного запроса в минуту. После DELIVERED данные tracking доступны 24 часа.

Тело запроса

merchant_order_id
string
required

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

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

200A successful response.
application/json
object
merchant_order_id
string
required

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

courier_search_deadline_at
string

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

status_history
array

История статусов Express-доставки. Текущий статус — последний элемент по changed_at.

DbsTrackingStatusHistoryItem

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

DbsTrackingStatusHistoryItem

status_id
string
required

Идентификатор статуса.

  • SEARCHING: Поиск курьера
  • ASSIGNED: Курьер назначен
  • PICKED_UP: Курьер забрал заказ
  • ON_THE_WAY: Курьер направляется к месту доставки
  • DELIVERED: Заказ доставлен
Допустимые значения
SEARCHINGASSIGNEDPICKED_UPON_THE_WAYDELIVERED
status_name
string
required

Человекочитаемое название статуса.

changed_at
string
required

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

courier
object

Данные курьера (опционально до назначения).

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

Имя курьера.

phone
string

Телефон курьера.

vehicle
object

Транспортное средство (опционально).

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

Модель транспортного средства.

plate_number
string

Государственный номер.

courier_location
object

Последняя известная позиция курьера (без истории GPS).

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

Широта.

longitude
number

Долгота.

changed_at
string

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

destination_location
object

Координаты места доставки.

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

Широта.

longitude
number

Долгота.

changed_at
string

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

errors
array

Ошибки (HTTP 200). При непустом errors поля tracking отсутствуют. После DELIVERED данные доступны 24 часа.

Ошибка для scope «DbsTrackingGet». Допустимые field: merchant_order_id. Коды — DbsTrackingValidationErrorCode.

Ошибка для scope «DbsTrackingGet». Допустимые field: merchant_order_id. Коды — DbsTrackingValidationErrorCode.

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

Путь к полю. Ожидаемые: merchant_order_id.

code
string
required

Коды ошибок ручки (scope DbsTrackingGet).

  • REQUIRED: Поле отсутствует или пустое, но обязательно
  • INVALID_TYPE: Неверный JSON-тип
  • NOT_FOUND: Заказ не найден или данные tracking недоступны
  • STATUS_NOT_ALLOWED: Метод применим только для заказов с delivery_type = EXPRESS
  • STOREFRONT_RULE_VIOLATION: Отклонено бизнес-правилом витрины (детали в message)
Допустимые значения
REQUIREDINVALID_TYPENOT_FOUNDSTATUS_NOT_ALLOWEDSTOREFRONT_RULE_VIOLATION
message
string
required

Текст для клиента.

Ошибки

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/dbs/tracking/get
1curl https://api.omninet.ru/v1/dbs/tracking/get \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "merchant_order_id": "string"6}'
{
  "merchant_order_id": "string",
  "courier_search_deadline_at": "string",
  "status_history": [
    {
      "status_id": "string",
      "status_name": "string",
      "changed_at": "string"
    }
  ],
  "courier": {
    "name": "string",
    "phone": "string",
    "vehicle": {
      "model": "string",
      "plate_number": "string"
    }
  },
  "courier_location": {
    "latitude": 0,
    "longitude": 0,
    "changed_at": "string"
  },
  "destination_location": {
    "latitude": 0,
    "longitude": 0,
    "changed_at": "string"
  },
  "errors": [
    {
      "field": "string",
      "code": "string",
      "message": "string"
    }
  ]
}

A successful response.