Eine Reparaturkalkulation ist ein dichtes Dokument: Positionen, Arbeitswerte, Ersatzteilnummern, Ausstattung. Als PDF ist sie für einen Menschen lesbar und für ein System wertlos. Wer sie abtippt, überträgt Fehler; wer sie ignoriert, verliert die belastbarste Beschreibung des Schadens, die es gibt.
Die Kette trennt bewusst zwei Quellen: Das Dokument sagt, was kalkuliert wurde, die Aufnahmen sagen, was zu sehen ist. Beides gehört in dieselbe Akte, aber nicht in dasselbe Feld — sonst lässt sich später nicht unterscheiden, was gemessen und was beschrieben wurde.
| Fläche | Rollen |
|---|---|
| Hub | Sachverständige und Versicherer, Werkstatt, Fahrzeughandel |
Was dieser Fall voraussetzt
- Die Kalkulation als abrufbares Dokument. Ein Ausdruck, der abfotografiert wurde, geht auch — nur sinkt die Trefferquote mit der Auflösung.
- Aufnahmen des Schadens, wenn eine Beschreibung entstehen soll. Ohne Bild keine Beschreibung; geschätzt wird nichts.
- Die Befugnis zur Übermittlung. Kalkulationen enthalten regelmäßig Namen, Kennzeichen und Versicherungsdaten.
- Eine Entscheidung, wofür die Akte dient. Für die Restwertermittlung zählen andere Felder als für die Demontageplanung.
- Die Berechtigung zur Fahrzeugabfrage. Mit dem Aufruf bestätigen Sie, Halter, Eigentümer oder nachweislich bevollmächtigt beziehungsweise anderweitig rechtlich berechtigt zu sein und die Fahrgestellnummer ausschließlich für den angegebenen zulässigen Zweck zu verwenden.
Der Ablauf
Die Tabelle nennt je Stufe den zuständigen Aufruf und das, was danach vorliegt. Die Begründung, warum die Stufe nicht übersprungen werden kann, steht darunter.
| Stufe | Aufruf | Was danach vorliegt |
|---|---|---|
| Kalkulation auslesen | POST /scanner/document/calculation | Positionen, Arbeitswerte und Ausstattung strukturiert statt als PDF |
| Fahrzeugdaten ziehen | POST /scanner/document/vehicle | Fahrzeug und Ausstattung aus demselben Dokument, ohne Abtippen |
| Schaden beschreiben | POST /vision/damage/describe | Beschreibung dessen, was auf den Aufnahmen sichtbar ist — nicht mehr |
| Bauteil einstufen | POST /vision/part/quality | Qualitätsstufe je Bauteil als Grundlage für Wiederverwendung oder Ersatz |
Warum jede Stufe nötig ist
- Die Kalkulation auslesen.
POST /scanner/document/calculationnimmt das Dokument unterfileUrlin der einzig vorgesehenen Stufestandardund gibt Positionen, Arbeitswerte und Ausstattung strukturiert zurück. Das ist der Schritt mit dem grössten Hebel: Er ersetzt die Handarbeit, die sonst niemand macht. - Die Fahrzeugdaten ziehen.
POST /scanner/document/vehicleholt Fahrzeug und Ausstattung aus demselben Dokument. Getrennter Aufruf, weil nicht jede Akte die Kalkulationstiefe braucht — manche braucht nur das Fahrzeug. - Den Schaden beschreiben.
POST /vision/damage/describebeschreibt, was auf den Aufnahmen sichtbar ist. Diese Stufe ergänzt die Kalkulation, sie korrigiert sie nicht: Ein kalkulierter Austausch und ein sichtbarer Kratzer sind zwei Aussagen. - Das Bauteil einstufen.
POST /vision/part/qualitygibt je Bauteil eine Qualitätsstufe. Erst damit lässt sich entscheiden, was wiederverwendet und was ersetzt wird — die Kalkulation allein beantwortet das nicht.
curl -X POST \
-H 'X-Api-Key: <API_KEY>' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: schaden-2026-0871-kalkulation' \
-d '{"fileUrl":"https://example.com/kalkulation.pdf","quality":"standard"}' \
'https://api.tapinomahub.com/scanner/document/calculation'Was am Ende vorliegt
Am Ende steht eine Akte, in der kalkulierte Positionen, Fahrzeugdaten und sichtbarer Zustand getrennt voneinander nachvollziehbar sind. Für den Sachverständigen ist das die Grundlage der Bewertung, für den Verwerter die Grundlage der Demontageplanung.
Wo das in der Dokumentation steht
Die verbindlichen Feldlisten, Fehlercodes und Beispielantworten stehen im OpenAPI-Vertrag dieser Fläche unter docs.tapinomahub.com (tapinoma-hub). Alle Anwendungsfälle nach Fläche und Rolle geordnet: Übersicht der Anwendungsfälle.
Quellen und Rechtsgrundlagen
Häufige Fragen
Kann ich eine mehrseitige Kalkulation einreichen?
Die verbindlichen Angaben zu Format und Umfang stehen im OpenAPI-Vertrag. Wichtig ist in jedem Fall die Auflösung: Was auf dem Bild nicht lesbar ist, steht nicht in der Antwort.
Warum gibt es zwei Aufrufe für dasselbe Dokument?
Weil nicht jede Akte dieselbe Tiefe braucht. Wer nur das Fahrzeug und die Ausstattung sucht, nimmt POST /scanner/document/vehicle statt des Kalkulationsaufrufs.
Darf ich die Schadenbeschreibung in ein Inserat übernehmen?
Sie können sie als Grundlage verwenden. Verantwortlich für die Angaben im Inserat bleiben Sie — die Beschreibung beschreibt Sichtbares und sichert keinen Zustand zu.