Börsenfertigen Inseratstext erzeugen

Das bekommen Sie zurück

Sie erhalten Titel, Beschreibung und Ausstattungs-Highlights in Deutsch, Englisch oder Französisch sowie transparente Angaben zu Datenumfang und möglicher Kürzung.

Ein typischer Einsatz im Betrieb

Nach der Fahrzeugbewertung klickt der Remarketing-Mitarbeiter auf „Inserat erstellen“. Aus den geprüften Daten entsteht ein vollständiger Text, den er nur noch redaktionell freigibt.

Der greifbare Mehrwert

Aus Bildern, Dokumenten oder Kennungen entsteht eine konkrete Arbeitsgrundlage. Ihr Team spart Erfassung, arbeitet einheitlicher und kann sich auf die fachliche Entscheidung konzentrieren.

Spart Such-, Erfassungs- oder Wartezeit, weil der Arbeitsschritt direkt im gewohnten System angestoßen und abgeschlossen wird.
Verbessert die wirtschaftliche Nutzung vorhandener Daten, weil Angebote schneller vollständig, auffindbar und nachvollziehbar werden.

Für wen das besonders wertvoll ist

Einsatzbereich	Der konkrete Vorteil
Fahrzeughandel	Beschleunigt Hereinnahme, Datenprüfung und Vermarktung, ohne eine zweite Fahrzeugakte aufzubauen.
Autoverwerter	Verbindet Fahrzeugannahme, Demontage, Teileerfassung und Bestandsvermarktung in einem konsistenten Datenfluss.
Werkstätten	Reduziert manuelle Übertragung und Fehlzuordnungen zwischen Fahrzeug, Auftrag und benötigtem Teil.
Flotten, Leasing und Remarketing	Standardisiert Fahrzeugprüfung, Dokumentation und Übergabe über Standorte und Dienstleister hinweg.
ERP-, DMS-, Shop- und Softwareanbieter	Bettet die Funktion per API in das führende System ein und verarbeitet Ergebnisse ohne Medienbruch weiter.

So passt der Endpunkt in Ihren Ablauf

Der Endpunkt übernimmt einen klaren Arbeitsschritt und gibt das Ergebnis direkt an den nächsten Schritt weiter.

Ein berechtigtes Bild, Dokument oder eine vorhandene Kennung wird aus dem gewohnten System übergeben.
tapinomahub erkennt, ordnet oder gestaltet die benötigten Inhalte.
Ein Mitarbeiter prüft das Ergebnis und gibt es für Akte, Bestand, Angebot oder Verkauf frei.

Was der Inseratsmotor tatsächlich zurückgibt

Der Aufruf beginnt nicht mit einer freien VIN, sondern mit der stabilen tapiId aus einem zuvor erfolgreich abgeschlossenen VIN-Prozess. tapinomahub formuliert aus den dazu dokumentierten Fahrzeugdaten einen marktplatzfähigen Textentwurf. Ihr DMS, ERP oder Portal ergänzt anschließend Preis, Kilometerstand, aktuellen Zustand, Schäden, Fotos, Verkäuferangaben und die Pflichtfelder des Zielkanals.

Rückgabe	Nutzen im Betrieb
`title`	Ein kompakter Inseratstitel aus belegten Fahrzeugmerkmalen als Ausgangspunkt für Website, Börse oder B2B-Exposé.
`description`	Eine lesbare Fahrzeugbeschreibung ohne erfundene Ausstattung sowie ohne Preis-, Zustands- oder Wertversprechen.
`highlights`	Dokumentierte Ausstattungsmerkmale werden als einzeln weiterverarbeitbare Vorteile geliefert und können in Karten, Listen oder Plattformfelder übernommen werden.
`documentedEquipmentCount`	Macht sichtbar, wie viele Ausstattungsmerkmale in der Fahrzeugakte belegt sind. Die Zahl ist ein Kontrollwert, keine Behauptung vollständiger Werksausstattung.
`truncated`	Zeigt an, ob der Entwurf gekürzt wurde. Bei `true` prüft die Redaktion, welche belegten Details separat aufgenommen werden sollen.
`format`, `tapiId` und `language`	Erhalten Fahrzeugbezug, Ausgabeformat und Sprache maschinenlesbar, damit Entwurf und Freigabe dem richtigen Bestandseintrag zugeordnet bleiben.

Drei realistische Betriebsfälle

