WooCommerce#

WooCommerce – Eingang via REST-API-Webhook (JSON). Benötigtes Addon: connector_woocommerce.

Überblick#

Orderport empfängt Bestellungen aus WooCommerce-Shops über den eingebauten Webhook-Mechanismus. Beim Order-Create-Event sendet WooCommerce die komplette Bestellung als JSON an Orderport. Orderport normalisiert die WooCommerce-spezifische Struktur und übergibt sie an Ihr Zielformat.

Die Integration unterstützt nur den Eingang. Bestellungen von Orderport zurück in WooCommerce zu schreiben, ist nicht Bestandteil dieser Integration.

Kompatibilität#

Unterstützte Versionen#

Bekannte Einschränkungen#

• Kein Rückweg. Updates, Stornos oder Fulfillment-Statusänderungen werden nicht in WooCommerce zurückgeschrieben.
• order.updated-Webhooks werden zwar akzeptiert, aber wie order.created verarbeitet – Orderport erkennt die Bestellung per Bestellnummer als Duplikat und weist sie ab.
• Coupons, Fee-Lines, Shipping-Lines landen nicht im Standard-Mapping. Bei Bedarf manuell im Feldmapping ergänzen.
• Produktvarianten tauchen als eigene Positionen auf, werden aber nicht separat als Variante markiert.
• Meta-Felder der Bestellung (meta_data) werden nicht standardmäßig extrahiert.

Authentifizierung#

WooCommerce signiert jeden Webhook-Body mit HMAC-SHA256 im Header X-WC-Webhook-Signature. Orderport prüft die Signatur vor der Verarbeitung.

• Auth-Typ in Orderport: HMAC-SHA256
• Header-Name: X-WC-Webhook-Signature
• Secret: wird in WooCommerce beim Anlegen des Webhooks angegeben und muss identisch in Orderport hinterlegt werden

Einrichten in Orderport#

Pipeline anlegen#

1. Pipelines → Neue Pipeline
2. Eingabeformat: WooCommerce, Ausgabeformat nach Ihrem Ziel (openTrans oder JSON)
3. Auto-Mapping vorschlagen lassen und ggf. anpassen
4. Transport wählen

Credential anlegen#

Auf der Pipeline-Detailseite Credentials → Hinzufügen:

• Typ: HMAC-SHA256
• Header-Name: X-WC-Webhook-Signature
• Secret: selbst setzen (mindestens 8 Zeichen); denselben Wert in WooCommerce eintragen

Einrichten im Shop#

Webhook konfigurieren#

1. WooCommerce → Einstellungen → Erweitert → Webhooks → Webhook hinzufügen
2. Name: z. B. "Orderport"
3. Status: Aktiv
4. Thema: Bestellung erstellt (order.created)
5. Auslieferungs-URL: Webhook-URL aus Orderport
6. Geheimnis: identisch mit dem in Orderport hinterlegten HMAC-Secret
7. API-Version: REST API v3

Technische Details#

Eingangs-Payload (Auszug)#

{
  "id": 1234,
  "number": "1234",
  "date_created": "2024-03-15T14:30:00",
  "status": "processing",
  "currency": "EUR",
  "total": "1500.00",
  "total_tax": "239.50",
  "billing": {
    "first_name": "Max",
    "last_name": "Mustermann",
    "company": "Muster GmbH",
    "address_1": "Hauptstr. 1",
    "city": "München",
    "postcode": "80331",
    "country": "DE",
    "email": "bestellung@muster.de"
  },
  "shipping": {
    "first_name": "Max",
    "last_name": "Mustermann",
    "address_1": "Industriestr. 42",
    "city": "München",
    "postcode": "80331",
    "country": "DE"
  },
  "line_items": [
    { "sku": "WIDGET-001", "name": "Premium Widget Blau", "quantity": 10, "price": 150.00, "total": "1500.00" }
  ]
}

Verfügbare Quellfelder#

Signaturprüfung#

Orderport berechnet base64(HMAC-SHA256(raw_body, secret)) und vergleicht zeitkonstant mit X-WC-Webhook-Signature. Bei Fehlschlag: HTTP 401.

Endpoint#

Webhook-URL je Pipeline: https://orderport.app/api/v1/webhook/{token}.

Fehlerbehebung#

Nächste Schritte#

• Feldmapping
• Zugangsdaten
• Duplikatserkennung