Cifra di controllo ISIN

Un International Securities Identification Number (ISIN) è il codice di dodici caratteri che identifica in modo univoco un titolo tra i mercati secondo la norma ISO 6166. I primi due caratteri sono il codice paese, i nove successivi il numero nazionale di identificazione dei titoli (NSIN) e il dodicesimo è una cifra di controllo numerica ottenuta convertendo le lettere in numeri e applicando l'algoritmo di Luhn. Questa capacità implementa solo quella regola ufficiale: la modalità compute accetta esattamente undici caratteri alfanumerici e restituisce la cifra di controllo più l'ISIN completo di dodici; la modalità validate accetta un ISIN completo di dodici caratteri e indica se la cifra finale coincide con il valore atteso ricalcolato.

Come si calcola la cifra di controllo Luhn dell'ISIN

Secondo l'ISO 6166 un ISIN ha sempre dodici caratteri: due lettere maiuscole per il paese o la regione di emissione, nove caratteri alfanumerici per l'NSIN (spesso un numero nazionale con zeri iniziali, come un CUSIP o un SEDOL) e una cifra finale che è il carattere di controllo. Per calcolarla, prenda il corpo di undici caratteri ed espanda ogni lettera in due cifre decimali con la mappatura fissa A uguale a dieci fino a Z uguale a trentacinque, mentre le cifre decimali restano a una sola cifra.

Il risultato è una stringa solo di cifre la cui lunghezza dipende da quante lettere compaiono nel corpo: i codici paese contribuiscono sempre con quattro cifre perché entrambi i caratteri sono lettere. Applichi l'algoritmo classico di Luhn da destra di quella stringa espansa: raddoppi ogni seconda cifra a partire dalla cifra del corpo più a destra, perché una volta aggiunta la cifra di controllo quella del corpo occupa la posizione due da destra del numero completo.

Quando il doppio di una cifra è maggiore di nove, sottragga nove (in modo equivalente, sommi le decine e le unità del prodotto). Sommi tutti i valori pesati; la cifra di controllo è dieci meno quella somma modulo dieci, modulo dieci di nuovo, così che la sequenza completa di cifre inclusa la di controllo abbia un totale Luhn divisibile per dieci. La convalida ricalcola la cifra attesa dai primi undici caratteri e la confronta con la dodicesima, che deve sempre essere una cifra decimale da zero a nove.

L'algoritmo è deterministico e locale: nessuna chiamata a un registro di emittenti, nessun orologio e nessuna casualità. Rispetto agli strumenti Luhn per carte o IMEI, l'intento di ricerca qui è stretto: chi ha bisogno di una calcolatrice di cifra di controllo ISIN per un corpo di undici caratteri o di un verificatore di ISIN titoli di dodici, non di uno strumento di pagamento o di dispositivo.

Contratto di ingresso, modalità e comportamento di errore

Invii un campo code che, dopo trim e conversione in maiuscolo, contenga solo lettere da A a Z e cifre da zero a nove. Una lunghezza errata è un errore esplicito che nomina la modalità e la lunghezza inviata — undici per compute, dodici per validate — così i form client possono mostrare «servono undici caratteri» senza indovinare.

Stringhe vuote, code mancante, valori di mode non validi, un dodicesimo carattere non cifra in validate e un corpo che fallisce la forma due lettere più nove alfanumerici falliscono prima di qualsiasi somma Luhn e non vengono fatturati. Preferisca compute quando crea o completa ISIN per dati anagrafici ed etichette; preferisca validate quando condiziona un'operazione, un'importazione o una ricerca a un ISIN completo da un utente, un file partner o un feed di mercato.

Le attività di convalida che rifiutano forma errata non vengono addebitate; una stringa ben formata di dodici caratteri che ha semplicemente la cifra di controllo sbagliata restituisce valid false senza sollevare errori.

Dove le cifre di controllo ISIN si inseriscono nei flussi reali

Emittenti, agenti e agenzie di numerazione ricevono codici nazionali e devono aggiungere la cifra di controllo Luhn ufficiale prima di stampare un ISIN su prospetti, operazioni societarie o filing regolamentari. I moduli di onboarding di broker e custodi convalidano ISIN di dodici caratteri all'ingresso affinché una sola trasposizione non apra una posizione fantasma né un'istruzione di regolamento fallita.

I job ETL che caricano i master strumenti scorrono ogni colonna ISIN in un CSV o in una definizione di sicurezza FIX, chiamano la modalità validate e mettono in quarantena le righe dove valid è false — catturando sia modifiche umane sia bug dei generatori.

Non tratti un ISIN che supera il controllo come prova che il titolo sia quotato, liquido o privo di operazioni societarie; dimostra solo che la cifra Luhn è coerente con il paese e l'NSIN espansi sotto i pesi standard dell'ISO 6166 per l'identificazione internazionale dei titoli.