Criar fatura ZUGFeRD no Power Automate

Criar fatura ZUGFeRD é um Power Automate ação por PDF4me que gera uma fatura eletrônica híbrida compatível com ZUGFeRD, uma única PDFArquivo /A-3 com estrutura XML Incorporado. Use-o para cumprir o mandato de faturamento eletrônico B2B da Alemanha, troque faturas alinhadas à norma EN 16931 com qualquer empresa. ERPOu então, arquive um único arquivo que possa ser lido tanto por humanos quanto por máquinas.

O que esta ação faz

PDF4me Criar fatura ZUGFeRD constrói um fatura eletrônica híbrida compatível com ZUGFeRD, um único PDF/A-3 arquivo PDF com fatura estruturada XML embutido dentro, diretamente em um Power Automate fluxo. Os humanos leem o PDF; ERPs e plataformas de compensação analisam o XMLA ação satisfaz Mandato de faturamento eletrônico B2B da Alemanha (com vigência a partir de 1º de janeiro de 2025 para recebimento, envio completo até 2028) e o subjacente EM 16931 Padrão Europeu. Mapear dados de faturas como XML, JSON, ou CSV de SharePoint, OneDrive, Outlookou Dataverse, e direcione a saída híbrida para seu arquivo, seu ERPOu seu cliente em uma única etapa.

Artigos relacionados no blogue(2)

Como criar uma fatura ZUGFeRD no Power Automate? Um fluxo de trabalho passo a passo com Dropbox e JSON.

Fluxo de trabalho do Power Automate para criar faturas ZUGFeRD/Factur-X a partir de PDFs e JSONs do Dropbox usando o PDF4me. Crie a fatura ZUGFeRD e salve o resultado de volta no Dropbox.

Ler publicação →

Criar uma fatura ZUGFeRD no Power Automate a partir de um PDF e XML do Dropbox: um fluxo de trabalho de 5 etapas

Fluxo do Power Automate com cinco ações: Acionar manualmente, obter conteúdo do arquivo para o PDF base (/pdf4metest/sample/10 page.pdf) via Dropbox, obter conteúdo do arquivo para o XML ZUGFeRD (/pdf4metest/zugfred invoice/version2.xml), criar fatura ZUGFeRD via PDF4me (2.0-XML, XmlWithPdf, BASIC, renderização ativada, idioma alemão), criar arquivo para /pdf4meoutput via Dropbox. Incorpora XML alinhado à norma EN 16931 em um formato híbrido PDF/A-3 que atende à exigência alemã de B2B de 2025. Capturas de tela reais e valores exatos dos campos.

Ler publicação →

Como faço para autenticar meu fluxo do Power Automate?

Para ligar PDF4me através Power Automate, o fluxo precisa de um válido PDF4me API chave no PDF4me Conectar Conector. A autenticação garante uma comunicação segura e valida sua identidade como usuário autorizado. Obtenha ou gire sua chave no painel do desenvolvedor.

Get your API Key

Fatos importantes que você não deve perder

ZUGFeRD é híbrido PDF/A-3 + embutido XML, não um puro XML formato

O padrão XmlWithPdf O resultado é um único arquivo: um arquivo compactado. PDF/A-3 com ZUGFeRD estruturado XML preso dentro dele. Os humanos abrem o PDFOs sistemas AP analisam o XML. Definir Somente XML somente quando o sistema receptor consome puro XML.

O mandato alemão B2B de 2025 exige ZUGFeRD 2.0 ou superior.

A Lei de Oportunidades de Crescimento da Alemanha (Wachstumschancengesetz) tornou obrigatório o recebimento de faturas eletrônicas a partir de [data a ser inserida]. 1 de janeiro de 2025, com as obrigações de envio integral sendo implementadas gradualmente por 2028O ZUGFeRD 2.0 e versões superiores (em conformidade com a norma EN 16931) atendem aos requisitos; a versão legada 1.0 não atende. Selecione a versão mais recente que seu conector suporta (a lista suspensa que exibe a versão do ZUGFeRD combinada com o formato de entrada).

