Appearance
Shopware 6 konfigurieren
Diese Seite beschreibt die Shopware-Einstellungen einer Verbindung. Den allgemeinen Ablauf finden Sie unter Verbindungen.
ReadySync schreibt über die Admin-API von Shopware 6: Produkte, Varianten, Staffelpreise, Kategorien, Verkaufskanäle, Grundpreise, Bilder und Cross-Selling. Bestellungen liest ReadySync aus und setzt danach deren Status.
Zugangsdaten
ReadySync meldet sich mit einer Integration (Access Key ID und Secret Access Key) bei Shopware an.
Access Key erstellen
- Melden Sie sich in der Shopware-Administration an.
- Öffnen Sie Einstellungen → System → Integrationen und klicken Sie auf Integration hinzufügen.
- Vergeben Sie einen Namen, z. B. „ReadySync“.
- Geben Sie der Integration Schreibrechte: entweder als Administrator oder über eine Rolle mit mindestens diesen Bereichen:
productproduct_mediamediacurrencytaxorder(für Bestellexport und Status)category,property_group,product_manufacturer,unit,rule,sales_channel,product_cross_selling, falls Sie Kategorien, Varianten, Hersteller, Grundpreise, Staffelpreise, Verkaufskanäle oder Cross-Selling nutzen
- Nach dem Speichern werden Ihnen folgende Daten angezeigt:
- Access Key ID: Eine alphanumerische Zeichenkette
- Secret Access Key: Ein langer Schlüssel (dieser wird nur einmal angezeigt!)
Wichtig
Der Secret Access Key wird nur einmal angezeigt. Speichern Sie diesen sicher. Falls Sie ihn vergessen, müssen Sie einen neuen API-Zugang erstellen.
Shop-URL ermitteln
Die Shop-URL ist die Basis-URL Ihres Shopware Shops:
- Format:
https://ihr-shop.de(ohne abschließenden Schrägstrich) - Beispiele:
https://shop.example.comhttps://www.mein-shop.de
Hinweis
Verwenden Sie immer die HTTPS-Version Ihrer Shop-URL, auch wenn HTTP technisch möglich wäre.
Konfiguration in ReadySync
Schritt 1: Basis-Konfiguration
- Öffnen Sie die Verbindungskonfiguration in der Anwendung.
- Wechseln Sie zum Tab Shop.
- Tragen Sie folgende Daten ein:
- Shop-URL: Die Basis-URL Ihres Shopware Shops
- Access Key ID: Die ID aus dem erstellten API-Zugang
- Secret Key: Der Secret Access Key (wird als Passwort-Feld maskiert)
Schritt 2: Shopware-Daten laden
Mit eingetragenen Zugangsdaten lädt ReadySync Auswahllisten aus Ihrem Shop:
- Klicken Sie auf den Button Shopware Daten laden.
- ReadySync lädt folgende Informationen:
- Währungen: Verfügbare Währungen im Shop
- Steuersätze: Konfigurierte Steuersätze (z.B. 19%, 7%)
- Bestellstatus: Verfügbare Bestellstatus
- Zahlungsstatus: Verfügbare Zahlungsstatus
Schritt 3: Standard-Werte festlegen
Standard-Währung
- Wählen Sie die Standard-Währung für Produktimporte aus.
- Diese Währung wird verwendet, wenn keine Währung im Import-File angegeben ist.
Standard-Steuersatz
- Wählen Sie den Standard-Steuersatz aus (z.B. 19% für Deutschland).
- Dieser wird verwendet, wenn kein Steuersatz im Import-File angegeben ist.
Schritt 4: Bestellexport konfigurieren (optional)
Im Abschnitt Bestellexport (Filter & Status) können Sie konfigurieren, welche Bestellungen exportiert werden sollen:
Bestellstatus (Filter)
- Wählen Sie die Bestellstatus aus, die für den Export berücksichtigt werden sollen.
- Nur Bestellungen mit diesen Status werden exportiert.
Zahlungsstatus (Filter)
- Wählen Sie die Zahlungsstatus aus, die für den Export berücksichtigt werden sollen.
Neuer Bestellstatus nach Export
- Wählen Sie einen Status aus, der nach erfolgreichem Export gesetzt werden soll.
- Dies verhindert, dass dieselben Bestellungen mehrfach exportiert werden.
Shopware-Funktionen im Import
| Funktion | Wo einstellen |
|---|---|
| Verkaufskanäle und Sichtbarkeit | Tab Produktimport. Ohne Zuordnung bleiben neue Artikel in der Storefront unsichtbar. |
| Varianten (Eigenschaftsgruppen) | Tab Produktimport und Mapping |
| Staffelpreise mit Preisregel | Tab Produktimport. Ohne Preisregel-ID legt ReadySync die Regel „ReadySync – Staffelpreise“ an. |
| Kategorien unter einer Wurzelkategorie | Tab Produktimport. Die 32-stellige ID der Wurzel sehen Sie in der Adresszeile, wenn Sie die Kategorie in Shopware öffnen. |
| Grundpreis (Inhalt, Bezugsmenge, Einheit) | Mapping |
| Zusatzfelder (Custom Fields) | Mapping-Editor, Bereich Zusatzfelder |
| Hervorheben (Topseller), Bild-Alt-Text, Lieferzeit | Mapping |
| Cross-Selling | Menüpunkt Cross-Selling |
Steuersätze und Einheiten anlegen
ReadySync legt Kategorien, Hersteller, Lieferzeiten und Eigenschaften selbst an, Steuersätze und Maßeinheiten aber nicht. Fehlt ein Steuersatz (z. B. 0 % oder 7 %), importiert ReadySync die Artikel mit dem Standard-Steuersatz der Verbindung und meldet das im Protokoll. Fehlt eine Einheit wie ml, bekommt der Artikel keinen Grundpreis. Legen Sie beides vorab in Shopware an.
Verbindung testen
Wechseln Sie zum Tab Test und klicken Sie auf Test ausführen. Details: Verbindung testen.
Falls der Test fehlschlägt:
- Shop-URL ohne
/apiam Ende eintragen. - Access Key ID und Secret Key neu kopieren, ohne Leerzeichen. Groß- und Kleinschreibung zählt.
- Prüfen, ob die Integration in Shopware Schreibrechte hat.
Häufige Probleme
Problem: "Access denied" oder "401 Unauthorized"
- Lösung: Überprüfen Sie Access Key ID und Secret Key. Beachten Sie Groß-/Kleinschreibung.
Problem: "403 Forbidden"
- Lösung: Der Integration fehlen Rechte. Geben Sie ihr Schreibrechte für die oben genannten Bereiche.
Problem: "Shop-URL konnte nicht erreicht werden"
- Lösung: Prüfen Sie, ob die Shop-URL korrekt ist und der Shop erreichbar ist. Verwenden Sie HTTPS.