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

Factures suisses au format PDF avec code QR : renommez-les par créancier, montant ou référence dans n8n !

· 11 minutes de lecture
Sankalp Mishra
SEO and Content Writer

Vous recevez des PDF, des factures, des bordereaux de paiement, chacun comportant un code QR suisse indiquant le payeur, le montant et la référence. Vous souhaitez renommer ces fichiers avec ces informations afin de pouvoir les retrouver et les trier rapidement. Le traitement manuel est irréalisable à grande échelle.

La solution : un flux de travail n8n qui téléchargements le PDF utilise Lire le code QR suisse (PDF4me) pour extraire ces données de paiement structurées, fusions il avec le fichier, et téléchargements Il s'agit d'un nouveau fichier, avec un nouveau nom, par créancier, montant, référence ou tout autre critère nécessaire. Même fichier, nom de fichier amélioré, aucun renommage manuel.

Ce guide vous accompagne tout au long du processus : téléchargez le PDF, lisez son code QR suisse, puis fusionnez et téléchargez le fichier avec un nom construit à partir des données qui vous intéressent : nom et ville du créancier, montant et référence, ou coordonnées du débiteur.

Aperçu du flux​

Votre flux de travail n8n pour Renommage des PDF par données QR suisses Cela ressemble à ceci :

  1. Déclenchement: Manuellement pour les tests, ou automatisé (par exemple Dropbox, e-mail, webhook) lorsqu'un nouveau PDF est disponible.
  2. Télécharger un fichier: Récupère le PDF depuis votre source (par exemple, Dropbox) et l'affiche au format binaire dans un champ tel que document.
  3. Lire le code QR suisse (PDF4me) : Extrait les données des factures QR suisses à partir du PDF et génère des données structurées (swissQrData: créancier cr_Name, cr_City, cr_Country, débiteur ud_Name, Amount, Currency, Reference, etc.). Le PDF original reste sur le nœud Téléchargement.
  4. Fusionner: Combine la sortie Read Swiss QR Code (données QR suisses) et la sortie Download (fichier binaire PDF) en un seul élément afin que le nœud suivant dispose à la fois du nouveau nom de fichier et du contenu du fichier.
  5. Téléverser un fichier: Enregistre le PDF avec le chemin/nom de fichier défini sur les champs QR suisses que vous choisissez (par exemple, Test AG_Zurich_Switzerland.pdf ou 1000_CHF_REF123.pdf).

Même fichier, nom différent à chaque fois. Nous détaillons chaque étape ci-dessous.

Aperçu du flux de travail n8n : Déclencheur → Téléchargement d’un fichier → Lecture du code QR suisse → Fusion → Téléversement du fichier

Étape 1 : Téléchargez le fichier et lisez son code QR suisse.​

Importez le PDF dans n8n et extraire la valeur de nommage Avec PDF4me, lisez les codes QR suisses. Le fichier peut provenir de Télécharger un fichier (par exemple Dropbox), Google Drive, e-mail ou tout nœud qui produit binaire.

Flux jusqu'à présent : Déclencher → Télécharger un fichier → Lire le code QR suisse.

