{"info":{"_postman_id":"aa92acf6-e3ba-466d-870f-6452599317ea","name":"API Actividad del Vehículo","description":"

La API de Actividades de Vehículos permite obtener información detallada sobre las actividades realizadas por los vehículos en un periodo de tiempo determinado. Actualmente, la API es de solo lectura y está diseñada para consultar datos aplicando distintos filtros según las necesidades del usuario. Cada usuario únicamente podrá acceder a la información de los vehículos a los cuales tenga permisos asignados, garantizando así la seguridad y privacidad de los datos.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"20397665","collectionId":"aa92acf6-e3ba-466d-870f-6452599317ea","publishedId":"2sB3WnvgzQ","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"3e3e3e","highlight":"6226f7"},"publishDate":"2025-10-30T00:47:11.000Z"},"item":[{"name":"Obtención de token","item":[{"name":"Login","id":"b080efef-e0ca-4e86-b934-2715391602cb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.waypoint.cl/auth/login?user=username&password=password","description":"

Este servicio solicita como body el username y la password de tu usuario y, a través de una validación de login, devuelve el accessToken.

\n

Este dato se solicitara para consumir la API.

\n

Para poder consultar se requiere pasar el username y la password como query params en la url como se muestra en el ejemplo

\n","urlObject":{"protocol":"https","path":["auth","login"],"host":["api","waypoint","cl"],"query":[{"key":"user","value":"username"},{"key":"password","value":"password"}],"variable":[]}},"response":[],"_postman_id":"b080efef-e0ca-4e86-b934-2715391602cb"}],"id":"fb54b393-c9ac-49c8-9f34-eb730568bb95","_postman_id":"fb54b393-c9ac-49c8-9f34-eb730568bb95","description":""},{"name":"Actividades del vehículo","item":[{"name":"Actividad del vehículo","id":"ec8dac5c-99ca-48c5-bff5-37fda5e45387","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"id-client","value":"12345","type":"text"}],"body":{"mode":"raw","raw":"{\n \"start_date\": \"10/10/2025 00:00\",\n \"end_date\": \"11/10/2025 23:59\",\n \"client_id\": 120,\n \"groups\": [1, 4, 20],\n \"vehicles\": [1267, 2345, 15678],\n \"weekdays\": [1, 2, 3, 4, 5, 6, 7],\n \"time_range_start\": \"08:00\",\n \"time_range_end\": \"19:00\",\n \"states\": [\"TRIP\",\"NOTRIP\"],\n \"timezone\": \"America/Santiago\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api2.tranciti.com/actividad-vehiculo/report","description":"

Este servicio solicita un Bearer token para poder ser autorizado para consumirlo. Ademas de añadir el id-client en el header.

\n

Nota: Cabe mencionar que para consumir este servicio, el usuario en cuestion debe tener acceso al producto de Comportamiento del vehículo.

\n

Para consultar existen una campos que se le pueden pasar al body que permitiran filtrar la data de los vehículos:

\n

Importante: El filtro de fecha no puede superar los 31 entre la fecha de inicio y la de termino.

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
NombreTipoObligatorioDescripción
start_dateStringSiFecha y hora de inicio del rango de análisis. Indica desde qué momento se comenzará a obtener la información.
Formato: dd/mm/yyyy HH:mm
end_dateStringSiFecha y hora de término del rango de análisis. Indica hasta qué momento se obtendrá la información. Formato: dd/mm/yyyy HH:mm
client_idIntegerSiId del tenant propietario de los vehículos que quiero consultar.
groupsArray[Integer]NoTraera todos los vehículos que pertenezcan a los ids de grupos que se indiquen. Nota: Por defecto trae todos los grupos si no se indica nada.
vehiclesArray[Integer]NoFiltro para consultar por id de vehículos en especifico. Nota: Por defecto traera todos los vehículos si no se ingresa nada.
weekdaysArray[Integer]NoFiltro para consultar por dias de la semana en específico. Nota: Por defecto consultara por todos los días de la semana. El Lunes es el 1.
time_range_startStringNoHora de inicio del rango horario diario a considerar dentro del periodo definido por start_time y end_time. Por ejemplo, si se indica 15:00, solo se incluirán los datos ocurridos desde las 15:00 en cada uno de los días comprendidos entre las fechas indicadas. Nota: Este campo no puede ir vacio.
time_range_endStringNoHora de término del rango horario diario a considerar dentro del periodo definido por start_time y end_time. Por ejemplo, si se indica 18:00, solo se incluirán los datos ocurridos hasta las 18:00 en cada uno de los días comprendidos entre las fechas indicadas. Nota: Este campo no puede ir vacio.
statesArray[String]NoTipo de actividad del vehículo que deseo traer. Puede ser TRIP o NOTTRIP. Nota: Por defecto entrega todos los estados existentes.
timezoneStringNoZona horaria a utilizar para la interpretación de las fechas y horas indicadas. Nota: Por defecto se utiliza America/Santiago
\n

En particular el servicio retorna la siguiente información:

\n\n

Si por algun motivo la solicitud fallo uno puede encontrarse con los siguientes casos de error 400:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Mensaje de ErrorCausa
Faltan parámetros obligatorios: start_date, end_date, client_idUno o más de los parámetros requeridos (start_date, end_date, client_id) no fueron incluidos en el cuerpo de la petición.
Formato de fecha inválido para start_date o end_date. Use dd/mm/yyyy HH:mm.El valor de start_date o end_date no sigue el formato de fecha y hora especificado.
end_date no puede ser anterior a start_date.La fecha de fin del rango es anterior a la fecha de inicio.
client_id debe ser un entero válido.El valor proporcionado para client_id no es un número entero.
Zona horaria inválida.El valor del parámetro timezone no corresponde a una zona horaria válida (ej: \"America/Santiago\").
Formato de hora inválido para time_range. Use HH:MM.El valor de time_range_start o time_range_end no sigue el formato de hora especificado.
El valor de state '[valor]' no es válido. Use 'TRIP' o 'NOTRIP'.Se ha proporcionado un valor no permitido en el filtro states. Solo se aceptan TRIP y NOTRIP (insensible a mayúsculas). Nota: [valor] es el dato que ingreso como usuario.
El parámetro '[nombre]' debe ser una lista (ej: [1,2]) o una cadena de texto separada por comas (ej: '1,2').Un parámetro de filtro como groups, vehicles, weekdays o states se ha enviado en un formato que no es ni un array ni un string. Nota: [nombre] hace referencia a cualquiera de los nombres de los parametros como groups, vehicles, weekdays
\n
","urlObject":{"protocol":"https","path":["actividad-vehiculo","report"],"host":["api2","tranciti","com"],"query":[],"variable":[]}},"response":[{"id":"dfafa507-8e17-451e-bc3d-e92ff491bff0","name":"Respuesta exitosa","originalRequest":{"method":"POST","header":[{"key":"id-client","value":"12345","type":"text"},{"key":"Authorization","value":"Bearer token","type":"text"}],"body":{"mode":"raw","raw":"{\n \"start_date\": \"10/10/2025 00:00\",\n \"end_date\": \"11/10/2025 23:59\",\n \"client_id\": 120,\n \"groups\": [1, 4, 20],\n \"vehicles\": [1267, 2345, 15678],\n \"weekdays\": [1, 2, 3, 4, 5, 6, 7],\n \"time_range_start\": \"08:00\",\n \"time_range_end\": \"19:00\",\n \"states\": [\"TRIP\",\"NOTRIP\"],\n \"timezone\": \"America/Santiago\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api2.tranciti.com/actividad-vehiculo/report","protocol":"https","host":["api2","tranciti","com"],"path":["actividad-vehiculo","report"],"query":[{"key":"","value":"","disabled":true},{"key":"","value":"","disabled":true}]}},"status":"Accepted","code":202,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\n \"executionId\": \"380195ea-76cb-48cb-a3z8-5af45f2235c\"\n}"},{"id":"6d70e921-9b5d-4833-a0aa-4bc2c945ab65","name":"Error falta campo obligatorio","originalRequest":{"method":"POST","header":[{"key":"id-client","value":"12345","type":"text"},{"key":"Authorization","value":"Bearer token","type":"text"}],"body":{"mode":"raw","raw":"{\n \"start_date\": \"10/10/2025 00:00\",\n \"client_id\": 120,\n \"timezone\": \"America/Santiago\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api2.tranciti.com/actividad-vehiculo/report"},"status":"Bad Request","code":400,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Faltan parámetros obligatorios: start_date, end_date, client_id\"\n}"}],"_postman_id":"ec8dac5c-99ca-48c5-bff5-37fda5e45387"},{"name":"Estado actividad del vehículo","id":"3bd0dece-b970-4b40-bf05-efae6db00510","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": \"id-entregado-por-endpoint-de-report\",\n \"nombreReporte\": \"reporte-actividad-vehiculo\"\n}","options":{"raw":{"language":"json"}}},"url":"https://reportes.waypoint.cl/v1/base/status","description":"

