Criar fatura ZUGFeRD em Zapier

O que esta ação faz

PDF4me Criar fatura ZUGFeRD gera totalmente compatível Faturas eletrônicas híbridas ZUGFeRD, um PDFDocumento A-3 com estrutura XML dados de fatura incorporados diretamente no seu Zapier fluxo de trabalho. Converter XML, JSON, ou CSV dados de fatura em um único arquivo híbrido pronto para o Mandato alemão para faturamento eletrônico B2B (2025+)Compatível com a norma EN 16931 em toda a UE ou com o perfil do setor público alemão XRECHNUNG. Suporta as versões 1.0 a 2.x do ZUGFeRD e todos os níveis de conformidade: BASIC, COMFORT, EXTENDED, EN16931 e XRECHNUNG, em uma única ação Zap. Substituto direto para fluxos de trabalho manuais do Adobe Acrobat, JustOn ou ZUGFeRD Manager.

Autenticando seu API Solicitar

Para acessar o PDF4me Web API através ZapierToda ação precisa ser autenticada. Clique. Conecte uma nova conta Na primeira vez, cole o seu PDF4me API chave, os Zaps subsequentes reutilizam a conexão automaticamente.

Get your API Key PDF4me on Zapier

Fatos importantes que você não deve perder

ZUGFeRD 2.0+ é um requisito para o mandato alemão B2B de 2025.

A Lei de Proteção de Dados Pessoais (Wachstumschancengesetz) tornou obrigatório o recebimento de faturas eletrônicas a partir de 1º de janeiro de 2025, com a obrigatoriedade de envio integral até 2028. O ZUGFeRD 2.0 ou superior, em conformidade com as normas EN16931 ou XRECHNUNG, atende a essa exigência: o ZUGFeRD 1.0 não está em conformidade. Em algumas instalações, a versão padrão é a 1.0; para ambientes de produção, altere explicitamente para a versão 2.0 ou superior.

Preencha apenas um campo de dados por execução, nunca dois.

Mapa apenas o campo de dados da fatura que corresponde ao seu formato de entrada, Dados XML da fatura para XMLDados JSON da fatura para JSONDados CSV de faturas para CSVPreencher vários campos "por precaução" quebra a validação e impede a execução da etapa Zap em tempo de execução.

O nível de conformidade EN16931 é o padrão seguro para a versão 2.x.

Escolha EN16931 para faturamento geral B2B na UE (ZUGFeRD 2.x), XRECARGA para entidades do setor público alemão, ESTENDIDO para áreas específicas do setor. Para o ZUGFeRD 1.0, BASIC é o nível mínimo legal de fatura. MINIMUM e BASICWL omitem itens de linha e não são faturas legais por si só.

Parâmetros

Requerido no Zapier UI (com asterisco): Formato de entrada, modo de saída, versão do Zugferd e nível de conformidade. Condicional: o campo de dados da fatura correspondente (dados XML da fatura, dados JSON da fatura ou dados CSV da fatura) com base no formato de entrada. Para saída XmlWithPdf: O arquivo e o nome do arquivo (o PDF do modelo) geralmente são exigidos pelo conector, mesmo que não estejam marcados com um asterisco em todos os layouts. Opcional: Renderizar fatura em PDF, idioma.

