Criar fatura ZUGFeRD em n8n

O que este nó faz

PDF4me Criar fatura Zugferd gera totalmente compatível Faturas eletrônicas híbridas ZUGFeRD (Documentos PDF/A-3 com estrutura) XML dados de fatura incorporados diretamente no seu n8n fluxo de trabalho. Converter XML, JSON, ou CSV dados de fatura em um único arquivo híbrido pronto para o Mandato alemão de faturamento eletrônico B2BCompatível com a norma EN 16931 em toda a UE ou com o perfil do setor público alemão XRECHNUNG. Suporta todas as versões do ZUGFeRD, da 1.0 à 2.4, e todos os seis níveis de conformidade em um único nó.

Artigos relacionados no blogue(1)

Como criar uma fatura ZUGFeRD no n8n? Um fluxo de trabalho com Dropbox e JSON, passo a passo!

Fluxo de trabalho n8n: faça o upload do JSON da fatura para o PDF4me, crie uma fatura ZUGFeRD/Factur-X e, em seguida, faça o upload do PDF gerado para o Dropbox. Inclui capturas de tela reais, mapeamentos e verificações de saída.

Ler publicação →

Autenticando seu API Solicitar

Todo PDF4me nó em n8n requer um válido Credencial para se conectar comCrie ou selecione um que contenha o seu PDF4me API chave para que o fluxo de trabalho possa autenticar com segurança as solicitações de geração de faturas ZUGFeRD.

Get your API Key

Fatos importantes que você não deve perder

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

O resultado é um único arquivo PDF/A-3 de qualidade arquivística. PDF com a estrutura XML fatura anexada dentro. Humanos leem a PDF, as máquinas analisam o XMLNão é necessário enviar arquivos separados. Para gerar arquivos puros. XML sem o PDF Para gerar o arquivo wrapper, defina o Modo de Saída como Somente XML; para gerar o arquivo híbrido, defina-o como XML com PDF (o padrão).

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

A Lei Alemã de Oportunidades de Crescimento (Wachstumschancengesetz) tornou obrigatório o recebimento de faturas eletrônicas para todas as transações B2B a partir de 1º de janeiro de 2025, com a obrigatoriedade de envio sendo implementada gradualmente até 2028. O ZUGFeRD versão 2.0 ou superior, em conformidade com as normas EN16931 ou XRECHNUNG, atende a essa exigência. A versão legada ZUGFeRD 1.0 não está em conformidade.

O nível de conformidade controla a conformidade: EN16931 é a norma de segurança padrão.

Selecione EN16931 para faturamento B2B geral em toda a UE (a Norma Europeia), XRECHNUNG para faturamento de entidades do setor público alemão e EXTENDED para campos específicos do setor que vão além da linha de base da EN 16931. MINIMUM e BASICWL omitem itens de linha e não podem ser usados para faturamento completo; apenas para lançamentos contábeis internos.

Parâmetros

Obrigatório no n8n Interface do usuário: Credencial de conexão, Tipo de dados de entrada, Nome do documento (sempre obrigatório, mesmo quando o Tipo de dados de entrada for Nenhum, usado como nome de documento alternativo), Modo de saída, Versão do Zugferd, Renderizar fatura em PDF, Idioma, Formato de entrada e Tipo de entrada de dados da fatura. Nível de conformidade é exibido e exigido com base na ramificação da versão Zugferd, com nomes de campo e conjuntos de opções diferentes para 1.0 vs 2.0/2.1/2.2/2.4 vs Custom. O campo de dados da fatura correspondente (Fatura) XML/JSON/CSV Dados, Propriedade Binária, Base64 O conteúdo (ou URL de dados) é obrigatório com base no tipo de entrada de dados da fatura. A validação em tempo de execução garante que o caminho escolhido contenha conteúdo não vazio, exibindo erros como "Os dados da fatura são obrigatórios" ou "O conteúdo base64 da fatura é obrigatório".

Completo Parâmetros Visualizar; utilize a tabela abaixo para localizar cada campo no nó.

