Créer une facture QR suisse dans n8n
Que fait ce nœud ?
PDF4meCréer une facture QR suisse génère des bordereaux de paiement QR suisses entièrement conformes, intégrés dans PDF documents via votre n8n Flux de travail d'automatisation. Fournir un PDF facture via données binaires, base64, URL, ou en l'absence de tout document de référence, le nœud génère une facture QR suisse standardisée avec Informations sur les créanciers et les débiteurs, IBAN, numéros de référence, étiquettes multilingues et formats de sortie configurables en une seule étape automatisée. Entièrement compatible avec toutes les banques suisses. PostFinance, et les normes suisses de paiement (SPS) spécification.
Authentification de votre API Demande
Chaque PDF4me nœud dans n8n nécessite un numéro valide Identifiant pour se connecter avecCréez ou sélectionnez-en un qui contient votre PDF4me API clé permettant au flux de travail d'authentifier en toute sécurité les demandes de génération de factures QR suisses.
Informations importantes à ne pas manquer

Panneau supérieur, champs de connexion, type de saisie, détails de paiement et adresse du créancier

Panneau inférieur : adresse du débiteur, type de référence, langue, format, pagination et configuration de sortie
Paramètres
Requis dans le n8n UI: Identifiant de connexion, Type de données d'entrée, Montant, Devise, IBAN, Nom du créancier, Type d'adresse du créancier, Type d'adresse du débiteur final, Type de référence, Type de langue, Ligne de séparation, Type de format et (lorsque le type de format est PDFOptions de pagination. Tous les champs d'adresse, de code postal et de ville sont indiqués comme facultatifs. UI mais sont fortement recommandé pour les billets QR suisses valides, la norme suisse de paiement et la PDF4me API Ces données sont considérées comme indispensables à la production. La charge utile exécutée les envoie systématiquement (sous forme de chaînes vides si elles sont absentes).
| Paramètre | Requis | Ce que cela fait | Exemple |
|---|---|---|---|
| Input Data Type | Conditional | How the source PDF is supplied. None generates a standalone QR bill with no background document. Binary Data reads from a previous n8n node: the most common option. Base64 String accepts encoded file content. URL downloads from a public link. | Binary Data |
| Binary Property Name | Conditional | Name of the binary field from the previous node. Required when Input Data Type is Binary Data. Maps to the output binary field of a prior download or file node. | data |
| Base64 Content | Conditional | Base64-encoded PDF content. Required when Input Data Type is Base64 String. | JVBERi0xLjQK... |
| File URL | Conditional | Public URL to the source PDF file. Required when Input Data Type is URL. | https://example.com/invoice.pdf |
| File Name | Conditional | Filename of the source PDF input. Shown only when Input Data Type is Binary Data, Base64 String, or URL: hidden for None. Include the .pdf extension. | document.pdf |
| Amount | Yes | Payment amount for the Swiss QR bill. Enter without leading zeroes (per the node field description). Must be a positive number with up to two decimal places. | 1000 |
| Currency | Yes | Currency for the QR bill. Only two options accepted: CHF (Swiss Franc, standard for domestic Swiss payments) or EUR (cross-border transactions). | CHF |
| IBAN | Yes | Creditor's Swiss IBAN. Must start with CH followed by 19 digits and be linked to a valid PostFinance or Swiss bank account. An invalid IBAN halts the workflow. | CH0200700110003765824 |
| Creditor Name | Yes | Full name of the creditor company or individual as registered with the bank. Printed on the generated QR bill in the creditor section. | Test AG |
| Creditor Address Type | Yes | Address format for creditor information. Sent as code S (Structured: components stored separately for maximum SPS compliance) or K (Combined, two free-form lines). | Structured (S) |
| Creditor Address Line 1 | No | Street name for the creditor's address. Marked optional in the UI but required for valid Swiss QR bills: always provide it. When Address Type is Structured, enter the street name only. | Test Strasse |
| Creditor Address Line 2 | No | House number or secondary address detail. Used as the second address line when Creditor Address Type is Structured. | 1 |
| Creditor Postal Code | No | Swiss postal code for the creditor's address. Marked optional in the UI but required for valid Swiss QR bills. Must be a 4-digit Swiss postal code matching the creditor city. | 8000 |
| Creditor City | No | Swiss city name for the creditor's address. Marked optional in the UI but required for valid Swiss QR bills. Must correspond to the postal code entered above. | Zurich |
| Ultimate Debtor Name | No | Full name of the party who will pay the bill. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. Appears in the payment section of the printed QR bill. | Test Debt AG |
| Ultimate Debtor Address Type | Yes | Address format for the ultimate debtor. Sent as code S (Structured: recommended for automated Swiss banking) or K (Combined, two free-form lines). | Structured (S) |
| Ultimate Debtor Address Line 1 | No | Street name for the debtor's address. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. | Test Deb Strasse |
| Ultimate Debtor Address Line 2 | No | House number or secondary address line for the debtor. Used as the second line when Ultimate Debtor Address Type is Structured. | 2 |
| Ultimate Debtor Postal Code | No | Swiss postal code for the debtor's address. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. | 8000 |
| Ultimate Debtor City | No | Swiss city name for the debtor's address. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. | Zurich |
| Reference Type | Yes | Sent as code NON (No Reference: simple payments), QRR (QR Reference, 27-digit numeric for PostFinance/Swiss bank reconciliation), or SCOR (Creditor Reference, ISO 11649 for SEPA-compatible cross-border payments). | NON |
| Language Type | Yes | Display language for QR bill labels and printed text. Options: English, German, French, Italian. Choose the language matching the recipient's Swiss region. | English |
| Separator Line | Yes | Visual separator between the invoice body and the QR bill tear-off section. Note the node field name is spelled "seperatorLine". Options: Line With Scissor (Swiss standard), Simple Line, No Line. | Line With Scissor |
| Format Type | Yes | Output file format for the generated QR bill. PDF is recommended for print-ready documents. PNG and JPEG for digital delivery. TIFF for archival quality. Empty or null for raw data output. | PDF |
| Paging Options | Conditional | Controls where the QR bill slip is placed in the output document. Required when Format Type is PDF. Options: First, Last, Add Page At End, Custom. | First |
| Page Number | Conditional | Specific page index for placing the QR bill. Shown and required only when Format Type is PDF and Paging Options is Custom. | 3 |
| Output File Name | No | Filename for the generated Swiss QR bill document. Default value is provided by the node. Include the extension matching your chosen Format Type. | swissqr_bill.pdf |
| Output Binary Field Name | No | Name of the binary field in the n8n output that holds the generated QR bill file. Default is data. Used to reference the file in subsequent workflow nodes. | data |
Options avancées
Tous les champs à l'intérieur du Options avancées Les collections sont facultatives et offrent un contrôle supplémentaire sur le contenu des factures QR. Ajoutez-les via Ajouter une option dans l'interface utilisateur du nœud.
référencemessage non structuréinformations de facturationav1av2profilsOptions de type de données d'entrée
Choisissez comment la source PDF entre dans le nœud. Chaque option correspond à un modèle de flux de travail différent.

