WooCommerce-ERP-Integration: Wo die häufigsten Probleme entstehen
Die Integration eines Shops mit einem ERP-System hat ein einfaches Ziel: Die Daten in beiden Systemen sollen übereinstimmen, ohne dass sie von Hand übertragen werden. In der Praxis liegen die Schwierigkeiten selten an der API selbst. Häufiger daran, dass zwei Systeme dieselben Daten unterschiedlich verstehen.
Welche Daten fließen und in welche Richtung
Die erste Frage bei jeder Integration lautet: Welches System ist für eine bestimmte Information die führende Quelle? Eine typische Aufteilung sieht so aus:
| Daten | Häufigste Quelle | Richtung |
|---|---|---|
| Produkte und Varianten | ERP | ERP → WooCommerce |
| Preise | ERP | ERP → WooCommerce |
| Lagerbestände | ERP | ERP → WooCommerce |
| Bestellungen | WooCommerce | WooCommerce → ERP |
| Bestellstatus | ERP | ERP → WooCommerce |
Jedes Unternehmen kann die Aufteilung anders wählen, aber sie muss feststehen, bevor Code geschrieben wird.
Wo Integrationen am häufigsten auseinanderlaufen
Produktkennungen. Das ERP arbeitet mit eigenen Artikelnummern, der Shop mit SKUs und Varianten-IDs. Ohne eindeutige Zuordnung erzeugt die Synchronisierung Duplikate oder aktualisiert die falschen Produkte.
Varianten. Im ERP ist eine Variante oft ein eigener Artikel, in WooCommerce ein Kind eines variablen Produkts. Es muss festgelegt werden, wie diese Struktur aufgebaut und aktualisiert wird.
Preise. Netto- und Bruttopreise, Preislisten für Kundengruppen, im Shop angelegte Aktionen. Wenn beide Systeme einen Preis ändern können, werden Daten leicht überschrieben.
Lagerbestände. Zwischen zwei Synchronisierungen kann der Bestand im Shop veraltet sein. Wie oft synchronisiert wird und was bei fehlender Ware passiert, sollte vorab geklärt werden.
Bestellungen. Eine an das ERP übergebene Bestellung muss alles enthalten, was das ERP verlangt: Kundendaten, Versandart, Zahlung, Rabatte. Ein einziges fehlendes Feld kann den gesamten Prozess anhalten.
Synchronisierung: nach Zeitplan oder nach Ereignissen
Es gibt zwei Grundmodelle:
- periodische Synchronisierung, z. B. alle paar Minuten oder einmal pro Nacht, gut für große Kataloge und Daten, die nicht sofort aktuell sein müssen;
- ereignisbasierte Synchronisierung, z. B. ein Webhook nach einer Bestellung, gut dort, wo die Reaktionszeit zählt.
In der Praxis werden beide Ansätze oft kombiniert. Lange Vorgänge laufen am besten im Hintergrund, z. B. über eine Warteschlange oder Action Scheduler, damit sie den Shop nicht verlangsamen.
Fehler gehören zur Integration
APIs sind manchmal nicht erreichbar, Daten manchmal unvollständig. Eine gute Integration geht von Anfang an davon aus: Sie schreibt Logs, wiederholt fehlgeschlagene Vorgänge und informiert das Team, wenn etwas eine manuelle Entscheidung erfordert. So hält ein Problem mit einer einzelnen Bestellung nicht den gesamten Verkauf auf.