Aller au contenu principal
API PDF4meIntégrationsBase de connaissancesExtensionsTesteur d'APIBlog

Ajouter une facture QR suisse à n'importe quelle facture PDF dans Zapier : un flux de travail Dropbox en 4 étapes

· 22 minutes de lecture
Sankalp Mishra
SEO and Content Writer

Chaque facture suisse doit comporter un Billet QR suisse Ainsi, les banques et les logiciels comptables peuvent scanner et traiter automatiquement le paiement. Avec Zapier et PDF4me, cette fonctionnalité est un atout supplémentaire. Zap en quatre étapesDropbox Nouveau fichier dans le dossier, Dropbox Trouver un fichier, PDF4me Créer une facture QR suisse, Dropbox Téléverser un fichierLes captures d'écran ci-dessous illustrent précisément le déroulement de l'exécution capturée dans le canevas : une facture de 10 pages. /pdf4metest/Swiss-RP devient une facture conforme aux normes suisses, avec le bordereau de paiement annexé et enregistré dans /pdf4meoutputPrêt pour la production en moins de 10 minutes.

Le Zap en bref
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 version courte

Quatre étapes Zap. Dropbox Nouveau fichier dans le dossier montres /pdf4metest/Swiss-RP (Espace par défaut, Inclure les fichiers dans les sous-dossiers) FAUXInclure le contenu du fichier et le lien de partage. OuiDropbox Trouver un fichier regarde vers le haut 10 pages.pdf dans /pdf4metest/Fichiers et renvoie le fichier binaire. PDF4me Créer une facture QR suisse ajoute une page de facture QR conforme aux normes suisses de paiement (Type de format PDF, Options de pagination d'abord, Devise CHF, Type de référence QRR, Langue Anglais, Séparateur Ligne avec des ciseaux, Montant 1923,67IBAN CH4431999123000889012Créancier : Var Schneider AG, Débiteur ultime : Pia-Maria Rutschmann-Schnyder, Référence 210000000003139471430009017Dropbox Téléverser un fichier écrit le PDF rempli dans /pdf4meoutput en utilisant 3. URL du fichier, avec 3. Nom du fichier et 3. Extension de fichier comme nom de sortie. Le résultat est un PDF scannable par les banques suisses, situé dans le dossier d'archive.

Deux éléments déterminent si votre document est scannable par une banque.

Premièrement, le L'IBAN doit commencer par CH ou LI. et comporter au maximum 21 caractères. Pour un type de référence QRR, l'IBAN doit être un QR-IBAN, pas un IBAN standard. Deuxièmement, lorsque Le type de référence est QRR, le Le champ de référence est une chaîne numérique de 27 chiffres avec un chiffre de contrôle modulo 10.; si vous n'en avez pas, changez le type de référence en SCORE (ISO 11649) ou NON Laissez le champ Référence vide. Les banques rejettent les valeurs de référence mal saisies, et non l'image QR.

Ce produit répond à des questions courantes du monde réel​

Les internautes recherchent précisément ce problème en utilisant des expressions comme :

  • « Comment ajouter automatiquement un code QR suisse à ma facture PDF dans Zapier ? » Ce Zap en 4 étapes fait tout : le fichier est enregistré dans Dropbox, le Zap s'exécute, et le PDF enrichi d'un code QR est enregistré dans le dossier de sortie.
  • « Zapier peut-il générer une facture QR suisse à partir d'une facture existante ? » Oui, via l'action PDF4me « Créer une facture QR suisse ». Le résultat est le même PDF avec le reçu de paiement ajouté à la page de votre choix (première, dernière ou une page spécifique).
  • « Ai-je besoin d'une bibliothèque de codes QR ou d'un abonnement à un générateur de codes QR suisse ? » Non. L'action PDF4me masque la génération de QR code, les calculs de référence modulo 10 et la mise en page complète des normes de paiement suisses derrière une seule étape Zapier.
  • « Que se passe-t-il si je ne dispose pas d'un fichier PDF source, puis-je générer un bordereau QR autonome ? » Oui. Ignorez l'étape 2 (Rechercher un fichier) et les champs Fichier / URL du fichier à l'étape 3. L'action renvoie un PDF de facture QR suisse autonome à partir des seules données de paiement.
  • « Les banques suisses accepteront-elles cette production ? » Cette opération génère un reçu conforme à la norme suisse ISO 20022 relative aux paiements. Toutes les applications de banque mobile suisses peuvent le scanner pour initier un paiement.

Ce que vous êtes en train de construire​

Un Zap Zapier réutilisable en 4 étapes. Le déclencheur surveille un dossier Dropbox, le Zap trouve la facture la plus récente, exécute l'action PDF4me Swiss QR Bill avec les informations du créancier, du débiteur et du paiement, puis télécharge le PDF enrichi dans un dossier de sortie. Ce même processus s'applique aux factures clients sortantes, aux traitements par lots planifiés ou au traitement automatisé des comptes clients.

Utilisation de Zapier avec quatre étapes : création d’un nouveau fichier dans un dossier Dropbox (intervalle de 2 min), recherche de fichier dans Dropbox, création d’une facture SwissQR avec PDF4me, chargement du fichier dans Dropbox. La bannière d’état indique « Réussi le 1er juin 2026 à 13h00:20 » avec l’ID d’exécution.

Quatre étapes de haut en bas. L'intervalle de 2 minutes à l'étape 1 correspond à la fréquence d'interrogation par défaut de Zapier pour les déclencheurs Dropbox ; les forfaits supérieurs permettent une interrogation plus fréquente.

Ce dont vous avez besoin​

  • Zapier compte. Créer un compte Zapier si vous en avez besoin.
  • Clé API PDF4me. Obtenez votre clé API et ajoutez-le lorsque PDF4me vous demande un compte dans l'éditeur Zap. Voir Connectez PDF4me à Zapier.
  • Dropbox avec un dossier source (par exemple, /pdf4metest/Swiss-RP) et un dossier de sortie (/pdf4meoutput).
  • Une facture au format PDF (les captures d'écran utilisent 10 pages.pdf). Facultatif : ignorer le fichier source pour un bordereau QR autonome à partir des seules données de paiement.
  • données de paiement suisses: un CH ou LI IBAN, montant, devise (CHF ou EUR), et les blocs nom/adresse du créancier et du débiteur. Référence complète du champ dans le documents d'action.

Guide de référence rapide : paramètres clés​

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.

Créez le Zap​

Étape 1 : Dropbox - Nouveau fichier dans le dossier (déclencheur)​

Surveillez le dossier source pour les nouvelles factures.

ChampValeur utilisée dans cette exécution
SpaceDefault
Folder/pdf4metest/Swiss-RP
Include files in subfolders?False
Include file contents?Yes
Include sharing link?Yes
Déclencheur Zapier Dropbox Nouveau fichier dans le dossier : Espace par défaut, Dossier /pdf4metest/Swiss-RP, Inclure les fichiers dans les sous-dossiers Non, Inclure le contenu du fichier Oui, Inclure le lien de partage Oui.

Étape 2 : Dropbox - Rechercher un fichier​

Résolvez le fichier par son nom. Cela vous fournit une référence de fichier stable et exploitable pour l'étape 3.

ChampValeur utilisée dans cette exécution
SpaceDefault
Folder/pdf4metest/Files
Include files in subfolders?False
File Name10 page.pdf
Include Deleted Files?False
Include file contents?Yes
Recherche de fichier Zapier Dropbox : Espace par défaut, Dossier /pdf4metest/Files, Nom du fichier 10 page.pdf, Inclure les fichiers supprimés : Non, Inclure le contenu du fichier : Oui.

Étape 3 : PDF4me - Créer une facture SwissQR​

L'action qui produit le travail. Rechercher PDF4me dans le sélecteur d'actions, choisissez Créer une facture QR suisse, puis remplissez les champs exactement comme indiqué sur les captures d'écran du référence d'action Afficher. Le minimum requis pour correspondre à cette exécution :

GroupeChampValeur
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

Étape 4 : Dropbox - Téléverser un fichier​

Enregistrez le PDF rempli dans le dossier de sortie.

ChampValeur utilisée dans cette exécution
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)
Téléchargement de fichier Zapier Dropbox : Espace par défaut, Dossier /pdf4meoutput, Fichier 3. URL du fichier, Écraser non, Spécifier le nom du fichier 3. Nom du fichier : 10 pages, Spécifier l’extension du fichier 3. Extension du fichier : .pdf.

Carte Déposer au PDF4me URL du fichier sortie (étape 3) ; séparée Spécifiez le nom du fichier et Spécifiez l'extension du fichier Les champs conservent leur nom d'origine.

Enregistrer et cliquer PublierLe Zap est en ligne ; déposez une nouvelle facture dans /pdf4metest/Swiss-RP et le PDF enrichi par QR-bill arrive dans /pdf4meoutput au cours du prochain cycle électoral.

Get your API KeyFull action reference

Dépannage​

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.

Quand utiliser ce modèle​

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.

Que lire ensuite ?​

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.

Commencer​

Get your API KeyPDF4me on ZapierAction reference