Shopware mit ERP oder Warenwirtschaft verbinden.
Ohne Dubletten und Datensalat.

Warum die Anbindung mehr ist als ein Häkchen

In den meisten Unternehmen ist das ERP oder die Warenwirtschaft das Herz: Dort entstehen Artikel und Preise, dort wird der Lagerbestand gezählt, dort laufen Versand und Rechnung. Shopware ist der Verkaufskanal. Die Schnittstelle sorgt dafür, dass beide Seiten zur richtigen Zeit dasselbe wissen.

Das klingt einfach, ist es aber selten. Ein Artikel mit sechs Größen und vier Farben ist im ERP vielleicht ein Datensatz mit Merkmalen, in Shopware ein Hauptprodukt mit 24 Varianten. Steuersätze, Versandarten und Zahlungsarten heißen in beiden Systemen anders. Wer das vor dem Start nicht klärt, sucht später Dubletten und Bestandsfehler.

Welche Schnittstellen Shopware 6 bietet

Shopware 6 ist von Grund auf über Schnittstellen gebaut. Für die ERP-Anbindung zählt vor allem die Admin-API. Laut Shopware-Entwicklerdokumentation ist sie für Vorgänge im Hintergrund gedacht: Produkte, Bestellungen, Kunden, Integrationen sowie Import und Export. Den Zugang legen Sie in der Administration unter „Einstellungen › System › Integrationen“ an. Shopware erzeugt dabei eine Zugangs-ID und einen geheimen Schlüssel, mit denen sich das ERP oder die Middleware per OAuth 2.0 anmeldet. Das ausgestellte Token ist zeitlich begrenzt.

Für große Datenmengen gibt es die Sync-API unter /api/_action/sync. Sie nimmt viele Datensätze und Datenarten in einer Anfrage an, zum Beispiel neue Produkte anlegen oder ändern (upsert) und alte löschen. Laut Shopware wird eine Sync-Anfrage als Transaktion ausgeführt: Scheitert ein Datensatz, wird die ganze Anfrage zurückgerollt. Shopware empfiehlt für komplexe Daten wie Produkte 50 bis 200 Datensätze je Anfrage, je nach Daten und Server.

Den Rückweg übernehmen oft Webhooks. Im App-System meldet Shopware Ereignisse – etwa eine geschriebene Bestellung – per Aufruf an eine festgelegte Adresse. Jeder Aufruf trägt eine Signatur, die der Empfänger prüfen muss. Bei Ereignissen zu Datensätzen schickt Shopware laut Doku nur die ID mit, die aktuellen Daten holt das empfangende System dann über die API. Die Store-API ist dagegen für Kundenfunktionen und eigene Frontends gedacht, nicht für den Datenabgleich mit dem ERP.

Drei Wege zur Anbindung

Fertiger Connector. Viele ERP-Hersteller bieten eine eigene Anbindung an Shopware 6 an, und im Shopware Store gibt es eine Kategorie für ERP-Integrationen. Ein Connector ist meist schnell eingerichtet. Er bildet aber den Standard ab. Eigene Felder, besondere Preislogiken oder ungewöhnliche Lagerprozesse brauchen oft Ergänzungen.

Middleware oder iPaaS. Eine Plattform zwischen den Systemen übernimmt den Datenaustausch, die Zuordnung und das Fehlerprotokoll. Das lohnt sich vor allem, wenn neben Shopware weitere Systeme angebunden werden, etwa Marktplätze, PIM oder Versanddienstleister.

Eigene Schnittstelle. Ein Plugin, eine App oder ein eigener Dienst, der über Admin-API, Sync-API und Webhooks mit Shopware spricht. Das passt, wenn kein Connector Ihre Abläufe abbildet oder Ihr ERP eine Eigenentwicklung ist. In der Praxis ist es oft eine Mischung: ein Connector als Basis, eigener Code für die Lücken. Welche Fähigkeiten ein Entwickler dafür braucht, zeigt der Ratgeber Shopware-Entwickler.

