Zum Hauptinhalt springen

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.

Verwandte Blog-Beiträge(1)

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

ZUGFeRD ist ein hybrides PDF/A-3 + XML Format, nicht ein reines XML Standard
Das Ergebnis ist eine einzelne PDF-Datei im Archivformat (A-3). PDF mit der strukturierten XML Die Rechnung war beigefügt. Menschen lesen sie. PDFMaschinen analysieren die XMLEs müssen keine separaten Dateien gesendet werden. Um reine XML ohne die PDF Wrapper, Ausgabemodus auf XML einstellen; um die Hybriddatei zu generieren, auf XML mit PDF einstellen (Standardeinstellung).
ZUGFeRD 2.0+ ist für das deutsche B2B-Mandat 2025–2028 erforderlich.
Das deutsche Wachstumschancengesetz (WAG) schreibt den Empfang elektronischer Rechnungen für alle B2B-Transaktionen ab dem 1. Januar 2025 vor; die vollständige Versandpflicht wird bis 2028 schrittweise eingeführt. ZUGFeRD Version 2.0 oder höher mit EN16931- oder XRECHNUNG-Konformität erfüllt diese Vorgabe. Die ältere Version ZUGFeRD 1.0 ist nicht konform.
Die Einhaltung der Konformitätsstufe wird durch EN16931 kontrolliert, der sichere Standardwert.
Wählen Sie EN16931 für allgemeine B2B-Rechnungen in der EU (europäischer Standard), XRECHNUNG für Rechnungen an deutsche öffentliche Einrichtungen und EXTENDED für branchenspezifische Felder, die über die EN 16931-Basisnorm hinausgehen. MINIMUM und BASICWL lassen Einzelposten aus und können nicht für vollständige Rechnungen verwendet werden; sie dienen ausschließlich der internen Buchhaltung.

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.

Zugferd-Rechnung n8n-Knoten erstellen, vollständiges Parameterfeld mit Anmeldeinformationen für die Verbindung mit dem PDF4ME-Konto „dev“, Ressource „Rechnung“, Rechnungsoperationen „Zugferd-Rechnung erstellen“, Eingabedatentyp „Binärdaten“, Binäreigenschaften „data“, Dokumentname „invoice.pdf“, Ausgabemodus „XML mit PDF“, Zugferd-Version 2.0, Konformitätsstufe EN16931, Sprache „Deutsch“, Rechnung als PDF rendern aktiviert, Eingabeformat „JSON“, Eingabetyp „Direkter Text“, Ausgabedateiname „zugferd_invoice.pdf“, Binärfeldname „data“

Voll Parameter Ansicht; verwenden Sie die unten stehende Tabelle, um jedes Feld im Knoten zu finden.

ParameterErforderlichWas es tutBeispiel
Input Data TypeConditionalHow 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 NameConditionalName of the binary field from the previous node. Required when Input Data Type is Binary Data.data
Base64 ContentConditionalBase64-encoded PDF string. Required when Input Data Type is Base64 String.JVBERi0xLjQK...
File URLConditionalPublic URL to the source PDF. Required when Input Data Type is URL.https://example.com/invoice.pdf
Document NameYesFilename 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 ModeYesXML 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 VersionYesZUGFeRD 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 CustomConditionalCustom ZUGFeRD version identifier. Shown and required only when Zugferd Version is Custom (the execute step throws if empty).2.3.1
Conformance LevelConditionalProfile 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
LanguageYesDisplay 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 PDFYesToggle (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 FormatYesFormat 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 TypeYesHow 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 DataConditionalThe 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 NameConditionalName of the binary field holding the invoice data file. Required when Invoice Data Input Type is Binary Data.data
Invoice Base64 ContentConditionalBase64-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 URLConditionalPublic URL to the invoice data file. Required when Invoice Data Input Type is URL.https://example.com/invoice.json
Output File NameNoFilename 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 NameNoName 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).

