Работа с отчетами План / Факт

Отчеты План / Факт — это инструмент для анализа точности планирования и получения сводной информации о фактических показателях.

В анализе участвуют все планирования и маршруты по всем складам компании, которые загрузили в Мониторинг. В отчетах плановые показатели сравниваются с фактическими данными по уже реализованным маршрутам.

Загрузить план в Мониторинг

Чтобы получить сравнительную информацию по плановым и фактическим показателям, передайте в Мониторинг решение, полученное в сервисе Планирования. Если этого не сделать, в отчете окажутся только фактические показатели.

В отчетах не учитывается последующее редактирование маршрута менеджером в Рабочем месте логиста или курьером в приложении Яндекс Курьер.

Способ загрузки плана в Мониторинг зависит от выбранного компанией способа взаимодействия с сервисом.

Через интерфейс Рабочего места логиста

План сохраняется в момент экспорта маршрута в Мониторинг:

1. Спланируйте маршрут через сервис Планирования.
2. Нажмите Экспортировать.
3. В окне Экспортировать решение выберите Мониторинг.

Через API

Отправьте запрос к ресурсу route-plans. В запросе нужно указать информацию о маршруте и заказах.

Важно

Маршрут с  номером, указанным в запросе, уже должен существовать в компании.

Windows

MacOS/Linux

Запрос

cURL

curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-токен>" -X POST -d @<Путь_до_файла_в_кодировке_UTF-8> -i https://courier.yandex.ru/api/v1/companies/<id-вашей-компании>/route-plans

Файл

[
  {
    "number":"101-2_2017-10-23",
    "nodes":[
      {
        "type":"depot",
        "arrival_time_s":25200,
        "transit_distance_m":0,
        "value":{
          "number":"0",
          "point":{
            "lat":55.799087,
            "lon":37.729377
          },
          "service_duration_s":200
        }
      },
      {
        "type":"order",
        "arrival_time_s":57526,
        "departure_time_s":57526,
        "transit_distance_m":8723,
        "used_time_window":"10:00-12:00",
        "value":{
          "number":"126",
          "point":{
            "lat":55.826326,
            "lon":37.637686
          },
          "service_duration_s":0
        }
      },
      {
        "type":"order",
        "arrival_time_s":57546,
        "departure_time_s":57546,
        "transit_distance_m":87423,
        "used_time_window":"10:00-12:00",
        "value":{
          "number":"2345",
          "address":"Address",
          "point":{
            "lat":55.826426,
            "lon":37.647686
          },
          "service_duration_s":0,
          "shared_service_duration_s":0,
          "multi_order":false,
          "customer_name":"Name",
          "shipment_size":{
            "volume_cbm":1.2,
            "weight_kg":5.1,
            "amount":4.5
          }
        }
      }
    ]
  }
]

Результат

Код состояния 200 в ответе означает, что ваш план успешно загружен на сервер.

Запрос

cURL

curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-токен>" -X POST -d [{"number":"101-2_2017-10-23","nodes":[{"type":"depot","arrival_time_s":25200,"transit_distance_m":0,"value":{"number":"0","point":{"lat":55.799087,"lon":37.729377},"service_duration_s":200}},{"type":"order","arrival_time_s":57526,"departure_time_s":57526,"transit_distance_m":8723,"used_time_window":"10:00-12:00","value":{"number":"126","point":{"lat":55.826326,"lon":37.637686},"service_duration_s":0}},{"type":"order","arrival_time_s":57546,"departure_time_s":57546,"transit_distance_m":87423,"used_time_window":"10:00-12:00","value":{"number":"2345","address":"Address","point":{"lat":55.826426,"lon":37.647686},"service_duration_s":0,"shared_service_duration_s":0,"multi_order":false,"customer_name":"Name","shipment_size":{"volume_cbm":1.2,"weight_kg":5.1,"amount":4.5}}}]}] -i https://courier.yandex.ru/api/v1/companies/<id-вашей-компании>/route-plans

Результат

Код состояния 200 в ответе означает, что ваш план успешно загружен на сервер.

Построить отчет

1. Перейдите в раздел Отчеты → План/Факт.

2. Нажмите Большой отчёт в Excel.

3. Нажмите Выберите период, чтобы задать временные рамки для запланированных и выполненных маршрутов, которые нужно проанализировать.

   Вы можете как выбрать один из преднастроенных периодов (Вчера, 7 дней, 30 дней, Прошлый месяц), так и задать собственный произвольной продолжительности, но не более 60 дней.

   Примечание

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

4. Нажмите Подготовить.

После выбора периода в правом верхнем углу появится значок , означающий, что отчет готовится. В это время вы можете продолжать работать в любом разделе интерфейса Рабочего места логиста.

Скачать отчет

Когда отчет будет готов, появится уведомление с названием отчета (формируется автоматически и содержит даты начала и конца периода сравнения).

Нажмите кнопку Скачать, чтобы получить готовый отчет. Если вы закроете уведомление, то сможете вернуться к списку доступных отчетов позже. Для этого нажмите значок в правом верхнем углу.

Описание полей отчета см. в разделе План / Факт.