Zum Hauptinhalt springen

Erstellen ZUGFeRD Rechnung in Make

Erstellen ZUGFeRD Rechnung ist ein Make Modul von PDF4me das Hybride erzeugt ZUGFeRD/Factur-X E-Rechnungen von CSV, JSON, oder XML Rechnungsdaten. Verwenden Sie diese, um eine Rechnung zu erstellen. PDF/A-3 Dokument mit maschinenlesbarer XML innen eingebettet, ausgerichtet auf EN 16931 Europäischer Standard für elektronische Rechnungen. Wählen Sie die Konformitätsstufe und Spezifikationsversion, die den Anforderungen Ihres Käufers oder Ihrer Kundin entsprechen. ERP Systemanforderungen.

Was dieses Modul bewirkt

PDF4meErstellen Sie ein ZUGFeRD Rechnung Erstellt hybride E-Rechnungen direkt in Ihrem Make Szenario. Rechnungsdaten bereitstellen als CSV, JSON, oder XMLDas Modul erzeugt ein PDF/A-3 Dokument mit maschinenlesbarer ZUGFeRD XML darin eingebettete Dateioder ein XML-nur Ausgabe für ERP Systeme, die ihr eigenes Rendering übernehmen. Das Ergebnis stimmt mit dem überein. EN 16931 Europäischer Standard für elektronische Rechnungsstellung und wird akzeptiert als Factur-X in Frankreich und auf den EU-Märkten. Konformitätsstufen und Spezifikationsversionen sind konfigurierbar und entsprechen exakt den Anforderungen Ihres Käufers oder öffentlichen Auftraggebers.

Verwandte Blog-Beiträge(1)

Authentifizierung Ihres API Anfrage

Jeder PDF4me Modul in Make erfordert eine gültige VerbindungErstellen oder wählen Sie einen Eintrag aus, der Ihre Daten enthält. PDF4me API Schlüssel, damit das Szenario den Rechnungsgenerierungsdienst sicher aufrufen kann.

Wichtige Fakten, die Sie nicht verpassen sollten

XmlWithPdf ist ein PDF/A-3 Datei, keine reguläre PDF

Das Hybrid-Ergebnis ist ein PDF/A-3 Dokument. das ZUGFeRD XML ist als konformer Anhang in die Datei eingebettet. ERP Systeme extrahieren die XML automatisch; Menschen können sie aber weiterhin öffnen und lesen. PDF in jedem Standard-Viewer. Einstellen Rechnung als PDF ausgeben Ja, um die Rechnungspositionen visuell auf der Seite darzustellen.

Die Konformitätsgrade hängen ab von ZUGFeRD Version

Version 1.0 unterstützt BASIS, KOMFORT, ERWEITERTVersion 2+ erweitert sich auf MINIMUM, BASICWL, BASIC, EN16931, ERWEITERT, XRECHNUNGDie XRECHNUNG Und EN16931 Für die Rechnungsstellung im öffentlichen Sektor in Deutschland sind entsprechende Dokumente erforderlich. Version und Versionsstufe müssen stets den Anforderungen des Käufersystems entsprechen.

Das Eingabeformat steuert, welches Datenfeld angezeigt wird.

Auswahl XML zeigt die Rechnungs-XML-Daten Feld; JSON zeigt Rechnungsdaten im JSON-Format an; CSV Zeigt Rechnungsdaten im CSV-Format an. Füllen Sie nur die Felder aus, die dem gewählten Format entsprechen. Bei Verwendung XML Format, das Modul stellt auch ein Datei Radio, damit Sie das XML direkt von Dropbox oder über ein vorheriges Modul.

Welche ZUGFeRD Welche Version soll ich verwenden?

Das Modul unterstützt zwei Spezifikationsversionen. Für die meisten neuen Integrationen sollte Version 2.0 oder höher verwendet werden; Version 1.0 wird für die Kompatibilität mit älteren Systemen beibehalten.

ZUGFeRD 2.0+ EMPFOHLEN

Aktuelle Spezifikation. Konformitätsstufen: MINIMUM, BASICWL, BASIC, EN16931 (Comfort, die deutsche Rechtsnorm), ERWEITERT, XRECHNUNG. Kompatibel mit Factur-XKombinieren Sie es mit dem 2.0 XML Probe, 2.0 EN16931 JSON Probe, oder 2.0 CSV ProbeDie folgenden Screenshots zeigen die Benutzeroberfläche von Version 2.0+ genau so, wie sie heute dargestellt wird.