Beispiele: Anbindungen, die die Hersteller dokumentieren

Einige Beispiele, wie Hersteller die Anbindung an Shopware 6 beschreiben. Die Liste ist keine Rangfolge und keine Empfehlung – sie zeigt, wie unterschiedlich die Ansätze sind. Funktionen und Kompatibilität ändern sich, prüfen Sie den aktuellen Stand immer beim Anbieter.

• ✓JTL-Wawi: JTL dokumentiert den JTL-Connector für Shopware 6. Laut JTL-Guide gleicht er unter anderem Artikel, Bestände und Aufträge ab und unterstützt Datenübertragung von Shopware zur Wawi, von der Wawi zu Shopware und beides kombiniert.
• ✓Xentral: Laut Xentral holt das ERP alle Bestellungen aus Shopware, hält Bestände abgeglichen, überträgt Produkte samt Bildern, Varianten und Preisgruppen in bestimmte Verkaufskanäle und meldet nach dem Versand Status und Sendungsnummer zurück.
• ✓Microsoft Dynamics 365 Business Central: Im Shopware Store bietet die shopware AG selbst eine Integration an. Laut Beschreibung ist Business Central führend für Artikel, Bestände und Preise, Shopware führend für Bestellungen. Bei Kunden und Rechnungen hängt die Richtung vom Projekt ab.
• ✓Pickware: Ein anderer Ansatz. Pickware ERP läuft laut Anbieter direkt in der Shopware-Administration, ohne separates System und ohne Datenabgleich. Das passt, wenn Shopware Ihr wichtigster Verkaufskanal ist.
• ✓Weitere: In der ERP-Kategorie des Shopware Store finden sich unter anderem Connectoren für weclapp, Sage, Odoo und plentymarkets. Für SAP Business One bieten mehrere Drittanbieter Anbindungen im Store an.

Welche Daten in welche Richtung fließen

Für jede Datenart gilt eine Grundregel: Ein System ist führend, das andere übernimmt. Wer an beiden Stellen pflegt, erzeugt Widersprüche. Die Grafik zeigt die übliche Verteilung. Bei Ihnen kann sie anders aussehen – etwa wenn Produkttexte im Shop gepflegt werden oder Kunden sich im B2B-Bereich selbst registrieren.

Legen Sie für jede Datenart auch fest, wie oft sie fließt. Bestellungen und Bestände brauchen kurze Abstände oder Ereignisse über Webhooks. Für Artikelstammdaten reicht oft ein Lauf pro Stunde oder pro Nacht. Zu häufige Vollabgleiche belasten Shop und ERP unnötig.

Typische Probleme – und woher sie kommen

Die meisten Probleme haben wenige Ursachen. Dubletten entstehen, wenn Datensätze keine feste gemeinsame Nummer haben und die Schnittstelle bei jedem Lauf neu anlegt statt zu aktualisieren. Bestandsabweichungen entstehen durch zu lange Abstände, durch Reservierungen, die nur ein System kennt, oder durch Bestellungen, die zwischen zwei Läufen eingehen.

Varianten-Mapping ist bei Mode, Ersatzteilen und konfigurierbaren Produkten die häufigste Baustelle: Shopware arbeitet mit Hauptprodukt und Varianten, viele ERP mit eigenen Artikelnummern je Ausprägung. Steuern machen Ärger, wenn Steuersätze, Länder oder Brutto- und Nettopreise in beiden Systemen unterschiedlich angelegt sind.

