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

Word, QR Code suíço e um PDF base. O n8n os mescla em um só. Seis nós, pronto!

· 21 min para ler
Sankalp Mishra
SEO and Content Writer

Você tem um Arquivo do Word (por exemplo 3 páginas.docx) e um PDF base (por exemplo demo_5_page.pdf) no Dropbox, e você precisa de um Nota QR suíça mescladas por cima, de forma que o PDF final esteja pronto para envio. n8n e PDF4me Faça isso em um único fluxo de trabalho: Baixar um arquivo (Palavra), Converter para PDF, Criar fatura SwissQR com detalhes do credor e do devedor, Baixar arquivo PDF base, Mesclar dois arquivos PDF, um sobre o outro, como uma sobreposição., então Carregar um arquivo Para o Dropbox. Seis nós. Uma execução. Sem código.

Este guia utiliza capturas de tela autênticas e legendas descritivas para que você possa seguir cada etapa e reproduzir a configuração (caminhos, campos binários e parâmetros) em seu próprio fluxo de trabalho n8n.

Em resumo: Ao clicar em Executar fluxo de trabalho → Dropbox, Baixar um arquivo (/blog data/convert-swissqr-merge/3page.docx, saída no campo dados) → PDF4me, Converter para PDF (Propriedade Binária) dados, Nome do arquivo de saída output.pdf) → PDF4me, Crie uma fatura SwissQR (Valor 500, Moeda Franco Suíço, IBAN, credor Test AG, devedor Test Debt AG, Saída) swissqr_bill.pdf) → Dropbox, Baixar arquivo PDF base (/blog data/convert-swissqr-merge/demo_5_page.pdf, saída no campo base) → PDF4me, Mescle dois arquivos PDF, um sobre o outro, como uma sobreposição. (Base base, Camada dados, Saída overlayed_output.pdf) → Dropbox, Carregar um arquivo (/blog data/convert-swissqr-merge/output/Overlayed_Output.pdfResultado: um PDF consolidado com o conteúdo base e o comprovante de pagamento com QR Code suíço.

O que você receberá​

Entrada: Um arquivo do Word (por exemplo, 3 páginas.docx) e um PDF base (por exemplo, demo_5_page.pdf) no Dropbox, além dos dados de pagamento da fatura QR suíça (IBAN, valor, credor, devedor, tipo de referência, idioma). Saída: Um único PDF que combina o documento base com a fatura QR suíça gerada como uma sobreposição, salvo como Overlayed_Output.pdf em /blog data/convert-swissqr-merge/output/A fatura com QR Code exibe o recibo e o pagamento, o código QR escaneável, o credor (por exemplo, Test AG, 8001 Zurique), o devedor (por exemplo, Test Debt AG, 3000 Berna) e o valor (por exemplo, CHF 500,00).

Do que você precisa​

  • n8n, n8n Instância (nuvem ou auto-hospedada). Crie um novo fluxo de trabalho.
  • Credenciais PDF4me, Obtenha sua chave de APIAdicione uma conta PDF4me no n8n. Veja Conecte o PDF4me ao n8n.
  • DropboxCredencial: API OAuth2 do Dropbox. Operações: Download (arquivo por caminho) e Carregar (arquivo binário).
  • Arquivo do Word, por exemplo 3 páginas.docx no /blog data/convert-swissqr-merge/3page.docx. Baixado em um campo binário (por exemplo, dados) para Converter para PDF.
  • PDF base, por exemplo demo_5_page.pdf no /blog data/convert-swissqr-merge/demo_5_page.pdf. Baixado em um campo binário (por exemplo, base) para a mesclagem de sobreposição.
  • Dados da nota QR suíça, Valor (ex.: 500), Moeda (Franco Suíço), IBAN (ex.: CH0102030405060708090), Credor (Test AG, Test Strasse, House 2, 8001 Zurique), Devedor Final (Test Debt AG, Test Deb Strasse, House 8, 3000 Berna), Tipo de Referência (Sem Referência), Tipo de Idioma (Inglês). Opcional: Referência, Mensagem Não Estruturada, Informações de Cobrança, AV1/AV2, Perfis Personalizados.

Visão geral do fluxo de trabalho (6 nós)​

  1. AcionarAo clicar em Executar fluxo de trabalho (ou em um agendamento/webhook).
  2. Dropbox: Baixar um arquivoCaminho do arquivo: /blog data/convert-swissqr-merge/3page.docxInsira o arquivo de saída no campo: dados.
  3. PDF4me: Converter para PDFTipo de dados de entrada: Dados binários. Propriedade binária: dadosNome do arquivo de entrada: por exemplo. Teste.docxNome do arquivo de saída: output.pdfNome da saída de dados binários: dados.
  4. PDF4me: Criar fatura SwissQROperações de Fatura: Criar Fatura SwissQR. Tipo de Dados de Entrada: Dados Binários. Propriedade Binária: dadosNome do arquivo: Teste.pdfCampos: Valor, Moeda, IBAN, Credor e Devedor Final. Nome do arquivo de saída: swissqr_bill.pdfNome do campo binário de saída: dados.
  5. Dropbox: Baixar arquivo PDF baseCaminho do arquivo: /blog data/convert-swissqr-merge/demo_5_page.pdfInsira o arquivo de saída no campo: base.
  6. PDF4me: Mescle dois arquivos PDF, um sobre o outro, como uma sobreposição.Campo binário do PDF base: base. Campo binário PDF da camada: dadosNome do arquivo de saída: overlayed_output.pdfNome da saída de dados binários: dados.
  7. Dropbox: Carregar um arquivoCaminho do arquivo: /blog data/convert-swissqr-merge/output/Overlayed_Output.pdfArquivo binário: ativado. Campo de entrada binária: dados.

Visão geral completa do fluxo de trabalho​

Fluxo de trabalho n8n: Ao clicar em Executar fluxo de trabalho, faça o download de um arquivo (Dropbox), converta para PDF (PDF4me), crie uma fatura SwissQR (PDF4me), baixe o arquivo PDF base (Dropbox), mescle dois arquivos PDF sobrepostos (PDF4me) e carregue um arquivo (Dropbox). Todas as etapas estão marcadas com um visto verde.

Seis nós mais gatilho: Baixar arquivo (Word), Converter para PDF, Criar fatura SwissQR, Baixar arquivo PDF base, Mesclar sobreposição, Carregar arquivo. Cada nó exibe 1 item e o status de sucesso.

Passo 1: Baixe um arquivo (Dropbox)​

Fluxo de trabalho até o momento: Gatilho e um nó do Dropbox.

  1. Adicionar Acionar → Ao clicar em Executar fluxo de trabalho (ou outro gatilho).
  2. Adicionar Dropbox → Baixar um arquivo (ou nó equivalente que faça download por caminho).
  3. CredencialAPI OAuth2 do Dropbox.
  4. Recurso: Arquivo. Operação: Download.
  5. Caminho do arquivo: /blog data/convert-swissqr-merge/3page.docx.
  6. Insira o arquivo de saída no campo: dados (assim, o próximo nó pode usar o binário na propriedade) dados).
  7. Execute a etapa. A saída mostra 3 páginas.docxdiretório /dados do blog/converter-merge-swissqr, Tipo MIME para Word, tamanho do arquivo.