Make Create a ZUGFeRD invoice module 2.0+: Block 1: Connection, File (PDF template), Input Format, File (invoice data), Output Mode
Block 1: Connection, File (PDF template), Input Format, File (invoice data), Output Mode
Make Create a ZUGFeRD invoice module 2.0+: Block 2: ZUGFeRD Version, Conformance Level, Render Invoice on PDF, Language
Block 2: ZUGFeRD Version, Conformance Level, Render Invoice on PDF, Language

ZUGFeRD 1.0 VERMÄCHTNIS

Vorher-EN 16931 Spezifikationskonformitätsstufen: BASIC, KOMFORT, ERWEITERTNur verwenden, wenn ein Empfänger ERP oder das Käufersystem erfordert explizit Version 1.0 (selten nach 2022). Passend dazu 1.0 XML Probe, Die grundlegend JSON Probeoder die 1.0 CSV ProbeAlle anderen Felder funktionieren gleich; nur die Auswahlliste für die Konformitätsstufe ändert sich.

Erstellen Sie mit PDF4me Dev ein ZUGFeRD-Rechnungsmodul (1.0), das die aus einem vorherigen Schritt zugeordneten Verbindungs-, Dateinamen- und Dokumentinformationen sowie das auf XML eingestellte Eingabeformat anzeigt.

