Crea fattura SwissQR
Codice a barre → Crea fattura SwissQR
IL Crea fattura SwissQR API genera uno svizzero QR-conto PDF che sia conforme allo standard ufficiale svizzero. Invii una base PDF docContent, docName), dettagli del creditore (IBAN, nome, indirizzo), dati del debitore, quantità, valuta, referenceType, languageType, seperatorLinee facoltativamente IsAsync. IL API restituisce un PDF con la fattura SwissQR allegata. Utilizza il tester qui sotto per provarlo; maggiori dettagli sono disponibili nelle sezioni seguenti.
Prova a creare una fattura SwissQR API
:::nota - Guida rapida
Punto finale: POST /api/v2/CreateSwissQrBill · Necessario: api-key, docContent, docName, iban, crName, crAddressType, crStreetOrAddressLine1/2, crPostalCode, crCity, importo, valuta, udName, udAddressType, udStreetOrAddressLine1/2, udPostalCode, udCity, referenceType, languageType, seperatorLine, IsAsync
:::
Usa il modulo sottostante per inviare il tuo API chiave, PDF Base64), e tutti i campi relativi a creditori/debitori e pagamenti. La risposta è la PDF con gli svizzeri QR-fattura. Nessun codice richiesto, compila i campi e fai clic Invia richiesta.
Panoramica, parametri e casi d'uso
- Overview
- Parameters
- Use cases
Che cos'è la creazione di una fattura SwissQR?
Questo endpoint crea un Swiss QR-conto PDF che sia conforme allo standard ufficiale svizzero (giugno 2020). Fornisci una base PDF e dati di pagamento completi: creditore (IBAN, nome, indirizzo), debitore finale, importo, valuta, tipo di riferimento, lingua e stile del separatore. Il API restituisce un PDF con gli svizzeri QR-Fattura allegata, pronta per il versamento in banca e per il pagamento digitale.
Caratteristiche principali
- Conforme agli standard svizzeri: Informazioni di pagamento strutturate, dettagli del creditore/debitore, incorporate QR codee una disposizione adeguata.
- Dati di pagamento completi: IBAN, importo, valuta (CHF, EUR, USD), tipo di riferimento (QRR, NON, SCOR), lingua (inglese, tedesco, francese, italiano).
- Opzioni di separazione: seperatorLine: Linea con forbici, Linea tratteggiata con forbici o Linea continua per tagliare/strappare.
:::suggerimento Ideale per Da utilizzare per fatture, bollette o qualsiasi documento svizzero che debba riportare un'etichetta svizzera QR-fattura. Combinare con Leggi il codice SwissQR per verificare o estrarre i dati di pagamento da sistemi svizzeri esistenti QR-fatture. :::
API parametri
| Parametro | Tipo | Necessario | Descrizione |
|---|---|---|---|
| api-key | corda | SÌ | Tuo PDF4me API chiave, Base64 codificato. Prendilo da pannello di controllo. |
| docContent | base64 | SÌ | PDF contenuto del file (Base64). |
| docName | corda | SÌ | PDF Nome del file con estensione .pdf. |
| iban | corda | SÌ | svizzero IBAN per il creditore (ad esempio CH0200700110003765824). |
| crName, crAddressType, crStreetOrAddressLine1, crStreetOrAddressLine2, crPostalCode, crCity | corda | SÌ | Nome del creditore, tipo di indirizzo (S/K), via, codice postale, città. |
| quantità | corda | SÌ | Importo del pagamento (senza zeri iniziali). |
| valuta | corda | SÌ | CHF, EUR, O USD. |
| udName, udAddressType, udStreetOrAddressLine1, udStreetOrAddressLine2, udPostalCode, udCity | corda | SÌ | Nome e indirizzo del debitore finale. |
| referenceType | corda | SÌ | QRR, NON, O SCOR. |
| languageType | corda | SÌ | Inglese, tedesco, francese o italiano. |
| seperatorLine | corda | SÌ | LineaConForbici, LineaTratteggiataConForbici o Linea Continua. |
| IsAsync | booleano | SÌ | Abilita l'elaborazione asincrona. |
Quando utilizzare Crea fattura SwissQR
- Fatture e bollette: Aggiungi svizzero QR- Conversione delle fatture in ricevute per il pagamento digitale in Svizzera.
- Elaborazione dei pagamentiGenera fatture conformi per i flussi di lavoro di pagamento automatizzati.
- Attività bancaria e contabile: Integrare svizzero QR-creazione della fattura in banca o ERP sistemi.
- Conformità normativa: Soddisfa gli standard bancari e di pagamento svizzeri con il layout ufficiale e QR code.
Per schemi di richiesta/risposta ed esempi di codice, vedere Crea fattura SwissQR nel PDF4me API documenti.
Prerequisiti
Prima di utilizzare questo endpoint, assicurati di avere:
- Un valido PDF4me API chiave (Ottieni il tuo API Chiave)
- UN PDF documento da allegare alla fattura SwissQR
- Tutte le informazioni di pagamento richieste (IBAN, dati del creditore, dati del debitore, importo, valuta)
- IL PDF file codificato in Base64 formato
Formato di risposta
IL API restituisce un PDF file con la fattura SwissQR. Stato 200 restituisce il PDF nel corpo della risposta; Stato 202 significa che l'elaborazione è asincrona, interroga il Location intestazione URL fino al PDF è pronto.