Crea fattura ZUGFeRD in n8n

Q: 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 document with embedded structured XML invoice data readable by both humans (the PDF) and machines (the XML). XRechnung is the German public sector profile, used for invoices to federal, state, and municipal authorities; it is a stricter pure-XML profile but is also available as a ZUGFeRD conformance level. Factur-X is the French sister format that uses the exact same hybrid PDF/A-3 + XML structure as ZUGFeRD 2.x and is fully compatible. Choose ZUGFeRD 2.x with EN16931 conformance for general B2B use, XRECHNUNG conformance for German public sector, and ZUGFeRD/Factur-X for cross-border French-German invoicing.

Cosa fa questo nodo

PDF4me Crea fattura Zugferd genera pienamente conforme Fatture elettroniche ibride ZUGFeRD (documenti PDF/A-3 con struttura XML dati della fattura incorporati all'interno) direttamente all'interno del tuo n8n flusso di lavoro. Converti XML, JSON, O CSV dati della fattura in un unico file ibrido pronto per l' Obbligo tedesco di fatturazione elettronica B2BConformità alla norma EN 16931 a livello europeo o al profilo del settore pubblico tedesco XRECHNUNG. Supporta tutte le versioni di ZUGFeRD dalla 1.0 alla 2.4 e tutti e sei i livelli di conformità in un unico nodo.

Autenticazione del tuo API Richiesta

Ogni PDF4me nodo in n8n richiede un valido Credenziali per connettersi con. Crea o selezionane uno che contenga il tuo PDF4me API chiave affinché il flusso di lavoro possa autenticare in modo sicuro le richieste di generazione di fatture ZUGFeRD.

Get your API Key

Informazioni importanti da non perdere

ZUGFeRD è un PDF/A-3 ibrido + XML formato, non puro XML standard

L'output è un singolo file PDF/A-3 di qualità archivistica PDF con la struttura XML fattura allegata all'interno. Gli umani leggono la PDF, le macchine analizzano il XML. Nessun file separato da inviare. Per generare puro XML senza il PDF Per il wrapper, impostare la modalità di output su Solo XML; per generare il file ibrido, impostarla su XML con PDF (impostazione predefinita).

ZUGFeRD 2.0+ è un requisito per il mandato B2B tedesco 2025-2028.

La legge tedesca Wachstumschancengesetz (Legge sulle opportunità di crescita) ha reso obbligatoria la ricezione delle fatture elettroniche per tutte le transazioni B2B a partire dal 1° gennaio 2025, con l'entrata in vigore graduale dell'obbligo di invio entro il 2028. La versione 2.0 o superiore di ZUGFeRD, conforme alla norma EN16931 o XRECHNUNG, soddisfa tale requisito. La versione precedente di ZUGFeRD 1.0 non è conforme.

Il livello di conformità controlla la conformità: EN16931 è l'impostazione predefinita sicura

Scegli EN16931 per la fatturazione B2B generale in tutta l'UE (lo standard europeo), XRECHNUNG per la fatturazione agli enti del settore pubblico tedesco e EXTENDED per i campi specifici del settore che vanno oltre lo standard EN 16931. MINIMUM e BASICWL omettono le voci e non possono essere utilizzati per la fatturazione completa; sono adatti solo per i trasferimenti contabili interni.

Parametri

Richiesto nel n8n Interfaccia utente: Credenziali di connessione, Tipo di dati di input, Nome del documento (sempre richiesto anche quando Tipo di dati di input è Nessuno, utilizzato come fallback per il nome del documento), Modalità di output, Versione di Zugferd, Genera fattura in PDF, Lingua, Formato di input e Tipo di input dei dati della fattura. Livello di conformità viene mostrato e richiesto in base al ramo della versione di Zugferd, con nome del campo e set di opzioni diversi per 1.0 vs 2.0/2.1/2.2/2.4 vs Personalizzato. Il campo dati fattura corrispondente (Fattura XML/JSON/CSV Dati, proprietà binaria, Base64 Il contenuto (o URL dei dati) è obbligatorio in base al tipo di input dei dati della fattura. La convalida in fase di esecuzione impone la presenza di un contenuto non vuoto nel percorso scelto, con messaggi di errore come "I dati della fattura... sono obbligatori" o "Il contenuto base64 della fattura è obbligatorio".

Parametro	Necessario	Cosa fa	Esempio
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 sample XML 2.0 sample JSON 2.0 EN16931 sample JSON (basic)CSV sample CSV 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 sample XML 2.0 sample JSON 2.0 EN16931 sample JSON (basic)CSV sample CSV 2.0 sample`Paste, 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`

Esempi di file di fattura

Utilizza questi file di esempio per testare il nodo con ciascun formato di input prima di connettere la tua origine dati reale. Per i flussi di lavoro di produzione B2B tedeschi, inizia con sample-invoice-zugferd-2.0-en16931.json ZUGFeRD 2.0, EN16931 conformità).

AMMANETTATO XML Campione

ZUGFeRD 1.0 BASIC XML. Utilizzare con Formati di input: XML. Incolla o mappa in Fattura XML Dati.

ZUGFeRD-invoice-sample.xml

ZUGFeRD 2.0

ZUGFeRD 2.0 XML Esempio (EN16931)

ZUGFeRD 2.0 EN16931 XML con parti venditore/acquirente, voci di riga, IVA e somma monetaria nel formato CrossIndustryInvoice. Utilizzare con Formati di input: XML, Versione ZUGFeRD: 2.0, Conformità: EN16931.

ZUGFeRD-invoice-sample-2.0.xml

Raccomandato

JSON 2.0 Campione EN16931

Fattura strutturata completa per ZUGFeRD 2.0 con EN16931 conformità. Utilizzare con Formati di input: JSON, Zugferd Versione: 2.0, Livello di conformità: EN16931. Incolla o mappa in Fattura JSON Dati.

sample-invoice-zugferd-2.0-en16931.json

JSON Esempio di fattura (base)

Più semplice JSON per prove di fumo con ZUGFeRD 1.0 E DI BASE conformità.

sample-invoice.json

CSV Esempio di fattura

Piatto CSV riga per Formati di input: CSV. Incolla o mappa in Fattura CSV Dati.

fattura-di-prova.csv

ZUGFeRD 2.0

CSV 2.0 Esempio di fattura

Colonna estesa a 22 colonne CSV: ID fattura, data di emissione, campi indirizzo venditore/acquirente, ID partita IVA venditore, ID prodotto, valuta, riferimento pagamento, IBAN, BIC. Da usare con Formati di input: CSV, ZUGFeRD 2.0.

zugferd-invoice-2.0.csv

Opzioni avanzate

Tutti i campi all'interno del Opzioni avanzate Le collezioni sono facoltative. Aggiungile tramite Aggiungi opzione nell'interfaccia utente del nodo.

profili

Costume PDF4me Profili di elaborazione. Applica set di opzioni preconfigurati per la generazione avanzata o specializzata di fatture ZUGFeRD (ad esempio, regole di convalida personalizzate, mappature di schema alternative o ottimizzazione dell'output specifica per settore).

Opzioni del tipo di dati di input

Controlla come il sfondo PDF documento (il livello visivo della fattura ibrida) viene fornito al nodo.

Menu a tendina Tipo di dati di input nel nodo Crea fattura Zugferd di n8n PDF4me che mostra quattro opzioni: Nessuno con descrizione Nessun input di documento richiesto (solo XML/JSON/CSV), Dati binari evidenziati con descrizione Usa file dal nodo precedente, Stringa Base64 con descrizione Fornisci il contenuto del file come stringa codificata in base64 e URL con descrizione Fornisci l'URL del file — Menu a tendina Tipo di dati di input: controlla come lo sfondo PDF raggiunge il nodo

NessunoSolo XML/JSON/CSV, nessun PDF di sfondo

Non è richiesto l'inserimento di alcun documento. PDF4me genera sia l'aspetto visivo PDF strato e strutturato XML dai soli dati della fattura. Usalo quando esistono solo i dati della fattura e vuoi PDF4me per renderizzare il file ibrido completo.

Dati binariFile dal nodo precedente (il più comune)

Legge le informazioni di base PDF binario direttamente dall'output di un precedente n8n nodo: Download da Google Drive, HTTP Richiesta o lettura del file binario. Il campo Proprietà binario specifica quale campo di output leggere (predefinito) dati).

Stringa Base64Contenuto del file codificato in Base64

Accetta lo sfondo PDF come stringa codificata in base64. Usala quando il file arriva da un API risposta, payload webhook o una colonna del database che memorizza i documenti in formato base64.

URLScarica da un link pubblico

Fornire un accesso pubblico URL sullo sfondo PDF. PDF4me scarica il file direttamente prima di generare la fattura ibrida. URL non deve richiedere autenticazione.

Opzioni della modalità di output

Controlla se il nodo produce un puro XML file o l'ibrido ZUGFeRD completo (PDF/A-3 + incorporato) XML).

Menu a tendina Modalità di output nel nodo Crea fattura Zugferd di n8n PDF4me che mostra due opzioni: Solo XML con descrizione Genera solo il file XML e XML con PDF evidenziato con descrizione Genera XML incorporato nel PDF — Menu a tendina Modalità di output con due opzioni: puro XML o PDF/A-3 ibrido con XML incorporato

Solo XMLPuro XML, NO PDF involucro

Produce solo output strutturati XML dati della fattura. Da utilizzare quando il sistema ricevente elabora il XML direttamente e scarta il contenuto visivo, per gli invii XRechnung in puro XML o per testare il livello dati in isolamento. Imposta l'estensione del nome del file di output su .xml.

XML con PDFPredefinito: file ibrido ZUGFeRD completo

Genera la fattura ibrida standard ZUGFeRD: un file PDF/A-3 di qualità archivistica PDF con la struttura XML dati della fattura incorporati all'interno come allegato. Gli umani leggono il PDF, le macchine analizzano il XMLQuesto è l'output canonico di ZUGFeRD per la fatturazione elettronica B2B in ambito produttivo.

Opzioni di versione di ZUGFeRD

La versione della specifica ZUGFeRD è incorporata nella fattura generata.

Menu a tendina Versione Zugferd nel nodo Crea fattura Zugferd di n8n PDF4me che mostra le opzioni: 1.0, 2.0 evidenziate, 2.1, 2.2, 2.4 e Personalizzato, con tooltip che mostra Parametro: zugferdVersion — Menu a tendina Versione ZUGFeRD con sei opzioni di versione, tra cui la versione precedente 1.0 e l'ultima 2.4

1.0Stato attuale: non soddisfa il mandato del 2025

Specifiche originali del 2014. Compatibile solo con sistemi di ricezione legacy. non Conformarsi all'obbligo tedesco di fatturazione elettronica B2B in vigore dal 2025. Evitare per i nuovi flussi di lavoro.

2.0Predefinito: ampia compatibilità

La prima versione conforme alla norma EN 16931 (2019). Soddisfa i requisiti tedeschi per la fatturazione B2B ed è la soluzione predefinita sicura per la fatturazione B2B in generale. Pienamente compatibile con Factur-X 1.0.

2.1Piccoli perfezionamenti

Aggiunge piccoli miglioramenti e chiarimenti allo schema rispetto alla versione 2.0. Da utilizzare quando il sistema ricevente richiede specificamente la versione 2.1.

2.2Profilo XRECHNUNG aggiornato

Conforme alla versione aggiornata 2.x del profilo XRECHNUNG. Selezionare questa opzione quando si emettono fatture agli enti del settore pubblico tedesco che richiedono il profilo più recente.

2.4Ultimo aggiornamento: supporto XRECHNUNG più recente

Specifiche rilasciate più di recente. Include il supporto per il profilo XRECHNUNG più recente e i miglioramenti dello schema. Selezionare questa opzione quando la parte ricevente richiede la versione più recente.

CostumeGestione avanzata delle versioni

Consente la gestione personalizzata delle versioni quando un sistema ricevente specifico richiede un identificatore di versione non standard. Utilizzare solo se esplicitamente richiesto dalla controparte di fatturazione.

Opzioni di livello di conformità

Il profilo di conformità controlla quali campi della fattura sono obbligatori e convalidati, la scelta più critica ai fini della conformità.

Menu a tendina Livello di conformità nel nodo Crea fattura Zugferd di n8n PDF4me che mostra sei opzioni: MINIMUM, BASICWL, BASIC, EN16931 evidenziato, ESTESA e XRECHNUNG — Menu a tendina Livello di conformità con sei profili, da MINIMO a XRECHNUNG, per il controllo dei requisiti di campo e dell'ambito di conformità.

MINIMOSolo intestazione, non è una fattura valida

Solo dati di intestazione: parti, totali, riferimenti ai documenti. Nessuna voce specifica. Non può essere utilizzato come fattura legale; solo per registrazioni contabili interne o notifiche di stato.

BASICWLBase senza linee: solo IVA

Aggiunge le ripartizioni IVA/tasse oltre al MINIMO. nessuna voce di riga. Utilizzato in scenari di sola prenotazione in cui le fatture vengono riconciliate con gli ordini, non come fatture legali autonome.

DI BASEFattura legale minima

Aggiunge voci di riga in aggiunta a BASICWL. Soddisfa i requisiti minimi assoluti della direttiva UE sulla fatturazione elettronica. Accettabile per fatture semplici, ma EN16931 è la soluzione predefinita più sicura per la piena conformità B2B.

EN16931Predefinito: Standard europeo

Profilo completo della norma europea EN 16931. Impostazione predefinita consigliata per la fatturazione B2B in tutta l'UE e il livello di conformità a cui fa riferimento il mandato tedesco del 2025. Include tutti i campi necessari per una fatturazione aziendale conforme.

ESTESAExtra specifici del settore

Aggiunge campi specifici del settore oltre a quelli previsti dalla norma EN 16931, ad esempio riferimenti aggiuntivi relativi a logistica, trasporto merci o settori specifici. Da utilizzare quando l'accordo di settore o il partner commerciale richiedono i campi ESTESI.

XRECHARGEobbligatorio nel settore pubblico tedesco

Il profilo CIUS XRechnung tedesco, Obbligatorio per le fatture destinate alle autorità federali, statali e comunali tedesche. Validazione più rigorosa rispetto alla norma EN16931. Da utilizzare quando il destinatario è un ente del settore pubblico tedesco.

Opzioni di lingua

Lingua di visualizzazione per le etichette della fattura nel rendering PDF strato. Lo XML I dati stessi sono indipendenti dalla lingua.

Menu a tendina Lingua in n8n Crea fattura Zugferd che mostra tedesco, francese, italiano, inglese, spagnolo, olandese, polacco e portoghese — **Lingua**: etichette localizzate per il rendering PDF (Il tedesco è tipico per il B2B e il B2G in Germania).

tedescoPredefinito, tedesco B2B/B2G

IngleseFatturazione internazionale

franceseFlussi di lavoro di Factor-X

ItalianoB2B italiano

spagnoloB2B spagnolo

OlandesePaesi Bassi/Belgio

PolaccoPolonia B2B

portoghesePortogallo/Brasile

Opzioni di formato di input

Formato dei dati di fatturazione che fornisci al nodo.

Menu a tendina Formato di input in n8n Crea fattura Zugferd che mostra le opzioni XML, JSON e CSV con JSON selezionato — **Formato di input**: scegliere `XML`, `JSON`, O `CSV` per corrispondere al payload della tua fattura.

XMLPreassemblato XML fattura

Fornitura già formattata conforme a ZUGFeRD XML o UBL XML dati. Usa quando il tuo ERP già produce standard XML fatture che hanno solo bisogno di essere incapsulate nell'ibrido PDF.

JSONPredefinito: moderno API fonte

Fornire i dati della fattura in forma strutturata JSON oggetto. La scelta più comune quando i dati della fattura arrivano da un webhook, REST API, o un software di contabilità moderno. PDF4me mappe JSON campi allo ZUGFeRD XML schema automaticamente.

CSVDati tabellari delle fatture batch

Fornire i dati della fattura come CSVUtile per l'esportazione in batch di fatture da fogli di calcolo, sistemi legacy o scenari di fatturazione di massa. PDF4me mappe CSV colonne allo schema ZUGFeRD.

Opzioni per il tipo di immissione dei dati della fattura

Controlla come i dati della fattura (il XML, JSON, O CSV contenuto) Raggiunge il nodo.

Menu a tendina "Tipo di input dati fattura" in n8n Crea fattura Zugferd che mostra le opzioni Testo diretto, Dati binari, Stringa Base64 e URL — **Tipo di immissione dati fattura**: come il XML, JSON, O CSV Il payload viene fornito (in linea, binario da un nodo precedente, base64 o URL).

Testo direttoPredefinito: incolla o mappa in linea

Incolla o mappa i dati della fattura direttamente nel campo Dati fattura. Ideale per JSON o più piccolo CSV payload dai nodi a monte. Utilizzare n8n Sintassi delle espressioni per costruire dinamicamente i dati.

Dati binariFile dal nodo precedente

Legge il file dei dati della fattura (XML, JSON, O CSV) direttamente dall'output binario di un precedente n8n nodo: Download da Google Drive, Leggi file binario o HTTP Richiesta. Ideale per grandi XML file.

Stringa Base64Dati codificati in Base64

Accetta i dati della fattura come stringa codificata in base64. Da utilizzare quando il contenuto della fattura arriva da un API risposta o campo del database che memorizza i file in formato base64.

URLScarica da un link pubblico

Fornire un accesso pubblico URL al file dei dati di fatturazione. PDF4me Scarica il file e ne analizza il contenuto in base al formato di input selezionato.

Campi di output

Campo	Tipo	Cosa contiene
`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.

Configurazione rapida

Aggiungere PDF4me al tuo n8n flusso di lavoro. Imposta Risorsa A Fattura E Operazioni di fatturazione A Crea fattura Zugferd.
In Credenziali per connettersi con, seleziona il tuo PDF4me credenziali o clicca Crea nuove credenziali e incolla il tuo API chiave.
Impostato Tipo di dati di input: collega un nodo precedente (dati binari), fornisci un Base64 corda o URL per il contesto PDF, oppure seleziona Nessuno quando PDF4me dovrebbe rendere il PDF dai soli dati di fatturazione.
Inserisci Nome reale (Per esempio invoice.pdf).
Impostato Modalità di uscita: XML con PDF per l'uscita ibrida standard ZUGFeRD, oppure Solo XML per puro XML.
Scegliere Versione Zugferd (utilizzo 2.0 come opzione predefinita sicura; 2.4 (per il profilo XRECHNUNG più recente).
Scegliere Livello di conformità: EN16931 per il B2B in generale, XRECHARGE per la fatturazione del settore pubblico tedesco, ESTESA per settori specifici dell'industria.
Impostato Lingua per il reso PDF etichette (tedesco per impostazione predefinita).
Abilitare Genera fattura in formato PDF se vuoi PDF4me per visualizzare il contenuto della fattura; disabilitare quando si fornisce uno sfondo predefinito PDF.
Scegliere Formato di input JSON, XML, O CSV) E Tipo di immissione dati fattura (Testo diretto, dati binari, stringa Base64 o URL). Incolla o mappa i dati della fattura nel campo Dati fattura.
Impostato Nome del file di output A zugferd_invoice.pdf E Nome del campo binario di output A data.
Collega l'output al nodo successivo (mittente di e-mail, caricamento su cloud storage, portale governativo) HTTP POST) ed eseguire il flusso di lavoro.

Esempi di flusso di lavoro

Esempi di flusso di lavoroCommon n8n workflow patterns using Create Zugferd Invoice.

Software di contabilità → ZUGFeRD 2.0 Fattura EN16931 → invia email al cliente

Un trigger Webhook si attiva quando una fattura viene finalizzata nella piattaforma contabile (DATEV, sevDesk, lexoffice).
Il payload del webhook contiene i dati della fattura come un formato strutturato JSON oggetto.
PDF4me La creazione della fattura Zugferd genera la fattura ibrida. Il tipo di dati di input è Nessuno (PDF4me rende il PDF dal JSON). La modalità di output è XML con PDF, la versione di Zugferd è 2.0, il livello di conformità è EN16931, la lingua è tedesco, il formato di input è JSONIl tipo di input dei dati della fattura è Testo diretto mappato dal payload del webhook.
Un nodo Gmail invia un'email allo ZUGFeRD PDF all'indirizzo di fatturazione del cliente, in conformità con il requisito tedesco del mandato di ricezione B2B.
Un nodo PostgreSQL registra il numero di fattura, la versione di ZUGFeRD e il livello di conformità per la creazione di report di audit e conformità.

ERP XML fattura → ZUGFeRD XRECHNUNG → carica sul portale del settore pubblico

Un trigger di pianificazione si attiva ogni giorno feriale alle 16:00 per elaborare le fatture del settore pubblico.
Un nodo SFTP scarica i dati appena generati ERP XML File delle fatture dalla cartella di esportazione.
PDF4me La creazione della fattura Zugferd genera una fattura XRECHNUNG conforme. Il tipo di dati di input è Nessuno, la modalità di output è XML con PDF, la versione di Zugferd è 2.4 (ultimo profilo XRECHNUNG), il livello di conformità è XRECHNUNG, la lingua è tedesco, il formato di input è XMLIl tipo di input dei dati della fattura è Dati binari mappati dal contenuto del file SFTP.
UN HTTP Il nodo richiedente carica la fattura XRECHNUNG sulla piattaforma federale ZRE (Piattaforma centrale di ricezione fatture del governo federale) o sul portale statale competente.
Un Microsoft Outlook Un nodo invia una conferma al team acquisti e un nodo PostgreSQL registra il riferimento dell'invio.

Mensile CSV batch di fatturazione → fatture ZUGFeRD → archivia in SharePoint

Un trigger programmato si attiva il primo giorno di ogni mese per elaborare il ciclo di fatturazione mensile.
Un nodo di Google Drive scarica il consolidato CSV Esportazione della fatturazione, una riga per fattura cliente.
Un nodo Split In Batches itera su ciascuno CSV riga. PDF4me Crea fattura Zugferd genera una fattura ZUGFeRD per cliente. Il tipo di dati di input è Nessuno, la modalità di output è XML con PDF, la versione di Zugferd è 2.0, il livello di conformità è EN16931, la lingua varia in base alle impostazioni locali del cliente, il formato di input è CSVIl tipo di input dei dati della fattura è Testo diretto con contenuto CSV per riga.
Un Microsoft SharePoint carica ogni nodo ZUGFeRD PDF nella cartella di archivio della fatturazione del cliente.
Un nodo Gmail invia a ciascun cliente la propria fattura ibrida; una riga di riepilogo finale in PostgreSQL registra l'esecuzione del batch con il numero di fatture e l'importo totale.

Domande frequenti

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.