Lire le code SwissQR dans Zapier

Lire le code SwissQR est un Zapier action par PDF4me qui décode le suisse QR-bill intégré dans un PDF et retourne le créancier, le débiteur, IBAN, montant et données de référence comme JSONUtilisez-le pour renommer automatiquement les factures, faire correspondre les paiements aux enregistrements comptables ou acheminer les documents par montant ou référence sans saisie manuelle de données.

Articles de blog connexes(1)

Vos factures suisses avec QR code s'accumulent dans Dropbox\_? Renommez-les automatiquement dans Zapier grâce à Code by Zapier.

Renommage automatique des factures QR suisses au format PDF avec Zapier\_: Créer un nouveau fichier dans un dossier → PDF4me lit le code SwissQR → Zapier analyse le code (JSON, extraction du débiteur/créancier) → Téléverser le fichier. Aucune étape de recherche de fichier requise. Procédure pas à pas avec captures d'écran Dropbox. Compatible avec SharePoint et Google Drive.

Lire l'article →

Que fait cette action ?

PDF4me Lire le code SwissQR prend un PDF contenant un Suisse QR-facture (QR-Facture) et renvoie ses données de paiement structurées, dans un Zap. Cartographiez le Déposer, et l'action revient Texte du document, un JSON chaîne avec IBAN, créancier, créancier final, débiteur, montant, devise et champs de référence. Analysez-le avec un code par Zapier étape permettant de renommer les factures, de rapprocher les paiements ou d'automatiser la comptabilité.

Authentification de votre API Demande

Pour accéder au PDF4me Web API à travers Zapier, chaque requête doit inclure des informations d'identification d'authentification valides.

Get your API Key

Informations importantes à ne pas manquer

Doc Text est un JSON chaîne de caractères, et non des champs individuels

L'action renvoie un champ, Texte du document, contenant la totalité de la charge utile décodée sous forme de JSON chaîne. Vous avez besoin d'un code par Zapier (Exécuter JavaScript) étape à JSON.parse il avant de mapper des valeurs individuelles comme IBAN ou ud_Nom.

Les noms de champs utilisent les préfixes cr_/ucr_/ud_

cr_ est le créancier, ucr_ est le créancier ultime (souvent laissé en blanc), et dehors_ est le débiteur ultime, conformément aux normes de paiement suisses (SPC) dénomination des champs. cr_Name et ud_Nom sont les deux champs que la plupart des flux de travail utilisent.

Utilisez le fichier original pour le PDF, et non la sortie de cette action

La lecture du code SwissQR renvoie des données sur le PDF, il ne passe pas le PDF et ainsi de suite. Continuez à faire référence à Déposer à partir de votre déclencheur pour toute étape de téléchargement de fichier, d'envoi d'e-mail ou de stockage.

Configurer le panneau d'actions : seul le champ Fichier est obligatoire, le nom du fichier est facultatif.

Paramètres

Requis dans le Zapier UI: Fichier. Le nom du fichier est facultatif.

Paramètre	Requis	Ce que cela fait	Exemple
File	Required	The PDF containing the Swiss QR-bill to decode. Map from your trigger or a previous step.	1. File
File Name	Optional	Name for the response file. If left blank, the name is picked from the source URL.	invoice.pdf

Sortir

L'action renvoie les métadonnées du fichier plus un champ de charge utile. Texte du document, un JSON chaîne de caractères. Analysez-la pour accéder à chaque Suisse. QR- Champs de facturation listés sous le tableau.

Champ	Taper	Ce qu'il contient
File Name	String	Name of the generated response file, from File Name or picked from the source URL.
File Extension	String	Extension of the response file, .json.
Full File Name	String	Complete filename including extension.
File Alternate Url	String	URL to the generated JSON response file.
Document Id	String	Unique identifier for this processing run.
File Size	Number	Size of the response file in bytes.
Doc Text	String (JSON)	The decoded Swiss QR-bill payload as a JSON string. Parse it to reach IBAN, creditor, debtor, amount, currency, and reference fields.

Champs de texte du document (après JSON.parse)

Champ	Ce qu'il contient
QRType, Version, CodingType	Swiss Payment Standards header data identifying this as an SPC QR payload and its version.
IBAN	Creditor IBAN the payment settles to.
cr_Name, cr_StreetOrAddressLine1, cr_PostalCode, cr_City, cr_Country	Creditor (biller) name and address.
ucr_Name, ucr_StreetOrAddressLine1, ucr_PostalCode, ucr_City, ucr_Country	Ultimate creditor fields, populated only when the creditor differs from the ultimate payee.
Amount, Currency	Payment amount and currency (CHF or EUR).
ud_Name, ud_StreetOrAddressLine1, ud_PostalCode, ud_City, ud_Country	Ultimate debtor (payer) name and address.
ReferenceType, Reference	Reference type (QRR, SCOR, or NON) and the reference number itself.
UnstructuredMessage, BillingInfo	Free-text payment message and structured billing information, when present on the bill.

