Shopware 6 Setup

Zentrale Einrichtungsseite für den Shopware 6 Connector. Hier werden die direkte API-Verbindung zum Shop (OAuth2 Client Credentials), die Standardwerte für Bestellimport, Artikelsynchronisation, Steuern, Währungen und Custom Fields konfiguriert.

Die Kommunikation mit dem Shopware-6-Shop erfolgt direkt über die Shopware 6 Admin API — ohne Middleware.

Seite öffnen

Über die Suche: Shopware 6 Setup
Über das Shopware 6 Dashboard → Aktion Setup
Über das merchantCENTRAL Dashboard → Shopware 6 → Setup

Felder

API Configuration

Verbindungsdaten zum Shopware-6-Shop. Die Authentifizierung erfolgt über OAuth2 Client Credentials.

Feld	Beschreibung
API URL	Basis-URL des Shopware-6-Shops, z. B. `https://myshop.com`. Alle API-Aufrufe gehen direkt an diese URL.
Access Key ID	API-Zugangsschlüssel aus der Shopware-Integration. Wird verschlüsselt in IsolatedStorage gespeichert und als `**` maskiert angezeigt. Muss in der Shopware-Administration unter Einstellungen > System > Integrationen* angelegt werden.
Secret Access Key	Geheimer API-Schlüssel der Shopware-Integration. Wird verschlüsselt in IsolatedStorage gespeichert und als `***` maskiert angezeigt.

Sicherheitshinweis

Alle Zugangsdaten (Access Key ID, Secret Access Key und OAuth2 Access Token) werden in IsolatedStorage mit dem SecretText-Datentyp gespeichert. Es werden niemals Credentials im Klartext in der Datenbank abgelegt. Die Anzeige zeigt immer *** — erst bei Änderung wird der neue Wert übernommen.

Order Import

Einstellungen für den automatischen Bestellimport aus dem Shopware-6-Shop.

Feld	Beschreibung
Order Import Enabled	Aktiviert den automatischen Bestellimport über die Job Queue. Wenn deaktiviert, werden keine neuen Bestellungen aus dem Shop importiert.
Max Orders Per Run	Maximale Anzahl an Bestellungen, die pro Job-Queue-Lauf importiert werden. Standardwert: 15. Ein niedrigerer Wert verhindert Timeouts bei großen Bestellmengen.
Order Date Filter	Frühestes Bestelldatum für den Import. Bestellungen vor diesem Datum werden ignoriert. Nützlich, um den Import auf einen bestimmten Zeitraum einzuschränken.
Missing Item Substitute	Sachkonto-Nr. (G/L Account), das als Ersatz verwendet wird, wenn ein Shopware-Artikel keinem BC-Artikel zugeordnet werden kann. Verhindert Fehler beim Bestellimport.
Suppress Status on Ship	Wenn aktiviert, wird bei der Lieferungsbuchung kein automatisches Status-Update an den Shopware-Shop gesendet. Nützlich, wenn der Status manuell oder über einen anderen Workflow aktualisiert werden soll.

Versandkosten und Zahlungsarten

Versandkosten werden zentral im merchantCENTRAL Hub konfiguriert (Zu-/Abschlagsartikel oder Sachkonto). Zahlungsarten-Mappings werden über die Hub-Tabelle Payment Mapping für den Marketplace-Code SHOPWARE6 eingerichtet. Rabatte und Promotions aus Shopware werden automatisch als Rabattzeilen importiert.

Item Settings

Standardwerte für die Artikelsynchronisation.

Feld	Beschreibung
Item Sync Enabled	Aktiviert die automatische Artikelsynchronisation über die Job Queue.
Price Sync Enabled	Aktiviert die automatische Preissynchronisation über die Job Queue.
Inventory Sync Enabled	Aktiviert die automatische Bestandssynchronisation über die Job Queue.
Default Tax ID	Standard-Steuer-UUID im Shopware-Shop. Neue Artikel werden mit dieser Steuerklasse angelegt. Kann automatisch über die Aktion Fetch Shop Defaults ermittelt werden.
Default Tax Rate	Standard-Steuersatz in Prozent (z. B. `19`). Wird zusammen mit der Tax ID verwendet, um den passenden Steuersatz beim automatischen Ermitteln zu finden.
Default Currency ID	Standard-Währungs-UUID im Shopware-Shop. Kann automatisch über die Aktion Fetch Shop Defaults ermittelt werden (sucht nach EUR).
Price List Code	Kundenpreisgruppen-Code (z. B. `SHOP`), aus dem Verkaufspreise für den Shop gelesen werden. Wenn leer, wird der Standardpreis `SHOP` verwendet.
Sales Channel ID	Standard-Verkaufskanal-UUID. Wird für SEO-URLs und kanalspezifische Funktionen verwendet. Kann über die Aktion Sync All Master Data automatisch befüllt werden.
Description Template	Standard-Beschreibungsvorlage für die automatische HTML-Beschreibungsgenerierung. Kann pro Artikel überschrieben werden.

