Pular para o conteúdo principal
API PDF4meIntegraçõesBase de conhecimentoExtensõesTestador de APIBlog

Crie uma fatura eletrônica ZUGFeRD 2.0+ no Make: um fluxo de trabalho de 4 módulos do Dropbox.

· 22 min para ler
Sankalp Mishra
SEO and Content Writer

ZUGFeRD 2.0+ (também conhecido como Fatura-X na França e XRechnung no setor público alemão) é um Fatura híbrida em PDF/A-3 com o XML legível por máquina incorporado no PDF. Um único arquivo que pode ser utilizado tanto por humanos quanto por sistemas ERP. Este guia descreve o processo exato mostrado nas capturas de tela: um PDF de fatura base e um XML ZUGFeRD 2.0+ no Dropbox se transformam em uma fatura eletrônica híbrida compatível com a norma EN16931. /pdf4meoutput/, em 4. Crie módulos, zero código..

O cenário em resumo
1. Dropbox Download (PDF)
Pulls the base invoice PDF (/pdf4metest/Zugfred Invoice/SimplePdf.pdf). Scheduled trigger shown.
2. Dropbox Download (XML)
Pulls the ZUGFeRD 2.0+ XML invoice data (/pdf4metest/Zugfred Invoice/version2.xml).
3. PDF4me Create a ZUGFeRD invoice
Input Format XML, Output Mode XML With PDF, ZUGFeRD Version 2+, Conformance EN16931, Render Yes, Language de.
4. Dropbox Upload
Writes the hybrid PDF/A-3 e-invoice to /pdf4meoutput/ using File set to Map.
A versão curta

Quatro módulos Make de ponta a ponta. Dois Dropbox. Baixar um arquivo As etapas extraem o PDF base e o XML do ZUGFeRD 2.0+ (as capturas de tela mostram). YnooxTestone conexão mais caminhos /pdf4metest/Fatura Zugfred/SimplePdf.pdf e /pdf4metest/Fatura Zugfred/versão2.xml). PDF4me Criar uma fatura ZUGFeRD incorpora o XML no PDF com Modo de saída XML com PDF, Versão ZUGFeRD 2+, Nível de conformidade EN16931, Gerar fatura em PDF Sim, Linguagem deDropbox Carregar um arquivo escreve o resultado Híbrido PDF/A-3 para /pdf4meoutput/ com o arquivo definido para Mapa, Nome do arquivo 15. Nome, Dados 15. DocumentO arquivo de saída abre em qualquer leitor de PDF e é interpretado corretamente em qualquer sistema ERP que suporte ZUGFeRD / Factur-X / XRechnung.

Dois fatores que determinam se o seu ERP aceita a fatura

Primeiro, o Nível de conformidade Deve corresponder ao que o ERP do comprador ou destinatário espera. EN16931 (Comfort) é a opção legal padrão alemã e a escolha segura para B2B na UE; XRECARGA É necessário para a emissão de faturas B2G (setor público) na Alemanha; BÁSICO Funciona para a maioria dos outros compradores. Em segundo lugar, o Versão ZUGFeRD deve ser 2+ Para qualquer dispositivo em conformidade com a norma EN 16931. Legado 1.0 Utiliza os modos BASIC / COMFORT / EXTENDED e é incompatível com receptores EN 16931. Selecione 2+ a menos que o destinatário solicite explicitamente a versão 1.0.

Isso resolve alguns problemas comuns do mundo real.​

As pessoas pesquisam exatamente esse problema com frases como:

  • "Como faço para criar uma fatura ZUGFeRD com XML incorporado no Make?" Este cenário de 4 módulos faz tudo de ponta a ponta: modelo PDF mais fatura XML de entrada, saída em formato híbrido PDF/A-3.
  • "ZUGFeRD é o mesmo que Factur-X?" Sim. O formato técnico é o mesmo, mas com nomes diferentes. Um arquivo ZUGFeRD 2.x é aceito por sistemas que esperam Factur-X e vice-versa.
  • "Qual nível de conformidade devo escolher?" EN16931 para B2B (em conformidade com a legislação alemã e a norma europeia EN 16931), XRECHNUNG para o setor público alemão (B2G), BASIC para a mais ampla compatibilidade com sistemas legados.
  • "Preciso escrever o XML eu mesmo?" Não, mas neste cenário as capturas de tela utilizam uma fatura XML existente. O módulo também aceita entrada JSON ou CSV e gera o XML para você.
  • "E se o meu comprador precisar apenas do XML, sem PDF?" Defina o modo de saída para XML Only e o módulo retorna apenas o arquivo de fatura XML em vez do híbrido.

O que você está construindo?​

