Flusso di ispezione dei veicoli a noleggio

Il tuo gestionale di noleggio conserva prenotazioni e condizioni commerciali. TrakarIA riceve il contesto necessario per ispezionare il veicolo e conserva il dossier autorevole dell’ispezione, le prove e le revisioni convalidate dei report.

Prova gli scenari API: apri il tester interattivo dell’integrazione. Le pagine seguenti restano la descrizione autorevole del contratto pubblico e dei casi d’uso.

Se TrakarIA è nuovo per te, inizia dalla panoramica. Per scegliere come collegare il tuo software, consulta i modelli d’integrazione. Gli scenari passo passo descrivono il percorso normale e i casi di recupero.

Responsabilità

Attore	Responsabilità	Esempio
Il tuo gestionale	Riferimento prenotazione, date previste e decisioni commerciali	Crea RES-1042; decide se addebitare un danno
TrakarIA	Flusso d’ispezione, prove, convalida umana e cronologia dei report	Registra lo stato alla consegna e lo confronta al rientro
Il tuo personale	Azioni eseguite con la propria identità TrakarIA	Accede, scatta foto, verifica i risultati e convalida l’ispezione

Una chiave API del gruppo identifica il software, non la persona che svolge l’ispezione e non le concede accesso. La persona accede a TrakarIA e deve possedere i permessi appropriati nel gruppo. L’intero percorso Rental può anche essere completato direttamente nell’applicazione, senza collegamento API.

Percorso umano

1. Nel gruppo TrakarIA esiste un veicolo, creato nell’applicazione o sincronizzato dal software.
2. Un dossier Rental raccoglie il contesto operativo di una prenotazione. TrakarIA non sostituisce il sistema di prenotazione, pagamento o disponibilità.
3. Una persona autorizzata registra lo stato del veicolo alla consegna e convalida l’ispezione iniziale.
4. Al rientro registra lo stato corrente e convalida il confronto con la consegna. Non esiste un tipo ufficiale separato di report return.
5. Se usi l’API pubblica, TrakarIA può inviare webhook firmati alla convalida. Il backend recupera quindi il report di departure o comparison.

Report, foto e cronologia delle correzioni restano soggetti alle regole di accesso e conservazione dell’account.

Ricevi i risultati tramite webhook

Aggiungi alla chiave una destinazione HTTP o HTTPS in Organizzazione → Integrazioni → Chiavi API → Gestisci webhook. Sottoscrivi rental.departure.completed e rental.return.completed; aggiungi rental.report.pdf_ready per la disponibilità del PDF. Verifica la firma con il segreto della destinazione e usa gli identificativi dell’evento per recuperare il report autenticato: il webhook è una notifica, non il report completo. Vedi webhook e recupero.

Flusso principale

1. Veicolo: PUT /v1/vehicles/by-external/{external_id} crea o aggiorna il veicolo associato al tuo identificativo stabile.
2. Dossier e planning: PUT /v1/rentals/by-external/{external_id} collega la prenotazione al veicolo e la aggiunge subito al planning. Nel corpo è obbligatorio soltanto vehicle_external_id; gli altri dati sono facoltativi. Conserva id Rental e planning.entry_id. Per le modifiche usa una revisione sorgente più recente oppure PATCH /v1/rentals/{rental_id}.
3. Consegna: POST /v1/rentals/{rental_id}/inspections con {"type":"departure"} crea o riprende l’ispezione. Invia un Idempotency-Key univoco. La creazione restituisce 201 e already_started: false; una nuova chiamata con una nuova chiave restituisce la stessa ispezione con 200 e already_started: true, senza duplicati né errore. Apri il launch_url; l’operatore deve autenticarsi.
4. Risultato della consegna: dopo la convalida, rental.departure.completed segnala il report iniziale. Recupera JSON e PDF quando disponibile.
5. Rientro: richiama lo stesso endpoint con {"type":"return"}. Dopo la convalida, rental.return.completed annuncia il report di confronto con la consegna. Il suo tipo è comparison, non return.

Se perdi un evento, interroga GET /v1/events e rileggi lo stato Rental o l’indice dei report.

Altri percorsi supportati

• GET /v1/inspections/{inspection_id} legge lo stato; POST /v1/inspections/{inspection_id}/launch rinnova un link scaduto.
• Gli allegati Rental sono documenti privati distinti dalle foto ufficiali. Caricali o elencali tramite /v1/rentals/{rental_id}/attachments; appaiono automaticamente come contesto in sola lettura nel flusso umano.
• GET /v1/inspections/{inspection_id}/evidence espone metadati puliti delle foto operative. Puoi scaricare originali singoli, un ZIP dell’ispezione o un ZIP dell’intero Rental; il contratto pubblico non espone maschere, contorni, annotazioni o URL di storage. Vedi Report e prove.
• L’estrazione della patente propone dati da verificare e non aggiorna silenziosamente un conducente confermato.

Il riferimento API definisce campi, limiti e risposte esatti. Sincronizzazione ed errori tratta gli aggiornamenti fuori ordine.