Crea fattura ZUGFeRD in Zapier

Cosa fa questa azione

PDF4me Crea fattura ZUGFeRD genera pienamente conforme Fatture elettroniche ibride ZUGFeRD, UN PDF/Documento A-3 con struttura XML dati della fattura incorporati all'interno, direttamente all'interno del tuo Zapier flusso di lavoro. Converti XML, JSON, O CSV dati della fattura in un unico file ibrido pronto per l' Obbligo tedesco di fatturazione elettronica B2B (2025+)Conformità alla norma EN 16931 a livello europeo o al profilo tedesco XRECHNUNG per il settore pubblico. Supporta le versioni di ZUGFeRD dalla 1.0 alla 2.x e tutti i livelli di conformità: BASIC, COMFORT, EXTENDED, EN16931, XRECHNUNG, in un'unica azione Zap. Sostituzione diretta dei flussi di lavoro manuali di Adobe Acrobat, JustOn o ZUGFeRD Manager.

Autenticazione del tuo API Richiesta

Per accedere al PDF4me Web API Attraverso Zapier, ogni azione deve essere autenticata. Clicca Collega un nuovo account la prima volta e incolla il tuo PDF4me API Chiave, gli Zap successivi riutilizzano automaticamente la connessione.

Get your API Key PDF4me on Zapier

Informazioni importanti da non perdere

ZUGFeRD 2.0+ è un requisito obbligatorio per il mandato tedesco B2B del 2025

La legge Wachstumschancengesetz ha reso obbligatoria la ricezione delle fatture elettroniche a partire dal 1° gennaio 2025, con obbligo di invio completo entro il 2028. ZUGFeRD 2.0 o versioni successive, conformi alla norma EN16931 o XRECHNUNG, soddisfano il requisito: ZUGFeRD 1.0 non è conforme. In alcune installazioni, l'azione è impostata di default sulla versione 1.0; per gli ambienti di produzione, è necessario passare esplicitamente alla versione 2.0 o superiore.

Compilare un solo campo dati per ogni esecuzione, mai due.

Mappa soltanto il campo dati fattura corrispondente al tuo formato di input, dati XML fattura per XMLDati JSON della fattura per JSON, Dati CSV della fattura per CSVCompilare più campi "per sicurezza" interrompe la convalida e causa l'errore nella fase di esecuzione dello Zap.

Il livello di conformità EN16931 è il livello predefinito sicuro per la versione 2.x

Scegliere EN16931 per la fatturazione B2B generale dell'UE (ZUGFeRD 2.x), XRECHARGE per gli enti del settore pubblico tedesco, ESTESA per i campi specifici del settore. Per ZUGFeRD 1.0, BASIC è il livello minimo di fattura legale. MINIMUM e BASICWL omettono le voci e non costituiscono fatture legali a sé stanti.

Azione Zapier PDF4me Crea fattura ZUGFeRD nella fase Configura: File e nome file dalle fasi precedenti, formato di input XML, dati XML della fattura mappati da una fase precedente, modalità di output XmlOnly, versione Zugferd 1.0, livello di conformità BASIC, renderizza fattura su PDF vero, lingua de — Zapier azione **Specificare** scheda, mappa **File** / **Nome del file**, impostato **Formato di input** e il campo dati fattura corrispondente, quindi **Modalità di uscita**, **Versione Zugferd**, **Livello di conformità**, **Genera fattura in formato PDF**, E **Lingua**.

Parametri

Richiesto nel Zapier UI (contrassegnato da un asterisco): Formato di input, modalità di output, versione di Zugferd e livello di conformità. Condizionale: il campo dati fattura corrispondente (dati fattura XML, dati fattura JSON o dati fattura CSV) in base al formato di input. Per l'output XmlWithPdf: Il file e il nome del file (il PDF del modello) sono in genere richiesti dal connettore, anche se non sono contrassegnati da un asterisco in ogni layout. Opzionale: Genera fattura in formato PDF, lingua.

