Passa al contenuto principale

Crea fattura ZUGFeRD in Power Automate

Crea fattura ZUGFeRD è un Power Automate azione da PDF4me che genera una fattura elettronica ibrida conforme a ZUGFeRD, una singola PDF/File A-3 con struttura XML incorporato all'interno. Usalo per soddisfare l'obbligo di fatturazione elettronica B2B della Germania, scambia fatture allineate alla norma EN 16931 con qualsiasi ERPoppure archiviare un file che possa essere letto sia dagli esseri umani che dalle macchine.

Cosa fa questa azione

PDF4me Crea fattura ZUGFeRD costruisce un Fattura elettronica ibrida conforme a ZUGFeRD, un singolo PDF/A-3 archivio PDF con fattura strutturata XML incorporato all'interno, direttamente in un Power Automate flusso. Gli umani leggono il PDF; ERPe le piattaforme di compensazione analizzano il XML. L'azione soddisfa Obbligo tedesco di fatturazione elettronica B2B (in vigore dal 1° gennaio 2025 per la ricezione, invio completo entro il 2028) e il sottostante IN 16931 Standard europeo. Mappa i dati della fattura come XML, JSON, O CSV da SharePoint, OneDrive, Outlook, o Dataverse, e instradare l'output ibrido al tuo archivio, il tuo ERP, o il tuo cliente in un solo passaggio.

Articoli correlati del blog(2)
Come si crea una fattura ZUGFeRD in Power Automate? Un flusso di lavoro passo passo con Dropbox e JSON.
Automatizza il flusso di lavoro per creare fatture ZUGFeRD/Factur-X da file PDF + JSON di Dropbox utilizzando PDF4me. Crea la fattura ZUGFeRD, quindi salva l'output su Dropbox.
Leggi il post
Creare una fattura ZUGFeRD in Power Automate da un PDF + XML di Dropbox: un flusso di lavoro in 5 fasi
Flusso Power Automate a cinque azioni: Attivazione manuale, Dropbox Ottieni il contenuto del file per il PDF di base (/pdf4metest/sample/10 page.pdf), Ottieni il contenuto del file per l'XML ZUGFeRD (/pdf4metest/zugfred invoice/version2.xml), PDF4me Crea fattura ZUGFeRD (2.0-XML, XmlWithPdf, BASIC, rendering attivo, lingua de), Dropbox Crea file in /pdf4meoutput. Incorpora XML allineato alla norma EN 16931 in un ibrido PDF/A-3 che soddisfa il mandato B2B tedesco del 2025. Screenshot reali, valori dei campi esatti.
Leggi il post

Come posso autenticare il mio flusso di Power Automate?

Per chiamare PDF4me Attraverso Power Automate, il flusso necessita di un valido PDF4me API chiave sulla PDF4me Connetti Connettore. L'autenticazione garantisce una comunicazione sicura e convalida la tua identità come utente autorizzato. Ottieni o ruota la tua chiave dalla dashboard dello sviluppatore.

Informazioni importanti da non perdere

