Magento ERP-Integration: Synchronisation über REST und GraphQL
Produkte, Bestände, Preise und Bestellungen zwischen Magento und Ihrer Warenwirtschaft synchron halten: Welche Schnittstellen Magento bietet, wie die Synchronisation aufgebaut wird - und woran ERP-Anbindungen typischerweise scheitern.
Ein Online-Shop ist selten eine Insel. Produkte kommen aus dem ERP, Bestände ändern sich im Lager, Preise werden in der Warenwirtschaft gepflegt, und Bestellungen müssen zurück ins System, das Rechnung und Versand auslöst. Sobald diese Synchronisation manuell oder halbgar läuft, entstehen Überverkäufe, falsche Preise und genervte Kunden. Dieser Beitrag erklärt, welche Schnittstellen Magento dafür bietet und worauf es bei einer belastbaren ERP-Integration ankommt.
Dieser Artikel ist Teil unserer Serie "Magento für Entscheider". Wir schauen uns die Plattform aus der Perspektive an, die im Tagesgeschäft zählt: Was bringt es, was kostet es an Aufwand, und wo lohnt sich Hilfe von außen.
Welche Schnittstellen Magento mitbringt
Magento 2 ist von Grund auf API-orientiert gebaut. Für die Integration mit Drittsystemen stehen mehrere Web-APIs bereit: eine umfangreiche REST-API für nahezu alle Geschäftsobjekte (Produkte, Bestände, Preise, Kunden, Bestellungen), eine SOAP-API für ältere Integrationen sowie GraphQL, das vor allem für performante Frontend-Abfragen gedacht ist. Für ERP-Anbindungen ist die REST-API in der Regel der zentrale Weg.
Wichtig zu verstehen: Magento stellt die Schnittstellen bereit, aber die eigentliche Integrationslogik - was wann in welche Richtung synchronisiert wird - entsteht im Projekt. Genau hier liegt die Arbeit, und genau hier entscheidet sich, ob die Anbindung stabil läuft oder dauernd hakt.
Was eigentlich synchronisiert wird
Eine typische ERP-Anbindung deckt mehrere Datenflüsse mit unterschiedlicher Richtung und Frequenz ab:
Stammdaten aus dem ERP in den Shop: Produkte, Kategorien, Attribute, Preise - meist regelmäßig, aber nicht in Echtzeit.
Bestände aus dem ERP in den Shop: möglichst zeitnah, weil veraltete Bestände direkt zu Überverkäufen führen.
Bestellungen aus dem Shop ins ERP: möglichst sofort, damit Rechnung, Kommissionierung und Versand anlaufen.
Status-Rückmeldungen aus dem ERP in den Shop: Versandstatus, Tracking-Nummern und Rechnungsdaten zurück in den Kundenaccount.
Schon diese Aufstellung zeigt: Es gibt mehrere Synchronisationen mit unterschiedlichen Anforderungen an Aktualität und Fehlertoleranz. Bestände brauchen andere Regeln als Stammdaten.
Auf der ERP-Seite ist die Bandbreite groß: SAP, Microsoft Dynamics, Sage, Unit4, Odoo oder eine gewachsene Branchenlösung. Für die Anbindung zählt weniger der Produktname als die Frage, was das System anbietet - eine dokumentierte REST- oder SOAP-Schnittstelle, einen Dateiexport per CSV oder XML, oder nur einen Datenbankzugriff. Danach richtet sich, wie viel Integrationslogik auf der Magento-Seite entstehen muss.
Integrationsmuster: Direkt, Middleware oder iPaaS
Für die Verbindung von Magento und ERP gibt es im Wesentlichen drei Wege. Eine direkte Punkt-zu-Punkt-Anbindung ist schnell gebaut, wird aber bei wachsender Komplexität schnell unübersichtlich und schwer wartbar. Eine eigene Middleware (eine Zwischenschicht, die Daten transformiert, puffert und Fehler behandelt) ist aufwändiger, dafür laufen Feldzuordnung, Wiederholungen und Fehlerprotokoll an einer Stelle zusammen. iPaaS-Plattformen (Integration Platform as a Service) bieten fertige Konnektoren und sind eine Option, wenn Standardprozesse überwiegen.
Welcher Weg passt, hängt von Datenvolumen, Anzahl der Systeme und Ihrem Bedarf an Kontrolle ab. Für Händler mit individuellen Prozessen ist eine eigene Middleware-Schicht oft die haltbarste Wahl, weil sie Shop und ERP entkoppelt - ein Systemwechsel auf einer Seite reißt dann nicht die ganze Integration ein.
Nach dem Import: Magento-Cache und Indexer
Ein Punkt, der in Integrationsprojekten regelmäßig untergeht: Nach jedem Import müssen der Magento-Cache und die Indexer nachziehen. Wer Preise oder Bestände direkt in die Datenbank schreibt, umgeht die Magento-Logik. Im Frontend steht dann tagelang der alte Preis, während die Datenbank längst den neuen enthält.
Der belastbare Weg führt über die Web-APIs oder über die Import-Schnittstellen von Magento, weil beide die Cache-Invalidierung und die Reindexierung selbst anstoßen. Bei großen Importen gehören die Indexer in den Modus "Update on Schedule", damit nicht jeder einzelne Datensatz eine Neuberechnung auslöst.
Legen Sie außerdem fest, welche Produktattribute überhaupt aus dem ERP kommen. Häufig pflegt die Warenwirtschaft nur Artikelnummer, Preis, Bestand und Steuersatz, während Beschreibung, Bilder und Marketing-Attribute im Shop oder im PIM liegen. Ohne diese Abgrenzung überschreibt der nächste Import die Shop-Texte.
Woran ERP-Anbindungen typischerweise scheitern
Die meisten Probleme zeigen sich erst im Dauerbetrieb, lange nach dem ersten übertragenen Datensatz. Wiederkehrende Fehlerquellen sind:
Fehlgeschlagene Syncs werden verschluckt: Wenn ein Lauf abbricht und niemand es merkt, laufen Bestände und Preise auseinander.
Fehlendes Monitoring und Logging: Ohne Protokoll lässt sich im Fehlerfall nicht nachvollziehen, was wann passiert ist.
Unklare Datenhoheit: Wenn nicht definiert ist, welches System bei einem Konflikt gewinnt, überschreiben sich Daten gegenseitig.
Echtzeit-Erwartung an Daten, die in Wahrheit gar nicht in Echtzeit nötig sind - das treibt Komplexität und Kosten unnötig hoch.
Eine belastbare Integration plant diese Punkte von Anfang an mit ein: idempotente Verarbeitung, Wiederholungslogik bei Fehlern, Benachrichtigung bei Ausfällen und eine klare Definition der Datenhoheit pro Feld.
Wann sich externe Magento Entwicklung lohnt
ERP-Integrationen sind selten Standard. Jede Warenwirtschaft hat ihre Eigenheiten, jedes Sortiment seine Sonderfälle. Eine erfahrene Magento Agentur bringt vor allem Mustererkennung mit: Sie kennt die typischen Stolperfallen und baut die Anbindung so, dass sie auch im fünften Betriebsjahr noch wartbar ist. Das ist genau der Bereich, in dem sich externe Magento Entwicklung auszahlt: Der Erstaufbau geht dadurch kaum schneller, der Betrieb danach kostet aber deutlich weniger Nacharbeit.
Wir nennen hier bewusst keinen Pauschalaufwand - er hängt vollständig von ERP, Datenvolumen und Sonderfällen ab. Was sich pauschal sagen lässt: Eine gut geplante Integration ist günstiger als eine schnell zusammengesteckte, die später ständig repariert werden muss.
Fazit
Magento bringt mit REST, SOAP und GraphQL die Schnittstellen für eine ERP-Anbindung mit - die eigentliche Arbeit liegt in der Integrationslogik. Legen Sie pro Datenfluss fest, wer die Hoheit hat und wie oft synchronisiert wird, wählen Sie das Integrationsmuster danach (oft eine entkoppelnde Middleware), und lassen Sie jeden fehlgeschlagenen Lauf protokollieren und melden. Wer das von Anfang an einplant, muss die Anbindung später nicht neu bauen.
Quellen
Sie wollen Magento mit Ihrer Warenwirtschaft verbinden, ohne Überverkäufe und falsche Preise? Wir gehen Ihre Datenflüsse durch: Bestände, Preise, Bestellungen, Status. Danach steht fest, was in welcher Frequenz und in welche Richtung läuft und wie Fehler auffallen.