Mapeie UM campo de dados da fatura, nunca dois.

A ação mostra Dados XML da fatura, Dados JSON da fatura, ou Dados CSV da fatura Com base no formato da lista suspensa combinada, selecione apenas a opção correspondente. Preencher dois campos de dados na mesma execução é a causa mais comum de falhas de validação.

Principal Parâmetros aba. Versão ZUGFeRD e formato de entrada é um menu suspenso combinado (aqui) 2.0-XML).

Parâmetros avançados. Linguagem por padrão de; também aceita en, fr, it, es, nl, pl, pt, cs.

ZUGFeRD vs Factur-X vs XRechnung: escolha o perfil certo

Formatar	Onde é utilizado	Tipo de saída	Escolha quando
ZUGFeRD	Germany, EU B2B, supplier-to-buyer invoicing	Hybrid PDF/A-3 + embedded XML	General B2B; you want one file for humans and machines.
Factur-X	France (sister format, technically identical to ZUGFeRD 2.x)	Hybrid PDF/A-3 + embedded XML	Cross-border FR<>DE invoicing; the same hybrid file works on both sides.
XRechnung	German public sector (federal, state, municipal)	Strict pure XML profile	You invoice a German public-sector authority; switch to an XRechnung-aligned profile when the receiver demands pure XML.

Parâmetros

Necessário na ação: Versão do ZUGFeRD e formato de entrada, modo de saída, a correspondência Fatura XML / JSON / CSV Dados Campo e Nível de Conformidade. PDF Conteúdo do arquivo e Nome do arquivo tornam-se necessários apenas quando o Modo de Saída é XmlWithPdf. Nome do arquivo de saída Define o nome do arquivo híbrido gerado. Emitir fatura em PDF O valor padrão é verdadeiro. Linguagem vive sob Parâmetros avançados e define como padrão de.

Parâmetro	Obrigatório	O que faz	Exemplo
ZUGFeRD version and Input Format	Required	Combined 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 Mode	Required	XmlWithPdf 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 Data	Conditional	Required 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 Data	Conditional	Required 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 Data	Conditional	Required 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 Level	Required	Profile 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 PDF	Required	When 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 Content	Conditional	Required 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 Name	Conditional	Required when Output Mode is XmlWithPdf. The source PDF filename with extension. Used for trace and naming context.	abc.pdf
Output File Name	Optional	Filename 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
Language	Optional	Advanced 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

Opções do modo de saída

XmlWithPdfArquivo híbrido ZUGFeRD canônico padrão

Um PDFArquivo /A-3 com a fatura estruturada XML anexado dentro dele. Use para faturamento de saída para clientes, arquivamento em SharePoint, anexando-se a Outlook e-mails, ou em qualquer lugar onde um único artefato precise servir tanto para leitores humanos quanto para leitores de máquina.

Somente XMLIndependente XML fatura

Devolve a fatura ZUGFeRD XML sozinho. Use quando o receptor ERP, câmara de compensação ou ingestão de middleware XML diretamente e o visual PDF é gerado em outro lugar ou não é necessário. PDF O conteúdo do arquivo/nome do arquivo não são obrigatórios.

Escada de níveis de conformidade

BÁSICOPadrão. Ampla compatibilidade com receptores.

Perfil básico com itens de linha, detalhamento de impostos e partes envolvidas. Está em conformidade com a diretiva mínima da UE sobre faturamento eletrônico e é aceito pela maioria dos destinatários B2B. Comece aqui para testes de compatibilidade.

CONFORTOConteúdo de fatura mais completo

Adiciona campos estruturados adicionais além dos campos BÁSICOS. Mova para cá quando seu comprador ou ERP Espera-se um conteúdo de fatura mais completo do que o mínimo exigido. Confirme a compatibilidade antes de mudar do plano BASIC.

ESTENDIDOMaior conjunto, específico para cada setor.