ZUGFeRD è ibrido PDF/A-3 + incorporato XML, non un puro XML formato
L'impostazione predefinita XmlWithPdf L'output è un file: un archivio PDF/A-3 con la struttura ZUGFeRD XML attaccato al suo interno. Gli umani aprono il PDF; I sistemi AP analizzano il XML. Impostato Solo XML solo quando il sistema ricevente consuma puro XML.
Il mandato tedesco B2B del 2025 richiede ZUGFeRD 2.0 o superiore.
La legge tedesca Wachstumschancengesetz (Legge sulle opportunità di crescita) ha reso obbligatoria la ricezione della fattura elettronica a partire da 1° gennaio 2025, con l'entrata in vigore graduale degli obblighi di invio completi da 2028Le versioni di ZUGFeRD 2.0 e successive (conformi alla norma EN 16931) soddisfano i requisiti; la versione precedente 1.0 non li soddisfa. Selezionare la versione più recente supportata dal connettore (viene visualizzata nel menu a tendina combinato Versione ZUGFeRD + Formato di input).
Mappa UN solo campo dati della fattura, mai due
L'azione mostra Dati XML della fattura, Dati JSON della fattura, O Dati della fattura in formato CSV In base alla sezione "Formato" del menu a tendina combinato. Mappa solo l'opzione corrispondente. L'inserimento di due campi dati nella stessa esecuzione è la causa più comune di errori di convalida.
Crea un'azione di fattura ZUGFeRD in Power Automate che mostra la scheda principale Parametri con la versione di ZUGFeRD e il formato di input impostati su 2.0-XML, Modalità di output XmlWithPdf, Dati XML della fattura mappati dal contenuto del file, Livello di conformità BASIC, Visualizza fattura in PDF Sì, Contenuto del file mappato da un'azione precedente e Nome file abc.pdf

Principale Parametri tab. Versione e formato di input di ZUGFeRD è un menu a tendina combinato (qui 2.0-XML).

Crea l'azione Fattura ZUGFeRD in Power Automate mostrando la sezione Parametri avanzati con Mostra 1 di 1 e il campo Lingua impostato su de

Parametri avanzati. Lingua predefinito a Di; accetta anche en, fr, it, es, nl, pl, pt, cs.

ZUGFeRD vs Factur-X vs XRechnung: scegli il profilo giusto

FormatoDove viene utilizzatoTipo di outputScegli quando
ZUGFeRDGermany, EU B2B, supplier-to-buyer invoicingHybrid PDF/A-3 + embedded XMLGeneral B2B; you want one file for humans and machines.
Factur-XFrance (sister format, technically identical to ZUGFeRD 2.x)Hybrid PDF/A-3 + embedded XMLCross-border FR<>DE invoicing; the same hybrid file works on both sides.
XRechnungGerman public sector (federal, state, municipal)Strict pure XML profileYou invoice a German public-sector authority; switch to an XRechnung-aligned profile when the receiver demands pure XML.

Parametri

Richiesto nell'azione: Versione ZUGFeRD e formato di input, modalità di output, la corrispondenza Fattura XML / JSON / CSV Dati campo e livello di conformità. PDF Contenuto del file E Nome del file diventano necessari solo quando la modalità di output è XmlWithPdf. Nome del file di output Imposta il nome del file ibrido generato. Emetti fattura su PDF Il valore predefinito è true. Lingua vive sotto Parametri avanzati e per impostazione predefinita Di.

ParametroNecessarioCosa faEsempio
ZUGFeRD version and Input FormatRequiredCombined dropdown that picks both the ZUGFeRD specification version (1.0, 2.0, etc.) and the shape of your invoice data (XML, JSON, CSV) in a single setting. The value drives which Invoice Data field appears below and which Conformance Level set is offered.2.0-XML
Output ModeRequiredXmlWithPdf returns the canonical hybrid PDF/A-3 file with the XML embedded inside. XmlOnly returns the XML invoice file alone. PDF File Content and File Name are only required for XmlWithPdf.XmlWithPdf
Invoice XML DataConditionalRequired when the Input Format part of the combined dropdown is XML. Map your ZUGFeRD XML payload from a previous action (Get file content, Compose, etc.).File Content
Invoice JSON DataConditionalRequired when the Input Format part is JSON. Map a structured invoice JSON object that PDF4me converts to the ZUGFeRD XML schema before embedding.File Content
Invoice CSV DataConditionalRequired when the Input Format part is CSV. Map a tabular CSV row that PDF4me converts to the ZUGFeRD XML schema before embedding.File Content
Conformance LevelRequiredProfile that controls how rich the invoice data must be. BASIC is the entry-level profile with line items, suitable for most B2B receivers. COMFORT adds additional fields for richer content. EXTENDED is the largest set, used for industry-specific scenarios beyond the EN 16931 baseline.BASIC
Render Invoice on PDFRequiredWhen set to Yes (default), PDF4me visually renders the invoice content on the PDF pages using your invoice data. Set to No when you supply a pre-designed background PDF and only need the XML embedded without redrawing the content.Yes
PDF File ContentConditionalRequired when Output Mode is XmlWithPdf. Map the background PDF bytes from a previous action (Get file content from SharePoint / OneDrive / Outlook / Dataverse). Skip for XmlOnly.File Content
File NameConditionalRequired when Output Mode is XmlWithPdf. The source PDF filename with extension. Used for trace and naming context.abc.pdf
Output File NameOptionalFilename of the generated hybrid file or XML. Use .pdf for XmlWithPdf and .xml for XmlOnly. Helps when the downstream Create file action expects an explicit name.Zugferd-output.pdf
LanguageOptionalAdvanced parameter. Locale used for invoice labels in the rendered PDF. Default de. Accepted codes: de, en, fr, it, es, nl, pl, pt, cs. The XML data itself stays language-neutral.de

