Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog

Creare una fattura elettronica ZUGFeRD 2.0+ in Make: un flusso di lavoro Dropbox a 4 moduli

· 22 minuti di lettura
Sankalp Mishra
SEO and Content Writer

ZUGFeRD 2.0+ (anche noto come Fattore X in Francia e XRechnung nel settore pubblico tedesco) è un Fattura ibrida PDF/A3 con l'XML leggibile dalla macchina incorporato nel PDF. Un file che sia gli esseri umani che i sistemi ERP possono consumare. Questa guida illustra l'esecuzione esatta mostrata negli screenshot: una fattura base in PDF e un XML ZUGFeRD 2.0+ in Dropbox diventano una fattura elettronica ibrida conforme a EN16931 in /pdf4meoutput/, In 4 Crea moduli, zero codice.

Riepilogo dello scenario
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.
La versione breve

Quattro moduli Make end-to-end. Due Dropbox Scarica un file i passaggi estraggono il PDF di base e l'XML ZUGFeRD 2.0+ (gli screenshot mostrano YnooxTeststone collegamento più percorsi /pdf4metest/Fattura Zugfred/SimplePdf.pdf E /pdf4metest/FatturaZugfred/versione2.xml). PDF4me Crea una fattura ZUGFeRD incorpora l'XML nel PDF con Modalità di uscita XML con PDF, Versione ZUGFeRD 2+, Livello di conformità EN16931, Genera fattura in formato PDF SÌ, Lingua DiDropbox Carica un file scrive il risultato Formato ibrido PDF/A3 A /pdf4meoutput/ con File impostato su MappaNome del file 15. Nome, Dati 15. DocumentIl file di output si apre in qualsiasi lettore PDF e viene analizzato correttamente da qualsiasi sistema ERP che supporti ZUGFeRD / Factur-X / XRechnung.

Due fattori che determinano se il tuo sistema ERP accetta la fattura

Innanzitutto, il Livello di conformità deve corrispondere a quanto previsto dal sistema ERP dell'acquirente o del destinatario. EN16931 (Comfort) è l'impostazione predefinita legale tedesca e la scelta sicura per il B2B nell'UE; XRECHARGE è richiesto per la fatturazione B2G (settore pubblico) in Germania; DI BASE funziona per la maggior parte degli altri acquirenti. In secondo luogo, il Versione ZUGFeRD deve essere 2+ per qualsiasi cosa conforme alla norma EN 16931. Legacy 1.0 Utilizza BASIC / COMFORT / EXTENDED ed è incompatibile con i ricevitori EN 16931. Scegli 2+ a meno che il destinatario non richieda esplicitamente 1.0.

Domande comuni del mondo reale a cui questo risolve​

Le persone cercano questo specifico problema utilizzando frasi come:

  • "Come si crea una fattura ZUGFeRD con XML incorporato in Make?" Questo scenario a 4 moduli gestisce l'intero processo: modello PDF più fattura XML in ingresso, output in formato ibrido PDF/A-3.
  • "ZUGFeRD è la stessa cosa di Factur-X?" Sì. Stesso formato tecnico con nomi diversi. Un file ZUGFeRD 2.x è accettato dai sistemi che si aspettano Factur-X e viceversa.
  • "Quale livello di conformità dovrei scegliere?" EN16931 per B2B (conforme allo standard legale tedesco e alla norma UE EN 16931), XRECHNUNG per il settore pubblico tedesco (B2G), BASIC per la massima compatibilità con i sistemi preesistenti.
  • "Devo scrivere io stesso il codice XML?" No, ma in questo scenario gli screenshot utilizzano una fattura XML esistente. Il modulo accetta anche input JSON o CSV e genera automaticamente il file XML.
  • "E se il mio acquirente avesse bisogno solo del file XML, senza PDF?" Imposta la modalità di output su XML Only e il modulo restituisce solo il file di fattura XML anziché quello ibrido.

Cosa stai costruendo​

Uno scenario Make riutilizzabile che produce una fattura elettronica ibrida ZUGFeRD 2.0+ pienamente conforme a partire da un file PDF di base e un file di fattura XML. L'attivazione può essere manuale, pianificata (come mostrato), tramite il monitoraggio di file Dropbox o un webhook HTTP. L'output è un singolo file che soddisfa sia il requisito di leggibilità umana del PDF sia il requisito di leggibilità automatica dell'XML per le normative UE sulla fatturazione elettronica.

