WooCommerce Integration¶

HostAdmin übernimmt Bestellungen aus einem externen WooCommerce-Shop automatisch als Kunde + Bestellung.

Übersicht¶

Die WooCommerce-Integration ermöglicht:

Kunden-Matching: Bestehender Kunde wird per E-Mail erkannt, sonst neu angelegt (source = wordpress, status = new)
Artikel-Zuordnung: WooCommerce-SKU wird gegen die Artikelnummer (article_number) einer ServiceDefinition gematcht
Bestellungen: Pro Artikel wird eine CustomerService mit Status order angelegt — sie erscheint automatisch in der bestehenden Bestellungen-Seite im Admin-Panel
Admin-Benachrichtigung: E-Mail an den konfigurierten Shop-Admin bei jeder neuen Bestellung

Anders als bei Stripe gibt es keine bidirektionale Synchronisierung — WooCommerce bleibt das führende System für den Bestellprozess selbst, HostAdmin übernimmt nur das Ergebnis (abgeschlossene Bestellung).

Konfiguration¶

Secret und Enabled-Flag werden in der .env Datei gesetzt:

WOOCOMMERCE_WEBHOOK_SECRET=...
WOOCOMMERCE_WEBHOOK_ENABLED=true

Details zur Einrichtung siehe Webhook Einrichtung.

Workflow¶

Kunde schließt Bestellung im WooCommerce-Shop ab und bezahlt.
WooCommerce setzt die Bestellung auf Status completed und sendet den Webhook order.updated.
HostAdmin matcht/erstellt den Kunden und legt pro Artikel eine CustomerService mit Status order an.
Ein Admin prüft die Bestellung auf der Bestellungen-Seite und aktiviert die Services.

Einschränkungen¶

Nur der Topic order.updated mit Status completed wird verarbeitet — alle anderen Events werden ignoriert.
Domain-Angaben (bei Domain-Artikeln) werden nicht automatisch übernommen und müssen manuell nachgetragen werden.
Fehlgeschlagene Zustellungen wiederholt WooCommerce nicht automatisch (anders als Stripe) — bei Ausfällen muss die Bestellung manuell nacherfasst werden.
WooCommerce liefert Webhooks asynchron über WP-Cron/Action Scheduler aus — bei unzuverlässigem WP-Cron kann die Zustellung deutlich verzögert erfolgen (siehe Webhook Einrichtung).

Siehe auch: WooCommerce Webhook API-Referenz