Docs/Integrations/Shopify

Shopify Integration

Coming Soon

Automatische E-Rechnungen für deinen Shopify-Shop. XRechnung und ZUGFeRD bei jeder Bestellung – ready für die B2B-Pflicht ab 2025.

Shopify App in Entwicklung

Unsere offizielle Shopify App ist aktuell in Entwicklung. In der Zwischenzeit kannst du invoice-api.xhub über Shopify Webhooks und Automatisierungsplattformen wie n8n oder Make.com integrieren.

Features

Automatische E-Rechnung

Bei jeder Bestellung automatisch XRechnung oder ZUGFeRD erstellen

B2B-Erkennung

Automatische Erkennung von B2B-Kunden anhand USt-ID

Peppol-Versand

Direkter Versand an Geschäftskunden via Peppol-Netzwerk

PDF-Anhang

Hybride ZUGFeRD-PDF automatisch an Bestellbestätigung anhängen

Webhook-Integration (Jetzt verfügbar)

Shopify Webhooks

Nutze Shopify Webhooks um bei Bestellungen automatisch E-Rechnungen zu erstellen.

orders/create

Neue Bestellung erstellt

orders/fulfilled

Bestellung versendet

orders/paid

Bestellung bezahlt

customers/create

Neuer Kunde registriert

json
1// Shopify Webhook → invoice-api.xhub
2// Konfiguriere in Shopify Admin → Settings → Notifications → Webhooks
3 
4// Webhook Payload von Shopify (orders/paid)
5{
6  "id": 820982911946154508,
7  "email": "kunde@beispiel.de",
8  "billing_address": {
9    "company": "Musterfirma GmbH",
10    "address1": "Musterstraße 123",
11    "city": "Berlin",
12    "zip": "10115",
13    "country_code": "DE"
14  },
15  "line_items": [
16    {
17      "title": "Premium Widget",
18      "quantity": 2,
19      "price": "99.00"
20    }
21  ],
22  "tax_lines": [
23    { "rate": 0.19, "price": "37.62" }
24  ]
25}

Integration mit n8n/Make

Verbinde Shopify mit invoice-api.xhub über eine Automatisierungsplattform deiner Wahl.

  1. 1

    Shopify Webhook erstellen

    Admin → Settings → Notifications → Webhooks

  2. 2

    Workflow in n8n/Make erstellen

    Trigger: Webhook, Action: HTTP Request

  3. 3

    Daten transformieren

    Shopify-Format → invoice-api.xhub-Format

  4. 4

    E-Rechnung erstellen

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

typescript
1// n8n/Make Workflow: Shopify → invoice-api.xhub
2 
3// 1. Trigger: Shopify Webhook (orders/paid)
4// 2. Transform: Shopify → invoice-api.xhub Format
5// 3. Action: POST https://service.invoice-api.xhub.io/api/v1/invoice/de/xrechnung/generate
6 
7const invoiceData = {
8  type: "zugferd-2.1",
9  seller: {
10    name: "Dein Shop Name",
11    vatId: "DE123456789",
12    address: {
13      street: "Shopstraße 1",
14      city: "Hamburg",
15      zip: "20095",
16      country: "DE"
17    }
18  },
19  buyer: {
20    name: shopifyOrder.billing_address.company,
21    vatId: shopifyOrder.customer.tax_id, // Falls vorhanden
22    address: {
23      street: shopifyOrder.billing_address.address1,
24      city: shopifyOrder.billing_address.city,
25      zip: shopifyOrder.billing_address.zip,
26      country: shopifyOrder.billing_address.country_code
27    }
28  },
29  items: shopifyOrder.line_items.map(item => ({
30    description: item.title,
31    quantity: item.quantity,
32    unitPrice: parseFloat(item.price),
33    vat: 19
34  })),
35  reference: `SHOP-${shopifyOrder.id}`
36};

Anwendungsfälle

B2B-Bestellungen

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

  1. 1Kunde gibt USt-ID bei Checkout an
  2. 2Shopify Webhook bei Zahlungseingang
  3. 3invoice-api.xhub erstellt XRechnung
  4. 4E-Rechnung wird per Email versendet

Behörden-Aufträge

XRechnung mit Leitweg-ID für öffentliche Auftraggeber

  1. 1Leitweg-ID als Custom Field erfassen
  2. 2Bestellung wird aufgegeben
  3. 3XRechnung mit Leitweg-ID erstellen
  4. 4Direkter Versand via Peppol

Hybrid-Rechnungen

ZUGFeRD-PDF für alle Bestellungen als Standard

  1. 1Jede Bestellung triggert Workflow
  2. 2ZUGFeRD 2.1 COMFORT erstellen
  3. 3PDF an Bestätigungsmail anhängen
  4. 4Archivierung in invoice-api.xhub

Benachrichtigt werden wenn die Shopify App verfügbar ist?

Trage dich ein und wir informieren dich sobald die offizielle Shopify App im App Store verfügbar ist.