IN HANDSCHLÄGEN XML Probe
ZUGFeRD 1.0 BASIC XML. Verwendung mit Eingabeformat: XML. Einfügen oder zuordnen in Rechnung XML DatenDie
ZUGFeRD-invoice-sample.xml
ZUGFeRD 2.0
ZUGFeRD 2.0 XML Muster (EN16931)
ZUGFeRD 2.0 EN16931 XML mit Verkäufer-/Käuferangaben, Positionen, Mehrwertsteuer und Gesamtsumme im branchenübergreifenden Rechnungsformat. Verwendung mit Eingabeformat: XML, ZUGFeRD Version: 2.0, Konformität: EN16931Die
ZUGFeRD-invoice-sample-2.0.xml
Empfohlen
JSON 2.0 EN16931 Muster
Vollständige, strukturierte Rechnung für ZUGFeRD 2.0 mit EN16931 Konformität. Verwendung mit Eingabeformat: JSON, Zugferd Version: 2.0, Konformitätsstufe: EN16931. Einfügen oder zuordnen in Rechnung JSON DatenDie
sample-invoice-zugferd-2.0-en16931.json
JSON Rechnungsbeispiel (Standard)
Einfacher JSON für Rauchtests mit ZUGFeRD 1.0 Und BASIC Konformität.
sample-invoice.json
CSV Rechnungsmuster
Wohnung CSV Zeile für Eingabeformat: CSV. Einfügen oder zuordnen in Rechnung CSV DatenDie
test-invoice.csv
ZUGFeRD 2.0
CSV 2.0 Rechnungsbeispiel
Erweiterte 22-Spalten-Version CSV: Rechnungs-ID, Ausstellungsdatum, Adressfelder für Verkäufer/Käufer, Umsatzsteuer-Identifikationsnummer des Verkäufers, Produkt-ID, Währung, Zahlungsreferenz, IBANBIC. Verwendung mit Eingabeformat: CSV, ZUGFeRD 2.0Die
zugferd-invoice-2.0.csv

Erweiterte Optionen

Alle Felder innerhalb des Erweiterte Optionen Sammlungen sind optional. Fügen Sie sie hinzu über Option hinzufügen in der Node-Benutzeroberfläche.

Profile
Brauch PDF4me Verarbeitungsprofile. Vorkonfigurierte Optionssätze für die erweiterte oder spezialisierte Rechnungserstellung mit ZUGFeRD anwenden (z. B. benutzerdefinierte Validierungsregeln, alternative Schemazuordnungen oder branchenspezifische Ausgabeoptimierung).

Optionen für den Eingabedatentyp

Steuert, wie die Hintergrund PDF dokumentieren (Die visuelle Ebene der Hybridrechnung) wird dem Knoten bereitgestellt.

Im Dropdown-Menü „Eingabedatentyp“ des Knotens „Zugferd-Rechnung erstellen“ in n8n PDF4me werden vier Optionen angezeigt: „Keine“ (Beschreibung: Keine Dokumenteingabe erforderlich, nur XML/JSON/CSV), „Binärdaten“ (Beschreibung: Datei aus vorherigem Knoten verwenden), „Base64-Zeichenkette“ (Beschreibung: Dateiinhalt als Base64-kodierte Zeichenkette angeben) und „URL“ (Beschreibung: URL zur Datei angeben).

Dropdown-Menü „Eingabedatentyp“: Steuert, wie der Hintergrund PDF erreicht den Knoten

