Shopware-App für die ERP-Anbindung: erst die Architektur, dann die KI
Shopware-Händler sollen sich ohne Speziallösungen mit unserem ERP-System verbinden können. Dafür habe ich eine Shopware-App auf Basis von Symfony und dem Shopware App SDK entwickelt, mit Produkt- und Bestellsynchronisation, Nutzerverwaltung und lückenlosem Logging. Der entscheidende Schritt war, die Architektur selbst zu entwerfen, bevor KI beim Ausbau half.
- Kategorie
- API-Integration
- Kontext
- ERP-Anbindung für Shopware-Händler
- Rolle
- Backend- & Integrationsentwickler, Konzeption bis Deployment
- Zeitraum
- November 2025
- Tech-Stack
- SymfonyShopware 6Shopware App SDKSymfony MessengerRedisDoctrineTwigStimulusTailwind CSSPHPUnitDocker
Ausgangslage
Händler mit einem Shopware-Shop sollten sich an das ERP-System des Unternehmens anbinden können. Bis dahin bedeutete jede Anbindung Aufwand im Einzelfall. Ziel war eine Standardlösung: installieren, verbinden, fertig, ohne individuelle Sonderentwicklung pro Kunde.
Analyse & Vorgehen
Das eigentliche Problem war die Architektur. Ein erster, KI-generierter Entwurf funktionierte zwar, folgte aber keinem üblichen Muster für Shopware-Apps. Eine solche Grundlage wäre mit jeder Erweiterung schwerer wartbar geworden.
Deshalb habe ich ihn verworfen und die Grundarchitektur selbst entworfen:
- Im Shop des Händlers wird ein schlankes Plugin installiert.
- Das Plugin verbindet sich mit einer eigenständigen Shopware-App, einem Symfony-System auf Basis des Shopware App SDK.
- Die App übernimmt die gesamte Logik: Synchronisation, Mapping, Protokollierung und Kommunikation mit dem ERP.
Lösung
Auf dieser Basis habe ich die App mit bewährten Bausteinen aufgebaut:
- Asynchrone Verarbeitung mit Symfony Messenger und Redis, damit auch große Datenmengen zuverlässig verarbeitet werden, mit automatischem Wiederanlauf nach Abbrüchen.
- Bidirektionale Synchronisation von Produkten und Bestellungen, mit konfigurierbarem Attribut- und Kategorie-Mapping.
- Nutzerverwaltung direkt aus der App.
- Lückenloses Logging jedes Vorgangs, damit Fehler nachvollziehbar sind.
- Oberfläche mit Twig, Stimulus und Tailwind CSS.
- Unit-Tests von Anfang an.
- Staging- und Produktionsumgebung mit Reverse Proxy, TLS und automatisierten Datenbank-Backups habe ich selbst aufgesetzt.
Als diese Basis stand, habe ich KI gezielt eingesetzt, um Funktionen schneller umzusetzen. Weil Struktur, Muster und Tests vorgegeben waren, blieb der Code dabei sauber.
Ergebnis
Shopware-Händler können sich über eine Standard-App mit dem ERP verbinden, ohne Speziallösungen. Ich habe die App eigenständig von der ersten Codezeile bis zum produktiven Deployment entwickelt.
Erkenntnisse
KI beschleunigt die Umsetzung enorm, ersetzt aber keine Architekturentscheidung. Auf einem selbst entworfenen, getesteten Fundament wird sie zum Werkzeug. Ohne dieses Fundament entsteht schnell Code, der funktioniert, aber nicht wartbar ist.