Baixar um arquivo: Parâmetros​

Baixar um arquivo no Dropbox: guia Parâmetros, Credencial da API OAuth2 do Dropbox, Arquivo de recurso, Operação de download, Caminho do arquivo /blog data/convert-swissqr-merge/3page.docx, Inserir arquivo de saída no campo de dados

O Dropbox está configurado para download com o caminho do arquivo /blog data/convert-swissqr-merge/3page.docx e a opção "Inserir arquivo de saída" no campo "dados". O painel de SAÍDA exibe o arquivo 3page.docx e os detalhes do arquivo binário.

Passo 2: Converter para PDF (PDF4me)​

Fluxo de trabalho até o momento: Acionar → Baixar arquivo → Converter para PDF.

  1. Adicionar PDF4me nó. RecursoConverter. Operações de conversãoConverter para PDF.
  2. CredencialConta PDF4ME.
  3. Tipo de dados de entradaDados binários.
  4. Propriedade binária: dados (do nó anterior).
  5. Nome do arquivo de entrada: por exemplo Teste.docx.
  6. Nome do arquivo de saída: output.pdf. Nome da saída de dados binários: dados.
  7. Execute a etapa. A SAÍDA mostra output.pdf, application/pdf, tamanho do arquivo (ex.: 34,4 kB). Este binário é passado para a função Criar fatura SwissQR.

Converter para PDF: Parâmetros e saída​

n8n PDF4me Converter para PDF: ENTRADA 3page.docx de Baixar um arquivo, Parâmetros Credenciais da conta PDF4ME, Recurso Converter, Converter para PDF, Propriedade binária dados, Nome do arquivo de entrada Test.docx, Nome do arquivo de saída output.pdf, SAÍDA output.pdf

Converter para PDF com dados de propriedade binária, nome do arquivo de entrada Test.docx, nome do arquivo de saída output.pdf. Os dados binários de saída no campo são usados pelo nó Criar fatura SwissQR.

