Dein Shop läuft, dein Lager läuft, dein CRM läuft. Aber alle drei reden nicht miteinander. Das Ergebnis: manuelle Datenübertragung, Tippfehler und Bestellungen, die irgendwo zwischen den Systemen verschwinden. WooCommerce API Anbindungen lösen genau dieses Problem, aber nur wenn du sie von Anfang an sauber aufsetzt. Dieser Artikel zeigt dir, worauf es dabei wirklich ankommt.
Was ist die WooCommerce REST API und warum ist sie zentral?
WooCommerce bringt eine REST API mit. Laut der WooCommerce-Dokumentation zur REST API verbindet sie deinen Shop mit externen Systemen und Diensten, und WooCommerce ist dafür direkt an die REST API von WordPress angebunden. Andere Systeme greifen über standardisierte HTTP-Anfragen auf den Shop zu, lesen Daten und schreiben Daten. Die meisten Anbindungen brauchen dafür API-Schlüssel, die du in WooCommerce erzeugst und im externen Dienst einträgst.
Warum REST und nicht einfach Plugins?
Plugins sind praktisch für einfache Aufgaben. Sobald du aber zwei oder mehr externe Systeme verbindest, etwa ein ERP, ein Versanddienstleister-System und ein CRM gleichzeitig, wird die Plugin-Landschaft schnell unübersichtlich. Jedes Plugin bringt eigene Abhängigkeiten mit, und mit jedem weiteren steigt die Zahl möglicher Konflikte bei Updates.
Die REST API ist das sauberere Fundament, weil sie nicht an ein bestimmtes Plugin gebunden ist. Dein ERP spricht mit dem Shop über definierte Endpunkte. Ein Gegensatz zu Plugins ist das nicht: Viele Integrationen sind selbst Plugins oder externe Dienste, die genau über diese Schnittstelle arbeiten. Entscheidend ist, dass du weißt, welcher Weg welche Daten bewegt.
Welche Daten kannst du über die API steuern?
Die zentralen Shop-Daten sind über die API erreichbar:
- Produkte anlegen, aktualisieren und deaktivieren
- Bestellstatus lesen und schreiben
- Kundendaten abrufen und synchronisieren
- Lagerbestände aktualisieren
- Coupons verwalten
In der Praxis heißt das: Dein ERP meldet, dass eine Bestellung verschickt ist, und die Anbindung setzt über die API den passenden Bestellstatus im Shop, ohne dass jemand die Bestellung von Hand anfasst. Welchen Status die Anbindung dabei setzt, legst du beim Aufsetzen fest und hältst es in der Dokumentation fest.
Typische Fehler bei API Anbindungen und wie du sie vermeidest
Wer API-Anbindungen zum ersten Mal aufsetzt, hält oft die technische Verbindung für die eigentliche Arbeit. In Wirklichkeit fängt die Arbeit danach an.
Authentifizierung falsch konfiguriert
Die WooCommerce REST API arbeitet mit Schlüsseln aus Consumer Key und Consumer Secret. Laut der WooCommerce-Dokumentation zur REST API erzeugst du sie unter WooCommerce > Einstellungen > Erweitert > REST API, und jedes Schlüsselpaar gehört zu einem WordPress-Benutzer. Für jeden Schlüssel wählst du eine von drei Berechtigungen: Lesen, Schreiben oder Lesen/Schreiben. Vergib nur die Stufe, die das externe System wirklich braucht. Ein System, das nur Bestellungen abholt, braucht keinen Schreibzugriff. Das Prinzip der minimalen Rechtevergabe begrenzt den Schaden, wenn ein Schlüssel in falsche Hände gerät.
Drei Details aus derselben Dokumentation sparen Ärger: Vor dem Erzeugen der Schlüssel sollen die Permalinks in WordPress auf ein lesbares Format gestellt sein, also auf alles außer „Einfach“. Das Consumer Secret zeigt WooCommerce nur ein einziges Mal an, du kopierst es also sofort an einen sicheren Ort, bevor du die Seite verlässt. Und ein Schlüssel, den kein System mehr braucht, lässt sich über „Revoke Key“ widerrufen.
Alte Anbindungen über die Legacy REST API
Betreibst du eine ältere Anbindung, prüfe, welche Schnittstelle sie nutzt. Laut der WooCommerce-Dokumentation zur REST API ist die alte Legacy REST API aus dem Kern von WooCommerce entfernt. Eine Integration, die sie noch braucht, benötigt das Zusatz-Plugin „WooCommerce Legacy REST API“ von WordPress.org, das danach unter WooCommerce > Einstellungen > Erweitert > Legacy API eingeschaltet wird. Dasselbe gilt für Webhooks, die auf die Legacy REST API eingestellt sind: Ohne das Plugin hören sie auf zu arbeiten.
Das Plugin ist eine Brücke, keine Lösung. Laut der Plugin-Seite auf WordPress.org ist die Legacy REST API nicht mit High-Performance Order Storage (HPOS) kompatibel. HPOS speichert Bestellungen in eigenen Tabellen und ist laut der WooCommerce-Dokumentation zu HPOS bei Neuinstallationen ab WooCommerce 8.2 standardmäßig aktiviert. Die Plugin-Seite empfiehlt selbst dringend, Code, der auf der Legacy REST API aufbaut, auf die aktuelle WooCommerce REST API umzustellen.
Fehlende Fehlerbehandlung im Datenaustausch
API-Verbindungen brechen ab. Server sind kurz nicht erreichbar, Timeouts passieren, Datenformate ändern sich nach einem Update. Wenn dein angebundenes System keine saubere Fehlerbehandlung hat, passiert Folgendes: Eine Bestellung wird nicht übertragen, niemand merkt es, und der Kunde wartet auf eine Lieferung, die nie losgeht.
Saubere Integrationen loggen jeden API-Call, prüfen den Rückmeldestatus und lösen bei Fehler eine Benachrichtigung aus. Das klingt aufwendig, ist aber Pflicht.
Rate Limits unterschätzt
Auch eine sauber gebaute Anbindung wird ausgebremst, wenn sie zu viele Anfragen auf einmal schickt. Ob und ab welcher Menge gedrosselt wird, legt die jeweilige Gegenstelle fest, etwa dein Hosting. Erkennbar ist eine Drosselung am Statuscode 429. MDN beschreibt ihn als Antwort auf „too many requests in a given amount of time (rate limiting)“, also zu viele Anfragen in einem bestimmten Zeitraum. Schickt dein ERP die Lagerbestände des ganzen Sortiments in einem Rutsch, kann genau das passieren, oder der Server gerät unter Überlastung.
Die Lösung: Synchronisierungen in kleinere Pakete teilen, zeitlich entzerren und nach einer 429-Antwort mit Abstand erneut senden, statt sofort nachzulegen.
Welche externen Systeme werden am häufigsten angebunden?
Bei KMU geht es meist um drei Systemkategorien:
ERP-Systeme
ERP steht für Enterprise Resource Planning. Typische Vertreter sind SAGE, SAP Business One, Odoo oder die österreichische BMD. Diese Systeme verwalten Lagerbestände, Lieferanten, Buchhaltung und Produktion. Die Anbindung an WooCommerce bedeutet meistens: Lagerbestände fließen vom ERP in den Shop, Bestellungen fließen aus dem Shop ins ERP.
Das klingt einfach, ist aber oft der komplexeste Teil, weil ERP-Systeme eigene Datenstrukturen haben. Eine Produkt-ID im ERP ist selten dieselbe wie die WooCommerce-Produkt-ID. Du brauchst eine Mapping-Schicht, die beide Welten übersetzt.
CRM-Systeme
CRM-Anbindungen (z. B. HubSpot, Salesforce, Pipedrive oder ActiveCampaign) sorgen dafür, dass Kundendaten aus dem Shop im Vertriebssystem landen. Neue Kunden werden automatisch als Kontakt angelegt, Käufe werden als Aktivität erfasst, und Kundensegmente aus WooCommerce fließen in E-Mail-Kampagnen.
Gerade für KMU, die aktiv Bestandskundenpflege betreiben, ist das ein relevanter Hebel.
Versand- und Logistikdienste
Anbieter wie DHL, DPD, GLS oder die Österreichische Post haben eigene APIs. Die Anbindung ermöglicht automatische Labelgenerierung, Tracking-Nummer-Rückmeldung in den Shop und Statusupdates für den Kunden. Hier ist besonders auf die Datenqualität zu achten: Adressen müssen im richtigen Format ankommen, sonst schlägt die Labelgenerierung fehl.
Middleware oder Direktverbindung: Was passt zu deinem Shop?
Es gibt zwei grundsätzliche Ansätze, wie du externe Systeme mit WooCommerce verbindest:
Direktverbindung bedeutet: Das externe System spricht direkt mit der WooCommerce API. Kein Zwischensystem, keine zusätzliche Software. Das ist der einfachste Weg und funktioniert gut, wenn du genau ein System anbindest und die Anforderungen stabil sind.
Middleware ist eine Zwischenschicht, die mehrere Systeme koordiniert. Bekannte Middleware-Lösungen für KMU sind:
- Make: visueller Workflow-Baukasten, gut für einfache bis mittlere Szenarien
- Zapier: einsteigerfreundlicher Baukasten für Abläufe zwischen Diensten
- n8n: ein weiteres Werkzeug für Abläufe zwischen Diensten
Middleware ist kein Luxus, sondern eine Investition in Wartbarkeit. Wer drei Systeme direkt verkabelt, hat beim nächsten Update dreimal das Problem.
Die Wahl hängt von der Komplexität ab. Wenn du ein ERP, ein CRM und einen Versanddienstleister gleichzeitig anbindest, ist eine zentrale Middleware meist die bessere Entscheidung. Sie erlaubt es dir, Logik an einem Ort zu pflegen statt in drei getrennten Verbindungen.
Webhooks: die Auslöser aus WooCommerce
Webhooks sind keine Middleware, sondern eine Funktion von WooCommerce selbst. Laut der WooCommerce-Dokumentation zu Webhooks schickt dein Shop damit bei einem Ereignis automatisch eine Benachrichtigung an eine Adresse deiner Wahl, etwa wenn Bestellungen, Produkte, Coupons oder Kunden angelegt, geändert oder gelöscht werden. Eingerichtet werden sie unter WooCommerce > Einstellungen > Erweitert > Webhooks. Aus einem Secret erzeugt WooCommerce einen Hash der Zustellung und schickt ihn in den Request-Headern mit.
In der Praxis ist ein Webhook oft der Startpunkt: Er meldet die neue Bestellung, und eine Middleware oder das Zielsystem übernimmt die weitere Arbeit.
Warum Dokumentation und Monitoring keine Kür sind
Viele API-Anbindungen funktionieren monatelang tadellos. Und dann gibt es ein WooCommerce-Update, ein ERP-Update oder dein Hosting-Anbieter ändert eine Konfiguration. Plötzlich laufen keine Bestellungen mehr durch. Wenn keine Dokumentation und kein Monitoring existieren, beginnt die Fehlersuche bei null.
Was gutes API-Monitoring leistet
Monitoring bedeutet: Du erfährst zeitnah, wenn eine Verbindung nicht mehr funktioniert. Ein Uptime-Dienst prüft dabei nur, ob ein Endpunkt antwortet. Ob eine Bestellung vollständig und richtig im ERP angekommen ist, sieht er nicht. Das zeigen nur die Protokolle der Anbindung selbst.
Konkret solltest du überwachen:
- HTTP-Statuscodes jedes API-Calls: Laut MDN stehen 2xx für erfolgreiche Antworten, 4xx für Fehler auf Seiten des Clients, also der anfragenden Anbindung, und 5xx für Fehler des Servers
- Antwortzeiten der Endpunkte
- Anzahl der fehlgeschlagenen Synchronisierungen pro Zeitraum
- Datenmenge pro Übertragung (plötzliche Ausreißer sind oft ein Zeichen für Probleme)
Ein 4xx heißt dabei nicht automatisch Konfigurationsfehler. MDN führt in dieser Klasse unter anderem 401 für eine fehlende Authentifizierung, 403 für fehlende Zugriffsrechte, 404 für eine nicht gefundene Ressource und 429 für zu viele Anfragen. Ein 401 deutet also auf die Anmeldung, etwa einen falschen oder widerrufenen Schlüssel, ein 429 auf eine Drosselung, und beides braucht eine andere Reaktion.
Webhook-Zustellungen im Blick behalten
Bei Webhooks greift WooCommerce selbst ein. Laut der WooCommerce-Dokumentation zu Webhooks wird ein Webhook automatisch deaktiviert, wenn mehr als fünf Zustellungen hintereinander fehlschlagen. Als Fehler zählt jede Antwort, die kein 2xx, 301 oder 302 ist, also auch jede 4xx- und 5xx-Antwort. Fällt die Gegenstelle aus, steht der Webhook danach still, und Benachrichtigungen über neue Bestellungen kommen nicht mehr an, bis jemand ihn wieder aktiviert.
Die Protokolle findest du unter WooCommerce > Status > Logs, gefiltert auf die Quelle webhooks-delivery. Dort steht auch, was der empfangende Server geantwortet hat.
Warum Dokumentation beim nächsten Update Gold wert ist
Egal ob du oder ein Dienstleister die Anbindung gebaut hat, halte schriftlich fest: Welche Endpunkte werden genutzt? Welche Felder werden wohin gemappt? Welcher API-Schlüssel mit welcher Berechtigung gehört zu welchem Benutzer? Nutzt eine ältere Anbindung noch die Legacy REST API? Welche Abhängigkeiten bestehen? Klingt bürokratisch, aber nach einem Jahr ohne Dokumentation weiß niemand mehr, warum damals eine bestimmte Logik gebaut wurde.
Versionierung der API-Konfiguration (z. B. über Git) ist bei komplexeren Setups sinnvoll. So kannst du nach einem fehlerhaften Update auf eine funktionierende Version zurückwechseln.
Kurz zusammengefasst
WooCommerce API Anbindungen sind kein Hexenwerk, aber auch keine Einmal-Aufgabe. Wer externe Systeme sauber verbindet, spart langfristig Zeit, Fehler und Frustration. Die wichtigsten Punkte auf einen Blick:
- Die WooCommerce REST API ist bei mehreren Systemanbindungen das sauberere Fundament als ein Stapel einzelner Plugins
- API-Schlüssel nur mit der nötigen Berechtigung vergeben: Lesen, Schreiben oder Lesen/Schreiben
- Anbindungen über die Legacy REST API brauchen inzwischen ein Zusatz-Plugin, das nicht mit HPOS kompatibel ist, und gehören auf die aktuelle REST API umgestellt
- Fehlerbehandlung und Logging sind Pflicht, keine Option
- Anfragen in Pakete teilen und entzerren, ein Statuscode 429 zeigt eine Drosselung an
- Webhooks sind eine WooCommerce-Funktion und werden nach mehr als fünf Fehlzustellungen in Folge automatisch deaktiviert
- Bei mehr als zwei angebundenen Systemen lohnt sich meist eine Middleware wie Make oder n8n
- Monitoring und Dokumentation sorgen dafür, dass du Probleme früh siehst und nach dem nächsten Update schnell findest
Worauf sich das stützt
Was du noch wissen solltest
Laut WooCommerce verbindet die REST API deinen Shop mit externen Systemen und Diensten. Die meisten Anbindungen brauchen dafür API-Schlüssel, die du in WooCommerce erzeugst und im externen Dienst einträgst. So können ERP, CRM oder Versandsoftware Bestellungen, Lagerbestände und Kundendaten mit dem Shop abgleichen, ohne dass jemand sie von Hand überträgt.
Das ist kein Entweder-oder: Viele Integrationen sind selbst Plugins oder externe Dienste, die über die REST API mit dem Shop sprechen. Je mehr Systeme du anbindest, desto mehr lohnt sich ein klar dokumentierter Weg über die API statt vieler Einzel-Plugins mit eigenen Abhängigkeiten.
Die zentralen Shop-Daten: Produkte anlegen und aktualisieren, Bestellstatus lesen und schreiben, Kundendaten synchronisieren, Lagerbestände anpassen und Coupons verwalten. Ob ein externes System dabei nur lesen oder auch schreiben darf, legst du laut WooCommerce mit der Berechtigung seines API-Schlüssels fest: Lesen, Schreiben oder Lesen/Schreiben. Der Schlüssel gehört außerdem zu einem WordPress-Benutzer.
Laut WooCommerce erzeugst du Consumer Key und Consumer Secret unter WooCommerce > Einstellungen > Erweitert > REST API. Jedes Schlüsselpaar gehört zu einem WordPress-Benutzer und bekommt eine Berechtigung: Lesen, Schreiben oder Lesen/Schreiben. Vergib nur die Stufe, die das System braucht, und speichere das Consumer Secret sofort an einem sicheren Ort, denn WooCommerce zeigt es nur ein einziges Mal an.
Nicht unbedingt. Laut WooCommerce ist die Legacy REST API aus dem Kern entfernt. Anbindungen, die sie noch nutzen, und Webhooks, die auf sie eingestellt sind, brauchen das Plugin „WooCommerce Legacy REST API“ von WordPress.org. Langfristig ist die Umstellung auf die aktuelle REST API der saubere Weg.
Laut WooCommerce wird ein Webhook automatisch deaktiviert, wenn mehr als fünf Zustellungen hintereinander fehlschlagen. Als Fehler zählt jede Antwort außer 2xx, 301 und 302. Die Zustellprotokolle findest du unter WooCommerce > Status > Logs mit der Quelle webhooks-delivery.
MDN beschreibt 429 Too Many Requests als Antwort auf zu viele Anfragen in einem bestimmten Zeitraum, also eine Drosselung (rate limiting). Die Anbindung sollte dann Pausen einlegen und die Anfragen verteilt erneut senden, statt sofort nachzulegen.
Das passiert häufig, wenn die API-Anbindung keine saubere Fehlerbehandlung hat. Server-Timeouts, kurze Nichterreichbarkeit oder Datenformat-Änderungen nach Updates können den Datenaustausch unterbrechen, und ohne Protokoll und Benachrichtigung bemerkst du es nicht sofort.
Dein ERP-System kommuniziert über definierte API-Endpunkte mit deinem WooCommerce-Shop, direkt oder über eine Middleware. Ein typisches Beispiel: Das ERP meldet, dass eine Bestellung verschickt ist, und die Anbindung setzt über die API den Bestellstatus im Shop, ohne manuelle Eingriffe. Dazu brauchst du eine Zuordnung zwischen den Produktnummern im ERP und den Produkt-IDs in WooCommerce.
