Création d'une facture QR suisse dans n8n : Deux flux de travail complets (avec et sans PDF existant)
Chaque facture suisse doit comporter un Billet QR suisse (également appelé bordereau de paiement QR suisse) afin que les banques et les logiciels comptables puissent scanner et traiter le paiement automatiquement. n8n et PDF4me automatisent entièrement cette génération. Ce guide vous accompagne pas à pas. deux flux de travail prêts pour la productionL'une permet de superposer le reçu QR à un PDF existant déjà dans Dropbox, et l'autre de générer un document de facture QR autonome à partir des seules données de paiement, sans PDF de fond. La configuration des deux prend moins de 10 minutes.
Flux de travail A : Déclenchement. Téléchargement Dropbox récupéré Test Debt AG.pdf (344 ko). PDF4me Create SwissQR Bill fonctionne avec Type de données d'entrée : données binairesMontant 1000 CHF, IBAN CH0200700110003765824Créancier : Test AG. Résultat : facture_swissqr.pdf à 602 ko. Le téléchargement sur Dropbox enregistre le résultat.
Flux de travail B : Déclenchement. PDF4me Créer SwissQR Facture fonctionne avec Type de données d'entrée : Aucun, les mêmes champs de paiement plus une adresse complète et structurée du créancier. Le résultat est n8n_swissqr02.pdf à 132 ko. Le téléchargement sur Dropbox enregistre le résultat.
Le Type de données d'entrée Le champ dans le nœud PDF4me est la seule différence structurelle entre les deux flux de travail. Définissez-le sur Données binaires lorsque vous avez un PDF existant (Flux de travail A). Configurez-le pour Aucun Lorsque vous souhaitez un reçu QR autonome à partir des seules données de paiement (Workflow B), tous les autres paramètres (montant, IBAN, devise, nom du créancier) sont identiques.
Ce que vous êtes en train de construire
Toute facture suisse émise après la transition de 2020 du système de bordereau de paiement standard doit inclure une facture QR suisse : une section de paiement standardisée avec un code QR encodant l’IBAN, le montant, la devise, le créancier et, éventuellement, les données du débiteur au format ISO 20022. Les banques et les logiciels comptables la scannent automatiquement. Les deux flux de travail n8n présentés dans ce guide automatisent cette étape de génération : la facture QR est ainsi produite et enregistrée dans Dropbox sans intervention manuelle.
En un coup d'œil
Flux de travail A : 4 étapes
Flux de travail A : quatre nœuds, déclencheur de téléchargement pour créer une facture SwissQR (données binaires) à télécharger.
Flux de travail B : 3 étapes
Flux de travail B : trois nœuds, déclencheur pour créer une facture SwissQR (type de données d’entrée : aucun) à télécharger. Aucune étape de téléchargement n’est nécessaire.
Pourquoi deux flux de travail distincts ?
Le flux de travail A préserve votre modèle de facture personnalisé. PDF4me ajoute le bordereau QR suisse au PDF déjà enregistré dans Dropbox. Aucun reformatage, aucune refonte, aucune mise en page manuelle.
Le flux de travail B ignore complètement l'étape de téléchargement. Fournissez les données de paiement et PDF4me génère le reçu de paiement QR complet à partir de zéro. Aucun PDF de base n'est requis.
La seule différence structurelle est la Type de données d'entrée Champ : Données binaires pour le flux de travail A, aucun pour le flux de travail B. Le montant, l’IBAN, la devise et le nom du créancier sont configurés de la même manière dans les deux cas.
Avant de commencer
- n8n (cloud ou auto-hébergé). Créez un nouveau flux de travail vierge.
- Clé API PDF4me. Première configuration : Connectez PDF4me à n8n.
- Dropbox Identifiants OAuth2 dans n8n avec accès en lecture et en écriture à votre dossier de travail.
- Flux de travail A uniquement : Un PDF existant stocké dans Dropbox (par exemple,
Test Debt AG.pdfdans/Données du blog/SwissQR/). - Données de paiement : Un IBAN suisse valide (21 caractères, commence par
CH), le montant, la devise (CHF ou EUR), le nom du créancier et, pour le flux de travail B, l'adresse complète et structurée du créancier.
Flux de travail A : Créer une facture QR suisse sur un PDF existant (4 nœuds)
Utilisez cette fonction si vous possédez déjà une facture ou un document au format PDF. PDF4me superpose le code QR de la facture suisse au fichier.
Étape 1 : Téléchargez le PDF existant depuis Dropbox
Flux jusqu'à présent : Déclenchement.
- Ajoutez le Dropbox nœud.
- Titre de compétence : API OAuth2 de Dropbox.
- Ressource: Déposer. Opération: Télécharger.
- Chemin du fichier : chemin d'accès à votre PDF dans Dropbox, par exemple :
Test Debt AG.pdf(dans cet exemple, le fichier se trouve sous/Données du blog/SwissQR/). - Insérez le fichier de sortie dans le champ :
données. - Exécutez l'étape. Le panneau OUTPUT devrait afficher le nom du fichier (
Test Debt AG.pdf), répertoire, type MIMEapplication/pdfet une taille de fichier de 344 ko.
Téléchargement Dropbox configuré avec le chemin du fichier Test Debt AG.pdf et placez le fichier de sortie dans le champ données. OUTPUT confirme que le fichier a été téléchargé à une taille de 344 ko.
Étape 2 : Créer une facture SwissQR à partir du PDF téléchargé
Flux jusqu'à présent : Déclenchez puis téléchargez le PDF.
Il s'agit de l'étape principale. PDF4me lit le fichier binaire PDF téléchargé et génère un nouveau PDF avec le QR code de la facture suisse intégré.
- Ajoutez le PDF4me nœud.
- Titre de compétence : Compte PDF4ME.
- Ressource: Facture. Opérations de facturation : Créer une facture SwissQR.
- Type de données d'entrée : Données binaires (car vous alimentez le PDF à partir du nœud précédent).
- Propriété binaire :
données(correspond au nom du champ de l'étape de téléchargement). - Nom de fichier:
Test Debt AG.pdf(le nom du fichier source). - Remplissez les champs de paiement :
- Montant:
1000 - Devise: Franc suisse
- IBAN :
CH0200700110003765824 - Nom du créancier :
Test AG
- Montant:
- Exécutez l'étape. Le panneau SORTIE affiche
facture_swissqr.pdf, type MIMEapplication/pdf, taille du fichier 602 kB (contre 344 kB auparavant car les pages de la fiche QR étaient intégrées).
Créer une facture SwissQR avec des données d'entrée de type binaire. L'entrée est un fichier PDF de 344 ko provenant de Dropbox. La sortie est : facture_swissqr.pdf à 602 ko. L'augmentation de taille confirme que le code QR a été intégré.
Étape 3 : Téléversez le résultat sur Dropbox
Flux jusqu'à présent : Déclenchez puis téléchargez le PDF puis créez la facture SwissQR.
- Ajouter un autre Dropbox nœud.
- Titre de compétence : API OAuth2 de Dropbox.
- Ressource: Déposer. Opération: Télécharger.
- Chemin du fichier : chemin de destination dans Dropbox, par exemple :
/Données du blog/SwissQR/swissqr_bill.pdf. - Fichier binaire : Sur.
- Champ binaire d'entrée :
données(le résultat de la facture SwissQR de l'étape précédente). - Exécutez la commande. Dropbox renvoie les métadonnées de chargement confirmant le nom et le chemin du fichier.
Le processus A est terminé. Votre PDF existant contient désormais une facture QR suisse et a été enregistré dans Dropbox.
Flux de travail B : Créer une facture QR suisse autonome (3 nœuds)
Utilisez cette fonction si vous ne disposez pas d'un PDF de fond. PDF4me génère l'intégralité du reçu de paiement QR à partir des informations de paiement que vous saisissez directement dans le nœud.
Étape 1 : Créer une facture SwissQR sans PDF de fond
Flux jusqu'à présent : Déclenchement.
Comme il n'y a pas de fichier PDF en entrée, vous devez renseigner l'adresse complète du créancier afin que PDF4me puisse générer la mise en page complète de la facture QR suisse.
- Ajoutez le PDF4me nœud.
- Titre de compétence : Compte PDF4ME.
- Ressource: Facture. Opérations de facturation : Créer une facture SwissQR.
- Type de données d'entrée : Aucun (ceci indique à PDF4me de générer un bordereau QR autonome sans PDF de fond).
- Remplissez les champs de paiement :
- Montant:
1000 - Devise: Franc suisse
- IBAN :
CH0200700110003765824 - Nom du créancier :
Test AG - Type d'adresse du créancier : Structuré
- Nom ou adresse du créancier :
Test Strasse - Numéro de l'immeuble du créancier :
1 - Code postal du créancier :
8000 - Ville du créancier :
Zurich
- Montant:
- Exécutez l'étape. Le panneau SORTIE affiche
facture_swissqr.pdfà 132 ko. Nettement plus petit que le flux de travail A (602 ko) car il n'y a pas de PDF en arrière-plan, seulement le coupon QR lui-même.
Créer une facture SwissQR sans spécifier de type de données d'entrée. L'adresse complète du créancier est requise car PDF4me génère la mise en page. Taille du fichier : 132 ko.
Étape 2 : Téléchargez la facture QR autonome sur Dropbox
Flux jusqu'à présent : Déclenchez ensuite la création de la facture SwissQR.
- Ajoutez le Dropbox nœud.
- Titre de compétence : API OAuth2 de Dropbox.
- Ressource: Déposer. Opération: Télécharger.
- Chemin du fichier :
/n8n_swissqr02.pdf(ou n'importe quel chemin dans votre Dropbox). - Fichier binaire : Sur.
- Champ binaire d'entrée :
données. - Exécuter. Le panneau de sortie confirme le chargement :
nom : n8n_swissqr02.pdf,chemin_affichage : /n8n_swissqr02.pdf,taille : 132191, etest_téléchargeable : vrai.
Confirmation du téléchargement : nom n8n_swissqr02.pdf, chemin /n8n_swissqr02.pdf, taille 132191 octets, est_téléchargeable : vrai.
Le flux de travail B est terminé. Le PDF de la facture suisse avec code QR est disponible dans Dropbox et prêt à être envoyé par courriel ou joint à tout document sortant.
Quel flux de travail choisir ?
| Flux de travail A (avec PDF existant) | Flux de travail B (autonome) | |
|---|---|---|
| Nodes | 4 (trigger + download + QR + upload) | 3 (trigger + QR + upload) |
| Input Data Type | Binary Data | None |
| Requires existing PDF | Yes (in Dropbox or another source) | No |
| Output size (example) | 602 kB | 132 kB |
| Full creditor address required | No (name only shown in example) | Yes (Structured address required for layout) |
| Best for | Adding QR slip to finished invoices or letters | Sending a separate payment slip alongside any document |
Référence rapide : paramètres clés
| Nœud | Réglage des clés | Exemple de valeur |
|---|---|---|
| Dropbox Download (A only) | File Path + Put Output File in Field | Test Debt AG.pdf; data |
| PDF4me Create SwissQR Bill (A) | Input Data Type + Binary Property + File Name | Binary Data; data; Test Debt AG.pdf |
| PDF4me Create SwissQR Bill (A and B) | Amount + Currency + IBAN + Creditor Name | 1000; Swiss Franc; CH0200700110003765824; Test AG |
| PDF4me Create SwissQR Bill (B only) | Input Data Type | None |
| PDF4me Create SwissQR Bill (B only) | Creditor Address Type + Street + Number + Postal Code + City | Structured; Test Strasse; 1; 8000; Zurich |
| Dropbox Upload (A) | File Path + Binary File + Input Binary Field | /Blog Data/SwissQR/swissqr_bill.pdf; On; data |
| Dropbox Upload (B) | File Path + Binary File + Input Binary Field | /n8n_swissqr02.pdf; On; data |
Cas d'utilisation
Lot de factures mensuelles : Récupérez une liste de factures au format PDF depuis Dropbox, puis parcourez-les à l'aide d'une boucle. n8n Divisé en lots Pour chaque nœud, exécutez le flux de travail A et enregistrez les résultats dans un dossier distinct. Une seule exécution couvre le mois entier.
Reçus de paiement dynamiques issus d'une base de données : Déclencher une action via webhook lors de la création d'une demande de paiement. Récupérer le montant, l'IBAN et les données du créancier depuis une base de données Postgres ou Airtable. Utiliser le workflow B pour générer le reçu QR et l'envoyer automatiquement par e-mail (Gmail ou Outlook).
Factures de loyer et de services publics : Générez des coupons QR autonomes (Workflow B) pour le loyer, les charges ou les cotisations mensuelles. Stockez-les dans Dropbox et joignez-les aux e-mails envoyés depuis n8n. Aucun PDF de fond n'est requis.
Auto-hébergé et sur site : Déployez n8n sur votre propre infrastructure. Les données de paiement ne quittent jamais votre réseau, sauf lors de l'appel à l'API PDF4me. Combinez-le avec des partages de fichiers locaux ou un NAS au lieu de Dropbox.
Foire aux questions
Quand dois-je utiliser le flux de travail A plutôt que le flux de travail B ?
Utiliser Flux de travail A Lorsque vous possédez déjà un document PDF finalisé (une facture, une lettre, tout autre fichier) auquel vous souhaitez ajouter un bordereau QR suisse, PDF4me insère le bordereau QR dans votre fichier existant. Flux de travail B Lorsque vous ne disposez que des données de paiement (IBAN, montant, coordonnées du créancier) et que vous souhaitez un reçu de paiement au format PDF avec code QR, le flux de travail B génère le document complet sans nécessiter de PDF de base.
Quel format IBAN est requis pour la facture QR suisse ?
L'IBAN doit être valide. IBAN suisse: exactement 21 caractères, commençant par CH, suivis de deux chiffres de contrôle et du numéro de compte bancaire à 17 chiffres. Exemple : CH0200700110003765824La norme QR suisse prend également en charge les QR-IBAN (commençant par CH et en utilisant la plage 3000 à 3199 pour l'identifiant bancaire). Un IBAN invalide ou non suisse provoque une erreur de validation de l'API PDF4me avant la génération de tout PDF.
Pourquoi le flux de travail B exige-t-il une adresse complète du créancier alors que le flux de travail A n'en a pas besoin ?
Lorsque vous utilisez le type de données d'entrée Données binaires (Flux de travail A) PDF4me ajoute le bordereau QR à un PDF existant et la mise en page conserve le contexte visuel du document source. L'adresse du créancier est facultative car la section du bordereau QR est ajoutée et non générée ex nihilo. Lorsque vous utilisez le type de données d'entrée Aucun (Flux de travail B) PDF4me génère la mise en page complète du document. La norme suisse relative aux QR codes exige qu'une facture QR autonome contienne l'adresse complète du créancier (rue, numéro d'immeuble, code postal, ville) dans les données du QR code afin que les systèmes de paiement puissent la traiter sans autre contexte documentaire.
Puis-je utiliser des données de paiement dynamiques provenant d'une base de données ou d'un formulaire au lieu de valeurs codées en dur ?
Oui. Dans n8n, tout champ du nœud PDF4me accepte des expressions. Associez les champs Montant, IBAN, Nom du créancier et Ville à partir d'un nœud précédent, comme une requête Postgres, un enregistrement Airtable, une ligne Google Sheets, une soumission de formulaire via le déclencheur de formulaire n8n ou une charge utile webhook. Chaque exécution génère ensuite une facture QR unique pour l'article en cours, sans aucune modification manuelle du flux de travail. Il s'agit de l'approche recommandée pour l'automatisation de la facturation en production.
Le nœud PDF4me renvoie une erreur. Que dois-je vérifier en premier ?
Vérifiez trois éléments dans cet ordre. D'abord, veuillez confirmer que votre clé API est active sur dev.pdf4me.com et votre compte présente des crédits. DeuxièmePour le flux de travail B, vérifiez que les quatre champs d'adresse du créancier (rue, numéro d'immeuble, code postal, ville) sont renseignés lorsque le type d'adresse du créancier est structuré. L'absence d'un seul champ entraîne un échec de validation. TroisièmePour le flux de travail A, vérifiez que l'étape de téléchargement Dropbox s'est déroulée correctement et que le nom de la propriété binaire dans le nœud PDF4me correspond au nom du champ défini dans le nœud de téléchargement (les deux doivent être identiques). données).
Dépannage
Le nœud Dropbox Upload recherche un champ appelé données Par défaut, si le nœud « Créer une facture SwissQR » utilise un nom de champ binaire de sortie différent, mettez à jour le champ binaire d'entrée du nœud « Télécharger » en conséquence. Pour éviter ce problème, utilisez le même nom de champ dans tous les nœuds.
L'IBAN doit être un IBAN suisse valide commençant par CH (21 caractères). Pour le flux de travail B, les quatre champs d'adresse du créancier (rue, numéro d'immeuble, code postal, ville) doivent être renseignés lorsque le type d'adresse du créancier est structuré. L'absence d'un seul de ces champs entraîne un échec de validation.
Vérifiez le chemin d'accès au fichier dans le nœud Téléchargement. Les chemins d'accès Dropbox sont sensibles à la casse pour certains comptes. Ouvrez votre Dropbox et copiez le chemin d'accès exact, y compris le nom du dossier et l'extension du fichier. Si le fichier se trouve dans un sous-dossier, le chemin d'accès doit inclure l'arborescence complète, par exemple : /Données du blog/SwissQR/Test Debt AG.pdf.
Voir Dépannage de PDF4me pour les étapes de vérification de votre clé API, de vérification des crédits restants et de reconnexion des informations d'identification dans n8n.
Que faire ensuite ?
Facultatif : remplacer la gâchette. Remplacer la gâchette manuelle par une… Calendrier pour les facturations mensuelles, un Webhook déclencher lors de la création d'une demande de paiement, ou Dropbox sur le fichier créé Traiter automatiquement les nouveaux fichiers PDF dès leur arrivée.