Criar ZUGFeRD Fatura em Make
Criar ZUGFeRD Fatura é um Make módulo por PDF4me que gera híbridos ZUGFeRD/Factur-X faturas eletrônicas de CSV, JSON, ou XML Dados da fatura. Use-os para gerar um PDF/A-3 documento com legibilidade por máquina XML embutido no interior, alinhado ao EN 16931 Norma europeia de faturação eletrónica. Escolha o nível de conformidade e a versão da especificação que correspondam ao que o seu comprador ou ERP O sistema exige.
O que este módulo faz
PDF4meCrie um ZUGFeRD fatura gera faturas eletrônicas híbridas diretamente dentro do seu Make cenário. Fornecer dados de fatura como CSV, JSON, ou XMLO módulo produz um PDF/A-3 documento com um formato legível por máquina ZUGFeRD XML arquivo incorporado nele, ou um XML-somente saída para ERP sistemas que gerenciam sua própria renderização. O resultado está alinhado com o EN 16931 Padrão europeu de faturação eletrónica e é aceite como Factur-X Na França e em todos os mercados da UE. Os níveis de conformidade e a versão da especificação são configuráveis para atender exatamente às necessidades do seu comprador ou destinatário do setor público.
Autenticando seu API Solicitar
Todo PDF4me módulo em Make requer um válido ConexãoCrie ou selecione um que contenha o seu PDF4me API chave para que o cenário possa chamar o serviço de geração de faturas com segurança.
Fatos importantes que você não deve perder
A saída híbrida é uma PDF/A-3 documento. o ZUGFeRD XML está incorporado como um anexo compatível dentro do arquivo. ERP sistemas extraem o XML automaticamente; humanos ainda podem abrir e ler o PDF em qualquer visualizador padrão. Configurar Gerar fatura em PDF Sim, para que os itens da fatura sejam exibidos visualmente na página.
A versão 1.0 suporta BÁSICO, CONFORTO, ESTENDIDOA versão 2+ expande para MÍNIMO, BÁSICO, BÁSICO, EN16931, ESTENDIDO, XRECHNUNG. XRECHNUNG e EN16931 São obrigatórios para a emissão de faturas no setor público na Alemanha. Certifique-se sempre de que a versão e o nível correspondam aos padrões exigidos pelo sistema do comprador.
Selecionando XML mostra o Dados XML da fatura campo; JSON Exibe dados JSON da fatura; CSV Exibe dados CSV da fatura. Preencha apenas os campos que correspondem ao formato escolhido. Ao usar XML formato, o módulo também expõe um Arquivo rádio para que você possa puxar o XML diretamente do Dropbox ou mapeando-o de um módulo anterior.
Qual ZUGFeRD Qual versão devo usar?
O módulo suporta duas versões de especificação. A maioria das novas integrações deve usar a versão 2.0 ou superior; a versão 1.0 é mantida para interoperabilidade com versões anteriores.
ZUGFeRD 2.0+ RECOMENDADO
Especificações atuais. Níveis de conformidade: MÍNIMO, BASICWL, BÁSICO, EN16931 (Comfort, a cláusula padrão legal alemã), ESTENDIDO, XRECHCompatível com outras tecnologias. Factur-XCombine com o 2.0 XML amostra, 2.0 EN16931 JSON amostra, ou 2.0 CSV amostraAs capturas de tela abaixo mostram a interface do usuário da versão 2.0+ exatamente como ela é renderizada atualmente.
ZUGFeRD 1.0 LEGADO
Pré-EN 16931 Especificações. Níveis de conformidade: BÁSICO, CONFORTO, ESTENDIDOUse somente quando o destinatário for ERP ou o sistema de compradores exige explicitamente a versão 1.0 (raro após 2022). Combine com o 1.0 XML amostra, o básico JSON amostraou o 1.0 CSV amostraTodos os outros campos funcionam da mesma forma; apenas a lista suspensa do nível de conformidade muda.
Comece com Conexão, depois mapeie a base PDF (Nome do arquivo, Documento) e definir Formato de entrada (aqui XML).
Com Arquivo = Mapamapa Dados XML da fatura, definir Modo de saída (XmlWithPdf ou Somente XML), então escolha zugferd Versão (aqui 1.0).
Parâmetros
Obrigatório: Conexão, Formato de entrada, Modo de saída, ZUGFeRD VersãoO campo de dados da fatura (Dados XML da fatura, Dados JSON da fatura, ou Dados CSV da fatura) aparece dinamicamente com base na sua seleção de Formato de Entrada. Apenas o campo correspondente precisa ser preenchido.
Por que Arquivo Aparecem duas vezes nas capturas de tela da versão 2.0+? Quando o formato de entrada é XML e o arquivo está configurado para MapaO módulo renderiza um segundo seletor de arquivos para que você possa mapear (a) o seletor base. PDF o ZUGFeRD a fatura deve ser incorporada em, e (b) a fonte ZUGFeRD XML arquivo. Ambos os seletores exibem as mesmas opções de rádio. Quando o formato de entrada é JSON ou CSV O segundo seletor é substituído pelo correspondente. Dados JSON da fatura ou Dados CSV da fatura campo de texto.
| Parâmetro | Obrigatório | O que faz | Exemplo / Opções |
|---|---|---|---|
| Connection | Required | PDF4me API connection used to authenticate invoice generation requests. Click Add and paste your API key if connecting for the first time. | Your PDF4me connection |
| File | Conditional | Source of the base PDF where the ZUGFeRD invoice will be embedded (when Output Mode is XmlWithPdf). Radio button with two options: Dropbox - Download a File (pulls directly from a Dropbox account without a prior download step) or Map (supplies the PDF from a prior module. Dropbox, Google Drive, OneDrive, HTTP, etc.). Choose Map for the most flexible workflow. When Map is selected, the two sub-fields below appear. | Map |
| File → File Name | Conditional | Sub-field of File (visible when Map is selected). Filename of the base PDF including the .pdf extension. Map from the prior module's filename output. for example, the File Name field of a Dropbox or Google Drive Download module. | 1. File Name |
| File → Document | Conditional | Sub-field of File (visible when Map is selected). Binary PDF content where the ZUGFeRD XML will be embedded. Map from the prior module's binary data field. typically the Data field of Dropbox, Google Drive, or OneDrive download modules. Hint shown in module: "PDF file where Zugferd invoice should be added". | 1. Data |
| Input Format | Required | Format of the invoice data being supplied. Use XML for existing ZUGFeRD XML; JSON or CSV for structured data. Hint: "Format of the invoice data being supplied. Use XML for existing ZUGFeRD XML, JSON or CSV for structured data." | XML sampleXML 2.0 sampleJSON 2.0 EN16931 sampleJSON (basic)CSV sampleCSV 2.0 sample |
| Invoice XML Data | Conditional | The ZUGFeRD XML invoice content to embed. Appears when Input Format = XML and File = Map. Hint: "Use when inputFormat is XML, please refer to our Create a ZUGFeRD invoice for guidelines." Map from a prior Dropbox download or HTTP module output. | XML sampleXML 2.0 sample3. Data (mapped) |
| Invoice JSON Data | Conditional | Structured invoice data in JSON format. Appears when Input Format = JSON. Map a JSON string from a Google Sheets, Airtable, or HTTP module. See sample JSON below. | JSON 2.0 EN16931 sampleJSON (basic)(mapped JSON string) |
| Invoice CSV Data | Conditional | Invoice row data in CSV format. Appears when Input Format = CSV. Map a CSV row from an iterator, Google Sheets, or file download module. See sample CSV below. | CSV sampleCSV 2.0 sample(mapped CSV row) |
| Output Mode | Required | XML With PDF (a.k.a XmlWithPdf in API requests) returns a PDF/A-3 file with the ZUGFeRD XML embedded inside, the standard hybrid e-invoice. XML Only (XmlOnly) returns just the XML invoice file without a PDF wrapper. Hint shown in module: "XML with PDF returns a PDF with embedded ZUGFeRD XML. XML only returns only the XML invoice file." | XML With PDF |
| ZUGFeRD Version | Required | ZUGFeRD specification version. Set to match what the recipient ERP or buyer system expects. Latest is 2+; legacy 1.0 also supported. The two have different conformance level sets (see table below). | 2+ |
| Conformance Level | Optional | ZUGFeRD conformance profile. Available levels differ by version. For 2+, EN16931 (Comfort) is the default for German legal e-invoicing compliance. See the Conformance Level Reference table below. Defaults to BASIC if not specified. | EN16931 |
| Render Invoice on PDF | Optional | When set to Yes, invoice line items are drawn visually on the PDF pages. Applies only when Output Mode is XmlWithPdf. Options: Yes, No, Empty. Hint: "Render invoice data visually on PDF pages. Applies only when outputMode is XmlWithPdf." | Yes |
| language | Optional | Two-letter locale code for invoice label localisation. Supported: de, en, fr, it, es, nl, pl, pt, cs. Hint: "Language code for invoice localisation (e.g. de, en, fr, it, es, nl, pl, pt, cs). Defaults to de if not specified." | de |
Referência do nível de conformidade
Os níveis de conformidade disponíveis diferem por zugferd VersãoSempre combine o nível com o que seu comprador ou ERP O sistema exige.
| Nível | Use quando |
|---|---|
BASIC | Mandatory EN 16931 fields only. Widest compatibility, safe default. |
COMFORT | Adds optional fields for line-item detail and additional references. |
EXTENDED | Full field set for complex B2B invoices with delivery, allowances, and charges. |
| Nível | Use quando |
|---|---|
MINIMUM | Absolute minimum fields. Buyer reference and totals only. |
BASICWL | BASIC without line items. Header-level data only. |
BASIC | Mandatory EN 16931 fields. Recommended starting point. |
EN16931 | Full EN 16931 compliance for cross-border and public sector. |
EXTENDED | Full field set including German-specific extensions. |
XRECHNUNG | German public-sector e-invoice mandate (XRechnung profile). |
Exemplos de Arquivos de Fatura
Use esses arquivos de exemplo para testar o módulo 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).
ZUGFeRD-invoice-sample.xmlZUGFeRD-invoice-sample-2.0.xmlsample-invoice-zugferd-2.0-en16931.jsonexemplo-fatura.jsontest-invoice.csvzugferd-invoice-2.0.csvCSV Referência da coluna
O CSV Os dados devem ser inseridos exatamente nesta ordem de colunas. Cada linha gera uma fatura.
| Coluna | Descrição | Exemplo |
|---|---|---|
InvoiceId | Unique invoice identifier | INV-2025-001 |
IssueDate | Invoice issue date (YYYY-MM-DD) | 2025-01-15 |
SellerName | Seller company name | Test Company |
SellerStreet | Seller street address | 123 Main St |
SellerCity | Seller city | Test City |
SellerPostalCode | Seller postal / ZIP code | 12345 |
SellerCountry | ISO 3166-1 alpha-2 country code | DE |
SellerVatId | Seller VAT registration number | DE123456789 |
BuyerName | Buyer company or person name | Customer Inc |
BuyerStreet | Buyer street address | 456 Oak Ave |
BuyerCity | Buyer city | Customer City |
BuyerPostalCode | Buyer postal / ZIP code | 67890 |
BuyerCountry | ISO 3166-1 alpha-2 country code | DE |
ProductName | Line item product or service name | Test Product |
Quantity | Quantity of the line item | 10.0 |
UnitPrice | Net unit price | 9.90 |
TaxPercent | VAT / tax percentage | 19.0 |
Currency | ISO 4217 currency code | EUR |
PaymentReference | Payment reference string | PAY-REF-001 |
IBAN | Payee IBAN for bank transfer | DE08700901001234567890 |
BIC | Payee bank BIC / SWIFT code | GENODEF1M04 |
JSON Estrutura da fatura
Ao usar Formato de entrada: JSONA carga útil deve incluir as seguintes chaves de nível superior. Todos os objetos e arrays aninhados seguem a estrutura mostrada no arquivo de exemplo.
| Chave | Tipo | Descrição |
|---|---|---|
InvoiceId | String | Unique invoice number, e.g. "471102" |
IssueDate | String (ISO 8601) | Invoice date, e.g. "2013-03-05T00:00:00" |
InvoiceType | String | Document type label, e.g. "RECHNUNG" |
TypeCode | String | UN/EDIFACT document type code. 380 for standard invoice |
IsTest | Boolean | true for test runs, false / omit for production |
Notes | Array of strings | Free-text notes shown in the invoice header (payment terms, GLN, etc.) |
Seller | Object | Seller party: Name, Address (Street, City, PostalCode, Country), TaxId, VatId, GLN |
Buyer | Object | Buyer party: Name, Address (Street, City, PostalCode, Country, LineTwo), GLN |
Payment | Object | Payment details: PaymentReference, Currency, IBAN, BIC |
DeliveryDate | String (ISO 8601) | Actual delivery date, e.g. "2013-03-05T00:00:00" |
LineItems | Array of objects | Invoice lines. each with Quantity, UnitCode, UnitPrice, LineTotal, ProductName, GTIN, SellerProductId |
Totals | Object | Monetary totals: LineTotal, ChargeTotal, AllowanceTotal, TaxBasisTotal, TaxTotal, GrandTotal, TaxPercent, Currency |
Como faço para criar um ZUGFeRD fatura em Make?
- Adicionar PDF4me → Criar um ZUGFeRD fatura de acordo com o seu cenário.
- Selecione Conexão (ou clique) Adicionar para criar um com o seu API chave).
- Escolher Formato de entrada. XML, JSON, ou CSVO campo de dados que aparece depende dessa seleção.
- Definir Arquivo para Mapa e conecte o campo de dados da fatura (Dados XML da Fatura / Dados JSON / Dados CSV) da saída do módulo anterior. Ou escolha Dropbox - Baixar um arquivo Para extrair o arquivo diretamente do Dropbox.
- Definir Modo de saída para XmlWithPdf para um híbrido PDF/A-3 fatura, ou Somente XML para XML apenas.
- Definir zugferd Versão (1.0 ou 2+) e então escolha Nível de conformidade do conjunto apropriado para a versão. Comece com BÁSICO.
- Se estiver usando XmlWithPdf: defina Gerar fatura em PDF para Sim para desenhar itens de linha visualmente e definir linguagem para sua localidade de destino (por exemplo,
de,en,fr). - Salvar e clique Executar uma vez. Roteie o Dados do documento saída para Dropbox, Google Drive, um ERP webhook ou um módulo de e-mail.
Campos de saída
| Campo | Tipo | O que contém |
|---|---|---|
Document Name | String | Filename of the generated invoice file. e.g. invoice-471102.pdf or invoice-471102.xml. |
Document Data | Buffer | Binary content of the ZUGFeRD hybrid PDF/A-3 or XML file. Map into an upload, email attachment, or ERP HTTP module for the next step in your scenario. |
Exemplos de fluxo de trabalho
Exemplos de fluxo de trabalhoCommon Make scenario patterns using Create ZUGFeRD Invoice for automated e-invoicing.
- Um pedido é marcado como enviado no seu navegador. ERP ou Airtable. O cenário é acionado.
- Os itens da lista, os preços, o endereço do comprador e os dados fiscais são obtidos e reunidos em um único documento. JSON carga útil.
- Criar ZUGFeRD fatura Executa com formato de entrada JSONModo de saída XmlWithPdf, versão 2+Nível de conformidade BÁSICO, linguagem
de. - O híbrido PDF é enviada ao comprador por e-mail via Gmail e uma cópia é carregada no arquivo de faturas do Google Drive.
- A contabilidade deixa de lado um CSV Enviar arquivo com as faturas mensais para o Dropbox.
- Um gatilho "Monitorar Arquivos" detecta o novo arquivo e um iterador processa cada linha.
- Criar ZUGFeRD fatura execuções por linha com formato de entrada CSV, gerando um híbrido PDF por fatura.
- Todos PDFs Os documentos são carregados em uma pasta de arquivo estruturada e um e-mail com o resumo da conclusão é enviado para a equipe financeira.
- Uma fatura de contrato governamental é gerada a partir de um registro do Airtable.
- Criar ZUGFeRD fatura Executa com formato de entrada JSONModo de saída Somente XML, versão 2+Nível de conformidade XRECARGA.
- O XML O arquivo é enviado diretamente via POST para o dispositivo compatível com Peppol do comprador. ERP API por meio de um HTTP módulo.
- O resultado, seja ele positivo ou negativo, é registrado em uma planilha do Google para que a equipe financeira possa analisá-lo.