Shopware 6 Setup
Zentrale Einrichtungsseite für den Shopware 6 Connector. Sie bündelt die Aktivierung im Hub, die firmenweiten Standardwerte, die Shop-Liste, die Automatisierung und die Lizenz.
Verbindung liegt am Shop
Seit der Multi-Shop-Architektur gehören API-URL, Zugangsdaten und Sync-Schalter zum jeweiligen Shop (siehe Shops (Multi-Shop)), nicht mehr zur Setup-Karte. Die Setup-Karte hält die firmenweiten Default-Werte; ein leeres Shop-Feld erbt den Default.
Seite öffnen
- Über die Suche: Shopware 6 Setup
- Über das Dashboard → Aktion Einrichtung
- Über die Marktplatz-Karte im merchantCENTRAL Hub → Im Hub aktivieren (umgekehrter Weg)
Aufbau der Seite
| Bereich | Inhalt |
|---|---|
| Aktivierung | Schalter Aktiviert – aktiviert den Marktplatz im Hub. Erfordert eine gültige Lizenz oder aktive Demo; fehlt beides, öffnet sich die Demo-Registrierung. |
| Shopware 6 Einstellungen | Die firmenweiten Default-Einstellungen (siehe Feldreferenz). |
| Shops | Eingebettete Shop-Liste (identisch zu Manage Shops). |
| Automatisierung | Status der Aufgabenwarteschlange – zeigt, ob die Hintergrundaufgaben eingerichtet und bereit sind. Drill-down öffnet die Einträge. |
| Lizenz | Lizenz-FactBox zum Modul SHOPWARE6. |
Feldreferenz (globale Defaults)
| Bereich | Felder |
|---|---|
| Steuer & Währung | Default Tax ID, Default Tax Rate (Standard 19), Default Currency ID |
| Preise | Preislistencode (Standard SHOP; Auswahl aus den vorhandenen Verkaufspreislisten, ein neuer Code wird nach Rückfrage angelegt), Artikelpreise inkl. MwSt. (Standard = automatisch nach dem BC-Kennzeichen „Preise inkl. MwSt.", Ja = immer brutto, Nein = immer netto) |
| Beschreibung | Description Template (Standardvorlage für generierte Beschreibungen) |
| Verkaufskanal | Sales Channel ID (Pflicht für SEO-URL-Upload) |
| Varianten | Variant Container Suffix (Standard M) |
| Benutzerdefinierte Felder | Custom Field 1/2 (Boolean) + Custom Text 1/2 – je API-Name und Label |
| Produktdokumente | Documents Field Name (Default ad_documents), Datasheet URL Field Name (ad_datasheet_url), Upload Documents to Shop |
| Cross-Selling | Cross-Selling Group Name (Accessories/Related) und (Similar) |
| Stammdaten-Bilder | Master Data Image Mode (Disabled / Store URL / Hub Media Storage) |
| Prozess | Suppress Status Change on Shipping, Auto Payment Status on Ship, Auto Credit Memo on Return |
| Webhooks | Webhook Base URL (Azure-Function-Endpunkt) |
Sichere Speicherung der Zugangsdaten
Access Key ID, Secret Access Key und OAuth2-Token werden je Shop im zentralen Credential Store (SecretText) gespeichert – nie im Klartext in der Datenbank. Die Eingabe erfolgt über das DrillDown-Muster (kein Masked-Feld).
Versandkosten und Zahlungsarten
Versandkosten werden zentral im merchantCENTRAL Hub konfiguriert. 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.
Aktionen
| Aktion | Beschreibung |
|---|---|
| Einrichtungsassistent | Öffnet den geführten Einrichtungsassistenten. |
| Shops verwalten | Öffnet die Shop-Liste – Verbindung und Vorgaben je Shop. |
| Verbindung testen | Testet die Verbindung des kanonischen Shops (MAIN) per authentifiziertem Aufruf (api/_info/config). |
| Shop-Standardwerte abrufen | Ermittelt Standard-Steuer-ID und -Währungs-ID automatisch über die Shopware-API. |
| Shop-Preisliste initialisieren | Baut die BC-Preisliste aus allen Shopware-6-Artikelpreisen neu auf (über den Hub). |
| Aufgabenwarteschlangenposten erstellen | Erstellt die Standard-Job-Queue-Einträge für die automatische Synchronisation. |
| Aufgabenwarteschlangenposten öffnen | Öffnet die Job-Queue-Einträge des Connectors. |
| Im Hub aktivieren | Öffnet die Shopware-6-Marktplatz-Karte im Hub (Lizenz/Aktivierung). |
Stammdaten & Dashboard
Die Stammdaten-Synchronisation (Alle Stammdaten synchronisieren) und der Rückimport aus dem Shop (Vom Shop synchronisieren) laufen über das Dashboard.
Ersteinrichtung (Schritt für Schritt)
Am einfachsten über den Einrichtungsassistenten. Manuell:
- Hub zuerst einrichten (Platform-Guard).
- Aktiviert einschalten – bei fehlender Lizenz/Demo öffnet sich die Demo-Registrierung.
- Shops verwalten → Shop anlegen (
MAIN): API URL, Access Key ID, Secret Access Key. - Verbindung testen – Verbindung prüfen.
- Shop-Standardwerte abrufen – Steuer/Währung/Kanal holen.
- Alle Stammdaten synchronisieren (Dashboard) – Stammdaten synchronisieren.
- Zahlungsarten-Mapping im Hub für
SHOPWARE6einrichten. - Aufgabenwarteschlangenposten erstellen – automatische Verarbeitung einrichten und aktivieren.