Docs/Integrations/WooCommerce
W

WooCommerce Integration

Coming Soon

WordPress Plugin für XRechnung und ZUGFeRD. Open Source und vollständig anpassbar für deinen WooCommerce-Shop.

WordPress Plugin in Entwicklung

Unser offizielles WooCommerce Plugin ist aktuell in Entwicklung. In der Zwischenzeit kannst du invoice.xhub über WooCommerce Webhooks oder eigene PHP-Hooks integrieren.

Features

WordPress Plugin

Einfache Installation über das WordPress Plugin-Verzeichnis

WooCommerce Hooks

Nahtlose Integration mit allen WooCommerce-Events

Open Source

Plugin-Code auf GitHub verfügbar zur Anpassung

HPOS-kompatibel

Unterstützt High-Performance Order Storage

PHP Hook Integration

Verfügbare WooCommerce Hooks

Nutze WooCommerce Action Hooks um bei Bestellungen automatisch E-Rechnungen zu erstellen.

woocommerce_order_status_completed

Bestellung abgeschlossen

woocommerce_payment_complete

Zahlung eingegangen

woocommerce_new_order

Neue Bestellung erstellt

woocommerce_checkout_order_processed

Checkout abgeschlossen

php
1// WooCommerce Hook für E-Rechnung
2add_action('woocommerce_order_status_completed', 'create_einvoice', 10, 1);
3 
4function create_einvoice($order_id) {
5    $order = wc_get_order($order_id);
6 
7    // Nur für B2B mit USt-ID
8    $vat_id = $order->get_meta('_billing_vat_id');
9    if (empty($vat_id)) return;
10 
11    $invoice_data = [
12        'type' => 'xrechnung-3.0',
13        'seller' => [
14            'name' => get_option('woocommerce_store_name'),
15            'vatId' => get_option('xhub_seller_vat_id'),
16            'address' => [
17                'street' => WC()->countries->get_base_address(),
18                'city' => WC()->countries->get_base_city(),
19                'zip' => WC()->countries->get_base_postcode(),
20                'country' => WC()->countries->get_base_country()
21            ]
22        ],
23        'buyer' => [
24            'name' => $order->get_billing_company(),
25            'vatId' => $vat_id,
26            'address' => [
27                'street' => $order->get_billing_address_1(),
28                'city' => $order->get_billing_city(),
29                'zip' => $order->get_billing_postcode(),
30                'country' => $order->get_billing_country()
31            ]
32        ],
33        'items' => array_map(function($item) {
34            return [
35                'description' => $item->get_name(),
36                'quantity' => $item->get_quantity(),
37                'unitPrice' => $item->get_total() / $item->get_quantity(),
38                'vat' => 19
39            ];
40        }, $order->get_items()),
41        'reference' => $order->get_order_number()
42    ];
43 
44    // API Call zu invoice.xhub
45    wp_remote_post('https://api.invoice.xhub.io/api/v1/invoice/de/xrechnung/generate', [
46        'headers' => [
47            'Authorization' => 'Bearer ' . get_option('xhub_api_key'),
48            'Content-Type' => 'application/json'
49        ],
50        'body' => json_encode($invoice_data)
51    ]);
52}

Webhook Integration

Alternativ kannst du WooCommerce Webhooks nutzen und mit einer Automatisierungsplattform wie n8n oder Make.com verbinden.

  1. 1

    Webhook in WooCommerce erstellen

    WooCommerce → Einstellungen → Erweitert → Webhooks

  2. 2

    n8n/Make Workflow erstellen

    Webhook empfangen und Daten transformieren

  3. 3

    invoice.xhub API aufrufen

    E-Rechnung erstellen und zurück an WooCommerce

json
1// Alternative: WooCommerce Webhooks
2// Einstellungen → WooCommerce → Erweitert → Webhooks
3 
4// Webhook erstellen:
5// - Name: "E-Rechnung bei Zahlung"
6// - Status: Aktiv
7// - Thema: "Bestellung aktualisiert"
8// - Lieferungs-URL: https://your-n8n.com/webhook/woo-invoice
9 
10// Payload enthält komplette Bestelldaten:
11{
12  "id": 12345,
13  "status": "completed",
14  "billing": {
15    "company": "Musterfirma GmbH",
16    "address_1": "Musterstraße 123",
17    "city": "Berlin",
18    "postcode": "10115",
19    "country": "DE"
20  },
21  "meta_data": [
22    { "key": "_billing_vat_id", "value": "DE123456789" }
23  ],
24  "line_items": [...]
25}

Anwendungsfälle

B2B-Shop

Automatische XRechnung für Geschäftskunden mit USt-ID

  1. 1USt-ID Feld im Checkout hinzufügen
  2. 2Hook bei Zahlungseingang
  3. 3XRechnung über invoice.xhub erstellen
  4. 4PDF an Bestellbestätigung anhängen

Großhandel

ZUGFeRD-Rechnungen für Wiederverkäufer

  1. 1Wholesale-Plugin erkennt B2B-Kunden
  2. 2Automatische ZUGFeRD EXTENDED
  3. 3Versand mit Lieferschein
  4. 4GoBD-konforme Archivierung

Multivendor

E-Rechnungen für Marketplace-Verkäufer

  1. 1Dokan/WCFM Vendor erkannt
  2. 2Separate Rechnung pro Vendor
  3. 3XRechnung mit Vendor-Daten
  4. 4Automatische Provision-Abrechnung

Benachrichtigt werden wenn das Plugin verfügbar ist?

Trage dich ein und wir informieren dich sobald das offizielle WooCommerce Plugin im WordPress Plugin-Verzeichnis verfügbar ist.