Pular para o conteúdo principal
API PDF4meIntegraçõesBase de conhecimentoExtensõesTestador de APIBlog

PDFs de faturas QR suíças: renomeie por credor, valor ou referência no n8n!

· 11 min para ler
Sankalp Mishra
SEO and Content Writer

Você recebe PDFs, faturas, comprovantes de pagamento, cada um com um código QR suíço que indica quem está pagando, quanto e qual a referência. Você quer que esses arquivos sejam renomeados com esses dados para poder encontrá-los e organizá-los rapidamente. Fazer isso manualmente não é viável em larga escala.

A solução: um fluxo de trabalho n8n que downloads o PDF usa Leia o código QR suíço (PDF4me) para extrair esses dados de pagamento estruturados, fusões com o arquivo, e uploads Com um novo nome, por credor, valor, referência ou o que você precisar. Mesmo arquivo, nome de arquivo melhor, sem renomeação manual.

Este guia explica todo o processo: baixe o PDF, leia o código QR suíço, depois combine e carregue o arquivo com um nome baseado nos dados que você precisa, como nome e cidade do credor, valor e referência, ou dados do devedor.

O Fluxo em Resumo​

Seu fluxo de trabalho n8n para Renomeando PDFs por dados QR suíços Tem esta aparência:

  1. Acionar: Manual para testes ou automatizado (por exemplo, Dropbox, e-mail, webhook) quando um novo PDF estiver disponível.
  2. Baixar um arquivoObtém o PDF da sua fonte (por exemplo, Dropbox) e o gera como um arquivo binário em um campo como: document.
  3. Leia o código QR suíço (PDF4me): Extrai dados QR de faturas suíças do PDF e gera dados estruturados (swissQrData: credor cr_Name, cr_City, cr_Country, devedor ud_Name, Amount, Currency, Reference, etc.). O PDF original permanece no nó de Download.
  4. FusãoCombina a saída da função "Ler código QR suíço" (dados QR suíços) e a saída da função "Download" (PDF binário) em um único item, de forma que o próximo nó contenha tanto o novo nome do arquivo quanto o conteúdo do arquivo.
  5. Carregar um arquivoSalva o PDF com o caminho/nome do arquivo definido para os campos do código QR suíço que você escolher (por exemplo, Test AG_Zurich_Switzerland.pdf ou 1000_CHF_REF123.pdf).

O mesmo arquivo, nome diferente, sempre. Abaixo, detalhamos cada parte.

Visão geral do fluxo de trabalho n8n: Acionar → Baixar um arquivo → Ler o código QR suíço → Mesclar → Carregar um arquivo

Passo 1: Baixe o arquivo e leia o código QR suíço.​

Obtenha o PDF em n8n e extrair o valor de nomeação Com o PDF4me, leia o código QR suíço. O arquivo pode vir de Baixar um arquivo (por exemplo Dropbox), Google Drive, e-mail ou qualquer nó que produza saída binário.

Fluxo até o momento: Acionar → Baixar um arquivo → Ler o código QR suíço.

Importante: A leitura do código QR suíço retorna os dados de pagamento (em swissQrData): não passa pelo PDF. O conteúdo do arquivo permanece no nó de Download. Na Etapa 2, você mesclará ambos para que o nó de Upload contenha o arquivo e o novo nome.

  1. Adicionar um gatilhoManual para testes; para produção, utilize um gatilho automatizado (ex.: Dropbox, e-mail, Google Drive, webhook).
  2. Adicionar Download de um arquivo (ex.: Dropbox): Configurar Caminho do arquivo para o local do seu PDF (por exemplo, /Blog Data/Read Swiss QR.pdf) e Insira o arquivo de saída no campo para document Assim, o PDF estará disponível em formato binário para os próximos nós.
  3. Adicionar um nó PDF4me → Código de barras → Leia o código QR suíço.
  4. Configure o nó de leitura de código QR suíço:
  • Credencial para conectar-se com: Sua conta PDF4me.
  • Recurso: Código de barras → Operações com código de barras: Leia o código QR suíço.
  • Tipo de dados de entrada: Dados binários.
  • Campo binário de entrada: document (igual ao campo de saída do nó de Download).
  • Nome do arquivo de saída: Por exemplo swissqr_code_data.json.
  • Assíncrono: Ative esta opção para PDFs maiores, se necessário.
  1. Execute o nó. A saída inclui sucesso, nomeDoDocumento, e dados swissQr com credor (cr_Name, cr_City, cr_Country), devedor (ud_Name, etc.), Quantia, Moeda, Referência, IBANe muito mais. Você usará esses campos para o nome do arquivo na etapa de Upload.