Parâmetro	Obrigatório	O que faz	Exemplo
Input Data Type	Conditional	How the background PDF (the visual layer of the hybrid invoice) is supplied. None creates the PDF from invoice data alone. Binary Data reads from a previous n8n node. Base64 String accepts encoded content. URL downloads from a public link.	Binary Data
Binary Property Name	Conditional	Name of the binary field from the previous node. Required when Input Data Type is Binary Data.	data
Base64 Content	Conditional	Base64-encoded PDF string. Required when Input Data Type is Base64 String.	JVBERi0xLjQK...
File URL	Conditional	Public URL to the source PDF. Required when Input Data Type is URL.	https://example.com/invoice.pdf
Document Name	Yes	Filename of the source PDF document. Always required in the UI, including when Input Data Type is None (used as document name fallback in the payload). Include the .pdf extension.	invoice.pdf
Output Mode	Yes	XML Only generates a pure XML file. XML With PDF generates the full hybrid ZUGFeRD file: a PDF/A-3 document with structured XML embedded inside. XML With PDF is the canonical ZUGFeRD output.	XML With PDF
Zugferd Version	Yes	ZUGFeRD specification version. 1.0 is legacy and does not satisfy the German B2B mandate. 2.0 through 2.4 all support EN 16931. 2.2 and 2.4 add the latest XRECHNUNG profile updates. Custom enables advanced version handling.	2.0
Zugferd Version Custom	Conditional	Custom ZUGFeRD version identifier. Shown and required only when Zugferd Version is Custom (the execute step throws if empty).	2.3.1
Conformance Level	Conditional	Profile controlling which invoice fields are required. Shown when Zugferd Version is 1.0 (legacy options). Switches to Conformance Level (Above 2) for versions 2.0/2.1/2.2/2.4 and Custom (MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG).	EN16931
Language	Yes	Display language for invoice labels in the rendered PDF. Options: German, French, Italian, English, Spanish, Dutch, Polish, Portuguese. The XML data itself remains language-neutral.	German
Render Invoice On PDF	Yes	Toggle (ON/OFF). When enabled, PDF4me visually renders the invoice content on the PDF using your invoice data. When disabled, only the structured XML is generated and embedded, useful when you supply a pre-designed background PDF.	true
Input Format	Yes	Format of the invoice data you are providing. XML for pre-built ZUGFeRD XML or UBL data. JSON for structured invoice objects. CSV for tabular batch exports.	XML sampleXML 2.0 sampleJSON 2.0 EN16931 sampleJSON (basic)CSV sampleCSV 2.0 sample
Invoice Data Input Type	Yes	How the invoice data reaches the node. Direct Text accepts pasted or mapped data inline. Binary Data reads from a previous file node. Base64 String for encoded payloads. URL downloads from a public link.	Direct Text
Invoice XML / JSON / CSV Data	Conditional	The actual invoice content. Appears as Invoice XML Data, Invoice JSON Data, or Invoice CSV Data, matching the chosen Input Format. Required when Invoice Data Input Type is Direct Text. Runtime also throws "Invoice … data is required" if empty.	XML sampleXML 2.0 sampleJSON 2.0 EN16931 sampleJSON (basic)CSV sampleCSV 2.0 samplePaste, map, or load via Binary / Base64 / URL to match the format you chose above.
Invoice Binary Property Name	Conditional	Name of the binary field holding the invoice data file. Required when Invoice Data Input Type is Binary Data.	data
Invoice Base64 Content	Conditional	Base64-encoded invoice data. Required when Invoice Data Input Type is Base64 String. Runtime also throws "Invoice base64 content is required" if empty.	PGludm9pY2U+...
Invoice Data URL	Conditional	Public URL to the invoice data file. Required when Invoice Data Input Type is URL.	https://example.com/invoice.json
Output File Name	No	Filename for the generated ZUGFeRD invoice. Default provided and normalized in execute (e.g. extension matched to Output Mode). Use .pdf for XML With PDF and .xml for XML Only.	zugferd_invoice.pdf
Output Binary Field Name	No	Name of the binary field holding the generated ZUGFeRD file. Defaults to data. Used to reference the file in subsequent workflow nodes.	data

Exemplos de Arquivos de Fatura

