Tutorial Swiss QR-bill

Tutto quello che devi sapere sul formato SPC a 31 righe obbligatorio sulle fatture svizzere dal 2020.

Cos'è un Swiss QR-bill

Dal 30 giugno 2020, ogni fattura in Svizzera deve includere un QR-bill («QR-Rechnung»), un blocco di pagamento standardizzato e leggibile da macchina stampato sulla distinta di pagamento. Sostituisce le vecchie distinte di versamento arancioni e rosse ES/ESR. Le banche svizzere (UBS, PostFinance, Raiffeisen, ZKB, ecc.) leggono il QR direttamente nelle loro app di mobile banking; i clienti lo scansionano e premono Paga.

Il payload SPC

Un Swiss QR-bill codifica un payload Swiss Payments Code (SPC), un blocco di 31 righe di testo UTF-8, ogni campo sulla propria riga, in un ordine rigido definito dal documento «Swiss Implementation Guidelines QR-bill» di SIX. Il payload inizia con SPC, termina con EPD (End Payment Data) e include campi per IBAN, creditore, creditore finale, importo, valuta, debitore, tipo di riferimento e riferimento creditore.

Campi obbligatori

• QRType: sempre SPC
• Version: 0200
• Coding: 1 (UTF-8)
• IBAN: IBAN svizzero o liechtensteinese (CH/LI); QR-IBAN richiesto se si usa il riferimento QRR
• Creditore: tipo di indirizzo (S=strutturato, K=combinato), nome, via, numero civico, CAP, città, paese
• Importo: opzionale; vuoto per le distinte «inserire importo»
• Valuta: CHF o EUR
• Debitore: opzionale
• Tipo di riferimento: QRR (riferimento QR), SCOR (riferimento creditore, ISO 11649) o NON
• Riferimento: la stringa di riferimento
• Trailer: EPD

La croce svizzera

Ogni Swiss QR-bill deve avere la sovrapposizione della bandiera svizzera rossa al centro del QR. Abundera QR la disegna automaticamente nelle proporzioni e posizioni corrette quando selezioni il tipo Swiss QR-bill. Senza la croce, le banche svizzere non accetteranno il QR.

Correzione degli errori

SIX impone il livello di correzione degli errori M per i Swiss QR-bill. La sovrapposizione della croce svizzera copre ~7% dei moduli, quindi la tolleranza ~15% del livello M è sufficiente.

Generarne uno

Apri il generatore Swiss QR-bill, inserisci IBAN, creditore, debitore opzionale, importo e riferimento. Scegli il tipo di riferimento che corrisponde al tuo IBAN (QRR per i QR-IBAN nell'intervallo istituzionale 30000-31999, altrimenti SCOR o NON). Scarica il PDF e includilo sulla tua distinta di pagamento.

Nota sulla privacy

Il tuo IBAN creditore, i nomi dei clienti e gli importi delle fatture non lasciano mai il tuo browser. Abundera QR non ha un backend per riceverli. Leggi l'informativa sulla privacy completa.