Parametro	Necessario	Cosa fa	Esempio
File	Conditional	Template/layout PDF that will hold the embedded XML in XmlWithPdf output. Map from a previous step (Dropbox, Google Drive, HTTP). Not required when Output Mode is XmlOnly.	`3. File: (Exists but not shown)`
File Name	Conditional	Filename of the template PDF (filename + extension). Required alongside File for XmlWithPdf output. Map both `File Name` and `File Ext` from the prior step.	`3. File Name: 10 page + 3. File Ext: .pdf`
Input Format	Yes	Format of the invoice payload: XML, JSON, or CSV. Determines which invoice data field below must be filled. Asterisked in the Zapier UI.	XML sample XML 2.0 sample JSON 2.0 EN16931 sample JSON (basic)CSV sample CSV 2.0 sample
Invoice Xml Data	Conditional	XML invoice payload. Required when Input Format is XML. Map from a previous file step that produced XML content. Leave empty for JSON/CSV inputs.	XML sample XML 2.0 sample`4. File: (Exists but not shown)`
Invoice Json Data	Conditional	JSON invoice payload. Required when Input Format is JSON. Best for webhook-driven or API-driven invoice data.	JSON 2.0 EN16931 sample JSON (basic)`4. Body`
Invoice Csv Data	Conditional	CSV invoice payload. Required when Input Format is CSV. Best for batch invoice exports from spreadsheets or legacy ERP exports.	CSV sample CSV 2.0 sample`4. File`
Output Mode	Yes	XmlWithPdf produces the hybrid PDF/A-3 + embedded XML (canonical ZUGFeRD). XmlOnly produces pure XML with no PDF wrapper. Asterisked.	`XmlOnly`
Zugferd Version	Yes	ZUGFeRD specification version. 1.0 is legacy. 2.0+ aligns with EN 16931 and satisfies the German B2B mandate. Asterisked.	`1.0`
Conformance Level	Yes	Profile controlling required invoice fields. For 1.0: BASIC, COMFORT, EXTENDED. For 2.x: MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG. Asterisked.	`BASIC`
Render Invoice On Pdf	No	Toggle (True / False). When True, PDF4me visually renders invoice content on the PDF. When False, only the XML is embedded: useful when the template PDF already shows the invoice layout.	`True`
Language	No	Two-letter locale code for printed invoice labels: de (German, default), en (English), fr (French), it (Italian), es (Spanish), nl (Dutch), pl (Polish), pt (Portuguese). The XML data itself remains language-neutral.	`de`

Opzioni di formato di input

Consente di controllare il formato dei dati utilizzato per il payload della fattura e quali campi dei dati della fattura è necessario compilare di seguito.

XMLPreassemblato XML fattura

È meglio quando sei ERP produce già conforme a ZUGFeRD XML o UBL XML che ha solo bisogno di essere avvolto nell'ibrido PDFMappa il file in Dati XML della fattura.

JSONModerno APIdati di origine

Ideale per flussi di lavoro basati su webhook o SaaS sistemi di fatturazione che emettono JSON. PDF4me mappe JSON campi allo ZUGFeRD XML schema automaticamente. Mappa in Dati JSON della fattura.

CSVEsportazione in foglio di calcolo o in batch

Ideale per l'esportazione in batch di fatture da Fogli Google, Excel, sistemi legacy o scenari di fatturazione riga per riga. PDF4me mappe CSV colonne allo schema. Mappa in Dati della fattura in formato CSV.

Opzioni della modalità di output

Consente di scegliere se produrre il file ibrido ZUGFeRD canonico o un file XML puro.

XML con PDFFile ibrido ZUGFeRD predefinito e completo

Produce l'ibrido ZUGFeRD standard: PDF/Archivio A-3 PDF con la struttura XML fattura incorporata all'interno come allegato. Gli umani leggono la PDF, le macchine analizzano il XML. Output canonico per la fatturazione elettronica B2B. Richiede la mappatura di File e Nome file.

Solo XMLPuro XML, NO PDF involucro

Produce solo la struttura XML fattura. Utilizzare per XRechnung pure-XML invii del settore pubblico, pipeline EDI, test del livello dati o sistemi che ingeriscono solo XML senza una rappresentazione visiva.

Opzioni di versione di Zugferd