Zeitverzug entsteht oft nicht in der Schnittstelle, sondern in Shopware selbst. Nach großen Importen müssen Indizes neu aufgebaut werden, und das erledigt die Message Queue im Hintergrund. Läuft der Hintergrundprozess nicht, sind die Daten zwar da, aber im Shop noch nicht sichtbar. Grenzen der API spielen ebenfalls eine Rolle: Zu große Sync-Anfragen werden langsam, und wer Anfragen nicht wiederholen kann, verliert Daten. Shopware rät bei Antworten mit Status 429 zu Wiederholungen mit wachsenden Abständen. Beim Massenimport von Kunden sollte außerdem der Header sw-skip-trigger-flow verhindern, dass für jeden importierten Kunden eine Willkommensmail aus dem Flow Builder verschickt wird.

Testen Sie die Anbindung nie zuerst im Live-Shop. Eine fehlerhafte Zuordnung kann in Minuten tausende Artikel überschreiben. Arbeiten Sie mit einer Kopie von Shop und – wenn möglich – einem Test-Mandanten im ERP.

Vorgehen in Schritten

Eine Anbindung gelingt, wenn die Fragen vor dem Code geklärt sind. Diese Schritte haben sich bewährt:

1. 1Ziel und Datenarten festlegenWelche Daten müssen fließen – Artikel, Bestände, Preise, Bestellungen, Kunden, Tracking, Rechnungen? Was passiert heute von Hand?
2. 2Führendes System je Datenart bestimmenFür jede Datenart genau ein System, das gewinnt. Schreiben Sie es auf, auch wenn es selbstverständlich wirkt.
3. 3Weg wählenPrüfen Sie, ob Ihr ERP-Hersteller einen Connector für Shopware 6 anbietet und ob er Ihre Version und Ihre Abläufe abdeckt. Sonst Middleware oder eigene Schnittstelle.
4. 4Zuordnung klärenGemeinsame Artikel- und Kundennummern, Varianten, Steuersätze, Versand- und Zahlungsarten, Bestellstatus. Das ist die meiste Arbeit – und die wichtigste.
5. 5Auf einer Testumgebung testenMit echten Daten und Sonderfällen: Storno, Teillieferung, Retoure, Gutschein, B2B-Preis. Erst wenn alles stimmt, live.
6. 6Überwachen und dokumentierenFehlerprotokoll, Benachrichtigung bei Abbrüchen, Dokumentation der Zuordnung. So kann auch jemand anderes später weiterarbeiten.

Worauf Sie achten – und wie wir das umsetzen

Achten Sie bei jeder Anbindung auf eigene Zugänge mit begrenzten Rechten, auf update-feste Umsetzung außerhalb des Shopware-Kerns, auf ein Fehlerprotokoll mit Benachrichtigung und auf eine Dokumentation, die nicht nur im Kopf eines Entwicklers existiert. Und klären Sie, wer die Schnittstelle nach dem nächsten Shopware- oder ERP-Update pflegt.

▶

Beim Abspielen lädt das Video von YouTube (Google).Datenschutz

Bei der Beyond AIgency, einer Marke der Beyond Media GmbH (seit 2004), setzen KI-Agenten Schnittstellen in der Sprache von Shopware um: als Plugin, App oder Dienst über Admin-API, Sync-API und Webhooks – oder als Ergänzung zu einem vorhandenen Connector. Jede Änderung entsteht auf einer Testumgebung, ein Prüf-Agent testet, ein Entwickler aus unserem Team gibt frei. Alle Zuordnungen landen im gemeinsamen Gehirn, das Ihren Shop dokumentiert.

Ihr Anliegen nimmt Martin, unser KI-Berater, rund um die Uhr per Sprache unter Kontakt auf und vereinbart bei Bedarf ein Gespräch mit einem unserer Technikexperten. Pflege und Fehlerbehebung laufen über eine feste Monatspauschale, monatlich kündbar. Neues rechnen wir nach Verbrauch über Token ab, große Vorhaben wie eine komplette ERP-Anbindung auf Wunsch zum Festpreis. Mehr über Schnittstellen und Anpassungen lesen Sie auf der Seite Webentwicklung, mehr über unsere Betreuung auf Shopware-Agentur und Shop-Technik.