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
API-URL, Zugangsdaten und Sync-Schalter gehören zum jeweiligen Shop (siehe Shops (Multi-Shop)), nicht 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-Einrichtung
- Über die Shopware 6-Artikelkarte → Aktion Einstellungen
- Ü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 Shops verwalten). |
| Automatisierung | Status der Aufgabenwarteschlange – zeigt, ob die Hintergrundaufgaben eingerichtet und bereit sind. Drill-down öffnet die Einträge. Daneben Datenübernahme: wie viele Schritte der einmaligen Übernahme schon gelaufen sind, gezählt je aktiviertem Shop und Schritt. Nicht gestartet ist der Normalzustand eines Shops, der neu in Business Central beginnt, und bleibt ohne Farbe; eine halb fertige Übernahme ist gelb, eine vollständige grün. Ein Klick öffnet die Datenübernahme. |
| Lizenz | Lizenz-FactBox zum Modul SHOPWARE6. |
Feldreferenz (globale Defaults)
| Bereich | Felder |
|---|---|
| Auftragsimport | Auftragsimport aktiviert |
| Synchronisation | Artikelaktualisierungen je Lauf (leer = 100) |
| Steuer & Währung | Standard-Steuer, Standard-Steuersatz (Standard 19), Standard-Währung |
| Beschreibung | Beschreibungsvorlage (Standardvorlage für generierte Beschreibungen) |
| Verkaufskanal | Verkaufskanal (Pflicht für SEO-URL-Upload) |
| Varianten | Variantenquelle (ab Version 1.81; Artikel oder Artikelvarianten, je Mandant; nur umstellbar, solange kein Varianten-Master existiert und kein Artikel je Variante gelistet ist – siehe Varianten-Master), Varianten-Container-Suffix (Standard M) |
| Benutzerdefinierte Felder | Benutzerdefiniertes Feld 1/2 (Ja/Nein) und Benutzerdefinierter Text 1/2 – je API-Name und Bezeichnung |
| Produktdokumente | Feldname Produktdokumente (Standard ad_documents), Feldname Datenblatt-URL (ad_datasheet_url) |
| Cross-Selling | Cross-Selling-Gruppenname (Zubehör) und (Ähnlich) |
| Stammdaten-Bilder | Stammdaten-Bildmodus (Deaktiviert / URL speichern / Hub-Medienspeicher) |
| Prozess | Statusänderung bei Versand unterdrücken, Zahlungsstatus bei Versand automatisch setzen, Automatische Gutschrift bei Retoure, Dokumente in den Shop hochladen (PDF der gebuchten Rechnung oder Gutschrift an die Shop-Bestellung) – die Versandmeldung sendet die Aufgabenwarteschlange POSTSYNC nach dem Buchen; als bezahlt markiert sie den Auftrag erst mit der Lieferung, die den Rest des Auftrags versendet, nicht bei einer Teillieferung, siehe gebuchte Lieferung |
| Webhooks | Webhook-Basis-URL (Azure-Function-Endpunkt) |
| Status | Simulationsmodus (ob die aktivierten Shops live oder im Simulationsmodus laufen; ein Klick öffnet die Shops), Letzte Auftragssynchronisierung, Letzte Artikelsynchronisation, Letzter Sync-Fehler (rot hervorgehoben) und Letzter Sync-Fehler (Datum/Zeit) – nur Anzeige |
Preise: Preise stellen Sie hier nicht ein. Sie kommen ausschließlich aus der Verkaufspreisliste, die dem Verkaufskanal des Shops in merchantCENTRAL zugeordnet ist – siehe Preise aus merchantCENTRAL.
Eigenständige Shops (z. B. anderes Land oder eigener Server) haben eigene Kataloge: Standard-Steuer, Standard-Währung und Verkaufskanal sind Shopware-UUIDs des jeweiligen Shops. Ein solcher Shop setzt auf seiner Shop-Karte eigene Werte. Erbt er einen Wert, den sein synchronisierter Katalog nicht kennt, bricht der Upload mit einem Konfigurationsfehler ab, der zu den Shops führt.
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 Zahlungszuordnungen des Hubs 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. |
| Datenübernahme | Öffnet die einmalige Übernahme eines Shops, der schon vor Business Central live war (Produkte, Zuordnungen, Bilder, Cross-Selling, Aktionen, Kunden, historische Aufträge). |
| Verbindung testen | Testet die Verbindung des kanonischen Shops (MAIN) per authentifiziertem Aufruf (api/_info/config). |
| Shop-Standardwerte aktualisieren | Liest Standard-Steuer, Standard-Währung und Verkaufskanal über die Shopware-API aus dem Shop und trägt sie ein. |
| Aufgabenwarteschlangenposten erstellen | Erstellt die Standard-Job-Queue-Einträge für die automatische Synchronisation: in der Kategorie MC6-ORDER ORDER (alle 5 Minuten), WEBHOOK (1) und POSTSYNC (5), in der Kategorie MC6-SYNC SYNC (2), QTY (10), PRICE-QTY (15), CHECK (10), WORKQUEUE (2), CROSSSELLING (60) und ab Version 1.81 IMPORTCATEGORIES (jede Nacht um 01:05, siehe Kategorien). Vorhandene Einträge bleiben, wie sie sind. |
| 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) läuft über das Dashboard, der Download aller Produkte aus dem Shop über die Datenübernahme (Schritt Alle Produkte).
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 aktualisieren – Steuer/Währung/Kanal holen.
- Alle Stammdaten synchronisieren (Dashboard) – Stammdaten synchronisieren.
- Zahlungszuordnungen im Hub für
SHOPWARE6einrichten. - Aufgabenwarteschlangenposten erstellen – automatische Verarbeitung einrichten und aktivieren.