Parâmetro	Obrigatório	O que faz	Exemplo
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`

Opções de formato de entrada

Controla qual formato de dados sua fatura utiliza e qual campo de dados da fatura você deve preencher abaixo.

XMLPré-fabricado XML fatura

Melhor quando seu ERP já produz em conformidade com ZUGFeRD XML ou UBL XML que só precisa ser envolvido no híbrido PDFMapeie o arquivo para Dados XML da fatura.

JSONModern APIdados de origem

Ideal para fluxos de trabalho orientados por webhook ou SaaS sistemas de faturamento que emitem JSON. PDF4me mapas JSON campos para o ZUGFeRD XML esquema automaticamente. Mapear para Dados JSON da fatura.

CSVExportação de planilha ou em lote

Ideal para exportação em lote de faturas do Google Sheets, Excel, sistemas legados ou cenários de faturamento por linha. PDF4me mapas CSV colunas para o esquema. Mapear para Dados de fatura em CSV.

Opções do modo de saída

Controla se você gera o arquivo híbrido ZUGFeRD canônico ou um arquivo XML puro.

XmlWithPdfArquivo híbrido ZUGFeRD completo padrão

Produz o híbrido padrão ZUGFeRD: PDF/A-3 arquivo PDF com a estrutura XML fatura incorporada como anexo. Humanos leem a PDF, as máquinas analisam o XMLSaída padrão para faturamento eletrônico B2B. Requer o mapeamento de Arquivo e Nome do Arquivo.

Somente XMLPuro XML, não PDF invólucro

Produz apenas a estrutura XML fatura. Use para XRechnung pure-XML submissões do setor público, fluxos EDI, testes da camada de dados ou sistemas que ingerem apenas XML Sem representação visual.

Opções de versão Zugferd

A versão da especificação ZUGFeRD incorporada na fatura gerada determina quais opções de Nível de Conformidade aparecem no menu suspenso.

1.0Legado, anterior à norma EN 16931

Especificação original de 2014. Opções de conformidade: BÁSICO, CONFORTO, ESTENDIDONão atende ao requisito de faturamento eletrônico B2B alemão para 2025+. Use somente para destinatários legados que exigem explicitamente a versão 1.0.

2.0+Recomendado, em conformidade com a norma EN 16931.

Em conformidade com a norma europeia EN 16931 e atende aos requisitos da regulamentação alemã para o mercado B2B. As opções de conformidade incluem: MÍNIMO, BÁSICO, BÁSICO, EN16931, ESTENDIDO, XRECHNUNGA escolha certa para faturamento de produção a partir de 2025 e interoperabilidade com Factur-X.

Opções de Nível de Conformidade

O perfil de conformidade controla quais campos da fatura são obrigatórios e validados. As opções disponíveis dependem da versão do Zugferd escolhida.

MÍNIMOSomente versão 2.x, somente cabeçalho

Apenas o cabeçalho, sem itens de linha. NÃO é uma fatura legal válida. Destinada apenas a entregas internas para o departamento de contabilidade.

BASICWLApenas versão 2.x, apenas IVA.

Adiciona a discriminação do IVA, mas não os itens de linha. Para cenários que envolvem apenas reservas, a conciliação é feita com base nos pedidos.

BÁSICOAmbas as versões, fatura legal mínima

Adiciona itens de linha. Atende aos requisitos mínimos da diretiva de faturamento eletrônico da UE. Disponível nas versões 1.0 e 2.x.

CONFORTOApenas versão 1.0, referências estendidas

Adiciona dados de referência e campos adicionais além do BASIC. Compatível apenas com ZUGFeRD 1.0, equivalente ao EN16931 nas versões modernas 2.x.

EN169312.x, padrão B2B recomendado

Perfil completo da norma europeia EN 16931. O padrão recomendado para faturamento B2B na UE e o nível referenciado pelo mandato alemão. Somente para ZUGFeRD 2.x.

ESTENDIDOAmbas as versões, extras da indústria

Adiciona campos específicos do setor além dos básicos (logística, frete, referências específicas do setor). Disponível nas versões 1.0 e 2.x.

XRECARGA2.x, obrigatório para o setor público alemão

O perfil alemão XRechnung CIUS é obrigatório para faturas emitidas a autoridades federais, estaduais e municipais. Validação mais rigorosa que a norma EN16931. Compatível apenas com ZUGFeRD 2.x.

Campos de saída

Campo	Tipo	O que contém
`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).

Exemplos de Arquivos de Faturas

Use esses arquivos de exemplo para testar a ação com cada formato de entrada antes de conectar sua fonte de dados real. Para fluxos de trabalho de produção B2B em alemão, comece com sample-invoice-zugferd-2.0-en16931.json (ZUGFeRD 2.0, EN16931 conformidade).

Exemplo XML ZUGFeRD

ZUGFeRD 1.0 BÁSICO XMLUse com Formato de entrada: XML. Mapear para Dados XML da fatura.

ZUGFeRD-invoice-sample.xml

ZUGFeRD 2.0

Exemplo XML do ZUGFeRD 2.0 (EN16931)

ZUGFeRD 2.0 EN16931 XML Com partes vendedor/comprador, itens de linha, IVA e soma monetária no formato CrossIndustryInvoice. Use com Formato de entrada: XML, Versão ZUGFeRD: 2.0, Conformidade: EN16931.

ZUGFeRD-invoice-sample-2.0.xml

Recomendado

Exemplo JSON 2.0 EN16931

Fatura totalmente estruturada para ZUGFeRD 2.0 com EN16931 conformidade. Usar com Formato de entrada: JSON, Zugferd Versão: 2.0, Nível de conformidade: EN16931. Mapear para Dados JSON da fatura.

sample-invoice-zugferd-2.0-en16931.json

Exemplo de fatura JSON (básico)

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

exemplo-fatura.json

Exemplo de fatura em CSV

Plano CSV linha para Formato de entrada: CSV. Mapear para Dados de fatura em CSV.

test-invoice.csv

ZUGFeRD 2.0

