Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog

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

· 22 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 Zapier e PDF4me l'aggiunta è un Zap in quattro fasi: Dropbox Nuovo file nella cartellaDropbox Trova file, PDF4me Crea una fattura QR svizzeraDropbox Carica file. Gli screenshot qui sotto illustrano l'esecuzione esatta catturata nella tela: una fattura di 10 pagine in /pdf4metest/Swiss-RP diventa una fattura conforme alla normativa svizzera con la ricevuta di pagamento allegata e salvata su /pdf4meoutputPronto per la produzione in meno di 10 minuti.

Zap in sintesi
1. Dropbox New File in Folder
Watches /pdf4metest/Swiss-RP every 2 minutes. Trigger fires when a new invoice PDF lands.
2. Dropbox Find File
Resolves the file by name (10 page.pdf) and pulls the binary, ready for the next step.
3. PDF4me Create Swiss QR Bill
Appends the QR payment slip with all required SPS fields: CHF, QRR reference, English, Line with Scissor separator.
4. Dropbox Upload File
Writes the populated PDF to /pdf4meoutput. File Name and File Extension carried from the PDF4me output.
La versione breve

Quattro passaggi Zap. Dropbox Nuovo file nella cartella orologi /pdf4metest/Swiss-RP (Spazio predefinito, Includi file nelle sottocartelle Falso, Includi il contenuto del file e il link di condivisione entrambi SÌDropbox Trova file guarda in alto 10 pagine.pdf In /pdf4metest/Files e restituisce il file binario. PDF4me Crea una fattura QR svizzera aggiunge una pagina di fattura QR conforme agli standard di pagamento svizzeri (tipo di formato PDFOpzioni di paging Primo, Valuta CHF, Tipo di riferimento QRR, Lingua Inglese, Separatore Lineare con le forbici, Quantità 1923.67IBAN CH4431999123000889012Creditore: Var Schneider AG, Debitore finale: Pia-Maria Rutschmann-Schnyder, Riferimento 210000000003139471430009017Dropbox Carica file scrive il PDF compilato su /pdf4meoutput utilizzando 3. URL del file, con 3. Nome del file E 3. Estensione del file come nome del file di output. Il risultato è un PDF 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 il 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 tramite Zapier?" Questo Zap in 4 passaggi fa tutto: il file viene caricato su Dropbox, Zap viene eseguito e il PDF con la fattura arricchita da codice QR viene salvato nella cartella di output.
  • "È possibile per Zapier generare una fattura con codice QR svizzero a partire da una fattura esistente?" Sì, tramite l'azione "Crea fattura QR svizzera" di PDF4me. Il risultato è lo stesso PDF con la ricevuta di pagamento allegata sulla pagina che preferisci (prima, ultima o 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 Zapier.
  • "E se non dispongo di un PDF di origine, posso generare un codice QR separato?" Sì. Salta il passaggio 2 (Trova file) e i campi File / URL file nel passaggio 3. L'azione restituisce un PDF autonomo della fattura QR svizzera contenente solo i dati di pagamento.
  • "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​

Uno Zap Zapier riutilizzabile in 4 fasi. Il trigger monitora una cartella Dropbox, lo Zap trova la fattura più recente, esegue l'azione PDF4me Swiss QR Bill con i dettagli del creditore, del debitore e del pagamento e carica il PDF ottimizzato in una cartella di output. Lo stesso schema funziona per le fatture in uscita ai clienti, le esecuzioni batch programmate o l'elaborazione dei crediti completamente basata su eventi.

Zapier Zap canvas con quattro passaggi: Dropbox Nuovo file nella cartella (intervallo di 2 minuti), Dropbox Trova file, PDF4me Crea fattura SwissQR, Dropbox Carica file. Il banner di stato mostra Operazione completata con successo il 1 giugno 2026 alle 13:00:20 con ID esecuzione.

Quattro passaggi dall'alto verso il basso. L'intervallo di 2 minuti del passaggio 1 è la cadenza di polling predefinita di Zapier per i trigger di Dropbox; i piani di upgrade possono effettuare polling più frequentemente.

Ciò di cui hai bisogno​

  • Zapier account. Crea un account Zapier se ne hai bisogno.
  • Chiave API di PDF4me. Ottieni la tua chiave API e aggiungilo quando PDF4me richiede un account nell'editor Zap. Vedi Collega PDF4me a Zapier.
  • Dropbox con una cartella sorgente (ad esempio /pdf4metest/Swiss-RP) e una cartella di output (/pdf4meoutput).
  • Una fattura in formato PDF (gli screenshot utilizzano 10 pagine.pdf). Opzionale: salta il file sorgente per ottenere una ricevuta QR autonoma utilizzando solo i dati di pagamento.
  • 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​

IBAN
CH or LI prefix, max 21 chars. QR-IBAN required for QRR references.
Currency
CHF or EUR only. Other currencies rejected by 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 Postal Code + City). K = combined (full address in two Address Lines).
paging Options
first, last, append, or a specific 1-based page number.
Format Type
PDF for printable invoices, PNG/JPEG/TIFF for image output.

Crea lo Zap​

Passaggio 1: Dropbox - Nuovo file nella cartella (attivatore)​

Controlla la cartella di origine per eventuali nuove fatture.

CampoValore utilizzato in questa esecuzione
SpaceDefault
Folder/pdf4metest/Swiss-RP
Include files in subfolders?False
Include file contents?Yes
Include sharing link?Yes
Attivazione Zapier Dropbox Nuovo file nella cartella: Spazio predefinito, Cartella /pdf4metest/Swiss-RP, Includi file nelle sottocartelle Falso, Includi contenuto file Sì, Includi link di condivisione Sì.

Passaggio 2: Dropbox - Trova file​

Risolvi il file per nome. Questo ti fornirà un riferimento al file stabile e mappabile per il passaggio 3.

CampoValore utilizzato in questa esecuzione
SpaceDefault
Folder/pdf4metest/Files
Include files in subfolders?False
File Name10 page.pdf
Include Deleted Files?False
Include file contents?Yes
Zapier Dropbox Trova file: Spazio predefinito, Cartella /pdf4metest/Files, Nome file 10 page.pdf, Includi file eliminati Falso, Includi contenuto file Sì.

Passaggio 3: PDF4me - Crea fattura SwissQR​

L'azione che compie il lavoro. Cerca PDF4me nel selettore azioni, seleziona Crea una fattura QR svizzera, quindi compila i campi esattamente come negli screenshot nel riferimento all'azione mostra. Il minimo per corrispondere a questa esecuzione:

GruppoCampoValore
SourceFormat TypePDF
SourceFile2. File: (Exists but not shown)
SourceFile Name2. File Name: 10 page + 2. File Ext: .pdf
Sourcepaging Optionsfirst
PaymentCurrencyCHF
PaymentReference TypeQRR
PaymentLanguage TypeEnglish
PaymentSeparator LineLine with Scissor
PaymentAmount1923.67
PaymentIBANCH4431999123000889012
CreditorCreditor Address TypeS
CreditorCreditor NameVar Schneider AG
CreditorCreditor:Street / Address Line 1Var Schneider AG
CreditorCreditor:Building No. / Address Line 223
CreditorCreditor Citybiel
CreditorCreditor Postal Code2501
DebtorUltimate Debtor Address TypeS
DebtorUltimate Debtor NamePia-Maria Rutschmann-Schnyder
DebtorUltimate Debtor:Address Line 1Grosse Marktgasse
DebtorUltimate Debtor:Address Line 232
DebtorUltimate Debtor CityRorschach
DebtorUltimate Debtor Postal Code9400
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

Passaggio 4: Dropbox - Carica il file​

Salva il PDF compilato nella cartella di output.

CampoValore utilizzato in questa esecuzione
SpaceDefault
Folder/pdf4meoutput
File3. File Url (from PDF4me Step 3)
Overwriteno
Specify File Name3. File Name: 10 page (from PDF4me Step 3)
Specify File Extension3. File Extension: .pdf (from PDF4me Step 3)
Zapier Dropbox Carica file: Spazio predefinito, Cartella /pdf4meoutput, File 3. URL file, Sovrascrivi no, Specifica nome file 3. Nome file: 10 pagine, Specifica estensione file 3. Estensione file: .pdf.

Mappa File al PDF4me URL del file output (Fase 3); separare Specificare il nome del file E Specificare l'estensione del file i campi conservano il nome originale.

Salva e fai clic Pubblicare. Lo Zap è attivo; invia una nuova fattura in /pdf4metest/Swiss-RP e il PDF con codice QR arriva in /pdf4meoutput entro il prossimo ciclo di votazioni.

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. first puts the slip as the new page 1. last appends it after the last page. Pass a 1-based page number to insert at that 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.
Upload writes a zero-byte or missing file
File field on Step 4 is not bound to the PDF4me File Url. Re-pick 3. File Url. Also confirm Specify File Name and Specify File Extension are mapped to the PDF4me Step 3 outputs, not hardcoded.
Want a standalone QR slip without a source invoice
Skip Step 2 (Find File). In Step 3, leave File and File URL empty and the action returns a standalone Swiss QR-bill PDF.

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 Swiss QR 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, publish the Zap, 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 Step 2 (Find File). In Step 3, leave File and File URL empty and the action returns a standalone Swiss QR-bill PDF (just the payment slip, no invoice body).
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 Create EPC QR Code action instead.
Address Type S vs K. which one should I pick?+
S (Structured) is the modern default: Postal Code 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 Postal Code/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, Make, 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 Swiss QR Bill action page.

Inizia​

Get your API KeyPDF4me on ZapierAction reference