Fatura eletrônica ZUGFeRD a partir de uma lista do SharePoint: Converta JSON em XML EN 16931 e em PDF/A-3 no Power Automate com PDF4me

O PDF4me Create ZUGFeRD Invoice é uma ação do Power Automate que transforma dados de faturas em uma fatura eletrônica híbrida em PDF/A-3. Apontada para uma lista do SharePoint, ela utiliza o JSON gerado por uma ação Compose a partir de cada linha, escreve o XML EN 16931, desenha a fatura legível no PDF base, arquiva o resultado e o envia por e-mail ao comprador.

Ao pesquisar por ZUGFeRD, você se depara com um de três lugares: uma explicação sobre o formato, um validador que verifica se um arquivo já existente está correto ou uma biblioteca em PHP, Java ou C# para desenvolvedores que criam softwares de faturamento. Todos os três partem do pressuposto de que a fatura já existe em algum lugar. A pergunta que nenhum deles responde é a que uma equipe financeira realmente enfrenta: os dados da fatura estão em uma lista, planilha ou em qualquer sistema que registre as vendas, e precisam ser convertidos em uma fatura eletrônica válida. Este fluxo preenche essa lacuna, em sete etapas e sem código.

Perguntas e respostas baseadas no porquê​

O que você receberá​

Entrada: uma linha com o número da fatura, as datas, a moeda, o bloco do vendedor, o bloco do comprador e um item de linha. Saída: uma fatura ZUGFeRD PDF/A-3 na biblioteca ZUGFeRD Invoices, a linha atualizada com seu status e um link, e um e-mail para o comprador com a fatura em anexo.

Uma linha por fatura. Cada coluna neste painel se torna uma chave no JSON que o fluxo constrói.

Um arquivo por número de fatura, redigido pela conta de fluxo.

A metade legível do mesmo arquivo, tal como o comprador o vê.

Do que você precisa​

O Fluxo em Resumo​

1. When an item is created (SharePoint), ele monitora a lista chamada ZUGFeRD Requests.
2. Compose cria o JSON da fatura a partir da linha.
3. Get file content using path reads /ZUGFeRD Templates/BaseInvoice.pdf.
4. Create ZUGFeRD Invoice (PDF4me PDF) converte o JSON em XML EN 16931 e retorna o PDF híbrido.
5. Create file (SharePoint) é salvo como ZUGFeRD_<invoice number>.pdf.
6. Update item (SharePoint) define Status como Generated e preenche OutputLink.
7. Send an email (V2) (Office 365 Outlook) envia a fatura ao comprador.

Visão geral completa do fluxo​

Quatro segundos e alguns segundos de ponta a ponta, e a própria fatura eletrônica leva cerca de um segundo. A etapa mais lenta é a gravação do arquivo pelo SharePoint.

Passo 1: Como acionar uma fatura eletrônica quando uma solicitação é recebida?​

Fluxo até agora: nada ainda, este é o gatilho.

A adição de uma linha é a forma como uma fatura é solicitada, portanto, esse é o sinal.

1. Crie um Automated cloud flow e selecione SharePoint > When an item is created.
2. Configurar:
   • Site Address: PDF4me Support - https://ynoox1.sharepoint.com/sites/PDF4meSupport
   • List Name: ZUGFeRD Requests

When an item is created: configuração​

Cada coluna na nova linha se torna um token que as próximas seis ações podem usar.

Passo 2: Como construir o JSON da fatura a partir de colunas de lista?​

Fluxo até o momento: o gatilho do SharePoint.

Uma única ação Compose descreve toda a fatura. É aqui que os nomes das suas colunas correspondem aos nomes esperados pelo padrão, e o texto é curto o suficiente para ser lido em uma única tela.

1. Adicionar Data Operation > Compose.
2. Cole o objeto abaixo em Entradas e substitua cada valor pelo token correspondente.

