CPF e CNPJ de verdade
Confere o dígito verificador no cadastro, no perfil, no checkout e no admin. Documento inventado não passa.
Módulo para WHMCS · cadastro de clientes · CPF e CNPJ
O cadastro, o perfil e o checkout passam a conferir o CPF e o CNPJ pelo dígito verificador, aceitam o CNPJ com letras e barram o documento que já está em outro cadastro. O CEP preenche o endereço e o CNPJ preenche a empresa.
BR.S2 — O que o plugin faz
Confere o dígito verificador no cadastro, no perfil, no checkout e no admin. Documento inventado não passa.
O CNPJ com letras, em uso desde julho de 2026, é aceito. Validadores antigos recusam e travam o cadastro.
O mesmo CPF ou CNPJ em outro cadastro é barrado, comparado sem pontos e traços.
O CEP preenche rua, bairro, cidade e estado na área do cliente, sem apagar o que ele digitou.
O CNPJ numérico traz o nome da empresa e o endereço quando os campos estão vazios.
Grava 000.000.000-00 e 00.000.000/0000-00, do jeito que a nota fiscal e o boleto leem.
Testado com 18 casos e 10 mutações e, dentro de um WHMCS 9 real, pelos ganchos do próprio WHMCS: recusa do CPF errado, CNPJ alfanumérico aceito, máscara gravada e o documento de um cliente real barrado para outro. Antes de divulgar, faça um cadastro de teste na sua área do cliente.
R$ 49,90 por ano por instalação do WHMCS, no Pix, boleto ou cartão, com as atualizações e o suporte do ano, sem taxa por fatura. O arquivo é liberado na área do cliente assim que o pagamento é confirmado. As consultas de CEP e CNPJ são públicas e grátis (ViaCEP e BrasilAPI), feitas pelo navegador do cliente.
BR.S3 — Como fica na loja
Imagem montada com as mensagens reais do módulo. No seu WHMCS elas aparecem no formulário de cadastro, no tema da sua área do cliente.
BR.S4 — Como instalar
Na área do cliente, baixe o .zip e descompacte na pasta raiz do WHMCS, a que tem o init.php. Ele só cria arquivos novos.
Em Configurações, Módulos Addon, ative o Brasa Cadastro Brasil, dê acesso ao seu grupo de administradores e confira as opções.
Na sua área do cliente, tente cadastrar com um CPF errado e veja a mensagem; depois com um CEP, e veja o endereço preenchido.
BR.S5 — Perguntas frequentes
Não. O WHMCS só obriga o campo; com uma regra no campo personalizado ele confere o formato, não o dígito verificador, e aceita o mesmo CPF em dois cadastros. Este módulo confere os dígitos, barra o repetido e cobra o nome da empresa quando é CNPJ.
Aceita. O CNPJ com letras da Receita Federal, em uso desde julho de 2026, é conferido pelo dígito verificador como o numérico. Validadores antigos e regras de formato que circulam recusam esse CNPJ e travam o cadastro do cliente.
No cadastro novo, na edição do perfil, no checkout e quando você cadastra ou edita um cliente pelo admin. Cliente de fora do Brasil não é cobrado.
O mesmo CPF ou CNPJ em outro cadastro é barrado, comparado sem pontos e traços. Quem edita o próprio cadastro não é barrado por ele mesmo. A mensagem pode ser a sua, se você não quiser dizer que o documento já está cadastrado.
Funciona. O módulo acha sozinho o campo de cliente com CPF, CNPJ ou Documento no nome; sem ele, usa o Tax ID do WHMCS. Dá para fixar o campo nas opções.
Na área do cliente, ao digitar o CEP, a rua, o bairro, a cidade e o estado são preenchidos pelo ViaCEP. Ao digitar um CNPJ numérico, o nome da empresa e o endereço vêm da BrasilAPI. Só campo vazio é preenchido; o que o cliente digitou fica. A consulta sai do navegador do cliente, nada passa por servidor nosso.
Grava o documento do campo personalizado como 000.000.000-00 ou 00.000.000/0000-00, do jeito que a nota fiscal e o boleto leem. Documento de fora do Brasil fica como foi digitado.
As regras rodaram com 18 casos e 10 mutações, e o script do CEP e do CNPJ num navegador simulado. Dentro de um WHMCS 9 real, os três ganchos rodaram pelo próprio WHMCS: recusa do CPF errado, CNPJ alfanumérico aceito, máscara gravada e o documento de um cliente real barrado para outro e liberado para ele mesmo. Antes de divulgar, faça um cadastro de teste com um CPF errado na sua área do cliente.
WHMCS 8.8 ou mais novo, com PHP 8.1 ou mais novo. O CPF/CNPJ num campo personalizado de cliente ou no Tax ID.
O módulo continua funcionando no seu WHMCS como está, porque ele não consulta licença nem desliga recurso. A fatura da renovação sai 20 dias antes do vencimento; sem pagamento, a licença fica suspensa 30 dias depois e a área do cliente deixa de liberar as versões novas e o suporte.
Na versão 0.2, a tela do módulo em Addons lista os clientes do Brasil já cadastrados com CPF ou CNPJ inválido, vazio ou repetido, cada um com o link para abrir e corrigir. A tela não altera nenhum cadastro.
BR.S6 — Suporte
A consulta da situação na Receita fica de fora da versão 0.1. Se o seu WHMCS precisa de outra coisa, chame no WhatsApp. Você fala com quem escreveu o módulo.