Путевые листы
Этот 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 — массив информации о посещённых точках маршрута