Integrationen · n8n
E-Rechnungen in n8n
Der invoapi-Node bringt Erzeugen, Prüfen, Auslesen und Umwandeln in Ihre n8n-Workflows. Dateien kommen als normale n8n-Binärdaten herein und gehen so wieder hinaus — direkt aus einem E-Mail-Anhang, aus Google Drive oder an Ihr Buchhaltungssystem.

Sechs Operationen
| In n8n | Eingabe | Ergebnis |
|---|---|---|
| Invoice → GenerateRechnung erzeugen | Rechnungsdaten (JSON) | XML oder ZUGFeRD-PDF als Datei, mit Prüfergebnis |
| Document → ValidateE-Rechnung prüfen | XML- oder PDF-Datei | gültig ja/nein, jeder Fehler mit Regel und Erklärung |
| Document → ParseAuslesen | XML- oder PDF-Datei | Rechnungsdaten als JSON |
| Document → Detect FormatFormat erkennen | XML- oder PDF-Datei | Standard, Syntax, Version |
| Document → ConvertUmwandeln | XML- oder PDF-Datei | anderes Format, ZUGFeRD-PDF, HTML oder JSON |
| Invoice → Calculate TotalsSummen berechnen | Rechnungsdaten (JSON) | Netto, USt, Brutto (kostenlos) |
Installieren
Der Node ist bei npm veröffentlicht, der Quellcode liegt offen auf GitHub.
Direkt im Workflow (n8n Cloud und selbst betrieben)
invoapi ist ein von n8n verifizierter Community-Node. Verifizierte Nodes installieren Sie direkt aus der Node-Suche:
- Im Workflow auf „+“ klicken und nach invoapi suchen.
- Den Node auswählen und auf Install klicken. Das dürfen Owner und Admins der n8n-Instanz.
- Fertig: Danach können alle Mitglieder der Instanz den Node in ihren Workflows verwenden.
Taucht der Node nicht auf, sind verifizierte Community-Nodes ausgeschaltet: in n8n Cloud unter Instance settings im Cloud-Dashboard, bei selbst betriebenem n8n über die Umgebungsvariable N8N_VERIFIED_PACKAGES_ENABLED. Alternativ funktioniert auch der Standard-Node „HTTP Request“ mit unserer REST-API.
Selbst betrieben: über Settings → Community Nodes
- In n8n Settings → Community Nodes → Install öffnen (nur Owner oder Admin).
- Als Paketnamen
n8n-nodes-invoapieintragen, „I understand the risks …“ abhaken und installieren. - Fertig: Der Node invoapi erscheint in der Suche beim „+“ im Workflow.
Im Terminal installieren (Docker, Server, Download)
Noch kein n8n? In einer Minute mit Docker
Startet n8n mit dem invoapi-Node. Danach localhost:5678 öffnen.
docker volume create n8n_data
docker run -d --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n n8nio/n8n
docker exec -u node n8n sh -c "mkdir -p ~/.n8n/nodes && cd ~/.n8n/nodes && npm install --omit=peer n8n-nodes-invoapi"
docker restart n8nn8n läuft schon direkt auf dem Server
mkdir -p ~/.n8n/nodes && cd ~/.n8n/nodes && npm install --omit=peer n8n-nodes-invoapin8n läuft schon in Docker
docker exec -u node n8n sh -c "mkdir -p ~/.n8n/nodes && cd ~/.n8n/nodes && npm install --omit=peer n8n-nodes-invoapi"
docker restart n8nErsetzen Sie n8n durch den Namen Ihres Containers; den zeigt docker ps. Version 0.2.0, getestet mit n8n 2.45. Direkter Download: n8n-nodes-invoapi-0.2.0.tgz.
Verbinden
- Einen API-Schlüssel im Dashboard anlegen.
- Im Workflow auf + klicken, nach invoapi suchen und die Aktion wählen, zum Beispiel Generate oder Validate.
- Im Node bei Credential auf Create new credential klicken, den Schlüssel einfügen und speichern. n8n prüft ihn dabei („Connection tested successfully“); das kostet kein Kontingent.
Beispiel-Workflows zum Importieren
Herunterladen, in n8n einen neuen Workflow öffnen, oben rechts auf … → Import from File und die Datei wählen. Notizen im Workflow erklären jeden Schritt.
Weitere Ideen
Eingangsrechnungen automatisch prüfen
E-Mail-Trigger (Anhang) → invoapi Validate → IF valid → gültig: in den Buchhaltungsordner; ungültig: Rückfrage an den Absender mit den Fehlern.
Rechnungen aus Shop oder CRM als XRechnung
Webhook oder Shop-Trigger → Felder zuordnen → invoapi Generate → E-Mail mit der XRechnung an den Kunden.
Rechnungsdaten in eine Tabelle
Ordner- oder Drive-Trigger → invoapi Parse → Google Sheets oder Airtable: Nummer, Datum, Lieferant, Brutto.
Gut zu wissen
- Erzeugen und Prüfen zählen je eine Rechnung auf Ihr Kontingent; Auslesen, Erkennen und Berechnen sind kostenlos.
- Mit Stop on Invalid Invoice stoppt der Workflow mit den Fehlern; sonst läuft er weiter und Sie verzweigen per IF-Node über
valid. - Der Node funktioniert auch als Tool für den AI Agent in n8n, etwa um Summen zu berechnen oder eine Rechnung zu prüfen. Bei selbst betriebenem n8n muss dafür die Variable
N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=truegesetzt sein. - Fehlermeldungen der API erscheinen unverändert in n8n, zum Beispiel bei aufgebrauchtem Kontingent oder ungültigem Schlüssel.
- Die Rechnungsfelder für Generate beschreibt die API-Dokumentation.
Die wichtigsten Einstellungen im Node
Je nach Operation zeigt der Node nur die passenden Felder. Diese Einstellungen entscheiden, was aus einem Workflow herauskommt:
| Einstellung | Werte | Standard |
|---|---|---|
| Invoice Data | JSON des eingehenden Items oder ein JSON-Feld | JSON des Items |
| Format | XRechnung, ZUGFeRD / Factur-X, EN 16931, Peppol BIS Billing, UBL, CII | XRechnung |
| Syntax | Standard des Formats, UBL oder CII | Standard des Formats |
| Output | XML oder PDF (ZUGFeRD, PDF/A-3 mit eingebettetem XML) | XML |
| ZUGFeRD Profile | EN 16931 (Comfort), Basic, Extended, XRechnung | EN 16931 |
| Validate with Official Validator | an oder aus | an |
| Stop on Invalid Invoice | an oder aus | aus |
| Input / Output Binary Field | Name des Binärfelds | data |
Kommen die Rechnungsdaten aus einem Shop oder CRM, ordnen Sie die Felder vorher mit einem Set-Node dem invoapi-Format zu. Generate liefert danach die Datei im Binärfeld und daneben das Prüfergebnis im JSON, sodass ein IF-Node direkt auf valid verzweigen kann.
Schritt für Schritt: Eingangsrechnungen aus dem Postfach prüfen
So ist der mitgelieferte Beispiel-Workflow aufgebaut. Sie können ihn importieren oder selbst nachbauen:
- Einen Trigger Email Trigger (IMAP) anlegen, das Rechnungspostfach verbinden und das Herunterladen von Anhängen einschalten. Anhänge heißen dann
attachment_0,attachment_1und so weiter. - Den invoapi-Node mit Document → Validate anhängen und als Input Binary Field
attachment_0eintragen. Stop on Invalid Invoice bleibt aus. - Einen IF-Node auf
{{ $json.valid }}ist wahr setzen. - Im Zweig „wahr“ die Rechnung ablegen, etwa in Google Drive oder im Buchhaltungsordner. Im Zweig „falsch“ dem Absender schreiben und die Liste
errorsmit Regel und Erklärung einfügen. - Den Workflow aktivieren. Ab jetzt wird jede neue Rechnung im Postfach geprüft, und jede Prüfung zählt eine Rechnung auf Ihr Kontingent.
Fehlerbehebung
- Der Node fehlt in der Suche (selbst betriebenes n8n): Das Paket ist nicht installiert oder n8n wurde danach nicht neu gestartet. In Docker hilft
docker restartmit dem Namen Ihres Containers. - Der Verbindungstest der Zugangsdaten schlägt fehl: Schlüssel neu einfügen und das Feld Base URL auf
https://api.invoapi.delassen. Ändern müssen Sie es nur bei einer eigenen invoapi-Instanz. - Meldung, dass keine Binärdaten gefunden wurden: Der Name im Feld Input Binary Field passt nicht zum vorherigen Node. Bei E-Mail-Anhängen ist es meist
attachment_0, nichtdata. - Der Node fehlt in der Werkzeugliste des AI Agent (selbst betriebenes n8n): Die Variable
N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=truesetzen und n8n neu starten. - Generate meldet BR-CO-25: Es fehlt ein Fälligkeitsdatum (
due_date) oder eine Zahlungsbedingung. Weitere Regeln erklärt der Validator.
Zugangsdaten und Datenschutz
Der API-Schlüssel liegt als Passwortfeld in den n8n-Zugangsdaten (Invoapi API) und wird als Bearer-Token mitgeschickt; er erscheint nicht im Workflow selbst. Legen Sie für n8n einen eigenen Schlüssel an, damit Sie ihn im Dashboard einzeln widerrufen können. Die Rechnungsdaten gehen direkt von Ihrem n8n an die API, werden dort nur für die Dauer der Anfrage verarbeitet und nicht gespeichert. Die fertige Datei liegt danach allein in Ihrem Workflow.
Häufige Fragen zur E-Rechnung in n8n
- Ist der invoapi-Node in n8n Cloud verfügbar?
- Ja. invoapi ist ein von n8n verifizierter Community-Node und lässt sich in n8n Cloud direkt aus der Node-Suche installieren: nach invoapi suchen und auf Install klicken (Owner oder Admin). Bei selbst betriebenem n8n geht das genauso, alternativ über Settings → Community Nodes mit dem Paketnamen n8n-nodes-invoapi.
- Was kostet die E-Rechnung in n8n?
- Der Node ist kostenlos und MIT-lizenziert. Generate und Validate zählen je eine Rechnung auf Ihr invoapi-Kontingent, Parse, Detect Format und Calculate Totals sind kostenlos, ebenso der Verbindungstest der Zugangsdaten. 100 Rechnungen sind einmalig gratis.
- Kann ich ZUGFeRD-PDFs aus E-Mail-Anhängen prüfen?
- Ja. Validate nimmt XML- und PDF-Dateien als n8n-Binärdaten an. Aus einer ZUGFeRD-PDF wird das eingebettete XML entnommen und geprüft. Ein gewöhnliches PDF ohne eingebettetes XML ist keine E-Rechnung und kann nicht geprüft werden.
- Welche Felder braucht Generate?
- Generate erwartet die Rechnung im Format der invoapi-API: Rechnungsnummer, Rechnungsdatum, Verkäufer, Käufer, Positionen und Zahlungsangaben. Für eine gültige XRechnung gehört ein Fälligkeitsdatum oder eine Zahlungsbedingung dazu. Alle Felder beschreibt die API-Dokumentation.