Important: La lecture du code QR suisse renvoie les données de paiement (en swissQrDataLe contenu du fichier ne transite pas par le PDF. Il reste sur le nœud Téléchargement. À l'étape 2, vous fusionnerez les deux nœuds afin que le nœud Téléversement contienne le fichier et son nouveau nom.

  1. Ajouter un déclencheurManuel pour les tests ; pour la production, utilisez un déclencheur automatisé (par exemple Dropbox, e-mail, Google Drive, webhook).
  2. Ajouter Télécharger un fichier (par exemple, Dropbox) : Définir Chemin du fichier vers l'emplacement de votre fichier PDF (par exemple, /Blog Data/Read Swiss QR.pdf) et Placez le fichier de sortie dans le champ à document Le fichier PDF est donc disponible au format binaire pour les nœuds suivants.
  3. Ajouter un nœud PDF4me → code-barres → Lire le code QR suisse.
  4. Configurer le nœud Lire le code QR suisse :
  • Identifiant pour se connecter : Votre compte PDF4me.
  • Ressource: Code-barres → Opérations de codes-barres : Lire le code QR suisse.
  • Type de données d'entrée : Données binaires.
  • Champ binaire d'entrée : document (identique au champ de sortie du nœud Téléchargement).
  • Nom du fichier de sortie : par exemple swissqr_code_data.json.
  • Asynchrone : Activez cette option pour les fichiers PDF plus volumineux si nécessaire.
  1. Exécutez le nœud. La sortie comprend succès, Nom du document, et SwissQrData avec le créancier (cr_Name, cr_City, cr_Country), débiteur (ud_Name, etc.), Montant, Devise, Référence, IBANet plus encore. Vous utiliserez ces champs pour le nom du fichier lors de l'étape de téléchargement.

Référence complète des paramètres : Lire le code QR suisse (n8n).

n8n Dropbox Télécharger un fichier : chemin du fichier et placer le résultat dans le champ document
Nœud n8n de lecture de code QR suisse : paramètres et sortie swissQrData

Étape 2 : Fusionner et télécharger avec le nouveau nom​

Vous avez besoin des deux PDF binaire (à partir du téléchargement) et le Données QR suisses (à partir de Read Swiss QR Code) dans un seul élément afin que le nœud de téléchargement puisse enregistrer le fichier sous le nouveau nom. A Fusionner Le nœud les combine ; Télécharger Le nœud utilise ensuite les champs QR suisses comme chemin d'accès ou nom de fichier.

  1. Ajouter un nœud de fusion
  • Mode: Combiner.
  • Combiner par : Position (premier élément de l'entrée 1 avec le premier élément de l'entrée 2).
  • Nombre d'entrées : 2.
  • Entrée 1 : Se connecter depuis Lire le code QR suisse (fournit swissQrData).
  • Entrée 2 : Se connecter depuis Télécharger un fichier (fournit binary.document).
  • Sortir: Un élément fusionné contenant à la fois le JSON QR suisse et binary.documentLe nœud suivant contient donc le nouveau nom de fichier et le contenu du fichier.
Nœud de fusion n8n : combine les données JSON et PDF binaires des codes QR suisses.
  1. Ajouter un nœud de téléchargement (par exemple, Dropbox) Téléverser un fichier, ou tout nœud qui accepte binaire + chemin)
  • Chemin du fichier (expression) : Utilisez la sortie « Lire le code QR suisse ». Vous pouvez référencer le nœud par son nom : $('Read SwissQR code').item.json.swissQrData.
  • Fichier binaire : SUR.
  • Champ binaire d'entrée : document.
  • Le fichier est téléchargé avec le nom dérivé du code QR suisse ; le contenu du PDF reste inchangé.

Utilisez le nom du créancier, la ville et le pays pour le nom du fichier (par exemple : Test AG_Zurich_Switzerland.pdf):

/Blog Data/{{ $('Read SwissQR code').item.json.swissQrData.cr_Name }}_{{ $('Read SwissQR code').item.json.swissQrData.cr_City }}_{{ $('Read SwissQR code').item.json.swissQrData.cr_Country }}.pdf

Se résout à : /Blog Data/Test AG_Zurich_Switzerland.pdf

n8n Téléverser un fichier : nom de fichier dynamique issu des données de créanciers QR suisses

Le même modèle de fusion et de chargement fonctionne avec Google Drive, la messagerie électronique ou tout système de stockage acceptant les fichiers binaires et un chemin d'accès dynamique. Conseil: Pour Dropbox, activez lire et écrire dans le Console d'application Dropbox (Permissions → Fichiers et dossiers) : par exemple, lecture pour le téléchargement, files.content.write Pour le téléchargement, utilisez un nouveau jeton d'accès après avoir modifié les autorisations.

Je t'ai eu : Si le chargement signale un fichier binaire manquant, assurez-vous que la fusion Entrée 2 est de Télécharger un fichier, pas à partir de Read Swiss QR Code.

Pourquoi ça marche​

