Shopware 6 Connector

Überblick

Der merchantCENTRAL Shopware 6 Connector verbindet einen oder mehrere Shopware-6-Shops direkt mit Microsoft Dynamics 365 Business Central. Er importiert Bestellungen, überträgt Artikel, Preise und Bestände, hält Stammdaten synchron und meldet Liefer-, Zahlungs- und Bestellstatus an den Shop zurück – direkt über die Shopware 6 Admin API, ohne Middleware.

Der Connector läuft vollständig in Business Central und nutzt den zentralen merchantCENTRAL Hub für Lizenzierung, Versandkosten, Zahlungszuordnung und die übergreifenden Auswertungen.

Lizenz serverseitig

Die Lizenzierung erfolgt zentral in Business Central pro Tenant + Modul (SHOPWARE6) über den merchantCENTRAL Hub. Ohne gültige Lizenz oder aktive Demo bleibt der Marktplatz deaktiviert. Siehe Einrichtung.

Funktionsumfang

Bereich	Funktion
Bestellungen	Import inkl. Rabatte/Promotions, Rückmeldung von Bestell-, Liefer- und Zahlungsstatus, Retoure → Gutschrift, Beleg-Upload
Artikel	Upload/Sync von Titel, Preisen, Bestand, Bildern; Sichtbarkeit je Kanal; Custom Fields; Lieferzeit; wesentliche Merkmale
Varianten	Shopware-Varianten-Container über einen expliziten Varianten-Master
Beschreibungen	Template-basierte HTML-Beschreibungen aus Marketing-Text und technischen Daten
Stammdaten	Tags, Kategorien, Hersteller, Eigenschaften, Einheiten, Währungen, Steuern, Zahlungs-/Versandarten, Verkaufskanäle, Kundengruppen, Lieferzeiten
Dokumente & Recht	Produktdokumente in die Shop-Media, Wesentliche Merkmale (§312j BGB)
Marketing	Promotions, Cross-Selling, Bewertungen
Kunden	Kundenimport inkl. Kundengruppen
Multi-Shop	Mehrere Shops je BC-Umgebung – je Shop eigene Verbindung, Vorgaben und Sync-Schalter

Architektur

flowchart LR
  subgraph SHOP["Shopware 6 (ein oder mehrere Shops)"]
    S1["Admin API<br>OAuth2 Client Credentials"]
  end
  subgraph BC["Business Central (Cloud)"]
    direction TB
    CONN["Shopware 6 Connector<br>Setup · Shops · Artikel · Bestellungen · Sync"]
    HUB["merchantCENTRAL Hub<br>Lizenz · Versand · Zahlung"]
    CONN --> HUB
  end
  SHOP <==>|"HTTPS / JSON · ohne Middleware"| BC

Verbindung: OAuth2 Client Credentials; das Access-Token wird automatisch bezogen und erneuert.
Credentials: je Shop im zentralen Credential Store (SecretText), nie im Klartext.
Automatisierung: Job Queue + WorkQueue + optionale Webhooks (Azure Function).

Voraussetzungen

[ ] merchantCENTRAL Hub (AD merchantCENTRAL) installiert und eingerichtet
[ ] Modul-Lizenz – mindestens eine Demo für das Modul SHOPWARE6
[ ] Shopware-6-Shop mit einer Integration (Access Key ID + Secret Access Key)
[ ] Berechtigung ALN MC6 Admin (Einrichtung) bzw. ALN MC6 User (tägliche Arbeit)

Reihenfolge: Hub zuerst

Der Einrichtungsassistent des Connectors lässt sich erst öffnen, wenn der Hub eingerichtet ist (Platform-Guard). Richten Sie zuerst den merchantCENTRAL Hub ein.

So ist diese Hilfe aufgebaut

Handbuch als PDF

Die komplette Anleitung gibt es auch als Benutzerhandbuch (PDF) – Einrichtung und Betrieb in Business Central in einem Dokument. Diese Online-Hilfe ist stets die aktuellste Fassung.

Einrichtung

Seite	Inhalt
Einrichtungsassistent	Geführte Ersteinrichtung in 6 Schritten
Einrichtung (Referenz)	Setup Card: Aktivierung, Defaults, Automation, Lizenz
Shops (Multi-Shop)	Verbindung, Vorgaben und Overrides je Shop

Tägliche Arbeit

Seite	Inhalt
Dashboard	KPIs und Schnellzugriff
Artikel · Artikelkarte	Artikel pflegen und hochladen
Varianten-Master	Variantenartikel als Shop-Container
Produktdokumente	Datenblätter/Handbücher in die Shop-Media
Wesentliche Merkmale	Feature Sets (§312j BGB) zuweisen
WorkQueue · Protokoll	Verarbeitung und Aktivitätsprotokoll

Stammdaten

Seite	Inhalt
Beschreibungsvorlagen	HTML-Beschreibungen aus Sektionen
Kategorien · Tags · Hersteller	Katalogstruktur
Eigenschaftssets · BC-Attribut-Zuordnung	Eigenschaften/Attribute
Steuersätze · Währungen · Einheiten	Referenzdaten
Zahlungsarten · Versandarten	Zahlung & Versand
Verkaufskanäle · Kundengruppen · Lieferzeiten	Kanäle & Kataloge

Marketing & Automatisierung

Seite	Inhalt
Promotions · Bewertungen	Aktionen und Reviews
Artikelsichtbarkeit	Sichtbarkeit je Verkaufskanal
Webhooks	Echtzeit-Events über Azure Function