Comment configurer la lecture des codes SwissQR dans Zapier?

1. Ajouter PDF4me comme application d'action dans votre Zap et choisissez Lire le code SwissQR.
2. Connectez votre PDF4me Créez un compte ou sélectionnez une connexion existante.
3. Carte Déposer aux Suisses QR-facture PDF à partir de votre déclencheur ou d'une étape précédente. Carte facultative Nom de fichier.
4. Tester l'étape et inspecter Texte du document dans le panneau de sortie de données, il s'agit d'un JSON chaîne.
5. Ajouter un Code par Zapier (Exécuter JavaScript) étape qui reçoit le texte du document, s'exécute JSON.parse, et renvoie le champ spécifique dont vous avez besoin (ud_Nom, cr_Name, IBAN, Référence, ou d'autres).
6. Transformez cette valeur analysée en Téléverser un fichier (pour renommer), un Filtre ou Chemins étape (pour le routage), ou une action de feuille de calcul/comptabilité.

Qu'est-ce que le Suisse ? QR-Bill et pourquoi a-t-il besoin d'un lecteur spécial ?

Les Suisses QR-facture (QRLe bordereau de paiement suisse (Rechnung) est le format standard des paiements suisses devenu le seul bordereau de paiement valide en Suisse le 30 septembre 2022, remplaçant les anciens bordereaux orange et rouge. Il indique le créancier, le débiteur, IBAN, montant et données de référence à l'intérieur d'un QR code utilisant le SPC (Swiss Payment Code) structure, un ordre de champ fixe qu'un code-barres générique ou QR Le scanner lit le texte brut mais ne peut pas l'associer à des champs nommés. La lecture du code SwissQR décode cela. SPC structure et la renvoie sous le nom JSON champs.

Configurations typiques

Exemples de flux de travailCommon Zapier patterns using Read SwissQR Code.

Renommage automatique des factures par nom du débiteur

1. Déclencheur « Nouveau fichier dans le dossier » (Dropbox, Google Drive, SharePoint) tire sur un nouveau Suisse QR-facture PDF.
2. La lecture du code SwissQR s'effectue avec le fichier et le nom de fichier mappés à partir du déclencheur, renvoyant le texte du document.
3. Un code par Zapier Cette étape analyse le texte du document et renvoie ud_Name (le débiteur).
4. Le téléchargement de fichiers enregistre la même chose PDF Le contenu est indexé afin que les fichiers soient consultables par payeur.

Rapprocher les paiements entrants des documents comptables

1. Un déclencheur de courriel ou de dossier délivre un Suisse QR-facture PDF.
2. Lire SwissQR Code extrait le texte du document, puis un code par Zapier analyse des étapes IBAN, Montant et Référence.
3. Une étape de recherche dans un système comptable (QuickBooks, Xero ou une base de données personnalisée) fait correspondre la référence à une facture impayée.
4. Une étape de suivi permet de marquer la facture comme payée et d'enregistrer la transaction.

Itinéraire par montant ou type de référence

1. Le code SwissQR est exécuté sur une facture entrante et renvoie le texte du document.
2. Un code par Zapier Cette étape analyse les champs Amount et ReferenceType.
3. L'étape Paths achemine les paiements de grande valeur vers une file d'attente d'approbation manuelle et QRR-Paiements référencés à la comptabilisation automatisée.

Conseils pratiques

Doc Text always needs a parse step

There is no built-in field mapping for individual Swiss QR-bill values. Budget for a Code by Zapier step in every Zap that uses this action.

cr_ vs ud_ vs ucr_ is easy to mix up

cr_ is the creditor (who gets paid), ud_ is the ultimate debtor (who is paying), ucr_ is the ultimate creditor and is usually blank. Double-check which prefix your workflow actually needs.

ReferenceType tells you the reference format

QRR means a 27-digit QR reference, SCOR means a Creditor Reference (ISO 11649), NON means no structured reference, only UnstructuredMessage. Branch your parsing logic on ReferenceType if you support more than one format.

Amount can be null for open-amount bills

Some Swiss QR-bills are issued without a fixed Amount, letting the payer enter it. Handle a null or missing Amount in your Code by Zapier step rather than assuming it is always present.

The action reads, it does not validate compliance

This action decodes whatever SPC data is embedded in the QR code. It does not certify Swiss banking regulatory compliance, that responsibility stays with however the bill was originally issued.

Aide-mémoire

Champ	Valeur
Action	Read SwissQR Code
File	Required, Swiss QR-bill PDF
File Name	Optional
Output payload	Doc Text (JSON string)
Common parsed fields	IBAN, cr_Name, ud_Name, Amount, Currency, Reference
Parse step needed	Code by Zapier, JSON.parse(Doc Text)
Counterpart action	Create SwissQR Bill (generates the QR-bill instead of reading it)

Questions fréquentes

What does Read SwissQR Code actually return?+

The action returns Doc Text, a JSON string containing the decoded Swiss QR-bill fields: QRType, Version, CodingType, IBAN, creditor fields (cr_Name, cr_StreetOrAddressLine1, cr_PostalCode, cr_City, cr_Country), ultimate creditor fields (ucr_*), Amount, Currency, ultimate debtor fields (ud_Name, ud_StreetOrAddressLine1, ud_PostalCode, ud_City, ud_Country), ReferenceType, Reference, UnstructuredMessage, and BillingInfo. It also returns file metadata (File Name, File Extension, Full File Name, File Alternate Url, Document Id, File Size) for the generated JSON response file.

Do I need a separate step to parse the output?+

Yes. Doc Text is a single JSON string, not individually mapped fields. Add a Code by Zapier (Run JavaScript) step, run JSON.parse on the Doc Text value, and return the specific field you need such as data.ud_Name or data.IBAN so later steps in the Zap can map it directly.

What is the Swiss QR-bill and why does it need a special reader?+

The <a href="https://www.six-group.com/en/products-services/banking-services/payment-standardization/qr-bill.html" target="_blank" rel="noopener noreferrer">Swiss QR-bill (QR-Rechnung)</a> is the Swiss Payment Standards format that became the only valid Swiss payment slip on 30 September 2022. It encodes structured payment data (IBAN, creditor, debtor, amount, reference) inside a QR code using the SPC data format, a fixed field order that a generic barcode or QR scanner cannot parse into named fields without knowing that structure.

Can I use the extracted data to rename or route the PDF?+

Yes. A common pattern parses Doc Text for ud_Name (debtor) or cr_Name (creditor) and uses that value as the filename in an Upload File step, or checks Reference or Amount in a Filter or Paths step to route the invoice. Use the original File field from your trigger for the file content, this action's output only carries data, not the PDF. See <a href="https://www.iso20022.org/" target="_blank" rel="noopener noreferrer">ISO 20022</a> for background on the structured payment messaging standard the Swiss QR-bill builds on.

Actions connexes

Créer une facture SwissQR

L'action de contrepartie génère un Suisse QR-facture PDF depuis IBAN, créancier et données de montant au lieu d'en lire une seule.

Classer les documents

Trier les messages entrants PDFs Commencez par trier par type, puis exécutez la fonction Lire le code SwissQR uniquement sur les codes classés comme suisses. QR-factures.

Analyser le document

Pour les factures sans Suisse QR-bill, extraire les données des lignes et des en-têtes à l'aide d'un modèle d'analyse mappé.

Cas d'utilisation et applications industrielles

Swiss Banking & Financial Services

• Traitement des paiementsLisez les codes SwissQR pour le traitement automatisé des paiements et la gestion des transactions.
• Gestion des transactionsExtraire les données de paiement pour un traitement et un rapprochement complets des transactions.
• Rapports de conformitéIntégrer les données de référence et de montant décodées dans les enregistrements de la piste d'audit interne.
• Service clientTraiter les paiements et les demandes des clients grâce à la reconnaissance automatisée des codes SwissQR.

Swiss Business & Professional Services

• Traitement des facturesLecture des codes SwissQR figurant sur les factures pour le traitement automatisé des paiements et la comptabilité
• Gestion de la clientèleExtraire les informations de paiement pour la facturation et le suivi des paiements des clients
• Gestion financièreAutomatiser la lecture des codes SwissQR pour une gestion financière complète
• Automatisation des documentsRationalisez le traitement des documents commerciaux grâce à la lecture intégrée des codes SwissQR.

Swiss E-commerce & Retail

• Traitement des commandesLisez les codes SwissQR pour le traitement automatisé des commandes et le recouvrement des paiements.
• Suivi des paiementsExtraire les données de paiement pour un suivi complet des commandes et des paiements
• Expérience clientAméliorez l'expérience de paiement de vos clients grâce au traitement automatisé des codes SwissQR.
• Gestion des stocksLier les données de paiement à la gestion des stocks et au traitement des commandes

Swiss Government & Public Sector

• Services publicsConsultez les codes SwissQR pour accéder aux services gouvernementaux et au traitement des paiements du secteur public.
• Administration fiscaleExtraire les données de paiement pour le traitement des impôts et des frais gouvernementaux
• Gestion des documentsIntégrer les données de paiement décodées dans les systèmes d'archivage interne de la comptabilité du secteur public
• Services numériquesModernisez le traitement des paiements du secteur public grâce à l'automatisation des codes SwissQR.

Obtenez de l'aide

Zapier IntegrationGet your API KeyZapier Documentation