Verifica della QR-fattura svizzera
Incolli il contenuto grezzo di un codice QR svizzero oppure trascini un PDF o un'immagine di una QR-fattura. Ogni campo viene verificato secondo le Implementation Guidelines di SIX (v2.3, incluse le modifiche della v2.4 da novembre 2026).
Cosa controlliamo
- ✓Intestazione: tipo QR SPC, versione 0200, tipo di codifica 1
- ✓Cifre di controllo IBAN, solo CH/LI, QR-IBAN o IBAN normale
- ✓Riferimento: cifra di controllo QRR (modulo 10 ricorsivo), cifre di controllo SCOR (ISO 11649), NON vuoto
- ✓Indirizzi di beneficiario e debitore: solo strutturati (S) da novembre 2025, campi obbligatori, lunghezza dei campi, codice paese
- ✓Formato e intervallo dell'importo, valuta CHF o EUR
- ✓QR-IBAN e riferimento QR solo in CHF (IG v2.4, dal 14 novembre 2026)
- ✓Lunghezza di comunicazione e informazioni di fatturazione (max. 140 in totale), procedure alternative (max. 100)
- ✓Set di caratteri, numero di righe, chiusura EPD e limite di 997 caratteri
Da usare nel codice
Gli stessi controlli, come API JSON gratuita. Nessuna chiave richiesta, limite di richieste per IP. Documentazione API completa →
curl -X POST https://swissinvoice.dev/api/v1/qr-bill/validate \
-H "Content-Type: text/plain" \
--data-binary @payload.txtDomande frequenti
Come ottengo il testo contenuto in una QR-fattura?
+
Trascini su questa pagina il PDF o una foto della fattura: decodifichiamo il codice QR nel Suo browser. In alternativa, lo scansioni con una qualsiasi app per codici QR e incolli il testo. Il contenuto inizia sempre con la riga SPC.
Gli indirizzi combinati (tipo K) sono ancora ammessi?
+
No. Dal 21 novembre 2025 le banche svizzere accettano solo indirizzi strutturati (tipo S) con NPA e località separati. Le fatture con indirizzi di tipo K vengono respinte, perciò questo strumento le segnala come errori.
Qual è la differenza tra un QR-IBAN e un IBAN normale?
+
Un QR-IBAN ha un identificativo dell'istituto (posizioni 5–9) compreso tra 30000 e 31999 e va utilizzato con un riferimento QR (QRR) di 27 cifre. Un IBAN normale si usa con un riferimento creditore (SCOR) o senza riferimento (NON).
Perché il mio riferimento QR non supera la verifica della cifra di controllo?
+
L'ultima delle 27 cifre è una cifra di controllo calcolata con l'algoritmo modulo 10 ricorsivo. Se genera i riferimenti autonomamente, il messaggio di errore indica quale cifra di controllo è attesa.
I miei dati vengono salvati?
+
No. I file caricati vengono decodificati localmente nel Suo browser. Il testo decodificato viene inviato alla nostra API per la verifica e non viene salvato.
Le servono fatture complete, non solo la parte QR?
Magic Heidi crea fatture con QR-fattura, tiene traccia di pagamenti e spese — su iPhone, Android, Mac e web.