Adiciona campos específicos do setor além dos requisitos básicos da norma EN 16931. Utilize somente quando o destinatário exigir explicitamente; caso contrário, a carga útil mais rica aumenta a probabilidade de dificuldades na validação.

Opções de idioma (Avançado)

A seção de parâmetros avançados expõe um campo, LinguagemEle controla apenas a localidade usada para os rótulos desenhados no elemento visual. PDF; o XML Os dados permanecem neutros em relação ao idioma. O padrão é de.

Código	Linguagem	Uso típico
de	German	Default. German domestic invoicing.
en	English	Cross-border B2B in English-speaking markets.
fr	French	France or French-speaking Switzerland (also pairs with Factur-X workflows).
it	Italian	Italy or Italian-speaking Switzerland.
es	Spanish	Spain and Spanish-speaking partners.
nl	Dutch	Netherlands and Flemish Belgium.
pl	Polish	Poland.
pt	Portuguese	Portugal and Portuguese-speaking partners.
cs	Czech	Czechia.

Exemplos de Arquivos de Fatura

Use esses exemplos para testar o fluxo com cada formato de entrada antes de conectar sua fonte de dados real. Para fluxos de trabalho de produção B2B na Alemanha, alinhados com o mandato de 2025, comece com o JSON 2.0 EN16931 amostra.

ALGEMADO XML Amostra

ZUGFeRD 1.0 BÁSICO XML. Escolha 1.0-XML Na lista suspensa combinada, mapeie isso para Fatura XML Dados.

ZUGFeRD-invoice-sample.xml

ZUGFeRD 2.0

ZUGFeRD 2.0 XML Amostra (EN16931)

ZUGFeRD 2.0 EN16931 XML Com as partes vendedor/comprador, itens de linha, IVA e soma monetária no formato CrossIndustryInvoice. Selecione 2.0-XML.

ZUGFeRD-invoice-sample-2.0.xml

Recomendado

JSON 2.0 EN16931 Amostra

Fatura totalmente estruturada para ZUGFeRD 2.0 EN16931. Escolha 2.0-JSON, depois mapeie para Fatura JSON Dados.

sample-invoice-zugferd-2.0-en16931.json

JSON Exemplo de fatura (básica)

Mais simples JSON para testes de fumaça com ZUGFeRD 1.0 e BÁSICO conformidade.

exemplo-fatura.json

CSV Exemplo de fatura

Plano CSV linha para testes em lote. Selecione 1.0-CSV, depois mapeie para Fatura CSV Dados.

test-invoice.csv

ZUGFeRD 2.0

CSV 2.0 Exemplo de Fatura

Formato estendido de 22 colunas CSV: ID da fatura, Data de emissão, campos de endereço do vendedor/comprador, ID do IVA do vendedor, ID do produto, Moeda, Referência de pagamento, IBAN, BIC. Escolha 2.0-CSV.

zugferd-invoice-2.0.csv

Matriz de decisão de entrada e saída

Se você selecionar	Em seguida, mapeie	Você recebe
ZUGFeRD version and Input Format = 2.0-XML	Invoice XML Data	ZUGFeRD 2.0 hybrid output (or XML-only) from your existing XML payload
ZUGFeRD version and Input Format = 2.0-JSON	Invoice JSON Data	ZUGFeRD 2.0 hybrid from a structured JSON object converted to the schema
ZUGFeRD version and Input Format = 2.0-CSV	Invoice CSV Data	ZUGFeRD 2.0 hybrid from a flat CSV row converted to the schema
Output Mode = XmlWithPdf	PDF File Content + File Name (background PDF)	PDF/A-3 hybrid file with embedded XML
Output Mode = XmlOnly	Invoice data only (no PDF bytes needed)	Standalone ZUGFeRD XML invoice

Como faço para configurar a criação de uma fatura ZUGFeRD no Power Automate?

