Skizzieren Sie alle Systeme und legen Sie für jedes Datenobjekt eine einzige Quelle der Wahrheit fest. Nutzen Sie Events für schnelle Änderungen, regelmäßige Batches für den Abgleich und schützen Sie jeden Schreibvorgang mit einem Idempotenzschlüssel. Eine Integration braucht einen Status, eine Fehlerwarteschlange, ein Monitoring der geschäftlichen Vollständigkeit und einen Verantwortlichen, der über Ausnahmen entscheiden kann. Ein kritischer Online-Aufruf sollte ein kurzes Timeout, einen sicheren Fallback und eine dokumentierte Auswirkung auf Checkout oder Administration haben. Ein verspätetes Event darf keine neuere bestätigte Version des Objekts überschreiben. Gleichen Sie jede Synchronisationsrichtung regelmäßig ab.
WooCommerce-Integrationen verbinden den Onlineshop mit Zahlungs-, Versand-, Lager-, Buchhaltungs- und Marketingdiensten. Jede Verbindung kann für sich funktionieren, doch ihre Nebeneffekte treffen in einer einzigen Bestellung aufeinander. Wenn zwei Systeme denselben Preis verwalten oder jedes einen Status anders interpretiert, entstehen zyklische Überschreibungen, Duplikate und Fehler, die der Nutzer erst nach dem Versand bemerkt.
Dieser Artikel ist keine Anleitung für einen bestimmten ERP-Connector. Er hilft, eine Integrationslandkarte für WooCommerce als Ganzes zu entwerfen: Verantwortungsgrenzen, Synchronisationsrichtungen, Ereignisse, Batches, Ausfallsicherheit und operative Zuständigkeit. Die konkrete API setzt dann die allgemeinen Sicherheits- und Vertragsregeln gemäß der Dokumentation des jeweiligen Anbieters um.
Erstellen Sie eine Übersicht der Systeme und der Dateneigentümerschaft
Listen Sie Produkte, Preise, Lagerbestand, Kunden, Bestellungen, Zahlungen, Sendungen und Rückerstattungen auf. Legen Sie für jeden Punkt fest, in welchem System die Daten entstehen, wo sie korrigiert werden dürfen und wohin sie lediglich kopiert werden. Die Quelle der Wahrheit kann für jedes Objekt eine andere sein, darf sich aber nicht danach ändern, welcher Prozess gerade läuft.
Ergänzen Sie das Mapping um Identifikatoren und die Zuordnung von Status. Die öffentliche Bestellnummer ist nicht unbedingt ein sicherer Integrationsschlüssel, und ein Produktname kann sich ändern. Verwenden Sie stabile interne und externe IDs. Dokumentieren Sie die Statuszuordnung als Tabelle mit zulässigen Übergängen und dem Verhalten bei unbekannten Werten.
- Single Source of Truth für jedes Objekt
- Richtung und Häufigkeit der Synchronisierung
- Stabile ID auf beiden Seiten
- Verantwortlicher für die Geschäftsausnahme
Wählen Sie je nach Bedarf Ereignis, Batch oder Abfrage
Ein Webhook eignet sich für eine schnelle Benachrichtigung über eine Änderung, kann aber mehrfach, verspätet oder in anderer Reihenfolge eintreffen. Ein periodischer Batch ist langsamer, kann aber verpasste Ereignisse korrigieren. Kombinieren Sie bei kritischen Daten die sofortige Verarbeitung mit einem regelmäßigen Abgleich, der Quelle und Ziel vergleicht.
Verwenden Sie eine Online-Abfrage während des Checkouts nur für Angaben, ohne die ein sicheres Fortfahren nicht möglich ist. Sie braucht einen kurzen Timeout, ein risikogerechtes Caching und ein klar definiertes Verhalten bei einem Ausfall. Der Aufruf eines langsamen ERP-Systems bei jedem Seitenaufruf kann den Verkauf zum Erliegen bringen. Vorberechnete Daten müssen ihre Aktualität und die Ablaufregel ausweisen.
Gestalten Sie die Verarbeitung für Wiederholungen und Reihenfolge
Jede Änderung erhält eine Ereignis-ID oder einen idempotenten Schlüssel, der aus der Geschäftsoperation abgeleitet ist. Der Empfänger speichert den verarbeiteten Schlüssel und bestätigt dieselbe Nachricht beim zweiten Mal sicher. Verwenden Sie bei Aktualisierungen die Version oder den Zeitstempel der Quelle, damit ein verspätetes älteres Ereignis keinen neueren Zustand überschreibt.
Speichern Sie einen mehrstufigen Prozess als Zustandsautomat. Wird eine Sendung erstellt, schlägt aber das Speichern der Nummer in WooCommerce fehl, sucht die Wiederholung zunächst nach dem bereits vorhandenen Ergebnis und erstellt keine zweite Sendung. Definieren Sie Kompensationsaktionen separat; das technische Zurücksetzen des lokalen Zustands storniert nicht unbedingt die Zahlung beim Anbieter.
Isolieren Sie Secrets und beschränken Sie Berechtigungen
Jede Integration erhält eigene Zugangsdaten mit dem geringstmöglichen Berechtigungsumfang. Speichern Sie Schlüssel weder im Theme noch im Log noch in einem Administrationsfeld, auf das eine weit gefasste Rolle Zugriff hat. Verwenden Sie eine sichere Umgebungskonfiguration oder einen unterstützten Speicher, einen Rotationsplan und getrennte Zugangsdaten für Staging und Produktion.
Prüfen Sie eingehende Webhooks je nach Möglichkeiten des Anbieters per Signatur, Zeitstempel und Schutz vor Wiederholungsangriffen. Die Antwort gibt keine internen Details preis. Senden Sie ausgehende Anfragen nur an freigegebene HTTPS-Ziele und schützen Sie bei dynamischen URLs das Netzwerk vor Aufrufen interner Adressen. Maskieren Sie sensible Inhalte im Log.
Überwachen Sie das Geschäftsergebnis und bereiten Sie ein Runbook vor
Technischer HTTP-Erfolg reicht nicht aus. Überwachen Sie die Anzahl bezahlter Bestellungen im Vergleich zu exportierten, Sendungen ohne Nummer, Produkte ohne aktuellen Lagerbestand und nicht abgeschlossene Rückerstattungen. Gliedern Sie die Metriken nach Integration und Alter. Eine Warnung sollte die Auswirkung, den letzten Erfolg und einen sicheren ersten Schritt nennen, ohne Secrets anzuzeigen.
Die Fehlerwarteschlange benötigt eine Klassifizierung in vorübergehende, dauerhafte und unbekannte Fehler. Das Runbook erklärt Wiederholung, Überspringen, manuellen Abschluss und anschließenden Abgleich. Führen Sie nach einer Vertragsänderung Integrationstests sowohl in der Sandbox als auch im Staging aus. Die Verantwortung endet nicht mit dem Deployment; jede Verbindung braucht eine verantwortliche Person für technische wie geschäftliche Entscheidungen.
Häufige Fragen
Ist ein fertiger WooCommerce-Connector oder eine Individualentwicklung besser?
Ein fertiger Connector eignet sich, wenn er Datenmodell, Fehlerbehandlung und betriebliche Anforderungen genau unterstützt. Eine Individualentwicklung ist bei einem abweichenden Vertrag sinnvoll. Beide Varianten müssen auditiert, getestet und überwacht werden.
Warum reichen Webhooks allein nicht aus?
Ein Webhook kann verspätet, doppelt oder gar nicht zugestellt werden. Ergänzen Sie für kritische Daten daher einen periodischen Abgleich, der die Source of Truth mit dem Ziel vergleicht und Differenzen sicher nachträgt.
Wo sollte eine Integration API-Schlüssel speichern?
In eine sichere Konfiguration oder einen unterstützten Speicher außerhalb von öffentlichem Code und Logs. Trennen Sie Zugangsdaten nach Umgebung, beschränken Sie ihren Umfang und bereiten Sie eine Rotation ohne lange Ausfallzeit vor.
Quellen und weiterführende Lektüre
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.
