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

Lire le code QR suisse à l'aide de n8n action

PDF4me Lire le code QR suisse extrait et analyse les données de paiement des codes QR suisses intégrés dans PDF documents par n8n Flux de travail automatisés. Processus PDFs loin n8n déclencheurs, données binaires, chaînes base64 ou publiques URLs pour décoder automatiquement les factures QR suisses et récupérer les informations de paiement structurées, y compris les détails du créancier/débiteur, IBANCette solution permet d'extraire les montants, les devises, les numéros de référence et les informations de facturation, en parfaite conformité avec les normes de paiement suisses. Elle est idéale pour le traitement automatisé des paiements, le rapprochement des factures, l'intégration aux systèmes comptables, les flux de travail financiers et la conformité réglementaire nécessitant une extraction précise des données des codes QR suisses.

Articles de blog connexes(1)

Installation​

Ajoutez le PDF4me Ajoutez le nœud « Lire le code QR suisse » à votre n8n Suivez le flux de travail et configurez les paramètres requis. Pour les instructions de configuration initiale, consultez notre documentation. n8n Guide d'intégration.

Prérequis :

  • PDF4me API informations d'identification
  • n8n accès au flux de travail
Get Your API Key

Configuration:

  1. Ajouter PDF4me nœud vers flux de travail
  2. Sélectionnez l'action « Lire le code QR suisse ».
  3. Configurer les paramètres d'entrée (voir ci-dessous)
Lire le code QR suisse

Paramètres​

Liste complète des paramètres de l'action « Lire le code QR suisse ». Configurez ces paramètres pour extraire les données du code QR suisse.

Important: Les paramètres marqués d'un astérisque (***) sont obligatoires et doivent être fournis pour que l'action fonctionne correctement.

ParamètreTaperDescriptionExemple
Type de données d'entrée***StringSélection du format de saisie du code QR
• Choisissez le format de vos données de code QR.
• PDF4me Prend en charge plusieurs types d'entrée pour le traitement des codes QR suisses
• Options : Données binaires, Base64 Chaîne, ou URL		Binary Data
Champ binaire d'entréeBinaireSaisie d'image de code QR binaire (Obligatoire si données binaires)
• Fichier image du code QR de référence de la version précédente n8n nœud ou téléchargement
• PDF4me traite les images binaires avec reconnaissance automatique des codes QR
• Obligatoire lorsque le type de données d'entrée est « Données binaires »		{{ $binary.data }}
Contenu du document Base64StringBase64 Saisie du code QR encodé (Obligatoire si Base64 Chaîne)
• Fournir les données de l'image du code QR sous forme de chaîne encodée en base64
• PDF4me décode et traite automatiquement le contenu du code QR
• Obligatoire lorsque le type de données d'entrée est «Base64 Chaîne"		UEsDBBQABgAI...
URL du fichierStringCode QR public URL Saisir (Obligatoire si URL)
• Fournir une autorisation publique/ouverte URL vers le fichier image du code QR
• PDF4me télécharge et traite le fichier depuis URL
• Obligatoire lorsque le type de données d'entrée est «URL"		https://abc.com/qr.png
Nom du fichier de sortie***StringNom du fichier de sortie des données QR suisses
• Spécifiez le nom du fichier généré JSON fichier contenant les données extraites
• Doit inclure l'extension .json
• PDF4me garantit une validation unique du nom et du format		swissqr_code_data.json
Asynchrone***BooleanTraitement asynchrone
• Activer le traitement asynchrone pour la lecture des codes QR suisses
• vrai = traitement en arrière-plan pour de meilleures performances
• faux = traitement synchrone pour des résultats immédiats
• Idéal pour les opérations à volume élevé		true

Options avancées​

Les paramètres suivants sont disponibles dans la section Options avancées et sont facultatifs :

ParamètreTaperDescriptionExemple
Profils personnalisésStringProfils de configuration personnalisés
• Définir des options supplémentaires à l'aide de profils personnalisés
• JSON-format contenant des paramètres prédéfinis
• Active les paramètres avancés de lecture des codes QR suisses
• Optionnel pour les besoins spécifiques		{ "outputDataFormat": "json", "validateSwissStandards": true }

Sortir​

Paramètres de sortie​

