Créer suisse QR Bill dans Zapier
Que fait cette action ?
PDF4me Créer une facture SwissQR génère des normes de paiement suisses (SPS) conforme Suisse QR-factures (QR-Facture) à l'intérieur de votre Zapier Flux de travail. Convertissez les données de facturation provenant de Bexio, Sage, Abacus, QuickBooks, Xero, Microsoft Dynamics ou de tout autre système. Zapier-source connectée dans un Suisse prêt à imprimer QR-facture avec IBAN, détails structurés du créancier et du débiteur final, QR Référence (QRR) ou référence du créancier (SCOR), Montant, Devise et étiquettes multilingues. Sortie sous forme de PDF, PNG, JPEG, ou TIFFAccepté par toutes les banques suisses, PostFinanceet une application bancaire suisse depuis le QR-La facture est devenue le seul document de paiement suisse valide le 30 septembre 2022.
Authentification de votre API Demande
Pour accéder au PDF4me Web API à travers Zapier, chaque action doit être authentifiée. Cliquez Créer un nouveau compte La première fois, collez votre PDF4me API clé. Les Zaps suivants réutilisent automatiquement la connexion.
Informations importantes à ne pas manquer
Configurer dans Zapier
Sur le Configure étape par étape, les champs apparaissent dans l'ordre ci-dessous. Type de format, IBAN, Type d'adresse du créancier, et Nom du créancier sont obligatoires (astérisques dans Zapier); les autres champs sont facultatifs ou conditionnels.
Sortie et PDF placement : ensemble Type de format (PDF/PNG/JPEG/TIFF), carte facultative Déposer ou Déposer URL et Nom de fichier, choisir Options de pagination (ici Personnalisé (numéro de page) avec Numéro de page 2), alors Devise et Type de référence (exemple: CHF et QRR).
Paiement et créancier : Devise, Type de référence, Montant, IBANet structuré Créancier champs d'adresse (S = Structuré).
Débiteur, référence et champs avancés : facultatif Débiteur ultime détails, Référence (pour QRR/SCOR), Message non structuré, Informations de facturation (Swico), et AV1 / AV2 paramètres.
Paramètres
L'action « Créer une facture SwissQR » expose 26 champs, présentés dans le Zapier UI sous forme de cinq blocs défilables. Les captures d'écran ci-dessous reprennent l'ordre exact des champs et présentent les valeurs d'exemple vérifiées lors d'une exécution réelle.