Opzioni della modalità di output

XmlWithPdfPredefinito. File ibrido ZUGFeRD canonico
Uno PDF/Fascicolo A-3 con la fattura strutturata XML allegato al suo interno. Da utilizzare per la fatturazione in uscita ai clienti, l'archiviazione in SharePoint, attaccandosi a Outlook email, o ovunque un singolo artefatto debba servire sia ai lettori umani che a quelli automatici.
Solo XMLAutonomo XML fattura
Restituisce la fattura ZUGFeRD XML da solo. Utilizzare quando si riceve ERP, clearing house o middleware ingestione XML direttamente e visivamente PDF viene generato altrove o non è richiesto. PDF Il contenuto del file e il nome del file non sono obbligatori.

Scala dei livelli di conformità

DI BASEPredefinito. Massima compatibilità con i ricevitori.
Profilo base con voci di dettaglio, ripartizione delle imposte e parti coinvolte. Conforme alla direttiva UE minima sulla fatturazione elettronica e accettato dalla maggior parte dei destinatari B2B. Inizia da qui per i test di compatibilità.
COMFORTContenuto della fattura più ricco
Aggiunge ulteriori campi strutturati oltre a BASIC. Spostati qui quando il tuo acquirente o ERP Richiede un payload della fattura più completo rispetto al minimo. Verificare la compatibilità prima di passare da BASIC.
ESTESAIl set più ampio, specifico per settore
Aggiunge campi specifici del settore oltre a quelli previsti dalla norma EN 16931. Utilizzare solo quando il destinatario lo richiede esplicitamente; in caso contrario, un contenuto più ricco aumenta la probabilità di problemi di validazione.

Opzioni lingua (Avanzate)

La sezione Parametri avanzati espone un campo, LinguaControlla solo le impostazioni locali utilizzate per le etichette disegnate sull'elemento visivo. PDF; IL XML i dati rimangono indipendenti dalla lingua. Il valore predefinito è de.

CodiceLinguaUso tipico
deGermanDefault. German domestic invoicing.
enEnglishCross-border B2B in English-speaking markets.
frFrenchFrance or French-speaking Switzerland (also pairs with Factur-X workflows).
itItalianItaly or Italian-speaking Switzerland.
esSpanishSpain and Spanish-speaking partners.
nlDutchNetherlands and Flemish Belgium.
plPolishPoland.
ptPortuguesePortugal and Portuguese-speaking partners.
csCzechCzechia.

Esempi di file di fattura

Utilizzali per testare il flusso con ciascun formato di input prima di connettere la tua origine dati live. Per i flussi di lavoro di produzione B2B tedeschi allineati al mandato 2025, inizia con il JSON 2.0 EN16931 campione.

