WooCommerce mit ERP verbinden: Daten, Synchronisierung und Fehler

So konzipieren Sie die Anbindung von WooCommerce an ein ERP für Produkte, Preise, Lagerbestand, Bestellungen und Kunden ohne Duplikate und stille Fehler.

WooCommerce mit ERP verbinden: Daten, Synchronisierung und Fehler
Kurze Antwort

Legen Sie bei der Anbindung für jedes Feld ERP oder WooCommerce als Quelle fest, verwenden Sie stabile SKUs und externe IDs und gestalten Sie die Synchronisierung idempotent. Übermitteln Sie Bestellungen über eine Warteschlange, gleichen Sie den Lagerbestand regelmäßig ab und zeigen Sie Fehler dem Bedienpersonal an. Führen Sie vor dem Livegang einen Paralleltest mit realen Szenarien durch.

Die Anbindung von WooCommerce an ein ERP macht das manuelle Übertragen von Katalog und Bestellungen nur dann überflüssig, wenn es präzise Regeln gibt. Beide Systeme speichern oft ähnliche Felder, verwenden sie aber unterschiedlich. Das ERP kann Bestände je Lager und Preise ohne Steuer führen, während der Onlineshop Verkaufsverfügbarkeit, Aktionen und Varianten anzeigt. Ohne ein Mapping der Bedeutung entstehen Abweichungen, die sich bei größerem Volumen nur schwer nachverfolgen lassen.

Die Integration wird daher gemeinsam mit Mitarbeitenden aus E-Shop, Lager, Finanzen und IT konzipiert. Zuerst werden die maßgebliche Datenquelle und der Lebenszyklus der Bestellung festgelegt, danach die technische Art des Austauschs. Eine unklare Regel lässt sich nicht durch eine schnellere API beheben. Die folgenden Kapitel behandeln Produkte, Lagerbestand, Bestellungen, Ausfallsicherheit sowie die Einführung, ohne den laufenden Betrieb zu gefährden.

Legen Sie das führende System für den Katalog fest

Führen Sie in der Mapping-Tabelle Name, Beschreibung, SKU, EAN, Variante, Preis, Steuerkategorie, Lagerbestand, Gewicht, Bilder und Veröffentlichungsstatus auf. Kennzeichnen Sie bei jedem Feld die Richtung und den verantwortlichen Eigentümer. Die Marketingbeschreibung kann in WooCommerce entstehen, während der Preis aus dem ERP stammt. Die Synchronisierung darf dann nicht das gesamte Produkt mit einem einzigen Objekt überschreiben. Eine stabile SKU oder interne ID unterscheidet den Datensatz auch nach einer Namensänderung.

Das Variantenmodell muss eine eindeutige Zuordnung haben. Ein ERP-Artikel kann jede Variante einzeln abbilden, während WooCommerce sie unter einem übergeordneten Produkt bündelt. Definieren Sie das Anlegen, Deaktivieren und erneute Aktivieren. Ein fehlender Artikel bedeutet nicht zwingend eine Löschung; es kann sich um einen unvollständigen Batch handeln. Übertragen Sie Bilder inkrementell und prüfen Sie Größe, Format und Nutzungsrechte. Der Import muss nach einer Unterbrechung sicher fortgesetzt werden können.

Unterscheiden Sie zwischen physischem Bestand, Reservierung, Verkaufsverfügbarkeit und erwartetem Wareneingang. WooCommerce benötigt einen Wert, anhand dessen ein Kauf zugelassen wird, das ERP kann jedoch mehrere Lager und verzögerte Buchungen haben. Legen Sie fest, wann ein Artikel reserviert wird, wann er nach einer fehlgeschlagenen Zahlung wieder freigegeben wird und wie eine manuelle Bestellung außerhalb der Website verarbeitet wird. Ohne dieses Modell kann die Synchronisation einen falschen Geschäftswert technisch korrekt übertragen.

Bei höherer Parallelität kann man sich nicht vollständig auf einen gelegentlichen Export verlassen. Nutzen Sie ereignisbasierte oder häufigere inkrementelle Abläufe sowie einen periodischen vollständigen Abgleich. Änderungen dürfen nicht zwischen den Systemen hin- und herpendeln. Überwachen Sie das Alter der Bestandsinformation und legen Sie für den Fall, dass das ERP nicht verfügbar ist, ein bewusstes Verhalten fest: letzter bekannter Wert, Sicherheitsreserve oder vorübergehende Einschränkung des Verkaufs je nach Risiko des Sortiments.

  • Physischer, reservierter und verkaufbarer Bestand
  • Regeln für die Freigabe nach Stornierung einer Zahlung
  • Inkrementelle Änderungen und Kontrollabgleich
  • Definiertes Verhalten bei nicht verfügbarem ERP

Übertragen Sie die Bestellung nur einmal und vollständig

Legen Sie den auslösenden Status fest: Erstellung, bestätigte Zahlung oder manuelle Freigabe. Eine Bestellung enthält Positionen, Mengen, Einzelpreise, Rabatte, Versand, Steuern, Währungen, Adressen und Zahlungskennungen; die Summe muss auf beiden Seiten übereinstimmen. Das ERP sollte den Preis nicht nach der aktuellen Preisliste neu berechnen, wenn es eine historische Transaktion erfassen soll. Jede Übertragung erhält einen stabilen Schlüssel, der Duplikate verhindert.

