Zum Hauptinhalt springen
PDF4me APIIntegrationenWissensdatenbankErweiterungenAPI-TesterBlog

Erstellen einer ZUGFeRD 2.0+ E-Rechnung in Make: Ein Dropbox-Workflow mit 4 Modulen

· 21 Minuten Lesezeit
Sankalp Mishra
SEO and Content Writer

ZUGFeRD 2.0+ (auch bekannt als Factur-X in Frankreich und XRechnung im deutschen öffentlichen Sektor) ist ein Hybrid-Rechnung (PDF/A-3) mit maschinenlesbarem XML, eingebettet in die PDF-Datei. Eine Datei, die sowohl von Menschen als auch von ERP-Systemen verarbeitet werden kann. Diese Anleitung beschreibt den genauen Ablauf, der in den Screenshots dargestellt ist: Eine Basis-PDF-Rechnung und eine ZUGFeRD 2.0+ XML-Datei in Dropbox werden zu einer EN16931-konformen hybriden E-Rechnung. /pdf4meoutput/, In 4. Module erstellen, keine Programmierung erforderlichDie

Das Szenario im Überblick
1. Dropbox Download (PDF)
Pulls the base invoice PDF (/pdf4metest/Zugfred Invoice/SimplePdf.pdf). Scheduled trigger shown.
2. Dropbox Download (XML)
Pulls the ZUGFeRD 2.0+ XML invoice data (/pdf4metest/Zugfred Invoice/version2.xml).
3. PDF4me Create a ZUGFeRD invoice
Input Format XML, Output Mode XML With PDF, ZUGFeRD Version 2+, Conformance EN16931, Render Yes, Language de.
4. Dropbox Upload
Writes the hybrid PDF/A-3 e-invoice to /pdf4meoutput/ using File set to Map.
Die Kurzfassung

