---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.kz/routing/doc/kk/delivery/functions/working-with-quality-report.md
  - https://yandex.kz/routing/doc/ru/delivery/functions/working-with-quality-report.md
  - href: kk/delivery/functions/working-with-quality-report.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
title: Яндекс Маршрутизация — функции — отчет о качестве работы курьера
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.kz/routing/doc/kk/llms.txt


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

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

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

* через интерфейс [Рабочего места логиста](https://yandex.kz/courier/companies). Подробнее см. в разделе [Качество работы курьеров](https://yandex.kz/routing/doc/kk/delivery/interface/quality-report.md);
* через API за любой интервал времени:
  
  * [полный отчет](#full-api);
  * [отчет с пагинацией](#api-with-pagination).

Обратите внимание, что часовые пояса складов, логистов, курьеров и клиентов могут различаться. Чтобы учесть различие, при анализе параметров времени используйте поле `timezone`, которое возвращается в ответе API для каждого объекта. Часовой пояс указывается в формате базы данных `tz`, например `Europe/Moscow` (подробнее см. [Список часовых поясов](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List)). По умолчанию часовой пояс объекта рассчитывается на основе координат.

## Полный отчет {#full-api}

Отправьте GET-запрос к ресурсу [courier-quality](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsDeliveryQualityInformation). В запросе укажите дату `date` или идентификатор маршрута `route_id`.

{% note warning %}

Параметры `date` и `route_id` — взаимоисключающие. Укажите только один из них.

{% endnote %}

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

* `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`:

```json
[
  {
    "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
  }
]
```

## Отчет с пагинацией {#api-with-pagination}

Отправьте GET-запрос к ресурсу [courier-quality](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsDeliveryQualityInformationWithPagination). В запросе укажите дату `date` или идентификатор маршрута `route_id`.

{% note warning %}

Параметры `date` и `route_id` — взаимоисключающие. Укажите только один из них.

{% endnote %}

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

* `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`.

```json
{
  "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=="
}
```

<!-- source: kk/delivery/_includes/feedback.md -->


[//]: # (Вариант без html\: \[Написать в службу поддержки\]\(../../../feedback.md\))

<!-- source: kk/_includes/neuroexpert.md -->
<div style="display: none;"> </div>
<!-- endsource: kk/_includes/neuroexpert.md -->
<!-- endsource: kk/delivery/_includes/feedback.md -->