Validação de NIFs em Portugal: VIES não chega
No Gestix, validamos NIFs de clientes europeus através do serviço VIES da Comissão Europeia. Funciona bem para empresas, mas há uma limitação importante que vale a pena esclarecer: o VIES não valida NIFs de particulares.
Porquê?
O VIES (VAT Information Exchange System) é uma base de dados de sujeitos passivos de IVA registados para comércio intracomunitário. Em Portugal, isso inclui empresas e trabalhadores independentes registados em IVA — mas nunca particulares. Um NIF que comece por 1, 2 ou 3 (cidadãos residentes) jamais aparecerá no VIES. Se for consultado, o serviço devolve sempre “inválido”, o que não significa que o NIF esteja errado: significa apenas que não está registado para IVA.
Como validar NIFs de particulares
Existem essencialmente duas abordagens:
Validação offline pelo dígito de controlo. O NIF português tem 9 dígitos e usa um algoritmo módulo 11. Esta verificação apanha praticamente todos os erros de digitação — que, na prática, são a esmagadora maioria dos problemas reais. É instantânea, gratuita e funciona sem ligação à internet. Não confirma que o NIF está atribuído a alguém, mas confirma que é matematicamente válido e que o primeiro dígito corresponde a uma categoria existente (1, 2, 3 para particulares; 5 para empresas; 6 para entidades públicas; etc.).
Consulta à Autoridade Tributária. A AT disponibiliza webservices (consultarNIF na infraestrutura do e-fatura / SAF-T), mas o acesso é restrito ao próprio titular ou a aplicações certificadas com credenciais do utilizador. Não existe, por opção do legislador, uma API pública para validar NIFs de terceiros particulares — é uma proteção de privacidade.
Existem agregadores comerciais (NIF.PT e outros) que cruzam dados do registo comercial, mas apenas para entidades coletivas. Para particulares, não há alternativa pública.
A nossa abordagem no Gestix
Combinamos as duas vias: VIES para validar empresas europeias (incluindo a obtenção de nome e morada), e validação módulo 11 para NIFs portugueses de particulares. A decisão é tomada automaticamente em função do primeiro dígito do NIF — o utilizador não tem de escolher.
É a melhor combinação possível dentro daquilo que a legislação europeia e portuguesa permitem hoje.
Quer que eu guarde isto como ficheiro .md ou .docx para publicação?