WooCommerce konfigurieren

Shop-Adapter

Diese Seite beschreibt nur WooCommerce-spezifische API- und Shop-Einstellungen. Generischer Ablauf: Verbindungen · Adapter-Übersicht.

Die WooCommerce-Konfiguration verbindet ReadySync mit Ihrem WooCommerce-Shop und ermöglicht die automatische Synchronisation von Produkten, Bestellungen und Status-Updates.

Voraussetzungen

• WooCommerce-Shop mit aktivierter REST API (WooCommerce → Einstellungen → Erweitert → REST API)
• Admin-Zugriff auf Ihren WordPress/WooCommerce-Shop
• Für Bildimport zusätzlich: WordPress Application Password

WooCommerce REST API Zugangsdaten anlegen

1. Melden Sie sich in Ihrem WordPress-Backend an.
2. Navigieren Sie zu WooCommerce → Einstellungen → Erweitert → REST API.
3. Klicken Sie auf „Schlüssel hinzufügen".
4. Vergeben Sie eine Beschreibung (z. B. „ReadySync") und wählen Sie den Benutzer sowie die Berechtigungsstufe Lesen/Schreiben.
5. Klicken Sie auf „API-Schlüssel generieren".
6. Kopieren Sie Consumer Key und Consumer Secret – sie werden nur einmal angezeigt.

Konfiguration in ReadySync

Öffnen Sie die Verbindung und wechseln Sie zum Tab Shop. Tragen Sie folgende Felder ein:

Feld	Beschreibung
Shop-URL	Basis-URL Ihres Shops, z. B. https://ihr-shop.de – ohne abschließenden Schrägstrich, immer HTTPS.
Consumer Key	Der generierte Consumer Key (ck_...).
Consumer Secret	Das generierte Consumer Secret (cs_...).
Steuerklasse	WooCommerce-Steuerklasse für importierte Produkte, z. B. standard, reduced-rate oder zero-rate. Entspricht den in WooCommerce definierten Klassen.

Bild-Upload (WordPress Application Password)

WooCommerce API-Schlüssel autorisieren keinen direkten Zugriff auf die WordPress-Medienbibliothek. Für den Bildimport wird ein WordPress Application Password benötigt.

Application Password anlegen

1. Melden Sie sich in WordPress an und öffnen Sie Benutzer → Profil.
2. Scrollen Sie zum Abschnitt „Application Passwords".
3. Geben Sie einen Namen ein (z. B. „ReadySync Medien") und klicken Sie auf „Neues Application Password hinzufügen".
4. Das Passwort wird nur einmal angezeigt – kopieren Sie es sofort.

Tragen Sie dann folgende Felder in ReadySync ein:

Feld	Beschreibung
WordPress-Benutzername	Ihr WordPress-Benutzername (Admin).
Application Password	Das generierte Application Password (Format: xxxx xxxx xxxx xxxx xxxx xxxx).

Hinweis

Ohne Application Password wird der Bildimport automatisch übersprungen. Produktdaten (Name, Preis, Bestand) werden trotzdem synchronisiert.

Bestellexport

Im Abschnitt „Bestellexport" konfigurieren Sie, welche Bestellungen exportiert werden:

Feld	Beschreibung
Bestellstatus (Filter)	Nur Bestellungen mit diesem WooCommerce-Status werden exportiert. Standard: processing (In Bearbeitung).
Neuer Status nach Export	WooCommerce-Status, der nach dem Export gesetzt wird – verhindert mehrfachen Export. Empfehlung: on-hold. Leer lassen für keine Statusänderung.

WooCommerce-Status-Übersicht

Status	Bezeichnung
pending	Ausstehend
processing	In Bearbeitung
on-hold	Wartend
completed	Abgeschlossen
cancelled	Storniert
refunded	Erstattet
failed	Fehlgeschlagen

Status-Updates aus dem ERP

Wenn ReadySync Status-Updates aus Ihrer ERP-Statusdatei in WooCommerce einspielt, muss der Statuswert in der ERP-Datei einem gültigen WooCommerce-Status-String entsprechen (z. B. completed, on-hold).

Die ERP-Statusdatei enthält typischerweise Zeilen im Format Bestellnummer;StatusWert. ReadySync verwendet den Statuswert direkt als WooCommerce-Status. Ungültige Werte werden übersprungen und im Job-Log protokolliert.

Nächste Schritte

• Mapping einrichten – Quellfelder aus Ihrer Import-Datei WooCommerce-Produktfeldern zuordnen
• Import starten – Delta- oder Vollimport ausführen
• Verbindung testen – Shop-Verbindung prüfen