O cadastro padrão do Magento foi criado para um cenário internacional. Em operações brasileiras, porém, é comum precisar diferenciar Pessoa Física e Pessoa Jurídica, coletar CPF ou CNPJ, organizar endereço no padrão local e aplicar regras específicas de validação. O Mage2 CPF/CNPJ Account centraliza essas necessidades em um fluxo configurável para cadastro, conta do cliente e checkout.
Vídeo demonstrativo
Veja o cadastro de Pessoa Física e Jurídica em funcionamento
A demonstração apresenta a escolha entre PF e PJ, os campos de CPF e CNPJ, as validações, o endereço brasileiro e as configurações administrativas do módulo.
O que o módulo resolve?
Em uma loja brasileira, identificar corretamente o tipo de cliente evita formulários improvisados e reduz inconsistências entre cadastro, checkout, faturamento e integrações. O módulo apresentado no vídeo adiciona uma camada específica para esse cenário, permitindo que o administrador defina quais tipos de pessoa serão aceitos e em quais pontos os dados devem ser apresentados.
Na demonstração, o cliente visualiza duas opções logo no início do cadastro: Pessoa Física, com CPF, e Pessoa Jurídica, com CNPJ. A loja pode trabalhar com os dois perfis ou restringir o fluxo conforme sua operação.
Cadastro de Pessoa Física
No fluxo de Pessoa Física, o cadastro exibido no vídeo reúne o CPF aos dados pessoais tradicionais do Magento, como nome, sobrenome e, quando habilitada, data de nascimento. O endereço pode ser preenchido no mesmo fluxo, evitando que o cliente conclua uma conta sem as informações que a operação considera necessárias.
O ponto importante é que a presença de cada informação é administrável. O lojista pode decidir, por exemplo, se o telefone deve aparecer no cadastro ou somente no checkout, se a data de nascimento será exibida e se será obrigatória, além de controlar a necessidade de endereço no momento da criação da conta.
Cadastro de Pessoa Jurídica
Para operações B2B, atacado ou lojas que também vendem para empresas, o módulo permite trabalhar com um fluxo de Pessoa Jurídica. Além do CNPJ, a configuração demonstrada contempla a Inscrição Estadual (IE) e a possibilidade de torná-la obrigatória.
O formulário também pode acomodar os campos necessários à identificação da empresa e do responsável, mantendo o endereço estruturado no padrão adotado pela loja. Essa separação é especialmente útil quando regras comerciais, integrações fiscais, tabelas de preço ou processos internos distinguem clientes PF e PJ.
Configurações gerais no painel do Magento 2
O vídeo mostra o módulo dentro de Stores > Configuration, em uma seção dedicada ao cadastro brasileiro. A partir dali, o administrador controla o comportamento do recurso sem precisar alterar o formulário diretamente no código para cada regra de negócio.
Tipos de pessoa
Permite trabalhar com Pessoa Física, Pessoa Jurídica ou ambos os perfis.
CPF/CNPJ no cadastro
Controla a exibição dos documentos na criação da conta.
CPF/CNPJ no checkout
Permite solicitar ou apresentar o documento durante a finalização da compra.
Endereço e telefone
Há controles separados para exibição de endereço, telefone no cadastro e telefone no checkout.
Data de nascimento
Pode ser exibida para Pessoa Física e configurada como obrigatória ou opcional.
Cadastro em modal
O painel apresenta opção para abrir a criação de conta em um modal, em vez de direcionar para outra página.
Validação de CPF/CNPJ e prevenção de cadastros duplicados
Um dos pontos mais relevantes do módulo está nas regras de consistência do documento. O painel demonstrado possui opções para verificar CPF/CNPJ duplicado e validar os dígitos verificadores.
Na prática, essas regras ajudam a impedir que um mesmo documento seja associado a múltiplas contas e bloqueiam números que não passam pela validação estrutural de CPF ou CNPJ. O administrador também pode definir se o documento será obrigatório para criar a conta e se o cliente poderá editá-lo posteriormente.
Endereço adaptado ao padrão brasileiro
Outro problema comum em implementações brasileiras é o uso genérico das linhas de endereço do Magento. O módulo demonstrado permite dar nomes claros para essas linhas e definir quais serão obrigatórias.
No exemplo do vídeo, a configuração utiliza:
- Linha 1: Rua;
- Linha 2: Número;
- Linha 3: Bairro;
- Linha 4: Complemento.
Também há uma opção para bloquear pedidos com endereço incompleto. Isso é útil em lojas que já possuem contas antigas, importadas ou criadas por integrações, nas quais algum campo obrigatório pode ter ficado ausente.
Personalização do seletor e do formulário
O módulo não se limita aos dados. O vídeo mostra uma seção de Aparência, na qual o administrador pode escolher o estilo do seletor de tipo de pessoa e configurar cores de fundo e texto do formulário.
Na demonstração, o estilo utilizado é em cartões, deixando Pessoa Física e Pessoa Jurídica visualmente separadas. Essa abordagem facilita a compreensão do usuário antes mesmo de ele começar a preencher os dados.
O que fazer com clientes antigos sem CPF ou CNPJ?
Esse é um cenário importante em projetos de migração, redesign ou modernização de lojas antigas. Uma base existente pode conter clientes que foram criados antes de o documento ser exigido.
O painel demonstrado possui a opção “Exigir CPF/CNPJ de Clientes Logados”. Quando habilitada, ela permite direcionar clientes sem documento para a atualização da conta. Há também uma opção de modal de aviso e um campo para personalizar o texto apresentado ao usuário.
Assim, a loja consegue evoluir sua regra de cadastro sem depender de uma atualização manual de cada conta antiga.
Integração com o checkout e consistência de dados
O cadastro não deve ser analisado isoladamente. Em uma operação Magento 2, os dados do cliente podem impactar checkout, meios de pagamento, antifraude, ERP, emissão fiscal, CRM e regras B2B. Por isso, o módulo oferece controles separados para exibição de CPF/CNPJ e telefone durante o checkout.
A vantagem de centralizar essas regras é reduzir divergências entre a conta criada pelo cliente e os dados exigidos no momento do pedido. Em uma implantação real, a configuração ideal deve considerar também quais integrações consomem esses campos e quais deles são efetivamente necessários em cada etapa.
Cadastro completo até os dados de acesso
Depois das informações pessoais e de endereço, o formulário segue para os dados de acesso da conta, como e-mail e senha. O vídeo demonstra o fluxo completo até a ação de criação da conta, mantendo a experiência dentro do layout da loja.
Onde esse módulo faz mais diferença?
E-commerce B2C
Padroniza CPF, endereço e dados pessoais para consumidores brasileiros.
B2B e atacado
Permite separar Pessoa Jurídica, CNPJ e Inscrição Estadual dentro do fluxo de conta.
Migração de plataformas
Ajuda a tratar bases antigas com clientes incompletos após importação ou mudança de plataforma.
Magento Luma para Hyvä
Na demonstração, o recurso aparece integrado a uma loja com Hyvä, mantendo o cadastro dentro da experiência visual do frontend.
Cuidados de implementação
CPF, CNPJ, data de nascimento, telefone e endereço são dados que precisam ser tratados com responsabilidade. O uso do módulo não substitui a definição de uma política de privacidade, base legal, controles de acesso, retenção adequada e demais práticas necessárias à operação.
Também é recomendável revisar integrações existentes antes de tornar novos campos obrigatórios. ERP, antifraude, gateway, emissão fiscal e sistemas de atendimento podem esperar formatos específicos ou depender de dados existentes na conta.
Perguntas frequentes sobre CPF e CNPJ no Magento 2
O módulo permite cadastrar Pessoa Física e Pessoa Jurídica?
Sim. O painel permite configurar os tipos aceitos e, quando ambos estão habilitados, o cliente pode escolher entre Pessoa Física e Pessoa Jurídica no formulário.
É possível impedir CPF ou CNPJ duplicado?
Sim. A demonstração mostra uma configuração específica para verificar documentos duplicados antes de concluir o cadastro.
O módulo valida se o CPF ou CNPJ existe na Receita Federal?
O recurso demonstrado valida os dígitos verificadores, ou seja, a estrutura do documento. Uma consulta cadastral externa à Receita Federal exige outro tipo de integração.
É possível exibir CPF ou CNPJ no checkout?
Sim. Há um controle específico para exibir CPF ou CNPJ durante o checkout, independentemente da configuração do cadastro.
A Inscrição Estadual pode ser obrigatória?
Sim. A configuração exibida inclui a opção de tornar a Inscrição Estadual obrigatória no fluxo de Pessoa Jurídica.
Posso impedir que o cliente edite o CPF ou CNPJ depois do cadastro?
Sim. O painel possui uma opção para permitir ou impedir a edição posterior do documento.
O que acontece com clientes antigos que não possuem CPF ou CNPJ?
A loja pode exigir o documento de clientes já logados e apresentar um aviso orientando a atualização da conta.
Magento 2 adaptado à operação brasileira
A Mage2 Commerce trabalha com desenvolvimento, evolução e sustentação de lojas Magento 2, incluindo projetos com Hyvä Theme, B2B, integrações e funcionalidades específicas para o mercado brasileiro.
Se sua operação precisa organizar cadastro de Pessoa Física e Jurídica, CPF/CNPJ, endereço, checkout ou regras comerciais específicas, esse tipo de recurso pode ser planejado dentro da arquitetura da sua loja.
Site: www.mage2.com.br
YouTube: youtube.com/@mage2commerce
Material elaborado com base no vídeo demonstrativo do Mage2 CPF/CNPJ Account. As telas e opções podem evoluir conforme a versão do módulo e do projeto Magento.