Microsoft Dynamics 365 Business Central mit Shopware verbinden: Integrationsleitfaden

Finanzen, Lager und Bestellungen in einem System: So verbinden Sie Microsoft Dynamics 365 Business Central mit Shopware 6, von der App-Registrierung über den Connector bis zu Sandbox-Test und Go-live.

Einleitung

Ausgangslage

Wer einen Onlineshop betreibt, jongliert mit Bestandsführung, Auftragsabwicklung, Kundenkommunikation, Versand, Retouren und Marketing. Shop, Versanddienstleister, Buchhaltung und Helpdesk arbeiten dabei oft nebeneinander her. Mit wachsendem Umsatz wird dieses Stückwerk ineffizient, fehleranfällig und teuer.

Die Lösung

Microsoft Dynamics 365 Business Central ist ein cloudbasiertes ERP, das Finanzen, Vertrieb, Lager, Lieferkette und Kundendaten in einem System zusammenführt. Dieser Leitfaden führt von den Voraussetzungen über die Installation einer Connector-Erweiterung und die Konfiguration bis zu Sandbox-Test, Go-live und Betrieb. Ziel ist ein wiederholbarer, nachvollziehbarer Ablauf, der sich auch auf mehrere Shops übertragen lässt.

Für wen dieser Leitfaden gedacht ist

• Shopbetreiber, die Überblick und Effizienz wollen, ohne tief in die Entwicklung einzusteigen.
• Entwickler, die einen klaren Weg für Installation, Konfiguration und Feldzuordnung suchen.
• Agenturen, die mehrere Shops anbinden oder Kunden eine standardisierte Lösung anbieten.

Ergebnis

Am Ende läuft zwischen Shopware und Business Central ein bidirektionaler Datenfluss für Bestellungen, Kunden, Produkte und Bestände, getragen von einem ERP für Finanzen und Betrieb.

Für Unternehmen unterhalb der Enterprise-Größe lohnt sich vorher ein Blick auf Xentral: Es ist für den E-Commerce gebaut, bindet sich nativ an Shopware 6 an und ist schneller und günstiger eingeführt. Ein Vergleich der Optionen steht in unserem Beitrag zur kosteneffizienten ERP-Integration für Shopware 6.

Microsoft Dynamics 365 Business Central im Überblick

Business Central gehört zur Familie Microsoft Dynamics 365. Es ist ein Cloud-ERP für kleine und mittlere Unternehmen, das Finanzbuchhaltung, Vertrieb, Lager, Projekte und Service in einer Oberfläche bündelt. Durch die enge Verbindung mit Microsoft 365, Power BI, Power Automate und Azure lässt es sich flexibel erweitern.

Nutzen für den E-Commerce

• Ein Datenbestand: Kunden, Bestellungen, Rechnungen und Bestände an einem Ort.
• Weniger Handarbeit: keine doppelten Im- und Exporte; Lieferverfolgung, Bestellungen beim Lieferanten und Rechnungsstellung laufen automatisch.
• Aktuelle Bestände: Die im Lager gepflegten Mengen aus Business Central erscheinen in Shopware.
• Bessere Entscheidungen: Finanz- und Betriebsberichte in Echtzeit, etwa zu Lagerumschlag und Deckungsbeitrag.
• Compliance: Audit-Protokolle, Umsatzsteuerberichte und Finanzkontrollen erleichtern die Einhaltung regulatorischer Vorgaben, auch bei GoBD-Anforderungen.

Welche weiteren ERP- und CRM-Systeme sich mit Shopware verbinden lassen, zeigt unsere Übersicht zu Shopware ERP- und CRM-Integrationen.

Voraussetzungen

Shopware-Umgebung

• Version: Shopware 6.4 oder neuer; prüfen Sie die Kompatibilität des gewählten Connectors mit Ihrer Version.
• PHP: die von Ihrer Shopware-Version geforderte Version, mit php -v auf der Kommandozeile prüfen.
• Erweiterungen: Admin-Zugang zur Verwaltung von Erweiterungen in der Administration.
• Hosting: stabiles Hosting mit ausreichend CPU und RAM für Synchronisationsläufe; Message-Queue-Worker und Scheduler müssen laufen.

Business Central

• Abonnement: ein Business-Central-Mandant im Microsoft-365-Tenant Ihres Unternehmens.
• Admin-Zugang: Rechte im Business Central Admin Center und im Microsoft Entra Admin Center (früher Azure AD), um Apps, Benutzer und API-Zugriffe zu verwalten.
• App-Registrierung in Microsoft Entra ID: mit den nötigen Berechtigungen für die Business-Central-API, etwa Financials.ReadWrite.All (delegiert) oder API.ReadWrite.All (Anwendung).
• Sandbox-Umgebung: eine von der Produktion getrennte Testumgebung.
• Produktionsumgebung: der Live-Mandant für den echten Betrieb.

Zugangsdaten

Halten Sie bereit:

• Verzeichnis-ID (Tenant ID)
• Anwendungs-ID (Client ID) der App-Registrierung
• Client Secret
• Name der Business-Central-Umgebung und der Firma (Company)

Sicherheitsregeln

• Eigene App bzw. eigenen technischen Benutzer mit minimalen Rechten anlegen.
• Secrets regelmäßig erneuern (alle 90 bis 180 Tage).
• Zugangsdaten in .env-Dateien oder einem Secret-Store ablegen, nie im Code.

Connector-Erweiterung in Shopware installieren

