Módulo para WHMCS · cadastro de clientes · CPF e CNPJ

CPF e CNPJ conferidos no cadastro do WHMCS. Com o CNPJ alfanumérico, sem cliente duplicado.

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

Cadastro brasileiro certo desde o primeiro pedido.

CPF e CNPJ de verdade

Confere o dígito verificador no cadastro, no perfil, no checkout e no admin. Documento inventado não passa.

CNPJ alfanumérico

O CNPJ com letras, em uso desde julho de 2026, é aceito. Validadores antigos recusam e travam o cadastro.

Sem cliente duplicado

O mesmo CPF ou CNPJ em outro cadastro é barrado, comparado sem pontos e traços.

Endereço pelo CEP

O CEP preenche rua, bairro, cidade e estado na área do cliente, sem apagar o que ele digitou.

Empresa pelo CNPJ

O CNPJ numérico traz o nome da empresa e o endereço quando os campos estão vazios.

Máscara certa

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

As mensagens que o cliente lê.

Mensagens que o Brasa Cadastro Brasil devolve ao cadastro do WHMCS: CPF inválido, documento repetido, CNPJ sem nome da empresa e CEP incompleto
O que o cliente lê no cadastro. Mensagens reais do módulo, devolvidas pelo gancho de validação de um WHMCS 9.

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

Três passos, e o cadastro passa a conferir o documento.

1. Envie os arquivos

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.

2. Ative o addon

Em Configurações, Módulos Addon, ative o Brasa Cadastro Brasil, dê acesso ao seu grupo de administradores e confira as opções.

3. Teste um cadastro

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

O que perguntam antes de comprar.

O WHMCS já não valida o CPF?

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 alfanumérico?

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.

Onde ele confere?

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.

E o cliente repetido?

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.

Meu CPF/CNPJ fica num campo personalizado. Funciona?

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.

Como funciona o CEP e o CNPJ automáticos?

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.

Ele grava com máscara?

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.

O que já foi testado, e o que não foi?

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.

O que preciso para instalar?

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.

E se eu não renovar a licença?

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.

E os clientes que já estão cadastrados?

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

Sua loja tem algo diferente?

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.