Passo 3: Criar fatura SwissQR (PDF4me)​

Fluxo de trabalho até o momento: Acionar → Baixar → Converter para PDF → Criar fatura SwissQR.

  1. Adicionar PDF4me nó. Recurso: Fatura. Operações de FaturamentoCriar fatura SwissQR.
  2. CredencialConta PDF4ME.
  3. Tipo de dados de entradaDados binários. Propriedade binária: dados (de Converter para PDF). Nome do arquivo: Teste.pdf.
  4. Quantia: 500. MoedaFranco suíço. IBAN: por exemplo CH0102030405060708090.
  5. Credor: Nome do credor Teste AG, Tipo de endereço do credor Estruturado, Endereço do Credor Linha 1 Test Strasse, Endereço do Credor Linha 2 Casa 2, Código Postal do Credor 8001Cidade Credora Zurique.
  6. Devedor final: Nome do Devedor Final Dívida de teste AG, Tipo de endereço do devedor final Estruturado, Endereço do Devedor Final, Linha 1 Teste Deb Strasse, Endereço do Devedor Final, Linha 2 Casa 8, Código Postal do Devedor Final 3000, Cidade dos Devedores Definitiva Bern.
  7. Tipo de referênciaSem referência. Tipo de idioma: Inglês. Linha Separadora: Linha com tesoura (ou LinhaComTesoura).
  8. Nome do arquivo de saída: swissqr_bill.pdf. Nome do campo binário de saída: dados.
  9. Opções avançadas (opcional): Referência, Mensagem não estruturada (ex.: Obrigado pela sua preferência), Informações de faturamento (ex.: Fatura pelos serviços prestados), AV1/AV2, Perfis personalizados (ex.: { 'outputDataFormat': 'base64' }).
  10. Execute a etapa. A SAÍDA mostra swissqr_bill.pdf em campo binário dados (Esta será a camada na mesclagem).

Criar fatura SwissQR: Operações de fatura e pagamento​

Criar fatura SwissQR no n8n PDF4me: Credenciais da conta PDF4ME, Recurso: Fatura, Operações da fatura: Criar fatura SwissQR, Tipo de dados de entrada: Dados binários, Propriedade: dados binários, Nome do arquivo: Test.pdf, Valor: 500, Moeda: Franco suíço, IBAN: CH0102030405060708090, Nome do credor: Test AG, Tipo de endereço do credor: Estruturado, Endereço do credor (linha 1): Test Strasse

Criar nó de fatura SwissQR com conta PDF4ME (Credenciais), Operações de Fatura: Criar Fatura SwissQR, Dados de Propriedade Binária, Valor: 500, Moeda: Franco Suíço, IBAN e Credor: Test AG com endereço estruturado.

Criar fatura SwissQR: Devedor e referência​

Parâmetros para criação de fatura SwissQR: Endereço do Credor (Linha 2): Casa 2, CEP do Credor: 8001, Cidade do Credor: Zurique, Nome do Devedor Final: Test Debt AG, Tipo de Endereço do Devedor Final: Estruturado, Endereço (Linha 1): Test Deb Strasse, Endereço (Linha 2): Casa 8, CEP: 3000, Cidade: Berna, Tipo de Referência: Sem Referência, Idioma: Inglês

Campos de endereço do credor e do devedor final: Test AG Zurich 8001, Test Debt AG Bern 3000, Tipo de referência: Sem referência, Tipo de idioma: Inglês.

Criar fatura SwissQR: opções de saída e avançadas​

Criar fatura SwissQR: Tipo de idioma: Inglês, Linha separadora: Linha tracejada, Nome do arquivo de saída: swissqr_bill.pdf, Nome do campo binário de saída: data, Opções avançadas: Referência: Mensagem não estruturada, Informações de faturamento: AV1, AV2, Perfis personalizados: outputDataFormat: base64

Nome do arquivo de saída: swissqr_bill.pdf, Nome do campo binário de saída: data. Opções avançadas: Referência, Mensagem não estruturada, Informações de faturamento, AV1/AV2, Perfis personalizados.

Passo 4: Baixe o arquivo PDF base (Dropbox)​

Fluxo de trabalho até o momento: Acionar → Baixar Word → Converter para PDF → Criar fatura SwissQR → Baixar PDF base.

  1. Adicionar Dropbox → Baixar arquivo PDF base (ou o nó que baixa um arquivo pelo caminho e o coloca em um campo nomeado).
  2. CredencialAPI OAuth2 do Dropbox. Recurso: Arquivo. Operação: Download.
  3. Caminho do arquivo: /blog data/convert-swissqr-merge/demo_5_page.pdf.
  4. Insira o arquivo de saída no campo: base (portanto, o nó de mesclagem tem base e camada em campos separados).
  5. Execute a etapa. A saída mostra demo_5_page.pdf em campo base.