AMMANETTATO XML Campione
ZUGFeRD 1.0 BASIC XML. Scegliere 1.0-XML nel menu a tendina combinato, quindi mappa questo 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 dettaglio, IVA e somma monetaria nel formato CrossIndustryInvoice. Seleziona 2.0-XML.
ZUGFeRD-invoice-sample-2.0.xml
Raccomandato
JSON 2.0 Campione EN16931
Fattura strutturata completa per ZUGFeRD 2.0 EN16931. Scegliere 2.0-JSON, quindi 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 i test batch. Seleziona 1.0-CSV, quindi 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 Pick 2.0-CSV.
zugferd-invoice-2.0.csv

Matrice decisionale input-output

Se si selezionaPoi mappaTu ottieni
ZUGFeRD version and Input Format = 2.0-XMLInvoice XML DataZUGFeRD 2.0 hybrid output (or XML-only) from your existing XML payload
ZUGFeRD version and Input Format = 2.0-JSONInvoice JSON DataZUGFeRD 2.0 hybrid from a structured JSON object converted to the schema
ZUGFeRD version and Input Format = 2.0-CSVInvoice CSV DataZUGFeRD 2.0 hybrid from a flat CSV row converted to the schema
Output Mode = XmlWithPdfPDF File Content + File Name (background PDF)PDF/A-3 hybrid file with embedded XML
Output Mode = XmlOnlyInvoice data only (no PDF bytes needed)Standalone ZUGFeRD XML invoice

Come si configura la creazione di fatture ZUGFeRD in Power Automate?

  1. Aggiungere Crea fattura ZUGFeRD al tuo flusso come un nuovo passo.
  2. Accedi PDF4me Connettiti con il tuo API chiave.
  3. Scegliere Versione e formato di input di ZUGFeRD (Per esempio 2.0-XML, 2.0-JSON, O 2.0-CSV).
  4. Impostato Modalità di uscita A XmlWithPdf per il file ibrido o Solo XML per puro XML.
  5. Mappa soltanto il campo dati della fattura corrispondente (XML, JSON, O CSV) da un'azione precedente.
  6. Impostato Livello di conformità DI BASE per i test di compatibilità, COMFORT O ESTESA quando il tuo destinatario conferma il supporto).
  7. Partire Genera fattura in formato PDF COME a meno che non forniate uno sfondo predefinito PDF.
  8. Per XmlWithPdfmappa Contenuto del file PDF E Nome del file da un'azione precedente (Ottieni il contenuto del file).
  9. Impostato Nome del file di output Zugferd-output.pdf O Zugferd-output.xml).
  10. Sotto Parametri avanzati, impostato Lingua se hai bisogno di etichette in una lingua diversa dal tedesco.
  11. Instradare il Contenuto del file uscita in SharePoint Crea file, OneDrive Crea file, Outlook Invia un'e-mail o un record Dataverse. Facoltativamente, concatena Convalidare PDF/UN prima dell'archiviazione.

Produzione

L'azione restituisce il contenuto del file generato più i metadati che il flusso può passare a valle.

CampoTipoDescrizione
File ContentBinaryThe generated PDF/A-3 hybrid file (XmlWithPdf) or the standalone XML invoice (XmlOnly).
FileName (header)StringSuggested output filename returned in the response headers.
PageCount (header)StringPage count of the generated PDF, returned when Output Mode is XmlWithPdf.

Risoluzione dei problemi

I dati della fattura sono stati mappati al campo di formato errato.

Se la parte Formato di input del menu a tendina combinato è CSVsolo mappa Dati della fattura in formato CSV. Non riempire XML / JSON campi nella stessa esecuzione. Scegli un singolo formato per chiamata.

PDF errori di output quando la modalità di output è XmlWithPdf

Contenuto del file PDF deve provenire da un passaggio che restituisce byte di file completi (Ottieni il contenuto del file da SharePoint / OneDrive / Outlook allegato), non riferimenti contenenti solo metadati come un elemento GET privo del payload del file.

Livello di conformità rifiutato dal destinatario

