Dígito verificador CUSIP

Os identificadores CUSIP rotulam ações, títulos e outros valores mobiliários da América do Norte para que sistemas de liquidação, ordens e arquivos de carteira concordem no mesmo código de nove caracteres. Os primeiros oito identificam emissor e emissão; o nono é um dígito verificador calculado a partir do corpo, de modo que um erro de digitação ou uma transposição falhe com frequência antes de registrar uma operação no instrumento errado. Esta capacidade implementa esse algoritmo padrão de dígito verificador: mapeia dígitos e letras para valores, dobra posições alternadas, soma os dígitos decimais e devolve o dígito que torna o total múltiplo de dez. Use o modo compute quando dispuser apenas do corpo de oito caracteres e precisar do dígito final, ou o modo validate quando receber um CUSIP completo de nove e precisar de um booleano mais o dígito esperado para mensagens de erro.

Como o dígito verificador CUSIP é calculado

Um CUSIP tem nove caracteres no layout familiar estilo ANSI X9.6: seis para o emissor, dois para a emissão e um dígito verificador final. Cada caractere do corpo mapeia para um número: os dígitos de zero a nove permanecem como estão, as letras de A a Z tornam-se de dez a trinta e cinco, e os símbolos especiais asterisco, arroba e cerquilha valem trinta e seis, trinta e sete e trinta e oito quando aparecem.

Percorrendo os oito caracteres do corpo da esquerda para a direita, os valores das posições segunda, quarta, sexta e oitava são dobrados. Cada número resultante é reduzido somando seus dígitos decimais — por exemplo, quatorze vira cinco — para que valores grandes de letras não dominem o total. Essas somas de dígitos são adicionadas.

O dígito verificador é dez menos o total módulo dez, e esse resultado novamente módulo dez, o que produz um único dígito de zero a nove. Acrescentar esse dígito gera um CUSIP completo de nove caracteres cuja soma ponderada de dígitos é congruente com zero módulo dez.

Em comparação com dígitos verificadores de códigos de barras de varejo como EAN-13 ou com Luhn em cartões de pagamento, o CUSIP é alfanumérico e de comprimento fixo, por isso pertence às utilidades de codificação de identificadores de valores e não aos validadores de código de produto.

Modo compute versus modo validate

Envie um campo cusip que contenha apenas caracteres permitidos após a remoção opcional de espaços e hífens. O modo validate espera exatamente nove caracteres, com o nono sendo um dígito de zero a nove. Strings vazias, cusip ausente, comprimento errado para o modo escolhido, nono caractere não numérico em validate e valores de mode inválidos falham antes de qualquer soma ponderada e não são cobrados.

As letras são aceitas sem distinção de maiúsculas e normalizadas para maiúsculas na entrada ecoada, para que lotes possam colar texto misto de planilhas. Prefira compute ao completar um corpo de um fornecedor de dados que omite o dígito verificador; prefira validate quando um usuário, um arquivo de parceiro ou um scanner enviar um CUSIP completo e você precisar de um portão booleano antes de consultar o instrumento.

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

Corretoras e equipes de operações do lado comprador ingerem arquivos de posições e negociações de fim de dia em que um único caractere transposto pode contabilizar risco no título ou na ação errados. Validar cada CUSIP na importação e colocar em quarentena as linhas com valid false evita a poluição silenciosa do cadastro mestre.

Mesas de agente de transferência e de eventos corporativos recalculam dígitos verificadores ao montar códigos de emissor e emissão a partir de feeds separados, usando o modo compute para que o código de nove caracteres armazenado siga a convenção do setor. Testes de integração e jobs de qualidade de dados recalculam o dígito verificador esperado em cada linha de uma exportação CSV e marcam linhas cujo CUSIP completo armazenado não coincide mais, o que captura edições humanas e bugs de um a mais em geradores.

Não trate um controle CUSIP válido como prova de que o valor existe, é líquido ou está autorizado para negociação — apenas prova que a string de nove caracteres está bem formada sob este algoritmo, o mesmo critério de honestidade que se aplica a qualquer checksum.