Um cenário Make reutilizável que gera uma fatura eletrônica híbrida totalmente compatível com o padrão ZUGFeRD 2.0+ a partir de um arquivo PDF base e um arquivo XML de fatura. O gatilho pode ser manual, agendado (como mostrado), monitorado pelo Dropbox ou por um webhook HTTP. O resultado é um único arquivo que atende tanto ao requisito de PDF legível por humanos quanto ao requisito de XML legível por máquina, conforme exigido pelas normas de faturamento eletrônico da UE.

Crie um cenário: Baixe um arquivo do Dropbox (PDF, com um indicador de tempo agendado) conectado a um segundo Dropbox. Baixe um arquivo (XML), conectado ao PDF4me. Crie uma fatura ZUGFeRD, conectada ao Dropbox. Envie um arquivo. Cada módulo mostra um contador de 1 iteração e uma marca de seleção verde indicando uma execução bem-sucedida.

Quatro módulos integrados. Dois downloads, uma ação do PDF4me e um upload. O ícone de relógio no Módulo 1 indica um gatilho agendado; alterne para manual / monitoramento de arquivo / webhook conforme sua necessidade.

Do que você precisa​

  • Fazer conta com um cenário aberto. Crie uma conta Make Se você precisar de um.
  • Chave da API do PDF4me. Obtenha sua chave de API e conecte-se ao primeiro módulo PDF4me. Veja Conecte o PDF4me para criar.
  • Dropbox com uma pasta de origem (por exemplo, /pdf4metest/Fatura Zugfred/) contendo o modelo PDF e a fatura XML, além de uma pasta de saída (/pdf4meoutput/).
  • Um PDF base (as capturas de tela usam SimplePdf.pdfNão requer nenhuma marcação de layout. O módulo incorpora o XML como um anexo PDF/A-3.
  • Uma fatura XML ZUGFeRD 2.0+Use o seu próprio ou pegue um Exemplo XML 2.0 para acompanhar.

Referência rápida: o que cada parâmetro faz​

Input Format
XML for existing ZUGFeRD XML, JSON for structured JSON, CSV for tabular invoice rows.
Output Mode
XML With PDF returns the hybrid PDF/A-3 (recommended). XML Only returns just the XML invoice file.
ZUGFeRD Version
2+ for EN 16931 alignment (use this). 1.0 is legacy with BASIC / COMFORT / EXTENDED only.
Conformance Level
2+ supports MINIMUM, BASICWL, BASIC, EN16931 (Comfort, default), EXTENDED, XRECHNUNG (German B2G).
Render Invoice on PDF
Yes draws the invoice line items visually on the PDF. Only takes effect when Output Mode is XML With PDF.
Language
Two-letter ISO code: de (default), en, fr, it, es, nl, pl, pt, cs. Controls label localisation on the rendered PDF.

Construa o cenário​

Módulo 1: Dropbox - Baixar um arquivo (PDF base)​

Extraia o PDF de origem onde o XML do ZUGFeRD será incorporado como um anexo PDF/A-3.

CampoValor usado nesta execução.
ConnectionYnooxTestone (ynoox.test...). your Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Zugfred Invoice/SimplePdf.pdf
Configure o Dropbox para baixar um arquivo PDF como base. Conexão YnooxTestone. Como selecionar arquivos: Selecione um arquivo. Caminho do arquivo: /pdf4metest/Zugfred Invoice/SimplePdf.pdf.

Módulo 2: Download de um arquivo no Dropbox (ZUGFeRD 2.0+ XML)​

Baixe o arquivo XML da fatura ZUGFeRD. O XML contém todos os detalhes da fatura; o PDF é apenas a apresentação visual.

CampoValor usado nesta execução.
ConnectionYnooxTestone (ynoox.test...). same Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Zugfred Invoice/version2.xml
Configure o Dropbox para baixar um arquivo XML do ZUGFeRD 2.0+. Conexão YnooxTestone. Como selecionar arquivos: Selecione um arquivo. Caminho do arquivo: /pdf4metest/ZugfredInvoice/version2.xml.

Módulo 3: PDF4me Criar uma fatura ZUGFeRD​

A ação que realiza a incorporação propriamente dita. Mapeie os dois arquivos baixados como entradas, escolha suas configurações de conformidade e execute.

GrupoCampoValor
AuthConnectionClassify Documen (testva...). PDF4me connection
SourceFile (PDF template)Map → Module 1 File Name + Data
SourceInput FormatXML
SourceFile (XML invoice)Map → Module 2 File Name + Data (a second File picker appears when Input Format is XML)
OutputOutput ModeXML With PDF (hybrid PDF/A-3)
OutputZUGFeRD Version2+
OutputConformance LevelEN16931
OutputRender Invoice on PDFYes
OutputLanguagede

Módulo 4: Carregar um arquivo no Dropbox​

Salve a fatura eletrônica híbrida em PDF/A-3 de volta na pasta de saída.

CampoValor usado nesta execução.
ConnectionYnooxTestone (ynoox.test...)
Folder/pdf4meoutput/
FileMap (so File Name and Data come from the PDF4me step)
File Name15. Name (dynamic content from PDF4me Module 3)
Data15. Document (dynamic content from PDF4me Module 3)
Configure o Dropbox para fazer upload de um arquivo. Conexão YnooxTestone. Pasta /pdf4meoutput/. Arquivo definido como Mapa. Nome do arquivo vinculado a 15. Nome (do PDF4me Criar uma fatura ZUGFeRD). Dados vinculados a 15. Documento.

Salvar e clicar Executar uma vezO formato híbrido PDF/A-3 chega a /pdf4meoutput/ Em poucos segundos.

Get your API KeyFull action reference

Arquivos de exemplo (XML, JSON, CSV)​

Você pode substituir o Módulo 2 (XML) por qualquer uma dessas entradas e alterar Formato de entrada de acordo.

Solução de problemas​

Conformance Level dropdown shows different options than expected
You toggled between Versions. Version 1.0 has BASIC, COMFORT, EXTENDED. Version 2+ has Empty, MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG. Pick the version first; conformance levels follow.
Second File picker did not appear when Input Format is XML
It only appears when File is set to Map. Click the File radio and choose Map; the second File picker (for the XML invoice) renders below.
Buyer ERP rejects the hybrid PDF as non-compliant
Mismatched Conformance Level. Check what the receiver expects (commonly EN16931 for B2B EU, XRECHNUNG for German B2G). Re-run with the right value.
Output is XML only when you wanted the hybrid PDF
Output Mode is set to XML Only. Switch to XML With PDF.
Rendered invoice on PDF is missing line items
Render Invoice on PDF is set to No or Empty, or Output Mode is XML Only. Set both: Output Mode = XML With PDF AND Render Invoice on PDF = Yes.
Want JSON or CSV instead of XML as the input
Change Input Format. The Invoice XML Data / second File picker is replaced by an Invoice JSON Data or Invoice CSV Data text field, which you map from a Google Sheets, HTTP, or file-download module.

Quando usar este padrão​

B2B invoicing in the EU
EN16931 (Comfort) covers the legal default for German and EU business-to-business e-invoicing.
B2G (public-sector) Germany
XRECHNUNG is required for invoicing public authorities. Same flow, different conformance level.
Cross-border Factur-X
France and other EU markets accept ZUGFeRD 2.x as Factur-X. No format conversion needed.
ERP integration without code
Buyer ERP extracts the embedded XML automatically; no manual data entry in accounts payable.

O que ler a seguir​

Perguntas frequentes​

What is ZUGFeRD 2.0+ and how does it differ from 1.0?+
ZUGFeRD 2.0+ aligns with the EU EN 16931 e-invoicing standard and supports the modern Conformance Level set (MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG). ZUGFeRD 1.0 predates EN 16931 and uses BASIC / COMFORT / EXTENDED only. For any new integration in 2026 use 2+; 1.0 is kept for legacy buyer ERPs.
Is ZUGFeRD the same as Factur-X?+
Same technical format under different brand names. ZUGFeRD is the German designation; Factur-X is the French equivalent. Both align to EN 16931 and are cross-compatible: a ZUGFeRD 2.x invoice is accepted by Factur-X receivers and vice versa.
Which Conformance Level should I pick for a typical EU B2B invoice?+
EN16931 (also called Comfort). It is the German legal default and the safe choice for EU business-to-business invoicing. Use XRECHNUNG when invoicing German public authorities (B2G). Use BASIC only when a recipient ERP explicitly requires it.
Do I need to author the XML myself?+
No. The screenshots use an existing XML (Input Format = XML), but the module also accepts JSON or CSV. Choose Input Format = JSON or CSV and the XML is built for you. Sample JSON and CSV files are in the section above.
What if my buyer needs only the XML, no PDF?+
Set Output Mode to XML Only. The module returns just the XML invoice file without a PDF wrapper. Useful when the receiving ERP renders its own document and only consumes the structured data.
Can I render line items visually on the PDF page?+
Yes. Set Render Invoice on PDF = Yes (only effective when Output Mode is XML With PDF). The module draws the invoice items as a visual table on the PDF pages so human reviewers see the invoice content without opening the embedded XML.
Does this work in Power Automate, n8n, or Zapier?+
Yes. The PDF4me Create ZUGFeRD Invoice action is available on all four platforms with the same parameters. See the cross-platform comparison at the bottom of the Make action reference page.
Does the output PDF/A-3 work with every PDF viewer?+
Yes. PDF/A-3 is backward-compatible with all PDF readers. Human readers see the rendered invoice PDF; ZUGFeRD-aware ERPs extract the embedded XML automatically. Non-aware tools just see a normal PDF.

Comece agora​

Get your API KeyPDF4me on MakeAction reference