User Story	So läuft der Prozess	Greifbarer Mehrwert
Autohandel: Als Disponent möchte ich kurz nach der Fahrzeugaufnahme einen vollständigen ersten Inseratsentwurf erhalten, damit ein Fahrzeug nicht wegen reiner Schreibarbeit unvermarktet bleibt.	Zulassungsdaten erfassen, VIN-Prozess abschließen, `tapiId` speichern, Sprache und belegte Händlernotizen übergeben, Entwurf prüfen und danach über den eigenen Connector in mobile.de, die Website oder weitere Kanäle übertragen.	Kürzere Zeit von der fertigen Fahrzeugakte bis zum freigegebenen Inserat, weniger Copy-and-paste und weniger übersehene dokumentierte Extras. Nicht null Sekunden, sondern ein messbar schnellerer Freigabeprozess.
Unfallfahrzeug und Restwertbörse: Als Remarketing-Verantwortlicher möchte ich eine neutrale Fahrzeug- und Ausstattungsbasis mit der getrennt dokumentierten Schadenakte verbinden, damit Bieter Chancen und Risiken schneller erfassen.	Compose Vehicle Listing liefert den belegten Fahrzeugtext. Schäden, Zustand und Fotos kommen separat aus Rücknahmeprotokoll, Gutachten oder `POST /vision/condition-report` hinzu und werden vor Veröffentlichung fachlich freigegeben.	Ein konsistenteres B2B-Exposé, weniger Rückfragen zu Ausstattung und eine bessere Vergleichbarkeit. Höhere Gebote bleiben eine mögliche Folge, keine zugesicherte Wirkung.
Flotte und Leasing: Als Flottenmanager möchte ich viele Rückläufer nach derselben Logik vorbereiten, damit Qualität nicht von der Tagesform einzelner Bearbeiter abhängt.	Für jede `tapiId` denselben Ablauf, die gewünschte Sprache und einen eigenen `Idempotency-Key` verwenden. CI-Ton, Plattformfelder, Preise und Rücknahmezustand werden anschließend über Vorlagen und Freigaberegeln ergänzt.	Mehr Durchsatz ohne proportionale zusätzliche Textarbeit, konsistentere Entwürfe und weniger manuelle Übertragungsfehler. CI-Konformität entsteht im nachgelagerten Template, nicht automatisch im Endpunkt.

Vom Fahrzeug zur veröffentlichten Anzeige

Fahrzeug über den dokumentierten VIN-Prozess identifizieren. Falls der gewählte Provider eine Browserfreigabe verlangt, wird zuerst der Redirect abgeschlossen und die zurückgegebene tapiId sicher der eigenen Fahrzeugakte zugeordnet.
Die dokumentierten Fahrzeugdaten bei Bedarf über GET /vehicles/{tapiId} prüfen. Aktuelle Betriebsdaten wie Kilometerstand oder Verkaufspreis bleiben in den dafür verantwortlichen Quellsystemen.
Für den Inseratsentwurf language, gewünschte Qualitätsstufe und höchstens 500 Zeichen sachliche notes festlegen. Ein eigener Idempotency-Key verhindert eine unbeabsichtigte doppelte Ausführung; erfolgreiche Antworten können damit 24 Stunden wiederholt werden.
POST /vehicles/{tapiId}/listing aufrufen und Titel, Beschreibung, Highlights, documentedEquipmentCount sowie truncated übernehmen.
Fehlende oder gekürzte Inhalte gezielt prüfen. Nicht belegte Ausstattungen werden nicht ergänzt; ein unbekannter oder fremder Fahrzeugbezug führt zu 404 vehicle_not_found statt zu einem geratenen Text.
Preis, Kilometerstand, aktueller Zustand, Schäden, Bilder, Gewährleistungsinformationen und weitere Pflichtfelder aus freigegebenen Systemen ergänzen. Der Endpunkt erzeugt diese Aussagen bewusst nicht.
Den fertigen Datensatz gegen das Schema des Zielkanals validieren. Die mobile.de Seller-API kann Anzeigen programmatisch anlegen und verwalten, benötigt dafür aber einen separaten Connector und eigene Zugangsdaten.
Erst nach redaktioneller und fachlicher Freigabe veröffentlichen und Zeitstempel, Version, Zielkanal sowie spätere Korrekturen in der Fahrzeugakte protokollieren.

Zeitgewinn und Qualität belastbar messen

Sinnvolle Kennzahlen: Median von vollständiger Fahrzeugakte bis Veröffentlichung, Bearbeitungszeit je Inserat, Erstfreigabequote, Anzahl dokumentierter Highlights, Anteil truncated=true, manuelle Korrekturen, Plattformablehnungen, fehlende Pflichtfelder und Zeit bis zur ersten qualifizierten Anfrage. Verkaufspreis und Standtage sollten nur für vergleichbare Fahrzeuggruppen und mit weiteren Einflussfaktoren bewertet werden.

Recht und Plattformregeln bleiben Teil der Freigabe

Für Deutschland untersagt § 5 UWG irreführende Angaben unter anderem zu wesentlichen Eigenschaften, Verfügbarkeit und Preis. Bei Angeboten an Verbraucher verlangt die Preisangabenverordnung klare, zugeordnete Gesamtpreise. Weil Compose Vehicle Listing weder Preis noch Zustand erzeugt, müssen diese Angaben im nachgelagerten Verkaufsprozess aus verantwortlichen Quellen ergänzt und kontrolliert werden. Die Plattform kann darüber hinaus eigene Pflichtfelder und Validierungsregeln verlangen.

Wenn es an die Umsetzung geht

Felder, Beispiele, mögliche Antworten und Preise finden Sie in der API-Dokumentation zu POST /vehicles/{tapiId}/listing.

Quellen und Rechtsgrundlagen

Häufige Fragen

Was bekomme ich von diesem Endpunkt zurück?