Criar fatura suíça com QR Code no n8n: Dois fluxos de trabalho completos (com e sem um PDF existente)
Todas as faturas suíças devem conter um Nota QR suíça (também chamado de comprovante de pagamento QR suíço) para que bancos e softwares de contabilidade possam escanear e processar o pagamento automaticamente. O n8n e o PDF4me tornam essa geração totalmente automática. Este guia explica o processo. dois fluxos de trabalho prontos para produçãoUma opção é sobrepor o código QR a um PDF já existente no Dropbox, e a outra gera um documento de fatura com código QR independente a partir dos dados de pagamento, sem necessidade de um PDF de fundo. Ambas levam menos de 10 minutos para serem configuradas.
Fluxo de trabalho A: O gatilho é acionado. O download do Dropbox é recuperado. Testar Dívida AG.pdf (344 kB). O PDF4me Create SwissQR Bill funciona com Tipo de dados de entrada: Dados binários, Valor 1000, CHF, IBAN CH0200700110003765824Credor: Test AG. O resultado é swissqr_bill.pdf com 602 kB. O Upload para o Dropbox salva o resultado.
Fluxo de trabalho B: O gatilho é acionado. PDF4me Criar fatura SwissQR é executado com Tipo de dados de entrada: Nenhum, os mesmos campos de pagamento, além de um endereço completo e estruturado do credor. O resultado é n8n_swissqr02.pdf com 132 kB. O Upload para o Dropbox salva o resultado.
O Tipo de dados de entrada O campo no nó PDF4me é a única diferença estrutural entre os dois fluxos de trabalho. Defina-o como Dados binários Quando você já tiver um PDF (Fluxo de Trabalho A), defina-o como Nenhum Quando você deseja um comprovante QR independente a partir apenas dos dados de pagamento (Fluxo de Trabalho B). Todos os outros parâmetros, como valor, IBAN, moeda e nome do credor, são idênticos entre eles.
O que você está construindo?
Toda fatura suíça emitida após a migração de 2020 do antigo padrão de boleto bancário deve incluir uma Fatura QR Suíça: uma seção de pagamento padronizada com um código QR que codifica o IBAN, o valor, a moeda, o credor e, opcionalmente, os dados do devedor no formato ISO 20022. Bancos e softwares de contabilidade a escaneiam sem qualquer reinserção manual. Os dois fluxos de trabalho n8n neste guia automatizam essa etapa de geração, de modo que a Fatura QR seja produzida e salva no Dropbox sem intervenção manual.
À primeira vista
Fluxograma A: 4 etapas
Fluxo de trabalho A: quatro nós, Gatilho para Download para Criação de Fatura SwissQR (Dados Binários) para Upload.
Fluxo de trabalho B: 3 etapas
Fluxo de trabalho B: três nós, Gatilho para Criar Fatura SwissQR (Tipo de Dados de Entrada: Nenhum) para Carregar. Nenhuma etapa de download necessária.
Por que dois fluxos de trabalho separados?
O fluxo de trabalho A mantém intacto o seu modelo de fatura personalizado. O PDF4me adiciona o código QR suíço ao PDF que você já tem no Dropbox. Sem reformatação, sem redesign, sem trabalho manual de layout.
O fluxo de trabalho B ignora completamente a etapa de download. Basta fornecer os dados de pagamento e o PDF4me gera o comprovante de pagamento com QR Code completo do zero. Nenhum PDF base é necessário.
A única diferença estrutural é a Tipo de dados de entrada Campo: Dados binários para o fluxo de trabalho A, nenhum para o fluxo de trabalho B. O valor, o IBAN, a moeda e o nome do credor estão configurados da mesma forma em ambos.
Antes de começar
- n8n (na nuvem ou autohospedado). Crie um novo fluxo de trabalho em branco.
- Chave da API do PDF4meConfiguração inicial: Conecte o PDF4me ao n8n.
- Dropbox Credencial OAuth2 no n8n com acesso de leitura e gravação à sua pasta de trabalho.
- Fluxo de trabalho A apenas: Um PDF existente armazenado no Dropbox (por exemplo,
Testar Dívida AG.pdfem/Dados do Blog/SwissQR/). - Dados de pagamento: Um IBAN suíço válido (21 caracteres, começa com
CH), valor, moeda (CHF ou EUR), nome do credor e, para o Fluxo de Trabalho B, o endereço completo e estruturado do credor.
Fluxo de trabalho A: Criar fatura QR suíça em um PDF existente (4 nós)
Use esta opção quando já tiver uma fatura ou documento em formato PDF. O PDF4me sobrepõe o código QR da fatura suíça ao arquivo.
Passo 1: Baixe o PDF existente do Dropbox.
Fluxo até o momento: Acionar.
- Adicione o Dropbox nó.
- Credencial: API OAuth2 do Dropbox.
- Recurso: Arquivo. Operação: Download.
- Caminho do arquivo: caminho para o seu PDF no Dropbox, por exemplo.
Testar Dívida AG.pdf(neste exemplo, o arquivo reside em/Dados do Blog/SwissQR/). - Insira o arquivo de saída no campo:
dados. - Execute a etapa. O painel SAÍDA deverá mostrar o nome do arquivo (
Testar Dívida AG.pdf), diretório, tipo MIMEaplicação/pdfe tamanho do arquivo 344 kB.
Download do Dropbox configurado com caminho de arquivo Testar Dívida AG.pdf e insira o arquivo de saída no campo dadosO comando OUTPUT confirma que o arquivo foi baixado com 344 kB.
Passo 2: Crie a fatura SwissQR no PDF baixado.
Fluxo até o momento: Acione o gatilho e, em seguida, faça o download do PDF.
Esta é a etapa fundamental. O PDF4me lê o arquivo binário PDF baixado e gera um novo PDF com a fatura suíça com código QR anexada.
- Adicione o PDF4me nó.
- Credencial: Conta PDF4ME.
- Recurso: Fatura. Operações de faturamento: Criar fatura SwissQR.
- Tipo de dados de entrada: Dados binários (porque você está fornecendo o PDF do nó anterior).
- Propriedade binária:
dados(corresponde ao nome do campo da etapa de Download). - Nome do arquivo:
Testar Dívida AG.pdf(o nome do arquivo do documento de origem). - Preencha os campos de pagamento:
- Quantia:
1000 - Moeda: Franco suíço
- IBAN:
CH0200700110003765824 - Nome do credor:
Teste AG
- Quantia:
- Execute a etapa. O painel de SAÍDA mostra
swissqr_bill.pdf, tipo MIMEaplicação/pdf, tamanho do arquivo 602 kB (aumentou de 344 kB porque as páginas com o código QR foram incorporadas).
Criar fatura SwissQR com tipo de dados de entrada "Dados binários". A ENTRADA é um PDF de 344 kB do Dropbox. A SAÍDA é swissqr_bill.pdf com 602 kB. O aumento de tamanho confirma que o código QR foi incorporado.
Etapa 3: Envie o resultado para o Dropbox
Fluxo até o momento: Acione o gatilho, baixe o PDF e, em seguida, crie a fatura SwissQR.
- Adicione outro Dropbox nó.
- Credencial: API OAuth2 do Dropbox.
- Recurso: Arquivo. Operação: Carregar.
- Caminho do arquivo: caminho de destino no Dropbox, por exemplo.
/Dados do blog/SwissQR/swissqr_bill.pdf. - Arquivo binário: Sobre.
- Campo binário de entrada:
dados(a fatura SwissQR gerada na etapa anterior). - Executar. O Dropbox retorna os metadados de upload, confirmando o nome e o caminho do arquivo.
O fluxo de trabalho A está concluído. Seu PDF existente agora contém um código QR suíço para faturas e foi salvo novamente no Dropbox.
Fluxo de trabalho B: Criar uma fatura QR suíça independente (3 nós)
Use esta opção quando não tiver um PDF de fundo. O PDF4me gera todo o documento de comprovante de pagamento com QR Code a partir dos dados de pagamento que você insere diretamente no nó.
Passo 1: Criar fatura SwissQR sem PDF de fundo
Fluxo até o momento: Acionar.
Como não há um arquivo PDF de entrada, você precisa preencher o endereço completo do credor para que o PDF4me possa renderizar o layout completo da fatura QR suíça.
- Adicione o PDF4me nó.
- Credencial: Conta PDF4ME.
- Recurso: Fatura. Operações de faturamento: Criar fatura SwissQR.
- Tipo de dados de entrada: Nenhum (isso instrui o PDF4me a gerar um comprovante QR independente, sem PDF de fundo).
- Preencha os campos de pagamento:
- Quantia:
1000 - Moeda: Franco suíço
- IBAN:
CH0200700110003765824 - Nome do credor:
Teste AG - Tipo de endereço do credor: Estruturado
- Linha com o nome ou endereço do credor:
Test Strasse - Número do prédio do credor:
1 - Código postal do credor:
8000 - Cidade do credor:
Zurique
- Quantia:
- Execute a etapa. O painel de SAÍDA mostra
swissqr_bill.pdfcom 132 kB. Significativamente menor que o Fluxo de Trabalho A (602 kB) porque não há PDF de fundo, apenas o próprio código QR.
Criar fatura SwissQR com o tipo de dados de entrada "Nenhum". O endereço completo do credor é obrigatório, pois o PDF4me gera o layout do zero. O arquivo de saída tem 132 kB.
Etapa 2: Faça o upload da fatura QR independente para o Dropbox.
Fluxo até o momento: Acione e, em seguida, crie uma fatura SwissQR.
- Adicione o Dropbox nó.
- Credencial: API OAuth2 do Dropbox.
- Recurso: Arquivo. Operação: Carregar.
- Caminho do arquivo:
/n8n_swissqr02.pdf(ou qualquer caminho no seu Dropbox). - Arquivo binário: Sobre.
- Campo binário de entrada:
dados. - Executar. O painel de SAÍDA confirma o upload:
nome: n8n_swissqr02.pdf,path_display: /n8n_swissqr02.pdf,Tamanho: 132191, eis_downloadable: true.
O upload confirma: nome n8n_swissqr02.pdf, caminho /n8n_swissqr02.pdf, tamanho 132191 bytes, is_downloadable: true.
O fluxo de trabalho B está concluído. O PDF da fatura QR suíça independente está no Dropbox e pronto para ser enviado por e-mail ou anexado a qualquer documento de saída.
Qual fluxo de trabalho você deve escolher?
| Fluxo de trabalho A (com PDF existente) | Fluxo de trabalho B (autônomo) | |
|---|---|---|
| Nodes | 4 (trigger + download + QR + upload) | 3 (trigger + QR + upload) |
| Input Data Type | Binary Data | None |
| Requires existing PDF | Yes (in Dropbox or another source) | No |
| Output size (example) | 602 kB | 132 kB |
| Full creditor address required | No (name only shown in example) | Yes (Structured address required for layout) |
| Best for | Adding QR slip to finished invoices or letters | Sending a separate payment slip alongside any document |
Referência rápida: parâmetros principais
| Nó | Configuração de teclas | Valor de exemplo |
|---|---|---|
| Dropbox Download (A only) | File Path + Put Output File in Field | Test Debt AG.pdf; data |
| PDF4me Create SwissQR Bill (A) | Input Data Type + Binary Property + File Name | Binary Data; data; Test Debt AG.pdf |
| PDF4me Create SwissQR Bill (A and B) | Amount + Currency + IBAN + Creditor Name | 1000; Swiss Franc; CH0200700110003765824; Test AG |
| PDF4me Create SwissQR Bill (B only) | Input Data Type | None |
| PDF4me Create SwissQR Bill (B only) | Creditor Address Type + Street + Number + Postal Code + City | Structured; Test Strasse; 1; 8000; Zurich |
| Dropbox Upload (A) | File Path + Binary File + Input Binary Field | /Blog Data/SwissQR/swissqr_bill.pdf; On; data |
| Dropbox Upload (B) | File Path + Binary File + Input Binary Field | /n8n_swissqr02.pdf; On; data |
Casos de uso
Lote mensal de faturas: Extraia uma lista de PDFs de faturas do Dropbox e percorra-os em um loop. n8n Dividido em lotes No nó, execute o Fluxo de Trabalho A em cada um e salve os resultados em uma pasta separada. Uma única execução processa o mês inteiro.
Comprovantes de pagamento dinâmicos a partir de um banco de dados: Acione o fluxo de trabalho via webhook quando uma solicitação de pagamento for criada. Obtenha o valor, o IBAN e os dados do credor de um nó do Postgres ou Airtable. Use o Fluxo de Trabalho B para gerar o comprovante com código QR e enviá-lo automaticamente por e-mail via Gmail ou Outlook.
Contas de aluguel e de serviços públicos: Gere comprovantes QR independentes (Fluxo de Trabalho B) para aluguel, contas de serviços públicos ou taxas de associação mensalmente. Armazene-os no Dropbox e anexe-os aos e-mails enviados pelo n8n. Não é necessário nenhum PDF de fundo.
Hospedagem própria e local: Execute o n8n em sua própria infraestrutura. Os dados de pagamento nunca saem da sua rede, exceto pela chamada à API do PDF4me. Combine com compartilhamentos de arquivos locais ou NAS em vez do Dropbox.
Perguntas frequentes
Quando devo usar o Fluxo de Trabalho A em vez do Fluxo de Trabalho B?
Usar Fluxo de trabalho A Quando você já tiver um documento PDF finalizado (uma fatura, uma carta, qualquer arquivo) ao qual deseja adicionar um código QR suíço, o PDF4me anexa o código QR ao seu arquivo existente. Fluxo de trabalho B Quando você só tem os dados de pagamento (IBAN, valor, detalhes do credor) e deseja um comprovante de pagamento em PDF com QR Code independente, o Fluxo de Trabalho B gera o documento completo do zero, sem a necessidade de um PDF de base.
Qual o formato de IBAN exigido pela fatura QR suíça?
O IBAN deve ser válido. IBAN suíçoexatamente 21 caracteres, começando com CH, seguido por dois dígitos de verificação e o número da conta bancária de 17 dígitos. Exemplo: CH0200700110003765824O padrão QR suíço também suporta QR-IBANs (que começam com CH e usando o intervalo de 3000 a 3199 para o identificador bancário). Um IBAN inválido ou não suíço causa um erro de validação da API PDF4me antes que qualquer PDF seja gerado.
Por que o Fluxo de Trabalho B exige o endereço completo do credor, mas o Fluxo de Trabalho A não?
Ao usar o tipo de dados de entrada Dados binários (Fluxo de trabalho A), o PDF4me anexa o comprovante com código QR a um PDF existente e o layout tem contexto visual do documento original. O endereço do credor é opcional porque a seção do comprovante com código QR é anexada, e não gerada do zero. Quando você usa o Tipo de Dados de Entrada Nenhum (Fluxo de trabalho B), o PDF4me gera o layout completo do documento do zero. O padrão suíço de QR Code exige que uma fatura QR independente inclua o endereço completo do credor (rua, número do prédio, CEP, cidade) nos dados do QR Code, para que os sistemas de pagamento possam processá-la sem qualquer outro contexto do documento.
Posso usar dados de pagamento dinâmicos de um banco de dados ou formulário em vez de valores fixos?
Sim. No n8n, qualquer campo no nó PDF4me aceita expressões. Mapeie os campos Valor, IBAN, Nome do Credor e Cidade de um nó anterior, como uma consulta Postgres, um registro do Airtable, uma linha do Google Sheets, um envio de formulário via gatilho de formulário do n8n ou um payload de webhook. Cada execução gera uma fatura QR exclusiva para o item atual, sem qualquer edição manual do fluxo de trabalho. Esta é a abordagem recomendada para a automação de faturamento em produção.
O nó PDF4me retorna um erro. O que devo verificar primeiro?
Verifique três itens em ordem. Primeiro, confirme se sua chave de API está ativa em dev.pdf4me.com e sua conta possui créditos. SegundoPara o Fluxo de Trabalho B, verifique se todos os quatro campos de endereço do credor (Rua, Número do Prédio, CEP, Cidade) estão preenchidos quando o Tipo de Endereço do Credor for Estruturado. A ausência de qualquer um deles causa uma falha na validação. TerceiroPara o Fluxo de Trabalho A, confirme se a etapa de Download do Dropbox foi concluída com sucesso e se o nome da propriedade binária no nó PDF4me corresponde ao nome do campo definido no nó Download (ambos devem ser iguais). dados).
Solução de problemas
O nó de upload do Dropbox procura um campo chamado dados Por padrão. Se o nó Criar Fatura SwissQR usar um nome de campo binário de saída diferente, atualize o campo binário de entrada no nó Carregar para corresponder. Mantenha o mesmo nome de campo em todos os nós para evitar esse problema.
O IBAN deve ser um IBAN suíço válido que comece com CH (21 caracteres). Para o Fluxo de Trabalho B, todos os quatro campos de endereço do credor (Rua, Número do Prédio, CEP, Cidade) devem ser preenchidos quando o Tipo de Endereço do Credor for Estruturado. A ausência de qualquer um deles causa uma falha na validação.
Verifique novamente o caminho do arquivo no nó de download. Os caminhos do Dropbox diferenciam maiúsculas de minúsculas em algumas contas. Abra seu Dropbox e copie o caminho exato, incluindo os nomes das pastas e a extensão do arquivo. Se o arquivo estiver dentro de uma subpasta, o caminho deve incluir toda a hierarquia de pastas, por exemplo: /Dados do blog/SwissQR/Test Debt AG.pdf.
Ver Solução de problemas do PDF4me Para obter instruções sobre como verificar sua chave de API, consultar os créditos restantes e reconectar as credenciais no n8n.
O que experimentar a seguir
Opcional: troque o gatilho. Substitua o gatilho manual por um... Agendar Para faturamento mensal, um Webhook para disparar na criação da solicitação de pagamento, ou Dropbox com arquivo criado Processar automaticamente novos PDFs à medida que chegam.