Pular para o conteúdo principal

Adicione uma fatura com QR Code suíço a qualquer PDF de fatura no Make: um fluxo de trabalho de 3 módulos do Dropbox.

· 21 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 Make e PDF4me, essa adição é um grande diferencial. cenário de três módulosDropbox Baixar um arquivo, PDF4me Criar nota QR suíçaDropbox Carregar um arquivoAs capturas de tela abaixo mostram exatamente o que é exibido na tela: uma fatura de 10 páginas em /pdf4metest/Files/10 page.pdf torna-se uma fatura em conformidade com as normas suíças, com o comprovante de pagamento anexado e salvo em /pdf4meoutput/Pronto para produção em menos de 10 minutos.

O cenário em resumo
1. Dropbox Download a File
Reads /pdf4metest/Files/10 page.pdf. Scheduled trigger (clock badge) is shown but any trigger works.
2. PDF4me Create Swiss QR-bill
Appends the QR payment slip to the source PDF. Currency, IBAN, creditor + debtor blocks, reference filled out.
3. Dropbox Upload a File
Writes the populated PDF to /pdf4meoutput/. File Name and Data mapped from the prior step.
A versão curta

Três módulos Make. Dropbox Baixar um arquivo Extrai a fatura original (a captura de tela mostra YnooxTestone conexão, Selecione um arquivo, caminho /pdf4metest/Files/10 page.pdf). 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, IBAN começando com CH(blocos completos de credores e devedores). Dropbox Carregar um arquivo escreve o resultado em /pdf4meoutput/ com o arquivo definido para Mapa, Nome do arquivo = 6. Nome, Dados = 6. DocumentO PDF gerado está pronto para ser enviado por e-mail e para ser utilizado como leitor de código QR em qualquer aplicativo móvel de bancos suíços.

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 código QR, 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, defina o Tipo de Referência como 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 faço para adicionar automaticamente um código QR suíço à minha fatura em PDF?" Basta enviar a fatura para o Dropbox; este sistema de 3 módulos cuida do resto, incluindo IBAN, valor, referência e detalhes do credor/devedor.
  • "O Make consegue gerar uma fatura com código QR suíço a partir de uma fatura existente?" Sim. Através do módulo PDF4me Create Swiss QR-bill. O resultado é o mesmo PDF com o comprovante de pagamento anexado na página que você escolher (primeira/última/específica).
  • "Preciso de um modelo do Excel ou de uma biblioteca de códigos QR?" Não. O módulo oculta toda a geração de código QR, os cálculos de referência mod-10 e o layout dos Padrões de Pagamento Suíços por trás de uma única etapa configurável.
  • "E se eu não tiver uma fatura em PDF? Ainda posso gerar um comprovante QR Code independente?" Sim. Ignore completamente o grupo Arquivo e o módulo retornará um PDF independente da fatura suíça com código QR.
  • "Será que os bancos suíços aceitarão de fato esse resultado?" O módulo 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 cenário Make reutilizável de 3 módulos. O gatilho é acionado (manual, agendado, monitoramento de arquivo, qualquer um), a fatura original é obtida, o código QR suíço é anexado e o resultado é salvo. O mesmo padrão funciona para testes pontuais, execuções em lote agendadas ou processamento de faturas totalmente orientado a eventos.

Criar tela de cenário: Download de um arquivo pelo Dropbox (com indicador de tempo agendado) conectado ao PDF4me Criar nota QR suíça, que está conectado ao Upload de um arquivo pelo Dropbox. Três grandes ícones circulares de módulo conectados com os conectores padrão de linha pontilhada.

Três módulos integrados de ponta a ponta. O ícone de relógio no Dropbox 1 indica um acionamento agendado. Alterne para o modo manual ou webhook conforme sua necessidade.


