Shopware 6 ERP-Anbindung ohne Datenstau: Artikel, B2B-Preise und Bestände sauber synchronisieren

Der Shop läuft, bis das ERP sich meldet. Jede Nacht, manchmal jede Stunde, schiebt die Warenwirtschaft Artikel, Preise und Bestände nach Shopware. Und genau dann wird der Checkout zäh, die Administration hängt, und am nächsten Morgen fehlen zwei Bestellungen in der Warenwirtschaft, die im Shop eindeutig bezahlt wurden. Niemand weiß genau, wo sie geblieben sind.
Wer so etwas erlebt, hat selten ein Shopware-Problem. Er hat ein Architekturproblem in der Shopware 6 ERP-Anbindung. In diesem Beitrag zeigen wir, wie man große Kataloge, kundenindividuelle B2B-Preise und Lagerbestände so synchronisiert, dass der Shop schnell bleibt und keine Bestellung verloren geht. Am Ende steht eine Checkliste, mit der Sie Ihre eigene Schnittstelle selbst prüfen können.
Warum Synchronisation den Checkout ausbremst
Die meisten Schnittstellen, die wir übernehmen, sind nicht falsch programmiert. Sie sind für einen kleineren Shop gebaut worden und mitgewachsen. Die typischen Muster sehen so aus:
Alles auf einmal, jedes Mal. Der Import schickt den kompletten Katalog, egal ob sich etwas geändert hat. Bei zehntausenden oder hunderttausenden Artikeln heißt das: Shopware schreibt Datensätze neu, die identisch sind, und baut dafür Indizes und Caches neu auf.
Indexierung im Schreibvorgang. Jede Änderung an einem Produkt löst in Shopware Indexer aus: Varianten, Kategorien, Suchindex, berechnete Preise, Streams. Läuft das synchron mit dem Import, konkurrieren Import und Storefront um dieselbe Datenbank.
Cache-Lawinen. Jede Produktänderung invalidiert die zugehörigen Cache-Einträge. Ein Massenimport tagsüber leert faktisch den HTTP-Cache, und plötzlich rechnet der Server jede Seite neu, während gleichzeitig Kund:innen bestellen wollen.
Live-Abfragen im Checkout. Preis oder Bestand werden während des Bestellvorgangs direkt beim ERP angefragt. Antwortet das ERP langsam oder gar nicht, wartet der Checkout mit. Im schlimmsten Fall bricht er ab.
Der Admin-Worker in Produktion. Shopware verarbeitet Hintergrundaufgaben standardmäßig über den Browser, solange jemand in der Administration eingeloggt ist. Für einen Testshop praktisch, für einen Shop mit großen Importen ein Flaschenhals.
All das hat eine gemeinsame Ursache: Arbeit, die im Hintergrund passieren sollte, passiert im Vordergrund. Die Lösung geht deshalb immer in dieselbe Richtung: entkoppeln.
Das Grundprinzip: Message Queue statt Direktverbindung
Shopware 6 bringt mit dem Symfony Messenger bereits eine Message Queue mit. Viele Aufgaben, etwa Indexierung oder Mailversand, laufen darüber. Eine saubere Shopware API Synchronisation nutzt dieses Prinzip konsequent auch für die ERP-Daten:
Das ERP liefert, die Queue puffert. Änderungen aus der Warenwirtschaft landen als Nachrichten in einer Queue, statt direkt in die Shop-Datenbank geschrieben zu werden.
Worker arbeiten ab. Eigene Prozesse holen die Nachrichten in ihrem Tempo ab und schreiben sie in kleinen Paketen nach Shopware. Wird es eng, lässt sich die Zahl der Worker erhöhen, ohne dass der Shop selbst etwas davon merkt.
Fehler bleiben liegen, statt zu verschwinden. Eine Nachricht, die nicht verarbeitet werden kann, wird erneut versucht und landet nach mehreren Fehlversuchen in einer eigenen Fehler-Queue. Dort kann man sie ansehen, korrigieren und erneut einspielen.
In der Praxis bedeutet das für den Betrieb:
Den Admin-Worker in Produktion abschalten und die Queue über dauerhaft laufende Worker (messenger:consume) verarbeiten, überwacht von systemd, Supervisor oder im Kubernetes-Cluster als eigene Deployments.
Bei größeren Datenmengen die Queue nicht in der Shop-Datenbank betreiben, sondern über einen eigenen Transport wie RabbitMQ oder Redis. Dann stehen Queue und Bestellungen nicht mehr in derselben Datenbank in Konkurrenz.
Worker mit Zeit- und Speicherlimit starten, damit sie sich regelmäßig sauber neu starten und keine Speicherlecks über Tage ansammeln.
Große Kataloge: Deltas, Pakete und verzögerte Indexierung
Wer viele Artikel synchronisiert, gewinnt am meisten, indem er weniger schickt. Drei Regeln haben sich bewährt:
1. Nur Änderungen übertragen
Die Schnittstelle merkt sich, was zuletzt übertragen wurde, und schickt nur geänderte Datensätze. Das kann über einen Änderungszeitstempel im ERP passieren oder über einen Prüfwert (Hash) je Artikel. Ein vollständiger Abgleich läuft zusätzlich, aber selten und zu einer ruhigen Uhrzeit, um Abweichungen zu finden.
2. In Paketen über die Sync-API schreiben
Die Admin-API von Shopware hat einen eigenen Sync-Endpunkt, der viele Schreib- und Löschvorgänge in einem Aufruf entgegennimmt. Statt tausender Einzelaufrufe gehen Pakete in sinnvoller Größe raus. Wie groß ein Paket sein darf, hängt von Datenmodell und Server ab. Das misst man, statt es zu raten.
3. Indexierung in die Queue verschieben
Über einen Header beim Sync-Aufruf lässt sich steuern, dass Shopware die Indexierung nicht sofort, sondern über die Queue erledigt. Der Import ist damit schneller fertig, und die Indizes werden von den Workern nachgezogen. Bei sehr großen Katalogen gehört außerdem eine Suche über Elasticsearch oder OpenSearch dazu, damit Suche und Listings nicht direkt auf der Datenbank laufen.
B2B-Preise: kundenindividuell, ohne dass der Warenkorb leidet
Im B2B ist der Listenpreis oft der Preis, den niemand bezahlt. Händler haben Rabattgruppen, Großkunden eigene Konditionen, manche Artikel gelten nur für bestimmte Kunden. Genau hier wird es bei vielen Shops langsam.
Shopware kann Preise über Regeln steuern, zum Beispiel „Kundengruppe Händler“ oder „Kunde aus Österreich“. Das ist für eine überschaubare Zahl an Preisgruppen der richtige Weg. Wer aber versucht, jeden einzelnen Kunden mit eigenen Preisen über eigene Regeln abzubilden, baut sich ein Problem: Shopware wertet Regeln laufend aus, und mit jeder zusätzlichen Regel wird das teurer.
Für echte kundenindividuelle Preise gibt es bessere Wege:
Preisgruppen statt Einzelregeln, wo das ERP ohnehin mit Gruppen oder Staffeln arbeitet.
Eigene Preistabelle mit eigener Preislogik, die im Warenkorb nur die Preise des angemeldeten Kunden lädt. Das ist klassische Shopware-Plugin-Entwicklung.
Funktionen aus den kommerziellen Shopware-Plänen für kundenspezifische Preise, wenn der Shop ohnehin auf einem passenden Plan läuft.
Welcher Weg passt, hängt davon ab, wie das ERP Preise denkt. Wichtig ist eine Regel, die für alle gilt: Preise werden vorher synchronisiert, nicht im Checkout beim ERP erfragt. Der Shop rechnet mit dem, was er hat. Muss ein Preis tatsächlich live bestätigt werden, gehören dazu ein kurzes Zeitlimit und ein klarer Fallback, damit ein langsames ERP nie den Checkout blockiert.
Lagerbestände: lieber oft und klein als selten und groß
Bestände ändern sich laufend, in beide Richtungen. Das ERP bucht Wareneingänge und Verkäufe aus anderen Kanälen, der Shop verkauft gleichzeitig. Wenn beide Seiten stur den „richtigen“ Bestand überschreiben, entstehen Überverkäufe oder Artikel, die fälschlich ausverkauft sind.
Bewährt hat sich:
Kurze Intervalle mit kleinen Deltas statt eines großen nächtlichen Bestandsabgleichs.
Eine klare führende Seite. In der Regel ist das ERP führend, der Shop meldet Verkäufe zurück. Das muss für jedes Feld eindeutig festgelegt sein.
Offene Bestellungen mitdenken. Bestellungen, die im Shop schon eingegangen, im ERP aber noch nicht verbucht sind, dürfen beim nächsten Bestandsabgleich nicht „vergessen“ werden. Sonst verkauft der Shop dieselbe Ware zweimal.
Bestandsupdates ohne vollen Produktimport. Wer für eine Bestandsänderung jedes Mal den ganzen Artikel neu schreibt, löst unnötig Indexer und Cache-Invalidierung aus. Ein Bestandsupdate sollte nur den Bestand anfassen.
Bestellungen: die Stelle, an der nichts verloren gehen darf
Artikel und Preise kann man notfalls neu übertragen. Eine verlorene Bestellung ist verlorenes Geld und ein verärgerter Kunde. Deshalb verdient der Weg vom Shop ins ERP die meiste Sorgfalt.
Erst speichern, dann übertragen. Die Bestellung wird im Shop gespeichert und für den Export vorgemerkt. Die Übertragung ins ERP passiert danach im Hintergrund, nie als Teil des Checkouts. Fällt das ERP aus, bestellen Kund:innen trotzdem, und die Bestellungen gehen raus, sobald es wieder erreichbar ist.
Idempotent übertragen. Jede Bestellung trägt eine eindeutige Kennung. Kommt sie wegen eines Wiederholungsversuchs doppelt im ERP an, wird sie dort nicht doppelt angelegt.
Status zurückschreiben. Das ERP bestätigt die Übernahme, der Shop vermerkt sie. So lässt sich jederzeit sehen, welche Bestellungen noch offen sind.
Alarm statt Hoffnung. Hängt eine Bestellung länger als üblich im Status „nicht übertragen“, bekommt jemand eine Nachricht. Nicht erst, wenn der Kunde nachfragt, wo seine Ware bleibt.
Shopware Performance optimieren: was neben der Schnittstelle zählt
Eine entkoppelte Synchronisation nimmt den größten Druck vom Shop. Damit er auch unter Last schnell bleibt, gehören ein paar Grundlagen dazu:
HTTP-Cache und Reverse Proxy richtig konfiguriert, damit Kategorien und Produktseiten nicht bei jedem Aufruf neu gerechnet werden.
Massenimporte nicht zur Hauptverkaufszeit, wenn sie viele Cache-Einträge invalidieren.
Eigene Ressourcen für Worker, getrennt von den Prozessen, die die Storefront ausliefern. Im Kubernetes-Betrieb heißt das: eigene Deployments für Web und Worker, die unabhängig skalieren.
Plugins mit Bedacht. Event-Subscriber, die bei jeder Bestellung oder jedem Produkt-Update etwas Aufwendiges tun, summieren sich. Ein Profiling zeigt schnell, wo Zeit verloren geht.
Messen statt vermuten. Antwortzeiten, Queue-Länge und Fehlerquote gehören auf ein Dashboard. Dann sieht man einen Datenstau, bevor ihn Kund:innen bemerken.
Mehr dazu, wie wir Shopware-Shops schneller machen, steht auf unserer Seite zur Shopware-Performance. Und wenn Sie wissen wollen, wo der Shop dabei laufen kann: Wir betreiben Shopware auf Kubernetes in Deutschland.
Der Datenstau-Check: Prüfen Sie Ihre Schnittstelle selbst
Diese Fragen können Sie mit Ihrem Team oder Ihrer Agentur in kurzer Zeit durchgehen. Jedes „Nein“ oder „Weiß ich nicht“ ist ein Hinweis, wo Probleme entstehen können:
Überträgt die Schnittstelle nur geänderte Artikel, oder jedes Mal den ganzen Katalog?
Läuft die Verarbeitung über eine Queue mit eigenen Workern, und ist der Admin-Worker in Produktion abgeschaltet?
Gibt es eine Fehler-Queue, in der Sie sehen können, welche Nachrichten nicht verarbeitet wurden?
Fragt der Checkout irgendwo live beim ERP nach, und was passiert, wenn das ERP nicht antwortet?
Wie viele Preisregeln hat Ihr Shop, und wächst die Zahl mit jedem neuen B2B-Kunden?
Ist für jedes Feld festgelegt, ob Shop oder ERP führend ist?
Können Sie für jede Bestellung sehen, ob und wann sie im ERP angekommen ist?
Bekommt jemand automatisch Bescheid, wenn eine Bestellung nicht übertragen wurde?
Laufen große Importe zu Zeiten, in denen wenig bestellt wird?
Gibt es eine Dokumentation der Schnittstelle, die jemand außer dem ursprünglichen Entwickler versteht?
Wenn mehrere Antworten offen bleiben, ist das kein Grund zur Panik. Aber es ist ein guter Zeitpunkt, die Schnittstelle einmal von außen ansehen zu lassen, bevor das nächste Weihnachtsgeschäft oder der nächste große Kunde sie an ihre Grenzen bringt.
Wenn die aktuelle Agentur nicht weiterkommt
Oft landen Shopbetreiber bei diesem Thema, weil sich das Problem seit Monaten wiederholt. Der Import wird nachts verschoben, dann wird der Server größer, dann wird es wieder langsam. Das liegt selten am fehlenden Willen der bisherigen Agentur, sondern daran, dass eine gewachsene Schnittstelle irgendwann einen Umbau braucht statt einer weiteren Ausnahme.
Als B2B Shopware Agentur übernehmen wir solche Projekte auch mitten im Betrieb: erst eine Bestandsaufnahme von Shop, Schnittstelle und Hosting, dann ein Plan, welche Teile umgebaut werden und in welcher Reihenfolge, ohne dass der Shop dafür stillsteht. Wie ein solcher Wechsel abläuft, steht auf unserer Seite Shopware-Agentur wechseln. Wie wir Shopware mit Warenwirtschaften verbinden, finden Sie unter Shopware-ERP-Schnittstelle, und alles rund um Händlerpreise und Kundenkonten auf der Seite zum B2B-Onlineshop. Wie ERP-Daten auch bei Sonderanfertigungen bis in die Fertigung laufen, beschreiben wir in unserem Beitrag über 3D-Konfiguratoren in Shopware 6.
Lassen Sie uns auf Ihre Schnittstelle schauen
Sie haben den Datenstau-Check durchgegangen und mehr offene Fragen als Antworten? Oder Sie wissen schon genau, wo es hakt, und suchen jemanden, der es löst? Vereinbaren Sie ein Erstgespräch. Wir sehen uns Ihre Anbindung an und sagen Ihnen ehrlich, was wir umbauen würden und was nicht nötig ist.
Starte noch heute dein neues Projekt mit uns
Vereinbare ein kostenloses Erstgespräch, schreib uns an hallo@lucksmith.io oder ruf einfach durch: +49 6772 9198690