Ein Händler bekommt ein Fahrzeug aus Frankreich angeboten, ein Verwerter eines aus Polen. Die Dokumente folgen fremden Mustern, die Felder heissen anders, und die Fahrgestellnummer steht nicht dort, wo man sie aus dem eigenen Land kennt. Wer abtippt, tippt falsch; wer übersetzen lässt, verliert Tage.
Die internationale Dokumentlesung liefert beides: die kanonischen Felder in einheitlicher Struktur und daneben den Originalwert mit seinem Quellcode. Die gelesene Fahrgestellnummer ist dann der Schlüssel für Fahrzeugdaten, Rückrufe und die Erlösschätzung — ohne eine einzige Übersetzung.
| Fläche | Rollen |
|---|---|
| Hub | Fahrzeughandel, Autoverwerter, Flotte und Leasing |
Was dieser Fall voraussetzt
- Das Zulassungsdokument als abrufbare Datei. Der Aufruf nimmt
fileUrloderimageUrl; für persönliche Dokumente ist nur die Stufestandardvorgesehen. - Die Befugnis zur Verarbeitung. Zulassungsdokumente und Kennzeichen sind personenbezogene Daten und brauchen eine Rechtsgrundlage.
- Aufnahmen des Fahrzeugs mit Kennzeichen. Die Kennzeichenlesung nimmt bis zu drei Bilder.
- Eine Rahmenbedingung für die Erlösschätzung. Land, Zustand und Fahrzeugtyp bestimmen, gegen welchen Markt gerechnet wird.
- 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 |
|---|---|---|
| Dokument lesen | POST /scanner/document/registration/international | document.countryCode, vehicle.vin, inspection.validUntil — und fields mit sourceValue im Original |
| Kennzeichen ablesen | POST /vision/license-plate | text, country und confidence je Schild — ohne Halter- oder Registerabfrage |
| Fahrzeug bestimmen | GET /vin/{vin}/vehicle | Baureihe und technische Merkmale zur gelesenen Fahrgestellnummer |
| Rückrufe prüfen | GET /recalls/vehicles/{vin} | Treffer aus den amtlichen Registern, jeweils mit Datenstand |
| Erlös einschätzen | GET /vin/{vin}/economic-evaluation | Einkaufsempfehlung auf dem Minimum, bevor verhandelt wird |
Warum jede Stufe nötig ist
- Das Dokument lesen.
POST /scanner/document/registration/internationalliefertdocumentmitcountryCodeunddocumentType,registration,holder,inspectionmitvalidUntilundvehiclemitvin,makeundfuelType. Infieldssteht jedes Feld zusätzlich mitsourceCodeundsourceValue— so bleibt nachprüfbar, was im Original stand. - Das Kennzeichen ablesen.
POST /vision/license-plateliest je Schildtext,normalized,country,confidence,positionundobstructions. Ausgegeben wird nur, was auf dem Bild steht: keine Halterabfrage, kein Registerabgleich, keine Aussage darüber, ob das Kennzeichen echt ist. Der Abgleich mit dem Dokument ist Ihre Plausibilitätsprüfung. - Das Fahrzeug bestimmen.
GET /vin/{vin}/vehicleliefert Baureihe und technische Merkmale zur gelesenen Fahrgestellnummer. Die Fahrzeugdaten kommen aus Referenzdaten, nicht aus dem ausländischen Dokument — und sind deshalb unabhängig von dessen Aufbau. - Rückrufe prüfen.
GET /recalls/vehicles/{vin}gibt die Treffer aus den amtlichen Registern mit Datenstand zurück. Ein offener Rückruf ändert den Ankaufspreis, und er ist leichter vor dem Kauf zu verhandeln als danach. - Den Erlös einschätzen.
GET /vin/{vin}/economic-evaluationnimmtcountry,conditionundvehicleTypeund liefert eine Einkaufsempfehlung auf dem Minimum der Preise. Diese Empfehlung steht damit schon vor der Verhandlung zur Verfügung und ist vor ihrer Verwendung eigenständig zu prüfen.
curl -X POST \
-H 'X-Api-Key: <API_KEY>' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: ankauf-import-fr-0412' \
-d '{"fileUrl":"https://example.com/zulassung-frankreich.pdf","quality":"standard"}' \
'https://api.tapinomahub.com/scanner/document/registration/international'Was am Ende vorliegt
Am Ende steht ein Ankauf, dessen Daten aus dem Originaldokument und aus Referenzdaten stammen, nicht aus einer Übersetzung — mit abgelesenem Kennzeichen, bekanntem Rückrufstand und einer Einkaufsempfehlung vor der ersten Verhandlungsrunde.
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
Welche Länder werden gelesen?
Die verbindliche Liste der Dokumentprofile steht im OpenAPI-Vertrag. Die Antwort nennt in document das erkannte Land, Profil und Dokumenttyp.
Warum stehen Originalwerte neben den kanonischen Feldern?
Damit nachprüfbar bleibt, was im Dokument stand. sourceCode und sourceValue zeigen das Original, code und value die vereinheitlichte Form.
Prüft die Kennzeichenlesung, ob das Fahrzeug zugelassen ist?
Nein. Sie liest nur, was auf dem Bild steht. Es gibt keine Halterabfrage und keinen Registerabgleich.