KeinerNur XML/JSON/CSV, kein Hintergrund-PDF
Es ist keine Dokumenteneingabe erforderlich. PDF4me erzeugt sowohl das visuelle PDF Schicht und die strukturierte XML Aus den Rechnungsdaten allein. Verwenden Sie diese Option, wenn nur die Rechnungsdaten vorhanden sind und Sie Folgendes möchten PDF4me um die vollständige Hybriddatei zu rendern.
BinärdatenDatei vom vorherigen Knoten (am häufigsten)
Liest den Hintergrund PDF Binärdaten direkt aus der Ausgabe eines vorherigen n8n Knoten: Google Drive-Download HTTP Binärdatei anfordern oder lesen. Das Feld „Binäreigenschaft“ gibt an, welches Ausgabefeld gelesen werden soll (Standardwert). Daten).
Base64-ZeichenketteBase64-kodierter Dateiinhalt
Akzeptiert den Hintergrund PDF als Base64-kodierter String. Verwenden Sie diesen, wenn die Datei von einem API Antwort, Webhook-Payload oder eine Datenbankspalte, die Dokumente als Base64 speichert.
URLVon einem öffentlichen Link herunterladen
Stellen Sie einen öffentlich zugänglichen URL in den Hintergrund PDFDie PDF4me Die Datei wird direkt vor der Erstellung der Hybridrechnung heruntergeladen. URL darf keine Authentifizierung erfordern.

Ausgabemodusoptionen

Steuert, ob der Knoten ein reines XML Datei oder das vollständige ZUGFeRD-Hybrid (PDF/A-3 + eingebettet) XML).

Im Dropdown-Menü „Ausgabemodus“ des Knotens „Zugferd-Rechnung erstellen“ in n8n PDF4me werden zwei Optionen angezeigt: „Nur XML“ (Beschreibung: Nur die XML-Datei generieren) und „XML mit PDF“ (Beschreibung: In PDF eingebettetes XML generieren).

Dropdown-Menü „Ausgabemodus“ mit zwei Optionen: rein XML oder Hybrid PDF/A-3 mit XML eingebettet

Nur XMLRein XML, NEIN PDF Verpackung
Gibt nur die strukturierte Ausgabe aus XML Rechnungsdaten. Verwenden Sie diese, wenn das empfangende System die Rechnung verarbeitet. XML Visuelle Inhalte werden direkt verworfen, für XRechnung-Rein-XML-Übermittlungen oder zum Testen der Datenschicht isoliert. Dateinamenserweiterung für die Ausgabe festlegen auf .xmlDie
XML mit PDFStandard: vollständige ZUGFeRD-Hybriddatei
Erstellt die standardmäßige ZUGFeRD-Hybridrechnung: eine PDF/A-3-Rechnung in Archivqualität. PDF mit der strukturierten XML Die Rechnungsdaten sind als Anhang eingebettet. Menschen lesen sie. PDFMaschinen analysieren die XMLDies ist die kanonische ZUGFeRD-Ausgabe für die B2B-E-Rechnungsstellung in der Produktion.

ZUGFeRD-Versionsoptionen

Die in der generierten Rechnung eingebettete ZUGFeRD-Spezifikationsversion.

Die Dropdown-Liste „Zugferd-Version“ im Knoten „Zugferd-Rechnung erstellen“ von n8n PDF4me zeigt die Optionen 1.0, 2.0 (hervorgehoben), 2.1, 2.2, 2.4 und „Benutzerdefiniert“ an. Der Tooltip gibt den Parameter „zugferdVersion“ an.

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.
Originalspezifikation von 2014. Nur mit älteren Empfangssystemen kompatibel. nicht Erfüllen Sie die ab 2025 geltende deutsche B2B-E-Rechnungspflicht. Vermeiden Sie dies bei neuen Arbeitsabläufen.
2.0Standardeinstellung: breite Kompatibilität
Die erste EN 16931-konforme Version (2019). Erfüllt die deutschen B2B-Vorgaben und ist der sichere Standard für die allgemeine B2B-Rechnungsstellung. Vollständig kompatibel mit Factur-X 1.0.
2.1Kleinere Verbesserungen
Enthält kleinere Schemaverbesserungen und Klarstellungen gegenüber Version 2.0. Verwenden Sie diese Version, wenn Ihr empfangendes System Version 2.1 explizit erfordert.
2.2Aktualisiertes XRECHNUNG-Profil
Entspricht dem aktualisierten XRECHNUNG-Profil Version 2.x. Wählen Sie diese Option bei der Rechnungsstellung an deutsche öffentliche Einrichtungen, die das neuere Profil benötigen.
2.4Aktuell: neueste XRECNUNG-Unterstützung
Die aktuellste Spezifikation ist verfügbar. Sie beinhaltet Unterstützung für das neueste XRECHNUNG-Profil und Schemaerweiterungen. Wählen Sie diese Version, wenn der Empfänger die neueste Version benötigt.
BrauchErweiterte Versionsverwaltung
Ermöglicht die benutzerdefinierte Versionsverwaltung, wenn ein nicht standardmäßiger Versionsbezeichner von einem bestimmten Empfangssystem benötigt wird. Nur verwenden, wenn Ihr Rechnungsempfänger dies ausdrücklich anordnet.

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