Creazione dello scenario canvas: Dropbox Scarica un file (PDF, con badge di orologio programmato) collegato a un secondo Dropbox Scarica un file (XML), collegato a PDF4me Crea una fattura ZUGFeRD, collegato a Dropbox Carica un file. Ogni modulo mostra un contatore di 1 iterazione e un segno di spunta verde che indica un'esecuzione riuscita.

Quattro moduli end-to-end. Due download, un'azione PDF4me, un upload. L'icona dell'orologio sul Modulo 1 indica un'attivazione programmata; è possibile passare alla modalità manuale/monitoraggio file/webhook in base alle proprie esigenze.

Ciò di cui hai bisogno​

  • Fare account con uno scenario aperto. Crea un account Make se ne hai bisogno.
  • Chiave API di PDF4me. Ottieni la tua chiave API e collegarsi al primo modulo PDF4me. Vedi Collega PDF4me per creare.
  • Dropbox con una cartella sorgente (ad esempio /pdf4metest/Fattura Zugfred/) contenente il modello PDF e la fattura XML, oltre a una cartella di output (/pdf4meoutput/).
  • Un PDF di base (gli screenshot utilizzano SimplePdf.pdfNon necessita di alcuna formattazione del layout. Il modulo incorpora l'XML come allegato PDF/A-3.
  • Una fattura XML ZUGFeRD 2.0+. Usa il tuo, oppure prendine uno Esempio XML 2.0 per seguire.

Guida rapida: a cosa serve ciascun parametro​

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.

Costruisci lo scenario​

Modulo 1: Download di un file tramite Dropbox (PDF di base)​

Scarica il file PDF di origine in cui verrà incorporato il codice XML di ZUGFeRD come allegato PDF/A3.

CampoValore utilizzato in questa esecuzione
ConnectionYnooxTestone (ynoox.test...). your Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Zugfred Invoice/SimplePdf.pdf
Configura il download di un file Dropbox per il PDF di base. Connessione YnooxTestone. Modalità di selezione dei file: Seleziona un file. Percorso file: /pdf4metest/Zugfred Invoice/SimplePdf.pdf.

Modulo 2: Download di un file da Dropbox (ZUGFeRD 2.0+ XML)​

Scarica il file XML della fattura ZUGFeRD. Il file XML contiene tutti i dettagli della fattura; il PDF è solo la rappresentazione grafica.

CampoValore utilizzato in questa esecuzione
ConnectionYnooxTestone (ynoox.test...). same Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Zugfred Invoice/version2.xml
Configura il download di un file Dropbox per ZUGFeRD 2.0+ XML. Connessione YnooxTestone. Modalità di selezione dei file: Seleziona un file. Percorso file: /pdf4metest/Zugfred Invoice/version2.xml.

Modulo 3: PDF4me Crea una fattura ZUGFeRD​

L'azione che esegue l'incorporamento vero e proprio. Mappa entrambi i file scaricati come input, scegli le impostazioni di conformità ed esegui.

GruppoCampoValore
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

Modulo 4: Caricamento di un file tramite Dropbox​

Salvare la fattura elettronica ibrida PDF/A-3 nella cartella di output.

CampoValore utilizzato in questa esecuzione
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)
Configura il caricamento di un file su Dropbox. Connessione YnooxTestone. Cartella /pdf4meoutput/. File impostato su Mappa. Nome file associato a 15. Nome (da PDF4me Crea una fattura ZUGFeRD). Dati associati a 15. Documento.

Salva e fai clic Eseguire una volta. Il PDF/A-3 ibrido arriva in /pdf4meoutput/ nel giro di un paio di secondi.

Get your API KeyFull action reference

File di esempio (XML, JSON, CSV)​

È possibile sostituire il Modulo 2 (XML) con uno qualsiasi di questi input e modificarlo Formato di input di conseguenza.

Risoluzione dei problemi​

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.

Quando utilizzare questo schema​

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.

Cosa leggere dopo​

FAQ​

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.

Inizia​

Get your API KeyPDF4me on MakeAction reference