Use esses arquivos de exemplo para testar o nó 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).

ALGEMADO XML Amostra

ZUGFeRD 1.0 BÁSICO XMLUse com Formato de entrada: XMLCole ou mapeie para Fatura XML Dados.

ZUGFeRD-invoice-sample.xml

ZUGFeRD 2.0

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

JSON 2.0 EN16931 Amostra

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

zugferd-invoice-2.0.csv

---

Opções avançadas

Todos os campos dentro do Opções avançadas As coleções são opcionais. Adicione-as através de Adicionar opção na interface do usuário do nó.

perfis

Personalizado PDF4me Perfis de processamento. Aplique conjuntos de opções pré-configuradas para geração de faturas ZUGFeRD avançada ou especializada (por exemplo, regras de validação personalizadas, mapeamentos de esquema alternativos ou ajuste de saída específico do setor).

Opções de tipo de dados de entrada

Controla como o fundo PDF documento (a camada visual da fatura híbrida) é fornecida ao nó.

Menu suspenso Tipo de dados de entrada: controla como o plano de fundo PDF alcança o nó

NenhumSomente XML/JSON/CSV, sem PDF de fundo.

Não é necessário inserir nenhum documento. PDF4me gera ambos os visuais PDF camada e a estrutura XML a partir dos dados da fatura. Use esta opção quando existirem apenas os dados da fatura e você quiser PDF4me para renderizar o arquivo híbrido completo.

Dados bináriosArquivo do nó anterior (mais comum)

Lê o contexto PDF binário diretamente da saída de um anterior n8n nó: Download do Google Drive, HTTP Solicitar ou ler arquivo binário. O campo Propriedade Binária especifica qual campo de saída ler (padrão). dados).

String Base64Conteúdo do arquivo codificado em Base64

Aceita o plano de fundo PDF como uma string codificada em base64. Use isso quando o arquivo chegar de um API resposta, carga útil do webhook ou uma coluna de banco de dados que armazena documentos em base64.

URLBaixar a partir de um link público

Disponibilizar um acesso público URL para o fundo PDF. PDF4me baixa o arquivo diretamente antes de gerar a fatura híbrida. URL Não deve exigir autenticação.

Opções do modo de saída

Controla se o nó produz um puro XML arquivo ou o híbrido ZUGFeRD completo (PDF/A-3 + incorporado) XML).

Menu suspenso Modo de saída com duas opções: puro XML ou híbrido PDF/A-3 com XML integrado

Somente XMLPuro XML, não PDF invólucro

Gera apenas a saída estruturada. XML Dados da fatura. Use quando o sistema receptor processar os dados. XML diretamente e descarta o conteúdo visual, para submissões XML puras do XRechnung ou para testar a camada de dados isoladamente. Defina a extensão do nome do arquivo de saída para .xml.

XML com PDFPadrão: arquivo híbrido ZUGFeRD completo

Gera a fatura híbrida padrão ZUGFeRD: um PDF/A-3 de qualidade arquivística. PDF com a estrutura XML Os dados da fatura estão incorporados como um anexo. Os humanos leem o PDF, as máquinas analisam o XMLEste é o resultado padrão do ZUGFeRD para faturamento eletrônico B2B em produção.

Opções de versão do ZUGFeRD

A versão da especificação ZUGFeRD está incorporada na fatura gerada.

Menu suspenso de versões do ZUGFeRD com seis opções, incluindo a versão legada 1.0 e a mais recente 2.4.

1.0Legado: não atende ao mandato de 2025

Especificação original de 2014. Compatível apenas com sistemas de recepção legados. não Atender à obrigatoriedade de faturamento eletrônico B2B na Alemanha, em vigor a partir de 2025. Evitar para novos fluxos de trabalho.

2.0Padrão: ampla compatibilidade

Primeira versão alinhada à norma EN 16931 (2019). Atende aos requisitos da legislação alemã para faturamento B2B e é a opção padrão segura para faturamento B2B em geral. Totalmente compatível com Factur-X 1.0.

2.1Pequenos ajustes

Adiciona pequenos refinamentos e esclarecimentos de esquema em relação à versão 2.0. Use quando o seu sistema receptor exigir especificamente a versão 2.1.