Dans le menu déroulant Type de données d'entrée, quatre options permettent de contrôler la manière dont la source PDF est fourni au nœud
AucunAucun document de référenceDonnées binairesFichier du nœud précédent, le plus courantdonnées).Chaîne Base64Contenu du fichier encodé en Base64URLTélécharger à partir d'un lien publicOptions de type d'adresse
S'applique aux deux Type d'adresse du créancier et Type d'adresse du débiteur finalChoisissez comment les composants de l'adresse sont stockés dans les données du code QR.
StructuréChamps d'adresse séparés recommandésCombinéDeux lignes d'adresse libres
Type d'adresse du créancier, structurée ou combinée

Type d'adresse du débiteur final : même choix que pour le créancier
Options de type de référence
Contrôle la norme de référence de paiement intégrée au code QR. Cela influe sur la manière dont le paiement est associé à la facture dans votre système bancaire.

Type de référence, Aucune référence, Référence QR ou Référence du créancier
Aucune référencePar défaut, aucune référence structuréeRéférence QRRapprochement bancaire suisse numérique à 27 chiffresRéférence du créancierISO 11649, transfrontalière SEPA paiementsOptions de type de format
Contrôle le format du fichier de sortie du ticket QR généré.

Liste déroulante Type de format, PDF, PNG, JPEG, TIFF, ou Vide (nul)
PDFPar défaut, prêt à imprimerPNGLivraison Web et numériqueJPEGimage adaptée au courrier électroniqueTIFFQualité d'archivageVide (nul)Sortie de données brutesOptions de pagination
Permet de contrôler l'emplacement du bordereau de facturation QR dans le document de sortie par rapport aux pages de facture existantes.

