Calculadora e validador do dígito verificador do NIF português

Informe os oito primeiros dígitos para calcular o nono ou envie todos os nove para verificar se o dígito fornecido confere com o cálculo. O resultado é determinístico e imediato, adequado para formulários, importações, rotinas contábeis e validação por API. Comprimentos incorretos, caracteres que não sejam dígitos e modos incompatíveis são informados com clareza, sem correção ou suposição silenciosa.

Escolha entre calcular e validar

Use o modo de cálculo quando você já tiver a base de oito dígitos de um NIF português e precisar do dígito verificador final. A resposta inclui o dígito calculado e o valor completo de nove dígitos, permitindo inseri-lo diretamente em uma validação posterior ou em um fluxo de testes. Use o modo de validação quando a origem já contiver os nove dígitos. A validação separa os oito primeiros do nono fornecido, calcula o valor esperado e informa se os dois conferem. Ela também retorna os dígitos fornecido e esperado, facilitando o diagnóstico de uma falha. Mantenha a entrada como string, e não como valor numérico. A string preserva cada caractere exatamente, inclusive um zero inicial, e impede que a formatação numérica de uma planilha ou linguagem de programação altere o identificador antes da avaliação. O modo padrão é validar, pois a conferência de um NIF completo é a tarefa mais comum, mas você deve definir o modo explicitamente quando um fluxo aceitar os dois formatos.

Como funciona o cálculo de módulo onze

O algoritmo processa os oito primeiros dígitos da esquerda para a direita, com pesos decrescentes de nove até dois. Ele multiplica o primeiro dígito por nove, o segundo por oito e prossegue até multiplicar o oitavo por dois. Os oito produtos são somados e o total é reduzido pelo módulo onze. Quando o resto é zero ou um, o dígito verificador é zero. Para qualquer outro resto, o dígito é onze menos esse resto. A validação faz exatamente o mesmo cálculo nas oito primeiras posições e compara o resultado com a nona. Esta capacidade não remove espaços, pontos, hífens, prefixos de país nem rótulos antes do cálculo. Esse comportamento rigoroso é proposital: uma limpeza automática pode fazer dados malformados parecerem confiáveis e esconder erros anteriores no mapeamento de campos. Envie apenas dígitos ASCII de zero a nove. O cálculo não usa rede, valor aleatório, relógio, banco de dados ou conversão sensível à localidade; portanto, entradas e modos idênticos sempre produzem a mesma saída JSON.

Interprete o resultado e os limites

Um resultado verdadeiro significa que o nono dígito é compatível com a soma de verificação de módulo onze derivada dos oito anteriores. Essa é uma verificação estrutural útil para erros de digitação, importações danificadas e colunas mapeadas incorretamente, mas não comprova que o número tenha sido emitido, continue ativo ou pertença a determinada pessoa ou organização. Essas questões exigem um cadastro autorizado ou um processo empresarial apropriado. Da mesma forma, a calculadora avalia deliberadamente a soma de verificação sem impor suposições sobre categorias codificadas no primeiro dígito. Isso mantém o escopo preciso e evita a rejeição de um número com soma válida apenas porque uma regra externa de atribuição mudou. Em um pipeline de dados, trate erros de entrada de modo diferente de um resultado falso: um erro indica tipo, comprimento, caracteres ou modo incorretos; falso indica que um valor bem formado foi verificado, mas seu dígito não conferiu. Cada solicitação de API custa US$ 0,002, e o mesmo núcleo determinístico pode ser executado no navegador.