PDF-Rechnungen und Gutschriften stapelweise in ZUGFeRD umwandeln: n8n-Workflow mit Prüfseite
Eine Hausverwaltung schreibt jeden Monat Provisionsgutschriften an Makler und Rechnungen über die Verwaltungsvergütung, alles als PDF aus Word oder dem Verwaltungsprogramm. Ab 2027 sollen daraus E-Rechnungen werden. Jede Datei einzeln hochladen, prüfen und herunterladen kostet bei zwanzig Belegen im Monat einen halben Vormittag. Mit einer kleinen Seite in n8n geht es in einem Durchgang: alle PDFs hineinziehen, jeden Beleg neben dem Original prüfen, am Ende alle als ZUGFeRD-Rechnung herunterladen, gesammelt in einer ZIP-Datei.
Das Video: acht Belege in drei Minuten
Im Video arbeitet die erfundene Fabulus Immobilienverwaltung acht Belege ab: drei Rechnungen, fünf Gutschriften, vier davon mit einem Fehler. Hier steht, was dabei im Hintergrund passiert und wo Sie den Workflow anpassen. Workflow, Seite und die acht Beispiel-PDFs aus dem Video können Sie herunterladen und selbst ausprobieren.
1. So läuft es ab
- Hochladen. Sie ziehen alle PDFs auf einmal in die Seite. Die Seite schickt jede Datei einzeln an n8n, drei gleichzeitig, und finisma liest sie aus. Ein Beleg dauert ein paar Sekunden.
- Sortieren. Die Liste zeigt Belegnummer, Art (Rechnung oder Gutschrift), Partner, Betrag und Status. Belege ohne Befund stehen auf „bereit zur Prüfung“, die anderen zeigen, wie viele Fehler oder Hinweise finisma gefunden hat.
- Prüfen. Ein Klick öffnet den Beleg: links das Original, rechts die ausgelesenen Daten zum Bearbeiten. Sie vergleichen, korrigieren, wo nötig, und haken ab. Solange ein Fehler offen ist, lässt sich der Haken nicht setzen.
- ZIP. Sind alle abgehakt, schickt die Seite die Belege mit den geprüften Daten zurück an n8n. finisma bettet die Daten als XML in jede Original-PDF ein, und Sie bekommen eine ZIP mit allen Dateien.
Das Ergebnis sieht aus wie die PDF vorher, trägt aber die E-Rechnung im Profil EN 16931 in sich. Das ist ZUGFeRD. Jede Datei hat finisma vor der Auslieferung gegen PDF/A-3 und die Geschäftsregeln der EN 16931 geprüft. Bei unserem Test am 16. November 2026 waren alle acht Dateien gültig, ohne Fehler und ohne Warnung.
2. Was Sie brauchen
- Eine selbst gehostete n8n-Instanz mit aktivierten Community Nodes. In n8n Cloud läuft der finisma-Node erst, wenn n8n ihn verifiziert hat.
- Den Community-Node
n8n-nodes-zugferd-finismaab Version 0.4.0. Die n8n-Dokumentation beschreibt die Installation. - Ein finisma-Konto mit API-Key und Abo oder Guthaben. Das Auslesen nutzt ein Sprachmodell und ist deshalb nicht im kostenlosen Kontingent. Den Key erzeugen Sie unter finisma.de/konto, die Preise stehen in Abschnitt 8.
Wer nur ab und zu einen Beleg hat, braucht dafür kein n8n. Einzelne Dateien können Sie auf der Startseite kostenlos von PDF in E-Rechnung umwandeln, ohne Anmeldung.
3. Workflow importieren und starten
- Community-Node installieren. In n8n unter Settings → Community Nodes das Paket n8n-nodes-zugferd-finisma ab Version 0.4.0 installieren.
- Workflow importieren. Die Datei belege-zu-e-rechnungen.json herunterladen und im n8n-Editor über „Import from File“ laden.
- Zugangsdaten hinterlegen. In beiden finisma-Nodes ein Credential mit Ihrem finisma-API-Key anlegen. Den Key erzeugen Sie unter finisma.de/konto.
- Seite anpassen. Im Node „Übersichtsseite zeigen“ oben im Script Firmenname und Namen der ZIP-Datei eintragen. Das ist optional.
- Veröffentlichen und öffnen. Den Workflow veröffentlichen und die Produktions-URL des Webhooks im Browser öffnen, also https://ihre-instanz/webhook/belege.
Nehmen Sie die Produktions-URL. Die Test-URL beantwortet genau eine Anfrage, die Seite stellt aber für jeden Beleg eine eigene. Zum Ausprobieren laden Sie die acht Beispiel-Belege aus dem Video herunter, entpacken sie und ziehen alle in die Seite. Vier davon haben einen eingebauten Fehler, Sie sehen also gleich, wie die Befunde aussehen.
4. Die Nodes: ein Webhook, drei Wege
Der ganze Workflow hängt an einem Webhook mit dem Pfad belege. Die Seite ruft immer dieselbe URL auf und unterscheidet nur die HTTP-Methode. So braucht sie keine Konfiguration: Sie kennt ihre eigene Adresse aus location.pathname.
| Node | Weg | Aufgabe |
|---|---|---|
| Webhook | alle | Ein Pfad, drei Methoden: GET liefert die Seite, POST nimmt eine PDF zum Auslesen, PATCH nimmt alle geprüften Belege. |
| Übersichtsseite zeigen | GET | Schickt die Prüfseite als HTML zurück. Die Seite ist komplett in diesem Node enthalten. |
| PDF übernehmen | POST | Nimmt die hochgeladene PDF aus dem Request und legt sie in das Binärfeld data. |
| Daten auslesen (finisma) | POST | finisma-Node, Operation Extract: liefert die Rechnungsdaten nach EN 16931 und die Befunde. |
| Ergebnis an die Seite | POST | Gibt Daten und Befunde als JSON an die Seite zurück, im Fehlerfall die Meldung der API. |
| Belege vorbereiten | PATCH | Macht aus jedem geprüften Beleg ein Item: Original-PDF als Binärdatei, korrigierte Daten als JSON. |
| E-Rechnung erzeugen (finisma) | PATCH | finisma-Node, Operation Create mit Quelle PDF: bettet die Daten als XML in die Original-PDF ein. |
| Für ZIP sammeln | PATCH | Sammelt alle fertigen Dateien in einem Item und merkt sich, welche Belege gescheitert sind. |
| Alle erzeugt? | PATCH | Nur wenn jeder Beleg geklappt hat, geht es weiter zur ZIP. Sonst bekommt die Seite die Fehlerliste. |
| ZIP packen, ZIP herunterladen | PATCH | Compression-Node packt alle Dateien, der Respond-Node schickt die ZIP als Download. |
Für PATCH schickt die Seite alle abgehakten Belege in einem JSON. Die Original-PDF reist als Base64 mit, weil n8n zwischen zwei Anfragen nichts aufbewahrt:
{
"documents": [
{
"filename": "04-Gutschrift-GS-2026-0412.pdf",
"pdf_base64": "JVBERi0xLjcK...",
"invoice": { "documentTypeCode": "389", "invoiceNumber": "GS-2026-0412", "...": "..." }
}
]
}Beide finisma-Nodes stehen unter Settings auf „On Error: Continue“. Scheitert ein Beleg, läuft der Workflow weiter, und „Für ZIP sammeln“ schreibt den Dateinamen mit der Meldung der API in eine Liste. Die Seite zeigt diese Liste an, und Sie wissen, welcher Beleg noch einmal angefasst werden muss. Eine halbe ZIP gibt es nicht.
5. Gutschriften: der Makler ist der Verkäufer
Bei einer Provisionsgutschrift schreibt die Hausverwaltung das Dokument, geleistet hat aber der Makler. Das ist das Gutschriftverfahren, im Gesetz Abrechnung durch den Leistungsempfänger (§ 14 Abs. 2 Satz 2 UStG). Umsatzsteuerlich ist so eine Gutschrift eine Rechnung des Maklers, nur dass ein anderer sie ausgestellt hat.
In der E-Rechnung hat das zwei Folgen. Der Dokumenttyp ist 389 (Selbstfakturierung). Und als Verkäufer steht der Makler drin, als Käufer die Hausverwaltung, obwohl oben im Briefkopf die Hausverwaltung steht. Wer das Dokument naiv ausliest, bekommt die Rollen genau falsch herum, und die Steuernummer der Hausverwaltung landet beim Verkäufer.
finisma erkennt das Gutschriftverfahren am Text, etwa an „im Gutschriftverfahren“ oder an einem Feld „Leistender“ zusammen mit einem Auszahlungsbetrag. Dann setzt finisma den Typ 389, tauscht die Rollen und nimmt die IBAN des Maklers als Zahlungskonto. Steht eine Rechnungsnummer als Bezug drin, bleibt es bei einer Rechnungskorrektur (381). Was eine Gutschrift im Sinne einer Korrektur ausmacht, steht im Artikel Gutschrift als E-Rechnung.
6. Was finisma vor dem Erzeugen meldet
Vier der acht Beispiel-Belege haben einen typischen Fehler. finisma meldet jeden davon beim Auslesen. Mit einem Fehler würde finisma die E-Rechnung nicht erzeugen, deshalb lässt die Seite den Beleg erst abhaken, wenn er behoben ist. Die beiden Hinweise hier betreffen Pflichtangaben nach dem Umsatzsteuergesetz, die das Format selbst nicht erzwingt. Die Seite zeigt sie an, entscheiden müssen Sie:
| Im Beleg | Befund | Art | Was Sie tun |
|---|---|---|---|
| Netto plus Steuer ergibt nicht den Bruttobetrag | Rechenfehler beim Gesamtbetrag | Fehler | Den richtigen Betrag eintragen. Im Video: 406,98 € statt 409,98 €. |
| Gutschrift ohne Steuernummer oder USt-IdNr. des Maklers | USt-IdNr. oder Steuernummer des Verkäufers fehlt | Fehler | Die Nummer aus den eigenen Stammdaten nachtragen. Pflichtangabe nach § 14 Abs. 4 Nr. 2 UStG. |
| Dokument heißt „Provisionsabrechnung“, das Wort Gutschrift fehlt | Angabe „Gutschrift“ fehlt bei Selbstfakturierung | Hinweis | „Gutschrift“ als Hinweis ergänzen und die Vorlage anpassen. Pflicht nach § 14 Abs. 4 Nr. 10 UStG. |
| Weder Leistungsdatum noch Leistungszeitraum | Leistungsdatum fehlt | Hinweis | Datum der Leistung eintragen, bei Vermittlungen etwa den Mietbeginn. Pflicht nach § 14 Abs. 4 Nr. 6 UStG. |
Die beiden Hinweise fallen bei einer Sichtprüfung kaum auf, weil das Dokument sonst vollständig aussieht. Ohne die Angaben gilt die Gutschrift aber nicht als ordnungsgemäße Rechnung. Das fehlende Wort „Gutschrift“ ist dabei der häufigste Fall: Viele Vorlagen heißen Provisionsabrechnung oder Abrechnung, und das reicht nicht. Die Korrektur in der Seite rettet den einzelnen Beleg, auf Dauer gehört das Wort in die Vorlage.
Was die Seite nicht kann: einen Beleg inhaltlich bewerten. Ob die Provision stimmt oder die Sollmiete, prüft weiterhin ein Mensch. Dafür steht das Original direkt neben den Daten.
7. Seite anpassen und absichern
Name und ZIP-Datei
Die Seite steckt komplett im Node „Übersichtsseite zeigen“. Oben im Script stehen drei Werte:
// ===== Hier anpassen =====
const SEITE = {
firma: "Muster GmbH", // Name oben links
zeile: "Buchhaltung", // Zeile darunter
zip: "e-rechnungen.zip", // Name der ZIP-Datei
};Die Seite gibt es auch als einzelne HTML-Datei. Sie ist identisch mit dem Inhalt des Nodes und zum Lesen und Bearbeiten im Editor gedacht. Direkt im Browser geöffnet funktioniert sie nicht, weil sie ihre Daten von der Webhook-URL holt.
Zugriff beschränken
Die Seite hat keine eigene Anmeldung. Wer die URL kennt, kann Belege auf Ihr Kontingent auslesen. Beschränken Sie den Zugriff deshalb im Webhook-Node unter Options → IP(s) Allowlist auf Ihr Büro oder Ihr VPN, oder betreiben Sie die Instanz nur im internen Netz.
Im Webhook-Node steht außerdem Allowed Origins: *. Das ist nötig, weil n8n Seiten aus einem Webhook in einer Sandbox ausliefert. Die Seite hat dann keinen eigenen Ursprung, und ohne diese Einstellung würde n8n ihre Anfragen an dieselbe URL abweisen. Aus demselben Grund zeigt die Seite das Original über pdf.js an: Eine PDF im eingebetteten Rahmen hat der Browser in der Sandbox blockiert, das war unser erster Versuch.
Externe Abhängigkeit
Für die Ansicht des Originals lädt die Seite pdf.js in Version 4.4.168 von cdnjs.cloudflare.com. Die PDF selbst verlässt dabei den Browser nicht. Wer keine externen Skripte möchte, legt pdf.js auf einen eigenen Server und ändert die Konstante PDFJS in der Seite.
Viele Belege
Die API liest höchstens 10 Belege pro Minute aus und antwortet danach mit „429 Zu viele Anfragen“. Mit den acht Belegen aus dem Video fiel das nicht auf. Erst beim Test für diesen Artikel liefen zwei Durchgänge kurz hintereinander, und vier Belege kamen mit 429 zurück. Die Seite hätte sie als „nicht lesbar“ markiert. Jetzt fängt sie das ab: Sie wartet 15 Sekunden und versucht es noch einmal. Im zweiten Test waren 20 Belege nach anderthalb Minuten ausgelesen und 32 nach dreieinhalb, ohne einen Ausfall. Mit den ersten können Sie schon anfangen, während der Rest noch läuft. Bis zur ZIP liegen alle Belege nur im Browser. Wer die Seite neu lädt, fängt von vorn an.
8. Datenschutz und Kosten
finisma legt die Belege nicht ab. Auslesen und Erzeugen laufen über die API jeweils in einer Anfrage: Die PDF geht hin, das Ergebnis kommt in derselben Antwort zurück. Das Auslesen macht ein Sprachmodell von OpenAI mit Zero Data Retention. OpenAI speichert von Ihren Rechnungen also nichts und trainiert nicht damit. Die Einzelheiten stehen im Artikel Zero Data Retention bei OpenAI. Wer die Rechnungsdaten schon hat und direkt an die API schickt, braucht gar kein Sprachmodell; das zeigt der Artikel ZUGFeRD-Rechnung aus einem Webformular.
Zu den Kosten: Im Abo für 8 € im Monat zzgl. MwSt. sind Auslesen und Erzeugen enthalten, bis 100 Rechnungen im Monat. Ohne Abo kostet jeder Beleg zwei Credits, einen fürs Auslesen und einen fürs Erzeugen, bei 10 € für 25 Credits also 80 Cent je Beleg. Für eine Hausverwaltung mit zwanzig Belegen im Monat ist das Abo die günstigere Wahl.
Zum Zeitplan: Ab 2027 müssen Unternehmen mit mehr als 800.000 € Vorjahresumsatz E-Rechnungen ausstellen, ab 2028 alle. Die Fristen und Ausnahmen stehen im Artikel E-Rechnungspflicht ab 2027.
9. Häufige Fragen
Läuft der Workflow in n8n Cloud?+
Nein. Der finisma-Node ist ein Community-Node, den n8n noch nicht verifiziert hat. Solche Nodes laufen nur auf selbst gehosteten Instanzen. Wer n8n Cloud nutzt, ruft die finisma-API mit HTTP-Request-Nodes auf; wie das geht, steht im Artikel „E-Rechnungen automatisch mit n8n erzeugen“.
Was kostet ein Beleg?+
Im Abo für 8 € im Monat zzgl. MwSt. sind Auslesen und Erzeugen enthalten, bis 100 Rechnungen im Monat. Ohne Abo kostet jeder Beleg zwei Credits, einen fürs Auslesen und einen fürs Erzeugen. Credits gibt es im Paket, 10 € für 25 Stück. Ohne Abo und ohne Guthaben lehnt finisma das Auslesen ab.
Speichert finisma meine Belege?+
Nein. Der Workflow ruft die API auf, und dort laufen Auslesen und Erzeugen jeweils in einer einzigen Anfrage: Die PDF geht hin, das Ergebnis kommt in derselben Antwort zurück, nichts wird abgelegt. Das Auslesen macht ein Sprachmodell von OpenAI mit Zero Data Retention, OpenAI speichert von der Rechnung also auch nichts.
Was passiert mit einer PDF, die schon eine E-Rechnung enthält?+
Dann liest finisma die eingebettete XML aus, ohne Sprachmodell. Die Daten sind damit exakt die der vorhandenen E-Rechnung. Im Ergebnis steht dann source: xml.
Sind Gutschriften im Gutschriftverfahren E-Rechnungen?+
Ja. Rechnet der Leistungsempfänger über die Leistung ab, ist die Gutschrift umsatzsteuerlich eine Rechnung (§ 14 Abs. 2 Satz 2 UStG). Sie fällt damit unter die E-Rechnungspflicht wie jede andere Rechnung zwischen Unternehmen. In der E-Rechnung trägt sie den Dokumenttyp 389.
Kann ich die Belege statt als ZIP direkt verschicken?+
Ja. Hinter „E-Rechnung erzeugen (finisma)“ liegt jede fertige Datei im Binärfeld zugferd. Ein E-Mail-Node kann sie als Anhang an den Empfänger schicken. Das zeigen wir im nächsten Video.
Quellen und Einordnung
§ 14 UStG (Abs. 2 Satz 2 Gutschrift, Abs. 4 Pflichtangaben); Node-Paket n8n-nodes-zugferd-finisma in Version 0.4.0; n8n-Dokumentation zu Community Nodes; finisma REST-Referenz. Die Beispiel-Belege und die Fabulus Immobilienverwaltung sind erfunden. Testlauf mit allen acht Belegen am 16. November 2026, Preise Stand November 2026.