{
  "InvoiceId": "@{triggerBody()?['InvoiceNumber']}",
  "TypeCode": "380",
  "InvoiceType": "RECHNUNG",
  "IssueDate": "@{triggerBody()?['InvoiceDate']}T00:00:00",
  "DeliveryDate": "@{triggerBody()?['InvoiceDate']}T00:00:00",
  "IsTest": false,
  "Seller": {
    "Name": "@{triggerBody()?['SellerName']}",
    "VatId": "@{triggerBody()?['SellerVATID']}",
    "Address": {
      "Street": "@{triggerBody()?['SellerStreet']}",
      "PostalCode": "@{triggerBody()?['SellerPostalCode']}",
      "City": "@{triggerBody()?['SellerCity']}",
      "Country": "@{triggerBody()?['SellerCountry']}"
    }
  },
  "Buyer": {
    "Name": "@{triggerBody()?['BuyerName']}",
    "Address": {
      "Street": "@{triggerBody()?['BuyerStreet']}",
      "PostalCode": "@{triggerBody()?['BuyerPostalCode']}",
      "City": "@{triggerBody()?['BuyerCity']}",
      "Country": "@{triggerBody()?['BuyerCountry']}"
    }
  },
  "LineItems": [
    {
      "ProductName": "@{triggerBody()?['ItemDescription']}",
      "Quantity": @{triggerBody()?['Quantity']},
      "UnitCode": "C62",
      "UnitPrice": @{triggerBody()?['UnitPrice']},
      "LineTotal": @{float(...)}
    }
  ],
  "Totals": {
    "Currency": "@{triggerBody()?['Currency']?['Value']}",
    "LineTotal": @{float(...)},
    "TaxBasisTotal": @{float(...)},
    "TaxPercent": @{triggerBody()?['VATRate']},
    "TaxTotal": @{float(...)},
    "GrandTotal": @{float(...)},
    "ChargeTotal": 0,
    "AllowanceTotal": 0
  },
  "Payment": {
    "Currency": "@{triggerBody()?['Currency']?['Value']}",
    "PaymentReference": "@{triggerBody()?['InvoiceNumber']}",
    "DueDate": "@{triggerBody()?['DueDate']}T00:00:00"
  }
}

Compose: configuração​

Os valores de texto são representados por tokens entre aspas. Moedas e quantidades são números puros, por isso são representados pelo float.

De onde vem cada parte da fatura?​

Etapa 3: De onde vem o PDF base?​

Fluxo até agora: o gatilho mais Compose.

Os arquivos ZUGFeRD possuem uma página legível, e é aqui que tudo começa.

1. Adicionar SharePoint > Get file content using path.
2. Configurar:
   • Site Address: PDF4me Support - https://ynoox1.sharepoint.com/sites/PDF4meSupport
   • File Path: /ZUGFeRD Templates/BaseInvoice.pdf
   • Infer content type (avançado): Yes

Get file content using path: configuração​

Guarde o cabeçalho desta pasta. Ele é lido do zero a cada impressão, portanto, alterá-lo afetará a próxima fatura.

Passo 4: Como converter o JSON em um arquivo ZUGFeRD PDF/A-3?​

Fluxo até o momento: o gatilho, Compose e Get file content using path.

Esta é a ação que gera a fatura eletrônica. Ela lê o JSON, grava o XML EN 16931 e retorna um único arquivo contendo ambas as partes.

1. Adicionar a Create ZUGFeRD Invoice a partir da conexão PDF4me PDF.
2. Configurar:
   • ZUGFeRD version and Input Format: 2.0-JSON
   • Output Mode: XmlWithPdf
   • Invoice JSON Data: a expressão base64(outputs('Compose'))
   • Conformance Level: EN16931
   • Render Invoice on PDF: Yes
   • File Content: uma expressão base64() sobre o conteúdo de Get file content using path
   • File Name: BaseInvoice.pdf

Create ZUGFeRD Invoice: configuração​

O formato de entrada determina qual campo de dados é exibido. Selecione 2.0-JSON e a ação solicitará Invoice JSON Data, e não Invoice XML Data.

O que cada configuração decide​

Etapa 5: Onde a fatura deve ser arquivada?​

Fluxo até o momento: tudo através Create ZUGFeRD Invoice.

O número da fatura identifica o arquivo, o que permite que a biblioteca faça buscas.

1. Adicionar SharePoint > Create file.
2. Configurar:
   • Site Address: PDF4me Support - https://ynoox1.sharepoint.com/sites/PDF4meSupport
   • Folder Path: /ZUGFeRD Invoices
   • File Name: ZUGFeRD_ seguido pelo token InvoiceNumber e .pdf
   • File Content: o token Body da Create ZUGFeRD Invoice

Create file: configuração​

Para RE-2026-0007 este arquivo é ZUGFeRD_RE-2026-0007.pdf.

Etapa 6: Como você registra o resultado na solicitação?​

Fluxo até agora: tudo através de Create file.

A linha que solicitava a fatura também deveria indicar o que aconteceu com ela.

1. Adicionar SharePoint > Update item.
2. Configurar:
   • Site Address: PDF4me Support - https://ynoox1.sharepoint.com/sites/PDF4meSupport
   • List Name: ZUGFeRD Requests
   • Id: o token ID do gatilho
   • Title: o token Title do gatilho
   • Status Value (avançado): Generated
   • OutputLink (avançado): o URL da biblioteca seguido por ZUGFeRD_, o token InvoiceNumber e .pdf

Update item: configuração​

O link é montado a partir do URL da biblioteca e do mesmo padrão de nome usado Create file, com o espaço no nome da biblioteca já codificado como %20.

Passo 7: Como você envia a fatura para o comprador?​

Fluxo até agora: tudo através Update item.

Uma fatura eletrônica que permanece em uma biblioteca não foi emitida, portanto, a última ação consiste em entregá-la.