Beginnen Sie mit VerbindungDann kartieren Sie die Basis PDF (Dateiname, Dokumentierenund setzen Eingabeformat (Hier XML).

Erstellen Sie eine ZUGFeRD-Rechnung (1.0) mit folgenden Einstellungen: Eingabeformat XML, Datei auf „Zuordnen“ eingestellt, Rechnungs-XML-Daten aus einem vorherigen Modul zugeordnet, Ausgabemodus „XmlWithPdf“ und ZUGFeRD-Version 1.0

Mit Datei = Karte, Karte Rechnungs-XML-Daten, Satz Ausgabemodus (XmlWithPdf oder Nur XML), dann wählen zugferd Version (Hier 1.0).

Parameter

Erforderlich: Verbindung, Eingabeformat, Ausgabemodus, ZUGFeRD VersionDas Rechnungsdatenfeld (Rechnungs-XML-Daten, Rechnungs-JSON-Daten, oder Rechnungsdaten (CSV-Datei)) wird dynamisch basierend auf Ihrer Auswahl des Eingabeformats angezeigt. Nur das entsprechende Feld muss ausgefüllt werden.

Warum Datei Erscheinen sie zweimal in den Screenshots der Version 2.0+? Wenn das Eingabeformat XML und die Datei ist auf eingestellt KarteDas Modul rendert einen zweiten Dateiauswahldialog, sodass Sie beide (a) die Basisdatei zuordnen können. PDF Die ZUGFeRD Die Rechnung sollte eingebettet werden in (b) die Quelle ZUGFeRD XML Datei. Beide Auswahlfelder zeigen dieselben Optionsfelder an. Wenn das Eingabeformat ist JSON oder CSV Der zweite Picker wird durch den entsprechenden ersetzt. Rechnungs-JSON-Daten oder Rechnungsdaten (CSV-Datei) Textfeld.

ParameterErforderlichWas es tutBeispiel / Optionen
ConnectionRequiredPDF4me API connection used to authenticate invoice generation requests. Click Add and paste your API key if connecting for the first time.Your PDF4me connection
FileConditionalSource of the base PDF where the ZUGFeRD invoice will be embedded (when Output Mode is XmlWithPdf). Radio button with two options: Dropbox - Download a File (pulls directly from a Dropbox account without a prior download step) or Map (supplies the PDF from a prior module. Dropbox, Google Drive, OneDrive, HTTP, etc.). Choose Map for the most flexible workflow. When Map is selected, the two sub-fields below appear.Map
File → File NameConditionalSub-field of File (visible when Map is selected). Filename of the base PDF including the .pdf extension. Map from the prior module's filename output. for example, the File Name field of a Dropbox or Google Drive Download module.1. File Name
File → DocumentConditionalSub-field of File (visible when Map is selected). Binary PDF content where the ZUGFeRD XML will be embedded. Map from the prior module's binary data field. typically the Data field of Dropbox, Google Drive, or OneDrive download modules. Hint shown in module: "PDF file where Zugferd invoice should be added".1. Data
Input FormatRequiredFormat of the invoice data being supplied. Use XML for existing ZUGFeRD XML; JSON or CSV for structured data. Hint: "Format of the invoice data being supplied. Use XML for existing ZUGFeRD XML, JSON or CSV for structured data."XML sampleXML 2.0 sampleJSON 2.0 EN16931 sampleJSON (basic)CSV sampleCSV 2.0 sample
Invoice XML DataConditionalThe ZUGFeRD XML invoice content to embed. Appears when Input Format = XML and File = Map. Hint: "Use when inputFormat is XML, please refer to our Create a ZUGFeRD invoice for guidelines." Map from a prior Dropbox download or HTTP module output.XML sampleXML 2.0 sample3. Data (mapped)
Invoice JSON DataConditionalStructured invoice data in JSON format. Appears when Input Format = JSON. Map a JSON string from a Google Sheets, Airtable, or HTTP module. See sample JSON below.JSON 2.0 EN16931 sampleJSON (basic)(mapped JSON string)
Invoice CSV DataConditionalInvoice row data in CSV format. Appears when Input Format = CSV. Map a CSV row from an iterator, Google Sheets, or file download module. See sample CSV below.CSV sampleCSV 2.0 sample(mapped CSV row)
Output ModeRequiredXML With PDF (a.k.a XmlWithPdf in API requests) returns a PDF/A-3 file with the ZUGFeRD XML embedded inside, the standard hybrid e-invoice. XML Only (XmlOnly) returns just the XML invoice file without a PDF wrapper. Hint shown in module: "XML with PDF returns a PDF with embedded ZUGFeRD XML. XML only returns only the XML invoice file."XML With PDF
ZUGFeRD VersionRequiredZUGFeRD specification version. Set to match what the recipient ERP or buyer system expects. Latest is 2+; legacy 1.0 also supported. The two have different conformance level sets (see table below).2+
Conformance LevelOptionalZUGFeRD conformance profile. Available levels differ by version. For 2+, EN16931 (Comfort) is the default for German legal e-invoicing compliance. See the Conformance Level Reference table below. Defaults to BASIC if not specified.EN16931
Render Invoice on PDFOptionalWhen set to Yes, invoice line items are drawn visually on the PDF pages. Applies only when Output Mode is XmlWithPdf. Options: Yes, No, Empty. Hint: "Render invoice data visually on PDF pages. Applies only when outputMode is XmlWithPdf."Yes
languageOptionalTwo-letter locale code for invoice label localisation. Supported: de, en, fr, it, es, nl, pl, pt, cs. Hint: "Language code for invoice localisation (e.g. de, en, fr, it, es, nl, pl, pt, cs). Defaults to de if not specified."de

Konformitätsniveau-Referenz

Die verfügbaren Konformitätsstufen unterscheiden sich um zugferd VersionPassen Sie das Niveau immer an die Bedürfnisse Ihres Käufers an. ERP Systemanforderungen.

Version 1.0
EbeneVerwenden Sie es, wenn
BASICMandatory EN 16931 fields only. Widest compatibility, safe default.
COMFORTAdds optional fields for line-item detail and additional references.
EXTENDEDFull field set for complex B2B invoices with delivery, allowances, and charges.
Version 2+ (Factur-X)
EbeneVerwenden Sie es, wenn
MINIMUMAbsolute minimum fields. Buyer reference and totals only.
BASICWLBASIC without line items. Header-level data only.
BASICMandatory EN 16931 fields. Recommended starting point.
EN16931Full EN 16931 compliance for cross-border and public sector.
EXTENDEDFull field set including German-specific extensions.
XRECHNUNGGerman public-sector e-invoice mandate (XRechnung profile).

Beispielrechnungsdateien

Verwenden Sie diese Beispieldateien, um das Modul 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 XML Probe
ZUGFeRD 1.0 GRUNDLAGEN XML. Verwendung mit Eingabeformat: XMLEnthält Verkäufer-/Käuferdaten, Positionen, Mehrwertsteuer und Zahlungsreferenz im UN/CEFACT CrossIndustryDocument-Format.
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: EN16931Die
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 mit Rechnungs-ID, Verkäufername, Käufername, Produktname, Menge, Einzelpreis, Steuerprozentsatz, IBANund BIC-Spalten. Verwendung mit Eingabeformat: CSVEntspricht der von erwarteten Spaltenreihenfolge. PDF4meDie
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

CSV Spaltenreferenz

Der CSV Die Eingabe muss in genau dieser Spaltenreihenfolge erfolgen. Jede Zeile erzeugt eine Rechnung.

SpalteBeschreibungBeispiel
InvoiceIdUnique invoice identifierINV-2025-001
IssueDateInvoice issue date (YYYY-MM-DD)2025-01-15
SellerNameSeller company nameTest Company
SellerStreetSeller street address123 Main St
SellerCitySeller cityTest City
SellerPostalCodeSeller postal / ZIP code12345
SellerCountryISO 3166-1 alpha-2 country codeDE
SellerVatIdSeller VAT registration numberDE123456789
BuyerNameBuyer company or person nameCustomer Inc
BuyerStreetBuyer street address456 Oak Ave
BuyerCityBuyer cityCustomer City
BuyerPostalCodeBuyer postal / ZIP code67890
BuyerCountryISO 3166-1 alpha-2 country codeDE
ProductNameLine item product or service nameTest Product
QuantityQuantity of the line item10.0
UnitPriceNet unit price9.90
TaxPercentVAT / tax percentage19.0
CurrencyISO 4217 currency codeEUR
PaymentReferencePayment reference stringPAY-REF-001
IBANPayee IBAN for bank transferDE08700901001234567890
BICPayee bank BIC / SWIFT codeGENODEF1M04

JSON Rechnungsstruktur

Bei Verwendung Eingabeformat: JSONDie Nutzdaten müssen die folgenden Schlüssel der obersten Ebene enthalten. Alle verschachtelten Objekte und Arrays entsprechen der Struktur der Beispieldatei.

SchlüsselTypBeschreibung
InvoiceIdStringUnique invoice number, e.g. "471102"
IssueDateString (ISO 8601)Invoice date, e.g. "2013-03-05T00:00:00"
InvoiceTypeStringDocument type label, e.g. "RECHNUNG"
TypeCodeStringUN/EDIFACT document type code. 380 for standard invoice
IsTestBooleantrue for test runs, false / omit for production
NotesArray of stringsFree-text notes shown in the invoice header (payment terms, GLN, etc.)
SellerObjectSeller party: Name, Address (Street, City, PostalCode, Country), TaxId, VatId, GLN
BuyerObjectBuyer party: Name, Address (Street, City, PostalCode, Country, LineTwo), GLN
PaymentObjectPayment details: PaymentReference, Currency, IBAN, BIC
DeliveryDateString (ISO 8601)Actual delivery date, e.g. "2013-03-05T00:00:00"
LineItemsArray of objectsInvoice lines. each with Quantity, UnitCode, UnitPrice, LineTotal, ProductName, GTIN, SellerProductId
TotalsObjectMonetary totals: LineTotal, ChargeTotal, AllowanceTotal, TaxBasisTotal, TaxTotal, GrandTotal, TaxPercent, Currency

Wie erstelle ich ein ZUGFeRD Rechnung in Make?

  1. Hinzufügen PDF4meErstellen Sie einen ZUGFeRD Rechnung zu Ihrem Szenario.
  2. Wählen Verbindung (oder klicken Sie hier) Hinzufügen um einen mit Ihrem API Schlüssel).
  3. Wählen EingabeformatDie XML, JSON, oder CSVDas angezeigte Datenfeld hängt von dieser Auswahl ab.
  4. Satz Datei Zu Karte und verbinden Sie das Rechnungsdatenfeld (Rechnungs-XML-Daten / JSON-Daten / CSV-Daten) aus der Ausgabe des vorherigen Moduls. Oder wählen Sie Dropbox – Datei herunterladen um die Datei direkt aus Dropbox abzurufen.
  5. Satz Ausgabemodus Zu XmlWithPdf für einen Hybrid PDF/A-3 Rechnung oder Nur XML für XML nur.
  6. Satz zugferd Version (1.0 oder 2+) dann auswählen Konformitätsgrad aus dem versionsspezifischen Satz. Beginnen Sie mit BASICDie
  7. Bei Verwendung von XmlWithPdf: einstellen Rechnung als PDF ausgeben Zu Ja Linienelemente visuell zeichnen und festlegen Sprache zu Ihrem Zielgebietsschema (z.B. de, en, fr).
  8. Speichern und klicken Einmal ausführen. Leiten Sie die Dokumentdaten Ausgabe an Dropbox, Google Drive, ERP Webhook oder ein E-Mail-Modul.