Referência completa dos parâmetros: Leia o código QR suíço (n8n).

n8n Dropbox Baixar um nó de arquivo: caminho do arquivo e inserir a saída no campo documento
Nó n8n de leitura de código QR suíço: parâmetros e saída swissQrData

Etapa 2: Mesclar e carregar com o novo nome​

Você precisa de ambos PDF binário (do Download) e o Dados QR suíços (de Ler código QR suíço) em um único item para que o nó de upload possa salvar o arquivo com o novo nome. A Fusão O nó os combina; o Carregar O Node utiliza então os campos do QR Code suíço como caminho ou nome do arquivo.

  1. Adicionar um nó de mesclagem
  • Modo: Combinar.
  • Combinar por: Posição (primeiro item da Entrada 1 com o primeiro item da Entrada 2).
  • Número de entradas: 2.
  • Entrada 1: Conecte-se a partir de Leia o código QR suíço (fornece) swissQrData).
  • Entrada 2: Conecte-se a partir de Baixar um arquivo (fornece) binary.document).
  • Saída: Um item mesclado com o QR JSON suíço e binary.documentAssim, o próximo nó terá o novo nome do arquivo e o conteúdo do arquivo.
Nó de mesclagem n8n: combina JSON QR suíço e binário PDF.
  1. Adicionar um nó de upload (ex.: Dropbox) Carregar um arquivo, ou qualquer nó que aceite binário + caminho)
  • Caminho do arquivo (expressão): Use a saída "Ler código QR suíço". Você pode referenciar o nó pelo nome: $('Read SwissQR code').item.json.swissQrData.
  • Arquivo binário: SOBRE.
  • Campo binário de entrada: document.
  • O arquivo foi carregado com o nome derivado do QR Code suíço; o conteúdo do PDF permanece inalterado.

Use o nome do credor, a cidade e o país para o nome do arquivo (por exemplo, Test AG_Zurich_Switzerland.pdf):

/Blog Data/{{ $('Read SwissQR code').item.json.swissQrData.cr_Name }}_{{ $('Read SwissQR code').item.json.swissQrData.cr_City }}_{{ $('Read SwissQR code').item.json.swissQrData.cr_Country }}.pdf

Resolve-se em: /Blog Data/Test AG_Zurich_Switzerland.pdf

n8n Carregar um arquivo: nome de arquivo dinâmico a partir de dados de credores QR suíços

O mesmo padrão de mesclagem + upload funciona com o Google Drive, e-mail ou qualquer armazenamento que aceite arquivos binários e um caminho dinâmico. Dica: Para o Dropbox, habilite ler e escrever no Console de aplicativos do Dropbox (Permissões → Arquivos e pastas): por exemplo, leitura para Download, files.content.write Para fazer o upload, utilize um novo token de acesso após alterar as permissões.

Entendi: Se o Upload reportar binário ausente, certifique-se de realizar a mesclagem. Entrada 2 é de Baixar um arquivo, não do Read Swiss QR Code.

Por que isso funciona​