Inizia con DI BASE per i test di compatibilità, quindi procedere solo dopo che il sistema ricevente ha confermato il supporto. ESTESA In particolare, può non superare la validazione sui ricevitori sintonizzati secondo lo standard EN 16931.

Legacy 1.0 è stato scelto per un flusso conforme al mandato

ZUGFeRD 1.0 non soddisfa il mandato tedesco B2B 2025. Scegli il 2.0 famiglia (o superiore) nella versione ZUGFeRD e nel menu a tendina Formato di input per qualsiasi flusso di lavoro sensibile al mandato.

Esempi di flusso di lavoro

Esempi di flusso di lavoroOpen by default. Four common ZUGFeRD automation patterns in a 2x2 grid.
Dataverse a ibrido PDF archivio
  1. Attivazione quando una riga della fattura viene contrassegnata come Approvata in Dataverse (o ERP).
  2. Componi la fattura JSON dalle colonne di riga e dalla tabella delle voci di riga secondarie.
  3. Ottieni il layout PDF da un SharePoint Modello di libreria di documenti.
  4. Correre Crea fattura ZUGFeRD con 2.0-JSON, XmlWithPdf, IN 16931-conformità allineata.
  5. Salva il contenuto del file restituito nella libreria dei record; concatena Convalidare PDF/UN prima della ritenzione.

Impatto: Un unico file per persone e macchine, ideale per verifiche e archiviazione a lungo termine.

CSV LOTTO da SharePoint
  1. Attivazione su un nuovo file che atterra in un SharePoint messa in scena cartella.
  2. Leggi il CSV Contenuto del file per le righe della fattura.
  3. Scegliere 2.0-CSV nel menu a tendina combinato; mappa Dati della fattura in formato CSV.
  4. Impostato XmlWithPdf, instrada il risultato a un fatture approvate biblioteca.

Impatto: Generazione batch ripetibile senza l'utilizzo di strumenti manuali sul computer.

XMLOnly per SAP o middleware
  1. Il sistema a monte genera la fattura JSON.
  2. Esegui l'azione con Solo XML; saltare PDF Contenuto del file.
  3. POST il reso XML a SAP, a un broker EDI o a una clearing house per la fatturazione elettronica.
  4. ID di correlazione dei log per la tracciabilità dell'assistenza.

Impatto: Passaggio di consegne pulito quando il PDF Il guscio viene generato altrove.

Outlook inviare e SharePoint archivio
  1. Finalizza la fattura nel tuo sistema di fatturazione.
  2. Genera il file ibrido ZUGFeRD (XmlWithPdf).
  3. Outlook Invia un'e-mail con il PDF/A-3 allegato al cliente.
  4. SharePoint Crea un file nella raccolta documenti con le colonne dei metadati (numero fattura, importo, data di scadenza).

Impatto: Servizio self-service per i clienti e riduzione dei ticket di supporto con formato errato.

Casi d'uso e applicazioni industriali

Casi d'uso e applicazioni industrialiExpand to see manufacturing, finance, public sector, and SaaS scenarios.
produzione e B2B
  • Fatture dei fornitoriFormato ibrido PDF/A-3 + XML per acquirenti con rigide normative in materia di contabilità fornitori.
  • Dall'ordine all'incassoAutomatizzare i pacchetti di fatturazione dagli eventi ERP
  • Traccia di controlloun manufatto per spedizione o traguardo
Finanza e contabilità
  • creditifatture elettroniche in uscita conformi al mandato del 2025
  • Fine mese. output ibrido batch da dati di fattura consolidati
  • Archivio. Abbinare alla convalida PDF/A prima della conservazione dei record
Settore pubblico e regolamentato
  • Scambio strutturatoXML Solo per i canali di compensazione obbligatori
  • TrasparenzaIl supporto XML incorporato consente la verifica automatizzata
  • Ritenzione. conformarsi alle politiche interne di gestione dei dati
