Pular para o conteúdo principal

Adicionar uma fatura com QR Code suíço a qualquer PDF de fatura no Zapier: um fluxo de trabalho de 4 etapas no Dropbox

· 22 min para ler
SEO and Content Writer

Todas as faturas suíças devem conter um Nota QR suíça Assim, bancos e softwares de contabilidade podem digitalizar e processar o pagamento automaticamente. Com o Zapier e o PDF4me, essa adição é ainda mais fácil. Zap de quatro etapasDropbox Novo arquivo na pastaDropbox Localizar arquivo, PDF4me Criar nota QR suíçaDropbox Carregar arquivoAs capturas de tela abaixo mostram exatamente o que foi exibido na tela: uma fatura de 10 páginas em /pdf4metest/Swiss-RP torna-se uma fatura em conformidade com as normas suíças, com o comprovante de pagamento anexado e salvo em /pdf4meoutputPronto para produção em menos de 10 minutos.

O Zap em resumo
1. Dropbox New File in Folder
Watches /pdf4metest/Swiss-RP every 2 minutes. Trigger fires when a new invoice PDF lands.
2. Dropbox Find File
Resolves the file by name (10 page.pdf) and pulls the binary, ready for the next step.
3. PDF4me Create Swiss QR Bill
Appends the QR payment slip with all required SPS fields: CHF, QRR reference, English, Line with Scissor separator.
4. Dropbox Upload File
Writes the populated PDF to /pdf4meoutput. File Name and File Extension carried from the PDF4me output.
A versão curta

Quatro passos Zap. Dropbox Novo arquivo na pasta relógios /pdf4metest/Swiss-RP (Espaço padrão, Incluir arquivos em subpastas) FalsoInclua o conteúdo do arquivo e o link de compartilhamento. SimDropbox Localizar arquivo olha para cima 10 páginas.pdf em /pdf4metest/Arquivos e retorna o binário. PDF4me Criar nota QR suíça Anexa uma página de fatura QR compatível com os padrões de pagamento suíços (Tipo de formato) PDFOpções de paginação primeiro, Moeda CHF, Tipo de referência QRR, Linguagem Inglês, Separador Linha com tesoura, Quantia 1923,67IBAN CH4431999123000889012Credor: Var Schneider AG, Devedor final: Pia-Maria Rutschmann-Schnyder, Referência 210000000003139471430009017Dropbox Carregar arquivo grava o PDF preenchido em /pdf4meoutput usando 3. URL do arquivo, com 3. Nome do arquivo e 3. Extensão do arquivo como nome de saída. O resultado é um PDF digitalizável por bancos suíços na pasta de arquivos.

Dois fatores que determinam se o seu documento pode ser escaneado pelo banco.

Primeiro, o O IBAN deve começar com CH ou LI. e ter no máximo 21 caracteres. Para um tipo de referência QRR, o IBAN deve ser um QR-IBAN, não um IBAN padrão. Segundo, quando O tipo de referência é QRR., o O campo de referência é uma sequência numérica de 27 dígitos com um dígito verificador módulo 10.; se você não tiver um, altere o Tipo de Referência para PONTUAÇÃO (ISO 11649) ou NÃO e deixe a Referência em branco. Os bancos rejeitam valores de referência digitados incorretamente, não a imagem do QR Code.

Isso resolve alguns problemas comuns do mundo real.

As pessoas pesquisam exatamente esse problema com frases como:

  • "Como adiciono automaticamente um código QR suíço à minha fatura em PDF no Zapier?" Este Zap de 4 etapas faz tudo: o arquivo é enviado para o Dropbox, o Zap é executado e o PDF com o código QR da fatura é salvo na pasta de saída.
  • "O Zapier consegue gerar uma fatura QR suíça a partir de uma fatura existente?" Sim, através da ação "Criar Fatura QR Suíça" do PDF4me. O resultado é o mesmo PDF com o comprovante de pagamento anexado na página que você escolher (primeira, última ou específica).
  • "Preciso de uma biblioteca de códigos QR ou de uma assinatura do gerador de QR suíço?" Não. A ação PDF4me oculta a geração de QR Code, os cálculos de referência módulo 10 e todo o layout dos Padrões de Pagamento Suíços por trás de uma única etapa do Zapier.
  • "E se eu não tiver um PDF de origem, posso gerar um comprovante com código QR independente?" Sim. Ignore a Etapa 2 (Localizar Arquivo) e os campos Arquivo/URL do Arquivo na Etapa 3. A ação retorna um PDF da fatura QR suíça independente, a partir dos dados de pagamento.
  • "Será que os bancos suíços aceitarão essa saída?" A ação gera um comprovante em conformidade com a norma suíça ISO 20022 para pagamentos. Todos os aplicativos de mobile banking dos bancos suíços podem escaneá-lo para iniciar o pagamento.

O que você está construindo?

Um Zap reutilizável de 4 etapas para o Zapier. O gatilho monitora uma pasta do Dropbox, o Zap encontra a fatura mais recente, executa a ação PDF4me Swiss QR Bill com os detalhes do credor, devedor e pagamento, e carrega o PDF otimizado para uma pasta de saída. O mesmo padrão funciona para faturas de clientes, execuções em lote agendadas ou processamento de contas a receber totalmente orientado a eventos.

