Получение данных Express-tracking по заказу
POST /v1/dbs/tracking/get
/v1/dbs/tracking/getВозвращает информацию о выполнении экспресс-доставки: статус поиска и движения курьера, данные назначенного курьера, его текущее местоположение и координаты места доставки. Метод применяется только для заказов с экспресс-доставкой (delivery_type = EXPRESS). Рекомендуемый интервал polling со стороны витрины — около одного запроса в минуту. После DELIVERED данные tracking доступны 24 часа.
Запрос передаёт merchant_order_ids или client_order_id. Ответ — массив trackings.
Тело запроса
Идентификаторы заказов продавца.
Идентификатор заказа клиента.
Успешный ответ
200A successful response. application/json
Элементы трекинга.
Элемент трекинга.
Показать свойстваСкрыть свойства
Идентификатор заказа продавца.
Идентификатор заказа клиента.
Дата и время, до которого ожидается назначение курьера. Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами. Часовой пояс остаётся текстом внутри этой строки.
История статусов Express-доставки. Текущий статус — последний элемент по changed_at.
DbsTrackingStatusHistoryItem
Показать свойстваСкрыть свойства
DbsTrackingStatusHistoryItem
Идентификатор статуса.
SEARCHING: Поиск курьераASSIGNED: Курьер назначенPICKED_UP: Курьер забрал заказON_THE_WAY: Курьер направляется к месту доставкиDELIVERED: Заказ доставленCANCELLED: Доставка не состоится
Человекочитаемое название статуса.
Время события (date-time, RFC3339). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
Данные курьера.
Показать свойстваСкрыть свойства
Имя курьера.
Телефон курьера.
Транспортное средство (опционально).
Показать свойстваСкрыть свойства
Модель транспортного средства.
Государственный номер.
Последняя известная позиция курьера.
Показать свойстваСкрыть свойства
Широта.
Долгота.
Время актуальности координат (date-time, RFC3339). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
Координаты места доставки.
Показать свойстваСкрыть свойства
Широта.
Долгота.
Ошибки элемента.
Ошибка для scope «DbsTrackingGet». Допустимые field: merchant_order_id. Коды — DbsTrackingValidationErrorCode.
Ошибка для scope «DbsTrackingGet». Допустимые field: merchant_order_id. Коды — DbsTrackingValidationErrorCode.
Показать свойстваСкрыть свойства
Путь к полю. Ожидаемые: merchant_order_id.
Коды ошибок трекинга.
REQUIRED_ONE_OF: Нужен ровно один фильтрINVALID_TYPE: Неверный JSON-типTOO_MANY_ITEMS: Превышен лимит элементовNOT_FOUND: Заказ не найден или данные tracking недоступныSTATUS_NOT_ALLOWED: Метод применим только для заказов сdelivery_type=EXPRESS
Текст для клиента.
Ошибки
400Некорректный запрос application/json
Класс транспортной ошибки запроса (HTTP 4xx/5xx).
Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.
ERROR_TYPE_UNSPECIFIED: не используетсяERROR_TYPE_UNAUTHORIZED: HTTP 401ERROR_TYPE_RATE_LIMIT: HTTP 429ERROR_TYPE_INTERNAL: HTTP 500ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Машинный код ошибки. Уточняет error_type.
Человекочитаемое сообщение об ошибке.
401Ошибка авторизации application/json
Класс транспортной ошибки запроса (HTTP 4xx/5xx).
Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.
ERROR_TYPE_UNSPECIFIED: не используетсяERROR_TYPE_UNAUTHORIZED: HTTP 401ERROR_TYPE_RATE_LIMIT: HTTP 429ERROR_TYPE_INTERNAL: HTTP 500ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Машинный код ошибки. Уточняет error_type.
Человекочитаемое сообщение об ошибке.
429Превышен лимит запросов application/json
Класс транспортной ошибки запроса (HTTP 4xx/5xx).
Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.
ERROR_TYPE_UNSPECIFIED: не используетсяERROR_TYPE_UNAUTHORIZED: HTTP 401ERROR_TYPE_RATE_LIMIT: HTTP 429ERROR_TYPE_INTERNAL: HTTP 500ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Машинный код ошибки. Уточняет error_type.
Человекочитаемое сообщение об ошибке.
500Внутренняя ошибка сервера application/json
Класс транспортной ошибки запроса (HTTP 4xx/5xx).
Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.
ERROR_TYPE_UNSPECIFIED: не используетсяERROR_TYPE_UNAUTHORIZED: HTTP 401ERROR_TYPE_RATE_LIMIT: HTTP 429ERROR_TYPE_INTERNAL: HTTP 500ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Машинный код ошибки. Уточняет error_type.
Человекочитаемое сообщение об ошибке.