WooCommerce anbinden
WooCommerce-Shop per REST-API mit SimpliServ verbinden: API-Schlüssel anlegen, Sync-Einstellungen wählen, Produkte importieren und Webhooks einrichten.
→ WooCommerce-Connector in SimpliServ öffnen · Connectoren-Übersicht öffnen
Mit der WooCommerce-Anbindung verbindest du deinen WordPress-Shop über die WooCommerce REST-API (wc/v3) mit SimpliServ. Produkte, Bestände und Bestellungen werden – je nach Einstellung – in eine oder beide Richtungen abgeglichen: Bestellungen aus dem Shop landen als Shop-Bestellungen, Produkt- und Bestandsänderungen fließen zurück in den Shop.
Anders als bei Shopify oder Wix gibt es keine OAuth-App: Du erzeugst den API-Schlüssel selbst in WordPress und hinterlegst ihn in SimpliServ.
Voraussetzungen
- WordPress 6.0 oder neuer und WooCommerce 5.3 oder neuer (REST-API v3). Getestet bis WooCommerce 10.x.
- Der Shop ist über HTTPS öffentlich erreichbar – SimpliServ ruft die REST-API aus der Cloud auf. Reine
http://-Adressen werden aufhttps://normalisiert. - Ein WordPress-Benutzer mit Adminrechten, der unter WooCommerce → Einstellungen → Erweitert → REST-API Schlüssel anlegen darf.
- In SimpliServ die Berechtigung Einstellungen anzeigen (Administration → Einstellungen → Ansehen) für die Connectoren-Seite, zum Speichern zusätzlich Administration → Einstellungen → Bearbeiten.
- Mindestens ein Lager, dessen Bestand den Shop speist.
Nur ein Verkaufskanal gleichzeitig. WooCommerce, Shopify und JTL-Wawi schließen sich gegenseitig aus. Ist bereits einer davon verbunden, lehnt SimpliServ das Speichern mit dem Hinweis ab, dass der andere Kanal zuerst getrennt werden muss.
API-Schlüssel in WooCommerce anlegen
REST-API öffnen
Gehe in WordPress zu WooCommerce → Einstellungen → Erweitert → REST-API und klicke auf Schlüssel hinzufügen.
Schlüssel mit Lese-/Schreibrechten erstellen
Vergib eine Beschreibung (z. B. „SimpliServ"), wähle einen Benutzer mit Adminrechten und setze die Berechtigung auf Lesen/Schreiben. Lesen allein genügt nicht — SimpliServ schreibt Produkte und Bestände zurück.
Consumer Key und Secret kopieren
WooCommerce zeigt Consumer Key (ck_…) und Consumer Secret (cs_…) genau einmal an. Kopiere beide, bevor du die Seite verlässt.
Verbindung in SimpliServ herstellen
Connector öffnen
Gehe zu Administration → Daten & Geräte → Integrationen und öffne die Kachel WooCommerce. Im Tab Installation stehen die Schritte kurz zusammengefasst, die Eingabefelder liegen im Tab Konfiguration.
Shop-URL und Zugangsdaten eintragen
Trage unter Shop-URL die vollständige Adresse deines Shops ein (z. B. https://shop.example.com) und darunter Consumer Key und Consumer Secret. Das Secret wird verschlüsselt gespeichert und nie wieder angezeigt — in der Übersicht steht danach nur noch Hinterlegt.
Lager wählen
Wähle das Lager, dessen Bestand mit WooCommerce abgeglichen wird. Eingehende Bestellungen reservieren ihren Bestand ebenfalls hier. Vorbelegt ist das Standardlager deines Arbeitsbereichs.
Verbindung speichern
Klicke auf Verbindung speichern. SimpliServ prüft die Zugangsdaten sofort gegen den Shop. Bei Erfolg steht der Status auf Verbunden.
Schlägt die Prüfung fehl, bleibt die Verbindung bestehen, wechselt aber auf Getrennt, und du siehst die Fehlermeldung des Shops. Deine Sync-Einstellungen gehen dabei nicht verloren — korrigiere die Schlüssel einfach über Zugangsdaten bearbeiten.
Über Verbindung testen prüfst du jederzeit erneut, ob der Shop antwortet; das Ergebnis landet im Feld Zuletzt geprüft.
Sync-Einstellungen
Im Block Sync-Einstellungen legst du je Bereich fest, ob und in welche Richtung synchronisiert wird. Eingehend zieht nur aus WooCommerce, Ausgehend schiebt nur dorthin, Beide gleicht in beide Richtungen ab.
| Bereich | Standard | Richtungen | Zusatzoptionen |
|---|---|---|---|
| Produkte | aktiv, Beide | Eingehend · Ausgehend · Beide | Neue Einträge automatisch synchronisieren |
| Bestände | aktiv, Beide | Eingehend · Ausgehend · Beide | – |
| Bestellungen | aktiv, Eingehend | nur Eingehend (fest) | Rechnung automatisch erstellen, Rechnung per E-Mail an Kunden senden |
- Neue Einträge automatisch synchronisieren (Produkte): Jedes neu angelegte Produkt wird automatisch sync-aktiviert und an WooCommerce übertragen. Bestehende Produkte behalten ihre Einstellung pro Datensatz.
- Rechnung automatisch erstellen (Bestellungen): Für jede bezahlte WooCommerce-Bestellung entsteht in SimpliServ automatisch eine Rechnung im Status Bezahlt.
- Rechnung per E-Mail an Kunden senden: nur wählbar, wenn die automatische Rechnung aktiv ist. Beachte, dass WooCommerce meist bereits eigene Bestell-E-Mails verschickt.
Das gewählte Lager änderst du hier ebenfalls. Vergiss am Ende Einstellungen speichern nicht.
Bestellungen laufen ausschließlich eingehend — SimpliServ legt keine Bestellungen in WooCommerce an.
Erstbefüllung: vollständiger Import
Im Block Synchronisation gibt es zwei Aktionen:
- Vollständiger Import — liest den kompletten WooCommerce-Katalog ein: einfache Produkte werden zu einem Produkt, variable Produkte zu einer Produktfamilie, in der jede Variation ein eigener Artikel wird. Die Zuordnung läuft über die Artikelnummer (SKU); existiert lokal bereits ein Artikel mit derselben SKU, wird er verknüpft statt doppelt angelegt. Bei aktiver Bestandsführung wird der Bestand ins zugeordnete Lager geschrieben, Produktbilder kommen mit.
- Bestellungen abgleichen — holt kürzlich geänderte Bestellungen nach. Webhook-Zustellung ist „best effort"; dieser Abgleich fängt verlorene Zustellungen auf. SimpliServ führt ihn zusätzlich alle fünf Minuten automatisch aus.
Während eines Imports zeigt die Karte den Badge Import läuft samt Fortschritt („x neu, y aktualisiert, z fehlgeschlagen"). Ein zweiter Import startet erst, wenn der laufende fertig ist.
Der Knopf Vollständiger Import ist gesperrt, wenn Produkte deaktiviert sind oder die Richtung auf Ausgehend steht. Setze sie auf Eingehend oder Beide.
Der Block Sync-Status zeigt danach zugeordnete Produkte, zugeordnete Bestellungen, den letzten Import und die letzte Prüfung.
Webhooks einrichten
Ohne Webhooks erfährt SimpliServ von neuen Bestellungen erst beim Fünf-Minuten-Abgleich. Für Live-Updates legst du sie einmalig in WordPress an — URL und Secret stehen im Block Webhooks einrichten.
Webhook-URL und Secret kopieren
Kopiere die angezeigte Webhook-URL (Form: https://…/api/v1/webhooks/woocommerce/<dein-slug>) und das Webhook-Secret.
Webhooks in WooCommerce anlegen
Öffne WooCommerce → Einstellungen → Erweitert → Webhooks und lege je einen Webhook mit Status Aktiv für diese sechs Themen an: order.created, order.updated, order.deleted, product.created, product.updated, product.deleted.
URL und Secret eintragen
Trage als Auslieferungs-URL die kopierte Webhook-URL und als Secret das kopierte Webhook-Secret ein, dann speichern. WooCommerce schickt beim Anlegen einen Test-Ping, den SimpliServ bestätigt — damit wird der Webhook aktiv.
SimpliServ prüft jede Zustellung über die Signatur im Header X-WC-Webhook-Signature; unpassend signierte Aufrufe werden abgewiesen. Mehrfach zugestellte Ereignisse werden erkannt und nur einmal verarbeitet.
Secret neu generieren macht alle bestehenden WooCommerce-Webhooks ungültig, bis du das neue Secret dort überall einträgst.
Was synchronisiert wird
Bestellungen (WooCommerce → SimpliServ)
Neue Bestellungen werden als Shop-Bestellung angelegt — mit Positionen, Versandkosten sowie Rechnungs- und Lieferadresse. Fehlt der Kunde, wird er anhand der E-Mail-Adresse neu angelegt. Der Bestand wird sofort reserviert.
Produkte (beidseitig)
Importierte Produkte bleiben über Produkt-Webhooks aktuell. Umgekehrt überträgt SimpliServ Name, Beschreibung, Preis, SKU, Status und Bilder, sobald am Produkt Auto-Sync aktiv ist.
Bestände (beidseitig)
Bestandsänderungen im zugeordneten Lager gehen als absolute Menge an WooCommerce; Änderungen im Shop kommen per Webhook zurück.
Rechnungen (optional)
Bezahlte Bestellungen erzeugen auf Wunsch automatisch eine bezahlte Rechnung — wahlweise direkt per E-Mail an den Kunden.
Bestellstatus
Der WooCommerce-Status wird so auf die Shop-Bestellung abgebildet:
| WooCommerce | Shop-Bestellung |
|---|---|
completed | Geliefert |
cancelled, failed, refunded | Storniert |
alle übrigen (z. B. processing, on-hold) | Offen |
Als bezahlt gilt eine Bestellung, wenn ihr Status processing oder completed ist oder WooCommerce ein Zahldatum meldet. Wird sie im Shop storniert, gibt SimpliServ die Reservierung wieder frei. Eine lokal bereits (teil-)gelieferte Bestellung wird nicht zurück auf Offen gesetzt.
Die weitere Abwicklung — Lieferschein, Versand, Rechnung — beschreibt der Leitfaden Shop-Bestellungen.
Einzelnes Produkt steuern
In der Produkt-Detailansicht erscheint bei bestehender Verbindung die Karte WooCommerce. Sie zeigt:
- den Sync-Status (Synchronisiert, Wird synchronisiert, Deaktiviert, Synchronisation fehlgeschlagen oder Keine Verbindung),
- die WooCommerce-ID und den letzten Sync,
- den Schalter Auto-Sync zu WooCommerce,
- den Link In WooCommerce öffnen, der den Artikel direkt im WP-Admin öffnet.
Das Umschalten benötigt die Berechtigung Produkte → Bearbeiten. Beim Einschalten überträgt SimpliServ das Produkt sofort. Steht der Bereich Produkte nicht auf Ausgehend oder Beide, wird das Einschalten abgelehnt.
Änderungen, die gerade erst aus WooCommerce importiert wurden, lösen keinen Rückversand aus — ein kurzes Zeitfenster verhindert Sync-Schleifen.
Zugangsdaten ändern und trennen
- Zugangsdaten bearbeiten — neuen Consumer Key und ein neues Secret hinterlegen (nur beides zusammen). Die Verbindung bleibt dieselbe, alle Zuordnungen bleiben erhalten. Die Shop-URL lässt sich nicht ändern: Für einen anderen Shop trennst du und verbindest neu.
- Trennen — entfernt die Verbindung samt aller Zuordnungen zwischen deinen Produkten, Bestellungen und ihren WooCommerce-Datensätzen. Bereits importierte Produkte und angelegte Shop-Bestellungen bleiben in SimpliServ erhalten; bei erneuter Verbindung wird alles neu zugeordnet.
Fehlersuche
| Symptom | Ursache und Lösung |
|---|---|
| „WooCommerce ist von diesem Server nicht erreichbar" | Shop nicht öffentlich erreichbar, Firewall bzw. Basic-Auth davor oder ungültiges Zertifikat. Anschließend Verbindung testen. |
| Zugangsdaten werden nicht akzeptiert | Schlüssel hat nur Leserechte oder wurde in WordPress gelöscht. Neuen Schlüssel mit Lesen/Schreiben erzeugen und über Zugangsdaten bearbeiten hinterlegen. |
| Bestellungen kommen nicht an | Webhooks fehlen, stehen nicht auf Aktiv oder tragen ein altes Secret. Danach Bestellungen abgleichen klicken, um Verpasstes nachzuholen. |
| Produkte werden nicht übertragen | Am Produkt ist Auto-Sync aus, oder der Bereich Produkte steht auf Eingehend. |
| Bestände weichen ab | Es zählt nur das in der Verbindung gewählte Lager. Prüfe außerdem, ob das Produkt in WooCommerce Bestandsführung aktiviert hat. |
| Verbindung lässt sich nicht speichern | Es ist bereits Shopify oder JTL-Wawi verbunden — dort zuerst trennen. |
Verwandte Themen
Connectoren verwalten
Der Connectoren-Hub, in dem die WooCommerce-Kachel lebt.
Shop-Bestellungen
Wie eingehende Shop-Bestellungen abgewickelt und versendet werden.
Channel-Sync einrichten
Sync-Richtung und Produkt-Mapping über alle Kanäle hinweg.
Produkte
Produkte, Artikelnummern und Varianten in SimpliServ.
Lager & Bestand
Lager anlegen und Bestände führen.
Shopify anbinden
Alternative Shop-Anbindung per OAuth.
How is this guide?