Gutachtensoftware anbinden: Dokumente auslesen, Schäden beschreiben, Fahrzeuge abgleichen

Wo im Prozess Daten fehlen

Ein Gutachten beginnt fast immer mit Material, das schon existiert: Schein als Handyfoto, Werkstattkalkulation als PDF, Vorgutachten, Bilder aus der Halle. In der Software ist es angehängt, nicht ausgelesen. Die Felder tippt jemand ab.

• Fahrzeugaufnahme. VIN, Schlüsselnummern und Emissionsangaben (siehe Abgasnorm und Schadstoffklasse: Was Euro 1 bis Euro 7 bedeuten) werden vom Schein in die Fahrzeugakte übertragen — jede Übertragung von Hand ist eine Fehlerquelle.
• Vorkalkulation und Vorgutachten. Summen, Positionen und Ausstattung werden neu erfasst, obwohl sie im Dokument stehen.
• Schadenbeschreibung. Der Text „Stoßfänger vorn verformt, Kratzer bis auf die Grundierung“ entsteht bei jedem Auftrag neu und bei jedem Sachverständigen in anderer Formulierung.
• Vorschäden. Der Rundgang wird fotografiert, aber selten strukturiert erfasst — obwohl Schäden außerhalb der Schadenzone in Wiederbeschaffungswert und Restwert eingehen.
• Rückrufe und Einstufung. Offene Rückrufe und der Status des Fahrzeugs — noch Ware oder schon Abfall — werden getrennt recherchiert oder gar nicht.

Was die Schnittstelle liefert

Scanner-Endpunkte geben nur Werte zurück, die im Dokument oder Bild stehen; was fehlt, bleibt null. Für persönliche Dokumente wie den Schein gibt es derzeit nur die Stufe standard. POST /vehicles/intake fasst Schein, VIN-Abgleich und Rundgang in einem Aufruf zusammen (fileUrl, photoUrls); components nennt, was geliefert wurde, nicht Geliefertes wird anteilig erstattet.

Ein Ablauf von Anfang bis Ende

Ein Werkstattkunde meldet einen Frontschaden und schickt Bilder sowie ein Foto des Fahrzeugscheins.

1. Schein auslesen. Das Foto geht als Datei-URL an POST /scanner/document/registration; VIN und Schlüsselnummern landen strukturiert in der Fahrzeugakte (Felder in Zulassungsbescheinigung: Die Felder, die im Betrieb zählen). Ausländische Dokumente: POST /scanner/document/registration/international.
2. VIN am Fahrzeug bestätigen. Ohne Schein liest POST /scanner/vin/extract die Nummer vom Foto der Windschutzscheibe, des Typenschilds oder der Prägung. Unlesbar heißt vin gleich null — die Software fragt nach, sie ergänzt nichts.
3. Fahrzeug abgleichen. GET /vin/{vin}/vehicle liefert Fahrzeugdaten und eine stabile tapiId. Provider 2 und 3: direkte Abfrage; Provider 1: redirect_required — Ihr Server legt mit POST /vin/redirect-sessions (vin, returnUrl, optional state) eine Session an und leitet den Sachverständigen auf redirectUrl; der Abgleich läuft in der tapinoma-Oberfläche, der Rücksprung auf returnUrl trägt status=completed, tapiId und state. 404 vehicle_not_found ist ein Leerbefund, kein Fehler (siehe VIN: Die Fahrgestellnummer verstehen, prüfen und nutzen).
4. Vorhandene Dokumente übernehmen. Kalkulation oder Vorgutachten gehen an POST /scanner/document/calculation, Bestellungen und Rechnungen an POST /scanner/document/vehicle. Summen, Positionen und Ausstattung werden zu Feldern — nur mit Werten aus dem Dokument.
5. Schaden beschreiben. Bis zu fünf Aufnahmen desselben Schadens gehen an POST /vision/damage/describe. Zurück kommt Text in sechs festen Abschnitten: Bauteil, Verformungen, Kratzer, Lack und Korrosion, Anbauteile, Sonstiges — Rohmaterial für das Feld „Schadenbeschreibung“. Der Sachverständige prüft, kürzt und ergänzt, so nüchtern wie Karosserieteile: Zustand beurteilen und ehrlich beschreiben es für die Karosserie empfiehlt.
6. Gesamtzustand und Einstufung. Der Rundgang mit bis zu 8 Aufnahmen geht an POST /vision/condition-report: Befunde je Zone, Gesamtstufe A, B oder C. Bei möglichem Totalschaden nimmt POST /vision/vehicle/elv-classification bis zu 10 Aufnahmen plus Marktwert und Reparaturschätzung aus dem Gutachten entgegen und antwortet mit kein_altfahrzeug_verdacht, gutachten_empfohlen oder altfahrzeug. Rechtlicher Hintergrund: Gebrauchtwagen oder Altfahrzeug? Die Abgrenzung beim Export, Unfallfahrzeuge: Totalschaden, Restwert und was für den Verwerter zählt.
7. Rückrufe anhängen. GET /recalls/vehicles/{vin} gleicht die Baureihe gegen Kraftfahrt-Bundesamt, EU Safety Gate und NHTSA ab; je Maßnahme Aktenzeichen, Mangel, Abhilfe und Stop-Drive-Kennung. Eine Arbeitshilfe, kein amtlicher Nachweis.