Ausgabefelder

FeldTypWas es enthält
Document NameStringFilename of the generated invoice file. e.g. invoice-471102.pdf or invoice-471102.xml.
Document DataBufferBinary content of the ZUGFeRD hybrid PDF/A-3 or XML file. Map into an upload, email attachment, or ERP HTTP module for the next step in your scenario.

Workflow-Beispiele

Workflow-BeispieleCommon Make scenario patterns using Create ZUGFeRD Invoice for automated e-invoicing.
Erstellen Sie Hybridrechnungen aus Bestelldaten (JSON)
  1. Eine Bestellung wird in Ihrem Konto als versendet markiert. ERP oder Airtable. Das Szenario wird ausgelöst.
  2. Artikelpositionen, Preise, Käuferadresse und Steuerdaten werden abgerufen und zu einem Dokument zusammengeführt. JSON Nutzlast.
  3. Erstellen ZUGFeRD Rechnung Läuft mit Eingabeformat JSONAusgabemodus XmlWithPdf, Version Ab 2 JahrenKonformitätsniveau BASIC, Sprache vonDie
  4. Der Hybrid PDF wird dem Käufer per E-Mail über Gmail zugesandt und eine Kopie wird im Rechnungsarchiv in Google Drive hochgeladen.
Stapelverarbeitung von Rechnungen aus einem monatlichen CSV-Export
  1. Die Buchhaltung lässt einen fallen CSV Datei mit monatlichen Rechnungen in Dropbox hochladen.
  2. Ein Watch Files-Trigger erkennt die neue Datei und ein Iterator verarbeitet jede Zeile.
  3. Erstellen ZUGFeRD Rechnung Läuft pro Zeile mit Eingabeformat CSVwodurch ein Hybrid entsteht PDF pro Rechnung.
  4. Alle PDFs werden in einen strukturierten Archivordner hochgeladen und eine E-Mail mit einer Abschlusszusammenfassung wird an das Finanzteam gesendet.