Baixe o arquivo PDF base: Parâmetros​

Baixar arquivo PDF base do Dropbox: Credenciais da API OAuth2 do Dropbox, Arquivo de recurso, Operação de download, Caminho do arquivo /blog data/convert-swissqr-merge/demo_5_page.pdf, Inserir arquivo de saída no campo base

Baixe o arquivo PDF base com o caminho /blog data/convert-swissqr-merge/demo_5_page.pdf e insira o arquivo de saída no campo "base". Este PDF será usado como camada base na sobreposição de mesclagem.

Passo 5: Mesclar dois arquivos PDF, um sobre o outro, como sobreposição (PDF4me)​

Fluxo de trabalho até o momento: Todos os nós até a junção.

  1. Adicionar PDF4me nó. RecursoMesclar e dividir. Operações de Fusão e CisãoMesclar dois arquivos PDF, um sobre o outro, como uma sobreposição.
  2. CredencialConta PDF4ME.
  3. Tipo de entrada PDF básicoDados binários. Tipo de entrada PDF em camadasDados binários.
  4. Campo binário do PDF base: base (Do arquivo PDF base para download). Campo binário PDF da camada: dados (da fatura Create SwissQR).
  5. Nome do arquivo de saída: overlayed_output.pdf. Nome da saída de dados binários: dados.
  6. Execute a etapa. A SAÍDA mostra overlayed_output.pdf (por exemplo, 144 kB) em campo binário dadosEste é o PDF consolidado (camada base + código QR suíço).

Mesclar dois arquivos PDF, um sobre o outro, como uma sobreposição.​

n8n PDF4me Mesclar dois arquivos PDF, um sobre o outro, como uma sobreposição: ENTRADA base demo_5_page.pdf e dados swissqr_bill.pdf, Parâmetros Campo Binário do PDF Base base, Camada Campo Binário do PDF data, Nome do Arquivo de Saída overlayed_output.pdf, SAÍDA dados overlayed_output.pdf

Mesclar sobreposição com o campo binário do PDF base (demo_5_page.pdf) e os dados do campo binário do PDF da camada (swissqr_bill.pdf). Gerar o arquivo overlayed_output.pdf nos dados do campo para o nó de upload.

Etapa 6: Carregar um arquivo (Dropbox)​

Fluxo de trabalho até o momento: Todos os seis nós; o nó final salva o PDF mesclado.

  1. Adicionar Dropbox → Carregar um arquivo (ou equivalente que carregue arquivos binários em um caminho).
  2. CredencialAPI OAuth2 do Dropbox. Recurso: Arquivo. Operação: Carregar.
  3. Caminho do arquivo: /blog data/convert-swissqr-merge/output/Overlayed_Output.pdf.
  4. Arquivo binário: Sobre. Campo binário de entrada: dados (do nó de mesclagem).
  5. Execute a etapa. O JSON de saída mostra nome: Overlayed_Output.pdf, exibição_do_caminho, tamanhoe metadados de sucesso.
  6. O PDF consolidado agora está no Dropbox, no caminho indicado.

Carregar um arquivo: Parâmetros e saída​

n8n Dropbox Carregar um arquivo: ENTRADA Mesclar dois arquivos PDF, um sobreposto a overlayed_output.pdf 144 kB, Parâmetros Credencial Dropbox OAuth2 API, Recurso Arquivo, Operação Carregar, Caminho do Arquivo /blog data/convert-swissqr-merge/output/Overlayed_Output.pdf, Arquivo Binário ativado, Campo de Entrada Binário data, SAÍDA Nome JSON Overlayed_Output.pdf path_display tamanho

Faça o upload de um arquivo com o caminho /blog data/convert-swissqr-merge/output/Overlayed_Output.pdf, selecione "Arquivo Binário" e escolha "Dados do Campo Binário de Entrada". A saída confirmará o nome, o caminho (path_display) e o tamanho do arquivo enviado.

Resultado: PDF mesclado com a fatura QR suíça​

O fluxo de trabalho produz um único PDF que combina o documento base (por exemplo, demo_5_page.pdf) com a fatura QR suíça gerada como sobreposição. A fatura QR mostra a parte do Recibo e do Pagamento, o código QR escaneável, a Conta/Pagável a (por exemplo, CH01 0203 0405 0607 0809 0, Test AG, Test Strasse House 2, 8001 Zurique), Pagável por (por exemplo, Test Debt AG, Test Deb Strasse House 8, 3000 Berna) e o Valor em Moeda CHF 500,00. O arquivo é salvo como Overlayed_Output.pdf em /blog data/convert-swissqr-merge/output/.

