Créer une facture SwissQR
code-barres → Créer une facture SwissQR
Le Créer une facture SwissQR API génère un suisse QR-facture PDF qui est conforme à la norme suisse officielle. Vous envoyez une base PDF (docContent, docName), les détails du créancier (IBAN, nom, adresse), coordonnées du débiteur, montant, devise, referenceType, languageType, seperatorLineet éventuellement IsAsync. Le API renvoie un PDF avec la facture SwissQR jointe. Utilisez l'outil de test ci-dessous pour l'essayer ; vous trouverez plus de détails dans les sections suivantes.
Essayez Create SwissQR Bill API
Point final : POST /api/v2/CreateSwissQrBill · Requis: api-key, docContent, docName, iban, crName, crAddressType, crStreetOrAddressLine1/2, crPostalCode, crCity, montant, devise, udName, udAddressType, udStreetOrAddressLine1/2, udPostalCode, udCity, referenceType, languageType, seperatorLine, IsAsync
Utilisez le formulaire ci-dessous pour envoyer votre API clé, PDF (Base64), et tous les champs créancier/débiteur et paiement. La réponse est la PDF avec les Suisses QR-bill. Aucun code requis, remplissez les champs et cliquez Envoyer une requête.
Aperçu, paramètres et cas d'utilisation
- Overview
- Parameters
- Use cases
Qu'est-ce que Create SwissQR Bill ?
Ce point de terminaison crée un Suisse QR-facture PDF qui est conforme à la norme suisse officielle (juin 2020). Vous fournissez une base PDF et données de paiement complètes : créancier (IBAN, nom, adresse), débiteur final, montant, devise, type de référence, langue et style de séparateur. API renvoie un PDF avec les Suisses QRFacture jointe, prête pour le paiement bancaire et numérique.
Caractéristiques principales
- conforme aux normes suissesInformations sur les paiements structurés, coordonnées du créancier/débiteur, intégrées QR codeet une disposition appropriée.
- Données de paiement complètes: IBAN, montant, devise (CHF, EUR, USD), type de référence (QRR, NON, SCOR), langue (anglais, allemand, français, italien).
- Options de séparation: seperatorLine: Ligne avec ciseaux, Ligne pointillée avec ciseaux ou Ligne continue pour couper/déchirer.
Conseil : Idéal pour
À utiliser pour les factures suisses, les notes de frais ou tout document devant comporter une mention suisse. QR-bill. Combiner avec Lire le code SwissQR vérifier ou extraire des données de paiement de Suisses existants QR-factures.
:::
API paramètres
| Paramètre | Taper | Requis | Description |
|---|---|---|---|
| api-key | chaîne | Oui | Ton PDF4me API clé, Base64 encodé. Obtenez-le depuis le tableau de bord. |
| docContent | base64 | Oui | PDF contenu du fichier (Base64). |
| docName | chaîne | Oui | PDF Nom du fichier avec l'extension .pdf. |
| iban | chaîne | Oui | Suisse IBAN pour le créancier (par exemple CH0200700110003765824). |
| crName, crAddressType, crStreetOrAddressLine1, crStreetOrAddressLine2, crPostalCode, crCity | chaîne | Oui | Nom du créancier, type d'adresse (S/K), rue, code postal, ville. |
| montant | chaîne | Oui | Montant du paiement (sans zéros non significatifs). |
| devise | chaîne | Oui | CHF, EUR, ou USD. |
| udName, udAddressType, udStreetOrAddressLine1, udStreetOrAddressLine2, udPostalCode, udCity | chaîne | Oui | Nom et adresse du débiteur final. |
| referenceType | chaîne | Oui | QRR, NON, ou SCOR. |
| languageType | chaîne | Oui | Anglais, allemand, français ou italien. |
| seperatorLine | chaîne | Oui | Ligne avec ciseaux, Ligne pointillée avec ciseaux ou Ligne continue. |
| IsAsync | booléen | Oui | Activer le traitement asynchrone. |
Quand utiliser Create SwissQR Bill
- Factures et notes de fraisAjouter Suisse QR-factures pour paiement numérique en Suisse.
- Traitement des paiementsGénérer des factures conformes pour les flux de paiement automatisés.
- Services bancaires et comptabilitéIntégrer la Suisse QR-création de factures dans le secteur bancaire ou ERP systèmes.
- Conformité réglementaire: Respectez les normes bancaires et de paiement suisses grâce à la mise en page officielle et QR code.
Pour les schémas de requête/réponse et des exemples de code, voir Créer une facture SwissQR dans le PDF4me API documents.
Prérequis
Avant d'utiliser ce point de terminaison, assurez-vous d'avoir :
- Un valide PDF4me API clé (Obtenez votre API Clé)
- UN PDF document auquel joindre la facture SwissQR
- Toutes les informations de paiement requises (IBAN, coordonnées du créancier, coordonnées du débiteur, montant, devise)
- Le PDF fichier encodé en Base64 format
Format de réponse
Le API renvoie un PDF déposer avec la facture SwissQR. Statut 200 renvoie le PDF dans le corps de la réponse ; Statut 202 signifie que le traitement est asynchrone, interrogez le Location en-tête URL jusqu'à ce que PDF est prêt.