1. Adicionar Criar fatura ZUGFeRD para o seu fluxo como um novo passo.
2. Faça login em PDF4me Conecte-se com o seu API chave.
3. Escolha Versão ZUGFeRD e formato de entrada (por exemplo 2.0-XML, 2.0-JSON, ou 2.0-CSV).
4. Definir Modo de saída para XmlWithPdf para o arquivo híbrido ou Somente XML para puro XML.
5. Mapa apenas o campo de dados da fatura correspondente (XML, JSON, ou CSV) de uma ação anterior.
6. Definir Nível de conformidade (BÁSICO para testes de compatibilidade, CONFORTO ou ESTENDIDO quando o seu receptor confirmar o suporte).
7. Deixar Gerar fatura em PDF como Sim a menos que você forneça um fundo pré-desenhado. PDF.
8. Para XmlWithPdfmapa Conteúdo do arquivo PDF e Nome do arquivo de uma ação anterior (Obter conteúdo do arquivo).
9. Definir Nome do arquivo de saída (Zugferd-output.pdf ou Zugferd-output.xml).
10. Sob Parâmetros avançados, definir Linguagem Se você precisar de etiquetas em um idioma que não seja alemão.
11. Rota Conteúdo do arquivo saída em SharePoint Criar arquivo, OneDrive Criar arquivo, Outlook Envie um e-mail ou um registro no Dataverse. Opcionalmente, encadeie. Validar PDF/UM antes do arquivamento.

Saída

A ação retorna o conteúdo do arquivo gerado, além dos metadados que seu fluxo pode repassar para os fluxos subsequentes.

Campo	Tipo	Descrição
File Content	Binary	The generated PDF/A-3 hybrid file (XmlWithPdf) or the standalone XML invoice (XmlOnly).
FileName (header)	String	Suggested output filename returned in the response headers.
PageCount (header)	String	Page count of the generated PDF, returned when Output Mode is XmlWithPdf.

Solução de problemas

Os dados da fatura foram mapeados para o campo de formato errado.

Se a parte Formato de entrada da lista suspensa combinada for CSV, apenas mapa Dados CSV da faturaNão preencha XML / JSON campos na mesma execução. Selecione um único formato por chamada.

PDF erros de saída quando o Modo de Saída é XmlWithPdf

Conteúdo do arquivo PDF deve vir de uma etapa que retorna os bytes completos do arquivo (Obter conteúdo do arquivo de SharePoint / OneDrive / Outlook anexo), não referências somente de metadados, como um item GET que não contém o conteúdo do arquivo.

Nível de conformidade rejeitado pelo destinatário

Comece com BÁSICO Para testes de compatibilidade, avance somente após o sistema receptor confirmar o suporte. ESTENDIDO Em particular, pode falhar na validação em receptores sintonizados para a linha de base EN 16931.

A versão 1.0 do legado foi escolhida para um fluxo em conformidade com o mandato.

O ZUGFeRD 1.0 não cumpre o mandato alemão B2B de 2025. Escolha o 2.0 família (ou superior) na versão ZUGFeRD e no menu suspenso Formato de Entrada para qualquer fluxo de trabalho que dependa de mandato.

Exemplos de fluxo de trabalho

Exemplos de fluxo de trabalhoOpen by default. Four common ZUGFeRD automation patterns in a 2x2 grid.

Dataverse para híbrido PDF arquivo

1. Acionar quando uma linha da fatura for marcada como Aprovada no Dataverse (ou ERP).
2. Elabore a fatura. JSON a partir de linhas, colunas e tabelas de itens filhos.
3. Obtenha o layout PDF de um SharePoint Modelo de biblioteca de documentos.
4. Correr Criar fatura ZUGFeRD com 2.0-JSON, XmlWithPdf, EM 16931-conformidade alinhada.
5. Salve o conteúdo do arquivo retornado na biblioteca de registros; encadeamento Validar PDF/UM antes da retenção.

Impacto: Um único arquivo para humanos e máquinas, ideal para auditoria e armazenamento a longo prazo.

CSV lote de SharePoint

