Zum Inhalt springen
Invoapi

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.

n8n-Workflow: Neue Bestellung, Rechnungsdaten, XRechnung erzeugen mit invoapi, Prüfung „Gültig?“, dann Rechnung an den Kunden senden oder die Buchhaltung informieren
Beispiel in n8n: Zu jeder neuen Bestellung entsteht eine geprüfte XRechnung. Gültige gehen an den Kunden, fehlerhafte an die Buchhaltung.

Sechs Operationen

In n8nEingabeErgebnis
Invoice → GenerateRechnung erzeugenRechnungsdaten (JSON)XML oder ZUGFeRD-PDF als Datei, mit Prüfergebnis
Document → ValidateE-Rechnung prüfenXML- oder PDF-Dateigültig ja/nein, jeder Fehler mit Regel und Erklärung
Document → ParseAuslesenXML- oder PDF-DateiRechnungsdaten als JSON
Document → Detect FormatFormat erkennenXML- oder PDF-DateiStandard, Syntax, Version
Document → ConvertUmwandelnXML- oder PDF-Dateianderes Format, ZUGFeRD-PDF, HTML oder JSON
Invoice → Calculate TotalsSummen berechnenRechnungsdaten (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:

  1. Im Workflow auf „+“ klicken und nach invoapi suchen.
  2. Den Node auswählen und auf Install klicken. Das dürfen Owner und Admins der n8n-Instanz.
  3. 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

  1. In n8n Settings → Community Nodes → Install öffnen (nur Owner oder Admin).
  2. Als Paketnamen n8n-nodes-invoapi eintragen, „I understand the risks …“ abhaken und installieren.
  3. 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.

Terminal
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 n8n

n8n läuft schon direkt auf dem Server

Terminal
mkdir -p ~/.n8n/nodes && cd ~/.n8n/nodes && npm install --omit=peer n8n-nodes-invoapi

n8n läuft schon in Docker

Terminal
docker exec -u node n8n sh -c "mkdir -p ~/.n8n/nodes && cd ~/.n8n/nodes && npm install --omit=peer n8n-nodes-invoapi"
docker restart n8n

Ersetzen 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

  1. Einen API-Schlüssel im Dashboard anlegen.
  2. Im Workflow auf + klicken, nach invoapi suchen und die Aktion wählen, zum Beispiel Generate oder Validate.
  3. 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

Die wichtigsten Einstellungen im Node

Je nach Operation zeigt der Node nur die passenden Felder. Diese Einstellungen entscheiden, was aus einem Workflow herauskommt:

EinstellungWerteStandard
Invoice DataJSON des eingehenden Items oder ein JSON-FeldJSON des Items
FormatXRechnung, ZUGFeRD / Factur-X, EN 16931, Peppol BIS Billing, UBL, CIIXRechnung
SyntaxStandard des Formats, UBL oder CIIStandard des Formats
OutputXML oder PDF (ZUGFeRD, PDF/A-3 mit eingebettetem XML)XML
ZUGFeRD ProfileEN 16931 (Comfort), Basic, Extended, XRechnungEN 16931
Validate with Official Validatoran oder ausan
Stop on Invalid Invoicean oder ausaus
Input / Output Binary FieldName des Binärfeldsdata

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:

  1. Einen Trigger Email Trigger (IMAP) anlegen, das Rechnungspostfach verbinden und das Herunterladen von Anhängen einschalten. Anhänge heißen dann attachment_0, attachment_1 und so weiter.
  2. Den invoapi-Node mit Document → Validate anhängen und als Input Binary Field attachment_0 eintragen. Stop on Invalid Invoice bleibt aus.
  3. Einen IF-Node auf {{ $json.valid }} ist wahr setzen.
  4. Im Zweig „wahr“ die Rechnung ablegen, etwa in Google Drive oder im Buchhaltungsordner. Im Zweig „falsch“ dem Absender schreiben und die Liste errors mit Regel und Erklärung einfügen.
  5. 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

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.
n8n E-Rechnung: XRechnung & ZUGFeRD im n8n-Workflow · Invoapi