Aller au contenu principal

Ajouter une facture QR suisse à n'importe quelle facture PDF dans Make : un flux de travail Dropbox en 3 modules

· 21 minutes de lecture
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 Make et PDF4me, cette fonctionnalité est un atout supplémentaire. scénario à trois modulesDropbox Télécharger un fichier, PDF4me Créer une facture QR suisse, Dropbox Téléverser un fichierLes captures d'écran ci-dessous illustrent le déroulement exact présenté sur le canevas : une facture de 10 pages à /pdf4metest/Files/10 page.pdf devient une facture conforme aux normes suisses, avec le bordereau de paiement annexé et enregistré dans /pdf4meoutput/Prêt pour la production en moins de 10 minutes.

Aperçu du scénario
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 version courte

Trois modules Make. Dropbox Télécharger un fichier récupère la facture source (la capture d'écran le montre) YnooxTestone connexion, Sélectionnez un fichier, chemin /pdf4metest/Fichiers/10 page.pdfPDF4me 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, IBAN commençant par CH(blocage complet des créanciers et des débiteurs). Dropbox Téléverser un fichier écrit le résultat dans /pdf4meoutput/ avec le fichier défini sur Carte, Nom du fichier = 6. Nom, Données = 6. DocumentLe fichier PDF généré est prêt à être envoyé par e-mail et scanné par le scanner de code QR de n'importe quelle application mobile de banque suisse.

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 une 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, définissez le type de référence sur 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 ? » Déposez la facture dans Dropbox ; ce scénario en 3 modules s'occupe du reste, y compris l'IBAN, le montant, la référence et les informations du créancier/débiteur.
  • « Make peut-il générer une facture QR suisse à partir d'une facture existante ? » Oui, via le module PDF4me Create Swiss QR-bill. 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 page spécifique).
  • « Ai-je besoin d'un modèle Excel ou d'une bibliothèque de codes QR ? » Non. Le module masque toute la génération de codes QR, les calculs de référence modulo 10 et la mise en page des normes de paiement suisses derrière une seule étape configurable.
  • « Que se passe-t-il si je ne dispose pas d'une facture PDF existante ? Puis-je tout de même générer un bordereau QR autonome ? » Oui. Ignorez complètement le groupe Fichier et le module renverra un PDF autonome de facture suisse avec QR code.
  • « Les banques suisses accepteront-elles réellement ces résultats ? » Le module génère un reçu conforme à la norme suisse ISO 20022 relative aux paiements. Toutes les applications de banque mobile suisse peuvent le scanner pour initier un paiement.

Ce que vous êtes en train de construire

Scénario Make réutilisable en 3 modules. Lorsqu'un déclencheur s'active (manuel, planifié, surveillance de fichier, etc.), la facture source est extraite, le QR code suisse est ajouté et le résultat est enregistré. Ce même modèle s'applique aux tests ponctuels, aux traitements par lots planifiés et au traitement de factures entièrement événementiel.

Création d'un canevas de scénario : téléchargement d'un fichier Dropbox (avec badge d'horloge programmé) connecté à PDF4me ; création d'une facture QR suisse, elle-même connectée à Dropbox ; chargement d'un fichier. Trois grandes icônes de module circulaires reliées par des connecteurs en pointillés standard.

Trois modules intégrés. L'icône d'horloge sur Dropbox 1 indique un déclenchement programmé. Choisissez entre le mode manuel et le webhook selon vos besoins.


Ce dont vous avez besoin

  • Faire compte avec un scénario ouvert. Créer un compte si vous en avez besoin.
  • Clé API PDF4me. Obtenez votre clé API et ajoutez-le lorsque PDF4me vous demande une connexion. Voir Connectez-vous à PDF4me pour créer.
  • Dropbox avec un dossier source (par exemple, /pdf4metest/Fichiers/) et un dossier de sortie (/pdf4meoutput/N'importe quel espace de stockage fonctionne de la même manière. Utilisez Google Drive, OneDrive ou SharePoint selon vos besoins.
  • Une facture au format PDF (les captures d'écran utilisent 10 pages.pdf). Facultatif : ignorer le fichier source et générer un reçu 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.

Élaborez le scénario

Module 1 : Dropbox - Télécharger un fichier

Récupérez la facture source depuis votre dossier d'entrée.

ChampValeur utilisée dans cette exécution
ConnectionYnooxTestone (ynoox.test...). your Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Files/10 page.pdf
Configurer Dropbox pour télécharger un fichier. Connexion : YnooxTestone. Mode de sélection : Sélectionner un fichier. Chemin d'accès : /pdf4metest/Files/10 page.pdf. Boutons Annuler et Enregistrer en bas.

Configuration de téléchargement de fichier Dropbox. Sélectionnez le fichier via le sélecteur de chemin ou, pour le traitement par lots, utilisez Fichiers de recherche et lier le fichier dynamiquement.

Module 2 : PDF4me – Créer une facture QR suisse

Rechercher PDF4me et choisir Créer une facture QR suisseLe module expose 26 champs. La documentation complète par champ (avec 5 captures d'écran détaillées de l'interface utilisateur et des exemples de valeurs comme Var Schneider AG, CH4431999123000889012, Pia-Maria Rutschmann-Schnyder) se trouve sur le site web. Créer une facture SwissQR dans Make Page d'action. Configuration minimale requise :

GroupeChampValeur
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

Remplissez les champs d'adresse du créancier et du débiteur selon votre choix de type d'adresse, puis tous les paramètres facultatifs de référence / message non structuré / informations de facturation / AV1 / AV2.

Module 3 : Dropbox - Téléverser un fichier

Enregistrez le fichier PDF rempli dans le dossier de sortie.

ChampValeur utilisée dans cette exécution
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)
Configurer le chargement d'un fichier Dropbox. Connexion : YnooxTestone. Dossier : /pdf4meoutput/. Fichier : Mapper. Nom du fichier : Nom (issu de PDF4me Create Swiss QR-bill). Données : Document. Remarque : Nom du fichier, extension comprise, par exemple : invoice.xml.

La radio File réglée sur Carte Expose le nom et les données du fichier comme des champs distincts. Liez-les aux sorties du module 2 de PDF4me afin que le PDF rempli soit enregistré intact.

Enregistrer et cliquer Exécuter une foisLa facture complétée apparaîtra dans /pdf4meoutput/ en quelques secondes.


Ce qui se retrouve dans le dossier de sortie

Un seul PDF nommé d'après la source (par exemple, 10 page.pdf) avec la page de facture QR suisse insérée à la position choisie dans Options de pagination (First la place en tant que nouvelle page 1 ; Last (Il est ajouté à la fin). Ouvrez le fichier dans n'importe quel lecteur PDF : la section « QR-facture » affiche le code QR de paiement, le numéro de compte/de bénéficiaire (lisible par un humain), le montant, la devise, la référence et les adresses du créancier et du débiteur. Scannez le code QR avec une application bancaire suisse : le paiement est prérempli.


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. 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.

Dépannage

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.

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 via this scenario.
e-Bill replacements / fallbacks
For customers who prefer paper or in-app QR-scan over the electronic Bill flow.

Que lire ensuite ?


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.

Commencer