Speichern Sie bei Erfolg die ERP-Nummer und den Zeitpunkt, bei einem Fehler den Status und eine verständliche Ursache. Vorübergehende Fehler löst die Warteschlange, dauerhaft fehlerhafte Daten ein Mensch. Die Korrektur einer Adresse oder Position nach dem Export erfordert einen eigenen Prozess, kein stilles Überschreiben. Bilden Sie Status aus dem ERP nur dann ab, wenn sie für den Kunden oder den Betrieb von Bedeutung sind. Übertragen Sie Rechnung, Tracking und Stornierung als separate Ereignisse mit eigener Idempotenz.

Sorgen Sie für Observability und Sicherheit

Das Dashboard sollte die letzte erfolgreiche Synchronisierung, die Anzahl wartender und fehlerhafter Datensätze, das Alter der ältesten Nachricht und Abweichungen beim Abgleich anzeigen. Eine Korrelations-ID verknüpft die Bestellung mit dem Log auf beiden Seiten. Eine Benachrichtigung braucht einen konkreten Verantwortlichen und eine Anweisung, was zu prüfen ist. „HTTP 500“ allein hilft einem Lagermitarbeiter nicht weiter; die Administration sollte den Fehler sicher in eine fehlende SKU, eine unbekannte Versandart oder ein nicht erreichbares System übersetzen.

API-Konten haben minimale Berechtigungen und getrennte Schlüssel für Staging und Produktion. Secrets gehören weder ins Repository noch in E-Mails oder Screenshots. Übertragen Sie nur die notwendigen Kundendaten und schwärzen Sie Logs. Prüfen Sie bei einem öffentlichen Webhook die Signatur, den Zeitstempel und den Schutz vor Wiederholungsangriffen. Vereinbaren Sie zwischen den Dienstleistern beider Systeme die Verantwortung für Verfügbarkeit, Schemaänderungen, Aufbewahrung und Sicherheitsvorfälle.

  • Korrelations-ID über Systeme hinweg
  • Sichtbare Warteschlange und verständliche Fehler
  • Minimale Rechte und sichere Secrets
  • Verantwortliche für Incidents und Contract-Änderungen

Rollen Sie über Stichproben und parallele Prüfung aus

Testen Sie zunächst repräsentative Produkte: einfach, mit Varianten, reduziert, ausverkauft, ungewöhnlich schwer und mit fehlenden Angaben. Gehen Sie anschließend Bestellungen mit verschiedenen Zahlungsarten, Versandarten, Gutschein, Rückerstattung und Stornierung durch. Prüfen Sie doppelte Ereignisse, Ausfälle und Wiederherstellung. Ein Test-ERP darf ohne klare Trennung keine echten Belege oder Lagerbewegungen senden. Vergleichen Sie die Ergebnisse Feld für Feld, nicht nur anhand der Anzahl der Datensätze.

Starten Sie bei einer Migration zunächst mit einer begrenzten Gruppe oder einer parallelen Kontrolle gegen den bestehenden Prozess. Legen Sie eine Grenze für akzeptable Abweichungen sowie Bedingungen für ein Zurücksetzen fest. Prüfen Sie nach dem Produktivstart vorübergehend jeden Fehler und gleichen Sie die Summen regelmäßig ab. Schalten Sie den alten manuellen Ablauf erst nach der Stabilisierung ab. Die Dokumentation sollte Mapping, Auslöser, Warteschlangen, Kontakte und das Vorgehen für eine sichere Wiederholung umfassen.

Häufige Fragen

Wie oft sollte der Lagerbestand mit dem ERP synchronisiert werden?

Das hängt vom Verkaufstempo, dem Risiko eines Ausverkaufs und den Möglichkeiten der API ab. Ein ereignisbasierter Datenfluss kann eine Änderung schnell übertragen, ein regelmäßiger Abgleich fängt Ausfälle ab. Legen Sie die Frequenz danach fest, wie alt eine Lagerbestandsinformation höchstens sein darf, nicht nach einem universellen Intervall.

Was, wenn ein Produkt nicht in beiden Systemen dieselbe ID hat?

Erstellen Sie ein Mapping und speichern Sie die externe stabile ID beim Produkt oder bei der Variante. Der Name ist kein zuverlässiger Schlüssel. Stoppen Sie bei fehlender oder doppelter Kennung den Import für den betreffenden Datensatz und fordern Sie eine Korrektur an.

Kann eine ERP-Integration ohne Monitoring funktionieren?

Technisch kann sie eine Weile laufen, doch ein stiller Fehler wird erst spät entdeckt. Das Monitoring der Warteschlange, des letzten erfolgreichen Laufs und von Datenabweichungen ist Teil eines zuverlässigen Betriebs, insbesondere wenn die Integration Bestellungen, Lagerbestand oder Belege beeinflusst.

Quellen und weiterführende Lektüre

Adam Antoni, Entwickler digitaler Lösungen
Adam Antoni · Webiant

Adam Antoni vyvíja weby, aplikácie a softvér na mieru. Prepája firemné systémy, automatizuje procesy a vytvára AI agentov. Pôsobí v Spišskej Novej Vsi a spolupracuje s firmami na celom Slovensku.

Möchten Sie dieses Thema in Ihrem Projekt umsetzen?

Schreiben Sie, was Sie verbessern möchten, womit Sie derzeit kämpfen und welches Ergebnis Sie erwarten. In der Erstberatung besprechen wir den passenden Umfang und das weitere Vorgehen.

Wählen Sie aus, welche Cookies Sie zulassen. Ihre Auswahl können Sie jederzeit über den Link in der Fußzeile oder die Cookie-Schaltfläche ändern.

Datenschutz und Details zu Cookies