{"info":{"_postman_id":"c2d4f3ca-c61f-4bb4-aa7d-a9f4306b126c","name":"API Módulo de Mantenimiento","description":"

La siguiente API Rest tiene como objetivo brindar una forma fácil de gestionar las mantenciones presentes, pasadas y futuras de sus vehículos registrados en Tranciti.

Se permite programar mantenciones.

Se permite registrar mantenciones; programadas, correctivas y de siniestro.

Se permite obtener metadata necesaria para los llamados a programaciones y registros de mantención.

Se permite obtener mantenciones actuales e historicas, tal como se muestra en la aplicación web.

Se permite obtener un historial de registros de mantenciones, tal como sería el reporte de registro de mantenciones desde la aplicación web.

Todo sigue la misma lógica presente en la aplicación web.

Resumen de endpoints:

https://api.tranciti.com/mantenimiento/programar-mantencion
\n
- Tipo de request: POST
  \n
- Seguridad: Sí
  \n
  - API key (entregada por cliente)
    \n
  - id-client ( int del cliente autorizado)
    \n
  - Bearer token (usuario solicitante que ve los vehículos en la web de Mantenimiento)
    \n
  \n
\n
https://api.tranciti.com/mantenimiento/registrar-mantencion
\n
- Tipo de request: POST
  \n
- Seguridad: Sí
  \n
  - API key (entregada por cliente)
    \n
  - id-client ( int del cliente autorizado)
    \n
  - Bearer token (usuario solicitante que ve los vehículos en la web de Mantenimiento)
    \n
  \n
\n
https://api.tranciti.com/mantenimiento/metadata
\n
- Tipo de request: GET
  \n
- Seguridad: Sí
  \n
  - id-client ( int del cliente autorizado)
    \n
  - Bearer token (usuario solicitante que ve los vehículos en la web de Mantenimiento)
    \n
  \n
\n
https://api.tranciti.com/mantenimiento/mantenciones
\n
- Tipo de request: GET
  \n
- Seguridad: Sí
  \n
  - id-client ( int del cliente autorizado)
    \n
  - Bearer token (usuario solicitante que ve los vehículos en la web de Mantenimiento)
    \n
  - API key (entregada por cliente)
    \n
  \n
\n
https://api.tranciti.com/mantenimiento/registro-mantenciones
\n
- Tipo de request: POST
  \n
- Seguridad: Sí
  \n
  - id-client ( int del cliente autorizado)
    \n
  - Bearer token (usuario solicitante que ve los vehículos en la web de Mantenimiento)
    \n
  - API key (entregada por cliente)
    \n
  \n
\n

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"50892995","collectionId":"c2d4f3ca-c61f-4bb4-aa7d-a9f4306b126c","publishedId":"2sBXVZpuxN","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-12-26T17:44:46.000Z"},"item":[{"name":"Obtener token de autorización","id":"d80dfcca-c5dd-4bca-927d-3d726b69a961","request":{"method":"GET","header":[],"url":"https://api.waypoint.cl/auth/login?user={{user}}&password={{password}}","description":"

Request que permite obtener el token de autorización.

Se recomienda utilizar el paso de variables en la URL a fin de no revelar información confidencial

Respuestas:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
200	Petición procesada correctamente. Se retorna el AccessToken en el body.
400	Se ha producido un error por falta de parámetros o parámetros incorrectos.

Ejemplo de respuesta código 200:

{\n    \"AccessToken\": \"eyJraWQiOiJEREhzTFdYUURUOGpBYSt4...\"\n}\n\n

Ejemplo de respuesta código 400 por falta de parámetros o usuario no encontrado:

{\n    \"error\": {}\n}\n\n

Ejemplo de respuesta código 400 por clave incorrecta:

{\n    \"error\": \"Invalid password for user USER\"\n}\n\n

\n","urlObject":{"protocol":"https","path":["auth","login"],"host":["api","waypoint","cl"],"query":[{"key":"user","value":"{{user}}"},{"key":"password","value":"{{password}}"}],"variable":[]}},"response":[{"id":"0ae4d14a-f7cc-4ee0-92fc-4a0e6ca9364c","name":"Obtener token de autorización","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.waypoint.cl/auth/login?user={{user}}&password={{password}}","protocol":"https","host":["api","waypoint","cl"],"path":["auth","login"],"query":[{"key":"user","value":"{{user}}"},{"key":"password","value":"{{password}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 03 Nov 2023 19:13:02 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"985"},{"key":"Connection","value":"keep-alive"},{"key":"x-amzn-RequestId","value":"ddbdbcbd-846b-4d32-93c8-bbb42da2de44"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Headers","value":"Content-Type,X-Amz-Date,Authorization,X-Api-Key,X-Amz-Security-Token"},{"key":"x-amz-apigw-id","value":"N1fpIG8MyK4EWyA="},{"key":"Access-Control-Allow-Methods","value":"OPTIONS,GET"},{"key":"X-Requested-With","value":"*"},{"key":"X-Amzn-Trace-Id","value":"Root=1-6545463a-43cefda41674e8310dd6646a;Sampled=0;lineage=4d9fa0f3:0"}],"cookie":[],"responseTime":null,"body":"{\n \"AccessToken\": \"ezyJraWQiOiJ2pRcFNEMVlaV....\"\n}"}],"_postman_id":"d80dfcca-c5dd-4bca-927d-3d726b69a961"},{"name":"Obtener metadata de mantención","id":"c908f8e1-e2e1-47ed-92c8-fc41418a3621","request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"x-api-key","value":"{{x-api-key}}","type":"text"},{"key":"id-client","value":"{{id-client-autorizado}}","type":"text"}],"url":"https://api.tranciti.com/mantenimiento/metadata","description":"

Este endpoint permite obtener la metadata necesaria para operar el módulo de Mantenimiento (misma lógica que la web):

Vehículos (flota)
\n
Actividades y tareas
\n
Proveedores
\n
Responsables
\n

Datos de entrada (headers)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	¿Requerido?	Tipo	Descripción
`x-api-key`	Siempre	String	API key del cliente.
`id-client`	Siempre	Integer (string en header)	ID del cliente autorizado.
`Authorization`	Siempre	String	`Bearer` del usuario.

Respuestas

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
200	Retorna `vehiculos`, `actividades`, `proveedores`, `responsables`.
400	Falta `id-client` o es inválido.
401	Falta Authorization o formato incorrecto.
401	Token inválido o usuario no encontrado.
401	No se pudo validar sesión legacy (Redis).
500	Error interno.

Descripción de respuesta

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campos dentro de json body	Descripción
vehiculos	Array de json's que contienen: `idVehiculo` -> id del vehículo. `imei` -> imei del vehículo. `patente` -> patente del vehículo. `descripcion` -> descripción del vehículo. `grupo` -> grupo al que pertenece el vehículo.
actividades	Array de json's que contienen: `actividad` -> nombre de actividad. `id` -> id de la actividad `tareas` -> Array de json's que contiene `id` de tarea y `nombre` de tarea.
proveedores	Array de json's que contienen: `id` -> id de proveedor. `nombre` -> nombre de proveedor.
responsables	Array de json's que contienen: `id` -> id de responsable. `nombre` -> nombre de responsable. `correo` -> correo de responsable.

","urlObject":{"protocol":"https","path":["mantenimiento","metadata"],"host":["api","tranciti","com"],"query":[],"variable":[]}},"response":[{"id":"69a5b3fc-92e3-4337-8867-cc8675a002a1","name":"Metadata (OK)","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{token}}","type":"text"},{"key":"id-client","value":"{{id-client-autorizado}}","type":"text"},{"key":"","value":"","type":"text","disabled":true}],"url":"https://api.tranciti.com/mantenimiento/metadata"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"vehiculos\": [\n {\n \"idVehiculo\": 501562,\n \"imei\": 123213213,\n \"patente\": \"ABCD12\",\n \"descripcion\": \"Camioneta demo 1\",\n \"grupo\": \"Operaciones\"\n },\n {\n \"idVehiculo\": 565013,\n \"imei\": 45435,\n \"patente\": \"WLYM34\",\n \"descripcion\": \"Camión demo 2\",\n \"grupo\": \"Operaciones\"\n }\n ],\n \"actividades\": [\n {\n \"actividad\": \"cambio de aceite\",\n \"id\": 101,\n \"tareas\": [\n { \"id\": 1001, \"nombre\": \"revisar nivel de aceite\" },\n { \"id\": 1002, \"nombre\": \"reemplazar filtro\" }\n ]\n },\n {\n \"actividad\": \"cambio de neumaticos\",\n \"id\": 12,\n \"tareas\": []\n }\n ],\n \"proveedores\": [\n { \"id\": 21, \"nombre\": \"Proveedor Demo\" },\n { \"id\": 22, \"nombre\": \"Taller Ejemplo\" }\n ],\n \"responsables\": [\n { \"id\": 31, \"nombre\": \"María Pérez\", \"correo\": \"maria.perez@ejemplo.cl\" },\n { \"id\": 32, \"nombre\": \"Juan Soto\", \"correo\": \"juan.soto@ejemplo.cl\" }\n ]\n}"}],"_postman_id":"c908f8e1-e2e1-47ed-92c8-fc41418a3621"},{"name":"Obtener mantenciones","id":"04e4ed2c-848d-4249-94a4-805f6b224cb5","request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"x-api-key","value":"{{x-api-key}}","type":"text"},{"key":"id-client","value":"{{id-client-autorizado}}","type":"text"}],"url":"https://api.tranciti.com/mantenimiento/mantenciones","description":"

Este endpoint permite obtener la información de mantenciones del módulo de Mantenimiento, siguiendo la misma lógica y formato de datos que la aplicación web.

Soporta:

Mantenciones programadas (estado=1)
\n
Mantenciones próximas (estado=2)
\n
Mantenciones vencidas (estado=3)
\n
Mantenciones en proceso (estado=4)
\n
Mantenciones realizadas (estado=5)
\n

Seguridad (Headers)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	¿Requerido?	Descripción
`x-api-key`	Sí	API key entregada por cliente.
`id-client`	Sí	ID del cliente autorizado.
`Authorization`	Sí	`Bearer` del usuario.

Query Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	¿Requerido?	Formato	Descripción
`estado`	No	`\"1,2,3\"`	Estados a retornar. Si se omite o viene vacío, retorna todos (1..5).
`patente-descripcion`	No	string	Filtra por patente o descripción (substring, case-insensitive).
`fecha-inicio`	No*	`YYYY-MM-DD`	Solo aplica cuando se solicita estado 5 (Realizadas). Filtra aquellas mantenciones cuya fecha de realización sea mayor o igual a este día. Si viene, se valida que sea el formato YYYY-MM-DD correcto.
`fecha-final`	No*	`YYYY-MM-DD`	Solo aplica cuando se solicita estado 5 (Realizadas). Solo aplica cuando se solicita estado 5 (Realizadas). Filtra aquellas mantenciones cuya fecha de realización sea menor o igual a este día. Si viene, se valida que sea el formato YYYY-MM-DD correcto.

* Si se solicita estado=5 y no se entregan fechas, se aplica un rango por defecto: desde hace 2 meses hasta hoy (zona horaria UTC-3). Si fecha-inicio es posterior a fecha-final, se invierten automáticamente.

Respuestas

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
200	Retorna un JSON con solo los arreglos solicitados según `estado`.
400	Falta `id-client` o es inválido.
401	Falta `Authorization` o formato incorrecto.
401	Token inválido o usuario no encontrado.
401	No se pudo validar sesión.
500	Error interno o falla al consultar servidores.

Descripción de la respuesta

La respuesta es un objeto JSON que puede incluir (según lo solicitado):

programadas (estado=1)
\n
proximas (estado=2)
\n
vencidas (estado=3)
\n
en_proceso (estado=4)
\n
realizadas (estado=5)
\n

Estructura de items para `programadas` / `proximas` / `vencidas`

\n
Mismo formato en los 3 arreglos; cambia el valor del campo estado (\"Programada\" / \"Próxima\" / \"Vencida\").
\n

Campo	Tipo	Descripción
`id`	number	Es el id de la programación asociada, parámetro importante para enviar en caso de querer registrar una mantención en el endpoint de /registrar-mantencion. Puede ser null en caso de que sea un registro del tipo correctivo o de siniestro, ya que no tienen programación asociada como tal.
`estado`	string	Estado de la mantención (Programada/Próxima/Vencida).
`ot`	string	Orden de trabajo, es un string de 5 digitos; Ejemplo: \"00012\", \"01234\".
`patente`	string	Patente de vehículo.
`descripcion`	string	Descripción de vehículo.
`responsable`	string	Responsable, persona a cargo registrada.
`grupo`	string	Grupo al que pertenece el vehículo.
`mantencion`	string	Nombre de la mantención.
`alertas`	array	Lista de alertas configuradas: puede incluir `\"Odómetro\"`, `\"Horómetro\"`, `\"Fecha\"` (si alguna no aplica viene como `null`).
`proxima_mantencion_odometro`	string	Próxima mantención de odómetro, el string incluye un número y una únidad, idéntico a lo que aparece en la webapp. Puede ser null en caso de que no venga \"Odómetro\" en el array de alertas bajo este mismo ítem.
`proxima_mantencion_horometro`	string	Próxima mantención de horómetro, el string incluye un número y una únidad, idéntico a lo que aparece en la webapp. Puede ser null en caso de que no venga \"Horómetro\" en el array de alertas bajo este mismo ítem.
`proxima_mantencion_fecha`	string	Próxima mantención de tipo fecha, el string incluye un número y una únidad, idéntico a lo que aparece en la webapp. Puede ser null en caso de que no venga \"Fecha\" en el array de alertas bajo este mismo ítem.
`valor_actual_odometro`	string	Valor actual del odómetro, el string incluye un número y una únidad, idéntico a lo que aparece en la webapp. Puede ser null en caso de que no venga \"Odómetro\" en el array de alertas bajo este mismo ítem.
`valor_actual_horometro`	string	Valor actual del horómetro, el string incluye un número y una únidad, idéntico a lo que aparece en la webapp. Puede ser null en caso de que no venga \"Horómetro\" en el array de alertas bajo este mismo ítem.
`valor_actual_fecha`	string	Valor actual de la última emisión de GPS, el string incluye un número y una únidad, idéntico a lo que aparece en la webapp. Puede ser null en caso de que no venga \"Fecha\" en el array de alertas bajo este mismo ítem.
`faltante_odometro`	string	Lo que falta respecto a la configuración de alerta de odómetro, para la mantención de odómetro. El string incluye un número y una únidad, idéntico a lo que aparece en la webapp. Puede ser null en caso de que no venga \"Odómetro\" en el array de alertas bajo este mismo ítem.
`faltante_horometro`	string	Lo que falta respecto a la configuración de alerta de horómetro, para la mantención de horómetro. El string incluye un número y una únidad, idéntico a lo que aparece en la webapp. Puede ser null en caso de que no venga \"Horómetro\" en el array de alertas bajo este mismo ítem.
`faltante_fecha`	string	Lo que falta respecto a la configuración de alerta de según fecha, para la mantención según fecha. El string incluye un número y una únidad, idéntico a lo que aparece en la webapp. Puede ser null en caso de que no venga \"Fecha\" en el array de alertas bajo este mismo ítem.
`notificacion_odometro`	string	Configuración de notificación que indica cuanto \"antes\" de lo programado se debe notificar la mantención de odómetro. El string incluye un número y una únidad, idéntico a lo que aparece en la webapp. Puede ser null en caso de que no venga \"Odómetro\" en el array de alertas bajo este mismo ítem.
`notificacion_horometro`	string	Configuración de notificación que indica cuanto \"antes\" de lo programado se debe notificar la mantención de horómetro. El string incluye un número y una únidad, idéntico a lo que aparece en la webapp. Puede ser null en caso de que no venga \"Horómetro\" en el array de alertas bajo este mismo ítem.
`notificacion_fecha`	string	Configuración de notificación que indica cuanto \"antes\" de lo programado se debe notificar la mantención según fecha. El string incluye un número y una únidad, idéntico a lo que aparece en la webapp. Puede ser null en caso de que no venga \"Fecha\" en el array de alertas bajo este mismo ítem.
`intervalo_odometro`	string	Intervalo configurado para repetir la alerta de odómetro, el string incluye un número y una únidad, idéntico a lo que aparece en la webapp. Puede ser null en caso de que no venga \"Odómetro\" en el array de alertas bajo este mismo ítem. Solo recurrentes.
`intervalo_horometro`	string	Intervalo configurado para repetir la alerta de horómetro, el string incluye un número y una únidad, idéntico a lo que aparece en la webapp. Puede ser null en caso de que no venga \"Horómetro\" en el array de alertas bajo este mismo ítem. Solo recurrentes.
`intervalo_fecha`	string	Intervalo configurado para repetir la alerta según fecha, el string incluye un número y una únidad, idéntico a lo que aparece en la webapp. Puede ser null en caso de que no venga \"Fecha\" en el array de alertas bajo este mismo ítem. Solo recurrentes.

Estructura de items para `en_proceso`

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descripción
`id`	number	Es el id de la programación asociada, parámetro importante para enviar en caso de querer registrar una mantención en el endpoint de /registrar-mantencion. Puede ser null en caso de que sea un registro del tipo correctivo o de siniestro, ya que no tienen programación asociada como tal.
`estado`	string	Siempre `\"En proceso\"`.
`hes`	string	Nombre registrado en campo HES, referente a la hoja de servicios.
`ot`	string	Orden de trabajo, es un string de 5 digitos; Ejemplo: \"00012\", \"01234\".
`patente`	string	Patente de vehículo.
`descripcion`	string	Descripción de vehículo.
`responsable`	string	Responsable, persona a cargo registrada.
`grupo`	string	Grupo al que pertenece el vehículo.
`mantencion`	string	Nombre de la mantención.
`fecha_mantencion`	string	Fecha registrada para realizar la mantención, en caso de tener configurada alerta según fecha, null en caso contrario.
`odometro_mantencion`	string	Odómetro registrado para realizar la mantención, en caso de tener configurada alerta según odómetro, null en caso contrario.
`horometro_mantencion`	string	Horómetro registrado para realizar la mantención, en caso de tener configurada alerta según horómetro, null en caso contrario.

Estructura de items para `realizadas`

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descripción
`id`	number	Es el id de la programación asociada, que ya fue registrada. Puede ser null en caso de que sea un registro del tipo correctivo o de siniestro, ya que no tienen programación asociada como tal.
`estado`	string	Siempre `\"Realizada\"`.
`hes`	string	Nombre registrado en campo HES, referente a la hoja de servicios.
`ot`	string	Orden de trabajo, es un string de 5 digitos; Ejemplo: \"00012\", \"01234\".
`patente`	string	Patente de vehículo.
`descripcion`	string	Descripción de vehículo.
`responsable`	string	Responsable, persona a cargo registrada.
`grupo`	string	Grupo al que pertenece el vehículo.
`nombre`	string	Nombre de la mantención.
`tipo`	string	Puede ser: Programada,Correctiva,Siniestro.
`recurrente`	string	`\"SI\"` o `\"NO\"` según si la programación es recurrente.
`fecha`	string	Fecha en la que fué registrada la mantención.
`alerta_odometro_intervalo_km`	string	Configuración que tenía la alerta de odómetro, para la mantención ya realizada. String con un número que indica en kilómetros, lo que fué configurado. Idéntico a lo que aparece en la webapp. Lo importante es el número de la izquierda, que indica los kilómetros. Ejemplo: 1 (2). -> 1 kilómetro. Puede ser null si la mantención no incluia alerta de odómetro.
`alerta_horometro_intervalo_hr`	string	Configuración que tenía la alerta de horometro, para la mantención ya realizada. String con un número que indica en horas, lo que fué configurado. Idéntico a lo que aparece en la webapp. Lo importante es el número de la izquierda, que indica las horas. Ejemplo: 542 (4). -> 542 horas. Puede ser null si la mantención no incluia alerta de horometro.
`alerta_fecha_intervalo`	string	Configuración que tenía la alerta según fecha, para la mantención ya realizada. String con una fecha que indica en dd/mm/yyyy, la configuración de la alerta de fecha. Idéntico a lo que aparece en la webapp. Ejemplo: 09/01/2026. Puede ser null si la mantención no incluia alerta de fecha.

\n
Todas las fechas entregadas por la api están en dd/mm/yyyy.
\n

Nota: los valores y formatos de estos campos corresponden al mismo contenido mostrado por la aplicación web del módulo de Mantenimiento. Diferencia es que los campos vacíos o no seteados, vienen en null, a menos que literalmente se hayan seteado como \"-\".

\n","urlObject":{"protocol":"https","path":["mantenimiento","mantenciones"],"host":["api","tranciti","com"],"query":[{"disabled":true,"description":{"content":"

Fecha inicio (YYYY-MM-DD). Solo se valida y aplica cuando se solicita estado 5 (Realizadas). Si se omite y se pidió estado 5, el backend asume por defecto 'hace 2 meses'.

\n","type":"text/plain"},"key":"fecha-inicio","value":"2025-11-06"},{"disabled":true,"description":{"content":"

Fecha final (YYYY-MM-DD). Solo se valida y aplica cuando se solicita estado 5 (Realizadas). Si se omite y se pidió estado 5, el backend asume por defecto 'hoy'.

\n","type":"text/plain"},"key":"fecha-final","value":"2026-01-06"},{"disabled":true,"description":{"content":"

Filtro por patente o descripción (substring, case-insensitive). Se aplica a todos los arreglos devueltos.

\n","type":"text/plain"},"key":"patente-descripcion","value":"ABCD12"},{"disabled":true,"description":{"content":"

Números, separados por ',', indicando que tipos de mantenciones se quieren obtener.

\n","type":"text/plain"},"key":"estado","value":"1,2,3,4,5"}],"variable":[]}},"response":[{"id":"8d0b4b1d-3312-4961-a612-08b216cad937","name":"Mantenciones (OK)","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{token}}","type":"text"},{"key":"id-client","value":"{{id-client-autorizado}}","type":"text"},{"key":"x-api-key","value":"{{x-api-key}}","type":"text"}],"url":{"raw":"https://api.tranciti.com/mantenimiento/mantenciones?estado=1,2,3,4,5&patente-descripcion=ABCD12","protocol":"https","host":["api","tranciti","com"],"path":["mantenimiento","mantenciones"],"query":[{"key":"estado","value":"1,2,3,4,5"},{"key":"patente-descripcion","value":"ABCD12"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"programadas\": [\n {\n \"id\": 121253,\n \"estado\": \"Programada\",\n \"ot\": \"00050\",\n \"patente\": \"ZJ-4593\",\n \"descripcion\": \"DEFENDER\",\n \"responsable\": \"N/D\",\n \"grupo\": \"Test2\",\n \"mantencion\": \"test manu 2\",\n \"alertas\": [\"Odómetro\", \"Horómetro\", \"Fecha\"],\n \"proxima_mantencion_odometro\": \"10.000 km\",\n \"proxima_mantencion_horometro\": \"10.000 hrs\",\n \"proxima_mantencion_fecha\": \"04/09/2025\",\n \"valor_actual_odometro\": \"208.857 km\",\n \"valor_actual_horometro\": \"208.851 hrs\",\n \"valor_actual_fecha\": \"06/01/2026\",\n \"faltante_odometro\": \"-198.857 km\",\n \"faltante_horometro\": \"-198.857 hrs\",\n \"faltante_fecha\": \"-4,1 meses\",\n \"notificacion_odometro\": \"2 km\",\n \"notificacion_horometro\": \"1 hrs\",\n \"notificacion_fecha\": \"42 horas\",\n \"intervalo_odometro\": \"4 km\",\n \"intervalo_horometro\": \"5 hrs\",\n \"intervalo_fecha\": \"32 días\"\n }\n ],\n \"proximas\": [],\n \"vencidas\": [],\n \"en_proceso\": [\n {\n \"id\": 10,\n \"estado\": \"En proceso\",\n \"hes\": \"-\",\n \"ot\": \"00010\",\n \"patente\": \"FJDS-33\",\n \"descripcion\": \"PEDRO\",\n \"responsable\": \"N/D\",\n \"grupo\": \"Grupo 4\",\n \"mantencion\": \"ajsidjaisdnjad\",\n \"fecha_mantencion\": null,\n \"odometro_mantencion\": null,\n \"horometro_mantencion\": \"11.000\"\n }\n ],\n \"realizadas\": [\n {\n \"id\": 6542,\n \"estado\": \"Realizada\",\n \"hes\": \"ENTRADA TEST\",\n \"ot\": \"00072\",\n \"patente\": \"DEMO J\",\n \"descripcion\": null,\n \"responsable\": \"N/D\",\n \"grupo\": \"Test2\",\n \"nombre\": \"TEST REGISTRO ABARCA\",\n \"tipo\": \"Programada\",\n \"recurrente\": \"SI\",\n \"fecha\": \"17/12/2025\",\n \"alerta_odometro_intervalo_km\": \"1 (2)\",\n \"alerta_horometro_intervalo_hr\": \"1 (4)\",\n \"alerta_fecha_intervalo\": \"06/01/2026\"\n }\n ]\n}\n"}],"_postman_id":"04e4ed2c-848d-4249-94a4-805f6b224cb5"},{"name":"Programar nuevas mantenciones","id":"d4eb0b27-61a8-46f6-ba75-ef2500e1e830","request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"x-api-key","value":"{{x-api-key}}","type":"text"},{"key":"id-client","value":"{{id-client-autorizado}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"idClient\": 1040,\n \"maintenanceList\": [\n {\n \"generalInfo\": {\n \"name\": \"Esta es una mantención recurrente\",\n \"recurring\": true,\n \"description\": \"Mantención cada 10mil kilómetros que avisa 200km antes y luego avisa de nuevo pasado 300 horas\",\n \"responsibleId\": 999999,\n \"activitiesIdsList\": [\n 1234,\n 5678\n ],\n \"isActive\": true\n },\n \"alertConfig\": {\n \"hourmeter\": {\n \"interval\": \"10000\",\n \"notification\": \"200\"\n }\n },\n \"vehicleList\": [\n {\n \"id\": 112233,\n \"hourmeter\": 1000\n },\n {\n \"id\": 445566,\n \"hourmeter\": 2000\n }\n ],\n \"alertEmails\": {\n \"responsibleIdsList\": [\n 888888\n ],\n \"postExpirationList\": [\n {\n \"title\": \"Título post-alerta vencida\",\n \"hours\": 300,\n \"recipientsIdsList\": [\n 777777\n ]\n }\n ]\n }\n },\n {\n \"generalInfo\": {\n \"name\": \"Mantención especial\",\n \"recurring\": false,\n \"description\": \"Esta es una mantención no-recurrente (normal, de una sola instancia)\",\n \"responsibleId\": 444444,\n \"activitiesIdsList\": [\n 12345678\n ],\n \"isActive\": true\n },\n \"alertConfig\": {\n \"odometer\": {\n \"interval\": \"10000\",\n \"notification\": \"201\"\n }\n },\n \"vehicleList\": [\n {\n \"id\": 111222,\n \"odometer\": 1000\n },\n {\n \"id\": 333444,\n \"odometer\": 3000\n }\n ],\n \"alertEmails\": {\n \"responsibleIdsList\": [\n 111111\n ]\n }\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.tranciti.com/mantenimiento/programar-mantencion","description":"

Este endpoint permite ingresar la información de próximas mantenciones sobre sus vehículos. La información debe cumplir con un formato preciso para ser válida según se detalla en la siguiente tabla y los ejemplos adjuntos.

Se permite crear máximo 5 mantenciones por consulta.

Datos de entrada

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Nombre del campo	Ubicación en JSON de body	¿Requerido?	Tipo de dato	Descripción / Relación
`idClient`	Raíz del JSON	Siempre	Integer	ID de Cliente. Debe ser un número entero positivo. Este valor debe ser consultado a su Ejecutivo/a comercial
`maintenanceList`	Raíz del JSON	Siempre	Array de objetos anidados con subobjetos `generalInfo`, `alertConfig`, `vehicleList`y `alertEmails`	Lista de eventos de mantenimiento. No puede ser un array vacío (máx 5 eventos por request).

`generalInfo`	Dentro de array `maintenanceList`	Siempre	Object	Información general sobre el mantenimiento. Requerido en cada evento.
`name`	Dentro de `generalInfo`	Siempre	String	Nombre para identificar el mantenimiento. Requerido en cada evento.
`recurring`	Dentro de `generalInfo`	Siempre	Boolean	Indica si el mantenimiento es recurrente en el tiempo. En caso `false`, se considera un mantenimiento \"normal\" (de única vez). Requerido en cada evento.
`isActive`	Dentro de `generalInfo`	Opcional	Boolean	Si la mantención está activa o no. De no enviarse se considera desactivada (equivalente a enviar `false`).
`description`	Dentro de `generalInfo`	Opcional	String	Observaciones o descripción de la mantención.
`responsibleId`	Dentro de `generalInfo`	Opcional	Integer	ID del destinatario asignado como responsable que recibirá un correo de aviso.
`activitiesIdsList`	Dentro de `generalInfo`	Opcional	Array de Integer	Lista de IDs de actividades que ejecutar como parte del mantenimiento.

`alertConfig`	Dentro de array `maintenanceList`	Siempre	Object	Configuración de alertas para el mantenimiento. Requerido en cada evento. Debe proveerse al menos una alerta (odometer, hourmeter, date).
`odometer`	Dentro de `alertConfig`	Condicionalmente obligatorio	Object	Requerido si se desea enviar un alerta de recordatorio por aproximarse al odómetro objetivo.
`interval`	Dentro de `odometer`	Condicionalmente obligatorio	Integer	Cada cuantos kilómetros se vuelve a enviar alerta por próximo mantenimiento. Requerido si `recurring` es `true` y alerta tipo `odometer` es usada.
`notification`	Dentro de `odometer`	Opcional	Integer	Cantidad de kilómetros antes del vencimiento, para enviar notificación preventiva.
`hourmeter`	Dentro de `alertConfig`	Condicionalmente obligatorio	Object	Requerido si se desea enviar un alerta de recordatorio por aproximarse al horómetro objetivo.
`interval`	Dentro de `hourmeter`	Condicionalmente obligatorio	Integer	Cada cuantas horas se vuelve a enviar alerta por próximo mantenimiento. Requerido si `recurring` es `true` y alerta tipo `hourmeter` es usada.
`notification`	Dentro de `alertConfig`	Opcional	Integer	Cantidad de horas antes del vencimiento, para enviar notificación preventiva.
`date`	Dentro de `alertConfig`	Condicionalmente obligatorio	Object	Requerido si se desea enviar un alerta de recordatorio por aproximarse a la fecha objetivo.
`autoEstimateNext`	Dentro de `date`	Opcional	Boolean	Solo considerado cuando `recurring` es `true`. De ser enviado en `true`, las próximas mantenciones se estimarán en base a un histórico.
`interval`	Dentro de `date`	Condicionalmente obligatorio	Integer	Cada cuantas unidades de tiempo (`intervalUnit )` se vuelve a enviar alerta por próximo mantenimiento. Requerido en mantenciones recurrentes cuando `autoEstimateNext` es `false`.
`intervalUnit`	Dentro de `date`	Opcional	String	Unidad para el intervalo de tiempo. Debe ser uno de los siguientes: day, week, month o year . De no enviarse o no ser correcto el valor entregado, se utilizará \"day\".
`notification`	Dentro de `date`	Opcional	Integer	Cuantas unidades de tiempo ( `notificationUnit` ) antes del vencimiento en el que se envía una notificación para alerta `date`.
`notificationUnit`	Dentro de `date`	Opcional	String	Unidad para el tiempo de la notificación previa. Debe ser uno de los siguientes: hour, day, week o month. De no enviarse o no ser correcto el valor entregado se utilizará \"day\".

`vehicleList`	Dentro de array `maintenanceList`	Siempre	Array de objetos	Listado de vehiculos. No puede ser un array vacío.
`id`	Dentro de cada objeto de `vehicleList`	Siempre	Integer	ID del Vehículo. Requerido para cada vehículo.
`odometer`	Dentro de cada objeto de `vehicleList`	Condicionalmente obligatorio	Integer	Odómetro de la próxima mantención. Requerido si se envía una alerta tipo odometer.
`hourmeter`	Dentro de cada objeto de `vehicleList`	Condicionalmente obligatorio	Integer	Horómetro de la próxima mantención. Requerido si se envía una alerta tipo hourmeter.
`date`	Dentro de cada objeto de `vehicleList`	Condicionalmente obligatorio	String (YYYY-MM-DD)	Fecha de la próxima mantención. Requerido si se envía una alerta tipo date. Debe ser un string de fecha válido.

`alertEmails`	Dentro de array `maintenanceList`	Siempre	Object	Configuración de correos electrónicos para alertas. Requerido en cada evento.
`responsibleIdsList`	Dentro de array `alertEmails`	Siempre	Array de Integer	Listado de IDs de los correos electrónicos responsables. No puede ser un array vacío.
`postExpirationList`	Dentro de array `alertEmails`	Opcional	Array de objetos	Listado de alertas que se envían luego de que expire la mantención.
`recipientsIdsList`	Dentro de cada objeto de `postExpirationList`	Opcional	Array de Integer	Listado de IDs de destinatarios de correo para la alerta luego de que expire la mantención.
`hours`	Dentro de cada objeto de `postExpirationList`	Opcional	Integer	Horas después de la expiración de la mantención para enviar la alerta.
`title`	Dentro de cada objeto de `postExpirationList`	Opcional	String	Descripción/título para la alerta luego de que expire la mantención.

Respuestas

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
200	La solicitud fue exitosa. En el body de la respuesta se encuentra el listado de mantenciones ingresadas exitosamente y de errores si es que se produjeron (y en cuales mantenciones hay problemas con los datos ingresados).
400	Falta parámetro idClient o es inválido (por ejemplo, no es número).
400	Faltan datos para programar mantención (por ejemplo, maintenanceList es un array vacío o no es un array).
400	Se permiten un máximo de 5 mantenimientos a la vez.
400	Se encontraron problemas en los datos de entrada. Se incluye un listado warnings con los problemas encontrados en datos obligatorios o en formato. No se hicieron inserciones.
401	No se envió la cabecera Authorization con el token o el token está incorrecto (por ejemplo, no cumple con el formato esperado).
401	El token entregado no pudo ser usado para verificar el usuario (por ejemplo, no fue enviado en su totalidad, está vencido o fue modificado).
500	Las inserciones presentaron problemas con los datos ingresados.
500	Error interno.

","urlObject":{"protocol":"https","path":["mantenimiento","programar-mantencion"],"host":["api","tranciti","com"],"query":[],"variable":[]}},"response":[{"id":"d320f3d7-cf96-43c5-8c3b-3de0a747f0e4","name":"Mantención con Alerta de Odómetro","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"{{vault:bearer-token}}q5VeqPmnoIvn31n9NbqvPAeVxSAg2mKDiw9wW49EEemoxcgw","type":"text"},{"key":"id-client","value":"12345678","type":"text"},{"key":"x-api-key","value":"ppbGkuNSapiKeyGYUB78321A7Cip8iWFkgexampleIOS8","type":"text"}],"body":{"mode":"raw","raw":"{\n \"idClient\": 1040,\n \"maintenanceList\": [\n {\n \"generalInfo\": {\n \"name\": \"Mantención recurrente 10k\",\n \"recurring\": true,\n \"description\": \"Mantención recurrente cada 10mil kilómetros que avisa 200km antes y luego avisa de nuevo pasado 300 horas\",\n \"responsibleId\": 999999,\n \"activitiesIdsList\": [\n 1234,\n 5678\n ],\n \"isActive\": true\n },\n \"alertConfig\": {\n \"odometer\": {\n \"interval\": \"10000\",\n \"notification\": \"200\"\n }\n },\n \"vehicleList\": [\n {\n \"id\": 112233,\n \"odometer\": 1000\n },\n {\n \"id\": 445566,\n \"odometer\": 2000\n }\n ],\n \"alertEmails\": {\n \"responsibleIdsList\": [\n 888888\n ],\n \"postExpirationList\": [\n {\n \"title\": \"Título post-alerta vencida\",\n \"hours\": 300,\n \"recipientsIdsList\": [\n 777777\n ]\n }\n ]\n }\n },\n {\n \"generalInfo\": {\n \"name\": \"Revisión única 15.000 km\",\n \"recurring\": false,\n \"description\": \"Esta es una mantención no-recurrente (normal, de una sola instancia) cuando el vehículo cumple 15 mil kilómetros y avisa 100km antes\",\n \"responsibleId\": 444444,\n \"activitiesIdsList\": [\n 12345678\n ],\n \"isActive\": true\n },\n \"alertConfig\": {\n \"odometer\": {\n \"interval\": \"15000\",\n \"notification\": \"100\"\n }\n },\n \"vehicleList\": [\n {\n \"id\": 111222,\n \"odometer\": 1000\n },\n {\n \"id\": 333444,\n \"odometer\": 3000\n }\n ],\n \"alertEmails\": {\n \"responsibleIdsList\": [\n 111111\n ]\n }\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.tranciti.com/mantenimiento/programar-mantencion"},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Mantenimientos programados correctamente: 2 - con error: 0\",\n \"okIds\": [\n {\n \"index\": 1,\n \"message\": 8165\n },\n {\n \"index\": 2,\n \"message\": 8166\n }\n ],\n \"errors\": []\n}"},{"id":"3dc128e4-85d3-4009-97c1-2c57cf15d1d1","name":"Mantención con Alerta de Horómetro","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"{{x-api-key}}","type":"text"},{"key":"id-client","value":"{{id-client-autorizado}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"idClient\": 1040,\n \"maintenanceList\": [\n {\n \"generalInfo\": {\n \"name\": \"Mantención recurrente 5000 horas\",\n \"recurring\": true,\n \"description\": \"Mantención cada 5 mil horas de uso, que avisa 1000 horas antes y luego avisa de nuevo pasado 100 horas\",\n \"responsibleId\": 999999,\n \"activitiesIdsList\": [\n 1234,\n 5678\n ],\n \"isActive\": true\n },\n \"alertConfig\": {\n \"hourmeter\": {\n \"interval\": \"5000\",\n \"notification\": \"1000\"\n }\n },\n \"vehicleList\": [\n {\n \"id\": 112233,\n \"hourmeter\": 1000\n },\n {\n \"id\": 445566,\n \"hourmeter\": 2000\n }\n ],\n \"alertEmails\": {\n \"responsibleIdsList\": [\n 888888\n ],\n \"postExpirationList\": [\n {\n \"title\": \"Título post-alerta vencida\",\n \"hours\": 100,\n \"recipientsIdsList\": [\n 777777\n ]\n }\n ]\n }\n },\n {\n \"generalInfo\": {\n \"name\": \"Mantención única 50 mil horas\",\n \"recurring\": false,\n \"description\": \"Esta es una mantención no-recurrente (normal, de una sola instancia) que se realiza cuando el vehículo cumple 50 mil horas de uso y se avisa 200 horas antes\",\n \"responsibleId\": 444444,\n \"activitiesIdsList\": [\n 12345678\n ],\n \"isActive\": true\n },\n \"alertConfig\": {\n \"hourmeter\": {\n \"interval\": \"50000\",\n \"notification\": \"200\"\n }\n },\n \"vehicleList\": [\n {\n \"id\": 111222,\n \"hourmeter\": 1000\n },\n {\n \"id\": 333444,\n \"hourmeter\": 3000\n }\n ],\n \"alertEmails\": {\n \"responsibleIdsList\": [\n 111111\n ]\n }\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.tranciti.com/mantenimiento/programar-mantencion"},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Mantenimientos programados correctamente: 2 - con error: 0\",\n \"okIds\": [\n {\n \"index\": 1,\n \"message\": 8165\n },\n {\n \"index\": 2,\n \"message\": 8166\n }\n ],\n \"errors\": []\n}"},{"id":"4a855ada-202a-43e9-afdb-b646731ff992","name":"Mantención con Alerta por Fecha","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"{{x-api-key}}","type":"text"},{"key":"id-client","value":"{{id-client-autorizado}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"idClient\": 1040,\n \"maintenanceList\": [\n {\n \"generalInfo\": {\n \"name\": \"Mantención trimestral\",\n \"recurring\": true,\n \"description\": \"Mantención cada 3 meses. Avisa 2 semanas antes\",\n \"responsibleId\": 999999,\n \"activitiesIdsList\": [\n 1234,\n 5678\n ],\n \"isActive\": true\n },\n \"alertConfig\": {\n \"date\": {\n \"autoEstimateNext\": false,\n \"interval\": 3,\n \"intervalUnit\": \"month\",\n \"notification\": 2,\n \"notificationUnit\": \"week\"\n }\n },\n \"vehicleList\": [\n {\n \"id\": 112233,\n \"date\": \"2026-02-03 00:00:00-03:00\"\n },\n {\n \"id\": 445566,\n \"date\": \"2026-02-03 00:00:00-03:00\"\n }\n ],\n \"alertEmails\": {\n \"responsibleIdsList\": [\n 888888\n ]\n }\n },\n {\n \"generalInfo\": {\n \"name\": \"Mantención fin de año\",\n \"recurring\": false,\n \"description\": \"Esta es una mantención no-recurrente (normal, de una sola instancia). Se ejecuta preventivamente cerca del día de Navidad. Avisa a inicio de diciembre\",\n \"responsibleId\": 444444,\n \"activitiesIdsList\": [\n 12345678\n ],\n \"isActive\": true\n },\n \"alertConfig\": {\n \"date\": {\n \"autoEstimateNext\": false,\n \"notification\": 3,\n \"notificationUnit\": \"week\"\n }\n },\n \"vehicleList\": [\n {\n \"id\": 111222,\n \"date\": \"2026-12-22\"\n },\n {\n \"id\": 333444,\n \"date\": \"2026-12-22\"\n }\n ],\n \"alertEmails\": {\n \"responsibleIdsList\": [\n 111111\n ],\n \"postExpirationList\": [\n {\n \"title\": \"Título post-alerta vencida\",\n \"hours\": 300,\n \"recipientsIdsList\": [\n 777777\n ]\n }\n ]\n }\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.tranciti.com/mantenimiento/programar-mantencion"},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Mantenimientos programados correctamente: 2 - con error: 0\",\n \"okIds\": [\n {\n \"index\": 1,\n \"message\": 8165\n },\n {\n \"index\": 2,\n \"message\": 8166\n }\n ],\n \"errors\": []\n}"},{"id":"2d008c49-2d99-4092-801f-ebc948274a1a","name":"Mantención recurrente con todo tipo de Alerta","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"{{x-api-key}}","type":"text"},{"key":"id-client","value":"{{id-client-autorizado}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"idClient\": 1040,\n \"maintenanceList\": [\n {\n \"generalInfo\": {\n \"name\": \"Múltimantenimiento estándar\",\n \"recurring\": true,\n \"description\": \"Esta es una serie de mantenciones con muchas condiciones: cada 10mil km, 20mil horas y cada 365 días\",\n \"responsibleId\": 555,\n \"activitiesIdsList\": [\n 888,\n 999,\n 1010\n ],\n \"isActive\": true\n },\n \"alertConfig\": {\n \"odometer\": {\n \"interval\": 10000,\n \"notification\": 1000\n },\n \"hourmeter\": {\n \"interval\": 20000,\n \"notification\": 2000\n },\n \"date\": {\n \"autoEstimateNext\": false,\n \"interval\": 365,\n \"intervalUnit\": \"day\",\n \"notification\": 24,\n \"notificationUnit\": \"hour\"\n }\n },\n \"vehicleList\": [\n {\n \"id\": 111111,\n \"odometer\": \"10000\",\n \"hourmeter\": \"500\",\n \"date\": \"2025-12-31\"\n }\n ],\n \"alertEmails\": {\n \"responsibleIdsList\": [\n 6,\n 7\n ],\n \"postExpirationList\": [\n {\n \"title\": \"Alerta luego de una hora de expirar\",\n \"hours\": 1,\n \"recipientsIdsList\": [\n 10,\n 11,\n 12,\n 13\n ]\n },\n {\n \"title\": \"Alerta luego de un día de expirar\",\n \"hours\": 24,\n \"recipientsIdsList\": [\n 14,\n 15,\n 16,\n 17\n ]\n }\n ]\n }\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.tranciti.com/mantenimiento/programar-mantencion"},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Mantenimientos programados correctamente: 1 - con error: 0\",\n \"okIds\": [\n {\n \"index\": 1,\n \"message\": 8165\n }\n ],\n \"errors\": []\n}"},{"id":"e6642d3b-1115-4c15-acb9-7c074870258e","name":"Mantenciones recurrente con fecha automática","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"{{x-api-key}}","type":"text"},{"key":"id-client","value":"{{id-client-autorizado}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"idClient\": 1040,\n \"maintenanceList\": [\n {\n \"generalInfo\": {\n \"name\": \"Esta es una mantención recurrente y predictiva\",\n \"recurring\": true,\n \"description\": \"Mantención que no require fecha, pues predice la siguiente según la historia pasada.\",\n \"responsibleId\": 999999,\n \"activitiesIdsList\": [\n 1234,\n 5678\n ],\n \"isActive\": true\n },\n \"alertConfig\": {\n \"date\": {\n \"autoEstimateNext\": true,\n \"notification\": 1,\n \"notificationUnit\": \"hour\"\n }\n },\n \"vehicleList\": [\n {\n \"id\": 112233,\n \"hourmeter\": 1000\n },\n {\n \"id\": 445566,\n \"hourmeter\": 2000\n }\n ],\n \"alertEmails\": {\n \"responsibleIdsList\": [\n 888888\n ],\n \"postExpirationList\": [\n {\n \"title\": \"Título post-alerta vencida\",\n \"hours\": 300,\n \"recipientsIdsList\": [\n 777777\n ]\n }\n ]\n }\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.tranciti.com/mantenimiento/programar-mantencion"},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Mantenimientos programados correctamente: 1 - con error: 0\",\n \"okIds\": [\n {\n \"index\": 1,\n \"message\": 8165\n }\n ],\n \"errors\": []\n}"}],"_postman_id":"d4eb0b27-61a8-46f6-ba75-ef2500e1e830"},{"name":"Registrar mantención","id":"e0549cee-ec28-472f-90ea-90c50522e0c1","request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"x-api-key","value":"{{x-api-key}}","type":"text"},{"key":"id-client","value":"{{id-client-autorizado}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"idClient\": 1040,\n \"cerrar\": true,\n \"registro\": {\n \"tipoMantencionId\": 3,\n \"nombre\": \"tipo32\",\n \"vehiculoId\": 17208,\n \"patente\": \"3_Historico\",\n \"responsableId\": 2364,\n \"proveedorId\": 329,\n \"hes\": \"6767\",\n \"encargadoIngreso\": \"encsin2\",\n \"fechaIngreso\": \"2025-12-17T00:00:00-03:00\",\n \"fechaInicioTrabajo\": \"2025-12-29T00:00:00-03:00\",\n \"fechaSalida\": \"2026-01-01T19:00:00-03:00\",\n \"fechaTerminoTrabajo\": \"2025-12-29T00:00:00-03:00\",\n \"odometro\": 449,\n \"horometro\": 334,\n \"valor\": 1232,\n \"observaciones\": \"aaa2\",\n \"patenteReemplazo\": \"gjkgf2\",\n \"valorReemplazo\": 123,\n \"fechaInicioReemplazo\": \"2025-12-03T00:00:00-03:00\",\n \"fechaFinReemplazo\": \"2025-12-10T00:00:00-03:00\",\n \"tareas\": [55, 56, 57]\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.tranciti.com/mantenimiento/registrar-mantencion","description":"

Este endpoint permite registrar mantenciones en el módulo de Mantenimiento, siguiendo la misma lógica presente en la aplicación web.

Soporta:

Mantención programada
\n
Mantención correctiva
\n
Mantención por siniestro
\n

Además:

Si existe odometro y fechaTerminoTrabajo, se procede a intentar actualizar el odómetro de forma interna.

Reglas por tipo

Programada

Se considera programada si programacionId viene en el body o si registro.tipoMantencionId = 1.
\n
programacionId es obligatorio. Es lo que el endpoint de programar mantención entrega en message.
\n
- Los id's de todas las programaciones pueden ser obtenidos por el endpoint de GET /mantenciones, documentado más abajo.
  \n
- IMPORTANTE: Solo es posible registrar mantenciones NO realizadas, por lo que si se envia un id de una programación que figura como \"Realizada\", este metodo va a retornar un error.
  \n
\n
registro.vehiculoId NO es obligatorio (se infiere desde la programación).
\n

Correctiva / Siniestro

programacionId no aplica.
\n
registro.vehiculoId es obligatorio.
\n

Datos de entrada

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Nombre del campo	Ubicación en JSON de body	¿Requerido?	Tipo de dato	Descripción / Relación
`idClient`	Raíz del JSON	Siempre	Integer	ID del cliente a registrar.
`cerrar`	Raíz del JSON	Opcional	Boolean	Si no se envía, se asume `true`. Si es `true`, entonces procede a `\"Guardar y cerrar\"` mantención, de lo contrario procede a `\"Guardar\".` (Equivalente de las opciones de aplicación web).
`programacionId`	Raíz del JSON	Condicional	Integer	Obligatorio si es programada.
`registro`	Raíz del JSON	Siempre	Object	Objeto principal del registro.

Campos de `registro`

Nombre	Ubicación	¿Requerido?	Tipo	Descripción
`tipoMantencionId`	`registro.tipoMantencionId`	Siempre	Integer	Tipo mantención. Si `== 1`, se trata como programada.
`nombre`	`registro.nombre`	Opcional	String	Nombre del registro.
`vehiculoId`	`registro.vehiculoId`	Condicional	Integer	Obligatorio en correctiva/siniestro. En programada se omite.
`patente`	`registro.patente`	Opcional?	String	Patente del vehículo (informativa), no es obligatoria pero por consistencia en los informes, se recomienda enviar.
`responsableId`	`registro.responsableId`	Opcional	Integer	Responsable (desde `/mantenimiento/metadata`).
`proveedorId`	`registro.proveedorId`	Opcional	Integer	Proveedor (desde `/mantenimiento/metadata`).
`hes`	`registro.hes`	Opcional	String	Campo HES.
`encargadoIngreso`	`registro.encargadoIngreso`	Opcional	String	Encargado de ingreso.
`fechaIngreso`	`registro.fechaIngreso`	Siempre	String (ISO-8601) (yyyy-MM-ddTHH:mm:ss.SSSZ)	Fecha/hora de ingreso.
`fechaInicioTrabajo`	`registro.fechaInicioTrabajo`	Opcional	String (ISO-8601) (yyyy-MM-ddTHH:mm:ss.SSSZ)	Inicio del trabajo.
`fechaSalida`	`registro.fechaSalida`	Siempre	String (ISO-8601) (yyyy-MM-ddTHH:mm:ss.SSSZ)	Fecha/hora de salida.
`fechaTerminoTrabajo`	`registro.fechaTerminoTrabajo`	Opcional	String (ISO-8601) (yyyy-MM-ddTHH:mm:ss.SSSZ)	Término del trabajo. Requerido para SetOdometro.
`odometro`	`registro.odometro`	Opcional	Number	Odómetro en km. Se convertirá a metros para SetOdometro.
`horometro`	`registro.horometro`	Opcional	Number	Horómetro en horas.
`valor`	`registro.valor`	Opcional	Number	Valor/costo, equivalente a `valor` en el apartado de `\"Información de taller\"` dentro de aplicación web.
`observaciones`	`registro.observaciones`	Opcional	String	Observaciones, quivalente a `observaciones` en el apartado de `\"Información de taller\"` dentro de aplicación web..
`patenteReemplazo`	`registro.patenteReemplazo`	Opcional	String	Vehículo reemplazo.
`valorReemplazo`	`registro.valorReemplazo`	Opcional	Number	Costo reemplazo.
`fechaInicioReemplazo`	`registro.fechaInicioReemplazo`	Opcional	String (ISO-8601) (yyyy-MM-ddTHH:mm:ss.SSSZ)	Inicio reemplazo.
`fechaFinReemplazo`	`registro.fechaFinReemplazo`	Opcional	String (ISO-8601) (yyyy-MM-ddTHH:mm:ss.SSSZ)	Fin reemplazo.
`tareas`	`registro.tareas`	Opcional	Array	IDs de tareas (desde `/mantenimiento/metadata`). Corresponde a los `id's` de las tareas, o en caso de existir una actividad sin una tareas, se debe ingresar el `id` de la actividad.

Respuestas

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
200	Registro procesado correctamente. Retorna `registroId`, `action`, `moduleResponse` y `odometerResponse`.
400	Falta body o es inválido.
400	Falta `idClient` o es inválido.
400	Falta `registro`.
400	Falta `registro.tipoMantencionId`.
400	Falta `registro.fechaIngreso`.
400	Falta `registro.fechaSalida`.
400	Correctiva/Siniestro: falta `registro.vehiculoId`.
400	Programada: falta `programacionId`.
401	Falta Authorization o formato incorrecto.
401	Token inválido o usuario no encontrado.
401	No se pudo validar sesión.
404	Programación no encontrada (`programacionId` inválido).
500	Error de módulo de mantenimiento o error interno.

Descripción de respuesta

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campos dentro de json body	Descripción
message	Mensaje con feedback sobre si la inserción fué o no correcta.
action	INSERT -> se ingresa un registro de forma correcta. UPDATE -> se actualiza un re registro de forma correcta.
idClient	id del cliente que solicita.
cerrar	true cuando se solicita cerrar por body.
programacionId	id de programación registrada, cuando el registro es de tipo 1.
registroId	id único de registro de mantención, referente a la mantención registrada
moduleResponse	Contiene la respuesta que normalmente la aplicación web entrega. `id` -> idem a registroId `delta` -> json con información de fecha, horometro, odómetro. Ignorar, es para usos internos.
odometerResponse	Contiene un json con: attempted-> `true` si se intenta modificar el odómetro, según se cumplan las condiciones necesarias (se envía lo requerido en el body, documentado anteriormente). ok -> true la respuesta de intento de setear odómetro fue correcta. Solo presente cuando attempted es `true`. status -> código http de respuesta. body -> json con `result` que contiene \"`ERROR`\" o \"`1`\" cuando es `success`. Tambien contiene \"`mensaje\"` con el motivo de error al actualizar el odómetro, en caso de \"`ERROR`\".

","urlObject":{"protocol":"https","path":["mantenimiento","registrar-mantencion"],"host":["api","tranciti","com"],"query":[],"variable":[]}},"response":[{"id":"a3a48be0-a660-4150-8230-d6cbe706f71d","name":"Registrar mantención (OK)","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{token}}","type":"text"},{"key":"id-client","value":"{{id-client-autorizado}}","type":"text"},{"key":"x-api-key","value":"{{x-api-key}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"idClient\": 1040,\n \"cerrar\": true,\n \"registro\": {\n \"tipoMantencionId\": 3,\n \"nombre\": \"tipo32\",\n \"vehiculoId\": 17208,\n \"patente\": \"3_Historico\",\n \"responsableId\": 2364,\n \"proveedorId\": 329,\n \"hes\": \"6767\",\n \"encargadoIngreso\": \"encsin2\",\n \"fechaIngreso\": \"2025-12-17T00:00:00-03:00\",\n \"fechaInicioTrabajo\": \"2025-12-29T00:00:00-03:00\",\n \"fechaSalida\": \"2026-01-01T19:00:00-03:00\",\n \"fechaTerminoTrabajo\": \"2025-12-29T00:00:00-03:00\",\n \"odometro\": 449,\n \"horometro\": 334,\n \"valor\": 1232,\n \"observaciones\": \"aaa2\",\n \"patenteReemplazo\": \"gjkgf2\",\n \"valorReemplazo\": 123,\n \"fechaInicioReemplazo\": \"2025-12-03T00:00:00-03:00\",\n \"fechaFinReemplazo\": \"2025-12-10T00:00:00-03:00\",\n \"tareas\": [55, 56, 57]\n }\n}"},"url":"https://api.tranciti.com/mantenimiento/registrar-mantencion"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Registro de mantención procesado correctamente\",\n \"action\": \"INSERT\",\n \"idClient\": 1040,\n \"cerrar\": true,\n \"programacionId\": null,\n \"registroId\": 18786,\n \"moduleResponse\": {\n \"id\": 18786,\n \"delta\": {\n \"fecha\": null,\n \"horometro\": null,\n \"odometro\": null\n }\n },\n \"odometerResponse\": {\n \"attempted\": true,\n \"ok\": true,\n \"status\": 200,\n \"body\": {\n \"result\": \"ERROR\",\n \"mensaje\": \"NO HAY DATOS GPS EN LA FECHA INDICADA - CARGA EN FECHA NO PERMITIDA \"\n }\n }\n}"}],"_postman_id":"e0549cee-ec28-472f-90ea-90c50522e0c1"},{"name":"Obtener registros de mantenciones realizadas","id":"d0c7418c-f006-4508-87f8-197b8c772572","request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"x-api-key","value":"","description":"

API Key entregado

\n","type":"text"},{"key":"id-client","value":"","description":"

ID del cliente (obligatorio).

\n","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"fechaInicio\": \"2025-08-01T00:00:00-03:00\",\n \"fechaFin\": \"2026-12-05T23:59:59-03:00\",\n \"vehicleList\": [1,2,3,4]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.tranciti.com/mantenimiento/registro-mantenciones","description":"

Entrega los registros de mantenciones realizadas en un rango de fechas para los vehículos indicados.

Equivalente a lo que se puede hacer desde la aplicación web en:
Mantenimiento → Reportes → Registro de Mantenciones.

Entradas

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Nombre del campo	Ubicación	¿Requerido?	Tipo de dato	Descripción / Relación
x-api-key	headers.`x-api-key`	Sí	string	API Key entregado.
Authorization	headers.`Authorization`	Sí	string	Bearer token del usuario. Formato: `Bearer {token}`
id-client	headers.`id-client`	Sí	integer	ID de cliente. Es un entero

Body (JSON)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Nombre del campo	Ubicación en JSON de body	¿Requerido?	Tipo de dato	Descripción / Relación
fechaInicio	body.`fechaInicio`	Sí	string (ISO 8601 con offset)	Inicio del rango. Debe incluir offset, ej: `2025-08-01T00:00:00-03:00`.
fechaFin	body.`fechaFin`	Sí	string (ISO 8601 con offset)	Fin del rango. Debe incluir offset, ej: `2026-12-05T23:59:59-03:00`. Debe ser mayor a `fechaInicio`.
vehicleList	body.`vehicleList`	Sí	array	Lista de IDs de vehículos a consultar. Debe contener al menos 1 entero > 0.

Salidas

200 OK

Retorna un array JSON, donde cada elemento corresponde a una registro de mantención.

La salida es identica al .xlsx generado como reporte desde la aplicación web, solo que los nombres de los atributos estan en camelCase.

En caso de no existir un atributo, viene un string vacio \"\".

Estructura de cada elemento del array

Nombre del campo	Ubicación en JSON de salida	¿Requerido?	Tipo de dato	Descripción / Relación
patente	`[i].patente`	Sí	string	Patente del vehículo.
nombreDeMantencion	`[i].nombreDeMantencion`	Sí	string	Nombre de mantención.
fechaIngresoTaller	`[i].fechaIngresoTaller`	Sí	string	Fecha ingreso taller. Formato yyyy-mm-dd hh:mm:ss ej: 2025-12-30 00:00:00
actividad	`[i].actividad`	Sí	string	Actividad.
tareas	`[i].tareas`	Sí	string	Tareas.
usuario	`[i].usuario`	Sí	string	Usuario responsable de la mantención.
taller	`[i].taller`	Sí	string	Taller/Proveedor.
fechaDiagnostico	`[i].fechaDiagnostico`	Sí	string	Fecha diagnóstico. yyyy-mm-dd
horaDiagnostico	`[i].horaDiagnostico`	Sí	string	Hora diagnóstico. hh:mm:ss
soporte	`[i].soporte`	Sí	string	Patente de reemplazo.
fechaReemplazo	`[i].fechaReemplazo`	Sí	string	Fecha reemplazo. yyyy-mm-dd
horaReemplazo	`[i].horaReemplazo`	Sí	string	Hora reemplazo. hh:mm:ss
fechaDeSalidaTaller	`[i].fechaDeSalidaTaller`	Sí	string	Fecha de salida taller. yyyy-mm-dd
horaDeSalidaTaller	`[i].horaDeSalidaTaller`	Sí	string	Hora de salida taller. hh:mm:ss
observacion	`[i].observacion`	Sí	string	Observación.
estado	`[i].estado`	Sí	string	Estado.
tiempoEntregaSoporte	`[i].tiempoEntregaSoporte`	Sí	string	Tiempo entrega soporte (formateado). x día/días/mes/meses/año/años x hora/horas/segundos/minutos según corresponda. Si es la fecha justa no va hora.
tiempoEstadiaTaller	`[i].tiempoEstadiaTaller`	Sí	string	Tiempo estadía taller (formateado). x día/días/mes/meses/año/años x hora/horas/segundos/minutos según corresponda. Si es la fecha justa no va hora.
tiempoSinSoporte	`[i].tiempoSinSoporte`	Sí	string	Tiempo sin soporte (formateado). x día/días/mes/meses/año/años x hora/horas/segundos/minutos según corresponda. Si es la fecha justa no va hora.

400 Bad Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Nombre del campo	Ubicación en JSON de salida	¿Requerido?	Tipo de dato	Descripción
message	body.`message`	Sí	string	Error de validación del body (por ejemplo: vehicleList vacío, fechas inválidas, fechaFin <= fechaInicio, offset ausente).

401 Unauthorized

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Nombre del campo	Ubicación en JSON de salida	¿Requerido?	Tipo de dato	Descripción
message	body.`message`	Sí	string	Falta/invalidación de Authorization, token inválido, o sesión inválida.

500 Internal Server Error

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Nombre del campo	Ubicación en JSON de salida	¿Requerido?	Tipo de dato	Descripción
message	body.`message`	Sí	string	Error interno o error al consultar backend.

","urlObject":{"protocol":"https","path":["mantenimiento","registro-mantenciones"],"host":["api","tranciti","com"],"query":[],"variable":[]}},"response":[{"id":"070a299e-def4-4554-b670-66e6a4de7e04","name":"200 OK - ejemplo","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Authorization","value":"Bearer "},{"key":"id-client","value":""},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"fechaInicio\": \"2025-08-01T00:00:00-03:00\",\n \"fechaFin\": \"2026-12-05T23:59:59-03:00\",\n \"vehicleList\": [123,234,543]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.tranciti.com/mantenimiento/registro-mantenciones"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"patente\": \"asdf\",\n \"nombreDeMantencion\": \"correctivaporpagina\",\n \"fechaIngresoTaller\": \"2025-12-30 00:00:00\",\n \"actividad\": \"\",\n \"tareas\": \"\",\n \"usuario\": \"testeador (testeador@tranciti.cl)\",\n \"taller\": \"Proveedor 1\",\n \"fechaDiagnostico\": \"2025-12-30\",\n \"horaDiagnostico\": \"00:00:00\",\n \"soporte\": \"patrempppagina\",\n \"fechaReemplazo\": \"2025-12-30\",\n \"horaReemplazo\": \"00:00:00\",\n \"fechaDeSalidaTaller\": \"2025-12-31\",\n \"horaDeSalidaTaller\": \"00:00:00\",\n \"observacion\": \"observacionesss\",\n \"estado\": \"finalizada\",\n \"tiempoEntregaSoporte\": \"\",\n \"tiempoEstadiaTaller\": \"1 día \",\n \"tiempoSinSoporte\": \"\"\n }\n]"},{"id":"7dfc4692-4ce2-496e-9398-3c6c8897e22a","name":"400 Bad Request - ejemplo","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Authorization","value":"Bearer "},{"key":"id-client","value":""},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"fechaInicio\": \"2025-08-01T00:00:00-03:00\",\n \"fechaFin\": \"2025-08-01T00:00:00-03:00\",\n \"vehicleList\": []\n}","options":{"raw":{"language":"json"}}},"url":"https://api.tranciti.com/mantenimiento/registro-mantenciones"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"vehicleList es obligatorio y debe ser un array de enteros\"\n}"},{"id":"af01b06e-9092-4550-8310-b164e217491c","name":"401 Unauthorized - ejemplo","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Authorization","value":"Bearer "},{"key":"id-client","value":""},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"fechaInicio\": \"2025-08-01T00:00:00-03:00\",\n \"fechaFin\": \"2026-12-05T23:59:59-03:00\",\n \"vehicleList\": [1234]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.tranciti.com/mantenimiento/registro-mantenciones"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Token inválido o usuario no encontrado\"\n}"},{"id":"4e78521a-9335-4cc1-b246-0fac97e84f92","name":"500 Internal Server Error - ejemplo","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Authorization","value":"Bearer "},{"key":"id-client","value":""},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"fechaInicio\": \"2025-08-01T00:00:00-03:00\",\n \"fechaFin\": \"2026-12-05T23:59:59-03:00\",\n \"vehicleList\": [123]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.tranciti.com/mantenimiento/registro-mantenciones"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Error interno del servidor\"\n}"}],"_postman_id":"d0c7418c-f006-4508-87f8-197b8c772572"}]}

Respuestas:

Datos de entrada (headers)

Respuestas

Descripción de respuesta

Seguridad (Headers)

Query Params

Respuestas

Descripción de la respuesta

Estructura de items para programadas / proximas / vencidas

Estructura de items para en_proceso

Estructura de items para realizadas

Datos de entrada

Respuestas

Reglas por tipo

Datos de entrada

Campos de registro

Respuestas

Descripción de respuesta

Entradas

Headers

Body (JSON)

Salidas

200 OK

Estructura de cada elemento del array

400 Bad Request

401 Unauthorized

500 Internal Server Error

Estructura de items para `programadas` / `proximas` / `vencidas`

Estructura de items para `en_proceso`

Estructura de items para `realizadas`

Campos de `registro`