Passa al contenuto principale

Aggiungere un codice QR svizzero a qualsiasi fattura PDF in Make: un flusso di lavoro Dropbox in 3 moduli

· 21 minuti di lettura
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 Make e PDF4me, l'aggiunta è un scenario a tre moduli: Dropbox Scarica un file, PDF4me Crea una fattura QR svizzeraDropbox Carica un file. Gli screenshot qui sotto illustrano l'esecuzione esatta mostrata nella tela: una fattura di 10 pagine a /pdf4metest/Files/10 page.pdf diventa una fattura conforme alla normativa svizzera con la ricevuta di pagamento allegata e salvata su /pdf4meoutput/Pronto per la produzione in meno di 10 minuti.

Riepilogo dello scenario
1. Dropbox Download a File
Reads /pdf4metest/Files/10 page.pdf. Scheduled trigger (clock badge) is shown but any trigger works.
2. PDF4me Create Swiss QR-bill
Appends the QR payment slip to the source PDF. Currency, IBAN, creditor + debtor blocks, reference filled out.
3. Dropbox Upload a File
Writes the populated PDF to /pdf4meoutput/. File Name and Data mapped from the prior step.
La versione breve

Tre moduli Make. Dropbox Scarica un file estrae la fattura sorgente (lo screenshot mostra YnooxTeststone connessione, Seleziona un file, sentiero /pdf4metest/Files/10 page.pdf). 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, IBAN che inizia con CH, blocchi completi creditori + debitori). Dropbox Carica un file scrive il risultato a /pdf4meoutput/ con File impostato su Mappa, Nome file = 6. Nome, Dati = 6. DocumentIl file PDF generato è pronto per essere inviato via email e per essere scansionato tramite lo scanner di codici QR dell'app mobile di qualsiasi banca svizzera.

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, imposta Tipo di riferimento su 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?" Carica la fattura su Dropbox; questo scenario in 3 moduli si occuperà del resto, inclusi IBAN, importo, riferimento e dettagli del creditore/debitore.
  • "È possibile generare una fattura con codice QR svizzero a partire da una fattura esistente?" Sì, tramite il modulo PDF4me Create Swiss QR-bill. Il risultato è lo stesso PDF con la ricevuta di pagamento allegata sulla pagina che preferisci (prima, ultima o specifica).
  • "Ho bisogno di un modello Excel o di una libreria di codici QR?" No. Il modulo nasconde tutta la generazione del codice QR, i calcoli di riferimento modulo 10 e il layout degli standard di pagamento svizzeri dietro un unico passaggio configurabile.
  • "E se non dispongo di una fattura PDF esistente? Posso comunque generare un codice QR separato?" Sì. Saltando completamente il gruppo File, il modulo restituisce un PDF autonomo con codice QR della fattura svizzera.
  • "Le banche svizzere accetteranno davvero questi risultati?" Il modulo 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 scenario Make riutilizzabile a 3 moduli. Quando si verifica un trigger (manuale, pianificato, monitoraggio file, qualsiasi), viene recuperata la fattura di origine, viene aggiunto il codice QR svizzero e l'output viene salvato. Lo stesso schema funziona per test singoli, esecuzioni batch pianificate o elaborazione delle fatture completamente basata su eventi.

Crea scenario canvas: Scarica un file da Dropbox (con badge orologio programmato) collegato a PDF4me Crea fattura QR svizzera, che è collegato a Carica un file da Dropbox. Tre grandi icone circolari del modulo collegate con i connettori standard Make tratteggiati.

Tre moduli end-to-end. L'icona dell'orologio su Dropbox 1 indica un trigger programmato. Passa alla modalità manuale o webhook a seconda delle tue esigenze.


