Workflow voor inspecties van huurvoertuigen

Je verhuursoftware beheert reserveringen en commerciële voorwaarden. TrakarIA ontvangt de nodige voertuigcontext en bewaart het gezaghebbende inspectiedossier, bewijs en gevalideerde rapportversies.

Probeer de API-scenario’s: open de interactieve integratietester. Deze pagina’s blijven de gezaghebbende beschrijving van het publieke contract.

Begin zo nodig bij het productoverzicht, kies een integratiemodel en volg de stapsgewijze scenario’s.

Wie doet wat?

Actor	Verantwoordelijkheid	Voorbeeld
Je verhuursoftware	Reserveringsreferentie, planning en commerciële beslissingen	Maakt RES-1042; beslist over schadeberekening
TrakarIA	Inspectie, bewijs, menselijke validatie en rapporthistorie	Legt de staat bij uitgifte vast en vergelijkt die bij retour
Je medewerkers	Handelingen onder hun eigen TrakarIA-identiteit	Aanmelden, foto’s nemen, bevindingen beoordelen en valideren

Een groepssleutel identificeert software, niet de inspecteur, en verleent die persoon geen toegang. De medewerker meldt zich aan en heeft passende groepsrechten nodig. De Rental-reis kan ook volledig in de applicatie zonder API-koppeling worden uitgevoerd.

De menselijke reis

1. Een voertuig bestaat in een TrakarIA-groep, via de app of synchronisatie.
2. Een Rental-dossier bevat de operationele context van één reservering; TrakarIA vervangt boeking, betaling of beschikbaarheid niet.
3. Een bevoegde persoon registreert de voertuigstaat bij uitgifte en valideert departure.
4. Bij retour registreert die persoon de huidige staat en valideert de vergelijking. Er is geen apart officieel return-rapporttype.
5. Bij API-gebruik kan TrakarIA ondertekende webhooks sturen. Je backend haalt daarna het departure- of comparison-rapport op.

Resultaten via webhook

Voeg onder Organisatie → Integraties → API-sleutels → Webhooks beheren een HTTP(S)-bestemming toe. Abonneer op rental.departure.completed, rental.return.completed en eventueel rental.report.pdf_ready. Verifieer de handtekening met het bestemmingsgeheim en haal het rapport via de API: de webhook is een melding, niet het volledige rapport. Zie webhooks en herstel.

Hoofdstroom

1. Voertuig: PUT /v1/vehicles/by-external/{external_id} maakt of actualiseert het voertuig bij je stabiele ID.
2. Dossier en planning: PUT /v1/rentals/by-external/{external_id} koppelt de reservering en plaatst haar meteen in de planning. Alleen vehicle_external_id is verplicht; andere bedrijfsvelden zijn optioneel. Bewaar Rental id en planning.entry_id en gebruik een nieuwere bronrevisie voor wijzigingen.
3. Uitgifte: POST /v1/rentals/{rental_id}/inspections met {"type":"departure"} maakt of hervat de inspectie. Gebruik een unieke Idempotency-Key. Creatie retourneert 201 en already_started: false; een latere opdracht met nieuwe sleutel retourneert dezelfde inspectie met 200 en already_started: true. Open launch_url; de medewerker meldt zich aan.
4. Uitgifteresultaat: na validatie signaleert rental.departure.completed het vertrekrapport. Haal JSON en PDF wanneer gereed op.
5. Retour: roep hetzelfde endpoint aan met {"type":"return"}. rental.return.completed kondigt het vergelijkingsrapport aan; het type is comparison, niet return.

Gebruik bij gemiste gebeurtenissen GET /v1/events en lees daarna de actuele resource.

Andere ondersteunde paden

• GET /v1/inspections/{inspection_id} leest de status; POST /v1/inspections/{inspection_id}/launch vernieuwt een verlopen link.
• Rental-bijlagen zijn privédocumenten, los van officiële inspectiefoto’s. Via /attachments verschijnen ze automatisch als alleen-lezen context in de menselijke workflow.
• Evidence-routes leveren schone fotometadata en originele bestanden afzonderlijk of als ZIP. Het publieke contract levert nooit maskers, contouren, geannoteerde beelden of opslag-URL’s. Zie Rapporten en bewijs.
• Rijbewijsextractie levert te beoordelen voorstellen en wijzigt een bevestigde bestuurder niet stilzwijgend.

De API-referentie bepaalt exacte velden, limieten en reacties. Zie synchronisatie en fouten voor volgordeproblemen.