ZUGFeRD-Rechnung erstellen in n8n
Was dieser Knoten bewirkt
PDF4me Zugferd-Rechnung erstellen erzeugt vollständig konforme ZUGFeRD hybride E-Rechnungen (PDF/A-3-Dokumente mit strukturierter XML Rechnungsdaten sind direkt in Ihrer Rechnung eingebettet. n8n Workflow. Konvertieren XML, JSON, oder CSV Rechnungsdaten in eine einzige Hybriddatei, bereit für die Deutsches B2B-E-RechnungsmandatUnterstützt EU-weite EN 16931-Konformität oder das deutsche XRECHNUNG-Profil für den öffentlichen Sektor. Unterstützt alle ZUGFeRD-Versionen von 1.0 bis 2.4 und alle sechs Konformitätsstufen in einem Knoten.
Authentifizierung Ihres API Anfrage
Jeder PDF4me Knoten in n8n erfordert eine gültige Anmeldeinformationen zum Verbinden mitErstellen oder wählen Sie einen Eintrag aus, der Ihre Daten enthält. PDF4me API Schlüssel, damit der Workflow ZUGFeRD-Rechnungsgenerierungsanfragen sicher authentifizieren kann.
Wichtige Fakten, die Sie nicht verpassen sollten
Parameter
Erforderlich in der n8n Benutzeroberfläche: Anmeldeinformationen für die Verbindung, Eingabedatentyp, Dokumentname (immer erforderlich, auch wenn der Eingabedatentyp None ist, wird als Fallback für den Dokumentnamen verwendet), Ausgabemodus, Zugferd-Version, Rechnung als PDF rendern, Sprache, Eingabeformat und Eingabetyp der Rechnungsdaten. Konformitätsgrad Die Anzeige und die erforderlichen Angaben basieren auf dem Zugferd-Versionszweig, wobei sich Feldname und Optionssatz für 1.0 im Vergleich zu 2.0/2.1/2.2/2.4 und benutzerdefiniert unterscheiden. Das entsprechende Rechnungsdatenfeld (Rechnung) XML/JSON/CSV Daten, Binäreigenschaften Base64 Je nach Eingabetyp der Rechnungsdaten ist der Inhalt (oder die Daten-URL) erforderlich. Die Laufzeitvalidierung erzwingt, dass der gewählte Pfad nicht leer ist, und gibt Fehlermeldungen wie „Rechnungsdaten erforderlich“ oder „Rechnungsbase64-Inhalt erforderlich“ aus.

Voll Parameter Ansicht; verwenden Sie die unten stehende Tabelle, um jedes Feld im Knoten zu finden.
| Parameter | Erforderlich | Was es tut | Beispiel |
|---|---|---|---|
| Input Data Type | Conditional | How the background PDF (the visual layer of the hybrid invoice) is supplied. None creates the PDF from invoice data alone. Binary Data reads from a previous n8n node. Base64 String accepts encoded content. URL downloads from a public link. | Binary Data |
| Binary Property Name | Conditional | Name of the binary field from the previous node. Required when Input Data Type is Binary Data. | data |
| Base64 Content | Conditional | Base64-encoded PDF string. Required when Input Data Type is Base64 String. | JVBERi0xLjQK... |
| File URL | Conditional | Public URL to the source PDF. Required when Input Data Type is URL. | https://example.com/invoice.pdf |
| Document Name | Yes | Filename of the source PDF document. Always required in the UI, including when Input Data Type is None (used as document name fallback in the payload). Include the .pdf extension. | invoice.pdf |
| Output Mode | Yes | XML Only generates a pure XML file. XML With PDF generates the full hybrid ZUGFeRD file: a PDF/A-3 document with structured XML embedded inside. XML With PDF is the canonical ZUGFeRD output. | XML With PDF |
| Zugferd Version | Yes | ZUGFeRD specification version. 1.0 is legacy and does not satisfy the German B2B mandate. 2.0 through 2.4 all support EN 16931. 2.2 and 2.4 add the latest XRECHNUNG profile updates. Custom enables advanced version handling. | 2.0 |
| Zugferd Version Custom | Conditional | Custom ZUGFeRD version identifier. Shown and required only when Zugferd Version is Custom (the execute step throws if empty). | 2.3.1 |
| Conformance Level | Conditional | Profile controlling which invoice fields are required. Shown when Zugferd Version is 1.0 (legacy options). Switches to Conformance Level (Above 2) for versions 2.0/2.1/2.2/2.4 and Custom (MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG). | EN16931 |
| Language | Yes | Display language for invoice labels in the rendered PDF. Options: German, French, Italian, English, Spanish, Dutch, Polish, Portuguese. The XML data itself remains language-neutral. | German |
| Render Invoice On PDF | Yes | Toggle (ON/OFF). When enabled, PDF4me visually renders the invoice content on the PDF using your invoice data. When disabled, only the structured XML is generated and embedded, useful when you supply a pre-designed background PDF. | true |
| Input Format | Yes | Format of the invoice data you are providing. XML for pre-built ZUGFeRD XML or UBL data. JSON for structured invoice objects. CSV for tabular batch exports. | XML sampleXML 2.0 sampleJSON 2.0 EN16931 sampleJSON (basic)CSV sampleCSV 2.0 sample |
| Invoice Data Input Type | Yes | How the invoice data reaches the node. Direct Text accepts pasted or mapped data inline. Binary Data reads from a previous file node. Base64 String for encoded payloads. URL downloads from a public link. | Direct Text |
| Invoice XML / JSON / CSV Data | Conditional | The actual invoice content. Appears as Invoice XML Data, Invoice JSON Data, or Invoice CSV Data, matching the chosen Input Format. Required when Invoice Data Input Type is Direct Text. Runtime also throws "Invoice … data is required" if empty. | XML sampleXML 2.0 sampleJSON 2.0 EN16931 sampleJSON (basic)CSV sampleCSV 2.0 samplePaste, map, or load via Binary / Base64 / URL to match the format you chose above. |
| Invoice Binary Property Name | Conditional | Name of the binary field holding the invoice data file. Required when Invoice Data Input Type is Binary Data. | data |
| Invoice Base64 Content | Conditional | Base64-encoded invoice data. Required when Invoice Data Input Type is Base64 String. Runtime also throws "Invoice base64 content is required" if empty. | PGludm9pY2U+... |
| Invoice Data URL | Conditional | Public URL to the invoice data file. Required when Invoice Data Input Type is URL. | https://example.com/invoice.json |
| Output File Name | No | Filename for the generated ZUGFeRD invoice. Default provided and normalized in execute (e.g. extension matched to Output Mode). Use .pdf for XML With PDF and .xml for XML Only. | zugferd_invoice.pdf |
| Output Binary Field Name | No | Name of the binary field holding the generated ZUGFeRD file. Defaults to data. Used to reference the file in subsequent workflow nodes. | data |
Beispielrechnungsdateien
Verwenden Sie diese Beispieldateien, um den Knoten mit jedem Eingabeformat zu testen, bevor Sie Ihre Live-Datenquelle anschließen. Für deutsche B2B-Produktionsworkflows beginnen Sie mit sample-invoice-zugferd-2.0-en16931.json (ZUGFeRD 2.0, EN16931 Konformität).
ZUGFeRD-invoice-sample.xmlZUGFeRD-invoice-sample-2.0.xmlsample-invoice-zugferd-2.0-en16931.jsonsample-invoice.jsontest-invoice.csvzugferd-invoice-2.0.csvErweiterte Optionen
Alle Felder innerhalb des Erweiterte Optionen Sammlungen sind optional. Fügen Sie sie hinzu über Option hinzufügen in der Node-Benutzeroberfläche.
ProfileOptionen für den Eingabedatentyp
Steuert, wie die Hintergrund PDF dokumentieren (Die visuelle Ebene der Hybridrechnung) wird dem Knoten bereitgestellt.

Dropdown-Menü „Eingabedatentyp“: Steuert, wie der Hintergrund PDF erreicht den Knoten
KeinerNur XML/JSON/CSV, kein Hintergrund-PDFBinärdatenDatei vom vorherigen Knoten (am häufigsten)Daten).Base64-ZeichenketteBase64-kodierter DateiinhaltURLVon einem öffentlichen Link herunterladenAusgabemodusoptionen
Steuert, ob der Knoten ein reines XML Datei oder das vollständige ZUGFeRD-Hybrid (PDF/A-3 + eingebettet) XML).