Points clés

  • DéclenchementUtilisez un déclencheur manuel pour les tests ou un déclencheur automatisé (Dropbox, e-mail, webhook) afin que le flux de travail s'exécute chaque fois qu'un nouveau PDF est disponible.
  • Lire le code QR suisse extrait les données des factures QR suisses et les affiche SwissQrData (créancier) cr_*, débiteur dehors_*, Montant, Devise, Référence, etc.). Il ne transite pas par le PDF ; le fichier reste sur le nœud de téléchargement.
  • Fusionner (Combiner par position) les paires Lire la sortie du code QR suisse avec la sortie de téléchargement afin que le nœud suivant reçoive un élément avec les deux document binaire et SwissQrData.
  • Télécharger utilise une expression comme $('Lire le code SwissQR').item.json.swissQrData.cr_Name (et cr_City, cr_Pays, ou d'autres champs) pour le chemin/nom de fichier et document binaire pour le contenu, chaque fichier est renommé à l'aide des données QR suisses.

Scénarios réels​

Scénario 1 : Factures renommées par le créancier

Problème: Factures entrantes au format PDF avec des noms génériques ; vous devez les rechercher par fournisseur (créancier) et par lieu.

Solution: Renommer par nom du créancier, ville et pays (par exemple, Test AG_Zurich_Switzerland.pdfChaque fichier est consultable par expéditeur de la facture.

Champs d'extraction : cr_Name, cr_City, cr_Country Déclenchement: Dossier Dropbox, pièce jointe d'e-mail ou webhook

Scénario 2 : Bordereaux de paiement par montant et référence

Problème: Les fichiers PDF des bordereaux de paiement doivent être classés par montant et par référence de paiement à des fins de rapprochement.

Solution: Renommer par montant, devise et référence (par exemple, 1000_CHF_210000000003139471430009017.pdfAssocier les documents aux transactions bancaires.

Champs d'extraction : Amount, Currency, Reference Déclenchement: Dropbox, e-mail, webhook

Scénario 3 : Dépôt de bilan par le débiteur

Problème: Vous devez regrouper les fichiers PDF par client (débiteur final) à des fins comptables.

Solution: Renommer par le nom du débiteur (par exemple, Test Debt AG.pdf) ou nom du débiteur + ville. Correspondance directe avec les fiches clients.

Champs d'extraction : ud_Name, ud_City Déclenchement: Courriel, dossier partagé, webhook

FAQ rapide​

  • Que se passe-t-il si aucun code QR suisse n'est trouvé ? Utilisez une valeur de repli dans l'expression du chemin de fichier, par exemple : {{ $('Read SwissQR code').item.json.swissQrData?.cr_Name || 'no-qr-found' }}Vous pouvez ajouter une branche conditionnelle pour ignorer le téléchargement ou envoyer ces fichiers vers un dossier séparé.
  • Puis-je utiliser le nom du créancier et le montant ensemble ? Oui. Exemple : {{ $('Read SwissQR code').item.json.swissQrData.cr_Name }}_{{ $('Read SwissQR code').item.json.swissQrData.Amount }}_{{ $('Read SwissQR code').item.json.swissQrData.Currency }}.pdf.
  • Puis-je utiliser cela pour Google Drive ou pour la messagerie électronique ? Oui. Même principe : utilisez n’importe quel nœud qui vous fournit le fichier au format binaire et n’importe quel nœud de téléchargement (ou d’enregistrement) qui accepte le format binaire ainsi qu’un chemin dynamique.

Prochaines étapes​

Résumer: Déclencher → Télécharger un fichier → Lire le code QR suisse → Fusionner → Téléverser. Le nom du fichier est construit à partir de swissQrData (Par exemple : nom du créancier, ville, pays ou montant/référence). Chaque fichier PDF est enregistré avec les données QR suisses extraites comme nom.

  1. Obtenez votre clé APIUtilisez le même compte PDF4me pour n8n. L'inscription est gratuite.
  2. Construisez votre flux n8n: Déclencher → Télécharger un fichier → Lire le code QR suisse → Fusionner → Téléverser avec le chemin du fichier défini sur l'expression QR suisse dont vous avez besoin.
  3. Consultez la documentation complète: Lire le code QR suisse (n8n).
  4. Essayez l'API: Testez le point de terminaison Read Swiss QR Code avec votre propre PDF dans l'API Tester.
Get Your API KeyRead Swiss QR Code in n8nTry SwissQR Code APIRename with Barcode