Pontos principais

  • AcionarUse um gatilho manual para testes ou um gatilho automatizado (Dropbox, e-mail, webhook) para que o fluxo de trabalho seja executado sempre que um novo PDF estiver disponível.
  • Leia o código QR suíço Extrai dados de notas QR suíças e gera resultados. dados swissQr (credor) cr_*, devedor fora_*, Quantia, Moeda, Referência, etc.). Ele não passa pelo PDF; o arquivo permanece no nó de Download.
  • Fusão (Combinar por posição) emparelha a saída do código QR suíço lido com a saída do download para que o próximo nó receba um item com ambos. documento binário e dados swissQr.
  • Carregar usa uma expressão como $('Ler código SwissQR').item.json.swissQrData.cr_Name (e cr_Cidade, cr_País, ou outros campos) para o caminho/nome do arquivo e documento binário para o conteúdo, portanto, cada arquivo é renomeado com dados QR suíços.

Cenários do mundo real​

Cenário 1: Faturas renomeadas pelo credor

Problema: PDFs de faturas recebidas com nomes genéricos; você precisa encontrá-las por fornecedor (credor) e localização.

Solução: Renomear pelo nome do credor, cidade e país (ex.: Test AG_Zurich_Switzerland.pdfCada arquivo pode ser pesquisado por quem enviou a fatura.

Campos de extração: cr_Name, cr_City, cr_Country Acionar: Pasta do Dropbox, anexo de e-mail ou webhook

Cenário 2: Comprovantes de pagamento por valor e referência

Problema: Os comprovantes de pagamento em PDF precisam ser arquivados por valor e referência de pagamento para fins de conciliação.

Solução: Renomeie por valor, moeda e referência (ex.: 1000_CHF_210000000003139471430009017.pdf). Conciliar documentos com transações bancárias.

Campos de extração: Amount, Currency, Reference Acionar: Dropbox, e-mail, webhook

Cenário 3: Pedido de falência baseado no devedor

Problema: Para fins contábeis, você precisa agrupar os PDFs por cliente (devedor final).

Solução: Renomear pelo nome do devedor (ex.: Test Debt AG.pdf) ou nome do devedor + cidade. Mapeamento direto para registros de clientes.

Campos de extração: ud_Name, ud_City Acionar: E-mail, pasta compartilhada, webhook

Perguntas frequentes rápidas​

  • E se nenhum código QR suíço for encontrado? Utilize um método alternativo na expressão do caminho do arquivo, por exemplo: {{ $('Read SwissQR code').item.json.swissQrData?.cr_Name || 'no-qr-found' }}Você pode adicionar uma ramificação condicional para ignorar o upload ou enviar esses arquivos para uma pasta separada.
  • Posso usar o credor e o valor juntos? Sim. Exemplo: {{ $('Read SwissQR code').item.json.swissQrData.cr_Name }}_{{ $('Read SwissQR code').item.json.swissQrData.Amount }}_{{ $('Read SwissQR code').item.json.swissQrData.Currency }}.pdf.
  • Posso usar isso para o Google Drive ou para e-mail? Sim. O padrão é o mesmo: use qualquer nó que forneça o arquivo em formato binário e qualquer nó de Upload (ou de salvamento) que aceite o formato binário mais um caminho dinâmico.

Próximos passos​

Recapitular: Gatilho → Baixar um arquivo → Ler código QR suíço → Mesclar → Carregar. O nome do arquivo é construído a partir de swissQrData (por exemplo, nome do credor, cidade, país ou valor/referência). Cada PDF é salvo com os dados QR suíços extraídos como nome.

  1. Obtenha sua chave de APIUse a mesma conta PDF4me para o n8n. Gratuito para começar.
  2. Construa seu fluxo n8n: Acionar → Baixar um arquivo → Ler o código QR suíço → Mesclar → Carregar com o Caminho do Arquivo definido para a expressão do código QR suíço que você precisa.
  3. Leia a documentação completa.: Leia o código QR suíço (n8n).
  4. Experimente a APITeste o endpoint de leitura de código QR suíço com seu próprio PDF no Testador de API.
Get Your API KeyRead Swiss QR Code in n8nTry SwissQR Code APIRename with Barcode