Dígito verificador ISIN

Um International Securities Identification Number (ISIN) é o código de doze caracteres que identifica de forma única um valor mobiliário entre mercados segundo a ISO 6166. Os dois primeiros caracteres são o código de país, os nove seguintes o número nacional de identificação de valores (NSIN) e o décimo segundo é um dígito verificador numérico obtido convertendo letras em números e aplicando o algoritmo de Luhn. Esta capacidade implementa apenas essa regra oficial: o modo compute aceita exatamente onze caracteres alfanuméricos e devolve o dígito verificador mais o ISIN completo de doze; o modo validate aceita um ISIN completo de doze caracteres e indica se o dígito final coincide com o valor esperado recalculado.

Como o dígito verificador Luhn do ISIN é calculado

Segundo a ISO 6166 um ISIN tem sempre doze caracteres: duas letras maiúsculas para o país ou região de emissão, nove caracteres alfanuméricos para o NSIN (muitas vezes um número nacional preenchido com zeros, como um CUSIP ou SEDOL) e um dígito final que é o caractere de verificação. Para calculá-lo, tome o corpo de onze caracteres e expanda cada letra em dois dígitos decimais com o mapeamento fixo A igual a dez até Z igual a trinta e cinco, enquanto os dígitos decimais permanecem de um só dígito.

O resultado é uma cadeia só de dígitos cujo comprimento depende de quantas letras há no corpo: os códigos de país contribuem sempre com quatro dígitos porque ambos os caracteres são letras. Aplique o algoritmo clássico de Luhn a partir da direita dessa cadeia expandida: dobre cada segundo dígito começando pelo dígito do corpo mais à direita, porque depois de acrescentar o verificador esse dígito do corpo fica na posição dois a partir da direita do número completo.

Quando o dobro de um dígito é maior que nove, subtraia nove (de forma equivalente, some as dezenas e as unidades do produto). Some todos os valores ponderados; o dígito verificador é dez menos essa soma módulo dez, módulo dez de novo, de modo que a sequência completa de dígitos incluindo o verificador tenha um total Luhn divisível por dez. A validação recalcula o dígito esperado a partir dos onze primeiros caracteres e compara-o com o décimo segundo, que deve ser sempre um dígito decimal de zero a nove.

O algoritmo é determinístico e local: sem chamada a um registro de emitentes, sem relógio e sem aleatoriedade. Esta ferramenta não resolve ISIN para nomes, não trata FIGI ou outros identificadores alternativos e não prova que um código está ativo em uma bolsa: apenas prova que a cadeia está bem formada sob a regra Luhn da ISO 6166.

Em comparação com ferramentas Luhn de cartão ou IMEI, a intenção de busca aqui é estreita: quem precisa de uma calculadora de dígito verificador ISIN para um corpo de onze caracteres ou de um verificador de ISIN de valores de doze, não de uma ferramenta de pagamento ou de dispositivo.

Contrato de entrada, modos e comportamento de erro

Envie um campo code que, após trim e conversão para maiúsculas, contenha apenas letras de A a Z e dígitos de zero a nove. Comprimento incorreto é um erro explícito que nomeia o modo e o comprimento enviado —onze para compute, doze para validate— para que formulários cliente mostrem «são necessários onze caracteres» sem adivinhar.

Strings vazias, code ausente, valores de mode inválidos, um décimo segundo caractere não dígito em validate e um corpo que falha a forma de duas letras mais nove alfanuméricos falham antes de qualquer soma Luhn e não são cobrados. Prefira compute quando criar ou completar ISIN para dados mestres e rótulos; prefira validate quando condicionar uma operação, importação ou consulta a um ISIN completo de um usuário, arquivo de parceiro ou feed de mercado.

Tarefas de validação que rejeitam forma incorreta não são cobradas; uma string bem formada de doze caracteres que simplesmente tem o dígito verificador errado devolve valid false sem lançar erro.

Onde os dígitos verificadores ISIN se encaixam em fluxos reais

Emitentes, agentes e agências de numeração recebem códigos nacionais e devem acrescentar o dígito verificador Luhn oficial antes de imprimir um ISIN em prospectos, eventos corporativos ou filings regulatórios. Formulários de onboarding de corretoras e custodians validam ISIN de doze caracteres na entrada para que uma única transposição não abra uma posição fantasma nem uma instrução de liquidação falha.

Jobs ETL que carregam mestres de instrumentos percorrem cada coluna ISIN em um CSV ou definição de segurança FIX, chamam o modo validate e colocam em quarentena as linhas onde valid é false — capturando tanto edições humanas quanto bugs de geradores.

Não trate um ISIN que passa a verificação como prova de que o valor está cotado, é líquido ou está livre de eventos corporativos; apenas prova que o dígito Luhn é consistente com o país e o NSIN expandidos sob os pesos padrão da ISO 6166 para identificação internacional de valores.