curl \
  -H 'X-Api-Key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"fileUrl":"<DOKUMENT_URL>"}' \
  'https://api.tapinomahub.com/scanner/document/calculation'

Der Einbau

1. Schlüssel serverseitig ablegen. Der X-Api-Key gehört in die Konfiguration des Backends. Bilder und Dokumente lädt Ihr Server hoch und übergibt sie als Datei-URL.
2. Mit einem Endpunkt beginnen. POST /scanner/document/calculation ist meist der lohnendste Einstieg: Vorkalkulationen liegen ohnehin als PDF vor.
3. Feldzuordnung festlegen. Welche Antwortfelder landen wo in der Fahrzeugakte, welche bewusst nirgends? Ausstattungscodes kommen als Strings, Serie und Sonderausstattung getrennt. Diese Abbildung ist die eigentliche Arbeit.
4. Leerbefund und Fehler trennen. null, vin gleich null und 404 vehicle_not_found sind fachliche Ergebnisse: Feld leer, Nacharbeit angezeigt, Vorgang läuft weiter. Ein technischer Fehler ist eine ausbleibende Antwort oder ein Serverfehler.
5. Abholung einbauen. Lang laufende Vorgänge antworten mit 202, Location, Retry-After und Job-ID; abgeholt wird über den zugehörigen .../jobs/{jobId}-Endpunkt — etwa GET /vin/{vin}/parts mit GET /vin/parts/jobs/{jobId}.
6. Ausrollen und beobachten. Erst ein Pilotbüro, dann alle. GET /client/usage zeigt die Häufigkeit je Endpunkt; X-Tapinoma-Usage-Warning meldet knappes Guthaben.

Worauf zu achten ist

• Idempotency-Key setzen. Wiederholungen tragen X-Tapinoma-Idempotent-Replay. Aufrufe, die einen Schlüssel einmalig ausgeben, werden nicht gereplayt — nach Timeout Bestand abgleichen statt blind wiederholen.
• Leere Felder leer lassen. Ein null aus dem Dokument ist eine Aussage; ein Standardwert sieht im Gutachten wie ein Befund aus.
• `tapiId` speichern. GET /vehicles/{tapiId} liefert die technischen Daten später als Bestandteil des zuvor bezahlten VIN-Ablaufs, ohne VIN und Ausstattung.
• Schlüssel nie im Browser. Auch nicht in einer App für den Außendienst — der Upload läuft über Ihren Server.
• Bilder in voller Auflösung. Vorschaubilder erzeugen Lücken, keine Befunde — und die Analyse wird berechnet, auch wenn nichts erkennbar war.
• Rate-Limits je Büro. PUT /client/users/{clientId}/rate-limits begrenzt je Nutzer, Schlüssel oder Endpunkt.
• Ergebnis prüfen. Ausgelesene Summen und Beschreibungen sind Eingabe für den Sachverständigen, nicht sein Urteil. Zu personenbezogenen Daten im Schein: Daten im Altfahrzeug: Was im Infotainment bleibt, wenn das Fahrzeug geht.

Was die Schnittstelle nicht tut

Sie erstellt kein Gutachten und ersetzt keinen Sachverständigen. Die Schadenbeschreibung ist ein Text über Sichtbares, keine Bewertung; der Zustandsbericht enthält keine Reparatur- oder Restwertkalkulation; die Altfahrzeug-Einstufung setzt Marktwert und Reparaturschätzung aus Ihrem Gutachten voraus und entscheidet nicht. Die Preisbewertung zu Teilen ist indikativ, keine Garantie. POST /vision/license-plate liest ein Kennzeichen, ohne Halterabfrage. Provider 1 ist für Drittsysteme nicht direkt abrufbar, nur über den Browser-Redirect. Der Rückrufabgleich ist baureihenbezogen, kein amtlicher Nachweis für das einzelne Fahrzeug. Verkauft wird kein Datenbestand: Geschuldet ist die Durchführung der Abfrage oder Analyse; Prüfung und Verwendung liegen bei Ihnen und Ihren Kunden.