Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog

Inserisci un codice QR svizzero per la fattura su un numero di pagina personalizzato in Power Automate (flusso Dropbox a 4 azioni con PDF4me)

· 22 minuti di lettura
Sankalp Mishra
SEO and Content Writer

La maggior parte dei tutorial svizzeri sulle fatture QR mette la ricevuta di pagamento su pagina 1 (oppure aggiungilo alla fine). Le fatture reali spesso ne hanno bisogno da qualche parte nel mezzo: un pacchetto di contratti di 10 pagine in cui la fattura QR va inserita subito dopo il riepilogo, oppure un estratto conto trimestrale in cui la ricevuta dovrebbe seguire la pagina di copertina. Il connettore PDF4me Power Automate gestisce tutto ciò in un'unica azione tramite Opzioni di paginazione = personalizzate più un Numero di pagina campo. Questa guida descrive nel dettaglio la corsa immortalata nell'immagine: /pdf4metest/sample/10 page.pdf diventa un file conforme alla normativa svizzera con il codice QR della fattura inserito come pagina 3, quindi caricato su /pdf4meoutput con un nome preceduto da GUID in modo che le esecuzioni successive non entrino in conflitto. 4 azioni, zero codice, esecuzione in pochi secondi.

Il flusso in sintesi
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.
La versione breve

Quattro azioni di Power Automate. L'attivazione manuale avvia il flusso. Dropbox Ottieni il contenuto del file legge /pdf4metest/sample/10 page.pdf con Dedurre il tipo di contenuto impostato su Sì. PDF4me Codice a barre - Crea fattura SwissQR aggiunge una pagina di fattura QR conforme agli standard di pagamento svizzeri con Tipo di formato di output PNG (in questa corsa; scegli PDF per il contenitore ibrido, più JPEG E Tiff disponibile), IBAN CH4431999123000889012, Quantità 5253531, Valuta CHF, Tipo di riferimento QRR, Lingua Inglese, Linea di separazione LineaConForbiciCreditore Var Schneider AG (Indirizzo S, biel 2501), Debitore finale Pia-Maria Rutschmann-Schnyder (indirizzo S, biel 9400), Riferimento 210000000003139471430009017, oltre ai parametri completi degli schemi alternativi AV1 e AV2. In Parametri avanzati: Opzioni di paginazione costume E Numero di pagina 3Dropbox Crea file scrive a /pdf4meoutput con Nome del file costruito da guid() + headers/FileName per garantire l'unicità. Output: un file scansionabile da una banca svizzera nella cartella dell'archivio.

Tre elementi che determinano se il tuo output è scansionabile dalla banca E finisce sulla pagina giusta

Innanzitutto, il L'IBAN deve iniziare con CH o LI. e deve essere al massimo di 21 caratteri. Per il tipo di riferimento QRR, l'IBAN deve essere un QR-IBAN, non un IBAN standard. In secondo luogo, quando il tipo di riferimento è QRR, il riferimento è un Numero di 27 cifre con cifra di controllo modulo 10. Se non ne hai uno, passa a SCOR O NON. Terzo, Le opzioni di impaginazione e la numerazione delle pagine si applicano solo quando il formato di output è PDF.I formati di immagine (PNG, JPEG, TIFF) vengono ignorati entrambi perché l'output è un'immagine singola, non un documento multipagina.

Domande comuni del mondo reale a cui questo risolve​

Le persone cercano questo specifico problema utilizzando frasi come:

  • "Come faccio a inserire un codice QR di una fattura svizzera su una pagina specifica del mio PDF in Power Automate?" Utilizzare il tipo di formato di output PDFOpzioni di paging custome il numero di pagina con l'indice di pagina basato su 1 (3 in questa guida).
  • "Posso esportare il codice QR svizzero come immagine PNG anziché come pagina PDF?" Sì. Imposta il tipo di formato di output su PNG, JPEG, O Tiff e l'azione restituisce un'immagine autonoma della sola ricevuta, ignorando le opzioni di impaginazione.
  • "Come posso assicurarmi che il nome del file di output non entri in conflitto durante le esecuzioni successive?" Utilizzare un guid() Espressione Power Automate nel campo Nome file del caricamento Dropbox, facoltativamente concatenata con headers/FileName dall'output di PDF4me.
  • "Cosa va inserito nella sezione Parametri avanzati dell'azione Power Automate?" Quattro campi: Numero di pagina, Opzioni di impaginazione, Contenuto del file (PDF sorgente), Nome del file. Fare clic Mostra tutto sui parametri avanzati per esporli.
  • "Le banche svizzere scansionano le fatture con codice QR in formato PNG?" Sì, la codifica QR è identica sia per i file PDF che per le immagini. Il formato PNG è la scelta ideale per le ricevute incorporate nelle email o nelle pagine web; il PDF è invece più indicato per la consegna di fatture complete con ricevuta.

