Die meisten Anbindungen scheitern nicht an der Technik. Sie scheitern daran, dass niemand festgelegt hat, wohin ein Antwortfeld gehört, was ein leeres Feld bedeutet und wer entscheidet, wenn zwei Quellen sich widersprechen. Dieser Text beschreibt die Anbindung, die man einmal baut und danach nur noch erweitert — unabhängig davon, welches ERP im Haus steht.
Die vier Datenflüsse eines Verwerterbetriebs
- Fahrzeug herein. VIN erfassen, Fahrzeug abgleichen, Fahrzeugakte anlegen. Einmal je Fahrzeug, am Anfang der Kette.
- Teile heraus. Teileliste zum Fahrzeug, Auswahl der auszubauenden Positionen, Bestandsanlage je Stück.
- Artikel vermarkten. Teiledaten, Marktplatzdaten und Bilder je Artikel, Verteilung auf die Kanäle.
- Rückfluss. Verkauf, Retoure, Nachbewertung — die Daten, die aus dem Kanal zurückkommen und den Bestand korrigieren.
Feldzuordnung: die eigentliche Arbeit
| Antwortfeld | Typisches Zielfeld im ERP | Bei leerem Wert |
|---|---|---|
tapiId | Fahrzeugreferenz in der Fahrzeugakte | Kein Abgleich zustande gekommen — Akte anlegen, Aufgabe erzeugen |
mainType, subType | Baureihe und Ausführung | Freitext aus dem Fahrzeugschein belassen, nicht raten |
kba.hsn, kba.tsn | Schlüsselnummern | Feld leer lassen; viele Importfahrzeuge haben keine |
parts[].number | OE-Nummer der Bestandsposition | Position ohne Nummer anlegen und für die Nacherfassung markieren |
parts[].tapiGenArt | Teileart für Kategorie und Auswertung | Kategorie manuell setzen, nicht aus der Bezeichnung ableiten |
parts[].vdi | Bestätigte VDI-4081-Zuordnungen | Geliefertes [] übernehmen und nichts ableiten; fehlt das Pflichtfeld, Antwort quarantänisieren |
matchLevel | Qualitätskennzeichen an der Teileliste | Nie weglassen — es entscheidet, ob die Liste verkaufsfähig ist |
content.ebayTitle, itemSpecifics | Kanalfelder des Artikels | Artikel nicht veröffentlichen, sondern in den Prüfkorb |
Die vier technischen Punkte, an denen es klemmt
- Asynchrone Antworten.
GET /vin/{vin}/partsundGET /vin/{vin}/economic-evaluationantworten entweder mit200oder nehmen den Auftrag mit202an. Eine Anbindung, die nur200kennt, funktioniert im Test und fällt im Betrieb aus; Job-Kennung speichern und im genannten Abstand nachfragen. - Ein Aufruf je Client gleichzeitig. Weitere parallele Anfragen enden mit
429 client_request_in_progress. Eine Warteschlange im ERP ist Pflicht, kein Feinschliff. - Idempotenz. Schreibende Aufrufe nehmen einen
Idempotency-Key. Derselbe Schlüssel liefert dasselbe Ergebnis ohne erneute Ausführung — der einfachste Schutz gegen doppelte Belastung bei einem Wiederholungslauf. - Abrechnung sichtbar machen. Die Kopfzeilen
X-Tapinoma-Billing-SourceundX-Tapinoma-Billing-Bundlesagen, wie ein Aufruf verrechnet wurde. Wer sie protokolliert, kann später jede Rechnungsposition erklären.
Reihenfolge der Einführung
- Mit dem Fahrzeugeingang anfangen. Die VIN-Anbindung spart am meisten Zeit und ist am einfachsten zu messen.
- Feldzuordnung schriftlich festhalten, inklusive Bedeutung jedes Leerwerts. Dieses Dokument ist die Anbindung; der Code ist nur seine Umsetzung.
- Mit fünf Fahrzeugen testen, darunter ein Import ohne Schlüsselnummern und eines ohne Treffer.
- Fehlerfall festlegen: Vorgang anlegen, Feld leer lassen, Aufgabe erzeugen — nie einen geschätzten Wert.
- Ausrollen und zwei Wochen messen: Bearbeitungszeit je Fahrzeug, Anteil des Prüfkorbs, Nacherfassungen, Aufrufe je Vorgang.
Grenzen
- Die API ersetzt kein ERP. Sie liefert Daten an das führende System; Bestand, Beleg und Buchhaltung bleiben dort.
- Ergebnisse gehören in Ihre Datenbank. Kein Aufruf bei jedem Seitenaufruf; Teiledaten ändern sich selten, jede Wiederholung kostet.
- Rechte am Ergebnis richten sich nach dem Vertrag. Was gespeichert werden darf, steht dort und nicht im Datenmodell.
- Nicht jedes Feld ist überall belegt. Abdeckung unterscheidet sich nach Hersteller, Baujahr und Markt; das gehört in die Feldzuordnung, nicht in den Support.
Der vollständige Weg vom Fahrzeug zur Bewertung steht in Von der VIN zur Wirtschaftlichkeitsanalyse: der Fahrzeugweg, der vom Teil zum Kanal in Von der OE-Nummer zum marktplatzfertigen Artikel. Wer keine eigene Entwicklung hat, fragt zuerst den ERP-Anbieter — die meisten Systeme für Verwerter bringen eine Schnittstellenschicht bereits mit; siehe ERP und Warenwirtschaft: Artikel anlegen, Passung prüfen, je Endkunde abrechnen und Schnittstelle anbinden: Wann sich eine API für Verwerter lohnt.
Quellen und Rechtsgrundlagen
Häufige Fragen
Welcher Prozess sollte zuerst angebunden werden?
Der Fahrzeugeingang über die VIN. Er spart am meisten Handarbeit und lässt sich am klarsten messen.
Was passiert, wenn die API nicht antwortet?
Der Vorgang wird trotzdem angelegt, das Feld bleibt leer, und es entsteht eine Aufgabe zur Nacherfassung. Ein Vorgang darf nie an einer externen Abfrage hängen bleiben.
Wie verhindere ich doppelte Belastungen?
Mit einem Idempotency-Key je fachlichem Vorgang. Eine Wiederholung mit demselben Schlüssel liefert dasselbe Ergebnis ohne erneute Ausführung.
Brauche ich eigene Entwickler?
Nicht zwingend. Viele Warenwirtschaften lassen sich vom Hersteller anbinden; die Feldzuordnung müssen Sie trotzdem selbst festlegen.