Dropdown-Menü „Ausgabemodus“ mit zwei Optionen: rein XML oder Hybrid PDF/A-3 mit XML eingebettet
Nur XMLRein XML, NEIN PDF Verpackung.xmlDieXML mit PDFStandard: vollständige ZUGFeRD-HybriddateiZUGFeRD-Versionsoptionen
Die in der generierten Rechnung eingebettete ZUGFeRD-Spezifikationsversion.

ZUGFeRD-Versionsauswahlmenü mit sechs Versionsoptionen, darunter die ältere Version 1.0 und die neueste Version 2.4.
1.0Altlasten: Erfüllt die Vorgaben für 2025 nicht.2.0Standardeinstellung: breite Kompatibilität2.1Kleinere Verbesserungen2.2Aktualisiertes XRECHNUNG-Profil2.4Aktuell: neueste XRECNUNG-UnterstützungBrauchErweiterte VersionsverwaltungOptionen für Konformitätsstufen
Das Konformitätsprofil steuert, welche Rechnungsfelder erforderlich und validiert werden müssen – die wichtigste Entscheidung für die Einhaltung der Vorschriften.

Dropdown-Menü „Konformitätsstufe“ mit sechs Profilen von MINIMUM bis XRECHNUNG zur Steuerung der Feldanforderungen und des Konformitätsbereichs
MINIMUMNur der Kopfbereich, keine gültige RechnungBASICWLBasisversion ohne Linien: Nur MwSt.BASICMindestrechnungEN16931Standard: Europäischer StandardERWEITERTBranchenspezifische ZusatzleistungenXRECHNUNGPflichtdienst im deutschen öffentlichen DienstSprachoptionen
Anzeigesprache für Rechnungsetiketten im gerenderten PDF Schicht. Die XML Daten an sich sind sprachneutral.