Das Dropdown-Menü „Konformitätsstufe“ im Knoten „Zugferd-Rechnung erstellen“ von n8n PDF4me zeigt sechs Optionen an: MINIMUM, BASICWL, BASIC, EN16931 (hervorgehoben), EXTENDED und XRECHNUNG

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 Rechnung
Nur Kopfdaten: Parteien, Summen, Dokumentverweise. Keine Einzelposten. Kann nicht als rechtsgültige Rechnung verwendet werden; nur für interne Buchhaltungsabgaben oder Statusmeldungen.
BASICWLBasisversion ohne Linien: Nur MwSt.
Fügt zusätzlich zum Mindestbetrag die Mehrwertsteuer-/Steueraufschlüsselung hinzu. Keine Einzelposten. Wird nur für Buchungsszenarien verwendet, in denen Rechnungen mit Bestellungen abgeglichen werden, nicht als eigenständige Rechtsrechnungen.
BASICMindestrechnung
Fügt zusätzlich zu BASICWL Einzelposten hinzu. Erfüllt die Mindestanforderungen der EU-Richtlinie zur elektronischen Rechnungsstellung. Für einfache Rechnungen akzeptabel, jedoch ist EN16931 die sicherere Standardnorm für die vollständige B2B-Konformität.
EN16931Standard: Europäischer Standard
Europäische Norm EN 16931, vollständiges Profil. Empfohlener Standard für die B2B-Rechnungsstellung in der EU und dem Konformitätsniveau gemäß der deutschen Richtlinie 2025. Enthält alle Felder, die für eine gesetzeskonforme Rechnungsstellung erforderlich sind.
ERWEITERTBranchenspezifische Zusatzleistungen
Fügt branchenspezifische Felder über EN 16931 hinaus hinzu, beispielsweise zusätzliche Angaben zu Logistik, Fracht oder branchenspezifischen Bereichen. Verwenden Sie diese Erweiterung, wenn Ihre Branchenvereinbarung oder Ihr Handelspartner die erweiterten Felder vorschreibt.
XRECHNUNGPflichtdienst im deutschen öffentlichen Dienst
Das deutsche XRechnung CIUS-Profil, Pflicht für Rechnungen an deutsche Bundes-, Landes- und Kommunalbehörden. Strengere Validierung als EN16931. Anzuwenden, wenn der Empfänger eine deutsche öffentliche Einrichtung ist.

Sprachoptionen

Anzeigesprache für Rechnungsetiketten im gerenderten PDF Schicht. Die XML Daten an sich sind sprachneutral.

Sprachauswahlmenü in n8n „Zugferd-Rechnung erstellen“ mit den Sprachen Deutsch, Französisch, Italienisch, Englisch, Spanisch, Niederländisch, Polnisch und Portugiesisch

Sprache: lokalisierte Beschriftungen für die gerenderten PDF (Deutsch ist typisch für DE B2B und B2G).

