Rental-Ablauf für Fahrzeuginspektionen

Ihr Vermietsystem verwaltet Reservierungen und kaufmännische Bedingungen. TrakarIA erhält den für die Fahrzeuginspektion erforderlichen Kontext und führt die maßgebliche Inspektionsakte, Nachweise und validierten Berichtsversionen.

API-Szenarien ausprobieren: Öffnen Sie das interaktive Integrationstestprogramm. Die folgenden Seiten bleiben die verbindliche Beschreibung des öffentlichen Vertrags und der Anwendungsfälle.

Beginnen Sie mit der Produktübersicht, wenn TrakarIA für Sie neu ist. Die Integrationsmodelle helfen bei der Wahl der Anbindung. Die Schritt-für-Schritt-Szenarien zeigen Standardablauf und Wiederherstellungsfälle.

Aufgabenverteilung

Beteiligter	Verantwortung	Beispiel
Ihr Vermietsystem	Reservierungsreferenz, geplante Zeiten und kaufmännische Entscheidungen	Erstellt RES-1042; entscheidet, ob ein Schaden berechnet wird
TrakarIA	Inspektionsablauf, Nachweise, menschliche Validierung und Berichtshistorie	Erfasst den Zustand bei der Abfahrt und vergleicht ihn mit der Rückgabe
Ihre Mitarbeiter	Handlungen unter ihrer eigenen TrakarIA-Identität	Melden sich an, fotografieren, prüfen Befunde und validieren eine Inspektion

Ein Gruppen-API-Schlüssel identifiziert Ihre Software. Er identifiziert weder die Person, die die Inspektion durchführt, noch gewährt er ihr Zugriff. Die Person meldet sich bei TrakarIA an und benötigt die passenden Gruppenberechtigungen. Der Rental-Ablauf kann auch vollständig in der Anwendung ohne Partner-API ausgeführt werden.

Menschlicher Ablauf

1. Ein Fahrzeug besteht in einer TrakarIA-Gruppe; es wurde in der Anwendung erstellt oder von Ihrer Software synchronisiert.
2. Ein Rental-Vorgang enthält den betrieblichen Kontext einer Reservierung. TrakarIA ersetzt nicht Buchung, Zahlung oder Verfügbarkeitsverwaltung.
3. Eine berechtigte Person erfasst bei der Abfahrt den Fahrzeugzustand und validiert die Abfahrtsinspektion.
4. Bei der Rückgabe erfasst eine Person den aktuellen Zustand und validiert den Vergleich mit der Abfahrt. Es gibt keinen eigenen offiziellen Berichtstyp return.
5. Nutzt Ihre Software die öffentliche API, kann TrakarIA bei validierter Abfahrt oder Rückgabe signierte Webhooks senden. Ihr Backend lädt danach den Abfahrts- oder Vergleichsbericht.

Berichte, Fotos und Korrekturverlauf unterliegen den Aufbewahrungs- und Zugriffsregeln des Kontos. Die Integrationsmodelle erläutern, wann ausschließlich die Anwendung oder zusätzlich ein Startlink genutzt wird.

Ergebnisse per Webhook empfangen

Fügen Sie zur Benachrichtigung bei validierter Inspektion unter Organisation → Integrationen → API-Schlüssel → Webhooks verwalten ein HTTP- oder HTTPS-Ziel zum API-Schlüssel hinzu. Abonnieren Sie rental.departure.completed und rental.return.completed; ergänzen Sie rental.report.pdf_ready, wenn auch die PDF-Bereitschaft gemeldet werden soll. TrakarIA sendet ein signiertes POST an Ihr Backend. Prüfen Sie die Signatur mit dem Geheimnis dieses Ziels und verwenden Sie die Ereigniskennungen, um den Bericht über die authentifizierte API abzurufen: Ein Webhook ist eine Benachrichtigung, nicht der vollständige Bericht. Webhooks und Wiederherstellung beschreiben Prüfung und Nachholen verpasster Ereignisse.

Hauptablauf

1. Fahrzeug: PUT /v1/vehicles/by-external/{external_id} erstellt oder aktualisiert das Fahrzeug unter Ihrer stabilen Kennung.
2. Rental-Vorgang und Planung: PUT /v1/rentals/by-external/{external_id} verknüpft die Reservierung mit dem Fahrzeug und trägt sie sofort in die Planung ein. Im Anfragetext ist nur vehicle_external_id erforderlich; weitere Geschäftsfelder sind optional. Speichern Sie Rental-id und planning.entry_id. Verwenden Sie für unterstützte Kontextänderungen eine neuere Quellrevision oder PATCH /v1/rentals/{rental_id}.
3. Abfahrt: POST /v1/rentals/{rental_id}/inspections mit {"type":"departure"} erstellt die Inspektion oder setzt sie fort. Senden Sie einen eindeutigen Idempotency-Key. Eine Erstellung liefert 201 und already_started: false. Ein erneuter Aufruf mit einem neuen Schlüssel liefert dieselbe Inspektion mit 200 und already_started: true — keinen Fehler und kein Duplikat. Öffnen Sie die zurückgegebene launch_url in TrakarIA. Die ausführende Person muss sich anmelden.
4. Abfahrtsergebnis: Nach der Validierung meldet rental.departure.completed, dass der Abfahrtsbericht verfügbar ist. Laden Sie JSON und das PDF, sobald es bereit ist.
5. Rückgabe: Rufen Sie denselben Inspektionsendpunkt mit {"type":"return"} auf. Nach der Validierung meldet rental.return.completed den Vergleichsbericht mit der Abfahrt. Lesen Sie sein JSON und laden Sie das PDF, sobald es bereit ist. Der Berichtstyp lautet comparison, nicht return.

Falls ein Ereignis fehlt, fragen Sie GET /v1/events ab und lesen Sie den aktuellen Rental-Zustand oder Berichtsindex. Webhooks und Wiederherstellung erläutern dieses Muster.

Weitere unterstützte Wege

• GET /v1/inspections/{inspection_id} liest den Inspektionsstatus. POST /v1/inspections/{inspection_id}/launch erneuert einen abgelaufenen Startlink.
• Rental-Anlagen sind private Dokumente und von offiziellen Inspektionsfotos getrennt. Laden Sie sie über /v1/rentals/{rental_id}/attachments hoch oder listen Sie sie dort auf. Verknüpfte Dateien erscheinen ohne erneuten Upload automatisch als schreibgeschützter Kontext im menschlichen Ablauf.
• GET /v1/inspections/{inspection_id}/evidence stellt saubere betriebliche Fotometadaten bereit. Originalbilder können einzeln, als ZIP je Inspektion oder als ein Rental-ZIP geladen werden. Der öffentliche Vertrag enthält niemals Masken, Konturen, annotierte Darstellungen oder Speicher-URLs. Siehe Berichte und Nachweise.
• Die Führerscheinextraktion schlägt prüfbare Felder vor; sie ändert einen bestätigten Fahrer nicht stillschweigend.

Die API-Referenz definiert Felder, Limits und Antwortcodes exakt. Synchronisierung und Fehler behandelt Aktualisierungen außerhalb der Reihenfolge.