Sprache: lokalisierte Beschriftungen für die gerenderten PDF (Deutsch ist typisch für DE B2B und B2G).
DeutschStandardmäßig, Deutsch B2B/B2GEnglischInternationale RechnungsstellungFranzösischFactur-X-WorkflowsItalienischItalienisches B2BSpanischSpanisches B2BNiederländischNiederlande/BelgienPolierenPolen B2BPortugiesischPortugal/BrasilienOptionen für das Eingabeformat
Format der Rechnungsdaten, die Sie dem Knoten übermitteln.

Eingabeformat: wählen XML, JSON, oder CSV um den Nutzdaten Ihrer Rechnung zu entsprechen.
XMLVorgefertigt XML RechnungJSONStandard: modern API QuelleCSVTabellarische Daten für SammelrechnungenOptionen für den Eingabetyp der Rechnungsdaten
Steuert, wie die Rechnungsdaten (die XML, JSON, oder CSV Der Inhalt erreicht den Knoten.

Eingabetyp der Rechnungsdaten: wie die XML, JSON, oder CSV Die Nutzdaten werden bereitgestellt (inline, binär von einem vorherigen Knoten, base64 oder URL).
Direkter TextStandardmäßig: Inline einfügen oder Karte anzeigenBinärdatenDatei vom vorherigen KnotenBase64-ZeichenketteBase64-kodierte DatenURLVon einem öffentlichen Link herunterladenAusgabefelder
| Feld | Typ | Was es enthält |
|---|---|---|
fileName | String | Filename of the generated ZUGFeRD invoice, for example zugferd_invoice.pdf for XML With PDF output or zugferd_invoice.xml for XML Only output. |
mimeType | String | MIME type of the output file: application/pdf for hybrid output, application/xml for XML Only. Useful for content type validation in downstream HTTP or storage nodes. |
fileSize | Number | Size of the generated ZUGFeRD file in bytes. Useful for storage planning, bandwidth monitoring, and conditional routing in the workflow. |
success | Boolean | True when the ZUGFeRD invoice was generated successfully. False if validation failed or input data was malformed. Use this field to route error handling branches. |
message | String | Human-readable status message confirming success or describing the validation/parsing error encountered. Useful for logging and error notification steps. |
Schnellkonfiguration
- Hinzufügen PDF4me zu Ihrem n8n Workflow. Festlegen Ressource Zu Rechnung Und Rechnungsvorgänge Zu Zugferd-Rechnung erstellenDie
- In Anmeldeinformationen zum Verbinden mit, wählen Sie Ihre PDF4me Anmeldeinformationen oder klicken Neue Anmeldeinformationen erstellen und fügen Sie Ihren ein API Schlüssel.
- Satz Eingabedatentyp: einen vorherigen Knoten (Binärdaten) verbinden, bereitstellen Base64 Zeichenkette oder URL zum Hintergrund PDFoder wählen Sie „Keine“, wenn PDF4me sollte die PDF Allein anhand der Rechnungsdaten.
- Eingeben Dokumentname (Zum Beispiel
invoice.pdf). - Satz Ausgabemodus: XML mit PDF für den standardmäßigen hybriden ZUGFeRD-Ausgang oder Nur XML für reine XMLDie
- Wählen Zugferd Version (verwenden 2.0 als sichere Standardeinstellung; 2.4 (für das neueste XRECHNUNG-Profil).
- Wählen Konformitätsgrad: EN16931 für allgemeine B2B-Unternehmen XRECHNUNG für die Rechnungsstellung im deutschen öffentlichen Sektor, ERWEITERT für branchenspezifische Bereiche.
- Satz Sprache für das gerenderte PDF Beschriftungen (standardmäßig auf Deutsch).
- Aktivieren Rechnung als PDF ausgeben falls Sie es wollen PDF4me Rechnungsinhalte visuell darstellen; deaktivieren, wenn ein vordefinierter Hintergrund angegeben wird PDFDie
- Wählen Eingabeformat (JSON, XML, oder CSV) Und Eingabetyp der Rechnungsdaten (Direkter Text, Binärdaten, Base64-Zeichenfolge oder URL). Fügen Sie die Rechnungsdaten in das Feld „Rechnungsdaten“ ein oder ordnen Sie sie dort zu.
- Satz Name der Ausgabedatei Zu
zugferd_invoice.pdfUnd Name des binären Ausgabefelds ZudataDie - Verbinden Sie den Ausgang mit Ihrem nächsten Knoten (E-Mail-Absender, Cloud-Speicher-Upload, Regierungsportal). HTTP POST) und den Workflow ausführen.
Workflow-Beispiele
Workflow-BeispieleCommon n8n workflow patterns using Create Zugferd Invoice.
- Ein Webhook-Trigger wird ausgelöst, wenn eine Rechnung in der Buchhaltungsplattform (DATEV, sevDesk, lexoffice) abgeschlossen wird.
- Die Webhook-Payload enthält Rechnungsdaten in strukturierter Form. JSON Objekt.
- PDF4me Die Funktion „Zugferd-Rechnung erstellen“ generiert die Hybridrechnung. Der Eingabedatentyp ist „Keine“ (PDF4me rendert die PDF von JSONAusgabemodus: XML mit PDF, Zugferd-Version: 2.0, Konformitätsstufe: EN16931, Sprache: Deutsch, Eingabeformat: JSONDer Eingabetyp für Rechnungsdaten ist „Direkter Text“, der aus der Webhook-Nutzlast zugeordnet wird.
- Ein Gmail-Knoten sendet eine E-Mail an ZUGFeRD. PDF an die Kreditorenadresse des Kunden, wodurch die deutsche B2B-Empfangspflicht erfüllt wird.
- Ein PostgreSQL-Knoten protokolliert die Rechnungsnummer, die ZUGFeRD-Version und den Konformitätsgrad für Prüfungs- und Compliance-Berichte.
- Ein Zeitplan-Trigger wird jeden Werktag um 16:00 Uhr ausgelöst, um Rechnungen des öffentlichen Sektors zu verarbeiten.
- Ein SFTP-Knoten ruft neu generierte Dateien ab. ERP XML Rechnungsdateien aus dem Exportordner.
- PDF4me Die Funktion „Zugferd-Rechnung erstellen“ generiert eine konforme XRECHNUNG-Rechnung. Der Eingabedatentyp ist „Keine“, der Ausgabemodus „XML mit PDF“, die Zugferd-Version ist 2.4 (neuestes XRECHNUNG-Profil), die Konformitätsstufe ist XRECHNUNG, die Sprache ist Deutsch und das Eingabeformat ist … XMLDer Eingabetyp für Rechnungsdaten ist Binärdaten, die aus dem Inhalt der SFTP-Datei abgeleitet werden.
- Ein HTTP Request node uploads the XRECHNUNG invoice to the federal ZRE (Zentrale Rechnungseingangsplattform des Bundes) or the relevant state portal.
- Ein Microsoft Outlook Ein Knoten sendet eine Bestätigung an das Beschaffungsteam und ein PostgreSQL-Knoten protokolliert die Einreichungsreferenz.
- Ein Zeitplan-Trigger wird am 1. jedes Monats ausgelöst, um die monatliche Abrechnung durchzuführen.
- Ein Google Drive-Knoten lädt die konsolidierte Datei herunter. CSV Export der Rechnungsstellung, eine Zeile pro Kundenrechnung.
- Ein Split In Batches-Knoten iteriert über jedes CSV Reihe. PDF4me Die Funktion „Zugferd-Rechnung erstellen“ generiert eine Zugferd-Rechnung pro Kunde. Der Eingabedatentyp ist „Keine“, der Ausgabemodus ist „XML mit PDF“, die Zugferd-Version ist 2.0, der Konformitätsgrad ist EN16931, die Sprache variiert je nach Kundengebietsschema, das Eingabeformat ist CSVDer Eingabetyp für Rechnungsdaten ist Direkttext mit CSV-Inhalt pro Zeile.
- Ein Microsoft SharePoint Knoten lädt jedes ZUGFeRD hoch PDF in den Rechnungsarchivordner des Kunden.
- Ein Gmail-Knoten sendet jedem Kunden seine Hybridrechnung; eine abschließende PostgreSQL-Zusammenfassungszeile erfasst den Batch-Lauf mit Rechnungsanzahl und Gesamtbetrag.