2.2Perfil XRECHNUNG atualizado

Compatível com a versão atualizada do perfil XRECHNUNG 2.x. Selecione esta opção ao faturar para entidades do setor público alemão que exigem o perfil mais recente.

2.4Novidade: suporte mais recente para XRECHNUNG

Última especificação lançada. Inclui suporte para o perfil XRECHNUNG mais recente e melhorias de esquema. Selecione quando a parte receptora exigir a versão mais recente.

PersonalizadoManipulação avançada de versões

Permite o tratamento de versões personalizadas quando um identificador de versão não padrão é exigido por um sistema de recebimento específico. Use somente quando instruído explicitamente pela sua contraparte de faturamento.

Opções de Nível de Conformidade

O perfil de conformidade controla quais campos da fatura são obrigatórios e validados, sendo essa a escolha mais importante para a conformidade.

Menu suspenso de Nível de Conformidade com seis perfis, de MÍNIMO a EXTRACONFIGURADO, controlando os requisitos de campo e o escopo de conformidade.

MÍNIMOApenas o cabeçalho, não é uma fatura válida.

Apenas dados de cabeçalho: partes, totais, referências de documentos. Sem itens de linha. Não pode ser usado como fatura legal; apenas para entregas contábeis internas ou notificações de status.

BASICWLBásico sem linhas: apenas IVA

Adiciona a discriminação do IVA/impostos além do valor MÍNIMO. Ainda assim. Sem itens de linha. Utilizado apenas em cenários de reserva, onde as faturas são conciliadas com os pedidos, e não como faturas legais independentes.

BÁSICOFatura legal mínima

Adiciona itens de linha além do BASICWL. Atende ao mínimo absoluto da diretiva de faturamento eletrônico da UE. Aceitável para faturas simples, mas a norma EN16931 é a opção padrão mais segura para total conformidade B2B.

EN16931Padrão: Norma Europeia

Perfil completo da norma europeia EN 16931. Padrão recomendado para faturamento B2B em toda a UE e o nível de conformidade a que se refere o mandato alemão de 2025. Inclui todos os campos necessários para a emissão de faturas comerciais em conformidade.

ESTENDIDOExtras específicos do setor

Adiciona campos específicos do setor além da norma EN 16931, como por exemplo, referências adicionais de logística, frete ou setor específico. Utilize quando o seu acordo setorial ou parceiro comercial exigir os campos EXTENDIDOS.

XRECHobrigatório no setor público alemão

O perfil alemão XRechnung CIUS, Obrigatório para faturas emitidas a autoridades federais, estaduais e municipais alemãs. Validação mais rigorosa que a EN16931. Utilizar sempre que o destinatário for uma entidade do setor público alemão.

Opções de idioma

Idioma de exibição para etiquetas de faturas no arquivo renderizado PDF camada. A XML Os dados em si são neutros em relação ao idioma.

Linguagem: rótulos localizados para o renderizado PDF (O alemão é típico para negócios B2B e B2G na Alemanha).

AlemãoPadrão, alemão B2B/B2G

InglêsFaturação internacional

FrancêsFluxos de trabalho Factur-X

italianoItaliano B2B

EspanholB2B espanhol

HolandêsPaíses Baixos/Bélgica

polonêsPolônia B2B

PortuguêsPortugal/Brasil

Opções de formato de entrada

Formato dos dados da fatura que você fornece ao nó.

Formato de entrada: escolher XML, JSON, ou CSV para corresponder ao conteúdo da sua fatura.

XMLPré-fabricado XML fatura

Forneça o arquivo já formatado e em conformidade com o padrão ZUGFeRD. XML ou UBL XML dados. Use quando seus ERP já produz padrão XML faturas que só precisam ser agrupadas no formato híbrido PDF.

JSONPadrão: moderno API fonte

Dados de faturas de fornecimento como uma estrutura JSON objeto. A opção mais comum quando os dados da fatura chegam por meio de um webhook. REST APIou software de contabilidade moderno. PDF4me mapas JSON campos para o ZUGFeRD XML esquema automaticamente.

