Berichte und Nachweise

Ergebnisse von Abfahrt und Rückgabe sind bewusst in unveränderliche Berichtsversionen, offizielle PDFs und geschützte Originalnachweise aufgeteilt. Folgen Sie den nachstehenden Schritten, statt sich auf den Zustellzeitpunkt eines Webhooks zu verlassen.

Schritt 1 — Verfügbarkeit ermitteln

GET /v1/rentals/{rental_id}/report liefert den aktuellen Index. Ein fertiger departure-Bericht kann bereits vorhanden sein, während comparison noch nicht verfügbar ist.

Menschliche Validierung	Inspektionsphase	Offizieller Berichtstyp
Abfahrt abgeschlossen	departure	departure
Rückgabe abgeschlossen	return	comparison

Es gibt keinen separaten offiziellen Berichtstyp return. Die Rückgabeinspektion erzeugt den Vergleich zwischen Abfahrt und Rückgabe.

Webhooks veranlassen Ihre Software zu einem schnelleren Abgleich, sind aber nicht die Quelle der Wahrheit. Lesen Sie nach rental.departure.completed, rental.return.completed oder einer Wiederherstellung nach Ausfall den Index erneut. Siehe Webhooks.

Schritt 2 — Unveränderliches JSON archivieren

1. Listen Sie mit GET /v1/rentals/{rental_id}/reports alle verfügbaren Versionen auf.
2. Lesen Sie die zu archivierende Version mit GET /v1/reports/{report_id}.
3. Speichern Sie öffentliche Berichtskennung, Version und Inhaltshash zusammen mit Ihrem Rental-Datensatz.

Eine unterstützte Korrektur erzeugt eine neue unveränderliche Version. Öffentliche Berichtskennung und Inhaltshash ändern sich; die bisherige Berichtskennung bezeichnet weiterhin die bisherige Version. Überschreiben Sie den Verlauf niemals ausschließlich anhand der Rental-Kennung.

Schritt 3 — Offizielles PDF laden

Rufen Sie GET /v1/reports/{report_id}/pdf auf.

• 200 liefert die PDF-Bytes.
• 202 bedeutet, dass Erzeugung oder Reparatur noch läuft. Beachten Sie Retry-After und fragen Sie danach GET /v1/jobs/{job_id} ab oder wiederholen Sie die PDF-Route.

Die API streamt das autorisierte PDF. Sie liefert der Integration keine dauerhafte Speicher-URL.

Schritt 4 — Originalnachweise auflisten

Rufen Sie GET /v1/inspections/{inspection_id}/evidence getrennt für die Kennungen der Abfahrts- und Rückgabeinspektion auf. Jedes Element enthält phase, kind, view, zone, ob ein Schaden verknüpft ist, sowie den öffentlichen content_path.

GET /v1/evidence/{evidence_id}/content streamt ein autorisiertes Originalbild. Bei historischen Datensätzen ohne MIME-Typ in den Speichermetadaten wird der Typ aus dem gespeicherten Objekt erkannt, statt fälschlich einen Integritätsfehler zu melden.

Der Nachweisvertrag stellt niemals Speicher-URLs, Konturen, Masken, Koordinaten oder annotierte Darstellungen bereit. is_fresh_for_record ist eine betriebliche Herkunftsinformation für die authentifizierte Integration; sie erscheint nicht im geteilten Berichts-JSON, PDF oder Webhook.

Schritt 5 — Nachweise gesammelt laden

Verwenden Sie einen dieser geschützten ZIP-Endpunkte:

Umfang	Endpunkt	Inhalt
Eine Inspektion	GET /v1/inspections/{inspection_id}/evidence/archive	Originalbilder dieser Abfahrts- oder Rückgabeinspektion
Gesamter Rental-Vorgang	GET /v1/rentals/{rental_id}/evidence/archive	Neueste Nachweise von Abfahrt und Rückgabe in getrennten Ordnern

Jedes ZIP enthält eine manifest.json mit sauberen öffentlichen Metadaten: Phase, Ansicht, Zone, Schadentyp, Schweregrad, betroffene Teile, Integritätsfelder und relativer Bildpfad. Die Bilder sind die unveränderten, nicht annotierten Originalbytes. Das Archiv enthält niemals Konturen, Masken, Annotationsebenen oder private Speicher-URLs. Das wirksame Größenlimit steht in GET /v1/capabilities unter limits.max_evidence_archive_bytes.

Schritt 6 — Anlagen getrennt halten

Rental-Anlagen sind private, von Ihrer Software gelieferte Dokumente und keine offiziellen Inspektionsnachweise. Laden und listen Sie sie über /v1/rentals/{rental_id}/attachments.

Wenn der Vorgang im TrakarIA-Ablauf für Abfahrt oder Rückgabe geöffnet wird, erscheinen diese Dokumente automatisch unter Zusätzliche Dokumente. Der Mitarbeiter öffnet dieselbe private Datei über einen kurzlebigen autorisierten Link; ein zweiter Upload ist nicht erforderlich. Die Dateien bleiben schreibgeschützter Kontext und werden weder in Nachweisarchive noch in den offiziellen Bericht aufgenommen.

Einfache Bildverarbeitung für Ihre Integration

Ihre Integration klassifiziert keine Inspektionsbilder und ordnet keine Fahrzeugansichten zu. Der Mitarbeiter nimmt Bilder in TrakarIA auf oder lädt sie dort hoch. TrakarIA erkennt die Ansicht, gruppiert Übersichten und Nahaufnahmen und akzeptiert brauchbare erkannte Ansichten automatisch. Der Mitarbeiter kann eine erkannte Ansicht jederzeit korrigieren.

Ist eine manuelle Korrektur nötig, führt die Oberfläche durch jedes Bild dieser Ansicht und speichert eine zusammenhängende Entscheidung für den vollständigen Satz. Eine Verarbeitung, die nach dieser Entscheidung endet, darf die Ansicht nicht stillschweigend wieder unvollständig machen. Eine echte Hinzufügung, Entfernung oder Neuzuordnung kann eine gezielte erneute Prüfung verlangen; vor der endgültigen Validierung führt die Oberfläche direkt zur betroffenen Ansicht. Diese interne Prüfung macht den öffentlichen Partnervertrag weder komplizierter noch blockierend.