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

Inserir um código QR suíço em uma página com número personalizado no Power Automate (fluxo de 4 ações do Dropbox com PDF4me)

· 22 min para ler
Sankalp Mishra
SEO and Content Writer

A maioria dos tutoriais suíços sobre faturas QR coloca o comprovante de pagamento no leitor. página 1 (ou acrescente-o ao final). Faturas reais geralmente precisam disso. em algum lugar no meioUm pacote de contrato de 10 páginas, onde a fatura com QR Code deve aparecer logo após o resumo, ou um extrato trimestral, onde o comprovante deve seguir a capa. O conector PDF4me Power Automate resolve isso em uma única ação. Opções de paginação = personalizadas mais um Número da página campo. Este guia descreve detalhadamente a execução capturada na tela: /pdf4metest/sample/10 page.pdf torna-se um arquivo compatível com as normas suíças, com a fatura QR inserida como página 3, e então carregado para /pdf4meoutput com um nome prefixado por GUID para que as execuções subsequentes não entrem em conflito. 4 ações, zero código, executado em segundos.

O fluxo em resumo
1. Manually trigger a flow
Manual trigger for testing. Swap for any storage trigger in production.
2. Dropbox Get file content
Reads /pdf4metest/sample/10 page.pdf with Infer Content Type Yes.
3. PDF4me Barcode - Create SwissQR Bill
Output Format Type PNG (try PDF for hybrid). Paging Options custom, Page Number 3. All payment fields filled.
4. Dropbox Create file
Writes to /pdf4meoutput. File Name built from guid() plus headers/FileName so every run lands as a unique file.
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 Inferir tipo de conteúdo Defina como Sim. PDF4me Código de barras - Criar fatura SwissQR Acrescenta uma página de fatura QR compatível com os padrões de pagamento suíços com Tipo de formato de saída PNG (nesta corrida; escolha PDF para o contêiner híbrido, mais JPEG e Tiff disponível), IBAN CH4431999123000889012, Quantia 5253531, Moeda CHF, Tipo de referência QRR, Linguagem Inglês, Linha Separadora Linha com tesoura, Credor Var Schneider AG (Endereço S, Biel 2501), Devedor Final Pia-Maria Rutschmann-Schnyder (Endereço S, Biel 9400), Referência 210000000003139471430009017Além dos parâmetros completos dos esquemas alternativos AV1 e AV2, consulte as opções em Parâmetros avançados: Opções de paginação personalizado e Número da página 3Dropbox Criar arquivo escreve para /pdf4meoutput com Nome do arquivo construído a partir de guid() + cabeçalhos/NomeDoArquivo para garantir a exclusividade. Resultado: um arquivo escaneável por bancos suíços na pasta de arquivos.

Três fatores que determinam se o seu documento é legível pelo sistema bancário E se ele será exibido na página correta.

Primeiro, o O IBAN deve começar com CH ou LI. e ter no máximo 21 caracteres. Para o tipo de referência QRR, o IBAN deve ser um QR-IBAN, não um IBAN padrão. Em segundo lugar, quando o Tipo de Referência é QRR, a Referência é um Número de 27 dígitos com um dígito verificador módulo 10.Se você não tiver um, mude para PONTUAÇÃO ou NÃO. Terceiro, As opções de paginação e número de página só se aplicam quando o tipo de formato de saída é PDF.Os tipos de formato de imagem (PNG, JPEG, TIFF) são ignorados porque a saída é uma imagem independente, e não um documento com várias páginas.

Isso resolve alguns problemas comuns do mundo real.​

As pessoas pesquisam exatamente esse problema com frases como:

  • "Como faço para inserir um código QR de uma nota fiscal suíça em uma página específica do meu PDF no Power Automate?" Usar o tipo de formato de saída PDFOpções de paginação custome o número da página com o índice de páginas baseado em 1 (3 neste guia).
  • "Posso gerar o código QR suíço como uma imagem PNG em vez de uma página PDF?" Sim. Defina o tipo de formato de saída para PNG, JPEG, ou Tiff e a ação retorna uma imagem independente apenas do comprovante, ignorando as opções de paginação.
  • "Como posso garantir que o nome do meu arquivo de saída não entre em conflito em execuções subsequentes?" Use um guid() Expressão do Power Automate no campo Nome do arquivo do upload do Dropbox, opcionalmente concatenada com headers/FileName a partir da saída do PDF4me.
  • "O que deve ser incluído nos parâmetros avançados da ação do Power Automate?" Quatro campos: Número da página, Opções de paginação, Conteúdo do arquivo (PDF de origem), Nome do arquivo. Clique. Mostrar tudo nas configurações avançadas para expô-las.
  • "Os bancos suíços conseguem ler notas com código QR em formato PNG?" Sim. A codificação QR é idêntica em PDFs e imagens. O PNG é a escolha certa para e-mails ou comprovantes incorporados na web; o PDF é ideal para faturas completas com comprovante.

O que você está construindo?​