Fatura suíça gerada por QR Code: Recibo e parte de pagamento com código QR, Conta a pagar à Test AG 8001 Zurique, Pagável por Test Debt AG 3000 Berna, Valor em moeda estrangeira: CHF 500,00, Ponto de aceitação

Documento final consolidado com layout de fatura QR suíça: Recibo, parte do pagamento com código QR, dados do credor e do devedor e valor em CHF. Pronto para distribuição ou impressão.

Casos de uso​

Faturas e orçamentos: Utilize uma fatura em Word ou PDF como base; adicione um código QR suíço compatível como sobreposição para que cada PDF seja legível por humanos e escaneável por máquinas para pagamento.

Comprovantes de pagamento em lote: Acione o fluxo de trabalho a partir de um webhook ou agendamento; passe diferentes valores e dados do devedor (por exemplo, de um banco de dados ou planilha) para o nó Criar fatura SwissQR para gerar um PDF consolidado por execução.

Automação auto-hospedada: Execute o n8n em sua própria infraestrutura e mantenha o controle dos dados de documentos e pagamentos, utilizando o PDF4me para conversão e geração de faturas por QR Code.

Referência rápida​

NóConfiguração de teclasExemplo
Dropbox Baixar um arquivoCaminho do arquivo, Insira o arquivo de saída no campo/blog data/convert-swissqr-merge/3page.docx; dados
PDF4me Converter para PDFPropriedade binária, nome do arquivo de saída, nome da saída de dados bináriosdados; output.pdf; dados
PDF4me Criar fatura SwissQRPropriedade binária, Valor, Moeda, IBAN, Credor/Devedor, Nome do arquivo de saídadados; 500; Franco suíço; CH01...; Test AG / Test Debt AG; swissqr_bill.pdf
Download do arquivo PDF base do DropboxCaminho do arquivo, Insira o arquivo de saída no campo/blog data/convert-swissqr-merge/demo_5_page.pdf; base
Sobreposição de mesclagem do PDF4meCampo binário do PDF base, Campo binário do PDF da camada, Nome do arquivo de saídabase; dados; overlayed_output.pdf
Dropbox Carregar um arquivoCaminho do arquivo, Arquivo binário, Campo de entrada binária/blog data/convert-swissqr-merge/output/Overlayed_Output.pdf; sobre; dados

Para obter detalhes completos sobre os parâmetros, consulte Criar nota QR suíça, n8n e Mesclar dois arquivos PDF, um sobre o outro, como sobreposição. (ou o nó de mesclagem equivalente na documentação do n8n). Para o mesmo fluxo no Power Automate, consulte Fusão de QR suíço (Power Automate).

Solução de problemas​

Campo binário incorreto na sobreposição de mesclagem

O campo binário do PDF base deve apontar para o nó que gera o PDF base (Baixar arquivo PDF base → baseO campo binário PDF da camada deve apontar para a saída da fatura Swiss QR (Criar fatura SwissQR → dadosCertifique-se de que os nós anteriores foram executados com sucesso e que os nomes dos campos correspondem.

Erros de validação de notas QR suíças

Verifique o formato do IBAN (IBAN suíço), o valor e a moeda, e certifique-se de que os campos de endereço do credor e do devedor utilizem o Tipo de Endereço correto (Estruturado). O Tipo de Referência e a Referência opcional devem seguir os padrões suíços quando utilizados.

Erros de API ou de conexão

Ver Solução de problemas do PDF4me Para chave de API, créditos e conectividade.

O que vem a seguir?​

  1. Execute o fluxo de trabalhoExecutar e confirmar Overlayed_Output.pdf aparece em /blog data/convert-swissqr-merge/output/ Com conteúdo básico e QR Code da fatura suíça visíveis.
  2. AutomatizarSubstitua o gatilho manual por Agendar ou Webhook e transmitir caminhos de arquivos ou dados de pagamento de outro sistema.
  3. Dados dinâmicosUtilize expressões para definir o valor, IBAN, credor e devedor a partir de um nó anterior (por exemplo, banco de dados ou CSV) para execuções em lote.
  4. O mesmo fluxo em outros lugares: Usar Fusão de QR suíço no Power Automate Para a mesma lógica nos fluxos da Microsoft.
n8nGet API KeyCreate Swiss QR Bill (n8n docs)Swiss QR merge (Power Automate)