1. Acionar quando um novo arquivo é lançado em um SharePoint encenação pasta.
2. Leia o CSV Conteúdo do arquivo para as linhas da fatura.
3. Escolha 2.0-CSV no menu suspenso combinado; mapa Dados CSV da fatura.
4. Definir XmlWithPdf, encaminhar o resultado para um faturas aprovadas biblioteca.

Impacto: Geração repetível de lotes sem ferramentas manuais de computador.

XML somente para SAP ou middleware

1. O sistema a montante gera a fatura. JSON.
2. Execute a ação com Somente XML; pular PDF Conteúdo do arquivo.
3. POSTE o resultado XML para a SAP, um intermediário EDI ou uma câmara de compensação de faturamento eletrônico.
4. IDs de correlação de logs para rastreabilidade de suporte.

Impacto: Transição limpa quando o PDF O shell é gerado em outro local.

Outlook enviar e SharePoint arquivo

1. Finalize a fatura em seu sistema de faturamento.
2. Gere o arquivo híbrido ZUGFeRD (XmlWithPdf).
3. Outlook Envie um e-mail com o PDF/A-3 anexado ao cliente.
4. SharePoint Criar arquivo na biblioteca de registros com colunas de metadados (número da fatura, valor, data de vencimento).

Impacto: Autoatendimento ao cliente e menos chamados de suporte com "formato incorreto".

Casos de uso e aplicações industriais

Casos de uso e aplicações industriaisExpand to see manufacturing, finance, public sector, and SaaS scenarios.

Manufatura e B2B

• Faturas de fornecedores. Híbrido PDF/A-3 + XML para compradores com regras rígidas de AP
• Do pedido ao recebimentoAutomatizar pacotes de faturas a partir de eventos do ERP
• Registro de auditoriaum artefato por remessa ou marco

Finanças e Contabilidade

• Contas a receberFaturas eletrônicas de saída em conformidade com o mandato de 2025
• Fim do mês. saída híbrida em lote a partir de dados de faturas consolidadas
• Arquivístico. emparelhar com validação PDF/A antes da retenção de registros

Setor público e regulamentado

• Troca estruturada.XmlOnly para canais de compensação obrigatórios
• TransparênciaO XML incorporado suporta verificação automatizada.
• Retenção. estar em conformidade com as políticas internas de registros

SaaS e plataformas

• Exportações de faturamentoGere o ZUGFeRD a partir do JSON/CSV que você já emitiu.
• Multi-inquilino. faturas separadas em JSON/XML/CSV ou modelos por cliente no seu fluxo de trabalho
• Sucesso do clientemenos ciclos manuais de "reenviar a fatura"

Perguntas frequentes

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.

Ações relacionadas

Validar PDF/UM

Verifique a conformidade do arquivo gerado. PDFArquivo híbrido /A-3 antes de armazená-lo em sua biblioteca de registros.

Analisar documento

Extrair dados de faturas recebidas PDFPrimeiro, insira o resultado em Criar Fatura ZUGFeRD para fluxos de saída.

Gerar EPC QR Código

Adicione um dispositivo compatível com SEPA QR código de pagamento para o renderizado PDF junto com ZUGFeRD XML incorporação.

Mesma tarefa em outras plataformas

Criar fatura ZUGFeRD em Make

O mesmo híbrido PDF/A-3 + XML geração como uma Make módulo, com a mesma hierarquia de níveis de conformidade e combinações de versão e formato.

Criar fatura ZUGFeRD em Zapier

Acione a geração de ZUGFeRD a partir de qualquer uma das mais de 6.000 opções. SaaS Aplicativos e webhooks. Mesma conformidade com a norma EN 16931.

Criar fatura ZUGFeRD em n8n

Fluxos de trabalho auto-hospedados ou em nuvem com os mesmos modos de entrada de dados de fatura e nível de conformidade.

Criar fatura ZUGFeRD REST API

O endpoint POST bruto para código de backend personalizado ou testes com o Postman.

Obtenha ajuda

PDF4me ConnectGet your API KeyPower Automate Documentation