Um fluxo reutilizável de 4 ações do Power Automate que gera uma fatura digitalizável por bancos suíços com o código QR na fatura. qualquer página que você escolherO mesmo fluxo trata o caso de imagens independentes (ignorar o PDF de origem, alterar o Tipo de Formato de Saída para PNG / JPEG / TIFF) para lembretes de pagamento incorporados em e-mails.

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 /pdf4metest/amostra como pasta de origem e /pdf4meoutput como destino. Qualquer armazenamento funciona: SharePoint, OneDrive, Dataverse funcionam da mesma maneira.
  • Uma fatura em PDF. Baixe a amostra de 10 páginas. Siga as instruções exatamente pelas capturas de tela.
  • dados de pagamento suíços: IBAN CH ou LI (máximo de 21 caracteres), Valor, Moeda (CHF ou EUR), blocos completos de nome/endereço do Credor + Devedor Final. Referência completa do campo no documentos de ação.

Referência rápida: os 4 campos que definem a saída​

Output Format Type
PDF (hybrid), PNG, JPEG, or Tiff. Picks the container of the populated output.
Paging Options
first, last, add at end, or custom. PDF Output Format Type only.
Page Number
1-based page index. Required when Paging Options is custom; ignored otherwise. Set to 3 in this run.
File Content + File Name
The source PDF, mapped from a previous action. Skip both for a standalone QR-slip from payment data alone.

Construa o fluxo​

Ação 1: Acionar um fluxo manualmente​

Acionador manual para testes. Em produção, troca 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​

A ação que realiza o trabalho. Procure por PDF4me no seletor de ações e escolha Código de barras - Criar fatura SwissQRA ação possui os campos de pagamento no painel principal e 4 campos abaixo. 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 com um nome exclusivo que contenha um prefixo GUID para que as execuções subsequentes 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 de guid() e da expressão 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. Concatenando cabeçalhos/Nome do Arquivo O arquivo de saída do PDF4me preserva o nome original da fatura dentro do novo nome do arquivo.

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

Get your API KeyFull action reference

As 4 opções de Tipo de Formato de Saída, lado a lado​

PDF
Hybrid output: QR-bill page inserted into your source invoice. Most common for outgoing AR. Uses Paging Options + Page Number.
PNG
Standalone raster image of the QR-bill slip. Best for inline email embeds and web previews. Ignores Paging Options.
JPEG
Compressed raster image. Smaller file size than PNG. Still bank-scannable.
Tiff
Lossless raster archive format. Use when the recipient needs print-grade quality.

Solução de problemas​

QR-bill landed on the wrong page
Check Paging Options. custom uses Page Number. first puts the slip as the new page 1. last appends at the end. Only applies when Output Format Type is PDF.
Page Number is greyed out / ignored
Paging Options is something other than custom. Switch Paging Options to custom and the Page Number field becomes active.
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.
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​

Slip on a specific mid-document page
Quarterly statement where the QR-bill belongs right after the cover page. Contract pack with the slip after the summary.
Inline email PNG payment reminders
Output Format Type PNG, skip the source PDF, embed the slip image directly in an Outlook Send email body.
High-volume AR archival
guid()-prefixed Dropbox upload makes every run uniquely addressable for downstream search and audit.
Subscription billing
QR-IBAN plus QRR Reference identifies the customer or contract every recurring run.

O que ler a seguir​

Perguntas frequentes​

How do I insert the Swiss QR-bill on a specific page in Power Automate?+
Click Show all on Advanced parameters in the PDF4me Barcode - Create SwissQR Bill action. Set Paging Options to custom, then set Page Number to the 1-based page index where the QR-bill should land (3 in this guide). Output Format Type must be PDF for Paging Options to take effect.
What is the difference between Paging Options values first, last, add at end, and custom?+
first inserts the QR-bill as the new page 1 (everything else shifts down by one). last appends at the very end of the source PDF. add at end is a functional alias for last. custom uses the Page Number field to insert at a specific 1-based position.
Why does the QR-bill not move when I change Paging Options?+
Output Format Type is set to PNG, JPEG, or Tiff. Image formats ignore Paging Options because the output is a standalone slip image, not a multi-page document. Switch Output Format Type to PDF.
Can I generate a Swiss QR-bill image (PNG) without a source invoice?+
Yes. Set Output Format Type to PNG (or JPEG / Tiff). Skip the File Content and File Name fields under Advanced parameters. The action returns a standalone QR-bill image you can embed inline in an Outlook email or display on a web page.
Why use guid() in the Dropbox Create file File Name?+
It guarantees every run lands as a unique file in /pdf4meoutput so re-runs do not silently overwrite previous outputs. Concatenating headers/FileName from the PDF4me output keeps the original invoice name inside the new filename for traceability.
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 and the recommended choice for new integrations. PostalCode and City go in separate fields; Address Line 1 / 2 carries the street. K (Combined) puts the full address into two free-text Address Line fields and leaves PostalCode and City empty.
Same flow 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 action reference page.

Comece agora​

Get your API KeyPDF4me ConnectAction reference