CSVdados tabulares de faturas em lote

Dados de faturas de fornecimento como CSVÚtil para exportação em lote de faturas a partir de planilhas, sistemas legados ou cenários de faturamento em massa. PDF4me mapas CSV colunas para o esquema ZUGFeRD.

Opções de tipo de entrada de dados de fatura

Controla como os dados da fatura (o XML, JSON, ou CSV conteúdo) chega ao nó.

Tipo de entrada de dados da fatura: como o XML, JSON, ou CSV A carga útil é fornecida (em linha, binária de um nó anterior, base64 ou URL).

Texto diretoPadrão: colar ou mapear em linha

Cole ou mapeie os dados da fatura diretamente no campo Dados da Fatura. Ideal para JSON ou menor CSV cargas úteis de nós upstream. Use n8n Sintaxe de expressão para construir os dados dinamicamente.

Dados bináriosArquivo do nó anterior

Lê o arquivo de dados da fatura (XML, JSON, ou CSV) diretamente da saída binária de um anterior n8n nó: Google Drive Download, Ler arquivo binário ou HTTP Solicitar. Ideal para grandes quantidades. XML arquivos.

String Base64Dados codificados em Base64

Aceita os dados da fatura como uma string codificada em base64. Use quando o conteúdo da fatura chegar de um API resposta ou campo de banco de dados que armazena arquivos em base64.

URLBaixar a partir de um link público

Disponibilizar um acesso público URL ao arquivo de dados da fatura. PDF4me Faz o download do arquivo e analisa o conteúdo de acordo com o formato de entrada selecionado.

Campos de saída

Campo	Tipo	O que contém
fileName	String	Filename of the generated ZUGFeRD invoice, for example zugferd_invoice.pdf for XML With PDF output or zugferd_invoice.xml for XML Only output.
mimeType	String	MIME type of the output file: application/pdf for hybrid output, application/xml for XML Only. Useful for content type validation in downstream HTTP or storage nodes.
fileSize	Number	Size of the generated ZUGFeRD file in bytes. Useful for storage planning, bandwidth monitoring, and conditional routing in the workflow.
success	Boolean	True when the ZUGFeRD invoice was generated successfully. False if validation failed or input data was malformed. Use this field to route error handling branches.
message	String	Human-readable status message confirming success or describing the validation/parsing error encountered. Useful for logging and error notification steps.

Configuração rápida

1. Adicionar PDF4me para o seu n8n Fluxo de trabalho. Configurar Recurso para Fatura e Operações de Faturamento para Criar fatura Zugferd.
2. Em Credencial para se conectar com, selecione o seu PDF4me credencial ou clique Criar nova credencial e cole o seu API chave.
3. Definir Tipo de dados de entrada: conectar um nó anterior (Dados Binários), fornecer um Base64 corda ou URL para o plano de fundo PDFou selecione Nenhum quando PDF4me deve renderizar o PDF apenas com base nos dados da fatura.
4. Digitar Nome do documento (por exemplo invoice.pdf).
5. Definir Modo de saída: XML com PDF para a saída híbrida padrão ZUGFeRD, ou Somente XML para puro XML.
6. Escolher Versão Zugferd (usar 2.0 como a opção padrão segura; 2.4 (para o perfil XRECHNUNG mais recente).
7. Escolher Nível de conformidade: EN16931 Para B2B em geral, XRECH para faturamento do setor público alemão, ESTENDIDO para áreas específicas da indústria.
8. Definir Linguagem para o renderizado PDF Rótulos (alemão por padrão).
9. Habilitar Gerar fatura em PDF se você quiser PDF4me Exibir o conteúdo da fatura visualmente; desative ao fornecer um plano de fundo predefinido. PDF.
10. Escolher Formato de entrada (JSON, XML, ou CSV) e Tipo de entrada de dados da fatura (Texto direto, dados binários, string Base64 ou URL). Cole ou mapeie os dados da fatura no campo Dados da Fatura.
11. Definir Nome do arquivo de saída para zugferd_invoice.pdf e Nome do campo binário de saída para data.
12. Conecte a saída ao seu próximo nó (remetente de e-mail, upload para armazenamento em nuvem, portal governamental). HTTP POST) e execute o fluxo de trabalho.