XRECHNUNG XML für die Rechnungsstellung im deutschen öffentlichen Sektor
  1. Eine Rechnung für einen Regierungsauftrag wird durch einen Airtable-Datensatz ausgelöst.
  2. Erstellen ZUGFeRD Rechnung Läuft mit Eingabeformat JSONAusgabemodus Nur XML, Version Ab 2 JahrenKonformitätsniveau XRECHNUNGDie
  3. Der XML Die Datei wird per POST-Anfrage direkt an den Peppol-kompatiblen Rechner des Käufers gesendet. ERP API über ein HTTP Modul.
  4. Eine Erfolgs- oder Fehlermeldung wird in einem Google Sheet protokolliert, damit das Finanzteam sie überprüfen kann.

Häufig gestellte Fragen

What is ZUGFeRD and why does it use a PDF?+
ZUGFeRD is a German and EU e-invoicing standard that combines a visually readable PDF/A-3 document with a machine-readable XML file embedded inside it. Humans can open the PDF in any viewer; ERP and accounting systems extract the XML automatically for processing. no manual data entry needed. The same format is called Factur-X in France and other EU markets, and both align to the EN 16931 European e-invoicing standard maintained by <a href="https://www.ferd-net.de/" target="_blank" rel="noopener">FeRD, the Forum elektronische Rechnung Deutschland</a>.
What is the difference between XmlWithPdf and XmlOnly output mode?+
XmlWithPdf produces a PDF/A-3 hybrid document with ZUGFeRD XML embedded as an attachment. this is the standard e-invoice format readable by both humans and ERPs. XmlOnly returns just the XML invoice file without any PDF wrapper, useful when the receiving system only needs the structured data and generates its own document view. Use XmlOnly with the XRECHNUNG conformance level for German public-sector submissions that require pure XML delivery.
Which Conformance Level and ZUGFeRD Version should I use?+
The available conformance levels depend on which zugferd Version you select. Version 1.0 supports BASIC, COMFORT, and EXTENDED. Version 2+ adds MINIMUM, BASICWL, EN16931, EXTENDED, and XRECHNUNG. Start with BASIC for the broadest buyer compatibility. it covers all mandatory EN 16931 fields. Move to EN16931 for cross-border EU compliance, or XRECHNUNG when submitting invoices to German federal and state government buyers who are legally required to accept the XRechnung profile.
Is ZUGFeRD the same as Factur-X?+
They are the same technical format under different 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 systems expecting Factur-X and vice versa. Version 1.0 is a German-only older specification; version 2.x is the aligned EU standard.
Can I only supply one input format per scenario run?+
Yes. Selecting XML shows the Invoice XML Data field, selecting JSON shows Invoice JSON Data, and selecting CSV shows Invoice CSV Data. Only fill in the field matching your chosen format in a given run. do not populate multiple data fields in the same execution. If you need to process different formats, split them into separate scenario branches with a Router module that filters by source type.
What does the Render Invoice on PDF option do?+
When Render Invoice on PDF is set to Yes, the module draws the invoice line items, totals, seller/buyer details, and payment information visually on the PDF pages. When set to No, the output is a PDF/A-3 container with the ZUGFeRD XML embedded but minimal or no visual rendering on the page. the PDF may appear nearly blank to a human reader. This option only applies when Output Mode is XmlWithPdf; it has no effect when using XmlOnly.

Verwandte Module

Dieselbe Aufgabe auf anderen Plattformen

Hilfe erhalten