Tela do Zapier Zap com quatro etapas: Adicionar novo arquivo à pasta do Dropbox (intervalo de 2 minutos), Localizar arquivo no Dropbox, Criar fatura SwissQR com PDF4me, Carregar arquivo no Dropbox. O banner de status mostra "Concluído com sucesso em 01/06/2026 às 13:00:20" com o ID da execução.

Quatro etapas de cima para baixo. O intervalo de 2 minutos na Etapa 1 é a frequência de consulta padrão do Zapier para gatilhos do Dropbox; planos pagos permitem consultas mais frequentes.


Do que você precisa

  • Zapier conta. Crie uma conta no Zapier Se você precisar de um.
  • Chave da API PDF4me. Obtenha sua chave de API e adicione-o quando o PDF4me solicitar uma conta no editor Zap. Veja Conecte o PDF4me ao Zapier.
  • Dropbox com uma pasta de origem (por exemplo, /pdf4metest/Swiss-RP) e uma pasta de saída (/pdf4meoutput).
  • Uma fatura em PDF (as capturas de tela usam 10 páginas.pdfOpcional: omita o arquivo de origem para gerar um comprovante QR independente apenas com os dados de pagamento.
  • dados de pagamento suíços: a CH ou LI IBAN, valor, moeda (CHF ou EUR), e blocos de nome/endereço do credor e do devedor. Referência completa do campo no documentos de ação.

Referência rápida: parâmetros principais

IBAN
CH or LI prefix, max 21 chars. QR-IBAN required for QRR references.
Currency
CHF or EUR only. Other currencies rejected by Swiss Payment Standards.
Reference Type
QRR (27-digit + mod-10), SCOR (ISO 11649), or NON. Pick once, fill Reference accordingly.
Address Type
S = structured (separate Postal Code + City). K = combined (full address in two Address Lines).
paging Options
first, last, append, or a specific 1-based page number.
Format Type
PDF for printable invoices, PNG/JPEG/TIFF for image output.

Construa o Zap

Passo 1: Dropbox - Novo arquivo na pasta (gatilho)

Verifique a pasta de origem para novas faturas.

CampoValor usado nesta execução.
SpaceDefault
Folder/pdf4metest/Swiss-RP
Include files in subfolders?False
Include file contents?Yes
Include sharing link?Yes
Gatilho Zapier Dropbox Novo Arquivo na Pasta: Espaço Padrão, Pasta /pdf4metest/Swiss-RP, Incluir arquivos em subpastas: Não, Incluir conteúdo do arquivo: Sim, Incluir link de compartilhamento: Sim.

Etapa 2: Dropbox - Localizar arquivo

Resolva o arquivo pelo nome. Isso lhe dará uma referência de arquivo estável e mapeável para a Etapa 3.

CampoValor usado nesta execução.
SpaceDefault
Folder/pdf4metest/Files
Include files in subfolders?False
File Name10 page.pdf
Include Deleted Files?False
Include file contents?Yes
Zapier Dropbox Localizar Arquivo: Espaço Padrão, Pasta /pdf4metest/Files, Nome do Arquivo 10 page.pdf, Incluir Arquivos Excluídos Desconhecido, Incluir conteúdo do arquivo Sim.

Etapa 3: PDF4me - Criar Fatura SwissQR

A ação que realiza o trabalho. Procure por PDF4me No seletor de ações, selecione Criar nota QR suíçaEm seguida, preencha os campos exatamente como nas capturas de tela. referência de ação mostrar. O mínimo para corresponder a esta execução:

GrupoCampoValor
SourceFormat TypePDF
SourceFile2. File: (Exists but not shown)
SourceFile Name2. File Name: 10 page + 2. File Ext: .pdf
Sourcepaging Optionsfirst
PaymentCurrencyCHF
PaymentReference TypeQRR
PaymentLanguage TypeEnglish
PaymentSeparator LineLine with Scissor
PaymentAmount1923.67
PaymentIBANCH4431999123000889012
CreditorCreditor Address TypeS
CreditorCreditor NameVar Schneider AG
CreditorCreditor:Street / Address Line 1Var Schneider AG
CreditorCreditor:Building No. / Address Line 223
CreditorCreditor Citybiel
CreditorCreditor Postal Code2501
DebtorUltimate Debtor Address TypeS
DebtorUltimate Debtor NamePia-Maria Rutschmann-Schnyder
DebtorUltimate Debtor:Address Line 1Grosse Marktgasse
DebtorUltimate Debtor:Address Line 232
DebtorUltimate Debtor CityRorschach
DebtorUltimate Debtor Postal Code9400
Ref/MsgReference210000000003139471430009017
Ref/MsgUnstructured MessageInstruction of 15.09.2019
Ref/MsgBilling InfoS1/01/20170309/11/10201409/20/14000000/22/36958/30/CH106017086/40/1020/41/3010
Ref/MsgAV1 ParametersName AV1: UV;UltraPay005;12345
Ref/MsgAV2 ParametersName AV2: XY;XYService;54321

Etapa 4: Dropbox - Carregar arquivo

Salve o PDF preenchido na pasta de saída.

CampoValor usado nesta execução.
SpaceDefault
Folder/pdf4meoutput
File3. File Url (from PDF4me Step 3)
Overwriteno
Specify File Name3. File Name: 10 page (from PDF4me Step 3)
Specify File Extension3. File Extension: .pdf (from PDF4me Step 3)
Zapier Dropbox Upload de arquivo: Espaço padrão, Pasta /pdf4meoutput, Arquivo 3. URL do arquivo, Sobrescrever não, Especificar nome do arquivo 3. Nome do arquivo: 10 páginas, Especificar extensão do arquivo 3. Extensão do arquivo: .pdf.

Mapa Arquivo para o PDF4me URL do arquivo saída (Etapa 3); separar Especifique o nome do arquivo e Especifique a extensão do arquivo. Os campos preservam o nome original.

Salvar e clicar PublicarO Zap está ativo; insira uma nova fatura. /pdf4metest/Swiss-RP e o PDF com QR Code integrado chega em /pdf4meoutput dentro do próximo ciclo eleitoral.


Solução de problemas

QR-bill page is blank or unreadable
IBAN is invalid (must start with CH or LI, max 21 chars) or Currency is something other than CHF / EUR. Both are hard requirements of the Swiss Payment Standards.
Bank rejects a QRR reference
QRR references must be 27 digits with a mod-10 check digit. If you do not have one, switch Reference Type to SCOR (ISO 11649) or NON and leave Reference empty.
QR-bill landed on the wrong page
Adjust paging Options. first puts the slip as the new page 1. last appends it after the last page. Pass a 1-based page number to insert at that position.
Creditor or Debtor address looks wrong on the slip
Mismatched Address Type. With S, fill Postal Code + City and use Address Line 1/2 for street. With K, leave Postal Code + City empty and put the full address into Address Line 1 + Address Line 2.
Upload writes a zero-byte or missing file
File field on Step 4 is not bound to the PDF4me File Url. Re-pick 3. File Url. Also confirm Specify File Name and Specify File Extension are mapped to the PDF4me Step 3 outputs, not hardcoded.
Want a standalone QR slip without a source invoice
Skip Step 2 (Find File). In Step 3, leave File and File URL empty and the action returns a standalone Swiss QR-bill PDF.

Quando usar este padrão

Outgoing customer invoices
Bills that need to be Swiss-payable directly from a banking app via QR scan.
Subscription billing
QR-IBAN + 27-digit QRR reference identifies the customer or contract on every recurring run.
Bulk invoice retrofitting
When an existing PDF invoice template does not yet carry the payment slip, append it.
e-Bill fallbacks
For customers who prefer paper or in-app QR-scan over electronic Bill.

O que ler a seguir


Perguntas frequentes

Do I need a special Swiss QR library or font?+
No. The PDF4me Create Swiss QR Bill action bundles QR-code generation, the QR-bill fonts (Liberation Sans), mod-10 reference math, and the Swiss Payment Standards layout. Configure the fields, publish the Zap, and the output is a Swiss-compliant PDF.
What is the difference between QRR, SCOR, and NON references?+
QRR is the Swiss 27-digit numeric reference with a mod-10 check digit; it requires a QR-IBAN. SCOR is the international ISO 11649 creditor reference; it works with a standard IBAN. NON means no reference is shown on the slip. useful for ad-hoc one-off payments where the debtor adds their own reference at payment time.
Can I generate a Swiss QR-bill without an existing PDF invoice?+
Yes. Skip Step 2 (Find File). In Step 3, leave File and File URL empty and the action returns a standalone Swiss QR-bill PDF (just the payment slip, no invoice body).
My IBAN starts with DE / FR / IT. can I still use this?+
No. Swiss QR-bills are scoped to CH and LI IBANs only. For European SEPA payments with non-Swiss IBANs, use the Create EPC QR Code action instead.
Address Type S vs K. which one should I pick?+
S (Structured) is the modern default: Postal Code and City go in separate fields; Address Line 1/2 carries the street. K (Combined) puts the full address in two free-text Address Line fields and ignores Postal Code/City. New integrations should use S unless you are importing legacy data that does not separate postal code and city.
Does the output PDF work with mobile banking apps?+
Yes. Every Swiss bank app that supports payments via QR-bill (which is all of them since 2022) can scan the output to pre-fill the payment form. Test by opening UBS, PostFinance, Raiffeisen, or any Swiss banking app and scanning the QR code on the printed or on-screen slip.
How do I change where the QR-bill page lands?+
Set paging Options. first puts the slip as the new page 1 of the output PDF, last appends it to the end, or pass a 1-based page number to insert it at that position. Page indexing starts at 1.
Same scenario in n8n, Make, or Power Automate?+
Yes. The same PDF4me Create Swiss QR Bill action is available on all four platforms with identical parameters. See the cross-platform comparison at the bottom of the Create Swiss QR Bill action page.

Comece agora