Do que você precisa

  • Fazer conta com um cenário aberto. Crie uma conta Make Se você precisar de um.
  • Chave da API PDF4me. Obtenha sua chave de API e adicione-o quando o PDF4me solicitar uma conexão. Veja Conecte o PDF4me para criar.
  • Dropbox com uma pasta de origem (por exemplo, /pdf4metest/Arquivos/) e uma pasta de saída (/pdf4meoutput/Qualquer serviço de armazenamento funciona da mesma maneira. Troque para Google Drive, OneDrive ou SharePoint conforme necessário.
  • Uma fatura em PDF (as capturas de tela usam 10 páginas.pdfOpcional: ignore o arquivo de origem e gere 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.

Construa o cenário

Módulo 1: Dropbox - Baixar um arquivo

Extraia a fatura original da sua pasta de entrada.

CampoValor usado nesta execução.
ConnectionYnooxTestone (ynoox.test...). your Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Files/10 page.pdf
Configure o Dropbox para baixar um arquivo. A conexão deve ser definida como YnooxTestone. A forma de seleção de arquivos deve ser selecionada. O caminho do arquivo deve ser /pdf4metest/Files/10 page.pdf. Os botões Cancelar e Salvar estão localizados na parte inferior.

Configuração do Dropbox para baixar um arquivo. Selecione o arquivo pelo seletor de caminho ou, para processamento em lote, use Pesquisar arquivos e vincular o arquivo dinamicamente.

Módulo 2: PDF4me - Criar nota QR suíça

Procurar PDF4me e escolha Criar nota QR suíçaO módulo expõe 26 campos. A referência completa de cada campo (com 5 capturas de tela detalhadas da interface do usuário e valores de exemplo como Var Schneider AG, CH4431999123000889012, Pia-Maria Rutschmann-Schnyder) está disponível em [link para o módulo]. Criar fatura SwissQR no Make Página de ação. O mínimo a definir:

GrupoCampoValor
SourceFileDropbox - Download a File (pulls from Module 1 automatically)
OutputFormat TypePDF
OutputPaging OptionsFirst (also: Last, or a specific 1-based page number)
PaymentCurrencyCHF (or EUR)
PaymentReference TypeQRR, SCOR, or NON
PaymentLanguageEnglish / German / French / Italian
PaymentSeparator LineLine With Scissor, Only Line, or No Line
PaymentAmounte.g. 1250.00
PaymentIBANCH or LI IBAN, max 21 chars
CreditorCreditor Address TypeS (Structured) or K (Combined)
CreditorCreditor NameCompany name on the account
DebtorUltimate Debtor AddressTypeS or K

Preencha os campos de endereço do credor e do devedor de acordo com a sua escolha de Tipo de Endereço e, em seguida, quaisquer parâmetros opcionais de Referência / Mensagem Não Estruturada / Informações de Cobrança / AV1 / AV2.

Módulo 3: Dropbox - Carregar um arquivo

Escreve o PDF preenchido na pasta de saída.

CampoValor usado nesta execução.
ConnectionYnooxTestone (ynoox.test...). same Dropbox connection as Module 1
Folder/pdf4meoutput/
FileMap (so File Name and Data come from the PDF4me step)
File Name6. Name (dynamic content from PDF4me Module 2)
Data6. Document (dynamic content from PDF4me Module 2)
Configure o Dropbox para fazer upload de um arquivo. Conexão YnooxTestone. Pasta /pdf4meoutput/. Arquivo definido como Mapa. Nome do arquivo vinculado a 6. Nome (de PDF4me Criar QR-bill suíço). Dados vinculados a 6. Documento. A dica diz: Nome do arquivo, incluindo a extensão, por exemplo, invoice.xml.

O programa de rádio File configurado para Mapa Expõe o nome do arquivo e os dados como campos separados. Vincule ambos às saídas do Módulo 2 do PDF4me para que o PDF preenchido seja gerado intacto.

Salvar e clicar Executar uma vezA fatura preenchida aparecerá em /pdf4meoutput/ Em poucos segundos.


O que é armazenado na pasta de saída?

Um único PDF nomeado de acordo com a fonte (por exemplo, 10 page.pdf) com a página da fatura QR suíça inserida na posição escolhida em Opções de paginação (First coloca-a como a nova página 1; Last (Acrescenta-o ao final). Abra o arquivo em qualquer visualizador de PDF e a seção da fatura QR mostrará o código QR de pagamento, a conta/pagamento legível, o valor, a moeda, a referência e os endereços do credor/devedor. Aponte um aplicativo bancário suíço para o código QR e o pagamento será preenchido automaticamente.


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. Anything else is rejected by the 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 PostalCode + City). K = combined (full address in two AddressLines).
Paging Options
First, Last, or a 1-based page number. Decides where the QR-bill page lands.
AV1 / AV2
Alternative scheme parameters for eBill and similar. Format: Name AV1: UV;value;id.

Solução de problemas

QR-bill page is blank or the QR code is unreadable
The IBAN is invalid (must start with CH or LI, max 21 chars) or the Currency was something other than CHF / EUR. Both are hard requirements of the Swiss Payment Standards.
Reference Type QRR but the bank rejects the 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. Or pass a 1-based page number to insert at that position.
Creditor or Debtor address looks wrong on the slip
Mismatched Address Type. With type S, fill PostalCode + City and use AddressLine1/2 for street. With type K, leave PostalCode + City empty and put the full address into AddressLine1 + AddressLine2.
Upload writes a zero-byte file
File Name or Data in the Upload module is not bound to the PDF4me Module 2 outputs. Click the field and re-pick the dynamic content from Module 6 (PDF4me Create Swiss QR-bill).
Want a standalone QR slip without an invoice
Skip the source file entirely. Remove Dropbox Module 1, or leave the File group empty in the PDF4me module. The output is 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 via this scenario.
e-Bill replacements / fallbacks
For customers who prefer paper or in-app QR-scan over the electronic Bill flow.

O que ler a seguir


Perguntas frequentes

Do I need a special Swiss QR library or font?+
No. The PDF4me Create Swiss QR-bill module bundles QR-code generation, the QR-bill fonts (Liberation Sans), the mod-10 reference math, and the Swiss Payment Standards layout. Configure the fields, click Run, 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 the File group in the PDF4me module and the output is a standalone Swiss QR-bill PDF (just the payment slip, no invoice body). Useful when the debtor only needs the slip, or when your invoice body comes from a different source.
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 Generate EPC QR Code for SEPA module instead.
Address Type S vs K. which one should I pick?+
S (Structured) is the modern default: PostalCode and City go in separate fields; AddressLine1/2 carries the street. K (Combined) puts the full address in two free-text AddressLine fields and ignores PostalCode/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, Zapier, 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 SwissQR Bill action page.

Comece agora