Fahrzeugakte aus dem Fahrzeugschein: Hereinnahme, Zustand, Inserat

Ein Fahrzeug kommt in Zahlung, aus einem Leasingrücklauf oder vom Ankauf. Bis es online steht, wird es in der Regel dreimal erfasst: einmal für die Warenwirtschaft, einmal für die Bewertung, einmal für das Inserat. Jede Erfassung ist eine Gelegenheit, einen Zahlendreher in die Fahrgestellnummer zu setzen, und jede kostet Zeit, in der das Fahrzeug Standfläche belegt statt Geld zu verdienen.

Der Hub dreht die Reihenfolge: Das Foto des Fahrzeugscheins legt die Akte an, und der Abruf der technischen Daten sowie das Inserat hängen an der tapiId, sofern eine zurückkommt. Der Zustandsbericht über POST /vision/condition-report nimmt keine tapiId entgegen, sondern entsteht allein aus den eingereichten Aufnahmen.

Was dieser Fall voraussetzt

• Eine lesbare Aufnahme des Fahrzeugscheins. Der Aufruf nimmt eine abrufbare Bildadresse entgegen, keine hochgeladene Datei. Ein Vorschaubild mit wenigen Hundert Pixeln enthält keine lesbare Fahrgestellnummer — laden Sie die grösste vorhandene Fassung.
• Das Recht an dem Dokument. Ein Fahrzeugschein enthält personenbezogene Daten. Mit dem Absenden bestätigen Sie, dass Sie zur Übermittlung und automatisierten Verarbeitung befugt sind.
• Aufnahmen des Fahrzeugs, wenn ein Zustandsbericht entstehen soll. Ohne Bilder gibt es keinen belegten Zustand; geschätzt wird nicht.
• Eine Stelle, an der die tapiId gespeichert wird. Der Abruf der technischen Daten und das Inserat verlangen sie als Pfadparameter; ohne sie entfallen beide Stufen.
• 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.

Warum jede Stufe nötig ist

1. Die Akte anlegen. POST /vehicles/intake liest den Fahrzeugschein unter fileUrl, nimmt optional Fahrzeugfotos als photoUrls und legt die Fahrzeugakte an. Das Ergebnis enthält neben dem Textauszug eine Kennung, die tapiId; sie kann null sein. Wer sie nicht speichert, hat die Hereinnahme gemacht und den Nutzen verschenkt.
2. Die technischen Daten holen. GET /vehicles/{tapiId} liefert Modell, Motorisierung und technische Details zur Akte. Diese Stufe ist der Grund, warum der Fahrzeugschein allein genügt: Die technische Tiefe kommt aus den Referenzdaten, nicht aus dem Dokument.
3. Den Zustand dokumentieren. POST /vision/condition-report erstellt aus den eingereichten Aufnahmen einen Zustandsbericht. Er beschreibt, was auf den Bildern sichtbar ist. Ein Kratzer, der nicht fotografiert wurde, steht nicht im Bericht — und soll dort auch nicht stehen.
4. Das Inserat erzeugen. POST /vehicles/{tapiId}/listing formuliert den börsenfertigen Text. Weil er aus der Akte entsteht, nennt er keine Ausstattung, die niemand belegt hat. Das ist der Unterschied zwischen einem Inserat, das verkauft, und einem, das später beanstandet wird.

curl -X POST \
  -H 'X-Api-Key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: hereinnahme-2026-0412' \
  -d '{"fileUrl":"https://example.com/fahrzeugschein.jpg","photoUrls":["https://example.com/front.jpg","https://example.com/heck.jpg"],"includeOwner":false}' \
  'https://api.tapinomahub.com/vehicles/intake'

Was am Ende vorliegt

Am Ende steht eine Fahrzeugakte, in der jede Angabe auf ein Dokument, auf Referenzdaten oder auf eine Aufnahme zurückgeht. Der Inseratstext entsteht aus den für die tapiId dokumentierten Fahrzeugdaten; der Zustandsbericht bleibt an die eingereichten Aufnahmen gebunden.

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.