La versione della specifica ZUGFeRD incorporata nella fattura generata. Determina quali opzioni di Livello di Conformità vengono visualizzate nel menu a tendina.

1.0Legacy, precedente alla norma EN 16931

Specifiche originali del 2014. Opzioni di conformità: BASE, COMFORT, ESTESANON soddisfa i requisiti tedeschi per la fatturazione elettronica B2B a partire dal 2025. Utilizzare solo per i destinatari legacy che richiedono esplicitamente la versione 1.0.

2.0+Raccomandato, conforme alla norma EN 16931

Conforme allo standard europeo EN 16931 e soddisfa il mandato B2B tedesco. Le opzioni di conformità includono MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNGLa scelta ideale per la fatturazione della produzione 2025+ e l'interoperabilità con Factur-X.

Opzioni di livello di conformità

Il profilo di conformità controlla quali campi della fattura sono obbligatori e convalidati. Le opzioni disponibili dipendono dalla versione di Zugferd scelta.

MINIMOSolo versione 2.x, solo file di intestazione

Solo dati di intestazione, senza voci di dettaglio. NON è una fattura legalmente valida. Solo per la consegna interna alla contabilità.

BASICWLSolo versione 2.x, solo IVA

Aggiunge i dettagli IVA ma nessuna voce specifica. Per scenari di sola prenotazione riconciliati con gli ordini.

DI BASEEntrambe le versioni, fattura legale minima

Aggiunge voci di riga. Soddisfa i requisiti minimi assoluti della direttiva UE sulla fatturazione elettronica. Disponibile nelle versioni 1.0 e 2.x.

COMFORTSolo versione 1.0, riferimenti estesi

Aggiunge dati di riferimento e campi aggiuntivi rispetto a BASIC. Solo per ZUGFeRD 1.0, equivalente a EN16931 nelle versioni 2.x più recenti.

EN169312.x, Impostazione predefinita B2B consigliata

Profilo completo della norma europea EN 16931. Il livello predefinito consigliato per la fatturazione B2B nell'UE e il livello di riferimento del mandato tedesco. Solo per ZUGFeRD 2.x.

ESTESAEntrambe le versioni, extra del settore

Aggiunge campi specifici del settore oltre a quelli di base (logistica, trasporto merci, riferimenti specifici di settore). Disponibile sia nella versione 1.0 che nella 2.x.

XRECHARGE2.x, obbligatorio per il settore pubblico tedesco

Il profilo CIUS XRechnung tedesco, obbligatorio per le fatture destinate alle autorità federali, statali e comunali. Validazione più rigorosa rispetto alla norma EN16931. Solo per ZUGFeRD 2.x.

Campi di output

Campo	Tipo	Cosa contiene
`File Content`	Binary	Generated ZUGFeRD invoice file: hybrid PDF/A-3 for XmlWithPdf output or pure XML for XmlOnly output. Map into the next Zap step (upload, email, ERP POST).
`File Url`	String	Direct URL to access the generated file: useful for sharing or downstream HTTP processing.
`File Name`	String	Output filename without extension.
`Full File Name`	String	Complete output filename with extension (.pdf for hybrid, .xml for XmlOnly).

Esempi di file di fattura

Utilizza questi file di esempio per testare l'azione 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à).

Esempio XML di ZUGFeRD

ZUGFeRD 1.0 BASIC XML. Utilizzare con Formati di input: XMLMappa in Dati XML della fattura.

ZUGFeRD-invoice-sample.xml

ZUGFeRD 2.0