1. Adicionar Office 365 Outlook > Send an email (V2).
2. Configurar:
   • Para: o token Email do gatilho
   • Assunto: Your ZUGFeRD e-invoice seguida do token InvoiceNumber
   • Body: uma linha com o nome do comprador e da fatura, e indicando que o arquivo é um PDF/A-3 com XML EN 16931 incorporado
3. Abra Advanced parameters e adicione o anexo:
   • Nome Attachments - 1: ZUGFeRD_ mais o token InvoiceNumber mais .pdf
   • Conteúdo Attachments - 1: o token File Content da Create ZUGFeRD Invoice
   • Importance: Normal

Send an email (V2): configuração​

O anexo obtém seus bytes da ação que os produziu, portanto o SharePoint nunca os lê de volta.

Execute o fluxo e verifique​

1. Save o fluxo.
2. Adicione uma linha às ZUGFeRD Requests com um comprador, um item de linha, ambas as datas e um endereço que você possa verificar.
3. Abra o histórico de execução. Todas as sete ações devem estar verdes e a execução completa deve levar alguns segundos.
4. Abra a biblioteca ZUGFeRD Invoices e verifique se o arquivo está lá, sob o número da fatura.
5. Volte à linha: Status deve exibir Generated e OutputLink deve abrir a fatura.
6. Abra o anexo do e-mail e verifique ambas as partes: a página deve mostrar os valores corretos e o arquivo deve conter o XML.

A captura de tela levou cerca de quatro segundos no total, com a fatura eletrônica sendo gerada em apenas um deles. O resultado, ZUGFeRD_RE-2026-0007.pdf, tem aproximadamente 331 KB e é apresentado como uma fatura alemã: vendedor Muster GmbH em Berlin com ID DE123456789, cliente Test Kunde AG em Muenchen, tipo de documento 380, um item de Consulting com IVA de 19%, valor líquido de 1.005,00 EUR, IVA de 190,95 EUR e total de 1.195,95 EUR.

Variações comuns que você pode adicionar sem reconstruir​

Como isso se compara às outras formas de gerar uma fatura ZUGFeRD​

Cada linha descreve a alternativa. A última linha é este fluxo.

Perguntas frequentes​

O que é uma fatura ZUGFeRD?​

Uma fatura ZUGFeRD é um arquivo que funciona de duas maneiras. É um PDF normal que qualquer pessoa pode abrir e ler, e dentro dele há um anexo XML contendo a mesma fatura como dados estruturados. O sistema de contabilidade do comprador lê o XML e registra a fatura sem que ninguém precise digitá-la, enquanto o responsável pelas contas a pagar ainda visualiza uma página.

O formato vem do FeRD, o fórum alemão para faturamento eletrônico, e seu equivalente francês é Factur-X, que é a mesma ideia com outro nome.

O que é o formato ZUGFeRD?​

Tecnicamente, trata-se de um contêiner PDF/A-3 com um arquivo XML incorporado na sintaxe Cross Industry Invoice e um perfil que indica o grau de completude dos dados. O perfil utilizado aqui é EN16931, que corresponde ao padrão semântico europeu para faturamento eletrônico: o conjunto de campos que EN 16931 define como o núcleo de uma fatura.

Na prática, a consequência disso para a automação é que a saída é avaliada com base no XML, e não na página. Forneça os dados solicitados pelo perfil e o arquivo é aprovado; deixe a página mais bonita e nada muda.

Como criar uma fatura ZUGFeRD?​

Você precisa de três coisas: os dados da fatura em formato estruturado, uma página para a parte que será preenchida pelo usuário e um programa que insira o XML no PDF como um anexo PDF/A-3.

Neste fluxo, os dados são uma linha do SharePoint convertida em JSON, a página é o BaseInvoice.pdf e Create ZUGFeRD Invoice executa a terceira parte com Output Mode XmlWithPdf. Se seus dados já existirem como XML Cross Industry Invoice ou como uma linha CSV, altere o formato de entrada e utilize esse formato. O restante do fluxo permanece inalterado.

Qual a diferença entre ZUGFeRD e XRechnung?​

Ambos atendem ao mesmo padrão europeu, e a diferença está na formatação. ZUGFeRD é híbrido: um PDF legível com o XML incorporado, adequado para faturas enviadas a clientes que podem abri-las manualmente. XRechnung é somente XML e é o formato exigido pelos compradores do setor público alemão.

Se você enviar faturas para empresas, o arquivo híbrido geralmente é a opção mais segura, pois pode ser lido por qualquer pessoa que o abra. Se a fatura for para um órgão público, verifique qual formato é exigido por esse órgão antes de enviar.

Solução de problemas​

Próximos passos​

O mesmo padrão de sete etapas (uma linha chega, uma fatura é descrita como dados, um arquivo é produzido, arquivado, registrado e enviado) é o que toda exigência de faturamento eletrônico realmente requer, independentemente do formato que seus compradores acabem precisando.