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

Ajouter une facture QR suisse à n'importe quelle facture PDF dans Power Automate : un workflow Dropbox en 4 étapes

· 21 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 Power Automate et PDF4me, cette fonctionnalité est un atout supplémentaire. flux à quatre actionsDéclenchement manuel, Dropbox Récupérer le contenu du fichier, PDF4me Code-barres - Créer une facture SwissQR, Dropbox Créer un fichierLes captures d'écran ci-dessous illustrent le déroulement exact de la tâche capturée dans le canevas. Une facture de 10 pages dans /pdf4metest/sample devient une facture conforme aux normes suisses, avec le bordereau de paiement joint et téléchargée sur /pdf4meoutput avec un nom de fichier unique. Prêt pour la production en moins de 10 minutes.

Aperçu du flux
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 version courte

Quatre actions Power Automate. Un déclenchement manuel lance le flux. Dropbox Récupérer le contenu du fichier lectures /pdf4metest/sample/10 page.pdf avec l'option « Inférer le type de contenu » activée. PDF4me Code-barres - Créer une facture SwissQR ajoute une page de facture QR conforme aux normes suisses de paiement (Type de format de sortie PNG dans cette exécution ; passer à PDF pour la sortie hybride, IBAN CH4431999123000889012, Montant 5253531, Devise CHF, Type de référence QRR, Langue AnglaisLigne de séparation Ligne avec des ciseauxCréancier : Var Schneider AG, Débiteur ultime : Pia-Maria Rutschmann-Schnyder, Référence 210000000003139471430009017, Options de pagination coutume, Numéro de page 3, Nom de fichier abc.pdfDropbox Créer un fichier écrit à /pdf4meoutput avec un nom de fichier construit à partir de guid() + en-têtes/Nom de fichier Pour garantir son unicité, le fichier de sortie, lisible par les banques suisses, se trouve 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 Power Automate ? » Ce flux en 4 étapes permet de réaliser cette opération : déposer un PDF dans Dropbox, déclencher le flux, et le fichier enrichi d'un code QR est enregistré dans le dossier de sortie.
  • « Power Automate peut-il générer une facture QR suisse à partir d'une facture existante ? » Oui, via l'action PDF4me Barcode - Create SwissQR Bill. Le résultat est le même PDF avec le reçu ajouté en première/dernière/sur 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 Power Automate.
  • « 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 les champs Contenu du fichier et Nom du fichier sous Paramètres avancés ; l’action renvoie une facture QR autonome dans le format de sortie choisi (PDF / PNG / JPEG / Tiff).
  • « 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 flux Power Automate réutilisable en 4 étapes. Le déclencheur s'active, la facture source est extraite de Dropbox (ou SharePoint/OneDrive/Outlook), l'action PDF4me ajoute le code QR, et le fichier ainsi rempli est importé avec un nom préfixé par un GUID. Ce même modèle s'applique aux factures clients sortantes, aux traitements par lots planifiés et au traitement des comptes clients déclenché par des événements.

Canevas de flux Power Automate avec quatre actions : Déclencher manuellement un flux, Récupérer le contenu d'un fichier Dropbox, Code-barres - Créer une facture SwissQR, Créer un fichier Dropbox.

Quatre actions, de haut en bas. La gâchette manuelle facilite le test du flux ; elle peut être remplacée par n’importe quelle gâchette à mémoire en production.

Ce dont vous avez besoin​

  • Power Automate compte avec un flux ouvert. Ouvrir Power Automate.
  • Clé API PDF4me. Obtenez votre clé APIConnectez-vous au connecteur PDF4me Connect la première fois que vous déposez l'action.
  • Dropbox avec un dossier source (par exemple, /pdf4metest/sample) et un dossier de sortie (/pdf4meoutputN'importe quel système de stockage fonctionne : SharePoint, OneDrive ou Dataverse sont mappés de la même manière.
  • Une facture au format PDF. Téléchargez l'extrait de 10 pages utilisé dans les captures d'écran pour suivre exactement.
  • 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​

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.

Construisez le flux​

Action 1 : Déclencher manuellement un flux​

Le déclenchement manuel est la méthode de test la plus rapide. En production, remplacez par Dropbox Lorsqu'un fichier est créé, SharePoint Lorsqu'un fichier est créé, OneDrive Lorsqu'un fichier est créé, Outlook Lorsqu'un nouveau courriel arrive, Récurrence, ou Webhooks en fonction de votre pipeline AR.

Action 2 : Dropbox - Obtenir le contenu du fichier​

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

ChampValeur utilisée dans cette exécution
File/pdf4metest/sample/10 page.pdf
Infer Content TypeYes
Action Power Automate Dropbox « Obtenir le contenu du fichier » avec le fichier /pdf4metest/sample/10 page.pdf et le paramètre avancé « Déduire le type de contenu » : Oui.

Action 3 : Code-barres PDF4me - Créer une facture SwissQR​

Rechercher PDF4me et choisir Code-barres - Créer une facture SwissQRCette action affiche les champs de paiement dans le panneau principal et 4 champs sous Paramètres avancés (Options de pagination, Numéro de page, Contenu du fichier, Nom du fichier). Configurer :

GroupeChampValeur
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

Action 4 : Dropbox - Créer un fichier​

Enregistrez le fichier rempli dans le dossier de sortie. Créez un nom de fichier unique avec guid() pour éviter les conflits entre les rediffusions.

ChampValeur utilisée dans cette exécution
Folder Path/pdf4meoutput
File Nameguid() + headers/FileName (concat expression for a unique-per-run name)
File ContentFile Content (from Action 3, dynamic content)
Action Power Automate Dropbox Créer un fichier avec le chemin du dossier /pdf4meoutput, le nom du fichier construit à partir de l'expression guid() + headers/FileName et le contenu dynamique du fichier provenant de l'action PDF4me Créer une facture SwissQR.

Le guid() L'expression dans le nom de fichier garantit un nom unique à chaque exécution. Déposez-la à côté de en-têtes/Nom de fichier Le nom de la facture d'origine est conservé dans le nom du fichier généré par PDF4me.

Enregistrer et cliquer TestLe fichier scannable par les banques suisses atterrit dans /pdf4meoutput.

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

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

Commencer​

Get your API KeyPDF4me ConnectAction reference