Pular para o conteúdo principal

Como criar uma fatura ZUGFeRD no Power Automate? Um fluxo de trabalho passo a passo com Dropbox e JSON.

· 16 min para ler
SEO and Content Writer

Este guia mostra um completo Power Automate fluxo de trabalho que lê um PDF base e fatura JSON do Dropbox, gera um ZUGFeRD/Factur-X fatura usando PDF4me Criar fatura ZUGFeRDe grava o arquivo final de volta no Dropbox.

A sequência de capturas de tela utiliza estes caminhos de exemplo:

  • PDF base: /dados do blog/fatura zugferd/simplepdf.pdf
  • JSON: /blog data/zugferd invoice/sample-invoice.json
  • Pasta de saída: /dados do blog/fatura zugferd/saída
A versão curta

1. Acionar o fluxo manualmente → 2. Obter arquivo PDF base (Dropbox) → 3. Obter arquivo JSON (Dropbox) → 4. Criar fatura ZUGFeRD (PDF4me, Formato de entrada = JSON, Modo de saída = PDF com XML) → 5. Criar arquivo (pasta de saída do Dropbox).

Lembre-se disso ao configurar a etapa 4.

Definir Formato de entrada = JSON, então mapeie apenas Dados JSON da fatura. Manter Dados XML da fatura e Dados CSV da fatura vazio nesta execução. Para PDF com XML, Conteúdo do arquivo PDF É obrigatório e deve vir da etapa base do PDF.

O que você está construindo?

Você produz um fatura híbrida em PDF A partir de um modelo PDF e dados JSON estruturados, o resultado é adequado para equipes que precisam de um PDF legível com dados de fatura legíveis por máquina, formatados de acordo com as convenções ZUGFeRD/Factur-X.


Em resumo: todos os cinco passos

1Trigger
2Get PDF
3Get JSON
4Create ZUGFeRD
5Save output

Por que esse layout de fluxo de trabalho funciona?

Entradas separadas

Os formatos PDF e JSON são obtidos independentemente, permitindo que você atualize os arquivos de carga útil sem alterar o fluxo visual do modelo PDF.

Etapa de geração única

Criar fatura ZUGFeRD Recebe ambas as fontes de conteúdo em um só lugar e retorna um arquivo de saída que pode ser usado diretamente pelo Dropbox. Criar arquivo.

Fácil de ramificar mais tarde

Após a geração, você pode adicionar validação, notificações, entrega de ERP/API ou roteamento de arquivos sem reestruturar o fluxo principal.


Antes de começar

Lista de verificação

Arquivos de entrada usados neste passo a passo

Pré-visualização do documento PDF base usada como entrada PDF para a ação Criar Fatura ZUGFeRD

Arquivo PDF de entrada base.

Conteúdo do payload JSON da fatura mostrando os campos da fatura mapeados para a geração ZUGFeRD.

Entrada de dados JSON para fatura.


O fluxo em resumo (cinco etapas)

  1. Acionar um fluxo manualmenteExecutar sob demanda durante a configuração.
  2. Obtenha o arquivo PDF base (Dropbox): Lê os bytes do modelo PDF.
  3. Obter arquivo JSON (Dropbox): Lê bytes/conteúdo JSON da fatura.
  4. Criar fatura ZUGFeRD (PDF4me): Combina entradas usando o modo JSON.
  5. Criar arquivo (Dropbox): Armazena a saída gerada na pasta de destino.

Visão geral do fluxo

Fluxo do Power Automate: Acionar um fluxo manualmente, Obter arquivo PDF base, Obter arquivo JSON, Criar fatura ZUGFeRD, Criar arquivo

Cadeia de fluxo completa utilizada para este padrão de geração ZUGFeRD.


Passo 1: Obtenha o arquivo PDF base (Dropbox)

Fluxo até o momento: Gatilho → Obter arquivo PDF base.

  1. Adicionar Dropbox Ação para obter o conteúdo do arquivo pelo caminho.
  2. Definir Caminho do arquivo para o modelo PDF base (exemplo: /dados do blog/fatura zugferd/simplepdf.pdf).
  3. Nas opções avançadas, mantenha Inferir tipo de conteúdo = Sim.
  4. Salve e teste esta etapa; certifique-se de que ela retorne o conteúdo do arquivo/saída binária.
A ação "Obter arquivo PDF base" do Dropbox mostra o caminho do arquivo, os dados do blog, a fatura zugferd e o simplepdf.pdf, e a inferência do tipo de conteúdo é exibida. Sim.

Captura de tela da Etapa 1: caminho base do PDF e inferência de conteúdo configurados.


Etapa 2: Obtenha o arquivo JSON (Dropbox)