Custom Fields

Bis zu 4 benutzerdefinierte Felder, die beim Artikel-Upload an den Shopware-Shop übertragen werden.

Feld	Beschreibung
Custom Field 1 Name / Label	API-Name und Anzeigename des ersten Boolean Custom Fields. Der API-Name muss mit der Custom-Field-Konfiguration in Shopware übereinstimmen.
Custom Field 2 Name / Label	API-Name und Anzeigename des zweiten Boolean Custom Fields.
Custom Text 1 Name / Label	API-Name und Anzeigename des ersten Text Custom Fields.
Custom Text 2 Name / Label	API-Name und Anzeigename des zweiten Text Custom Fields.

Status

Schreibgeschützte Statusinformationen zur letzten Synchronisation.

Feld	Beschreibung
Last Order Sync	Zeitstempel der letzten erfolgreichen Bestellsynchronisation.
Last Item Sync	Zeitstempel der letzten erfolgreichen Artikelsynchronisation.
Last Sync Error Message	Letzte Fehlermeldung bei einer Synchronisation. Wird rot angezeigt, wenn ein Fehler vorliegt, andernfalls grün (kein Fehler).
Last Sync Error DateTime	Zeitstempel des letzten Synchronisationsfehlers.
Token Expiry	Ablaufzeitpunkt des aktuellen OAuth2-Access-Tokens. Wird automatisch verwaltet — bei Ablauf wird ein neuer Token angefordert.

Aktionen

Aktion	Beschreibung
Test Connection	Testet die Verbindung zum Shopware-6-Shop in zwei Schritten: (1) Basis-Erreichbarkeit über `/api/_info/version`, (2) vollständig authentifizierter API-Aufruf über OAuth2 (`/api/_info/config`). Bei Erfolg erscheint eine Bestätigungsmeldung, bei Fehler die HTTP-Statusmeldung.
Sync All Items	Lädt alle Produkte aus dem Shopware-6-Shop herunter und aktualisiert die lokalen Artikel-Records. Es erscheint ein Bestätigungsdialog vor dem Start und ein 3-Zeilen-Fortschrittsdialog während der Verarbeitung.
Sync All Master Data	Führt eine vollständige Stammdaten-Synchronisation durch: Tags, Kategorien, Hersteller, Properties, Einheiten, Währungen, Steuersätze, Zahlungsarten und Verkaufskanäle werden heruntergeladen, fehlende BC-Einträge werden ergänzt und markierte Einträge an den Shop geschickt.
Fetch Shop Defaults	Ermittelt automatisch die Standard-Steuer-ID (passend zum eingestellten Default Tax Rate) und die Standard-Währungs-ID (EUR) über die Shopware-API und trägt sie in die Setup-Felder ein.
Init Shop Price List	Erstellt oder aktualisiert die BC-Preisliste aus allen Shopware-6-Artikelpreisen. Nützlich für den initialen Preisabgleich nach der Ersteinrichtung.
Create Job Queue Entries	Erstellt die Standard-Job-Queue-Einträge für die automatische Synchronisation (Bestellimport, Artikelsync, Preis-/Bestandsupdate, Statuscheck, WorkQueue-Verarbeitung). Nach dem Erstellen erscheint eine Bestätigung. Die Einträge müssen anschließend in der Job-Queue-Verwaltung aktiviert werden.

Ersteinrichtung (Schritt für Schritt)

Shopware-Integration anlegen: In der Shopware-Administration unter Einstellungen > System > Integrationen eine neue Integration erstellen und Access Key ID sowie Secret Access Key kopieren.
API URL eintragen: Die Basis-URL des Shops eingeben (z. B. https://myshop.com).
Credentials eingeben: Access Key ID und Secret Access Key in die entsprechenden Felder eintragen.
Test Connection: Verbindung prüfen — die Meldung „Connection successful" bestätigt die erfolgreiche Authentifizierung.
Default Tax Rate setzen: Den Standard-Steuersatz eingeben (z. B. 19 für 19 % MwSt.).
Fetch Shop Defaults: Automatisch die Standard-Steuer-ID und Währungs-ID (EUR) vom Shop holen.
Sync All Master Data: Alle Stammdaten synchronisieren (Tags, Kategorien, Hersteller, Einheiten, Währungen, Steuern, Zahlungsarten, Verkaufskanäle).
Zahlungsarten-Mapping: Im merchantCENTRAL Hub unter Payment Mapping die Shopware-Zahlungsarten den BC-Zahlungsbedingungen zuordnen.
Create Job Queue Entries: Automatische Hintergrundverarbeitung einrichten.
Job Queue aktivieren: Die erstellten Job-Queue-Einträge in der BC-Job-Queue-Verwaltung aktivieren.