Multi-Mandanten-Integration: Mehrere Shopware-Instanzen, ein B1ShopConnector

Einleitung

Eine Middleware-Instanz. Fünf Kunden. Fünf SAP-Business-One-Systeme. Fünf Shopware-Shops. Vollständig isoliert, individuell konfiguriert, zentral administriert.

Was nach einem Wunschtraum klingt, ist die Multi-Tenancy-Architektur von B1ShopConnector – und sie ist einer der Hauptgründe, warum Shopware-Agenturen und Systemintegratoren die Lösung schätzen.

In diesem Artikel erklären wir, wie das Profil-basierte Multi-Tenancy-Konzept funktioniert, welche Vorteile es bietet und für wen es besonders relevant ist.

Was bedeutet Multi-Tenancy in einer Integrations-Middleware?

Multi-Tenancy bedeutet, dass eine einzige Softwareinstanz mehrere voneinander unabhängige Mandanten (Tenants) bedienen kann. In der Welt der ERP-Shop-Integration heißt das konkret:

Eine laufende B1ShopConnector-Instanz kann gleichzeitig:

• Mandant A (SAP B1 Instanz X + Shopware Shop 1) bedienen
• Mandant B (SAP B1 Instanz Y + Shopware Shop 2) bedienen
• Mandant C (SAP B1 Instanz Z + Shopware Shop 3 + 4) bedienen

Dabei sind die Konfigurationen, Daten und Synchronisations-Logs der Mandanten vollständig voneinander isoliert. Kein Datenleck zwischen Kunden, keine gemeinsam genutzten Verbindungen.

Das Profil-Konzept

Das technische Fundament ist das Profil. Jeder Mandant bekommt ein eigenes JSON-Konfigurationsprofil, das enthält:

Verbindungsdaten

• ODBC-Verbindung zur SAP-B1-Datenbank (SQL Server oder HANA)
• Service-Layer-URL und Credentials für SAP B1
• Shopware Admin API URL und OAuth2-Credentials

Synchronisations-Konfiguration

• Welche Flows sind aktiv? (Produkte, Preise, Bestellungen, ...)
• Delta-Sync-Zeitstempel pro Flow
• Chunk-Größe und andere Performance-Parameter

Mapping und Customizing

• Sprach-Mappings (SAP-B1-Sprachcodes ↔ Shopware-Locale)
• Custom-Field-Mappings
• Pfad zu kundenspezifischem Python-Modul
• Pfad zu kundenspezifischen SQL-Skripten

Fehlerbehandlung

• Sentry-DSN für individuelles Error-Monitoring pro Mandant
• Log-Datei-Konfiguration

Jedes Profil hat seinen eigenen Laufzeitzustand (Runtime): Letzte Sync-Zeitstempel, Fehlerzähler, aktiver/inaktiver Status.

Warum das für Agenturen ein Game-Changer ist

Shopware-Agenturen und SAP-B1-Systemintegratoren, die mehrere Kunden mit ähnlichen Anforderungen betreuen, stehen vor einem wiederkehrenden Problem:

Für jeden Kunden eine eigene Middleware zu entwickeln, zu deployen und zu warten – das multipliziert den Aufwand linear. Ein Bugfix muss fünfmal gemacht werden. Ein Feature-Request muss fünfmal entwickelt werden.

Mit B1ShopConnector:

• Ein zentrales Deployment für alle Kunden
• Ein Monitoring-Dashboard für alle Profile
• Updates einmalig einspielen – alle Kunden profitieren
• Pro-Kunde-Customizing über Profile und Custom-Module, ohne den Kern zu berühren

Das reduziert den laufenden Betriebsaufwand erheblich und macht die Integration als Dienstleistung skalierbar.

Individuelle Anpassungen trotz geteiltem Core

Der häufigste Einwand gegen Multi-Tenancy in Integrationen: „Aber jeder unserer Kunden hat individuelle Anforderungen."

Das ist richtig. Und genau dafür ist das Custom-Module-System von B1ShopConnector gedacht.

Custom SQL-Skripte pro Profil

Wenn Kunde A eine andere Produktdatenbankstruktur in SAP B1 hat als Kunde B, bekommt jedes Profil eigene SQL-Abfragen. Der Core-Flow bleibt identisch – nur die Datenbeschaffung ist kundenspezifisch.

Custom Python-Module pro Profil

Komplexere Transformationen (z. B. spezielle Bundle-Auflösungslogik, individuelle Kundenzuordnung, besondere Preisberechnung) werden als Python-Modul pro Profil implementiert. Diese Module werden dynamisch geladen und greifen an definierten Hook-Points in den Standard-Flow ein.

Das Ergebnis: Sie können für zehn Kunden zehn verschiedene Integrationsverhalten konfigurieren – mit einem einzigen, zentralen Codebase.

Multi-Shop: Ein Unternehmen, mehrere Shopware-Instanzen

Multi-Tenancy ist nicht nur für Agenturen relevant. Auch Unternehmen, die mehrere Shopware-Shops betreiben – etwa einen B2B- und einen B2C-Shop, oder Shops für verschiedene Märkte/Sprachen – profitieren.

Typisches Szenario:

• Shop 1 (B2C Deutschland): Standardsortiment, Endverbraucherpreise
• Shop 2 (B2B Österreich): erweitertes Sortiment, Netto-Staffelpreise
• Beide verbunden mit derselben SAP-B1-Instanz, aber unterschiedlichen Preislisten

Mit zwei Profilen in B1ShopConnector wird das abgebildet, ohne zwei separate Deployment-Instanzen betreiben zu müssen.

Betrieb und Monitoring

Im laufenden Betrieb können alle Profile über die REST-API von B1ShopConnector verwaltet werden:

• Einzelne Flows pro Profil manuell triggern
• Sync-Zeitstempel zurücksetzen (z. B. für einen vollständigen Neuabgleich)
• Logs pro Profil abrufen
• Profile aktivieren oder deaktivieren

Für das Monitoring empfehlen wir Sentry – konfigurierbar pro Profil mit eigenem DSN, sodass Fehler eines Kunden direkt dem richtigen Team gemeldet werden.

Fazit

Multi-Tenancy in B1ShopConnector ist kein Nice-to-have – es ist ein fundamentales Architekturprinzip, das die Lösung für Agenturen und wachsende Unternehmen besonders attraktiv macht. Zentraler Betrieb, individuelle Konfiguration, skalierbare Wartung.

Wenn Sie als Agentur mehrere Kunden mit SAP B1 und Shopware 6 betreuen oder als Unternehmen mehrere Shops verwalten:

[Agentur-Partnerschaft anfragen – wir stellen Ihnen das Partnermodell vor →]