Отчет Качество работы курьера

Отчет о качестве работы курьера содержит данные о выполнении заказов за определенный период. С его помощью вы можете проанализировать точность соблюдения временных окон, выявить нарушения последовательности доставки и оценить другие параметры работы курьеров.

Вы можете получить отчет:

• через интерфейс Рабочего места логиста. Подробнее см. в разделе Качество работы курьеров;

• через API за любой интервал времени:

  • полный отчет;
  • отчет с пагинацией.

Обратите внимание, что часовые пояса складов, логистов, курьеров и клиентов могут различаться. Чтобы учесть различие, при анализе параметров времени используйте поле timezone, которое возвращается в ответе API для каждого объекта. Часовой пояс указывается в формате базы данных tz, например Europe/Moscow (подробнее см. Список часовых поясов). По умолчанию часовой пояс объекта рассчитывается на основе координат.

Полный отчет

Отправьте GET-запрос к ресурсу courier-quality. В запросе укажите дату date или идентификатор маршрута route_id.

Также вы можете дополнительно указать параметры:

• depot_id — идентификатор склада, с которого начинается маршрут;
• types — список типов точек для отчета. Доступные типы: order, depot, garage. По умолчанию — order;
• with_deleted_couriers — включить в отчет удаленных курьеров. По умолчанию — false.

Запрос

cURL

curl -H "Authorization: OAuth <ваш-токен>" \
     -X GET https://courier.yandex.ru/api/v1/companies/<id-вашей-компании>/courier-quality?date=2026-06-01

Результат

Метод возвращает массив объектов. Каждый объект соответствует одной точке маршрута и содержит поля в зависимости от типа точки.

Пример ответа для точки типа order:

[
  {
    "type": "order",
    "courier_name": "Иванов Иван",
    "courier_number": "12345",
    "order_number": "ABC-123",
    "order_address": "ул. Ленина, д. 10",
    "route_number": "R-67890",
    "route_date": "2026-06-01",
    "arrived_at": "2026-06-01T10:10:00+03:00",
    "left_at": "2026-06-01T10:20:00+03:00",
    "order_visited_at": "2026-06-01T10:15:00+03:00",
    "order_completed_at": "2026-06-01T10:15:00+03:00",
    "time_interval_error": 900.0,
    "segment_distance_m": 1500.0,
    "far_from_point": false,
    "no_call_before_delivery": false,
    "late_call_before_delivery": false,
    "delivery_not_in_interval": true,
    "not_in_order": false,
    "suggested_order_number": 1
  }
]

Отчет с пагинацией

Отправьте GET-запрос к ресурсу courier-quality. В запросе укажите дату date или идентификатор маршрута route_id.

Также вы можете дополнительно указать параметры:

• depot_id — идентификатор склада, с которого начинается маршрут;
• types — список типов точек для отчета. Доступные типы: order, depot, garage. По умолчанию — order;
• with_deleted_couriers — включить в отчет удаленных курьеров. По умолчанию — false;
• max_results — максимальное количество объектов, которые должны быть возвращены. По умолчанию — 100;
• page_token — токен страницы. Для второго и последующих запросов укажите значение next_page_token из тела предыдущего ответа.

Запрос

cURL

curl -H "Authorization: OAuth <ваш-токен>" \
     -X GET https://courier.yandex.ru/api/v2/companies/<id-вашей-компании>/courier-quality?date=2026-06-01&max_results=100

Результат

Метод возвращает объект с полем results (массив объектов точек маршрута) и, если есть следующая страница, полем next_page_token.

{
  "results": [
    {
      "type": "order",
      "courier_name": "Иванов Иван",
      "courier_number": "12345",
      "order_number": "ABC-123",
      "order_address": "ул. Ленина, д. 10",
      "route_number": "R-67890",
      "route_date": "2026-06-01",
      "arrived_at": "2026-06-01T10:10:00+03:00",
      "left_at": "2026-06-01T10:20:00+03:00",
      "order_visited_at": "2026-06-01T10:15:00+03:00",
      "order_completed_at": "2026-06-01T10:15:00+03:00",
      "time_interval_error": 900.0,
      "segment_distance_m": 1500.0,
      "far_from_point": false,
      "no_call_before_delivery": false,
      "late_call_before_delivery": false,
      "delivery_not_in_interval": true,
      "not_in_order": false,
      "suggested_order_number": 1
    }
  ],
  "next_page_token": "eyJvZmZzZXQiOiIxMDAifQ=="
}