Esempio XML di ZUGFeRD 2.0 (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

Esempio JSON 2.0 EN16931

Fattura strutturata completa per ZUGFeRD 2.0 con EN16931 conformità. Utilizzare con Formati di input: JSON, Zugferd Versione: 2.0, Livello di conformità: EN16931Mappa in Dati JSON della fattura.

sample-invoice-zugferd-2.0-en16931.json

Esempio di fattura JSON (base)

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

sample-invoice.json

Esempio di fattura in formato CSV

Piatto CSV riga per Formato di input: CSVMappa in Dati della fattura in formato CSV.

fattura-di-prova.csv

ZUGFeRD 2.0

Esempio di fattura in formato CSV 2.0

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 Formato di input: CSV, ZUGFeRD 2.0.

zugferd-invoice-2.0.csv

Configurazione rapida

In Zapier, clicca + per aggiungere una nuova azione e seleziona PDF4me.
Scegliere Crea fattura ZUGFeRD come evento di azione.
Collega il tuo PDF4me account o incolla il tuo API tasto quando richiesto.
Per XML con PDF output, mappa File E Nome del file al tuo layout PDF (spesso un passaggio di download precedente da Dropbox o Google Drive). Per Solo XML, questi possono essere lasciati vuoti.
Impostato Formato di input A XML, JSON, O CSV a seconda della fonte dei dati.
Riempire soltanto Il campo corrispondente ai dati della fattura: Dati XML della fattura, Dati JSON della fattura o Dati CSV della fattura. Lasciare vuoti gli altri due campi.
Impostato Modalità di uscita A XmlWithPdf (file ibrido, ZUGFeRD canonico) o Solo XML (puro) XML).
Scegliere Versione Zugferd: 2.0+ per la conformità al mandato tedesco B2B 2025+, 1.0 solo per ricevitori di vecchia generazione.
Scegliere Livello di conformità: EN16931 per B2B generale (2.x), XRECHARGE per il settore pubblico tedesco, DI BASE per la versione legacy di ZUGFeRD 1.0.
Attiva/disattiva Genera fattura in formato PDF A VERO se vuoi PDF4me per visualizzare il contenuto della fattura sul PDF; Falso se il tuo modello PDF mostra già il layout.
Impostato Lingua al codice locale corrispondente alla regione dell'acquirente (de, en, fr, it, es, nl, pl, pt).
Fare clic azione di prova, verifica l'output e accendi lo Zap.

Esempi di flusso di lavoro

Esempi di flusso di lavoroCommon Zapier workflow patterns using Create ZUGFeRD Invoice.

Webhook SaaS JSON → ZUGFeRD 2.x EN16931 → invia email al cliente

Tuo SaaS il sistema di fatturazione invia un webhook a Zapier quando viene emessa una fattura a un cliente B2B tedesco.
PDF4me Crea esecuzione fattura ZUGFeRD: Formato di input = JSON, Dati JSON della fattura mappati dal payload del webhook, Modalità di output = XmlWithPdf, Versione Zugferd = 2.0, Conformità = EN16931, Lingua = de.
L'ibrido PDF (leggibile dall'uomo + analizzabile dalla macchina) è allegato a un passaggio di Gmail e inviato all'indirizzo di fatturazione del cliente, soddisfacendo l'obbligo di fatturazione elettronica B2B previsto per il 2025 e successivi.
Una riga di Fogli Google registra l'ID della fattura, il cliente, l'importo e la data e l'ora per la creazione di report di controllo.
UN SharePoint carica archivi una copia dello ZUGFeRD PDF per il mantenimento della conformità.

Esportazione CSV ERP → XRECHNUNG → Portale del settore pubblico tedesco

Un processo Zap programmato viene eseguito ogni giorno feriale alle 16:00 per elaborare le fatture in sospeso del settore pubblico.
Un trigger di Dropbox rileva l'ultimo ERP CSV esportazione e layout PDF.
PDF4me Crea esecuzione fattura ZUGFeRD: Formato di input = CSV, Dati Csv della fattura = il CSV file, Output Mode = XmlWithPdf, Zugferd Version = 2.0, Conformance = XRECHNUNG, Language = de.
L'ibrido XRECHNUNG conforme PDF viene inviato tramite un passaggio Webhook al portale federale ZRE o all'endpoint di fatturazione elettronica statale pertinente.
Un'e-mail di conferma viene inviata al team AR con il riferimento dell'invio; un file di log di PostgreSQL registra la traccia di controllo.

XML precompilato → Solo XML → Integrazione con partner EDI

