Den Schaden am Karosserieteil zeigen, bevor es ausgebaut ist

Ein Verwerter will eine Fahrertür verkaufen, bevor er sie ausbaut: Ausgebaut wird erst, was verkauft ist. Die Fotos vom Fahrzeug zeigen die Tür aber schräg, mit Nachbarteilen und Hintergrund. Ein Käufer will die Tür in einer Standardansicht sehen — mit dem Schaden, den sie tatsächlich hat.

Die Schadensübertragung überträgt ausschliesslich sichtbare Befunde vom montierten Teil auf bereitgestellte Standardansichten desselben Bauteils. Was sich nicht belastbar zuordnen lässt, bleibt aus dem Bild und steht in notTransferred; verdeckte Rückseiten und nicht fotografierte Flächen werden nicht ergänzt. Das Ergebnis ist eine bearbeitete Ansicht, kein Foto des Einzelteils — und muss als solche erkennbar bleiben.

Was dieser Fall voraussetzt

• Ein bis fünf Aufnahmen des montierten Teils. Je Aufnahme kann optional eine Maske über partMaskUrl mitgegeben werden.
• Standardansichten desselben Bauteils. Bis zu sechs Zielansichten; jede nennt ihre view. Ohne eigene Standardansicht gibt es kein Ziel.
• Die OE-Nummer des Teils. Sie trägt die Marktplatzdaten; die Schadensübertragung selbst braucht sie nicht.
• Eine Kennzeichnung im Inserat. Die Zielansichten sind bearbeitete Darstellungen; je Asset nennt provenance.requiredLabel die Kennzeichnung, und provenance.disclosureEmbedded ist true.

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. Den Schaden beschreiben. POST /vision/damage/describe nimmt bis zu fünf imageUrls desselben Schadens und liefert einen report; textQuality wählt zwischen notes, prose und expert. Der Text beschreibt Sichtbares und ist die Grundlage für die Artikelbeschreibung.
2. Den Schaden übertragen. POST /vision/part/damage-transfer nimmt sources mit dem montierten Teil und targets mit den Standardansichten, jeweils mit view und optional einer Maske. Zurück kommen assets je bearbeiteter Zielansicht mit provenance, findings mit type, location, confidence und transferredToViews sowie notTransferred. Kann die Ausgabe nicht sicher verifiziert werden, antwortet der Aufruf mit 422 und damage_not_transferable oder image_edit_unverified.
3. Den Zustand einstufen. POST /vision/part/quality liefert grade, reworkEffort und refinishEffort mit Kriterien und Beobachtungen — oder gradable false, wenn die Bilder es nicht tragen. Die Stufe gehört ins Inserat, der Aufwand in die Kalkulation des Käufers.
4. Die Marktplatzdaten erzeugen. GET /parts/oe/{oeNumber}/seo liefert content.ebayTitle, categoryId, itemSpecifics und keywords für den gewählten Marktplatz. Der Titel beschreibt das Teil; der Schaden gehört in Beschreibung und Zustand, nicht in eine geschönte Überschrift.

curl -X POST \
  -H 'X-Api-Key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: tuer-links-schaden-0917' \
  -d '{"sources":[{"imageUrl":"https://example.com/tuer-montiert.jpg","view":"left"}],"targets":[{"imageUrl":"https://example.com/tuer-standard-links.jpg","view":"left"}],"partType":"Fahrertür links","quality":"standard","output":{"size":"1536x1024","format":"jpeg"}}' \
  'https://api.tapinomahub.com/vision/part/damage-transfer'

Was am Ende vorliegt

Am Ende steht ein Inserat für ein Teil, das noch am Fahrzeug sitzt, mit bearbeiteten Standardansichten, auf die sichtbare Befunde übertragen wurden, einer Zustandsstufe und einer Beschreibung. Ausgebaut wird, wenn verkauft ist.

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.