Skip to content

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 ​

  1. Melden Sie sich in der Shopware-Administration an.
  2. Öffnen Sie Einstellungen → System → Integrationen und klicken Sie auf Integration hinzufügen.
  3. Vergeben Sie einen Namen, z. B. „ReadySync“.
  4. Geben Sie der Integration Schreibrechte: entweder als Administrator oder über eine Rolle mit mindestens diesen Bereichen:
    • product
    • product_media
    • media
    • currency
    • tax
    • order (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
  5. 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.com
    • https://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 ​

  1. Öffnen Sie die Verbindungskonfiguration in der Anwendung.
  2. Wechseln Sie zum Tab Shop.
  3. 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:

  1. Klicken Sie auf den Button Shopware Daten laden.
  2. 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 ​

FunktionWo einstellen
Verkaufskanäle und SichtbarkeitTab Produktimport. Ohne Zuordnung bleiben neue Artikel in der Storefront unsichtbar.
Varianten (Eigenschaftsgruppen)Tab Produktimport und Mapping
Staffelpreise mit PreisregelTab Produktimport. Ohne Preisregel-ID legt ReadySync die Regel „ReadySync – Staffelpreise“ an.
Kategorien unter einer WurzelkategorieTab 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, LieferzeitMapping
Cross-SellingMenü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 /api am 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.

Nächste Schritte ​

ReadySync Dokumentation · Impressum