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

Este guia constrói um n8n fluxo de trabalho que utiliza dados de faturas como JSON, cria um ZUGFeRD/Factur‑X fatura com PDF4mee carrega o PDF final para Dropbox.

Você irá conectar três componentes principais:

1. Inserir o JSON da fatura no PDF4me (para obter um URL de documento estável),
2. Gere a fatura ZUGFeRD a partir dessa entrada,
3. Faça o upload do PDF resultante para o Dropbox como um arquivo binário.

O que você vai receber!​

Entrada: Dados JSON da fatura. Saída: Um PDF gerado pelo ZUGFeRD/Factur‑X (PDF com XML de fatura incorporado) carregado em um caminho do Dropbox, como por exemplo: /blog data/zugferd invoice/output/Zugferd_Result.pdf.

---

Em resumo: as etapas do fluxo de trabalho​

---

Antes de começar (lista de verificação!)​

---

Visão geral do fluxo de trabalho​

Quatro nós em sequência: acionar → enviar JSON → gerar fatura ZUGFeRD → enviar PDF para o Dropbox.

---

Etapa 1: Acionar (Executar fluxo de trabalho)​

Fluxo de trabalho até o momento: apenas o gatilho.

1. Crie um novo fluxo de trabalho no n8n.
2. Usar Ao clicar em “Executar fluxo de trabalho” enquanto você constrói a primeira versão.
3. Posteriormente, quando o fluxo de trabalho estiver estável, substitua isso por um Cron, Webhook ou um gatilho de "novo arquivo".

---

Etapa 2: Carregue o arquivo JSON no PDF4me​

Esta etapa transforma seu JSON em um documento hospedado no PDF4me, para que você possa passar um URL do documento para o nó de geração de faturas.

1. Adicionar PDF4me nó.
2. Recurso: PDF4me.
3. Operação: Enviar arquivo para PDF4me.
4. Tipo de dados de entradaEscolha o mesmo tipo que você está fornecendo (a captura de tela usa uma string base64).
5. Definir Horário de retenção de arquivos para o período de sua preferência (exemplo mostrado: 2 horas).
6. Execute o nó uma vez e confirme se ele gera uma URL/token utilizável que você possa referenciar no próximo nó.

Captura de tela da Etapa 2: faça o upload do JSON para que o PDF4me retorne um URL de documento para a próxima etapa.

---

Passo 3: Criar fatura Zugferd (PDF4me)​

Esta é a etapa principal de geração. Ela usa a URL JSON enviada como entrada e retorna um PDF binário (salvo em um campo binário como este). dados).

Configurações principais para corresponder​

1. Recurso: Fatura.
2. OperaçãoCriar fatura Zugferd.
3. Tipo de dados de entrada: String Base64 (corresponde ao exemplo executado).
4. Modo de saídaXML com PDF (PDF híbrido).
5. Nível de conformidade: BÁSICO (comece aqui, a menos que seu receptor exija mais).
6. Versão Zugferd: 1.0 (use a versão que seu receptor espera).
7. LinguagemInglês (ou o idioma de sua preferência).

Captura de tela da etapa 3 (parte 1): configurações de operação de faturamento e opções de perfil/versão principal.

Mapeamento JSON (entrada de URL)​

1. Formato de entrada: JSON.
2. Tipo de entrada de dados da faturaURL.
3. URL dos dados da fatura: mapear a URL de saída da Etapa 2 (o documento JSON carregado).
4. Nome do arquivo de saída: definir um nome de saída previsível (exemplo: zugferd_invoice.pdf).
5. Nome do campo binário de saída: dados (mantenha a consistência com o upload do Dropbox).

Captura de tela da etapa 3 (parte 2): Mapeamento JSON + URL e nome do campo de saída binária.

---

Passo 4: Carregar um arquivo (Dropbox)​

Isso publica o PDF gerado no Dropbox.

1. Adicionar Dropbox nó.
2. Recurso: Arquivo. Operação: Carregar.
3. Caminho do arquivo: defina o caminho completo de destino, incluindo o nome do arquivo (exemplo: /blog data/zugferd invoice/output/Zugferd_Result.pdf).
4. Arquivo binário: Sobre.
5. Campo binário de entrada: dados (a partir da Etapa 3).
6. Execute o nó e confirme se o Dropbox retorna metadados (caminho, ID, etc.).

Captura de tela da etapa 4: O upload para o Dropbox publica o PDF da fatura gerada.

---

Referência rápida​

Leitura complementar: Criar fatura ZUGFeRD (documentos), Versão do Power Automate, Validar o fluxo de trabalho PDFA.

---

Solução de problemas!​