Docs/Integrations/Shopware
S

Shopware Integration

Coming Soon

Native Integration für Shopware 6. Nutze den Flow Builder für automatische E-Rechnungen – optimiert für B2B und Enterprise.

Shopware 6 Plugin in Entwicklung

Unser offizielles Shopware 6 Plugin ist aktuell in Entwicklung. In der Zwischenzeit kannst du invoice.xhub über den Flow Builder mit Webhooks und n8n/Make.com integrieren.

Features

Shopware 6 Plugin

Native Integration für Shopware 6 über das Plugin-System

Flow Builder

E-Rechnungen direkt im Shopware Flow Builder konfigurieren

B2B Suite

Optimiert für Shopware B2B Suite und Großhandel

Rule Builder

Bedingungsbasierte E-Rechnung mit dem Rule Builder

Flow Builder Integration

Verfügbare Flow Events

Nutze den Shopware Flow Builder um E-Rechnungen basierend auf Shop-Events zu erstellen.

checkout.order.placed

Neue Bestellung aufgegeben

state_machine.order.state_changed

Bestellstatus geändert

state_machine.order_transaction.state_changed

Zahlungsstatus geändert

state_machine.order_delivery.state_changed

Lieferstatus geändert

json
1// Shopware Flow Builder Konfiguration
2// Admin → Einstellungen → Shop → Flow Builder
3 
4// Flow: "E-Rechnung bei Zahlung"
5{
6  "name": "E-Rechnung erstellen",
7  "eventName": "state_machine.order_transaction.state_changed",
8  "sequences": [
9    {
10      "actionName": "action.add.order.tag",
11      "config": { "tagId": "einvoice-pending" }
12    },
13    {
14      "actionName": "action.call.webhook",
15      "config": {
16        "url": "https://your-n8n.com/webhook/shopware-invoice",
17        "headers": {
18          "X-Invoice-Type": "xrechnung"
19        }
20      }
21    }
22  ],
23  "conditions": [
24    {
25      "type": "orContainer",
26      "children": [
27        {
28          "type": "toState",
29          "value": { "stateId": "paid" }
30        }
31      ]
32    }
33  ]
34}

Webhook → invoice.xhub

Verbinde den Shopware Flow Builder mit invoice.xhub über eine Automatisierungsplattform.

  1. 1

    Flow im Flow Builder erstellen

    Trigger: Zahlungsstatus → Bezahlt

  2. 2

    Webhook Action hinzufügen

    URL zu n8n/Make Workflow

  3. 3

    Daten transformieren

    Shopware-Format → invoice.xhub-Format

  4. 4

    E-Rechnung erstellen

    POST /api/v1/invoice/de/xrechnung/generate an invoice.xhub API

typescript
1// Shopware Admin API → invoice.xhub
2// Webhook empfängt Order-Daten von Shopware
3 
4const shopwareOrder = webhook.payload;
5 
6// Transform zu invoice.xhub Format
7const invoiceData = {
8  type: "xrechnung-3.0",
9  seller: {
10    name: shopConfig.companyName,
11    vatId: shopConfig.vatId,
12    address: {
13      street: shopConfig.address.street,
14      city: shopConfig.address.city,
15      zip: shopConfig.address.zipcode,
16      country: "DE"
17    }
18  },
19  buyer: {
20    name: shopwareOrder.orderCustomer.company
21      || shopwareOrder.orderCustomer.firstName + " " + shopwareOrder.orderCustomer.lastName,
22    vatId: shopwareOrder.orderCustomer.vatIds?.[0],
23    address: {
24      street: shopwareOrder.billingAddress.street,
25      city: shopwareOrder.billingAddress.city,
26      zip: shopwareOrder.billingAddress.zipcode,
27      country: shopwareOrder.billingAddress.country.iso
28    }
29  },
30  items: shopwareOrder.lineItems.map(item => ({
31    description: item.label,
32    quantity: item.quantity,
33    unitPrice: item.unitPrice,
34    vat: item.tax.taxRate
35  })),
36  reference: shopwareOrder.orderNumber
37};
38 
39// POST zu invoice.xhub
40const response = await fetch('https://api.invoice.xhub.io/api/v1/invoice/de/xrechnung/generate', {
41  method: 'POST',
42  headers: {
43    'Authorization': `Bearer ${XHUB_API_KEY}`,
44    'Content-Type': 'application/json'
45  },
46  body: JSON.stringify(invoiceData)
47});

Anwendungsfälle

B2B-Großhandel

Automatische XRechnung für alle B2B-Kunden mit USt-ID

  1. 1B2B-Kundengruppe im Rule Builder
  2. 2Flow bei Zahlungseingang
  3. 3XRechnung mit B2B-Konditionen
  4. 4Peppol-Versand an Großkunden

Multi-Channel

E-Rechnungen für alle Vertriebskanäle

  1. 1Sales Channel erkennen
  2. 2Kanal-spezifische Rechnungsdaten
  3. 3Einheitliches Format über alle Kanäle
  4. 4Zentrale Archivierung

Subscription Commerce

Wiederkehrende E-Rechnungen für Abonnements

  1. 1Subscription-Plugin Integration
  2. 2Monatliche XRechnung automatisch
  3. 3Referenz auf Abo-Vertrag
  4. 4Automatische Peppol-Zustellung

Benachrichtigt werden wenn das Plugin verfügbar ist?

Trage dich ein und wir informieren dich sobald das offizielle Shopware 6 Plugin im Shopware Store verfügbar ist.