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

Adicionar um código QR suíço a qualquer fatura em PDF no Power Automate: um fluxo de trabalho de 4 etapas do Dropbox

· 21 min para ler
Sankalp Mishra
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 Power Automate e o PDF4me, essa adição é ainda mais fácil. fluxo de quatro açõesAcionar manualmente, Dropbox Obter conteúdo do arquivo, PDF4me Código de barras - Criar fatura SwissQRDropbox Criar arquivoAs capturas de tela abaixo mostram exatamente o que foi exibido na tela. Uma fatura de 10 páginas em /pdf4metest/sample torna-se uma fatura em conformidade com as normas suíças, com o comprovante de pagamento anexado e carregado em /pdf4meoutput Com um nome de arquivo exclusivo. Pronto para produção em menos de 10 minutos.

O fluxo em resumo
1. Manually trigger a flow
Manual trigger for testing. Swap for SharePoint When a file is created or any storage trigger in production.
2. Dropbox Get file content
Reads the 10-page invoice from /pdf4metest/sample/10 page.pdf with Infer Content Type Yes.
3. PDF4me Barcode - Create SwissQR Bill
Appends the QR payment slip with CHF, QRR reference, English labels, custom Paging Options to land on page 3.
4. Dropbox Create file
Writes the populated PDF to /pdf4meoutput with a unique guid()+headers/FileName so re-runs do not collide.
A versão curta

Quatro ações do Power Automate. O acionamento manual inicia o fluxo. Dropbox Obter conteúdo do arquivo lê /pdf4metest/sample/10 page.pdf Com a opção "Inferir tipo de conteúdo" definida como "Sim". PDF4me Código de barras - Criar fatura SwissQR Anexa uma página de fatura QR compatível com os padrões de pagamento suíços (Tipo de formato de saída). PNG nesta execução; mude para PDF Para saída híbrida, IBAN CH4431999123000889012, Quantia 5253531, Moeda CHF, Tipo de referência QRR, Linguagem InglêsLinha Separadora Linha com tesouraCredor: Var Schneider AG, Devedor final: Pia-Maria Rutschmann-Schnyder, Referência 210000000003139471430009017Opções de paginação personalizado, Número da página 3, Nome do arquivo abc.pdfDropbox Criar arquivo escreve para /pdf4meoutput com nome de arquivo criado a partir de guid() + cabeçalhos/Nome do Arquivo para garantir a exclusividade. O resultado é um arquivo que pode ser lido por bancos suíços e está localizado 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 Power Automate?" Este fluxo de 4 ações faz tudo: arraste e solte um PDF no Dropbox, acione o fluxo e o arquivo com o código QR da fatura será salvo na pasta de saída.
  • "O Power Automate consegue gerar uma fatura QR suíça a partir de uma fatura existente?" Sim, através da ação PDF4me Barcode - Criar Fatura SwissQR. O resultado é o mesmo PDF com o comprovante anexado na primeira, última ou em uma página 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 em uma única etapa do Power Automate.
  • "E se eu não tiver um PDF de origem, posso gerar um comprovante com código QR independente?" Sim. Ignore os campos Conteúdo do Arquivo e Nome do Arquivo em Parâmetros Avançados; a ação retorna uma fatura QR independente no Formato de Saída escolhido (PDF / PNG / JPEG / TIFF).
  • "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 fluxo reutilizável de 4 ações do Power Automate. O gatilho é acionado, a fatura original é extraída do Dropbox (ou SharePoint/OneDrive/Outlook), a ação PDF4me adiciona o código QR da fatura e o arquivo preenchido é carregado com um nome prefixado por GUID. O mesmo padrão funciona para faturas de clientes, execuções em lote agendadas ou processamento de contas a receber orientado a eventos.

Tela de fluxo do Power Automate com quatro ações: Acionar um fluxo manualmente, Obter conteúdo de arquivo do Dropbox, Código de barras - Criar fatura SwissQR, Criar arquivo do Dropbox.

Quatro ações, de cima para baixo. O gatilho manual facilita o teste do fluxo; pode ser trocado por qualquer gatilho de armazenamento na produção.