Tuo ERP genera già conforme a ZUGFeRD XML Le fatture vengono elaborate tramite il modulo di esportazione e salvate in una cartella di Google Drive.
Zapier attivazioni su ogni nuovo XML file. PDF4me Crea esecuzione fattura ZUGFeRD: Formato di input = XML, Dati XML della fattura = il XML file, Modalità di output = XmlOnly, Versione Zugferd = 2.0, Conformità = EN16931.
Il puro convalidatoXML La fattura viene inviata tramite SFTP all'endpoint EDI del partner commerciale, no PDF È necessario un wrapper per il passaggio di consegne tra sistemi.
Una notifica Slack conferma l'avvenuta consegna EDI; un record Airtable si aggiorna con il partner e la data e l'ora di invio.

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 can read the PDF in any viewer; ERP systems and accounting software extract and process the XML automatically without manual data entry. 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 for cross-border French-German invoicing. Use ZUGFeRD 2.x with EN16931 for general EU B2B, XRECHNUNG conformance for German public sector, and ZUGFeRD/Factur-X for international DACH-FR workflows.

Which ZUGFeRD Version should I choose in Zapier for the 2025 German B2B e-invoicing mandate?+

The German Wachstumschancengesetz (Growth Opportunities Act) made e-invoice receipt mandatory for all B2B transactions from 1 January 2025, with full sending obligations phasing in through 2028. ZUGFeRD 2.0 or higher with EN16931 or XRECHNUNG conformance is required to satisfy the mandate. ZUGFeRD 1.0 is legacy and does not comply. The Zapier action exposes 1.0 as a default in some installations: explicitly switch to 2.0+ for compliant production workflows. Confirm the exact version your trading partner or invoicing portal accepts; some larger enterprises and government portals may require version 2.2 or 2.4 specifically.

What is the difference between XmlWithPdf and XmlOnly output modes?+

XmlWithPdf generates the standard ZUGFeRD hybrid invoice: a PDF/A-3 archival document with the structured XML invoice data embedded as an attachment inside the PDF. Humans read the PDF, machines parse the XML: one file serves both audiences and is the canonical ZUGFeRD format for B2B. XmlOnly generates a pure XML file with no PDF wrapper, used when the receiving system only ingests XML, typical for XRechnung pure-XML public-sector portals, EDI pipelines, or data-layer integration testing. Choose XmlWithPdf for production B2B invoicing; XmlOnly for pure-XML system integration or compliance submissions that explicitly require XML-only delivery.

Which Conformance Level should I pick: BASIC, COMFORT, EXTENDED, EN16931, or XRECHNUNG?+

Conformance levels differ by ZUGFeRD version. For ZUGFeRD 1.0: BASIC (minimum legal invoice with line items), COMFORT (additional reference data on top of BASIC), and EXTENDED (industry-specific fields beyond the baseline) are available. For ZUGFeRD 2.x: MINIMUM (header only, not a legal invoice: for internal use only), BASICWL (Basic Without Lines, adds VAT but no line items, for booking-only), BASIC (line items, minimum EU directive), EN16931 (European Standard full profile, recommended default for EU B2B), EXTENDED (industry-specific fields), and XRECHNUNG (German public-sector mandatory profile with stricter validation). Start with BASIC for ZUGFeRD 1.0 workflows and EN16931 for ZUGFeRD 2.x B2B. Switch to XRECHNUNG when invoicing German federal, state, or municipal authorities.

Can I generate ZUGFeRD invoices from CSV data, and how do CSV, JSON, and XML inputs compare?+

Yes. The Input Format parameter supports XML, JSON, and CSV: pick the format matching your data source. CSV is ideal for batch invoice exports from spreadsheets (Google Sheets, Excel), legacy ERP exports, or per-row billing workflows where each row represents one invoice. JSON is the modern choice when invoice data arrives from a webhook, REST API, or SaaS billing system that emits structured JSON payloads. XML is best when your ERP already produces ZUGFeRD or UBL XML that just needs wrapping in the hybrid PDF. The action automatically maps CSV columns or JSON fields to the ZUGFeRD XML schema before embedding in the output PDF, no manual XML construction is required for CSV or JSON paths. Critical: fill ONLY the data field matching your chosen Input Format. Mapping both Invoice Xml Data and Invoice Csv Data in the same run will fail the validation step.