Inspección de vehículos de alquiler: flujo de Alquiler

Tu software de alquiler sigue siendo responsable de las reservas y las condiciones comerciales. TrakarIA recibe el contexto necesario para inspeccionar el vehículo y conserva el expediente de inspección, las pruebas y las versiones validadas de los informes que constituyen la referencia autorizada.

Prueba el recorrido completo: abre el TrakarIA Integration Lab para utilizar un mostrador de alquiler realista, inspeccionar cada solicitud enviada desde el servidor y empezar en modo de simulación sin una clave API. La interfaz del Lab está en inglés.

Empieza por la visión general si todavía no conoces TrakarIA. Si estás decidiendo cómo conectar tu software, consulta los modelos de integración. Los escenarios paso a paso explican el recorrido normal y cómo recuperarse de los errores.

Quién hace qué

Participante	Responsabilidad	Ejemplo
Tu software de alquiler	Referencia de reserva, fechas previstas y decisiones comerciales	Crea RES-1042 y decide si cobra un daño
TrakarIA	Flujo de inspección, pruebas, validación humana e historial de informes	Registra el estado en la salida y lo compara en la devolución
Tu personal	Acciones realizadas con su propia identidad de TrakarIA	Inicia sesión, toma fotos, revisa y valida la inspección

Una clave API de grupo identifica tu software. No identifica a quien realiza la inspección ni le concede acceso. Esa persona inicia sesión en TrakarIA y necesita los permisos adecuados en el grupo. El flujo de Alquiler también puede realizarse directamente en la aplicación, sin integración API con un tercero.

El recorrido de las personas

1. Existe un vehículo en un grupo de TrakarIA, creado en la aplicación o sincronizado por tu software.
2. Un expediente de alquiler contiene el contexto operativo de una reserva. TrakarIA no sustituye el sistema de reservas, pagos o disponibilidad.
3. Una persona autorizada registra el estado del vehículo en la salida y valida la inspección de salida.
4. En la devolución, una persona registra el estado actual y valida la comparación con la salida. No existe un informe oficial de devolución independiente.
5. Si tu software usa la API pública, TrakarIA puede enviar webhooks firmados cuando se validan la salida y la devolución. Tu servidor recupera después el informe de salida o de comparación.

Los informes, fotos e historial de correcciones están sujetos a las reglas de acceso y conservación de la cuenta. Los modelos de integración explican cuándo utilizar solo la aplicación o un enlace de lanzamiento.

Recibir resultados por webhook

Para recibir un aviso al validar una inspección, configura un destino webhook HTTP o HTTPS en tu clave API, en Organización → Integraciones → Claves API → Gestionar webhooks. Suscríbelo a rental.departure.completed y rental.return.completed; añade rental.report.pdf_ready si también quieres conocer cuándo está disponible el PDF. TrakarIA envía un POST firmado a tu servidor. Verifica la firma con el secreto del destino y usa los identificadores del evento para leer el informe mediante la API autenticada: el webhook es una notificación, no el informe completo. Consulta webhooks y recuperación.

Flujo principal

1. Vehículo: PUT /v1/vehicles/by-external/{external_id} crea o actualiza el vehículo asociado a tu identificador estable.
2. Expediente y planning: PUT /v1/rentals/by-external/{external_id} asocia la reserva al vehículo y la añade inmediatamente al planning. Solo vehicle_external_id es obligatorio en el cuerpo; los demás campos de negocio son opcionales. Guarda el id del expediente y planning.entry_id. Usa una revisión de origen superior o PATCH /v1/rentals/{rental_id} para los cambios admitidos.
3. Salida: POST /v1/rentals/{rental_id}/inspections con {"type":"departure"} crea o reanuda la inspección. Envía un encabezado Idempotency-Key único. Abre el launch_url devuelto en la interfaz de TrakarIA. Quien realiza la inspección debe iniciar sesión.
4. Resultado de salida: después de la validación, rental.departure.completed indica que el informe de salida está disponible. Recupera su JSON y, cuando esté listo, su PDF.
5. Devolución: llama a la misma ruta con {"type":"return"}. Tras la validación, rental.return.completed anuncia el informe de comparación con la salida. Puedes leer el JSON y descargar el PDF cuando esté listo; el tipo de informe es comparison, no return.

Si se pierde un evento, consulta GET /v1/events y después el estado actual del expediente o su índice de informes. La página webhooks y recuperación explica cómo hacerlo.

Otros recorridos disponibles

• GET /v1/inspections/{inspection_id} consulta el estado de una inspección. POST /v1/inspections/{inspection_id}/launch renueva un enlace caducado.
• Los adjuntos de Alquiler son documentos privados, separados de las fotos oficiales de inspección. Súbelos o enuméralos mediante /v1/rentals/{rental_id}/attachments; la ruta de contenido transmite los bytes autorizados.
• GET /v1/inspections/{inspection_id}/evidence muestra metadatos operativos de las fotos, incluida la indicación de si una foto se capturó para la inspección actual o se reutilizó de un estado anterior del vehículo.
• La extracción del permiso de conducir propone campos para revisión; no modifica silenciosamente un conductor confirmado.

La referencia API define los campos, límites y códigos de respuesta exactos. Sincronización y errores explica las actualizaciones que llegan fuera de orden.