n8n Integration

Community Node verfügbar

Open-Source Workflow-Automatisierung mit Self-Hosting Option. Perfekt für datenschutzsensible E-Rechnungs-Workflows.

Community Node jetzt verfügbar

Der offizielle n8n-nodes-invoice-api-xhub Community Node ist jetzt im n8n Community Node Registry verfügbar. Installiere ihn direkt in n8n und starte sofort mit der E-Rechnungs-Automatisierung.

Quick Start

In 3 Schritten starten

1
Community Node installieren
Settings → Community Nodes → Suche nach n8n-nodes-invoice-api-xhub
2
Credentials einrichten
API Key und Base URL in den Invoice-api.xhub Credentials hinterlegen
3
Node in Workflow einfügen
Invoice-api.xhub Node hinzufügen und Operation auswählen

bash

1# Installation via n8n UI:
2# Settings → Community Nodes → Install
3 
4# Oder via npm (für selbst-gehostete Instanzen):
5cd ~/.n8n/custom
6npm install n8n-nodes-invoice-api-xhub
7 
8# n8n neu starten
9# Der Node erscheint unter "Invoice-api.xhub" in der Node-Liste

Credentials Setup

Erstelle neue Credentials für den Invoice-api.xhub Node:

NameInvoice-api.xhub API

Beliebiger Name zur Identifikation

API Keysk_test_xxxxxxxxxxxx

Test-Key (sk_test_*) oder Live-Key (sk_live_*)

Base URLhttps://service.invoice-api.xhub.io

Standard API-Endpoint (vorausgefüllt)

json

1// Credentials JSON Struktur
2{
3  "name": "Invoice-api.xhub API",
4  "type": "invoiceXhubApi",
5  "data": {
6    "apiKey": "sk_test_xxxxxxxxxxxxxxxxxxxx",
7    "baseUrl": "https://service.invoice-api.xhub.io"
8  }
9}
10 
11// API Key Formate:
12// sk_test_* → Sandbox/Test-Umgebung
13// sk_live_* → Produktions-Umgebung
14 
15// Den API Key findest du in der Console:
16// https://console.invoice-api.xhub.io

Node Operations

Der Invoice-api.xhub Node bietet 5 Haupt-Operationen für die E-Rechnungs-Verarbeitung.

Generate

E-Rechnung aus JSON erstellen

Parameter

countryCode(options)– Ländercode (DE, AT, CH, FR, IT, ...)

format(options)– xrechnung, zugferd, factur-x, fatturapa, ...

invoiceData(json)– Rechnungsdaten als JSON-Objekt

outputBinary(boolean)– Dokument als Binary ausgeben (Standard: true)

binaryPropertyName(string)– Name der Binary-Property (Standard: data)

includeWarnings(boolean)– Validierungs-Warnungen einschließen

formatOptions(json)– Format-spezifische Optionen (z.B. Template, Profil)

json

1// POST /api/v1/invoice/{countryCode}/{format}/generate
2{
3  "invoice": {
4    "invoiceNumber": "INV-2025-001",
5    "type": "invoice",
6    "issueDate": "2025-01-15",
7    "dueDate": "2025-02-14",
8    "seller": {
9      "name": "ACME GmbH",
10      "vatId": "DE123456789",
11      "street": "Hauptstraße 1",
12      "city": "Berlin",
13      "postalCode": "10115",
14      "countryCode": "DE"
15    },
16    "buyer": {
17      "name": "Customer AG",
18      "vatId": "DE987654321",
19      "street": "Musterweg 5",
20      "city": "München",
21      "postalCode": "80331",
22      "countryCode": "DE"
23    },
24    "items": [{
25      "position": 1,
26      "description": "Beratung",
27      "quantity": 10,
28      "unit": "HUR",
29      "unitPrice": 150.00,
30      "taxRate": 19,
31      "netAmount": 1500.00,
32      "taxAmount": 285.00,
33      "grossAmount": 1785.00
34    }],
35    "currency": "EUR",
36    "subtotal": 1500.00,
37    "total": 1785.00,
38    "taxSummary": [{ "taxRate": 19, "netAmount": 1500.00, "taxAmount": 285.00 }],
39    "paymentTerms": { "dueDays": 30 }
40  }
41}
42 
43// Response:
44{
45  "success": true,
46  "format": "xrechnung",
47  "filename": "INV-2025-001.xml",
48  "mimeType": "application/xml",
49  "hash": "sha256:...",
50  "data": "PD94bWwgdmVyc2lvbj0i..."
51}