Für die Anbindung brauchen Sie einen Connector. Im Shopware Store gibt es dafür Erweiterungen von Drittanbietern (Suche nach „Dynamics 365 Business Central“); alternativ bauen wir die Anbindung über die Business-Central-API und die Shopware-Admin-API individuell. Mehr dazu auf unserer Seite zur Shopware-Plugin-Entwicklung.

Schritte

1. In der Shopware-Administration anmelden.
2. Erweiterungen → Store öffnen.
3. Nach „Dynamics 365 Business Central“ suchen und die passende Erweiterung wählen.
4. Installieren klicken und warten, bis die Pakete entpackt sind.
5. Aktivieren, um die Funktionen der Erweiterung einzuschalten.

Integration konfigurieren

Verbindung einrichten

Öffnen Sie die Einstellungsseite der Erweiterung und tragen Sie ein:

• API-URL: der Endpunkt der Business-Central-API, in der Regel https://api.businesscentral.dynamics.com/v2.0/{tenant}/{umgebung}/api/v2.0/
• Tenant ID, Client ID und Client Secret aus der App-Registrierung
• Umgebung: Sandbox oder Produktion
• Firma: die Company in Business Central, mit der synchronisiert wird

Klicken Sie anschließend auf Verbindung testen und speichern Sie die Einstellungen.

Synchronisation festlegen

Legen Sie je Datenart Richtung, Intervall und Zuordnung fest:

• Produkte: Business Central → Shopware (Artikelstamm, Preise, Varianten)
• Bestände: Business Central → Shopware, möglichst in kurzen Intervallen
• Kunden: Shopware → Business Central (Debitoren anlegen und aktualisieren)
• Bestellungen: Shopware → Business Central (Verkaufsaufträge inklusive Zahlungsart, Versandkosten und Steuern)
• Status und Sendungsnummern: Business Central → Shopware

Achten Sie auf die Zuordnung von Steuersätzen, Zahlungsarten, Versandarten und Währungen. Hier entstehen die meisten Abweichungen in der Buchhaltung.

Sandbox-Test durchführen

Sandbox vorbereiten

1. Im Business Central Admin Center eine Sandbox anlegen, idealerweise als Kopie der Produktion.
2. Der App-Registrierung dieselben API-Berechtigungen geben wie für die Produktion.
3. Eigene Zugangsdaten verwenden, damit Test und Produktion nicht vermischt werden.

Synchronisation testen

1. In der Erweiterung auf den Modus Sandbox umschalten.
2. Für jede Datenart Jetzt synchronisieren ausführen: Kunden → BC, Produkte ← BC, Bestellungen → BC, Bestände ← BC.
3. Nach jedem Lauf die Daten in der Sandbox prüfen: Sind Preise, Steuern, Adressen und Mengen korrekt?

Protokolle auswerten

In den Synchronisationsprotokollen der Erweiterung sollten die Aufrufe mit Status 200 erscheinen. Fehler wie 401 (Berechtigung), 404 (falsche Umgebung oder Firma) oder 429 (API-Limit) beheben Sie, bevor Sie weitergehen.

Go-live in der Produktion

1. Umgebung in der Erweiterung von Sandbox auf Produktion umstellen.
2. Produktive Zugangsdaten eintragen und Verbindung testen ausführen.
3. Vollständige Erstsynchronisation starten und die ersten Zyklen auf Auffälligkeiten beobachten.
4. Team über die neuen Abläufe in Business Central informieren und einweisen.

Legen Sie vor dem Umschalten ein Backup der Shopware-Datenbank an und planen Sie den Go-live in eine verkehrsarme Zeit.

Best Practices nach dem Start

• Protokolle prüfen: Synchronisationslogs monatlich sichten und Benachrichtigungen bei Fehlern einrichten.
• Zugangsdaten: Client Secrets regelmäßig erneuern, Rechte nach dem Prinzip der minimalen Berechtigung vergeben.
• Abgleich: monatlich Bestellungen, Kunden und Bestände zwischen beiden Systemen gegenprüfen.
• Updates: Shopware, Connector und Business Central aktuell halten; Business Central erhält zweimal jährlich große Updates (Release Waves).
• Notfallplan: vor größeren Änderungen sichern und die Wiederherstellung testen.
• Performance: Warteschlangen, Dauer der Synchronisation und Serverlast beobachten.

Weiterführende Themen

• Mehrere Lager: Lagerorte („Locations“) aus Business Central auf Shopware-Lager abbilden.
• Eigene Entitäten: Montageartikel, Seriennummern oder Chargen über eigene API-Seiten synchronisieren.
• Automatisierung: Power Automate und Power BI für erweiterte Workflows und Dashboards nutzen.
• Lokalisierung: regionale Business-Central-Erweiterungen für Steuern, DATEV-Export oder Versandvorschriften installieren.
• Mehrere Shops: mehrere Shopware-Verkaufskanäle oder Shops aus einer Business-Central-Instanz bedienen.

Wenn Business Central für Ihre Größe zu umfangreich ist, lesen Sie unsere Anleitungen zu weclapp und Pickware, die für kleinere und mittlere Shops oft die passendere Wahl sind.

Fazit

Mit diesem Ablauf verbinden Sie Shopware und Microsoft Dynamics 365 Business Central in klaren Schritten: Voraussetzungen und Planung, Installation und Konfiguration, Sandbox-Test, Go-live und Betrieb. Das Ergebnis ist ein Shop, dessen Bestellungen, Kunden, Bestände und Finanzdaten in Echtzeit im ERP sichtbar sind. Wenn Sie Unterstützung bei Auswahl, Anbindung oder Feldzuordnung brauchen, sprechen Sie uns an; einen ersten Überblick über Ihren Shop liefert unsere Shop-Analyse.