Letra de controle do NIE

O NIE espanhol (Número de Identidad de Extranjero) é o identificador de estrangeiros usado em fluxos fiscais, bancários, de emprego e de residência na Espanha. Diferente de uma cadeia só de dígitos, cada NIE começa com X, Y ou Z, continua com sete dígitos e termina com uma letra de controle que prova que o corpo foi digitado ou armazenado sem um erro comum. Esta capacidade implementa o mapeamento oficial e a regra mod-23 compartilhada com as letras de controle do DNI: substitua 0 por X, 1 por Y ou 2 por Z, trate o resultado como inteiro de oito dígitos, tome esse inteiro módulo 23 e consulte a letra na tabela fixa TRWAGMYFPDXBNJZSQVHLCKE. Use o modo compute quando você tiver apenas o prefixo e os sete dígitos e precisar da letra final correta para um formulário ou importação de dados mestres; use o modo validate quando um parceiro, CRM ou usuário enviar um NIE completo e você precisar de um indicador valid claro mais a letra de controle esperada para mensagens de erro.

Como a letra de controle do NIE espanhol é calculada

Um NIE espanhol tem sempre nove caracteres quando escrito sem espaços ou hífens: uma letra inicial do conjunto X, Y, Z; sete dígitos decimais; e uma letra de controle final de A a Z (nem todas as letras aparecem — a tabela tem vinte e três posições). A letra inicial não é decorativa. Historicamente X, Y e Z marcam faixas sucessivas de números atribuídos a residentes estrangeiros; para a fórmula da letra de controle elas são reescritas como dígitos para reutilizar a mesma tabela do DNI.

Mapeie X para zero, Y para um e Z para dois, e concatene esse dígito com os sete caracteres numéricos para formar uma cadeia de oito dígitos como 01234567 para o corpo clássico X1234567. Interprete essa cadeia como inteiro (zeros à esquerda não alteram o valor modular) e calcule o resto da divisão por vinte e três.

Indexe na sequência oficial T, R, W, A, G, M, Y, F, P, D, X, B, N, J, Z, S, Q, V, H, L, C, K, E usando esse resto como índice baseado em zero. A letra nesse índice é a única letra de controle válida para esse corpo. Exemplo: X1234567 mapeia para 01234567, resto dezenove, letra de controle L, NIE completo X1234567L.

O algoritmo é determinístico e local: sem chamada de rede ao governo espanhol, sem consulta a registro e sem relógio. Esta ferramenta não confirma se uma pessoa possui cartão de residência ativo, não expande códigos provinciais e não afirma que uma soma de verificação válida signifique autorização do NIE para um regime fiscal específico — apenas prova que a letra final é consistente com a regra oficial mod-23.

Onde as checagens da letra do NIE se encaixam em fluxos reais

Equipes de RH e folha de pagamento integram colaboradores não espanhóis e devem anexar a letra de controle correta do NIE antes de gravar o identificador em contratos, declarações da segurança social ou arquivos de pagamento bancário que rejeitam IDs fiscais inválidos. Formulários de cadastro imobiliários, bancários e de telecom validam um NIE completo de nove caracteres na criação da conta para que uma única letra digitada errada não crie um cliente fantasma e um descompasso de conformidade.

Jobs de qualidade de dados percorrem cada coluna NIE em uma exportação de CRM ou ERP, chamam o modo validate e colocam em quarentena linhas onde valid é false — capturando edições humanas e bugs de geradores que confundem corpos só numéricos do DNI com regras de prefixo do NIE.

Não trate uma letra de NIE correta como prova de residência ativa junto às autoridades espanholas nem de um visto de trabalho específico; apenas prova que a letra de controle é consistente com o corpo de oito dígitos mapeado segundo a tabela padrão mod-23.