WooCommerce-kompatible API

Die Plattform bietet eine WooCommerce v3-kompatible API, damit ERP- und MRP-Systeme, die bereits mit WooCommerce kommunizieren, ohne Anpassungen angebunden werden können. Alle Antworten verwenden WooCommerce-Feldnamen und -Konventionen.

Pfade

Pfad	Status
`/wp-json/wc/v3/`	Rückwärtskompatibel, weiterhin aktiv
`/api2/woo/v3/`	Kanonischer Pfad (bevorzugt für Neukonfigurationen)

Beide Pfade liefern identische Antworten. Bestehende Integrationen, die /wp-json/wc/v3/ verwenden, müssen nicht umgestellt werden.

Authentifizierung (OAuth1)

Die WooCommerce-API verwendet OAuth1 mit HMAC-SHA256 — nicht den Bearer-Token der nativen Plattform-API.

Schlüssel erstellen

Melden Sie sich im Admin-Bereich an.
Navigieren Sie zu Einstellungen → API-Schlüssel.
Klicken Sie auf WooCommerce-Schlüssel und dann auf Neuen Schlüssel erstellen.
Notieren Sie Consumer Key und Consumer Secret — beide werden zur OAuth1-Signierung benötigt.

OAuth1-Signierung

Jede Anfrage muss einen korrekt signierten Authorization-Header mit folgenden OAuth-Parametern enthalten:

Parameter	Beschreibung
`oauth_consumer_key`	Consumer Key aus dem Admin-Bereich
`oauth_signature_method`	`HMAC-SHA256`
`oauth_timestamp`	Unix-Zeitstempel
`oauth_nonce`	Zufällige Zeichenkette für Eindeutigkeit
`oauth_version`	`1.0`
`oauth_signature`	Berechnete Signatur

Die meisten WooCommerce-SDKs und HTTP-Clients (z. B. woocommerce-api für Node.js, WooCommerce REST API-Client für PHP) übernehmen die Signierung automatisch.

MRP-System konfigurieren

Gehen Sie in Ihrem MRP-System zu den WooCommerce-Verbindungseinstellungen und tragen Sie folgende Werte ein:

Feld	Wert
Shop-URL	`https://ihr-shop.de`
Consumer Key	Aus dem Admin-Bereich (s. o.)
Consumer Secret	Aus dem Admin-Bereich (s. o.)
API-Version	`v3`
Endpunkt (optional)	`/wp-json/wc/v3` oder `/api2/woo/v3`

Die meisten MRP-Systeme ermitteln den Basispfad automatisch. Falls ein manueller Pfad erforderlich ist, verwenden Sie /wp-json/wc/v3.

Verfügbare Ressourcen

Die WooCommerce-API ist nur lesend (ausschließlich GET). Für Schreibzugriffe nutzen Sie die native Plattform-API.

Ressource	Endpunkt	Beschreibung
Bestellungen	`GET /wp-json/wc/v3/orders`	Liste mit Paginierung
Einzelne Bestellung	`GET /wp-json/wc/v3/orders/:id`	Vollständiges WooCommerce-Format
Produkte	`GET /wp-json/wc/v3/products`	Produktliste
Kategorien	`GET /wp-json/wc/v3/products/categories`	Produktkategorien
Kunden	`GET /wp-json/wc/v3/customers`	Kundenliste
Lagerbestand	`GET /wp-json/wc/v3/inventory/stock`	Lagerbestand pro Produkt
Lager	`GET /wp-json/wc/v3/inventory/warehouses`	Lagerliste
Systemstatus	`GET /wp-json/wc/v3/system_status`	Shop-Info im WooCommerce-Format

Alle Listenendpunkte unterstützen page und per_page und liefern X-WP-Total- und X-WP-TotalPages-Header.

Kunden: Gastkäufer einschließen

Verwenden Sie ?role=all, um sowohl registrierte Kunden als auch Gastkäufer zu erhalten:

GET /wp-json/wc/v3/customers?role=all

Unterschiede zu WooCommerce

Beim Migrieren von einer echten WooCommerce-Installation gibt es einige Unterschiede zu beachten:

Steuern werden aus der Tenant-Konfiguration berechnet

WooCommerce-Bestellantworten enthalten Steuerbeträge. Diese stammen nicht aus einem fest kodierten 19%-Satz, sondern aus dem für diesen Shop konfigurierten Steuersatz. Falls Ihr MRP-System Steuerbeträge mit dem bisherigen WooCommerce-Shop vergleicht, können die Werte nach der Migration abweichen.

Gastkäufer haben negative IDs

Gastkäufer haben in der Kunden-API negative Integer-IDs (z. B. -1001). Diese IDs werden aus den Bestelldaten synthetisiert und sind keine dauerhaften Kundendatensätze. Importieren Sie negative IDs nicht als Kundenstammdaten in Ihr MRP-System.

Nur GET-Anfragen

Schreiboperationen (POST, PUT, DELETE) über die WooCommerce-kompatiblen Pfade werden nicht unterstützt. Das Aktualisieren eines Bestellstatus oder das Anlegen von Produkten muss über die native Plattform-API erfolgen.

Keine Hooks / Webhooks über WooCommerce-Format

WooCommerce-Webhooks werden nicht über die WooCommerce-kompatiblen Endpunkte konfiguriert. Nutzen Sie dafür die Webhook-Verwaltung im Admin-Bereich.

Fehlerbehebung

Problem	Ursache	Lösung
`401 Unauthorized`	OAuth1-Signatur ungültig	Timestamp-Abweichung prüfen; Consumer Key/Secret neu erstellen
Leere Produktliste	Kein aktiver Bestand	Status-Filter entfernen oder aktive Produkte prüfen
Steuerbetrag weicht ab	Tenant-Steuersatz konfiguriert	Einstellungen unter Einstellungen → Steuern im Admin-Bereich prüfen
Gast-ID negativ	Erwartetes Verhalten	Gäste werden aus Bestelldaten synthetisiert — nicht als Kundendatensätze importieren