Shop an die Warenwirtschaft anbinden: welche Daten in welche Richtung fließen – Plan für WooCommerce und Shopware
Eine Schnittstelle zwischen Shop und Warenwirtschaft funktioniert dann verlässlich, wenn für jede Datenart feststeht, in welche Richtung sie fließt, wann sie übertragen wird und welches System bei Widersprüchen gewinnt. Der Plan unten deckt alle sieben Datenarten für WooCommerce und Shopware 6 ab, mit den passenden Stellen aus der Hersteller-Doku.
Stand 16.11.2026. Grundlage: Dokumentation der WooCommerce REST API v3 (Produkte, Varianten, Bestellungen, Erstattungen, Webhooks), WooCommerce-Anwenderdokumentation zu Webhooks und Programmcode von WooCommerce 11.3.0, Entwicklerdokumentation und Programmcode von Shopware 6.7.0.0 (Zustandsmaschinen, Webhooks, Sync API, Dokumente, Bestand) sowie das offizielle Shopware-Forum und der JTL-Guide.
- Kurze Antwort: wer liefert welche Daten
- Woran Sie einen ungeplanten Datenfluss erkennen
- Warum Shop und Warenwirtschaft auseinanderlaufen
- Der Datenfluss-Plan: sieben Datenarten in einer Tabelle
- Anbinden in der richtigen Reihenfolge
- Fertiger Connector oder eigene Schnittstelle?
- Was WooCommerce und Shopware technisch vorgeben
- Damit die Anbindung stimmt, auch nach Monaten
Kurze Antwort: wer liefert welche Daten
Für jede Datenart braucht eine Anbindung zwischen Shop und Warenwirtschaft vier Festlegungen: die Richtung, den Takt, das führende System und eine Konfliktregel. Fehlt eine davon, können die Zahlen früher oder später auseinanderlaufen.
- Von der Warenwirtschaft zum Shop: Artikel, Preise und Rechnungen. Hier wird gepflegt und gebucht.
- Vom Shop zur Warenwirtschaft: Bestellungen. Sie entstehen im Shop.
- In beide Richtungen: Bestand, Status und Retouren. Beide Systeme ändern diese Daten, also braucht jede davon eine Konfliktregel.
Das ist die übliche Aufteilung, keine feste Regel. Pflegen Sie Ihre Artikeltexte zum Beispiel im Shop, dann ist der Shop für genau diese Felder führend. Wichtig ist, dass die Zuständigkeit für jedes Feld eindeutig ist und schriftlich festgehalten wird.
Woran Sie einen ungeplanten Datenfluss erkennen
- Im Shop steht ein anderer Bestand als in der Warenwirtschaft, und niemand weiß, welcher stimmt.
- Preise, die Sie in der Warenwirtschaft geändert haben, tauchen nach dem nächsten Abgleich wieder in alter Höhe auf. Oder Aktionspreise aus dem Shop verschwinden.
- Einzelne Bestellungen kommen in der Warenwirtschaft nicht an, und das fällt erst auf, wenn ein Kunde nachfragt.
- Der Kunde sieht im Shop „in Bearbeitung“, obwohl das Paket längst unterwegs ist.
- Nach einer Retoure ist der Artikel doppelt eingebucht, oder das Geld wurde zweimal erstattet.
- Rechnungsnummern entstehen in zwei Systemen.
Steht die Synchronisation ganz still, finden Sie die Fehlersuche im Beitrag Schnittstelle synchronisiert nicht mehr. Dieser Artikel setzt eine Stufe früher an, nämlich bei der Planung.
Warum Shop und Warenwirtschaft auseinanderlaufen
Zwei Systeme ändern dasselbe Feld
Pflegen Mitarbeiter Preise im Shop und in der Warenwirtschaft, kann ohne geeignete Konfliktregeln eine spätere Übertragung den fachlich richtigen Wert überschreiben. Eine zuverlässige Auflösung braucht festgelegte Zuständigkeiten und gegebenenfalls Änderungsprotokolle.
Ereignisse gehen verloren
Webhooks melden Änderungen sofort, aber sie sind kein sicherer Transportweg. Für laufende Zustellungen gelten laut WooCommerce-Anwenderdokumentation Antworten mit HTTP-Status 2xx, 301 und 302 als Erfolg; der Programmcode von WooCommerce 11.3.0 akzeptiert den Bereich 200 bis 302. Andere Antworten zählen als Fehlschlag. WooCommerce deaktiviert Webhooks nach wiederholten aufeinanderfolgenden Zustellfehlern; die Fehlerschwelle ist konfigurierbar. Aktivieren Sie den Webhook dann unter WooCommerce > Einstellungen > Erweitert > Webhooks erneut oder setzen Sie seinen Status über die REST API auf active. Die Zustellprotokolle finden Sie unter WooCommerce > Status > Logs. Fehlt ein zeitgesteuerter Kontrollabgleich, fallen verlorene Bestellungen erst spät auf.
Die Meldung enthält nicht die ganzen Daten
Bei Shopware tragen Webhooks für geschriebene Datensätze (entity.written, etwa order.written) nur den Primärschlüssel. Die Gegenseite muss die vollständigen Daten danach über die API abrufen. Plant man das nicht ein, kommen unvollständige Datensätze an.
Standardwerte, die doppelt buchen
Legen Sie eine Erstattung über die WooCommerce REST API an, sind api_refund und api_restock standardmäßig eingeschaltet. Bei api_refund=true versucht WooCommerce, über den ursprünglichen Zahlungsanbieter zu erstatten. Das Gateway muss automatische Erstattungen unterstützen. Wird die Zahlung außerhalb von WooCommerce erstattet, setzen Sie api_refund auf false. Mit api_restock bucht der Shop außerdem Ware zurück ins Lager. Zurückgebucht werden dabei die in line_items übergebenen Mengen von lagerverwalteten Positionen, deren Bestand zuvor abgebucht wurde. Bucht die Warenwirtschaft den Wareneingang zusätzlich und meldet den Bestand als Differenz statt als Absolutwert, zählt der Artikel doppelt.
Grenzen bei Mengen
Batch-Aufrufe in WooCommerce nehmen standardmäßig höchstens 100 Objekte pro Anfrage an, Anlegen, Ändern und Löschen zusammengerechnet. Die Sync API von Shopware führt eine Anfrage als eine Transaktion aus: Scheitert ein Datensatz, wird die ganze Anfrage zurückgerollt. Wer große Kataloge in einem Stück schickt, bekommt deshalb Abbrüche oder ganze Pakete, die nicht ankommen.
Der Datenfluss-Plan: sieben Datenarten in einer Tabelle
Die Tabelle zeigt eine bewährte Ausgangslage. Passen Sie Richtung und führendes System an Ihren Betrieb an, aber füllen Sie jede Zelle aus. Die letzten beiden Spalten nennen die Stellen in der Doku, an denen die Daten technisch übergeben werden. Schreibwege (Endpunkte und Aktionsrouten) sind dort von ausgehenden Ereignissen getrennt benannt: Ein Ereignis meldet nur, dass etwas geschrieben wurde.
| Datenart | Richtung | Takt | Führend | Konfliktregel | WooCommerce REST API v3 | Shopware 6 Admin API |
|---|---|---|---|---|---|---|
| Artikel | Wawi zu Shop | Zeitgesteuert, zusätzlich bei Änderung | Wawi (Stammdaten), Shop für reine Shopfelder | Feldhoheit festlegen: Die Wawi überschreibt ihre Felder, Shopfelder wie SEO-Texte rührt sie nicht an. Schlüssel ist die Artikelnummer (SKU). | /products, /products/batch, Varianten unter /products/<id>/variations/batch, höchstens 100 Objekte je Anfrage | Schreibweg: Sync API POST /api/_action/sync mit upsert; ausgehendes Ereignis product.written |
| Preise | Wawi zu Shop | Bei Änderung, zusätzlich täglicher Kontrollabgleich | Wawi | Festlegen, wo Aktionspreise gepflegt werden. Gepflegt wird an genau einer Stelle, die andere Seite liest nur. | regular_price, sale_price, date_on_sale_from am Produkt | Schreibweg: Sync API (Preisabgleich aus ERP ist ein dokumentierter Anwendungsfall); ausgehende Ereignisse: product.written für Änderungen am normalen Produktpreis; product_price.written für erweiterte, regelabhängige Preise |
| Bestand | Beide | Shop reduziert je nach System bei Bestelleingang oder Zahlung; Wawi meldet in kurzem Takt zurück | Wawi (verkaufbarer Bestand) | Die Wawi sendet ihren berechneten verkaufbaren Bestand als Absolutwert, also den physischen Bestand abzüglich reservierter und gesperrter Mengen. Davon werden zusätzlich nur Shopbestellungen abgezogen, die in diesem Wert noch nicht berücksichtigt sind. Keine Differenzen addieren. | stock_quantity, manage_stock; bei aktivierter Lagerverwaltung reduziert WooCommerce den Bestand beim Zahlungsabschluss oder beim Wechsel zu processing, completed oder on-hold, nicht bei pending. set_paid=true stößt den Zahlungsabschluss an; dieser setzt eine dafür geeignete Bestellung je nach Bearbeitungsbedarf auf processing oder completed und löst gegebenenfalls die Bestandsreduzierung aus. | Schreibweg: Sync API (Bestandsupdates in Masse dokumentiert); im Standard ab Version 6.6 reduziert Shopware den Bestand bei Bestelleingang und erhöht ihn bei Storno wieder |
| Bestellungen | Shop zu Wawi | Ereignis per Webhook, dazu zeitgesteuerter Abgleich als Netz | Shop bis zur Übernahme, danach Wawi | Nach der Übernahme werden Positionen in der Wawi geändert. Die Übernahme muss doppelt eintreffende Meldungen erkennen. | /orders; Webhook order.created, order.updated; Signatur im Header X-WC-Webhook-Signature | Ausgehendes Ereignis checkout.order.placed; bei order.written nur der Primärschlüssel, Daten per API nachladen |
| Status | Beide: Zahlung vom Shop, Versand und Storno von der Wawi | Ereignis | Zahlung: Shop bzw. Zahlungsanbieter; Versand: Wawi | Jedes Teilsystem schreibt nur seinen Status. Übergänge nur nach den erlaubten Wegen, nicht direkt setzen. | Feld status: pending, processing, on-hold, completed, cancelled, refunded, failed | Getrennte Zustände für order, order_transaction, order_delivery. Schreibwege mit der ID der jeweiligen Entität: Bestellung über POST /api/_action/order/{orderId}/state/{transition} (etwa cancel), Lieferung über POST /api/_action/order_delivery/{orderDeliveryId}/state/ship, Zahlung über POST /api/_action/order_transaction/{orderTransactionId}/state/paid |
| Rechnungen | Wawi zu Shop | Ereignis nach Rechnungsstellung | Ein System, in der Regel die Wawi | Rechnungen und Nummern entstehen in genau einem System. Im anderen wird die Rechnungserstellung abgeschaltet. | Rückmeldung zum Beispiel als Bestellnotiz unter /orders/{id}/notes oder in meta_data | Schreibweg für externe PDF-Rechnungen: Dokumenteintrag über POST /api/_action/order/document/invoice/create mit static: true anlegen, danach die Datei über POST /api/_action/document/{documentId}/upload hochladen. document.written ist nur die anschließende Benachrichtigung. |
| Retouren | Beide | Ereignis | Wawi für Wareneingang und Prüfung; Erstattung an einer festgelegten Stelle | Erstattung und Wiedereinbuchung werden je einmal ausgelöst. Wenn die Wawi einbucht: api_restock auf false. | /orders/{id}/refunds mit amount, reason, line_items, api_refund, api_restock | Lieferstatus returned, returned_partially über die Aktionen retour, retour_partially; Zahlungsstatus refunded, refunded_partially über die Aktionen refund, refund_partially; ausgehendes Ereignis state_enter.order_delivery.state.returned |
Im Lager liegen 10 Stück. 2 davon sind für Aufträge reserviert, die die Wawi bereits übernommen, aber noch nicht versandt hat. Verkaufbar sind also 8. Eine neue Shopbestellung über 1 Stück ist in der Wawi noch nicht angekommen. Der Shop soll deshalb 7 anzeigen. Wer den physischen Bestand von 10 sendet, gibt 3 Stück zu viel frei.
Drucken Sie sie aus und tragen Sie für Ihren Betrieb in jede Zelle eine Entscheidung ein, bevor Sie einen Connector kaufen oder eine Schnittstelle beauftragen. Eine leere Zelle führt später leicht zu einer Rückfrage oder zu einem Datenfehler.
Anbinden in der richtigen Reihenfolge
Fangen Sie mit den einfachen Datenarten an, also mit denen in eine Richtung, und gehen Sie erst danach an die Fälle in beide Richtungen.
- Gemeinsamen Schlüssel festlegen. Jeder Artikel und jede Variante braucht in beiden Systemen dieselbe eindeutige Artikelnummer. In WooCommerce ist das das Feld
sku. Ohne sauberen Schlüssel ist jede weitere Stufe Glückssache. Wie Sie Produktdaten vorher in einer Tabelle bereinigen, zeigt der Beitrag Produktdaten in einer Tabelle pflegen. - Artikel und Preise von der Wawi in den Shop. Das ist eine Richtung, ein führendes System und das geringste Risiko. Senden Sie in Paketen: bei WooCommerce höchstens 100 Objekte je Batch-Anfrage. Für Shopware nennt das Shopware-Schulungsmaterial als Richtwert 100 bis 500 Datensätze für einfache Daten und 50 bis 200 für Daten mit vielen Verknüpfungen. Antwortet Shopware mit HTTP 429, wiederholen Sie die Anfrage mit wachsendem Abstand.
- Bestellungen vom Shop in die Wawi. Richten Sie den Webhook ein und zusätzlich einen zeitgesteuerten Abruf, der fehlende Bestellungen nachholt. Prüfen Sie die Signatur der Webhooks: bei WooCommerce im Header
X-WC-Webhook-Signature(HMAC-SHA256, Base64), bei Shopware im Headershopware-shop-signature. - Status zurück in den Shop. Versandstatus und Storno kommen von der Wawi. Bei Shopware schreiben Sie den Status über die Aktionsrouten, nicht direkt ins Feld. Laut Shopware prüft die Route, ob der Übergang erlaubt ist, schreibt die Historie und verschickt die hinterlegten Status-E-Mails. Hängt die Sendungsnummer, hilft der Beitrag Sendungsnummer kommt nicht im Shop an.
- Bestand in beide Richtungen. Erst wenn Bestellungen zuverlässig ankommen, kann die Wawi einen korrekten Bestand zurückmelden.
- Rechnungen und Retouren zuletzt. Hier hängen Geld und Buchhaltung dran. Legen Sie fest, welches System Rechnungen schreibt und wo erstattet wird. Was beim Thema E-Rechnung im Shop zu beachten ist, steht im Beitrag E-Rechnung in WooCommerce und Shopware.
Fertiger Connector oder eigene Schnittstelle?
Ein fertiger Connector ist oft der schnellere Weg. Die Frage ist, ob er Ihren ausgefüllten Datenfluss-Plan abbildet. Der Plan dient Ihnen dabei als Prüfliste.
Ein fertiger Connector reicht in der Regel, wenn
- Ihre Warenwirtschaft einen gepflegten Connector für Ihre Shopversion anbietet,
- Sie einen Shop ohne zusätzliche Verkaufskanäle betreiben,
- Ihre Artikel einfache Produkte oder Standardvarianten sind,
- Sie mit Listenpreisen und einfachen Aktionspreisen arbeiten,
- und sich jede Zelle Ihres Plans mit den Einstellungen des Connectors so umsetzen lässt, wie Sie es eingetragen haben.
Genauer prüfen sollten Sie den Connector, wenn
- Ihre Konfliktregeln von denen des Connectors abweichen, etwa bei der Feldhoheit für Artikeltexte,
- Sets, Stücklisten oder Varianten mit eigenem Bestand ins Spiel kommen,
- Sie im B2B-Bereich kundenindividuelle Preise oder Staffeln aus der Wawi übernehmen,
- Rechnungen oder Erstattungen in einem dritten System entstehen, etwa in der Buchhaltung,
- eigene Felder, Zusatzfelder oder mehrere Lager übertragen werden müssen,
- oder Sie einen Kontrollabgleich und eine Fehlermeldung brauchen, wenn ein Webhook abgeschaltet wurde.
Manche fertigen Connectoren decken solche Anforderungen ab. Bildet der konkret geprüfte Connector die benötigten Daten und Abläufe nicht ab, wird eine Erweiterung oder eine eigene Schnittstelle erforderlich, die genau Ihren Plan umsetzt. Für diesen Fall bieten wir Schnittstellen und Systemintegration nach Maß an.
Was WooCommerce und Shopware technisch vorgeben
WooCommerce
- Die aktuelle REST API ist Version 3 unter
/wp-json/wc/v3/. - Webhooks gibt es für Bestellungen, Produkte, Kunden und Gutscheine, jeweils für Anlegen, Ändern und Löschen. Dazu kommen frei wählbare Aktions-Themen.
- Jede Zustellung trägt die Kopfzeilen
X-WC-Webhook-TopicundX-WC-Webhook-Resource. So kann die Gegenseite die Meldung zuordnen. - Ein abgeschalteter Webhook schaltet sich nicht von selbst wieder ein. Prüfen Sie seinen Status deshalb regelmäßig.
Shopware 6
- Eine Bestellung hat drei getrennte Zustände: Bestellung (open, in_progress, cancelled, completed), Zahlung (unter anderem open, authorized, paid, paid_partially, refunded, refunded_partially) und Lieferung (open, shipped, shipped_partially, cancelled, returned, returned_partially).
- Seit Version 6.7.0.0 heißt der Zahlungsübergang
process. Der alte Namedo_payist veraltet. Ältere Anbindungen sollten Sie beim Update daraufhin prüfen. - Webhooks bekommen Sie über Apps, die sie in ihrem Manifest anmelden. Die Ereignisliste erzeugt Shopware für jede Version neu. Prüfen Sie die Ereignisnamen deshalb in der Referenz zu Ihrer installierten Version.
- Die Sync API kennt die Aktionen
upsert(anlegen oder ändern) unddelete. Eine Anfrage ist eine Transaktion.
Damit die Anbindung stimmt, auch nach Monaten
- Plan als Dokument führen. Ändert sich ein Ablauf, wird zuerst der Plan geändert und danach die Schnittstelle.
- Kontrollabgleich einplanen. Lassen Sie einmal täglich Bestellungen, Bestände und Preise beider Systeme vergleichen und Abweichungen melden.
- Webhook-Status überwachen. Wird ein WooCommerce-Webhook abgeschaltet, kommt keine Fehlermeldung mehr, weil gar nicht mehr zugestellt wird. Eine eigene Prüfung des Status schließt diese Lücke.
- Doppelte Meldungen abfangen. Die Übernahme muss eine Bestellung erkennen, die sie schon kennt, und darf sie nicht ein zweites Mal anlegen.
- Updates testen. Vor einem Update von Shop oder Wawi die sieben Datenarten in einer Testumgebung einmal durchspielen, besonders Statusübergänge und Erstattungen.
Wenn Ihr ausgefüllter Datenfluss-Plan Zellen enthält, die kein fertiger Connector abbildet, setzen wir genau diese Regeln als Schnittstelle zwischen Ihrem Shop und Ihrer Warenwirtschaft um, inklusive Kontrollabgleich und Fehlermeldung.
Mehr dazu: Software-Schnittstellen entwickeln und Systeme integrieren
Quellen
- WooCommerce REST API Documentation v3 (Produkte, Bestellungen, Bestellstatus), woocommerce.github.io
- WooCommerce Developer Docs: Webhooks (REST API v3), developer.woocommerce.com
- WooCommerce: Webhooks bearbeiten, Status und Zustellfehler (Anwenderdokumentation), woocommerce.com
- WooCommerce 11.3.0: class-wc-webhook.php (Bewertung der HTTP-Antwort, failed_delivery), raw.githubusercontent.com
- WooCommerce 11.3.0: wc-stock-functions.php (Auslöser der Bestandsreduzierung), raw.githubusercontent.com
- WooCommerce 11.3.0: class-wc-order.php (payment_complete), raw.githubusercontent.com
- WooCommerce 11.3.0: wc-order-functions.php (Wiedereinbuchung bei Erstattungen), raw.githubusercontent.com
- WooCommerce Developer Docs: Product Variations (REST API v3), developer.woocommerce.com
- WooCommerce Developer Docs: Order Refunds (REST API v3), developer.woocommerce.com
- Shopware Developer Docs: Using the State Machine, developer.shopware.com
- Shopware 6.7.0.0: OrderActionController.php (Aktionsrouten für Bestellung, Zahlung, Lieferung), raw.githubusercontent.com
- Shopware 6.7.0.0: DocumentGeneratorController.php (Dokumentanlage und Upload), raw.githubusercontent.com
- Shopware ADR: Stock API (Bestandsreduzierung bei Bestelleingang), developer.shopware.com
- Shopware Developer Docs: Webhook (Apps), developer.shopware.com
- Shopware Developer Docs: Webhook Event Reference, developer.shopware.com
- Shopware Hub: Using the Sync API, hub.shopware.com
- Shopware Forum: API – Ändern des Zahlstatus (Action Routes), forum.shopware.com
- JTL-Guide: Bestandsübersicht (verfügbarer Bestand nach Abzug reservierter und gesperrter Artikel), guide.jtl-software.com
- Shopware 6.7.0.0: ProductDefinition.php (Feld price am Produkt), raw.githubusercontent.com
- Shopware 6.7.0.0: ProductPriceDefinition.php (erweiterte, regelabhängige Preise), raw.githubusercontent.com
Alle Quellen gelesen am 16.11.2026.
Erstellt von der Redaktion Die Netzhandwerker mit KI-Unterstützung. Die Sachangaben wurden vor der Veröffentlichung automatisch gegen die genannten Quellen geprüft.