ParamètreTaperDescriptionExemple
nom de fichierStringPDF4me Nom de fichier de données QR suisses - Le nom complet du fichier généré avec succès JSON Fichier contenant les données extraites du code QR suisse avec l'extension .json appropriée. PDF4me garantit une dénomination unique et valide la conformité du format de fichier pour une intégration transparente avec les processus en avalswissqr_code_data.json
type mimeStringPDF4me JSON données MIME taper - Le MIME type du généré JSON Fichier contenant des données de code QR suisse, indiquant le format de fichier pour une gestion correcte dans les applications web et les systèmes de fichiers.application/json
taille du fichierNombrePDF4me JSON taille du fichier en octets - La taille exacte de l'objet généré JSON fichier en octets, fourni par PDF4me Pour la planification du stockage, l'optimisation de la bande passante et la surveillance des transferts de fichiers. Indispensable pour la gestion documentaire en entreprise et l'automatisation des flux de travail.1024
succèsBooleanPDF4me Indicateur d'état de lecture QR suisse - Indicateur booléen signalant le succès ou l'échec du processus de lecture du code QR suisse. PDF4me retours true pour une lecture réussie et false pour toute erreur, permettant une gestion robuste des erreurs dans les flux de travail automatiséstrue
SwissQrDataObjectPDF4me Données QR suisses extraites - Données structurées complètes extraites du code QR suisse, incluant les informations de paiement, les coordonnées du créancier et les données de transaction. Contient toutes les informations pertinentes conformément aux normes suisses relatives aux codes QR.{"ucr_PostalCode": "", "ucr_City": "", "ucr_Country": null, "Amount": 30, "Currency": "CHF", "ud_AddressType": "S", "ud_Name": "Heinz Muster", "ud_StreetOrAddressLine1": "Tödistrasse", "ud_BuildNoOrAddressLine2": "1", "ud_PostalCode": "8000", "ud_City": "Zürich", "ud_Country": "Switzerland", "ReferenceType": "QRR", "Reference": "210000000003139471430009017", "UnstructuredMessage": "for individuals", "BillingInfo": "S1/01/20200109/33/123455/99/0/123258/30/CH2345677/40/1020/41/300", "av1_Parameters": "", "av2_Parameters": ""}

N8N Réponse à l'action​

Le PDF4me Lire le code QR suisse API renvoie une réponse pouvant être affichée dans plusieurs formats. Choisissez l'affichage qui correspond le mieux à vos besoins :

JSON Format de réponse

Le cru JSON réponse de la API:

{
  "fileName": "swissqr_code_data.json",
  "mimeType": "application/json",
  "fileSize": 1024,
  "success": true,
  "swissQrData": {
    "ucr_PostalCode": "",
    "ucr_City": "",
    "ucr_Country": null,
    "Amount": 30,
    "Currency": "CHF",
    "ud_AddressType": "S",
    "ud_Name": "Heinz Muster",
    "ud_StreetOrAddressLine1": "Tödistrasse",
    "ud_BuildNoOrAddressLine2": "1",
    "ud_PostalCode": "8000",
    "ud_City": "Zürich",
    "ud_Country": "Switzerland",
    "ReferenceType": "QRR",
    "Reference": "210000000003139471430009017",
    "UnstructuredMessage": "for individuals",
    "BillingInfo": "S1/01/20200109/33/123455/99/0/123258/30/CH2345677/40/1020/41/300",
    "av1_Parameters": "",
    "av2_Parameters": ""
  }
}

Cas d'utilisation​

Traitement des paiements et services bancaires suisses​

  • Automatisez le traitement des paiements par QR code suisse en lisant les informations de paiement figurant sur les factures, les reçus et les documents de paiement afin de permettre le rapprochement automatique des paiements et l'intégration comptable.
  • Extraire les informations de paiement des codes QR suisses intégrés aux factures afin de faciliter le traitement automatisé des paiements et de réduire la saisie manuelle de données dans les systèmes bancaires et financiers suisses.
  • Traiter les confirmations de paiement et les enregistrements de transactions en lisant les codes QR suisses afin de vérifier les montants des paiements, les informations sur le destinataire et les références de transaction pour la conformité financière suisse.

Gestion des affaires et des factures en Suisse​

  • Lisez les codes QR suisses figurant sur les factures commerciales et les documents de paiement afin d'extraire les informations client, les montants des paiements et les détails des transactions pour les processus comptables automatisés.
  • Traiter les paiements et documents officiels du gouvernement suisse en lisant les codes QR suisses pour extraire les informations de paiement et garantir la conformité avec la réglementation financière suisse et les obligations déclaratives fiscales.
  • Extraire les données de paiement des codes QR suisses figurant sur les factures de services publics, les factures de services et les paiements d'abonnements afin de permettre le traitement automatisé des paiements et la gestion des comptes clients.

Commerce électronique et transactions numériques en Suisse​

  • Traitez les paiements en ligne et les transactions de commerce électronique en lisant les codes QR suisses figurant sur les reçus numériques et les confirmations de paiement afin de permettre le traitement automatisé des commandes et les flux de travail du service client.
  • Extraire les informations de paiement des codes QR suisses dans les applications de paiement mobile et les portefeuilles numériques afin de faciliter la vérification des transactions et la tenue automatisée des registres financiers.
  • Traitez les paiements d'abonnement et la facturation récurrente en lisant les codes QR suisses pour extraire les informations de paiement et permettre la gestion automatisée de la facturation pour les clients et entreprises suisses.

Obtenez de l'aide​

n8n Integration GuideGet your API Keyn8n SampleGetting Started