Vier Make-Module, die den gesamten Prozess abdecken. Zwei Dropbox-Module. Datei herunterladen Die folgenden Schritte laden das Basis-PDF und das ZUGFeRD 2.0+ XML (die Screenshots zeigen YnooxTestone Verbindung plus Wege /pdf4metest/Zugfred Invoice/SimplePdf.pdf Und /pdf4metest/Zugfred Invoice/version2.xmlPDF4me Erstellen Sie eine ZUGFeRD-Rechnung bettet das XML in das PDF ein mit Ausgabemodus XML mit PDF, ZUGFeRD Version Ab 2 Jahren, Konformitätsgrad EN16931, Rechnung als PDF ausgeben Ja, Sprache vonDropbox Datei hochladen schreibt das Ergebnis Hybrid PDF/A-3 Zu /pdf4meoutput/ mit Datei eingestellt auf Karte, Dateiname 15. NameDaten 15. DokumentDie Ausgabe lässt sich in jedem PDF-Reader öffnen und in jedem ERP-System, das ZUGFeRD / Factur-X / XRechnung unterstützt, problemlos parsen.

Zwei Faktoren entscheiden darüber, ob Ihr ERP-System die Rechnung akzeptiert.

Zunächst einmal die Konformitätsgrad muss den Anforderungen des ERP-Systems Ihres Käufers oder Empfängers entsprechen. EN16931 (Comfort) ist der deutsche Rechtsstandard und die sichere Wahl für B2B in der EU; XRECHNUNG ist für die Rechnungsstellung im B2G-Bereich (öffentlicher Sektor) in Deutschland erforderlich; BASIC funktioniert für die meisten anderen Käufer. Zweitens, ZUGFeRD Version muss sein Ab 2 Jahren für alle Produkte, die der Norm EN 16931 entsprechen. Legacy 1.0 Verwendet die Modi BASIC / COMFORT / EXTENDED und ist nicht kompatibel mit EN 16931-Empfängern. Wählen Sie Ab 2 Jahren es sei denn, ein Empfänger verlangt ausdrücklich Version 1.0.

Häufige Probleme aus dem Alltag, die damit gelöst werden​

Menschen suchen nach genau diesem Problem mit Formulierungen wie:

  • „Wie erstelle ich in Make eine ZUGFeRD-Rechnung mit eingebettetem XML?“ Dieses Szenario mit 4 Modulen deckt den gesamten Prozess ab: Eingabe einer PDF-Vorlage und einer XML-Rechnung, Ausgabe eines hybriden PDF/A-3-Dokuments.
  • "Ist ZUGFeRD dasselbe wie Factur-X?" Ja. Es handelt sich um dasselbe technische Format unter verschiedenen Bezeichnungen. Eine ZUGFeRD 2.x-Datei wird von Systemen akzeptiert, die Factur-X erwarten, und umgekehrt.
  • „Welche Konformitätsstufe soll ich wählen?“ EN16931 für B2B (entspricht dem deutschen Rechtsstandard und der EU EN 16931), XRECHNUNG für den deutschen öffentlichen Sektor (B2G), BASIC für größtmögliche Legacy-Kompatibilität.
  • „Muss ich das XML selbst schreiben?“ Nein, aber für dieses Szenario verwenden die Screenshots eine bestehende XML-Rechnung. Das Modul akzeptiert auch JSON- oder CSV-Eingaben und erstellt das XML-Dokument automatisch.
  • "Was ist, wenn mein Käufer nur die XML-Datei benötigt, kein PDF?" Stellen Sie den Ausgabemodus auf XML Only und das Modul gibt nur die XML-Rechnungsdatei anstelle der Hybriddatei zurück.

Was Sie bauen​

Ein wiederverwendbares Make-Szenario, das aus einer PDF- und einer XML-Rechnungsdatei eine vollständig ZUGFeRD 2.0+-konforme hybride E-Rechnung erstellt. Die Auslösung kann manuell, zeitgesteuert (wie dargestellt), per Dropbox-Dateiüberwachung oder über einen HTTP-Webhook erfolgen. Das Ergebnis ist eine einzelne Datei, die sowohl die Anforderungen an lesbares PDF als auch an maschinenlesbares XML gemäß den EU-Vorgaben für elektronische Rechnungsstellung erfüllt.

Szenario-Canvas erstellen: Dropbox-Datei herunterladen (PDF, mit Zeitanzeige), verbunden mit einer zweiten Dropbox-Datei herunterladen (XML), verbunden mit PDF4me, Rechnung erstellen (ZUGFeRD), verbunden mit Dropbox-Datei hochladen. Jedes Modul zeigt einen Iterationszähler (1) und ein grünes Häkchen für einen erfolgreichen Durchlauf an.

Vier Module in einem. Zwei Downloads, eine PDF4me-Aktion, ein Upload. Das Uhrensymbol auf Modul 1 signalisiert einen geplanten Auslöser; je nach Anwendungsfall kann zwischen manueller Ausführung, Dateiüberwachung oder Webhook gewechselt werden.

Was Sie benötigen​

  • Machen Konto mit einem offenen Szenario. Erstellen Sie ein Make-Konto Falls Sie einen benötigen.
  • PDF4me API-SchlüsselDie Holen Sie sich Ihren API-Schlüssel und verbinden Sie sich mit dem ersten PDF4me-Modul. Siehe Verbinde PDF4me, um zu erstellenDie
  • Dropbox mit einem Quellordner (z.B. /pdf4metest/Zugfred Rechnung/) die die PDF-Vorlage und die XML-Rechnung sowie einen Ausgabeordner enthält (/pdf4meoutput/).
  • Ein Basis-PDF (die Screenshots verwenden SimplePdf.pdfEs benötigt keine Layout-Auszeichnung. Das Modul bettet das XML als PDF/A-3-Anhang ein.
  • Eine ZUGFeRD 2.0+ XML-RechnungVerwenden Sie Ihr eigenes oder besorgen Sie sich eins. 2.0 XML-Beispiel um folgen zu können.

Kurzübersicht: Was die einzelnen Parameter bewirken​

Input Format
XML for existing ZUGFeRD XML, JSON for structured JSON, CSV for tabular invoice rows.
Output Mode
XML With PDF returns the hybrid PDF/A-3 (recommended). XML Only returns just the XML invoice file.
ZUGFeRD Version
2+ for EN 16931 alignment (use this). 1.0 is legacy with BASIC / COMFORT / EXTENDED only.
Conformance Level
2+ supports MINIMUM, BASICWL, BASIC, EN16931 (Comfort, default), EXTENDED, XRECHNUNG (German B2G).
Render Invoice on PDF
Yes draws the invoice line items visually on the PDF. Only takes effect when Output Mode is XML With PDF.
Language
Two-letter ISO code: de (default), en, fr, it, es, nl, pl, pt, cs. Controls label localisation on the rendered PDF.

Erstellen Sie das Szenario​

Modul 1: Dropbox-Datei herunterladen (Basis-PDF)​

Ziehen Sie die Quell-PDF-Datei, in die das ZUGFeRD-XML als PDF/A-3-Anhang eingebettet wird.

FeldIn diesem Lauf verwendeter Wert
ConnectionYnooxTestone (ynoox.test...). your Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Zugfred Invoice/SimplePdf.pdf
Dropbox-Datei-Download-Konfiguration für die Basis-PDF-Datei erstellen. Verbindung: YnooxTestone. Dateiauswahl: Datei auswählen. Dateipfad: /pdf4metest/Zugfred Invoice/SimplePdf.pdf.

Modul 2: Dropbox-Datei herunterladen (ZUGFeRD 2.0+ XML)​

Laden Sie die ZUGFeRD-XML-Rechnungsdatei herunter. Die XML-Datei enthält alle Rechnungsdetails; die PDF-Datei ist lediglich die visuelle Darstellung.

FeldIn diesem Lauf verwendeter Wert
ConnectionYnooxTestone (ynoox.test...). same Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Zugfred Invoice/version2.xml
Dropbox-Datei-Download-Konfiguration für ZUGFeRD 2.0+ XML. Verbindung: YnooxTestone. Dateiauswahl: Datei auswählen. Dateipfad: /pdf4metest/Zugfred Invoice/version2.xml.

Modul 3: PDF4me Erstellen einer ZUGFeRD-Rechnung​

Die Aktion, die das eigentliche Einbetten durchführt. Ordnen Sie beide heruntergeladenen Dateien als Eingaben zu, wählen Sie Ihre Konformitätseinstellungen und führen Sie die Aktion aus.

GruppeFeldWert
AuthConnectionClassify Documen (testva...). PDF4me connection
SourceFile (PDF template)Map → Module 1 File Name + Data
SourceInput FormatXML
SourceFile (XML invoice)Map → Module 2 File Name + Data (a second File picker appears when Input Format is XML)
OutputOutput ModeXML With PDF (hybrid PDF/A-3)
OutputZUGFeRD Version2+
OutputConformance LevelEN16931
OutputRender Invoice on PDFYes
OutputLanguagede

Modul 4: Dropbox-Datei hochladen​

Speichern Sie die hybride PDF/A-3-E-Rechnung wieder im Ausgabeverzeichnis.

FeldIn diesem Lauf verwendeter Wert
ConnectionYnooxTestone (ynoox.test...)
Folder/pdf4meoutput/
FileMap (so File Name and Data come from the PDF4me step)
File Name15. Name (dynamic content from PDF4me Module 3)
Data15. Document (dynamic content from PDF4me Module 3)
Dropbox-Datei-Upload konfigurieren. Verbindung: YnooxTestone. Ordner: /pdf4meoutput/. Dateityp: Map. Dateiname: 15. Name (aus PDF4me: ZUGFeRD-Rechnung erstellen). Daten: 15. Dokument.

Speichern und klicken Einmal ausführenDas Hybridmodell PDF/A-3 landet in /pdf4meoutput/ innerhalb weniger Sekunden.

Get your API KeyFull action reference

Beispieldateien (XML, JSON, CSV)​

Sie können Modul 2 (XML) anstelle jeder dieser Eingaben verwenden und ändern. Eingabeformat entsprechend.

Fehlerbehebung​

Conformance Level dropdown shows different options than expected
You toggled between Versions. Version 1.0 has BASIC, COMFORT, EXTENDED. Version 2+ has Empty, MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG. Pick the version first; conformance levels follow.
Second File picker did not appear when Input Format is XML
It only appears when File is set to Map. Click the File radio and choose Map; the second File picker (for the XML invoice) renders below.
Buyer ERP rejects the hybrid PDF as non-compliant
Mismatched Conformance Level. Check what the receiver expects (commonly EN16931 for B2B EU, XRECHNUNG for German B2G). Re-run with the right value.
Output is XML only when you wanted the hybrid PDF
Output Mode is set to XML Only. Switch to XML With PDF.
Rendered invoice on PDF is missing line items
Render Invoice on PDF is set to No or Empty, or Output Mode is XML Only. Set both: Output Mode = XML With PDF AND Render Invoice on PDF = Yes.
Want JSON or CSV instead of XML as the input
Change Input Format. The Invoice XML Data / second File picker is replaced by an Invoice JSON Data or Invoice CSV Data text field, which you map from a Google Sheets, HTTP, or file-download module.

Wann man dieses Muster verwendet​

B2B invoicing in the EU
EN16931 (Comfort) covers the legal default for German and EU business-to-business e-invoicing.
B2G (public-sector) Germany
XRECHNUNG is required for invoicing public authorities. Same flow, different conformance level.
Cross-border Factur-X
France and other EU markets accept ZUGFeRD 2.x as Factur-X. No format conversion needed.
ERP integration without code
Buyer ERP extracts the embedded XML automatically; no manual data entry in accounts payable.

Was Sie als Nächstes lesen sollten​

Häufig gestellte Fragen​

What is ZUGFeRD 2.0+ and how does it differ from 1.0?+
ZUGFeRD 2.0+ aligns with the EU EN 16931 e-invoicing standard and supports the modern Conformance Level set (MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG). ZUGFeRD 1.0 predates EN 16931 and uses BASIC / COMFORT / EXTENDED only. For any new integration in 2026 use 2+; 1.0 is kept for legacy buyer ERPs.
Is ZUGFeRD the same as Factur-X?+
Same technical format under different brand names. ZUGFeRD is the German designation; Factur-X is the French equivalent. Both align to EN 16931 and are cross-compatible: a ZUGFeRD 2.x invoice is accepted by Factur-X receivers and vice versa.
Which Conformance Level should I pick for a typical EU B2B invoice?+
EN16931 (also called Comfort). It is the German legal default and the safe choice for EU business-to-business invoicing. Use XRECHNUNG when invoicing German public authorities (B2G). Use BASIC only when a recipient ERP explicitly requires it.
Do I need to author the XML myself?+
No. The screenshots use an existing XML (Input Format = XML), but the module also accepts JSON or CSV. Choose Input Format = JSON or CSV and the XML is built for you. Sample JSON and CSV files are in the section above.
What if my buyer needs only the XML, no PDF?+
Set Output Mode to XML Only. The module returns just the XML invoice file without a PDF wrapper. Useful when the receiving ERP renders its own document and only consumes the structured data.
Can I render line items visually on the PDF page?+
Yes. Set Render Invoice on PDF = Yes (only effective when Output Mode is XML With PDF). The module draws the invoice items as a visual table on the PDF pages so human reviewers see the invoice content without opening the embedded XML.
Does this work in Power Automate, n8n, or Zapier?+
Yes. The PDF4me Create ZUGFeRD Invoice action is available on all four platforms with the same parameters. See the cross-platform comparison at the bottom of the Make action reference page.
Does the output PDF/A-3 work with every PDF viewer?+
Yes. PDF/A-3 is backward-compatible with all PDF readers. Human readers see the rendered invoice PDF; ZUGFeRD-aware ERPs extract the embedded XML automatically. Non-aware tools just see a normal PDF.

Los geht's!​

Get your API KeyPDF4me on MakeAction reference