Requis dans le Zapier UI (avec astérisque) : Type de format, IBAN, Type d'adresse du créancier, Nom du créancier. Conditionnel: Fichier ou fichier URL (l'un ou l'autre, utilisé lors de l'intégration) QR-facture dans un projet de loi existant PDF); Numéro de page (lorsque les options de pagination sont personnalisées). Fortement recommandé pour les Suisses valides QR-factures : Tous les champs d'adresse du créancier et du débiteur final. La norme suisse de paiement exige des données d'adresse complètes, même si… Zapier UI ne les marque pas d'astérisque.
| Paramètre | Requis | Ce que cela fait | Exemple |
|---|---|---|---|
| Format Type | Yes | Output file format. PDF for print-ready Swiss QR-bills (default), PNG/JPEG for digital web or email embedding, TIFF for archival quality, Empty/null for raw data. Asterisked in the Zapier UI. | PDF |
| File | Conditional | Base PDF where the Swiss QR-bill will be embedded. Either provide File or File URL, not both. Map binary content from a previous step (Dropbox, Google Drive, HTTP). Hint: "Either provide File or File URL". | Input sample (sample.pdf)1. File |
| File URL | Conditional | Public URL to the base PDF. Either provide File or File URL. PDF4me downloads the file and embeds the QR-bill onto it. | Input sample (sample.pdf)1. File |
| File Name | No | Output filename for the generated Swiss QR-bill document. Include the extension matching Format Type (.pdf, .png, .jpg, .tiff). | Output sample (sample.swissqr.pdf) |
| paging Options | No | Controls where the QR-bill is placed in the output PDF. First (top of doc), Last (final page), Add Page At End (appends a new dedicated QR-bill page), Custom (specific page index; requires Page Number below). | Custom (page number) |
| Page Number | Conditional | Specific page index for the QR-bill placement. Required when paging Options is Custom. Page index starts at 1. | 3 |
| Currency | No | Currency for the QR-bill payment amount. Only CHF (Swiss Franc, default for Swiss domestic) and EUR (cross-border) are valid per SPS specification. | CHF |
| Reference Type | No | Sent as code: NON (No Reference, for simple payments), QRR (27-digit QR Reference for QR-IBAN auto-reconciliation), or SCOR (ISO 11649 Creditor Reference for SEPA-compatible cross-border). | QRR |
| Language Type | No | Display language for printed QR-bill labels. Options: English, German, French, Italian. Match the recipient's Swiss region. | English |
| Separator Line | No | Visual separator between invoice body and QR-bill tear-off section. Options: "Line with Scissor" (Swiss standard for printed bills), Simple Line, No Line. | Line with Scissor |
| Amount | No | Payment amount in the chosen Currency. Enter as a number with up to two decimal places. Leave blank if the customer fills in the amount themselves. | 19432 |
| IBAN | Yes | Creditor's Swiss IBAN. Must start with CH and have 19 digits total. For QRR reference type, use a QR-IBAN (with QR-IID 30000-31999). Asterisked in the Zapier UI. | CH4431999123000889012 |
| Creditor Address Type | Yes | Address format for creditor information. Sent as code S (Structured, recommended for Swiss banking) or K (Combined, two free-form lines). Asterisked. | S |
| Creditor Name | Yes | Full name of the creditor (company or individual) as registered with the bank. Printed on the generated QR-bill. Asterisked. | muneer |
| Creditor: Street Name or Address Line 1 | No | Street name for the creditor (Structured) OR first free-form address line (Combined). Strongly recommended for valid SPS output. | vb vcb |
| Creditor: Building Number or Address Line 2 | No | House/building number (Structured) OR second free-form address line (Combined). | 1268 |
| Creditor City | No | Swiss city for the creditor. Must correspond to the Postal Code. | Zurich |
| Creditor Postal Code | No | Valid 4-digit Swiss postal code for the creditor. | 2501 |
| Ultimate Debtor Address Type | No | Address format for the party who will pay the bill. S (Structured) or K (Combined). Use S for automated processing. | S |
| Ultimate Debtor Name | No | Full name of the party who will pay. Appears in the payment section of the printed QR-bill. | Pia-Maria Rutschmann-Schnyder |
| Ultimate Debtor: Street Name or Address Line 1 | No | Debtor street name (Structured) or first free-form line (Combined). | Grosse Marktgasse |
| Ultimate Debtor: Building Number or Address Line 2 | No | Debtor house/building number or secondary address line. | 23 |
| Ultimate Debtor City | No | Swiss city of the debtor. | Rorschach |
| Ultimate Debtor Postal Code | No | Valid 4-digit Swiss postal code for the debtor. | 9400 |
| Reference | No | The actual reference value embedded in the QR code. Required content when Reference Type is QRR (27-digit numeric) or SCOR (ISO 11649 starting with RF). Empty when Reference Type is NON. | 210000000003139471430009017 |
| Unstructured Message | No | Free-form payment note printed on the QR-bill. Combined with Billing Info, max 140 characters total. Useful for invoice references when Reference Type is NON. | Instruction of 15.09.2019 |
| Billing Info | No | Structured billing information per Swiss QR-bill specification (Swico syntax). Encodes invoice number, date, VAT details. Combined with Unstructured Message, max 140 characters total. | S1/01/20170309/11/10201409/20/14000000/22/36958/30/CH106071086/40/1020/41/3010 |
| AV1 Parameters | No | Alternative procedure parameter 1 (AV1). Reserved for future Swiss payment alternative procedures and bilateral agreements between sender and receiver. | Name AV1: UV;UltraPay005;12345 |
| AV2 Parameters | No | Alternative procedure parameter 2 (AV2). Reserved for future Swiss payment alternative procedures. | Name AV2: XY;XYService;54321 |
Options de type de format
Contrôle le format du fichier de sortie du fichier suisse généré QR-facture.
PDFPar défaut (prêt à imprimer)PNGIntégration Web et numériqueJPEGimage compressée compatible avec l'envoi par e-mailTIFFQualité d'archivageVide (nul)Sortie de données brutesOptions de type de référence
Contrôle la norme de référence de paiement intégrée dans le QR Ce code a une incidence directe sur la manière dont les paiements sont rapprochés dans le relevé bancaire du bénéficiaire.
NONAucune référence (paiements simples)QRRQR Référence (rapprochement suisse à 27 chiffres)SCORERéférence du créancier (ISO 11649 SEPA)Options de type d'adresse
S'applique aux deux Type d'adresse du créancier et Type d'adresse du débiteur final.
SStructuré (recommandé)KCombinées (deux lignes libres)Options de pagination
Contrôles où le QR-bill est placé dans la sortie PDF lorsque le type de format est PDF.
D'abordDernierAjouter une page à la finPersonnalisé (numéro de page)Fichiers d'exemple
Utilisez ces fichiers pour tester Créer une facture SwissQR avant de câbler votre Zap sous tension. sample.pdf est le saisir: une plaine PDF vous mappez à Déposer (ou hôte à Déposer URL). sample.swissqr.pdf est le sortir: le même document après PDF4me ajoute le Suisse QR-section de paiement des factures avec votre configuration IBAN, créancier et champs de référence.
exemple.pdfsample.swissqr.pdfChamps de sortie
| Champ | Taper | Ce qu'il contient |
|---|---|---|
File Content | Binary | Generated Swiss QR-bill file (PDF/PNG/JPEG/TIFF). Map into the next step for upload, email, or further processing. See sample.swissqr.pdf for a PDF example. |
File Url | String | Direct URL to access the generated QR-bill, useful for sharing or downstream HTTP processing. |
File Name | String | Output filename without extension (for example sample.swissqr when the full name is sample.swissqr.pdf). |
Full File Name | String | Complete output filename with extension matching the chosen Format Type (for example sample.swissqr.pdf). |
Configuration rapide
- Dans Zapier, cliquez + pour ajouter une nouvelle action et sélectionner PDF4me.
- Choisir Créer une facture SwissQR comme événement d'action.
- Connectez votre PDF4me compte ou collez votre API appuyez sur la touche lorsque vous y êtes invité.
- Ensemble Type de format: PDF pour les factures imprimées, PNG/JPEG pour le web/courriel, TIFF pour les archives.
- Si l'intégration QR-facture dans un projet de loi existant PDF, carte Déposer OU Déposer URL (pas les deux) et choisissez Options de pagination (Les personnalisations nécessitent Numéro de page).
- Entrer Devise (
CHFpour les Suisses domestiques,EUR(pour les transactions transfrontalières), Montant, Type de référence (QRR/SCOR/NON), Type de langue, et Ligne de séparation. - Entrer IBAN (valable Suisse CH IBAN; pour QRR type de référence utiliser un QR-IBAN avec QR-IID 30000: 31999).
- Remplissez tous les champs Créancier Champs : Nom, Type d’adresse (S recommandé), Nom de la rue, Numéro du bâtiment, Ville, Code postal.
- Remplir Débiteur ultime champs contenant les coordonnées de la partie payeuse (même modèle structuré/combiné).
- Pour les cas complexes, ajoutez Référence (27 chiffres) QRR ou RF... SCOR), Message non structuré, Informations de facturation (Syntaxe Swico), AV1, AV2.
- Testez l'action avec des exemples de données, vérifiez le résultat et activez le Zap.
Exemples de flux de travail
Exemples de flux de travailCommon Zapier workflow patterns using Create SwissQR Bill.
- Un webhook Bexio, Sage ou Abacus se déclenche lorsqu'une nouvelle facture B2B est finalisée pour un client suisse.
- PDF4me Créer des exécutions SwissQR Bill : Type de format = PDF, Monnaie = CHF, Type de référence = QRR (avec QR-IBAN), Type de langue = allemand, Montant et IBAN cartographié à partir de la charge utile du webhook.
- Les champs du créancier sont issus de la fiche de votre entreprise ; les champs du débiteur final proviennent de la fiche client du système source.
- Un Gmail ou Outlook l'étape envoie le QR-facture PDF en pièce jointe à l'e-mail de facturation du client. Le fichier est entièrement SPS- Conforme aux normes et prêt pour le paiement instantané depuis n'importe quelle application bancaire suisse.
- Un journal Google Sheets ou Airtable enregistre l'identifiant de la facture, le client, le montant, QR Référence et horodatage pour le rapprochement des comptes clients.
- Un webhook de paiement Shopify, WooCommerce ou Stripe se déclenche lorsqu'un client suisse choisit « Payer par virement bancaire » au lieu de payer par carte.
- PDF4me Créer des exécutions SwissQR Bill : Type de format = PNG (intégration d'image), Monnaie = CHF, Type de référence = QRRMontant du total de la commande, type de langue correspondant aux paramètres régionaux du client.
- Le PNG L'image est intégrée directement dans un HTML Courriel de confirmation de commande afin que le client puisse le scanner directement dans son application bancaire pour payer.
- Paiement reçu → rapprochement bancaire QR Référence automatique à la commande d'origine.
- La commande Shopify est marquée comme payée et son traitement commence sans rapprochement manuel ni devinette du numéro de facture.
- Un calendrier par Zapier Les déclencheurs s'activent le 1er de chaque mois pour la facturation par abonnement mensuel. CHF.
- Une recherche dans Google Sheets ou Airtable permet de récupérer tous les abonnés actifs avec leurs identifiants. IBAN, adresse, montant et QR Modèle de référence.
- Une boucle par Zapier itère sur chaque abonné. PDF4me Créer une facture SwissQR en génère une QR-facture par rangée avec QRR Référence et pagination « Ajouter une page à la fin ».
- Chaque QR-facture PDF est envoyé par courriel à l'abonné via Gmail et archivé dans Microsoft SharePoint avec un modèle de nom de fichier comme
qrbill_{customerId}_{YYYY-MM}.pdf. - Un courriel récapitulatif mensuel envoyé à l'équipe financière indique le montant total facturé, le nombre d'abonnés et le nombre d'exceptions pour une visibilité claire des flux de trésorerie dès le premier jour.


