Eine Endpunktliste beantwortet die Frage „was kann dieser Aufruf". Sie beantwortet nicht die Frage, die ein Betrieb tatsächlich hat: „wie erledige ich diese Aufgabe". Die Anwendungsfälle auf dieser Seite gehen deshalb von der Aufgabe aus und nennen die Aufrufe, die sie zusammen erledigen — jeweils mit den Voraussetzungen, einem Hinweis zur Abrechnung und den Grenzen.
Die vier Flächen schliessen sich nicht aus. Für einen Verwerter kommen der Hub und Compliance in Betracht, für einen Teilehändler der Hub und Commerce, für ein Softwarehaus, das für mehrere Betriebe baut, alle vier — jeweils mit dem eigenen Reifegrad der Fläche. Maßgeblich für jeden genannten Pfad ist der OpenAPI-Vertrag der jeweiligen Fläche.
Die vier Flächen und ihr Reifegrad
| Fläche | Reifegrad | Anwendungsfälle |
|---|---|---|
| Hub | produktiv | 12 |
| Verkaufsagent | Pilot — Freischaltung nötig | 8 |
| Commerce | Vorschau — keine produktiven Kanaländerungen | 11 |
| Compliance | Dokumentationsvorschau — noch nicht aktiviert | 9 |
Alle Anwendungsfälle
Wenn Sie noch nicht wissen, wo Sie anfangen
- Sie haben ein Foto. Der Bildweg führt vom Teilefoto zum Inserat: vom Teilefoto zum Inserat.
- Sie haben eine OE-Nummer. Der OE-Weg führt zum marktplatzfertigen Artikel: von der OE-Nummer zum Artikel.
- Sie haben eine Fahrgestellnummer. Der VIN-Weg führt zur Wirtschaftlichkeitsbetrachtung: von der VIN zur Bewertung.
- Sie integrieren für viele Betriebe. Dann beginnt es bei der Mandantenverwaltung: viele Betriebe auf einem Zugang.
Wo die verbindlichen Angaben stehen
Feldlisten, Fehlercodes und Beispielantworten stehen in den OpenAPI-Verträgen unter docs.tapinomahub.com. Die Texte hier erklären den Zusammenhang; im Streitfall gilt der Vertrag.
Quellen und Rechtsgrundlagen
Häufige Fragen
Wie unterscheidet sich ein Anwendungsfall von einem Endpunktartikel?
Der Endpunktartikel beschreibt einen Aufruf. Ein Anwendungsfall beschreibt eine Aufgabe, die mehrere Aufrufe braucht, und begründet die Reihenfolge — einschliesslich der Stufen, die man gern überspringt.
Kann ich mehrere Flächen gleichzeitig nutzen?
Die Flächen schliessen sich nicht aus, haben aber getrennte Verträge und jeweils einen eigenen Reifegrad; für einen Verwerter kommen Hub und Compliance in Betracht.
Sind alle Flächen produktiv verfügbar?
Der Hub läuft produktiv; Compliance ist eine Dokumentationsvorschau, deren Endpunkte auf dem Zielserver noch nicht aktiviert sind. Der Verkaufsagent wird als Pilot geführt und braucht eine Freischaltung. Commerce ist eine Vorschau und führt keine produktiven Kanaländerungen und keinen Gebühreneinzug aus.