Parse

Daten aus XML/PDF mit bekanntem Format extrahieren

Parameter

countryCode(options)– Ländercode (DE, AT, CH, FR, IT, ...)

format(options)– xrechnung, zugferd, factur-x, fatturapa, ...

inputType(options)– binary (aus vorherigem Node) oder base64

binaryPropertyName(string)– Name der Binary-Property (Standard: data)

base64Data(string)– Base64-kodiertes Dokument (bei inputType=base64)

json

1// POST /api/v1/invoice/{countryCode}/{format}/parse
2// Input: Binary-Daten oder Base64-String
3 
4// n8n Expression (Binary Input):
5// inputType: "binary"
6// binaryPropertyName: "data"
7 
8// Response:
9{
10  "success": true,
11  "format": "xrechnung",
12  "hash": "sha256:...",
13  "invoice": {
14    "invoiceNumber": "INV-2025-001",
15    "type": "invoice",
16    "issueDate": "2025-01-15",
17    "dueDate": "2025-02-14",
18    "seller": { "name": "ACME GmbH", ... },
19    "buyer": { "name": "Customer AG", ... },
20    "items": [{ "position": 1, "description": "Beratung", ... }],
21    "currency": "EUR",
22    "subtotal": 1500.00,
23    "total": 1785.00
24  }
25}

Parse (Auto-Detect)

Automatische Erkennung von Land und Format

Parameter

inputType(options)– binary (aus vorherigem Node) oder base64

binaryPropertyName(string)– Name der Binary-Property (Standard: data)

base64Data(string)– Base64-kodiertes Dokument (bei inputType=base64)

json

1// POST /api/v1/invoice/parse
2// Kein countryCode/format nötig — wird automatisch erkannt
3 
4// Response:
5{
6  "success": true,
7  "format": "xrechnung",
8  "hash": "sha256:...",
9  "invoice": {
10    "invoiceNumber": "INV-2025-001",
11    "issueDate": "2025-01-15",
12    ...
13  },
14  "detection": {
15    "format": "xrechnung",
16    "countryCode": "DE",
17    "confidence": 95,
18    "formatMethod": "NAMESPACE",
19    "countrySource": "DOCUMENT",
20    "isAmbiguous": false
21  },
22  "detectedFormat": "xrechnung",
23  "detectedCountry": "DE",
24  "confidence": 95
25}

Validate

Geplant Q2 2026

Gegen länderspezifische Regeln validieren

Parameter

countryCode(options)– Ländercode (DE, AT, CH, FR, IT, ...)

invoiceData(json)– Rechnungsdaten als JSON-Objekt

failOnErrors(boolean)– Node bei Fehlern als fehlgeschlagen markieren

failOnWarnings(boolean)– Node bei Warnungen als fehlgeschlagen markieren

json

1// POST /api/v1/invoice/{countryCode}/validate
2{
3  "invoice": {
4    "invoiceNumber": "INV-2025-001",
5    "type": "invoice",
6    "issueDate": "2025-01-15",
7    ...
8  }
9}
10 
11// Response:
12{
13  "valid": true,
14  "countryCode": "DE",
15  "errors": [],
16  "warnings": [],
17  "errorCount": 0,
18  "warningCount": 0
19}

Get Formats

Unterstützte Länder/Formate abrufen

Parameter

scope(options)– all (alle Länder) oder country (einzelnes Land)

countryCode(options)– Ländercode (DE, AT, CH, FR, IT, ...)

json

1// GET /api/v1/invoice/formats (scope: all)
2// GET /api/v1/invoice/{countryCode}/formats (scope: country)
3 
4// Response (scope: all):
5{
6  "countries": [
7    { "code": "DE", "name": "Germany", "formats": [
8        { "name": "XRechnung", "id": "xrechnung", "mimeType": "application/xml" },
9        { "name": "ZUGFeRD", "id": "zugferd", "mimeType": "application/pdf" },
10        { "name": "PDF", "id": "pdf", "mimeType": "application/pdf" }
11      ]
12    },
13    { "code": "AT", "name": "Austria", "formats": [
14        { "name": "ebInterface", "id": "ebinterface", "mimeType": "application/xml" },
15        { "name": "PDF", "id": "pdf", "mimeType": "application/pdf" }
16      ]
17    },
18    ...
19  ],
20  "totalCountries": 14
21}