Exemplos de fluxo de trabalho

Exemplos de fluxo de trabalhoCommon n8n workflow patterns using Create Zugferd Invoice.

Software de contabilidade → Fatura ZUGFeRD 2.0 EN16931 → enviar e-mail ao cliente

1. Um gatilho Webhook é acionado quando uma fatura é finalizada na plataforma de contabilidade (DATEV, sevDesk, lexoffice).
2. A carga útil do webhook contém dados de fatura em formato estruturado. JSON objeto.
3. PDF4me A criação da fatura Zugferd gera uma fatura híbrida. O tipo de dados de entrada é Nenhum (PDF4me renderiza o PDF do JSONO modo de saída é XML com PDF, a versão do Zugferd é 2.0, o nível de conformidade é EN16931, o idioma é alemão e o formato de entrada é JSONO tipo de entrada de dados da fatura é Texto Direto mapeado a partir da carga útil do webhook.
4. Um nó do Gmail envia um e-mail para o ZUGFeRD. PDF para o endereço de contas a pagar do cliente, atendendo ao requisito de mandato de recebimento B2B alemão.
5. Um nó PostgreSQL registra o número da fatura, a versão do ZUGFeRD e o nível de conformidade para fins de auditoria e relatórios de conformidade.

ERP XML fatura → ZUGFeRD XRECHNUNG → carregar no portal do setor público

1. Um gatilho de agendamento é acionado todos os dias úteis às 16h para processar faturas do setor público.
2. Um nó SFTP extrai dados recém-gerados. ERP XML Arquivos de fatura da pasta de exportação.
3. PDF4me A opção Criar Fatura Zugferd gera uma fatura em conformidade com o padrão XRECHNUNG. O Tipo de Dados de Entrada é Nenhum, o Modo de Saída é XML com PDF, a Versão do Zugferd é 2.4 (perfil XRECHNUNG mais recente), o Nível de Conformidade é XRECHNUNG, o Idioma é Alemão e o Formato de Entrada é XMLO tipo de entrada de dados da fatura é Dados Binários mapeados a partir do conteúdo do arquivo SFTP.
4. Um HTTP O nó de requisição carrega a fatura XRECHNUNG para a ZRE federal (Plataforma Central de Recebimento de Faturas do Governo Federal) ou para o portal estadual correspondente.
5. Um produto da Microsoft Outlook O nó envia uma confirmação para a equipe de compras e um nó PostgreSQL registra a referência da submissão.

Mensal CSV Lote de faturamento → Faturas ZUGFeRD → arquivar em SharePoint

1. Um gatilho de agendamento é acionado no dia 1º de cada mês para processar a fatura mensal.
2. Um nó do Google Drive baixa o arquivo consolidado. CSV Exportação de faturamento, uma linha por fatura de cliente.
3. Um nó Split In Batches itera sobre cada CSV linha. PDF4me A opção Criar Fatura Zugferd gera uma fatura ZUGFeRD por cliente. O Tipo de Dados de Entrada é Nenhum, o Modo de Saída é XML com PDF, a Versão Zugferd é 2.0, o Nível de Conformidade é EN16931, o Idioma varia de acordo com a localidade do cliente e o Formato de Entrada é CSVO tipo de entrada de dados da fatura é Texto Direto com conteúdo CSV por linha.
4. Um produto da Microsoft SharePoint O nó carrega cada ZUGFeRD PDF para a pasta de arquivo de faturamento do cliente.
5. Um nó do Gmail envia a cada cliente sua fatura híbrida; uma linha de resumo final no PostgreSQL registra a execução do lote com a contagem de faturas e o valor total.

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 read the visual PDF and machines parse the embedded XML, so a single file serves both audiences. 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. Use ZUGFeRD 2.x with EN16931 for general B2B, XRECHNUNG conformance for German public sector, and ZUGFeRD/Factur-X for cross-border French-German invoicing.

Which ZUGFeRD version should I use in 2025 for the German B2B e-invoicing mandate?+

ZUGFeRD 2.0 or higher is required to comply with the German B2B e-invoicing mandate. The mandate, enacted under the Wachstumschancengesetz (Growth Opportunities Act), made e-invoice receipt mandatory from 1 January 2025 and phases in full sending obligations by 2028. Versions 2.0 through 2.4 all comply with EN 16931, the European standard the mandate references. ZUGFeRD 2.2 and 2.4 add support for the newer XRECHNUNG profile updates. Legacy ZUGFeRD 1.0 does not satisfy the mandate. Default to 2.0 for broad compatibility across receiving systems, or 2.4 when the latest XRECHNUNG profile is required.

What is the difference between MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, and XRECHNUNG conformance levels?+

MINIMUM contains only the absolute minimum invoice header data (totals and parties) and cannot serve as a legal invoice; it is for internal accounting drop-offs only. BASICWL (Basic Without Lines) adds VAT and tax breakdowns but still has no line items. BASIC adds line items and meets the absolute minimum of the EU e-invoicing directive. EN16931 is the European Standard EN 16931 profile, recommended as the default for B2B invoicing across the EU and the level the German mandate references. EXTENDED adds industry-specific fields beyond EN 16931. XRECHNUNG is the German public-sector mandatory profile, required when invoicing federal, state, or municipal authorities. Use EN16931 for general B2B, XRECHNUNG for public sector, EXTENDED for industry-specific scenarios.

What is the difference between XML Only and XML With PDF output modes?+

XML Only generates a pure XML file containing the structured invoice data, useful when the receiving system processes only the XML and discards visual content, for XRechnung pure-XML submissions, or for testing the data layer in isolation. XML With PDF generates the full ZUGFeRD hybrid invoice: a PDF/A-3 archival document with the XML embedded as an attachment inside the PDF. The hybrid format is the canonical ZUGFeRD output and is required when both human readability and machine processing must be supported by a single file. Choose XML With PDF for production e-invoicing workflows and XML Only for data-layer integration testing or pure-XML public-sector submissions.

Can I generate ZUGFeRD invoices from CSV data, and what does Invoice Data Input Type control?+

Yes. The Input Format parameter supports XML, JSON, and CSV; pick the format matching your data source. Invoice Data Input Type then controls how the data reaches the node: Direct Text lets you paste or map the data inline (best for JSON or small CSV from upstream nodes), Binary Data reads from a previous file node (best for large XML files), Base64 String accepts encoded content (best for API payloads), and URL downloads the data file from a public link. CSV input is automatically mapped to the ZUGFeRD XML schema by PDF4me before being embedded in the output PDF; no manual XML construction is required.

Ações relacionadas

Criar nota QR suíça

Gere comprovantes de pagamento com QR Code suíço incorporados à fatura. PDFs Para o padrão de pagamento bancário suíço. Combine com ZUGFeRD para faturamento transfronteiriço DACH.

Criar PDF/A

Converter PDFs para PDF/A Formato de arquivo, útil na preparação de informações de fundo. PDFs para faturas híbridas ZUGFeRD que devem atender aos padrões de conformidade PDF/A-3.

Analisador de faturas com IA

Extrair dados estruturados de faturas recebidas. PDFsCombine com a ferramenta Criar Fatura Zugferd para converter faturas antigas em um formato compatível com o ZUGFeRD.

Mesma tarefa em outras plataformas

Criar fatura ZUGFeRD (Gerar)

Mesma operação de faturamento eletrônico que um módulo Make: mesmo modelo de parâmetros e níveis de conformidade, ideal para criadores de cenários visuais que conectam Dropbox, Google Drive e ERP exportações.

Criar fatura ZUGFeRD (Zapier)

Funcionamento semelhante a uma ação do Zapier, ideal para SaaSFluxos de faturamento B2B orientados a dados e acionados por webhook, alimentando o Gmail. Salesforcee ferramentas de contabilidade.

Criar fatura ZUGFeRD (Power Automate)

Power Automate / Microsoft 365 fluxos, ideal para SharePoint, Outlooke faturamento empresarial baseado em Dataverse em ambientes regulamentados da região DACH.

Obtenha ajuda

n8n Integration Guiden8n SampleGetting Started