Options de pagination : Première, Dernière, Ajouter une page à la fin ou Personnalisée
D'abordFacture par défaut avec code QR en page 1DernierFacture QR sur la dernière pageAjouter une page à la finPage de facturation QR dédiée la plus couranteCoutumePositionnement spécifique de la pageChamps de sortie
| Champ | Taper | Ce qu'il contient |
|---|---|---|
fileName | String | Filename of the generated Swiss QR bill document, for example swissqr_bill.pdf. Map into an upload or email node as the destination filename. |
mimeType | String | MIME type of the output file, for example application/pdf. Useful for content type validation in downstream HTTP or storage nodes. |
fileSize | Number | Size of the generated QR bill file in bytes. Useful for storage planning, bandwidth monitoring, and conditional routing in the workflow. |
success | Boolean | True when the Swiss QR bill was created successfully. False if an error occurred during generation. Use this field to route error handling branches in your workflow. |
message | String | Human-readable status message confirming success or describing the error encountered. Useful for logging and error notification steps. |
Configuration rapide
- Ajouter PDF4me à votre n8n Flux de travail. Définir Ressource à Facture et Opérations de facturation à Créer une facture SwissQR.
- Dans Identifiant pour se connecter avec, sélectionnez votre PDF4me identifiant ou cliquez Créer un nouveau compte et collez votre API clé.
- Ensemble Type de données d'entrée: connecter la sortie binaire d'un nœud précédent (Données binaires), fournir un Base64 chaîne, fournir un public URL, ou sélectionnez Aucun pour un reçu QR autonome.
- Entrez dans Montant, Devise (Franc suisse pour les paiements en CHF), et IBAN (valable Suisse CH IBAN (commençant par CH).
- Remplissez tous les champs Créancier Champs : Nom, Type d’adresse (l’adresse structurée est recommandée), Ligne d’adresse 1, Ligne d’adresse 2, Code postal et Ville.
- Remplissez tous les champs Débiteur ultime champs contenant le nom complet et l'adresse du payeur.
- Ensemble Type de référence (Aucune référence n'est sélectionnée par défaut). Type de langue (anglais, allemand, français ou italien), et Ligne de séparation (La ligne avec ciseaux est la norme suisse).
- Configure Type de format (PDF recommandé) et Options de pagination (Ajouter une page à la fin pour ajouter une page de facture QR à une facture existante).
- Ensemble Nom du fichier de sortie à
swissqr_bill.pdfet Nom du champ binaire de sortie àdata. - Connectez la sortie à votre prochain nœud : expéditeur d’e-mails, téléchargement sur le stockage cloud, écriture dans la base de données, et exécutez le flux de travail.
Exemples de flux de travail
Exemples de flux de travailCommon n8n workflow patterns using Create Swiss QR Bill.
- Un déclencheur de planification s'active le premier jour de chaque mois pour lancer la facturation.
- Un nœud Google Drive répertorie toutes les factures PDFs dans le dossier de facturation mensuel, un par client.
- Un nœud « Boucle sur les éléments » parcourt chaque fichier. Pour chacun d'eux, un nœud « Téléchargement Google Drive » récupère le contenu binaire.
- PDF4me Create Swiss QR Bill ajoute un bordereau de paiement QR conforme à chaque facture en utilisant le montant du client. IBANL'adresse est extraite d'une fiche client Google Sheets. La langue est l'allemand. L'option de pagination est « Ajouter une page à la fin ».
- Un nœud Gmail envoie la facture QR PDF Un fichier est envoyé en pièce jointe à chaque client par courriel. Son nom utilise l'identifiant du client pour faciliter son identification.
- Un déclencheur Webhook s'active lorsqu'une commande est confirmée sur la plateforme de commerce électronique.
- Un HTTP Le nœud de requête génère une facture PDF d'un HTML modèle utilisant les données de commande.
- PDF4me Créer une facture QR suisse permet d'ajouter un bordereau QR conforme à la facture. PDFLe montant et les informations relatives au débiteur sont extraits des données du webhook. Le type de référence est défini sur « Référence du créancier » pour le rapprochement. La langue est le français pour la Suisse romande.
- Un Microsoft SharePoint Le nœud télécharge le ticket QR complété PDF dans le dossier d'archives des commandes.
- Un HTTP Le nœud de requête met à jour le statut de la commande à Facture envoyée dans le CRM système.
- Un déclencheur de planification s'active tous les lundis matin pour vérifier les comptes d'abonnement en retard.
- Un nœud PostgreSQL interroge tous les comptes dont le solde impayé date de plus de 14 jours.
- Un nœud de boucle sur les éléments traite chaque abonné. PDF4me La fonction « Créer une facture QR suisse » est appelée avec le type de données d'entrée défini sur « Aucun », sans arrière-plan. PDFGénération d'une facture QR autonome et sans erreur. Le nom et l'adresse du débiteur sont extraits de la base de données. Type de référence : Aucune. Langue : Italien (Suisse italophone).
- Un Microsoft Outlook Node envoie un e-mail de rappel de paiement à chaque abonné avec la facture QR autonome PDF ci-joint.
- Un nœud PostgreSQL enregistre l'horodatage de l'envoi du rappel et incrémente le compteur de rappels pour chaque compte.