DeutschStandardmäßig, Deutsch B2B/B2G
EnglischInternationale Rechnungsstellung
FranzösischFactur-X-Workflows
ItalienischItalienisches B2B
SpanischSpanisches B2B
NiederländischNiederlande/Belgien
PolierenPolen B2B
PortugiesischPortugal/Brasilien

Optionen für das Eingabeformat

Format der Rechnungsdaten, die Sie dem Knoten übermitteln.

Dropdown-Menü „Eingabeformat“ in n8n „Zugferd-Rechnung erstellen“ mit den Optionen XML, JSON und CSV; JSON ist ausgewählt.

Eingabeformat: wählen XML, JSON, oder CSV um den Nutzdaten Ihrer Rechnung zu entsprechen.

XMLVorgefertigt XML Rechnung
Liefern Sie bereits formatierte ZUGFeRD-konforme Dateien. XML oder UBL XML Daten. Verwenden Sie diese Funktion, wenn Ihre Daten. ERP produziert bereits Standard XML Rechnungen, die lediglich in die Hybridverpackung eingewickelt werden müssen PDFDie
JSONStandard: modern API Quelle
Liefern Sie Rechnungsdaten als strukturierte JSON Objekt. Die am häufigsten gewählte Option, wenn Rechnungsdaten über einen Webhook eingehen. REST APIoder moderner Buchhaltungssoftware. PDF4me Karten JSON Felder zum ZUGFeRD XML Schema automatisch.
CSVTabellarische Daten für Sammelrechnungen
Liefern Sie die Rechnungsdaten als CSVNützlich für den Export von Rechnungen aus Tabellenkalkulationen, Altsystemen oder für Massenabrechnungsszenarien. PDF4me Karten CSV Spalten zum ZUGFeRD-Schema.

Optionen für den Eingabetyp der Rechnungsdaten

