Shopware konfigurieren

Die Shopware-Konfiguration verbindet ReadySync mit Ihrem Shopware 6 Shop-System.

Zugangsdaten

In Shopware 6 benötigen Sie einen Administration API Access Key für die Kommunikation zwischen ReadySync und Ihrem Shop.

Access Key erstellen

1. Melden Sie sich im Shopware Administration an.
2. Navigieren Sie zu Einstellungen → System → Integration.
3. Klicken Sie auf "API-Zugänge verwalten" oder "Add API access".
4. Erstellen Sie einen neuen API-Zugang:
   • Label: z.B. "ReadySync"
   • Schreibrechte aktivieren: ✅ Ja (für Produktimport und Media-Upload)
   • Zugriffsrechte: Mindestens folgende Bereiche:
     • product
     • product_media
     • media
     • currency
     • tax
     • order (für Bestellexport)
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

Nach dem Speichern der Zugangsdaten können Sie automatisch Daten aus Shopware laden:

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.

Status nach Export setzen

• Wählen Sie einen Status aus, der nach erfolgreichem Export gesetzt werden soll.
• Dies verhindert, dass dieselben Bestellungen mehrfach exportiert werden.

Verbindung testen

Nach der Konfiguration sollten Sie die Verbindung testen:

1. Wechseln Sie zum Tab "Test".
2. Klicken Sie auf "Verbindung testen".
3. ReadySync prüft:
   • ✅ Erreichbarkeit der Shop-URL
   • ✅ Gültigkeit der Access Key ID
   • ✅ Korrektheit des Secret Keys
   • ✅ Zugriffsrechte für erforderliche API-Endpunkte

::: success Erfolg Wenn alle Tests erfolgreich sind, erscheint eine grüne Erfolgsmeldung. Die Verbindung ist bereit für den Produktimport. :::

Fehler

Falls Tests fehlschlagen, überprüfen Sie:

• Shop-URL korrekt eingegeben? (ohne /api am Ende)
• Access Key ID korrekt kopiert?
• Secret Key korrekt eingegeben? (groß-/kleinschreibungsempfindlich!)
• API-Zugang in Shopware aktiv und mit Schreibrechten?

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 API-Zugang hat keine ausreichenden Berechtigungen. Aktivieren Sie Schreibrechte für product, media und product_media.

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

Nach erfolgreicher Shopware-Konfiguration können Sie:

• Das Mapping konfigurieren
• Den ersten Import durchführen
• Zeitsteuerung einrichten