Shopware ERP-Anbindung: Der technische Leitfaden für belastbare Datenflüsse

Warum die ERP-Anbindung über den Projekterfolg entscheidet

Eine ERP-Anbindung an den Shop ist die Schnittstelle, an der sich zeigt, ob Ihre Prozesse belastbar sind. Läuft die Anbindung, arbeitet Ihr Team mit einem Datenstand; bricht sie, entstehen Überverkäufe, falsche Preise und manuelle Nacharbeit. Bei Katalogen mit mehreren hunderttausend Produkten und mehreren Verkaufskanälen ist die Anbindung deshalb kein Nebenthema, sondern kritische Infrastruktur.

Hinweis aus der Praxis: Wir betreuen E-Commerce-Systeme mit über 400.000 Produkten und mehreren Store-Views. Die größten Probleme entstehen fast nie in der Schnittstellen-Technologie selbst, sondern in unklaren Datenverantwortlichkeiten und fehlender Fehlerbehandlung.

Wenn Sie zuerst den Projektablauf aus Sicht von Entscheidern sehen möchten, lesen Sie Online-Shop ans ERP anbinden: 5 Projektschritte. Dieser Leitfaden geht in die technische Tiefe.

Schritt 1: Systemanalyse vor der ersten Zeile Code

Bevor eine Schnittstelle entsteht, muss klar sein, welche Systeme welche Daten besitzen.

Stellen Sie zuerst die Führungsfrage: Welches System ist die führende Quelle für Stammdaten und welches für Transaktionsdaten? Typischerweise führt das ERP Artikelstammdaten, Preise, Bestände und Kunden, während Shopware Bestellungen und Kundenkonten erzeugt. Diese Aufteilung muss schriftlich fixiert werden, sonst überschreiben sich Systeme gegenseitig.

Klären Sie danach Datenvolumen und Takt: Wie viele Artikel ändern sich pro Tag? Wie viele Bestellungen pro Stunde müssen zurückgemeldet werden? Ein Shop mit 400.000 Produkten braucht eine andere Strategie als einer mit 500 Artikeln, bei denen ein Vollabgleich stündlich genügt.

Schritt 2: Die passende Schnittstellen-Technologie wählen

Die Wahl zwischen REST, GraphQL und Middleware ist keine Geschmacksfrage, sondern folgt aus Ihren Anforderungen.

REST-Schnittstellen eignen sich für klar getrennte, dokumentierte Endpunkte: ein Aufruf für Bestandsabfrage, einer für Bestellimport. Sie sind robust, gut überwachbar und für die meisten ERP-Anbindungen ausreichend. Shopware selbst bietet mit der Admin-API eine REST-Schnittstelle für genau diese Aufgaben.

GraphQL lohnt sich, wenn ein System viele unterschiedliche Datenkombinationen in einer Abfrage benötigt – etwa Produktlisten mit Varianten, Staffelpreisen und Lagerständen. Der Vorteil geringerer Roundtrips wird aber mit komplexerer Sicherheits- und Cache-Logik erkauft.

Middleware ist die richtige Wahl, wenn Daten zwischen ERP und Shop umfangreich transformiert, angereichert oder bereinigt werden müssen. Eine Middleware entkoppelt beide Systeme: Das ERP muss nicht wissen, wie Shopware Daten erwartet, und der Shop nicht, wie das ERP sie liefert. Genau in dieser Transformationsschicht liegt bei komplexen Katalogen der eigentliche Wert.

Für Shop-Projekte mit individuellen Anforderungen kombinieren wir häufig robuste REST-Endpunkte mit einer schlanken Middleware-Schicht für die Datenaufbereitung – etwa über Symfony-Schnittstellen oder n8n-gestützte Workflows. Wann n8n eine klassische Middleware ersetzen kann, beschreibt der Beitrag n8n statt teurer Middleware.

Shopware-spezifisch: Admin-API, Sync-API und Message Queue

Shopware 6 bringt für ERP-Anbindungen eigene Werkzeuge mit, die Sie kennen sollten, bevor Sie eine Architektur festlegen:

• Admin-API: Die REST-Schnittstelle für Produkte, Preise, Bestände, Kunden und Bestellungen. Der Zugriff für ein ERP erfolgt über eine eigene Integration mit Zugangsschlüssel, deren Rechte sich einschränken lassen.
• Sync-API: Für Massenänderungen schreibt sie viele Datensätze in einem Request (Upsert und Löschen). Für Bestands- und Preisupdates großer Kataloge ist sie in der Regel der bessere Weg als einzelne Requests je Artikel.
• Message Queue und Scheduled Tasks: Aufwendige Verarbeitungsschritte wie Indexierung laufen in Shopware asynchron über Worker. Bei großen Importen müssen diese Worker ausreichend dimensioniert sein, sonst stauen sich Aufgaben.
• Webhooks und Flow Builder: Ereignisse wie eine neue Bestellung lassen sich an externe Systeme melden, statt dass das ERP den Shop ständig abfragt.
• Store-API nicht für das ERP: Sie ist für Frontends und Kunden-Sessions gedacht, nicht für die Datenpflege aus der Warenwirtschaft.