Exemplo de fatura em CSV 2.0

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. Use com Formato de entrada: CSV, ZUGFeRD 2.0.

zugferd-invoice-2.0.csv

Configuração rápida

Em Zapier, clique + para adicionar uma nova ação e selecionar PDF4me.
Escolher Criar fatura ZUGFeRD como o evento de ação.
Conecte seu PDF4me conta ou cole sua API Digite a tecla quando solicitado.
Para XmlWithPdf saída, mapa Arquivo e Nome do arquivo para o seu layout PDF (geralmente uma etapa anterior de download do Dropbox ou Google Drive). Para Somente XML, estes podem ser deixados vazios.
Definir Formato de entrada para XML, JSON, ou CSV dependendo da sua fonte de dados.
Preencher apenas Preencha o campo de dados da fatura correspondente: Dados XML da Fatura, Dados JSON da Fatura ou Dados CSV da Fatura. Deixe os outros dois campos em branco.
Definir Modo de saída para XmlWithPdf (arquivo híbrido, ZUGFeRD canônico) ou Somente XML (puro) XML).
Escolher Versão Zugferd: 2.0+ para conformidade com o mandato B2B alemão de 2025+, 1.0 Somente para receptores antigos.
Escolher Nível de conformidade: EN16931 para B2B geral (2.x), XRECARGA para o setor público alemão, BÁSICO para o legado do ZUGFeRD 1.0.
Alternar Renderizar fatura em PDF para Verdadeiro se você quiser PDF4me para renderizar visualmente o conteúdo da fatura no PDF; Falso se o seu modelo PDF já mostra o layout.
Definir Linguagem para o código de localidade correspondente à região do seu comprador (de, en, fr, it, es, nl, pl, pt).
Clique Ação de testeVerifique a saída e ligue o Zap.

Exemplos de fluxo de trabalho

Exemplos de fluxo de trabalhoCommon Zapier workflow patterns using Create ZUGFeRD Invoice.

Webhook SaaS JSON → ZUGFeRD 2.x EN16931 → enviar e-mail ao cliente

Seu SaaS O sistema de faturamento envia um webhook para Zapier quando um cliente B2B alemão recebe uma fatura.
PDF4me Criar execução de fatura ZUGFeRD: Formato de entrada = JSON, Dados JSON da fatura mapeados a partir da carga útil do webhook, Modo de saída = XmlWithPdf, Versão Zugferd = 2.0, Conformidade = EN16931, Idioma = alemão.
O híbrido PDF (Legível para humanos e analisável por máquina) é anexado a uma etapa do Gmail e enviado para o endereço de contas a pagar do cliente, atendendo ao mandato de faturamento eletrônico B2B de 2025+.
Uma linha do Google Sheets registra o ID da fatura, o cliente, o valor e o registro de data e hora para fins de auditoria.
A SharePoint carregar arquivos uma cópia do ZUGFeRD PDF para fins de conformidade e retenção.

Exportação ERP CSV → XRECHNUNG → Portal do setor público alemão

Um sistema Zap programado é executado todos os dias úteis às 16h para processar faturas pendentes do setor público.
Um gatilho do Dropbox detecta as últimas novidades. ERP CSV exportação e layout PDF.
PDF4me Criar execução de fatura ZUGFeRD: Formato de entrada = CSV, Dados CSV da fatura = o CSV arquivo, Modo de saída = XmlWithPdf, Versão Zugferd = 2.0, Conformidade = XRECHNUNG, Idioma = de.
O híbrido XRECHNUNG em conformidade PDF é enviado via POST por meio de uma etapa Webhook para o portal federal ZRE ou para o endpoint de faturamento eletrônico estadual relevante.
Um e-mail de confirmação é enviado à equipe de Contas a Receber com a referência da submissão; um log do PostgreSQL registra o histórico de auditoria.

XML pré-construído → Somente XML → Integração com parceiros EDI

Seu ERP já gera compatível com ZUGFeRD XML As faturas são geradas através do módulo de exportação e armazenadas em uma pasta do Google Drive.
Zapier aciona cada novo XML arquivo. PDF4me Criar execução de fatura ZUGFeRD: Formato de entrada = XML, Dados XML da fatura = o XML arquivo, Modo de saída = XmlOnly, Versão Zugferd = 2.0, Conformidade = EN16931.
O puro validado-XML A fatura é enviada via SFTP para o endpoint EDI do parceiro comercial, não. PDF É necessário um wrapper para a transferência de dados entre sistemas.
Uma notificação do Slack confirma a entrega do EDI; um registro no Airtable é atualizado com o parceiro e o carimbo de data/hora do envio.

Perguntas frequentes

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.