El servicio requiere de un body el cual debe ir constrituido por un json que contenga:

\n
{\n    \"id\": \"id-entregado-por-endpoint-de-report\",\n    \"nombreReporte\": \"reporte-actividad-vehiculo\"\n}\n\n
\n

Donde id es el executionId que entrega el endpoint de solicitud del reporte, y el valor que se añade en nombreReporte debe ser fijo con \"reporte-actividad-vehiculo\". A partir de ese body se recibira una respuesta que puede contener los siguientes status (Estado de la consulta):

\n\n

Si es SUCCEEDED entonces vendra con un campo llamado url que tiene un enlace de un reporte json que contiene toda la información que se obtuve luego de la consulta.

\n

El reporte json que retorna el servicio contiene la siguiente información:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
NombreTipoDescripción
vehicle_idIntegerId unico del vehículo. Nota: Correspondel al id de core.
plateStringPatente del vehículo.
descriptionStringDescripción del vehículo.
vehicle_typeStringTipo de vehículo al que corresponde el vehículo.
group_nameStringNombre del grupo al que pertenece el vehículo.
client_nameStringNombre del tenant al que pertenece el vehículo.
stateStringPermite diferenciar las actividades de los vehículos, ya sean TRIP, NOTTRIP, o DISCONNECTED.
start_timeBigintIndica la hora en la que inicio la actividad del vehículo. El dato se entrega en UTC.
end_timeBigintIndica la hora en la que finalizo la actividad del vehículo. El dato se entrega en UTC.
start_latitudeDoubleLatitud donde comienza la actividad del vehículo.
start_longitudeDoubleLongitud donde comienza la actividaddel vehículo.
end_latitudeDoubleLatitud donde finaliza la actividad del vehículo.
end_longitudeDoubleLongitud donde finaliza la actividad del vehículo.
distanceBigintDistancia en metros que reccorrio el vehículo en el periodo que duro la actividad del vehículo.
avg_speedDoubleVelocidad promedio en la que anduvo el vehículo durante su actividad. Su unidad es Km/h.
max_speedDoubleVelocidad máxima que alcanzo el vehículo durante su actividad. Su unidad es Km/h.
duration_secondsBigintDuración en segundos que duro la actividad del vehículo. Corresponde a la suma de los tiempos on, idle, y off.
time_on_secondsBigintTiempo en segundos que el vehículo se encontraba en movimiento.
time_idle_secondsBigintTiempo en segundos que el vehículo se encontraba en ralenti.
time_off_secondsBigintTiempo en segundos que el vehículo se encontraba apagado.
driver_idIntegerId del conductor que tenia el vehículo durante su actividad.
\n

Los estados de la actividad en un viaje se pueden explicar en tres:

\n\n","urlObject":{"protocol":"https","path":["v1","base","status"],"host":["reportes","waypoint","cl"],"query":[],"variable":[]}},"response":[{"id":"65f68f99-52e3-450b-9b90-2c07284ef12e","name":"Status 200","originalRequest":{"method":"POST","header":[{"key":"","value":"","type":"text"},{"key":"","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id\": \"380195ea-76cb-48cb-a3z8-5af45f2235c\",\n \"nombreReporte\": \"reporte-actividad-vehiculo\"\n}","options":{"raw":{"language":"json"}}},"url":"https://reportes.waypoint.cl/v1/base/status"},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Date","value":"Wed, 29 Oct 2025 23:47:06 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"26"},{"key":"Connection","value":"keep-alive"},{"key":"x-amzn-RequestId","value":"80604deb-9140-4bc8-8339-a4f3e4e4950b"},{"key":"x-amzn-ErrorType","value":"UnauthorizedException"},{"key":"x-amz-apigw-id","value":"TO8bMG2OoAMEOjA="}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"url\": \"https://informesreports2.s3.amazonaws.com/final/reporte-3826dd41-8bb1-446c-8bac-17e8901eefa0.json\",\n \"status\": \"SUCCEEDED\",\n \"id\": \"06814670-ebb8-4df7-9462-548ac43628b7\"\n}"}],"_postman_id":"3bd0dece-b970-4b40-bf05-efae6db00510"}],"id":"91881ea1-b83f-478b-979b-47470aa9b89a","description":"

Conjunto de servicios para obtener información sobre el comportamiento de los vehículos a los cuales tengo acceso como usuario

\n","_postman_id":"91881ea1-b83f-478b-979b-47470aa9b89a"}]}