Warum n8n?

Self-Hosted

Betreibe n8n auf deiner eigenen Infrastruktur

Open Source

Vollständig quelloffen unter Fair-Code Lizenz

400+ Integrationen

Native Nodes für die beliebtesten Tools

Code-fähig

JavaScript/Python Code direkt im Workflow

Fertige Workflow Templates

Produktionsreife n8n Workflows zum direkten Import. Jedes Template enthält JSON-Workflow, Dokumentation und Beispieldaten.

E-Rechnungen aus Email archivieren

Eingehende E-Rechnungen automatisch empfangen, parsen und in Google Drive archivieren. Dateien werden mit Rechnungsnummer, Datum und Lieferant umbenannt.

5 Min. Setup

XRechnung aus Google Sheets generieren

Konforme XRechnung E-Rechnungen direkt aus einer Google Sheets Tabelle erstellen und automatisch per Email an Kunden versenden.

10 Min. Setup

E-Rechnungen per Drag & Drop validieren

E-Rechnungen über ein einfaches Web-Formular hochladen und sofort Validierungsergebnisse erhalten. Kein curl, keine API-Kenntnisse nötig.

3 Min. Setup

E-Rechnungen aus Email parsen nach Sheets

Strukturierte Rechnungsdaten automatisch aus Email-Anhängen extrahieren und in Google Sheets protokollieren. Keine OCR nötig — 100% genaues Parsing.

5 Min. Setup

WooCommerce Bestellungen als XRechnung

Automatisch konforme XRechnung E-Rechnungen für abgeschlossene WooCommerce-Bestellungen generieren und per Email an Kunden senden.

10 Min. Setup

Multi-Agent Architektur

Für komplexe Szenarien: Baue ein System aus spezialisierten Agents, die zusammenarbeiten.

Webhook

Rechnung empfangen

Coordinator Agent

Anfragen analysieren & routen

Validation

Agent

Generation

Agent

Parsing

Agent

Error Handler Agent

Fehlerdiagnose & Eskalation

Coordinator Agent

Empfängt Anfragen und routet sie an den passenden spezialisierten Agent

Validation Agent

Prüft Rechnungen gegen offizielle XRechnung/ZUGFeRD-Schemas

Generation Agent

Erstellt konforme E-Rechnungen aus JSON-Daten

Error Handler Agent

Analysiert Fehler, versucht Auto-Fixes oder eskaliert zu Menschen

Unterstützte Formate

14 Länder mit verschiedenen E-Rechnungs-Formaten werden unterstützt.

XRechnungZUGFeRD

B2G Pflicht seit 2020

2025

ebInterface

Q2 2026

QR-Rechnung

Q2 2026

Factur-X

B2B Pflicht ab 2026

Q2 2026

FatturaPA

SDI Pflicht

Q2 2026

Facturae

Q2 2026

UBL

Q2 2026

UBL

Q2 2026

PDFSAF-T

Q2 2026

KSeF

Pflicht ab 2026

Q2 2026

ISDOC

Q2 2026

NAV

Q2 2026

e-Factura

Q2 2026

UBL

Q2 2026

Troubleshooting

Häufige Probleme und deren Lösungen.

Jetzt starten

Installiere den Community Node und automatisiere deine E-Rechnungs-Workflows.

GitHub Repository n8n Community Nodes Docs n8n.io

n8n Integration

Community Node jetzt verfügbar

Quick Start

In 3 Schritten starten

Credentials Setup

Node Operations

Generate

Parameter

Parse

Parameter

Parse (Auto-Detect)

Parameter

Validate

Parameter

Get Formats

Parameter

Warum n8n?

Self-Hosted

Open Source

400+ Integrationen

Code-fähig

Fertige Workflow Templates

E-Rechnungen aus Email archivieren

XRechnung aus Google Sheets generieren

E-Rechnungen per Drag & Drop validieren

E-Rechnungen aus Email parsen nach Sheets

WooCommerce Bestellungen als XRechnung

Multi-Agent Architektur

Coordinator Agent

Validation Agent

Generation Agent

Error Handler Agent

Unterstützte Formate

Troubleshooting

API Key ungültig

Validierungsfehler: USt-ID

Binary data not found

Timeout bei großen Dateien

Format nicht unterstützt

Jetzt starten