{"info":{"_postman_id":"72ebbb39-f318-4ae3-928a-aa1ae54ad823","name":"API Historial de Ruta","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"description":"","owner":"50892995","collectionId":"72ebbb39-f318-4ae3-928a-aa1ae54ad823","publishedId":"2sBY4JvhjW","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-07-15T13:52:40.000Z"},"item":[{"name":"Obtener token","event":[{"listen":"test","script":{"exec":["const jsonData = pm.response.json();","const wpsid = pm.response.headers.get(\"wpsid\");","pm.environment.set(\"token\", jsonData.AuthenticationResult.AccessToken);","pm.environment.set(\"wpsid\", wpsid);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"345e0469-61a4-4ac7-b0e8-a19f7bab241b","request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"user\": \"user\",\r\n \"password\": \"password1\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.waypoint.cl/auth/login","description":"

Paso 1

\n

Se debe realizar una consulta POST a la API de sesiones para obtener el AccesToken que usaremos en el paso 2 para consumir la api historial de ruta.

\n","urlObject":{"protocol":"https","path":["auth","login"],"host":["api","waypoint","cl"],"query":[],"variable":[]}},"response":[],"_postman_id":"345e0469-61a4-4ac7-b0e8-a19f7bab241b"},{"name":"Generar reporte","id":"77fc19c6-f3ae-4fbc-b1fc-7a0bb77309d0","request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"x-api-key","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"listPatentes\": [],\n \"clientId\": 3321,\n \"desde\": \"2026-07-02 00:00:00\",\n \"hasta\": \"2026-07-02 23:59:59\",\n \"maxHdop\": 2.4,\n \"formato\": \"json\",\n \"minNsat\": 5,\n \"minDetencion\": \"3600\",\n \"ignicion\": false,\n \"zoneId\": \"America/Santiago\",\n \"zona\": false,\n \"interseccion\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://reportes.waypoint.cl/v1/base/historial-ruta","description":"

Paso 2

\n

Se debe realizar una consulta de tipo POST y debemos agregar el token obtenido en el paso 1 como se muestra en la siguiente imagen.

\n

Esta solicitud requiere de x-api-key que se debe añadir en el header de la solicitud.

\n

Finalmente agregamos el body, apretamos send y la respuesta que nos de la copiaremos para usarlo en el paso 3.

\n

Detalle de los valores del Body

\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
CampoValor de ejemploSignificado
listPatentes[]Lista de patentes de los vehículos a solicitar.
clientId3321ID del tenant a solicitar.
desde2026-07-02 00:00:00Fecha y hora de inicio del reporte.
hasta2026-07-02 23:59:59Fecha y hora de fin del reporte.
maxHdop2.4 (recomendado)Máximo valor HDOP permitido.
formatojsonFormato de salida del reporte, \"json\" o \"excel\".
minNsat5 (recomendado)Mínimo número de satélites.
minDetencion3600 (recomendado)Tiempo mínimo de detención.
ignicionfalseFiltro de ignición. por defecto va en false.
ignicion = false solo trae los vehículos con ignición encendida.
ignicion = true trae tanto encendida como apagada.
zoneIdAmerica/SantiagoZona horaria.
zonafalseFiltro por zona.
zona = true a cada punto trae la zona del cliente donde cae ese punto. Debe estar creada la zona en la plataforma
interseccionfalseFiltro por intersección.
Interseccion = true trae la dirección de la lat-long en dirección escrita
\n
","urlObject":{"protocol":"https","path":["v1","base","historial-ruta"],"host":["reportes","waypoint","cl"],"query":[],"variable":[]}},"response":[],"_postman_id":"77fc19c6-f3ae-4fbc-b1fc-7a0bb77309d0"},{"name":"Status y archivo","id":"e70249c2-24df-4259-bd2c-6dff8d76970c","request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"id\": \"15068a6d-ab32-4117-9ca6-0e7e14f217ac\",\r\n \"nombreReporte\": \"reporteHistorialApiStateMachine\",\r\n \"count\": true\r\n} ","options":{"raw":{"language":"json"}}},"url":"https://reportes.waypoint.cl/v1/base/status","description":"

Paso 3

\n

Se debe realizar una consulta de tipo POST y en el Body agregamos la respuesta del paso 2 más un atributo \"count\": true como se muestra en la siguiente imagen.

\n

Cuando la petición este lista el status será SUCCEEDED (200) y nos mostrara una url la cual tendrá un archivo json con la data solicitada.

\n

Detalle de los valores del Body

\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
CampoValor de ejemploSignificado
id15068a6d-ab32-4117-9ca6-0e7e14f217acID del reporte (obtenido en la respuesta del paso 2).
nombreReportereporteHistorialApiStateMachineNombre del reporte (obtenido en la respuesta del paso 2).
counttrueAtributo adicional para la consulta, debe ser True.
\n
\n

Respuesta de la API

\n

La consulta de la API entrega información consolidados entre todos los registros solicitados, en conjunto con 4 arreglos: pstart, pend, data y stop. pstart representa los datos GPS del primer registro, pend del último y data incluye todos los registros GPS. stop representa la información entre los puntos de detención (velocidad 0 o ignición apagada).

\n

Datos consolidados

\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
VariableSignificado
icoNombre del ícono que se mostrará en la plataforma de Tranciti según el tipo de vehículo.
ptimeTiempo en segundos hacia atrás de vigencia del vehículo con ese GPS (permite saber el tiempo hacia atrás máximo que debes considerar que el vehículo no ha cambiado de GPS).
elapsedTiempo en milisegundos que se demoró el api en generar los datos.
vsizeCantidad de datos GPS que la API retornó en base a la solicitud.
vrealtimeCantidad de datos GPS que fueron recibidos en tiempo real.
vbackupCantidad de datos GPS que fueron recibidos en \"backup\" o con retraso.
vvmaxVelocidad máxima registrada.
vvavgVelocidad promedio entre los registros.
vdistanceDistancia recorrida por el vehículo según los registros GPS en metros.
vtimeTiempo transcurrido según los datos GPS en segundos.
\n

pstart, pend y data

\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
VariableSignificado
patentePlaca/Patente del vehículo asociado a los datos GPS.
imeiIMEI del equipo GPS asociado al vehículo.
indiceValor deprecado que siempre indica 0. No tiene significado en la actualidad.
epochFecha de generación del dato GPS en formato epoch.
nsatNúmero de satélites registrados en el dato GPS. A mayor, mejor calidad.
hdopDilución horizontal de la precisión. A menor valor, mejor calidad.
ignIgnición del vehículo en ese dato GPS. 1 representa encendida y 0 apagada.
latLatitud de la posición GPS.
lonLongitud de la posición GPS.
cog\"Course over ground\" donde el norte es 0.
sog\"Speed over ground\". Velocidad del vehículo según el registro GPS.
adc, adc2, adc3, adc4Entradas analógicas del GPS. Su interpretación depende de lo configurado en el equipo GPS.
input1, input2, input3, input4Entradas digitales del GPS. Son señales de ON/OFF (0 o 1) conectadas a distintos sensores o dispositivos eléctricos. En caso de no haber sensores, arroja un valor de -1. Su interpretación depende de lo configurado en el equipo GPS.
ibuttonCódigo identificador driverid.
identificadoCódigo identificador del ibutton.
powerIndica si el GPS está recibiendo corriente.
rtIndica si el dato fue recibido en tiempo real o con retraso. \"true\" indica que fue en tiempo real.
zonaEn caso de que el vehículo estuviese en una zona registrada en Tranciti, se muestra el nombre de dicha zona.
bateriaBatería del vehículo según el equipo GPS en volts.
bateriaintBatería del equipo GPS en volts.
odometroOdómetro registrado en el dato GPS según el equipo.
eventidIdentificador del evento que provocó el envío de datos GPS al sistema.
conductorNombre del conductor registrado en la plataforma en el momento de la generación del dato GPS.
\n

stop

\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
VariableSignificado
claseTipo de detención. 1 representa velocidad 0 y 2 representa ignición apagada.
latLatitud de la posición GPS en la detención.
lonLongitud de la posición GPS en la detención.
tstartFecha de inicio de detención del dato GPS en formato epoch.
tendFecha de término de detención del dato GPS en formato epoch.
cantidadCantidad de registros GPS en la detención.
tiempoDuración de la detención en segundos.
distanciaDistancia recorrida en la detención. Este dato está en metros.
zonaEn caso de que el vehículo estuviese en una zona registrada en Tranciti, se muestra el nombre de dicha zona donde se produjo la detención.
\n
\n

IMPORTANTE

\n

Para garantizar un rendimiento óptimo y una respuesta eficiente de la API, se recomienda enfáticamente que las peticiones se realicen utilizando un rango de tiempo limitado a 1 día. Esto significa que al solicitar datos, el intervalo entre la fecha de inicio y la fecha de fin no debe exceder las 24 horas.

\n","urlObject":{"protocol":"https","path":["v1","base","status"],"host":["reportes","waypoint","cl"],"query":[],"variable":[]}},"response":[],"_postman_id":"e70249c2-24df-4259-bd2c-6dff8d76970c"}]}