WooCommerce

Zweck

Der WooCommerce Connector bietet eine umfassende Schnittstelle zur Integration mit der WooCommerce REST-API. Er ermöglicht die Automatisierung von E‑Commerce‑Prozessen, indem Produkte, Bestellungen, Kunden, Gutscheine und weitere Shop‑Daten direkt aus Workflows verwaltet werden.

Mit diesem Connector lassen sich folgende Aufgaben erledigen:

• Produkte verwalten: Produkte inklusive Variationen, Kategorien, Tags und Attributen erstellen, abrufen, aktualisieren und löschen.

• Bestellungen bearbeiten: Bestellungen mit verschiedenen Status abrufen, neue Bestellungen anlegen, bestehende aktualisieren sowie Bestellnotizen und Rückerstattungen verwalten.

• Kundendaten handhaben: Kundeninformationen erstellen, aktualisieren, löschen und abrufen.

• Gutscheine verwalten: Gutscheine erstellen, abrufen, aktualisieren und löschen.

• Massenoperationen durchführen: Batch‑Aktionen ermöglichen die gleichzeitige Erstellung, Aktualisierung oder Löschung mehrerer Produkte, Bestellungen oder Kunden innerhalb eines einzelnen API‑Aufrufs.

Praktische Anwendungshinweise

Paginierte Antworten: Bei Anfragen, die Listen zurückliefern, ist die Ausgabe paginiert. Seite (page) und Anzahl der Elemente pro Seite (per_page) lassen sich steuern. Zur Abfrage der Gesamtanzahl und Gesamtseiten müssen die Response‑Header X-WP-Total und X-WP-TotalPages über die Option „Header ausgeben“ aktiviert werden. Weitere Seiten müssen durch Inkrementieren der page‑Variable manuell abgerufen werden.

Batch‑Operationen: Batch‑Aktionen wie BatchProducts oder BatchCustomers erlauben effiziente Mehrfachoperationen (Erstellen, Aktualisieren, Löschen) in einem einzelnen API‑Aufruf.

Authentifizierung

• URL: Basis‑URL des WooCommerce‑Shops (z. B. https://yourshop.com).

• Consumer Key: Für die REST‑API generierter Schlüssel.

• Consumer Secret: Zum Consumer Key gehörendes Secret.

Diese Daten werden bei jeder API‑Anfrage automatisch als Query‑Parameter zur Authentifizierung hinzugefügt.

Erwartungen an Ein‑ und Ausgabe

Eingabe

• Pfad‑Parameter: Für Aktionen auf Einzelressourcen (z. B. „Bestellung abrufen“) ist die Ressource‑ID (id) erforderlich.

• Query‑Parameter: Zum Filtern und Paginieren können optionale Parameter wie page, per_page, status oder search genutzt werden.

• JSON‑Body:

  • Bei einzelnen Elementen enthält das data‑Objekt die Attribute der Ressource.

  • Batch‑Aktionen erfordern ein data‑Objekt mit folgender Struktur:

Beispiel: Batch‑Payload

{
  "create": [ /* ... */ ],
  "update": [ /* ... */ ],
  "delete": [ /* ... */ ]
}

Ausgabe

• response: Enthält die API‑Antwort als JSON‑Objekt; bei Listen als Array von Elementen.

• header: Enthält die Response‑Header, die Paginierungsdetails enthalten, sofern aktiviert.

• createResponseDataStructure: Unterstützt die Abbildung von Daten aus der response auf nachfolgende Workflow‑Schritte.

Hinweise zur Nutzung

• Achte darauf, bei paginierten Ressourcen die Headerausgabe zu aktivieren, wenn du Gesamtanzahl/Gesamtseiten automatisch auslesen möchtest.

• Verwende Batch‑Endpunkte für große Mengen von Änderungen, um die Anzahl der API‑Aufrufe zu reduzieren und Performance zu verbessern.