Ciò di cui hai bisogno

  • Fare account con uno scenario aperto. Crea un account Make se ne hai bisogno.
  • Chiave API di PDF4me. Ottieni la tua chiave API e aggiungilo quando PDF4me richiede una connessione. Vedi Collega PDF4me per creare.
  • Dropbox con una cartella sorgente (ad esempio /pdf4metest/Files/) e una cartella di output (/pdf4meoutput/Qualsiasi servizio di archiviazione funziona allo stesso modo. Passa a Google Drive, OneDrive o SharePoint a seconda delle necessità.
  • Una fattura in formato PDF (gli screenshot utilizzano 10 pagine.pdf). Opzionale: salta il file sorgente e genera 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.

Costruisci lo scenario

Modulo 1: Dropbox - Scaricare un file

Recupera la fattura originale dalla cartella di input.

CampoValore utilizzato in questa esecuzione
ConnectionYnooxTestone (ynoox.test...). your Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Files/10 page.pdf
Configura Dropbox per scaricare un file. Connessione impostata su YnooxTestone. Modalità di selezione dei file impostata su Seleziona un file. Percorso file /pdf4metest/Files/10 page.pdf. Pulsanti Annulla e Salva in basso.

Configurazione di Dropbox Download di un file. Seleziona il file tramite il selettore di percorso oppure, per l'elaborazione in batch, utilizza Cerca file e collegare il file dinamicamente.

Modulo 2: PDF4me - Creazione di una fattura con codice QR svizzero

Cerca PDF4me e scegliere Crea una fattura QR svizzeraIl modulo espone 26 campi. Il riferimento completo per campo (con 5 schermate dettagliate dell'interfaccia utente e valori di esempio come Var Schneider AG, CH4431999123000889012, Pia-Maria Rutschmann-Schnyder) si trova su Crea fattura SwissQR in Make pagina delle azioni. Il minimo da impostare:

GruppoCampoValore
SourceFileDropbox - Download a File (pulls from Module 1 automatically)
OutputFormat TypePDF
OutputPaging OptionsFirst (also: Last, or a specific 1-based page number)
PaymentCurrencyCHF (or EUR)
PaymentReference TypeQRR, SCOR, or NON
PaymentLanguageEnglish / German / French / Italian
PaymentSeparator LineLine With Scissor, Only Line, or No Line
PaymentAmounte.g. 1250.00
PaymentIBANCH or LI IBAN, max 21 chars
CreditorCreditor Address TypeS (Structured) or K (Combined)
CreditorCreditor NameCompany name on the account
DebtorUltimate Debtor AddressTypeS or K

Compila i campi relativi all'indirizzo del creditore e del debitore in base al tipo di indirizzo selezionato, quindi inserisci eventuali parametri facoltativi di riferimento, messaggio non strutturato, informazioni di fatturazione, AV1 e AV2.

Modulo 3: Dropbox - Carica un file

Scrivi il PDF compilato nella cartella di output.

CampoValore utilizzato in questa esecuzione
ConnectionYnooxTestone (ynoox.test...). same Dropbox connection as Module 1
Folder/pdf4meoutput/
FileMap (so File Name and Data come from the PDF4me step)
File Name6. Name (dynamic content from PDF4me Module 2)
Data6. Document (dynamic content from PDF4me Module 2)
Configura il caricamento di un file su Dropbox. Connessione YnooxTestone. Cartella /pdf4meoutput/. File impostato su Mappa. Nome file associato a 6. Nome (da PDF4me Create Swiss QR-bill). Dati associati a 6. Documento. Suggerimento: nome del file, inclusa l'estensione, ad esempio invoice.xml.

La radio File impostata su Mappa Espone il nome del file e i dati come slot separati. Collega entrambi agli output del modulo 2 di PDF4me in modo che il PDF compilato venga generato correttamente.

Salva e fai clic Eseguire una volta. La fattura compilata apparirà in /pdf4meoutput/ nel giro di un paio di secondi.


Cosa finisce nella cartella di output

Un singolo PDF denominato con il nome della fonte (ad esempio 10 page.pdf) con la pagina della fattura QR svizzera inserita nella posizione scelta in Opzioni di paginazione First lo imposta come nuova pagina 1; Last (lo aggiunge alla fine). Apri il file con qualsiasi visualizzatore PDF e la sezione QR-fattura mostrerà il codice QR di pagamento, il conto/beneficiario da bloccare in formato leggibile, l'importo, la valuta, il riferimento e gli indirizzi del creditore/debitore. Punta un'app bancaria svizzera sul codice QR e il pagamento verrà precompilato.


Riferimento rapido: parametri chiave

IBAN
CH or LI prefix, max 21 chars. QR-IBAN required for QRR references.
Currency
CHF or EUR only. Anything else is rejected by the 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 PostalCode + City). K = combined (full address in two AddressLines).
Paging Options
First, Last, or a 1-based page number. Decides where the QR-bill page lands.
AV1 / AV2
Alternative scheme parameters for eBill and similar. Format: Name AV1: UV;value;id.

Risoluzione dei problemi

QR-bill page is blank or the QR code is unreadable
The IBAN is invalid (must start with CH or LI, max 21 chars) or the Currency was something other than CHF / EUR. Both are hard requirements of the Swiss Payment Standards.
Reference Type QRR but the bank rejects the 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. Or pass a 1-based page number to insert at that position.
Creditor or Debtor address looks wrong on the slip
Mismatched Address Type. With type S, fill PostalCode + City and use AddressLine1/2 for street. With type K, leave PostalCode + City empty and put the full address into AddressLine1 + AddressLine2.
Upload writes a zero-byte file
File Name or Data in the Upload module is not bound to the PDF4me Module 2 outputs. Click the field and re-pick the dynamic content from Module 6 (PDF4me Create Swiss QR-bill).
Want a standalone QR slip without an invoice
Skip the source file entirely. Remove Dropbox Module 1, or leave the File group empty in the PDF4me module. The output is 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 via this scenario.
e-Bill replacements / fallbacks
For customers who prefer paper or in-app QR-scan over the electronic Bill flow.

Cosa leggere dopo


FAQ

Do I need a special Swiss QR library or font?+
No. The PDF4me Create Swiss QR-bill module bundles QR-code generation, the QR-bill fonts (Liberation Sans), the mod-10 reference math, and the Swiss Payment Standards layout. Configure the fields, click Run, 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 the File group in the PDF4me module and the output is a standalone Swiss QR-bill PDF (just the payment slip, no invoice body). Useful when the debtor only needs the slip, or when your invoice body comes from a different source.
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 module instead.
Address Type S vs K. which one should I pick?+
S (Structured) is the modern default: PostalCode and City go in separate fields; AddressLine1/2 carries the street. K (Combined) puts the full address in two free-text AddressLine fields and ignores PostalCode/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, Zapier, 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 SwissQR Bill action page.

Inizia