Cosa stai costruendo​

Un flusso Power Automate riutilizzabile a 4 azioni che produce una fattura scansionabile da una banca svizzera con il codice QR qualunque pagina tu scelgaLo stesso flusso gestisce il caso di immagini singole (saltando il PDF di origine e cambiando il tipo di formato di output in PNG/JPEG/TIFF) per i promemoria di pagamento incorporati nelle e-mail.

Power Automate offre quattro azioni principali: Attiva manualmente un flusso, Ottieni il contenuto del file da Dropbox, Codice a barre - Crea fattura SwissQR, Crea file da Dropbox.

Quattro azioni, dall'alto verso il basso. L'attivazione manuale semplifica il test del flusso; sostituibile con qualsiasi trigger di accumulo in produzione.

Ciò di cui hai bisogno​

  • Power Automate conto con un flusso aperto. Open Power Automate.
  • Chiave API di PDF4me. Ottieni la tua chiave APIAccedi al connettore PDF4me Connect la prima volta che trascini l'azione.
  • Dropbox con /pdf4metest/sample come cartella sorgente e /pdf4meoutput come destinazione. Qualsiasi sistema di archiviazione funziona: SharePoint, OneDrive, Dataverse funzionano allo stesso modo.
  • Una fattura in formato PDF. Scarica l'esempio di 10 pagine seguire attentamente le schermate.
  • Dati di pagamento svizzeri: CH o LI IBAN (max 21 caratteri), Importo, Valuta (CHF O euro), blocchi completi nome/indirizzo del creditore + debitore finale. Riferimento completo del campo nel documenti di azione.

Riferimento rapido: i 4 campi che determinano l'output​

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.

Costruisci il flusso​

Azione 1: Attiva manualmente un flusso​

Attivazione manuale per il test. In produzione scambio per Dropbox Quando viene creato un file, SharePoint Quando viene creato un file, OneDrive Quando viene creato un file, Outlook Quando arriva una nuova email, Ricorrenza, O Webhooks a seconda della tua pipeline AR.

Azione 2: Dropbox - Ottieni il contenuto del file​

Recupera la fattura originale dalla cartella di input.

CampoValore utilizzato in questa esecuzione
File/pdf4metest/sample/10 page.pdf
Infer Content TypeYes
Power Automate Dropbox Ottieni contenuto file azione con File /pdf4metest/sample/10 page.pdf e parametro Avanzate Deduzione tipo di contenuto Sì.

Azione 3: PDF4me Barcode - Crea fattura SwissQR​

L'azione che compie il lavoro. Cerca PDF4me nel selettore di azioni e seleziona Codice a barre - Crea fattura SwissQR. L'azione ha i campi di pagamento nel pannello principale e 4 campi sotto Parametri avanzati (Opzioni di impaginazione, Numero di pagina, Contenuto del file, Nome del file). Configura:

GruppoCampoValore
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

Azione 4: Dropbox - Crea file​

Salva il file compilato con un nome univoco preceduto da GUID, in modo che le esecuzioni successive non causino conflitti.

CampoValore utilizzato in questa esecuzione
Folder Path/pdf4meoutput
File Nameguid() + headers/FileName (concat expression for a unique-per-run name)
File ContentFile Content (from Action 3 dynamic content)
Power Automate Dropbox Crea un'azione con percorso cartella /pdf4meoutput, nome file creato da guid() ed espressione headers/FileName e contenuto file contenuto dinamico dall'azione PDF4me Crea fattura SwissQR.

IL guid() L'espressione nel nome del file garantisce un nome univoco ad ogni esecuzione. Concatenazione intestazioni/NomeFile L'output di PDF4me conserva il nome originale della fattura all'interno del nuovo nome del file.

Salva e fai clic TestIl file scansionabile dalla banca svizzera finisce in /pdf4meoutput.

Get your API KeyFull action reference

Le 4 opzioni di formato di output, una accanto all'altra.​

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.

Risoluzione dei problemi​

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 utilizzare questo schema​

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.

Cosa leggere dopo​

FAQ​

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.

Inizia​

Get your API KeyPDF4me ConnectAction reference