Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog

Aggiungere un codice QR svizzero a qualsiasi fattura PDF in Power Automate: un flusso di lavoro Dropbox in 4 fasi

· 20 minuti di lettura
Sankalp Mishra
SEO and Content Writer

Ogni fattura svizzera deve essere accompagnata da un Banconota QR svizzera così le banche e i software di contabilità possono scansionare ed elaborare automaticamente il pagamento. Con Power Automate e PDF4me l'aggiunta è un flusso a quattro azioni: Attivazione manuale, Dropbox Ottieni il contenuto del file, PDF4me Codice a barre - Crea fattura SwissQRDropbox Crea file. Gli screenshot qui sotto illustrano l'esecuzione esatta catturata nella tela. Una fattura di 10 pagine in /pdf4metest/sample diventa una fattura conforme alla normativa svizzera con la ricevuta di pagamento allegata e caricata su /pdf4meoutput con un nome file univoco. Pronto per la produzione in meno di 10 minuti.

Il flusso in sintesi
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.
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 Infer Content Type impostato su Sì. PDF4me Codice a barre - Crea fattura SwissQR aggiunge una pagina di fattura QR conforme agli standard di pagamento svizzeri (tipo di formato di output PNG in questa corsa; passa a PDF per output ibrido, IBAN CH4431999123000889012, Quantità 5253531, Valuta CHF, Tipo di riferimento QRR, Lingua IngleseLinea di separazione LineaConForbiciCreditore: Var Schneider AG, Debitore finale: Pia-Maria Rutschmann-Schnyder, Riferimento 210000000003139471430009017Opzioni di paging costume, Numero di pagina 3Nome del file abc.pdfDropbox Crea file scrive a /pdf4meoutput con nome file creato da guid() + intestazioni/NomeFile per garantire l'unicità. L'output è un file scansionabile da una banca svizzera nella cartella dell'archivio.

Due fattori determinano se il tuo output è scansionabile dalla banca

Innanzitutto, il L'IBAN deve iniziare con CH o LI. e deve essere al massimo di 21 caratteri. Per un 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 Il campo di riferimento è una stringa numerica di 27 cifre con una cifra di controllo modulo 10.. Se non ne hai uno, cambia Tipo di riferimento in SCOR (ISO 11649) o NON e lasciare vuoto il campo Riferimento. Le banche rifiutano i valori di riferimento digitati in modo errato, non l'immagine del codice QR.

Domande comuni del mondo reale a cui questo risolve​

Le persone cercano questo specifico problema utilizzando frasi come:

  • "Come posso aggiungere automaticamente un codice QR svizzero alla mia fattura PDF in Power Automate?" Questo flusso in 4 fasi fa proprio questo: carica un PDF su Dropbox, avvia il flusso e il file con il codice QR per la fattura viene salvato nella cartella di output.
  • "Power Automate è in grado di generare una fattura con codice QR svizzero a partire da una fattura esistente?" Sì, tramite l'azione PDF4me Barcode - Create SwissQR Bill. Il risultato è lo stesso PDF con la ricevuta aggiunta alla prima/ultima/una pagina specifica.
  • "Ho bisogno di una libreria di codici QR o di un abbonamento a Swiss QR Generator?" No. L'azione PDF4me nasconde la generazione del codice QR, i calcoli di riferimento modulo 10 e l'intero layout degli standard di pagamento svizzeri dietro un singolo passaggio di Power Automate.
  • "E se non dispongo di un PDF di origine, posso generare un codice QR separato?" Sì. Ignora i campi Contenuto file e Nome file in Parametri avanzati; l'azione restituirà una fattura con codice QR autonoma nel formato di output scelto (PDF / PNG / JPEG / TIFF).
  • "Le banche svizzere accetteranno questi risultati?" Questa operazione genera una ricevuta conforme allo standard di pagamento svizzero ISO 20022. Qualsiasi app di mobile banking delle banche svizzere può scansionarla per avviare il pagamento.

Cosa stai costruendo​

Un flusso Power Automate riutilizzabile composto da 4 azioni. Quando si attiva un trigger, la fattura di origine viene recuperata da Dropbox (o SharePoint/OneDrive/Outlook), l'azione PDF4me aggiunge il codice QR della fattura e il file compilato viene caricato con un nome preceduto da un GUID. Lo stesso schema funziona per le fatture in uscita dei clienti, le esecuzioni batch pianificate o l'elaborazione dei crediti basata su eventi.

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 una cartella sorgente (ad esempio /pdf4metest/sample) e una cartella di output (/pdf4meoutputQualsiasi sistema di archiviazione funziona: SharePoint, OneDrive o Dataverse si mappano allo stesso modo.
  • Una fattura in formato PDF. Scarica l'esempio di 10 pagine utilizzato negli screenshot per seguire esattamente.
  • Dati di pagamento svizzeri: UN CH o LI IBAN, importo, valuta (CHF O euro), e blocchi nome/indirizzo creditore + debitore. Riferimento completo del campo nel documenti di azione.

Riferimento rapido: parametri chiave​

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.

Costruisci il flusso​

Azione 1: Attiva manualmente un flusso​

L'attivazione manuale è il modo più veloce per testare. In produzione sostituire con 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​

Cerca PDF4me e scegliere Codice a barre - Crea fattura SwissQRL'azione espone i campi di pagamento nel pannello principale e 4 campi in 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 popolato nella cartella di output. Crea un nome file univoco con guid() in modo che le esecuzioni ripetute non si sovrappongano.

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 crea un'azione Dropbox con percorso cartella /pdf4meoutput, nome file creato da guid() + espressione headers/FileName e contenuto file dinamico dall'azione PDF4me Crea fattura SwissQR.

IL guid() l'espressione in Nome file garantisce un nome univoco ad ogni esecuzione. Trascinandolo accanto a intestazioni/NomeFile L'output di PDF4me conserva il nome originale della fattura nel nome del file.

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

Get your API KeyFull action reference

Risoluzione dei problemi​

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

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.

Cosa leggere dopo​

FAQ​

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.

Inizia​

Get your API KeyPDF4me ConnectAction reference