Steuert, wie die Rechnungsdaten (die XML, JSON, oder CSV Der Inhalt erreicht den Knoten.

Dropdown-Menü für den Eingabetyp von Rechnungsdaten in n8n „Zugferd-Rechnung erstellen“ mit den Optionen Direkter Text, Binärdaten, Base64-Zeichenfolge und URL.

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 anzeigen
Fügen Sie die Rechnungsdaten direkt in das Feld „Rechnungsdaten“ ein oder ordnen Sie sie dort zu. Am besten geeignet für JSON oder kleiner CSV Nutzdaten von vorgelagerten Knoten. Verwenden Sie n8n Ausdruckssyntax zur dynamischen Datenkonstruktion.
BinärdatenDatei vom vorherigen Knoten
Liest die Rechnungsdatendatei (XML, JSON, oder CSV) direkt aus der Binärausgabe eines vorherigen n8n Knoten: Google Drive-Download, Binärdatei lesen oder HTTP Anfrage. Am besten geeignet für große Mengen. XML Dateien.
Base64-ZeichenketteBase64-kodierte Daten
Akzeptiert die Rechnungsdaten als Base64-kodierte Zeichenkette. Verwenden Sie diese Funktion, wenn Rechnungsinhalte von einem System empfangen werden. API Antwort- oder Datenbankfeld, das Dateien als Base64 speichert.
URLVon einem öffentlichen Link herunterladen
Stellen Sie einen öffentlich zugänglichen URL zur Rechnungsdatei. PDF4me Lädt die Datei herunter und analysiert den Inhalt gemäß dem ausgewählten Eingabeformat.

Ausgabefelder

FeldTypWas es enthält
fileNameStringFilename of the generated ZUGFeRD invoice, for example zugferd_invoice.pdf for XML With PDF output or zugferd_invoice.xml for XML Only output.
mimeTypeStringMIME 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.
fileSizeNumberSize of the generated ZUGFeRD file in bytes. Useful for storage planning, bandwidth monitoring, and conditional routing in the workflow.
successBooleanTrue when the ZUGFeRD invoice was generated successfully. False if validation failed or input data was malformed. Use this field to route error handling branches.
messageStringHuman-readable status message confirming success or describing the validation/parsing error encountered. Useful for logging and error notification steps.

Schnellkonfiguration

  1. Hinzufügen PDF4me zu Ihrem n8n Workflow. Festlegen Ressource Zu Rechnung Und Rechnungsvorgänge Zu Zugferd-Rechnung erstellenDie
  2. 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.
  3. 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.
  4. Eingeben Dokumentname (Zum Beispiel invoice.pdf).
  5. Satz Ausgabemodus: XML mit PDF für den standardmäßigen hybriden ZUGFeRD-Ausgang oder Nur XML für reine XMLDie
  6. Wählen Zugferd Version (verwenden 2.0 als sichere Standardeinstellung; 2.4 (für das neueste XRECHNUNG-Profil).
  7. Wählen Konformitätsgrad: EN16931 für allgemeine B2B-Unternehmen XRECHNUNG für die Rechnungsstellung im deutschen öffentlichen Sektor, ERWEITERT für branchenspezifische Bereiche.
  8. Satz Sprache für das gerenderte PDF Beschriftungen (standardmäßig auf Deutsch).
  9. Aktivieren Rechnung als PDF ausgeben falls Sie es wollen PDF4me Rechnungsinhalte visuell darstellen; deaktivieren, wenn ein vordefinierter Hintergrund angegeben wird PDFDie
  10. 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.
  11. Satz Name der Ausgabedatei Zu zugferd_invoice.pdf Und Name des binären Ausgabefelds Zu dataDie
  12. 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.
Buchhaltungssoftware → ZUGFeRD 2.0 EN16931 Rechnung → E-Mail an den Kunden
  1. Ein Webhook-Trigger wird ausgelöst, wenn eine Rechnung in der Buchhaltungsplattform (DATEV, sevDesk, lexoffice) abgeschlossen wird.
  2. Die Webhook-Payload enthält Rechnungsdaten in strukturierter Form. JSON Objekt.
  3. 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.
  4. Ein Gmail-Knoten sendet eine E-Mail an ZUGFeRD. PDF an die Kreditorenadresse des Kunden, wodurch die deutsche B2B-Empfangspflicht erfüllt wird.
  5. Ein PostgreSQL-Knoten protokolliert die Rechnungsnummer, die ZUGFeRD-Version und den Konformitätsgrad für Prüfungs- und Compliance-Berichte.
ERP XML Rechnung → ZUGFeRD-RECHNUNG → Hochladen auf das Portal des öffentlichen Sektors
  1. Ein Zeitplan-Trigger wird jeden Werktag um 16:00 Uhr ausgelöst, um Rechnungen des öffentlichen Sektors zu verarbeiten.
  2. Ein SFTP-Knoten ruft neu generierte Dateien ab. ERP XML Rechnungsdateien aus dem Exportordner.
  3. 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.
  4. Ein HTTP Request node uploads the XRECHNUNG invoice to the federal ZRE (Zentrale Rechnungseingangsplattform des Bundes) or the relevant state portal.
  5. Ein Microsoft Outlook Ein Knoten sendet eine Bestätigung an das Beschaffungsteam und ein PostgreSQL-Knoten protokolliert die Einreichungsreferenz.
Monatlich CSV Abrechnungsstapel → ZUGFeRD-Rechnungen → Archiv an SharePoint
  1. Ein Zeitplan-Trigger wird am 1. jedes Monats ausgelöst, um die monatliche Abrechnung durchzuführen.
  2. Ein Google Drive-Knoten lädt die konsolidierte Datei herunter. CSV Export der Rechnungsstellung, eine Zeile pro Kundenrechnung.
  3. 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.
  4. Ein Microsoft SharePoint Knoten lädt jedes ZUGFeRD hoch PDF in den Rechnungsarchivordner des Kunden.
  5. Ein Gmail-Knoten sendet jedem Kunden seine Hybridrechnung; eine abschließende PostgreSQL-Zusammenfassungszeile erfasst den Batch-Lauf mit Rechnungsanzahl und Gesamtbetrag.

Häufig gestellte Fragen

What is ZUGFeRD and how does it differ from XRechnung and Factur-X?+
ZUGFeRD is the German hybrid e-invoicing standard: a PDF/A-3 archival-grade PDF with structured XML invoice data embedded inside as an attachment. Humans read the visual PDF and machines parse the embedded XML, so a single file serves both audiences. XRechnung is the German public-sector profile, mandatory when invoicing federal, state, or municipal authorities; it can be issued as pure XML or as a ZUGFeRD conformance level. Factur-X is the French sister format that uses the identical hybrid PDF/A-3 + XML structure as ZUGFeRD 2.x and is fully interoperable. Use ZUGFeRD 2.x with EN16931 for general B2B, XRECHNUNG conformance for German public sector, and ZUGFeRD/Factur-X for cross-border French-German invoicing.
Which ZUGFeRD version should I use in 2025 for the German B2B e-invoicing mandate?+
ZUGFeRD 2.0 or higher is required to comply with the German B2B e-invoicing mandate. The mandate, enacted under the Wachstumschancengesetz (Growth Opportunities Act), made e-invoice receipt mandatory from 1 January 2025 and phases in full sending obligations by 2028. Versions 2.0 through 2.4 all comply with EN 16931, the European standard the mandate references. ZUGFeRD 2.2 and 2.4 add support for the newer XRECHNUNG profile updates. Legacy ZUGFeRD 1.0 does not satisfy the mandate. Default to 2.0 for broad compatibility across receiving systems, or 2.4 when the latest XRECHNUNG profile is required.
What is the difference between MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, and XRECHNUNG conformance levels?+
MINIMUM contains only the absolute minimum invoice header data (totals and parties) and cannot serve as a legal invoice; it is for internal accounting drop-offs only. BASICWL (Basic Without Lines) adds VAT and tax breakdowns but still has no line items. BASIC adds line items and meets the absolute minimum of the EU e-invoicing directive. EN16931 is the European Standard EN 16931 profile, recommended as the default for B2B invoicing across the EU and the level the German mandate references. EXTENDED adds industry-specific fields beyond EN 16931. XRECHNUNG is the German public-sector mandatory profile, required when invoicing federal, state, or municipal authorities. Use EN16931 for general B2B, XRECHNUNG for public sector, EXTENDED for industry-specific scenarios.
What is the difference between XML Only and XML With PDF output modes?+
XML Only generates a pure XML file containing the structured invoice data, useful when the receiving system processes only the XML and discards visual content, for XRechnung pure-XML submissions, or for testing the data layer in isolation. XML With PDF generates the full ZUGFeRD hybrid invoice: a PDF/A-3 archival document with the XML embedded as an attachment inside the PDF. The hybrid format is the canonical ZUGFeRD output and is required when both human readability and machine processing must be supported by a single file. Choose XML With PDF for production e-invoicing workflows and XML Only for data-layer integration testing or pure-XML public-sector submissions.
Can I generate ZUGFeRD invoices from CSV data, and what does Invoice Data Input Type control?+
Yes. The Input Format parameter supports XML, JSON, and CSV; pick the format matching your data source. Invoice Data Input Type then controls how the data reaches the node: Direct Text lets you paste or map the data inline (best for JSON or small CSV from upstream nodes), Binary Data reads from a previous file node (best for large XML files), Base64 String accepts encoded content (best for API payloads), and URL downloads the data file from a public link. CSV input is automatically mapped to the ZUGFeRD XML schema by PDF4me before being embedded in the output PDF; no manual XML construction is required.

Verwandte Aktionen

Dieselbe Aufgabe auf anderen Plattformen

Hilfe erhalten