Путевые листы

Этот API используется для получения информации о путевых листах (waybill) за указанный период.
С его помощью можно:
— получить список задач (заданий) по каждому агенту
— посмотреть планируемые и фактические времена выполнения
— узнать статусы выполнения и подробности по точкам маршрута

Как получить данные

Метод

GET

Адрес запроса

Для получения данных используйте адрес: https://tasks.<server_address>/backend/public/get_waybill_for_pilot

Параметры запроса

from_ts — время начала выборки (Unix timestamp, пример: 1536181200)
to_ts — время окончания выборки (Unix timestamp, пример: 1538773200)
agents — список идентификаторов агентов через запятую (например: 13128,13130,...)
 

Пример запроса

https://tasks.<server_address>/backend/public/get_waybill_for_pilot?from_ts=1536181200&to_ts=1538773200&agents=13128,13130,21055
Ответ
{
  "success": true,
  "msg": "",
  "items": [
    {
      "agent_id": 13128,
      "c_begin_time": "1536200000",
      "c_end_time": "1536210000",
      "c_information": "{\"route\":\"Маршрут №54\",\"driver\":\"Иванов И.И.\"}",
      "c_initiator": "Диспетчер",
      "c_progress_time": "1536200500",
      "c_running_time": "1536200300",
      "c_status_id": 2,
      "c_status_name": "Выполнено",
      "id": 98765,
      "points_info": [
        {
          "point_id": 1,
          "lat": "55.7558",
          "lon": "37.6173",
          "visited_at": "1536200600"
        }
      ]
    }
  ]
}
В ответ на API-запрос возвращается:
  • success — результат выполнения (true — успех, false — ошибка)
  • msg — сообщение об ошибке (если есть)
  • items — массив данных о заданиях
Для каждого задания:
agent_id — идентификатор агента
c_begin_time — планируемое время начала выполнения задачи
c_end_time — фактическое время завершения задачи
c_information — строка с дополнительной информацией о задании (JSON, зависит от шаблона)
c_initiator — заявитель (кто создал задание)
c_progress_time — фактическое время посещения первой точки
c_running_time — фактическое время отправления на выполнение задания
c_status_id — идентификатор статуса задания
c_status_name — расшифровка статуса задания
id — идентификатор задания в системе PTM
points_info — массив информации о посещённых точках маршрута