Wer bei eBay verkauft, kennt die täglichen Routinen: Bestellungen prüfen, Bestände nachziehen, Trackingnummern eintragen, Angebote anpassen. Vieles davon lässt sich über die offiziellen eBay-Schnittstellen automatisieren. Dieser Artikel zeigt, welche APIs es gibt, was sie konkret können und welche Punkte du vorab klären solltest.
Welche eBay APIs gibt es?
eBay stellt für Verkäufer mehrere Schnittstellen bereit. Die wichtigsten für Automatisierung sind die sogenannten Sell APIs (RESTful, JSON) und die ältere Trading API (XML).
| API | Zweck | Typische Anwendung |
|---|---|---|
| Fulfillment API | Bestellungen und Versandabschluss | Orders abrufen, Tracking übermitteln |
| Inventory API | Artikel, Bestände, Angebote | Bestand setzen, Offers anlegen und aktualisieren |
| Trading API (Legacy) | XML-Schnittstelle für Listings und Orders | Ältere Listings, Funktionen ohne REST-Pendant |
| Notification API | Benachrichtigungen bei Ereignissen | Push statt Polling |
Die Sell APIs sind der aktuelle Standard. Die Trading API bleibt relevant, weil viele bestehende Angebote noch im „alten“ Modell angelegt wurden und einige Funktionen dort nach wie vor vollständiger sind.
Bestellungen: Fulfillment API
Die Fulfillment API ist der Einstieg für fast jede Automatisierung. Sie liefert Bestellungen mit allen Positionen, Käuferdaten, Zahlungsstatus und Versandadresse. Damit lassen sich folgende Schritte automatisieren:
- Bestellabruf: Neue oder geänderte Orders regelmäßig abrufen und in deine Systeme übernehmen (Google Sheet, Datenbank, Versandsoftware).
- Statusfilter: Nur bezahlte Bestellungen weiterverarbeiten, unbezahlte zurückhalten.
- Versandabschluss: Über einen sogenannten Shipping Fulfillment wird die Trackingnummer inklusive Carrier an eBay gemeldet. eBay setzt die Bestellung damit auf „versendet“ und informiert den Käufer.
- Rückerstattungen: Teil- oder Vollerstattungen können ebenfalls über die API ausgelöst werden.
Wichtig ist die Duplicate Protection: Jede Bestellung hat eine eindeutige Order ID. Eine saubere Automatisierung merkt sich, welche IDs bereits verarbeitet wurden, damit keine Bestellung doppelt in der Versandsoftware landet.
Bestand und Angebote: Inventory API
Die Inventory API trennt zwischen Inventory Items (der Artikel mit SKU, Beschreibung, Bestandsmenge) und Offers (das konkrete Angebot auf einem Marktplatz mit Preis, Kategorie und Versandprofil). Diese Trennung ist für Automatisierung praktisch:
- Bestandsmengen pro SKU aktualisieren, ohne das Angebot neu anzulegen
- Preise über Offers anpassen
- Angebote pausieren oder wieder aktivieren, wenn der Bestand null erreicht
- Mehrere Lagerorte über Inventory Locations abbilden
Ein typischer Workflow: Ein zentrales Bestandssystem (auch ein Google Sheet) ist die führende Quelle, die Automatisierung schreibt Änderungen per Inventory API nach eBay. Ein Bestandspuffer (z. B. bei eBay immer zwei Stück weniger anzeigen als physisch vorhanden) reduziert das Risiko von Überverkäufen.
Benachrichtigungen oder Polling?
Damit eine Automatisierung auf Ereignisse reagiert, gibt es zwei Wege:
- Polling: Der Workflow fragt in festen Intervallen (z. B. alle fünf Minuten) neue Bestellungen ab. Einfach umzusetzen, aber mit Verzögerung und dauerhaftem API-Verbrauch.
- Notifications: eBay sendet bei bestimmten Ereignissen eine Nachricht an einen Endpunkt (Webhook). Die Verarbeitung erfolgt in der Regel innerhalb weniger Minuten, abhängig von eBay-Benachrichtigungen und Systemlast.
In der Praxis kombinieren robuste Setups beides: Notifications als Hauptkanal, Polling als Sicherheitsnetz für verpasste Ereignisse.
Zugang, Tokens und Rate Limits
Für den Zugriff auf Verkäuferdaten ist ein OAuth User Token nötig. Du als Händler autorisierst die Anwendung einmal, danach arbeitet sie mit einem Access Token, der automatisch über einen Refresh Token erneuert wird. Der Zugriff lässt sich jederzeit in deinem eBay-Konto widerrufen.
Außerdem gelten Rate Limits: Jede API hat ein tägliches Kontingent an Aufrufen. Für die meisten Händler ist das kein Problem, bei aggressivem Polling oder sehr großen Katalogen muss die Abruflogik aber darauf ausgelegt sein (Batch-Abfragen, sinnvolle Intervalle, Caching).
Was die API nicht löst
Eine Schnittstelle ist kein Prozess. Die API liefert Daten und nimmt Befehle entgegen, die Geschäftslogik musst du selbst definieren:
- Welche SKU gehört zu welchem physischen Artikel?
- Wann gilt eine Bestellung als versandbereit?
- Was passiert, wenn eBay eine Anfrage ablehnt oder ein Token abläuft?
- Wer wird informiert, wenn eine Bestellung in der Manual-Review-Queue landet?
Dazu kommt Betrieb: Hosting, Monitoring, Logging und die Anpassung, wenn eBay API-Versionen ändert. Genau das ist der Unterschied zwischen „einmal etwas gebaut“ und einem zuverlässig laufenden System. Wer das nicht selbst betreiben will, kann einen Managed Service wie HandelPilot nutzen, der Integration, Hosting und Überwachung übernimmt.
Fazit
Die eBay Sell APIs decken die Kernprozesse eines Händlers ab: Bestellungen abrufen, Bestände pflegen, Tracking melden, Angebote steuern. Die Technik ist ausgereift, der Aufwand steckt in Geschäftslogik, Fehlerbehandlung und Betrieb. Wenn du wissen willst, welche deiner Prozesse sich zuerst lohnen, starte mit einer Kostenlosen Prozessanalyse.