Fluxo até o momento: Gatilho → Obter PDF base → Obter arquivo JSON.

  1. Adicione outra ação de conteúdo de arquivo do Dropbox.
  2. Definir Caminho do arquivo aos seus dados de fatura em formato JSON (exemplo: /blog data/zugferd invoice/sample-invoice.json).
  3. Manter Inferir tipo de conteúdo = Sim.
  4. Salve e teste; confirme se o conteúdo JSON está disponível para mapeamento na etapa 3.
A ação "Obter arquivo JSON" do Dropbox mostra o caminho do arquivo, os dados do blog, a fatura de exemplo (sample-invoice.json) e a inferência do tipo de conteúdo. Sim.

Captura de tela da Etapa 2: Arquivo JSON de origem do Dropbox.


Etapa 3: Criar fatura ZUGFeRD (PDF4me)

Fluxo até o momento: Gatilho → Obter PDF base → Obter JSON → Criar ZUGFeRD.

Configurar PDF4me, Criar Fatura ZUGFeRD conforme mostrado:

  1. Nome do arquivo: nome do PDF de origem (exemplo: Teste.pdf).
  2. Conteúdo do arquivo PDF: mapa de Obtenha o arquivo PDF base.
  3. Nome do arquivo de saída: nome do arquivo de saída desejado (exemplo: Fatura Zugferd.pdf).
  4. Formato de entrada: definir para JSON.
  5. Modo de saída: definir para PDF com XML.
  6. Dados JSON da fatura: mapa de Obter arquivo JSON.
  7. Nível de conformidade: exemplo: BÁSICO.
  8. Versão ZUGFeRD: exemplo: 1.0 (ou a versão que você precisa).
  9. Gerar fatura em PDF: exemplo: Sim.
Ação Criar Fatura ZUGFeRD exibindo Nome do Arquivo, Conteúdo do Arquivo PDF, Nome do Arquivo de Saída, Formato de Entrada JSON, Modo de Saída PDF com XML, Dados JSON da Fatura, Conformidade BASIC, Versão ZUGFeRD 1.0, Renderizar Fatura em PDF Sim

Captura de tela da etapa 3: mapeamento completo de parâmetros para geração de ZUGFeRD baseado em JSON.


Passo 4: Criar arquivo (Dropbox)

Fluxo até o momento: Gatilho → Ler PDF + JSON → Gerar ZUGFeRD → Salvar arquivo.

  1. Adicionar Dropbox: Criar arquivo.
  2. Caminho da pasta: pasta de destino de saída (exemplo: /dados do blog/fatura zugferd/saída).
  3. Nome do arquivo: mapear o nome do arquivo de saída de Criar fatura ZUGFeRD.
  4. Conteúdo do arquivo: conteúdo do arquivo gerado pelo mapa a partir de Criar fatura ZUGFeRD.
  5. Salve e execute o fluxo completo.
Ação "Criar arquivo" do Dropbox com caminho da pasta, dados do blog, saída da fatura ZUGFeRD e nome e conteúdo do arquivo mapeados a partir da criação da fatura ZUGFeRD.

Captura de tela da etapa 4: gravação do arquivo de saída de volta para o Dropbox.


Verificação de saída

Exemplos de saída abertos
Saída visual em PDF da fatura ZUGFeRD gerada após a ação Criar Fatura ZUGFeRD

Geração de fatura em PDF.

O arquivo de saída foi aberto com o painel de anexos mostrando os dados XML incorporados no PDF da fatura ZUGFeRD gerada.

Visualização do anexo mostrando dados estruturados da fatura incorporados.


Referência rápida

#EtapaMapeamento de teclas
1Get Base PDF FileFile path to template PDF + Infer Content Type = Yes
2Get JSON FileFile path to invoice JSON + Infer Content Type = Yes
3Create ZUGFeRD InvoicePDF File Content from step 1, Input Format = JSON, Invoice JSON Data from step 2
4Create fileFile Name and File Content from Create ZUGFeRD Invoice output

Referências detalhadas de parâmetros: Criar fatura ZUGFeRD, Validar PDF.


Solução de problemas

A geração falha devido ao mapeamento de entrada.

Se Formato de entrada = JSON, apenas mapa Dados JSON da faturaLimpar os campos XML/CSV para esta execução.

Modo de saída incompatível

Com PDF com XML, ausente Conteúdo do arquivo PDF causa erros. Mapeia os bytes do arquivo a partir da etapa do PDF base.

401, 402 ou problemas de conexão

Ver Solução de problemas do PDF4me para verificação de chave de API, créditos e autorização de conectores.


O que experimentar a seguir

Endurecimento opcional: adicione um Doença Após a etapa 3, para verificar a presença da saída, o programa então direciona para as notificações de sucesso/falha antes da gravação final do arquivo.