Docs/Integrations/n8n
n

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-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. 1

    Community Node installieren

    Settings → Community Nodes → Suche nach n8n-nodes-invoice-xhub

  2. 2

    Credentials einrichten

    API Key und Base URL in den Invoice.xhub Credentials hinterlegen

  3. 3

    Node in Workflow einfügen

    Invoice.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-xhub
7 
8# n8n neu starten
9# Der Node erscheint unter "Invoice.xhub" in der Node-Liste

Credentials Setup

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

NameInvoice.xhub API

Beliebiger Name zur Identifikation

API Keysk_test_xxxxxxxxxxxx

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

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

Standard API-Endpoint (vorausgefüllt)

json
1// Credentials JSON Struktur
2{
3  "name": "Invoice.xhub API",
4  "type": "invoiceXhubApi",
5  "data": {
6    "apiKey": "sk_test_xxxxxxxxxxxxxxxxxxxx",
7    "baseUrl": "https://api.invoice.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 unter:
16// https://invoice.xhub.io/dashboard/api-keys

Node Operations

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

Generate

E-Rechnung aus JSON erstellen

Parameter

countryCode(string)– Ländercode (DE, AT, FR, ...)
format(string)– xrechnung, zugferd, factur-x, ...
invoiceData(object)– Rechnungsdaten als JSON
json
1{
2  "operation": "generate",
3  "countryCode": "DE",
4  "format": "xrechnung",
5  "invoiceData": {
6    "invoiceNumber": "INV-2025-001",
7    "invoiceDate": "2025-01-15",
8    "seller": {
9      "name": "ACME GmbH",
10      "vatId": "DE123456789",
11      "address": {
12        "street": "Hauptstraße 1",
13        "city": "Berlin",
14        "postalCode": "10115",
15        "country": "DE"
16      }
17    },
18    "buyer": {
19      "name": "Customer AG",
20      "vatId": "DE987654321",
21      "leitwegId": "991-12345-67"
22    },
23    "lineItems": [{
24      "description": "Beratung",
25      "quantity": 10,
26      "unit": "HUR",
27      "unitPrice": 150.00,
28      "vatRate": 19
29    }],
30    "currency": "EUR",
31    "total": 1785.00
32  }
33}

Parse

Daten aus XML/PDF extrahieren

Parameter

countryCode(string)– Ländercode des Formats
invoiceData(binary/string)– XML-Inhalt oder Binary-Daten
json
1{
2  "operation": "parse",
3  "countryCode": "DE",
4  "invoiceData": "={{ $binary.file.data }}"
5}
6 
7// Response:
8{
9  "success": true,
10  "data": {
11    "invoiceNumber": "INV-2025-001",
12    "invoiceDate": "2025-01-15",
13    "seller": { "name": "ACME GmbH", ... },
14    "buyer": { "name": "Customer AG", ... },
15    "lineItems": [...],
16    "total": 1785.00
17  }
18}

Validate

Gegen XRechnung/ZUGFeRD validieren

Parameter

countryCode(string)– Ländercode für Schema-Auswahl
invoiceData(string)– JSON-String der Rechnungsdaten
json
1{
2  "operation": "validate",
3  "countryCode": "DE",
4  "invoiceData": "={{ JSON.stringify($json.invoice) }}"
5}
6 
7// Response:
8{
9  "success": true,
10  "validation": {
11    "valid": true,
12    "errors": [],
13    "warnings": [],
14    "suggestions": []
15  }
16}

Get Formats

Unterstützte Länder/Formate abrufen

Keine Parameter erforderlich

json
1{
2  "operation": "getFormats"
3}
4 
5// Response:
6{
7  "countries": [
8    { "code": "DE", "formats": ["xrechnung", "zugferd"] },
9    { "code": "AT", "formats": ["zugferd", "ebinterface"] },
10    { "code": "FR", "formats": ["factur-x"] },
11    { "code": "IT", "formats": ["fatturapa"] },
12    ...
13  ]
14}

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

Beispiel-Workflows

Validierungs-Pipeline

Eingehende Rechnungen automatisch validieren und bei Fehlern eskalieren

WebhookInvoice.xhubSlack

Workflow-Struktur

Webhook → Validate → IF(valid) → Response
                         ↓
                   Slack Alert

Test mit curl

bash
1curl -X POST http://localhost:5678/webhook/validate-invoice \
2  -H "Content-Type: application/json" \
3  -d '{
4    "countryCode": "DE",
5    "invoice": {
6      "invoiceNumber": "INV-2025-001",
7      "invoiceDate": "2025-01-15",
8      "seller": { "name": "ACME GmbH", "vatId": "DE123456789" },
9      "buyer": { "name": "Customer AG", "vatId": "DE987654321" },
10      "lineItems": [{ "description": "Beratung", "quantity": 10, "unitPrice": 150 }],
11      "total": 1785.00
12    }
13  }'

Batch-Generierung

Rechnungen aus Datenbank generieren und in S3 speichern

CronPostgreSQLInvoice.xhubS3

Workflow-Struktur

Cron (tägl.) → DB Query → Loop → Generate → S3 Upload

Test mit curl

bash
1# Workflow wird automatisch per Cron getriggert
2# Manueller Test:
3curl -X POST http://localhost:5678/webhook/batch-generate \
4  -H "Content-Type: application/json" \
5  -d '{ "limit": 10 }'

Parse & Store

Eingehende E-Rechnungen parsen und in Google Sheets speichern

IMAPInvoice.xhubGoogle Sheets

Workflow-Struktur

Email Trigger → Parse PDF → Extract Data → Sheets Append

Test mit curl

bash
1# Workflow triggert bei neuen Emails
2# Die geparsten Daten landen automatisch in Google Sheets

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.

DE
XRechnungZUGFeRD

B2G Pflicht seit 2020

2025

AT
ZUGFeRDebInterface

Q2 2026

CH
ZUGFeRD

Q2 2026

FR
Factur-X

B2B Pflicht ab 2026

Q2 2026

IT
FatturaPA

SDI Pflicht

Q2 2026

PL
KSeF

Pflicht ab 2026

Q2 2026

BE
Peppol BIS

Q2 2026

NL
Peppol BISSI-UBL

Q2 2026

Troubleshooting

Häufige Probleme und deren Lösungen.

Jetzt starten

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

GitHub Repositoryn8n Community Nodes Docsn8n.io