Reichen die Standard-Endpunkte nicht aus, etwa für ERP-spezifische Felder oder eigene Prüfregeln, ergänzt ein eigenes Shopware-Plugin die Admin-API um passende Endpunkte und Datenfelder.

Schritt 3: Datenmodell und Mapping für Shopware abbilden

Die häufigste Fehlerquelle liegt nicht in der Technik, sondern im Mapping. ERP-Datenmodelle folgen Buchhaltungs- und Logistiklogik, Shop-Datenmodelle hingegen Verkaufs- und Darstellungslogik. Attribute, die im ERP flach und nummernbasiert sind, müssen im Shop hierarchisch, variantenfähig und mehrsprachig werden – in Shopware also als Eigenschaften, Varianten und Übersetzungen.

Achten Sie auf drei Punkte:

1. Eindeutige Identifikatoren. Jeder Artikel braucht über alle Systeme hinweg einen stabilen Schlüssel – nicht die Artikelnummer als Anzeigetext, sondern einen technischen Identifier.
2. Explizite Regeln für Konflikte. Wenn ERP und Shop denselben Preis unterschiedlich führen, muss definiert sein, welches System gewinnt.
3. Mehrsprachigkeit und Verkaufskanäle. Übersetzungen gehören in die Anbindung, nicht in manuelle Nachpflege, sobald mehr als eine Sprache bedient wird.

Sauber definierte Attribute sind der Unterschied zwischen einer Anbindung, die wartbar bleibt, und einem System, das nach jeder ERP-Aktualisierung neu debuggt werden muss.

Schritt 4: Monitoring und Betrieb von Anfang an mitplanen

Eine ERP-Anbindung ohne Monitoring ist ein Risiko auf Zeit. Sie brauchen Sichtbarkeit über den Zustand der Schnittstelle, nicht nur eine Fehlermeldung, wenn der Shop bereits falsche Bestände zeigt.

Planen Sie mindestens:

• Logging je Datensatz. Nachvollziehbar, welcher Artikel oder welche Bestellung wann wie übertragen wurde.
• Automatische Wiederholungen. Temporäre ERP-Ausfälle dürfen nicht zu Datenlücken führen; fehlgeschlagene Übertragungen müssen in eine Warteschlange und erneut versucht werden.
• Alarme statt stiller Fehler. Schwellenwerte, die melden, wenn Übertragungen ausbleiben oder die Fehlerquote steigt.
• Idempotente Verarbeitung. Doppelte Übertragungen dürfen keine doppelten Bestellungen oder Buchungen erzeugen.

Typische Fehlerquellen bei großen Shopware-Katalogen

Bei Katalogen mit vielen Varianten und mehreren Verkaufskanälen wiederholen sich dieselben Muster:

• Vollabgleich statt Delta. Ein stündlicher Komplettimport über 400.000 Produkte belastet beide Systeme unnötig. Delta-Abgleich über Änderungszeitstempel ist deutlich effizienter.
• Fehlende Transaktionsgrenzen. Wird eine Bestellung in mehreren Schritten geschrieben und ein Schritt schlägt fehl, entstehen halbe Datensätze.
• Unklare Zuständigkeit für Datenqualität. Ohne feste Verantwortung wächst die Zahl fehlerhafter Attribute kontinuierlich.
• Keine Versionsverwaltung der Schnittstelle. Änderungen am ERP oder Shop ohne abgestimmte Schnittstellenversion brechen bestehende Flüsse.

Wann Sie eine ERP-Anbindung nicht selbst bauen sollten

Eine ERP-Anbindung ist dann kein Projekt für eine Baukasten- oder Billiglösung, wenn Ihr Katalog groß, Ihr Datenmodell variantenreich und Ihr Betrieb langfristig ausgelegt ist. Genau dort – bei komplexen, wartbaren und skalierbaren Anbindungen – liegt unsere Stärke als Shopware Agentur mit Erfahrung in Symfony und Automatisierung.

Wenn Sie dagegen eine einfache Standardverbindung mit wenigen Artikeln ohne Individualanforderungen benötigen, ist ein fertiges Connector-Produkt oft die wirtschaftlichere Wahl. Wir sagen Ihnen offen, wann das der Fall ist.

Sie betreiben Magento oder Adobe Commerce? Die Grundsätze gelten dort genauso; unser Angebot dazu finden Sie unter ERP-Anbindung für Magento.

Fazit

Eine belastbare Shopware ERP-Anbindung entsteht in vier Schritten: klare Systemanalyse, bewusst gewählte Schnittstellen-Technologie, sauber abgebildetes Datenmodell und ein Monitoring, das Fehler sichtbar macht, bevor sie Kunden erreichen. Wer dabei die Werkzeuge von Shopware – Admin- und Sync-API, Message Queue, Webhooks – gezielt einsetzt, baut eine Anbindung, die auch bei wachsenden Katalogen trägt.

Sie planen eine ERP-Anbindung für Shopware und wollen die technische Machbarkeit einschätzen lassen? Wir prüfen Ihr Datenmodell und zeigen Ihnen den belastbaren Weg. Telefon +49 7248 934 50 54, E-Mail hallo@webmedia-hilcher.de oder über das Kontaktformular.