Do que você precisa​

  • Power Automate conta com fluxo aberto. Abra o Power Automate.
  • Chave da API PDF4me. Obtenha sua chave de APIFaça login no conector PDF4me Connect na primeira vez que você soltar a ação.
  • Dropbox com uma pasta de origem (por exemplo, /pdf4metest/amostra) e uma pasta de saída (/pdf4meoutputQualquer serviço de armazenamento funciona: SharePoint, OneDrive ou Dataverse funcionam da mesma maneira.
  • Uma fatura em PDF. Baixe a amostra de 10 páginas. As capturas de tela foram usadas para acompanhar exatamente o passo a passo.
  • 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​

Output Format Type
PDF (hybrid), PNG / JPEG / Tiff (standalone images).
IBAN
CH or LI prefix, max 21 chars. QR-IBAN required for QRR references.
Reference Type
QRR (27-digit + mod-10), SCOR (ISO 11649), or NON.
Address Type
S = structured (separate Postal Code + City). K = combined.
Paging Options
first, last, add at end, or custom (uses Page Number). PDF only.
Page Number
1-based page index. Required only when Paging Options is custom.

Construa o fluxo​

Ação 1: Acionar um fluxo manualmente​

O acionamento manual é a maneira mais rápida de testar. Em produção, troque por Dropbox Quando um arquivo é criado, SharePoint: Quando um arquivo é criado, OneDrive: Quando um arquivo é criado, Outlook: Quando chega um novo e-mail, Recorrência, ou Webhooks Dependendo do seu pipeline de RA.

Ação 2: Dropbox - Obter conteúdo do arquivo​

Extraia a fatura original da sua pasta de entrada.

CampoValor usado nesta execução.
File/pdf4metest/sample/10 page.pdf
Infer Content TypeYes
Ação "Obter conteúdo do arquivo" do Dropbox no Power Automate com o arquivo /pdf4metest/sample/10 page.pdf e o parâmetro avançado "Inferir tipo de conteúdo: Sim".

Ação 3: Código de barras PDF4me - Criar fatura SwissQR​

Procurar PDF4me e escolha Código de barras - Criar fatura SwissQRA ação expõe os campos de pagamento no painel principal e 4 campos em Parâmetros avançados (Opções de paginação, Número da página, Conteúdo do arquivo, Nome do arquivo). Configurar:

GrupoCampoValor
OutputOutput Format TypePNG
PaymentIBANCH4431999123000889012
PaymentAmount5253531
PaymentCurrencyCHF
PaymentReference TypeQRR
PaymentLanguage TypeEnglish
PaymentSeperator LineLineWithScissor
CreditorCreditor NameVar Schneider AG
CreditorCreditor Address TypeS
CreditorCreditor: Address Line 1Var Schneider AG
CreditorCreditor: Address Line 223
CreditorCreditor PostalCode2501
CreditorCreditor Citybiel
DebtorUltimate Debtor NamePia-Maria Rutschmann-Schnyder
DebtorUltimate Debtor AddressTypeS
DebtorUltimate Debtor: Address Line 1Grosse Marktgasse
DebtorUltimate Debtor: Address Line 233
DebtorUltimate Debtor PostalCode9400
DebtorUltimate Debtor Citybiel
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
AdvancedPaging Optionscustom
AdvancedPage Number3
AdvancedFile ContentFile Content (from Action 2)
AdvancedFile Nameabc.pdf

Ação 4: Dropbox - Criar arquivo​

Salve o arquivo preenchido na pasta de saída. Crie um nome de arquivo exclusivo com guid() para que as reprises não entrem em conflito.

CampoValor usado nesta execução.
Folder Path/pdf4meoutput
File Nameguid() + headers/FileName (concat expression for a unique-per-run name)
File ContentFile Content (from Action 3, dynamic content)
A ação "Criar arquivo" do Power Automate Dropbox utiliza o caminho da pasta /pdf4meoutput, o nome do arquivo é construído a partir da expressão guid() + headers/FileName e o conteúdo do arquivo é dinâmico, proveniente da ação "Criar fatura SwissQR" do PDF4me.

O guid() A expressão no nome do arquivo garante um nome exclusivo em cada execução. Soltá-la ao lado de cabeçalhos/Nome do Arquivo O arquivo de saída do PDF4me preserva o nome original da fatura no nome do arquivo.

Salvar e clicar TesteO arquivo escaneável pelo banco suíço chega em /pdf4meoutput.

Get your API KeyFull action reference

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 under Advanced. first puts the slip as the new page 1. last appends it after the last page. custom uses Page Number for a specific 1-based 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.
Create file writes an empty file
File Content on Action 4 is not bound to the PDF4me File Content output. Click the field and re-pick the dynamic content from Action 3.
Want a standalone QR slip without a source invoice
Skip Action 2 (Get file content). On Action 3, leave File Content and File Name empty under Advanced parameters and the action returns a standalone Swiss QR-bill in the chosen Output Format Type.

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 SwissQR 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, save the flow, and the output is a Swiss-compliant file.
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 Action 2 (Get file content). On Action 3, leave File Content and File Name empty under Advanced parameters; the action returns a standalone Swiss QR-bill in the chosen Output Format Type (PDF, PNG, JPEG, or Tiff).
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 action instead.
Address Type S vs K, which one should I pick?+
S (Structured) is the modern default: PostalCode 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 PostalCode/City. New integrations should use S unless you are importing legacy data.
Does the output work with mobile banking apps?+
Yes. Every Swiss bank app that supports payments via QR-bill (every major bank 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.
How do I change where the QR-bill page lands?+
Click Show all on Advanced parameters. Set Paging Options to first / last / add at end / custom. For custom, also fill Page Number with the 1-based page index. Only applies when Output Format Type is PDF.
Same scenario in Make, Zapier, or n8n?+
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​

Get your API KeyPDF4me ConnectAction reference