SaaS e piattaforme
  • Esportazioni di fatturazione. Genera ZUGFeRD da JSON/CSV che hai già emesso
  • Multi-inquilino. Fattura separata in formato JSON/XML/CSV o modelli per cliente nel tuo flusso
  • Successo del cliente. meno cicli manuali di "invio fattura di nuovo"

Domande frequenti

What is ZUGFeRD and how does it differ from XRechnung and Factur-X?+
ZUGFeRD is the German hybrid e-invoicing format: a PDF/A-3 archival PDF with structured XML invoice data embedded inside it. Humans read the PDF; machines parse the XML. XRechnung is the German public sector profile, a stricter pure-XML profile required when invoicing federal, state, or municipal authorities. Factur-X is the French sister format that uses the same hybrid PDF/A-3 + XML structure as ZUGFeRD 2.x and is fully compatible. Pick ZUGFeRD with EN 16931 alignment for general B2B; switch to XRechnung when invoicing a German public-sector buyer. The format is maintained by <a href="https://www.ferd-net.de/" target="_blank" rel="noopener noreferrer">FeRD, the Forum elektronische Rechnung Deutschland</a>.
Does ZUGFeRD satisfy the German B2B e-invoicing mandate that began in 2025?+
Yes, when generated as ZUGFeRD 2.0 or higher with EN 16931 alignment. Germany's Wachstumschancengesetz (Growth Opportunities Act) made e-invoice receipt mandatory for B2B transactions from 1 January 2025 and phases in full sending obligations by 2028. Legacy ZUGFeRD 1.0 does not satisfy the mandate; use the 2.0 family or higher. See the <a href="https://www.e-rechnung-bund.de/" target="_blank" rel="noopener noreferrer">German federal e-invoicing information portal</a> for the official rollout timeline.
When should I use XmlWithPdf versus XmlOnly?+
XmlWithPdf returns a single PDF/A-3 file with the ZUGFeRD XML attached inside it: the canonical hybrid output you send to customers, archive in SharePoint, or attach to email. XmlOnly returns the XML invoice alone, useful when the receiving ERP or clearing platform consumes XML directly and the PDF shell is generated elsewhere or not needed at all.
What is the difference between BASIC, COMFORT, and EXTENDED conformance?+
BASIC is the entry-level profile with the minimum line items and tax breakdown needed for a valid invoice; it offers the broadest receiver compatibility. COMFORT adds further structured fields for richer invoice content. EXTENDED includes the largest set, designed for industry-specific scenarios beyond the EN 16931 baseline. Start with BASIC for compatibility, then move to COMFORT or EXTENDED only after the receiver confirms support.
Do I need to map the background PDF when using XmlOnly?+
No. PDF File Content and File Name are only required when Output Mode is XmlWithPdf. With XmlOnly the action generates a standalone XML file from your invoice data and the PDF input fields can be left empty.
What does Render Invoice on PDF actually do?+
When set to Yes (default), PDF4me draws the invoice content (header, line items, totals) visually on the PDF pages using your invoice data. Set to No when you already provide a pre-designed background PDF that already shows the invoice content and you only need the structured XML embedded inside it.
Which language codes does the Language field accept?+
Nine codes: de (default, German), en (English), fr (French), it (Italian), es (Spanish), nl (Dutch), pl (Polish), pt (Portuguese), and cs (Czech). The setting affects only the labels drawn on the visual PDF; the XML data itself stays language-neutral.
How do I move the generated file into SharePoint, Outlook, or Dataverse?+
Add a follow-up action after Create ZUGFeRD Invoice and map the File Content output. For SharePoint use Create file under the document library; for OneDrive use Create file; for Outlook use Send an email with attachment and map File Content as the attachment content with Output File Name as the attachment name; for Dataverse use Add a new row or Upload a file to an existing row.

Azioni correlate

Stessa attività su altre piattaforme

Richiedi assistenza