Spenderfahrzeug
Das konkrete Fahrzeug mit VIN, Zugang, Laufleistung, Zustand und Demontagestatus.
VINFAHRZEUG-IDKOSTENMARKTDATEN · IMPORT V1
Vom Bestand zur
Marktintelligenz.
Sende uns Fahrzeug-, Teile-, Angebots- und Verkaufsdaten in einem klaren JSON-Format per E-Mail. Wir prüfen und importieren die Datei intern. So werden OE-Analysen und die Wirtschaftlichkeit jedes Spenderfahrzeugs auf derselben belastbaren Datengrundlage auswertbar.
01
DAS DATENMODELL
Ein Teil bleibt nachvollziehbar.
5 OBJEKTE / 1 KETTEOE-Nummer, physisches Teil und Inserat sind keine austauschbaren Identitäten. Das Zielformat hält sie getrennt und verbindet sie über dauerhafte Quell-IDs.
Physisches Teil
Die reale Verkaufseinheit aus genau einem Fahrzeug — mit OE-Zuordnung, Zustand und Lagerstatus.
OETEILE-IDZUSTANDListing
Ein Angebot auf genau einem Kanal. Mehrere Listings können dasselbe physische Teil referenzieren.
EINSTELLPREISKANALSTATUSEreignis
Preis- und Statusänderungen bleiben als Zeitreihe erhalten, statt den vorherigen Stand zu überschreiben.
ZEITPUNKTPREISHISTORIEVerkauf
Verkaufspreis, Positionen, Versand, Storno und Retoure werden dem Teil eindeutig zugeordnet.
ERLÖSRETOUREABSATZ02
WAS WIR BRAUCHEN
Die Pflichtbasis für saubere Analysen.
MINIMUM + MEHRWERTJe vollständiger Status, Zeitpunkte und Verknüpfungen geliefert werden, desto genauer lassen sich Nachfrage, Standzeit und Erlös erklären.
| Bereich | Pflichtbasis | Zusätzlicher Analysewert |
|---|---|---|
| Export | Export-ID, Partner-ID, Modus, Exportzeit | Abdeckung, Standort- und Kanal-Scope |
| Fahrzeug | Fahrzeug-ID, VIN, Standort, Status | Zugang, Demontage, Laufleistung, Schaden und Kosten |
| Teil | Teile-ID, Fahrzeug-ID, primäre OE, Zustand | Kategorie, Einbauposition, Referenznummern und Prüfstatus |
| Listing | Listing-ID, Teil, Kanal, Erst- und letzter Preis | Statushistorie, Versand, Aufrufe und Beobachter |
| Verkauf | Verkaufs-ID, Teil, Verkaufszeit, Verkaufspreis | Rabatt, Gebühren, Versand, Storno und Retoure |
03
ANALYSEEBENEN
Drei Sichten, eine Datenkette.
OE × FAHRZEUG × MARKTOE LEVELOE-Markt
Angebot, Einstellpreis, Verkaufspreis, Verkaufsquote und Standzeit je exakter oder normalisierter OE-Nummer.
VEHICLE LEVELFahrzeugertrag
Teileausbeute, Erlös, Lagerdauer und Verwertungskosten je VIN und konkretem Spenderfahrzeug.
CHANNEL LEVELKanalwirkung
Preis- und Absatzunterschiede zwischen Marktplätzen, Shops, Standorten und Zeiträumen — ohne Doppelzählung des Bestands.
04
JSON-VERTRAG
Maschinenlesbar und prüfbar.
SCHEMA 1.0.0Das JSON Schema definiert Pflichtfelder, Datentypen, Wertebereiche und erlaubte Status. Der Leitfaden ergänzt fachliche Regeln und Beispiele.
{
"schema_version": "1.0.0",
"export": {
"export_id": "exp-20260908-0001",
"mode": "delta",
"exported_at": "2026-09-08T08:00:00Z",
"source": { "partner_id": "verwerter-001" }
},
"vehicles": [{ "source_vehicle_id": "veh-1042", "vin": "WVWZZZ1JZXW000001" }],
"parts": [{
"source_part_id": "part-9182",
"source_vehicle_id": "veh-1042",
"oe_numbers": [{ "raw": "5Q0 919 275 C", "relation": "primary" }]
}],
"listings": [],
"listing_events": [],
"listing_metrics": [],
"sales": [],
"tombstones": []
}Grundregeln
- ✓Stabile source_*_id für Upserts statt wechselnder Bezeichner
- ✓Geld als Ganzzahl in der kleinsten Währungseinheit, zum Beispiel 5990 = 59,90 EUR
- ✓Zeitpunkte nach RFC 3339; unbekannte optionale Werte werden weggelassen
- ✓Genau eine primäre OE-Nummer je physischem Teil
05
DOWNLOADS
Alles für die Implementierung.
ÜBERGABEFERTIGGib Leitfaden, Schema und Beispiel direkt an den Softwareanbieter oder Export-Verantwortlichen weiter.
MD · 40 KBDatenvertrag
Fachliche Regeln, Objektmodell, Statuswerte und Übergabe-Checkliste.
Leitfaden ladenJSON SCHEMA · 49 KBValidierungsschema
Verbindliche maschinenlesbare Struktur nach JSON Schema Draft 2020-12.
Schema ladenJSON · 15 KBVollständiges Beispiel
Beispieldatei mit Fahrzeug, Teilen, Listings, Ereignissen und Verkauf.
Beispiel ladenZIP · 23 KBKomplettpaket
Leitfaden, Schema und Beispiel gemeinsam als weitergabefertiges Paket.
Paket laden06
VOM EXPORT ZUR ANALYSE
Ein kontrollierter Datenfluss.
4 SCHRITTEZuordnen
Quellfelder den IDs, Zeitpunkten, Status- und Geldfeldern des Vertrags zuordnen.
→Validieren
Export lokal gegen das Schema und die fachlichen Referenzregeln prüfen.
→Übermitteln
JSON per E-Mail an [email protected] senden; tapinomahub bestätigt den Eingang.
→Intern verarbeiten
Wir prüfen, importieren und führen akzeptierte Daten auf OE-, Fahrzeug-, Standort- und Kanalebene zusammen.
BEREIT FÜR DEN ERSTEN EXPORT?
JSON prüfen.
Marktdaten verbinden.
Lade das Übergabepaket herunter, erstelle eine vertragskonforme JSON-Datei und sende sie an [email protected]. Wir prüfen und verarbeiten die Lieferung intern.