- Este recurso coloca cada cliente automaticamente no grupo certo no momento do cadastro, com base no documento informado.
- Quem se cadastra com CPF vai para um grupo (pessoa física); quem se cadastra com CNPJ vai para outro (pessoa jurídica/atacado).
- O documento é validado: CPF/CNPJ inválido ou incompleto direciona o cliente para grupos separados, definidos por você.
- Funciona tanto no cadastro pela loja quanto no cadastro feito durante o checkout, na sua loja Magento 1.
Passo a Passo por Escrito
1. Acesse as opções de criação de conta
No topo, vá em Sistema → Configuração.
No menu lateral, dentro de Clientes, clique em Configuração.
Abra a seção Opções ao Criar Nova Conta.
Antes de começar, confirme que os grupos de clientes que você vai usar (por exemplo Comum e Atacado) já existem em Clientes → Grupos de Clientes. Você vai selecioná-los nos próximos passos.
Resultado esperado: A seção Opções ao Criar Nova Conta é exibida com os campos de configuração.
2. Ative o gerenciamento automático de grupos
No campo Gerenciar Cadastro de Grupos Automaticamente, selecione Sim. Ao marcar Sim, novos campos aparecem logo abaixo (a escolha do documento e os grupos de destino), que você preenche nos próximos passos.
Resultado esperado: Surgem os campos Verificar No e os campos de grupo (CPF, CNPJ, inválidos, etc.).
3. Escolha verificar pelo Tipo de Pessoa (Cadastro)
No campo Verificar No, selecione a opção Tipo de Pessoa (Cadastro).
Esse campo tem três opções, e vale entender a diferença antes de escolher:
- Endereço de Cobrança e Endereço de Entrega: validam o documento a partir do endereço do cliente. Só entram em ação quando o cliente salva um endereço — o que, na prática, acontece no checkout.
- Tipo de Pessoa (Cadastro): valida o documento no próprio cadastro, pelo CPF/CNPJ informado na criação da conta, sem depender de endereço.
Na maioria das lojas o cliente cria a conta pela página de cadastro (que pede apenas nome, e-mail, senha e CPF/CNPJ — sem endereço) e só informa o endereço depois, no checkout. Com Endereço de Cobrança ou Endereço de Entrega, o grupo só seria definido quando (e se) o cliente salvasse um endereço — ou seja, ele ficaria sem o grupo correto logo após o cadastro. Justamente por isso, para atribuir o grupo já no momento do cadastro, use Tipo de Pessoa (Cadastro).
As opções por endereço continuam existindo e podem ser úteis se o seu fluxo exigir endereço já no cadastro. Se esse não for o caso da sua loja (o mais comum), fique com Tipo de Pessoa (Cadastro).
Resultado esperado: O campo Verificar No fica com Tipo de Pessoa (Cadastro) selecionado.
4. Defina os grupos de destino
Agora indique para qual grupo cada tipo de cliente deve ir. Preencha:
- Grupo Padrão — o grupo base do cliente (por exemplo, Comum).
- Grupo com CPF Válido — para quem se cadastra com um CPF válido (pessoa física).
- Grupo com CNPJ Válido — para quem se cadastra com um CNPJ válido (pessoa jurídica/atacado).
- Grupo de CPF/CNPJ Inválidos — para documentos que não passam na validação.
- Grupo com Problemas de Validação — para quando o documento vem em branco ou fora do formato esperado.
Você pode apontar mais de um campo para o mesmo grupo. Por exemplo, se não quiser tratar inválidos de forma diferente, aponte Grupo de CPF/CNPJ Inválidos e Grupo com Problemas de Validação para o mesmo grupo do Grupo Padrão.
Resultado esperado: Todos os campos de grupo ficam preenchidos, sem nenhum como "Selecione...".
5. Mantenha a mudança de grupo ativa
Confirme que o campo Desabilitar Mudança de Grupo p/ Clientes está em Não.
Se este campo estiver em Sim, a troca automática de grupo é bloqueada e o cliente não será movido para o grupo do CPF/CNPJ. Para o recurso funcionar, deixe em Não.
O campo Validar a Cada Transação pode ficar em Não. Ele serve para revalidar o documento a cada compra; para o objetivo de classificar o cliente no cadastro, não é necessário.
Resultado esperado: Desabilitar Mudança de Grupo p/ Clientes em Não.
6. Salve e atualize o cache
Clique em Salvar no canto superior direito.
Em seguida, vá em Sistema → Cache, selecione Todos os tipos, escolha a ação Atualizar e clique em Enviar.
As alterações só passam a valer na loja depois de atualizar o cache.
Pronto! Dessa forma configuramos a atribuição automática de grupo por CPF/CNPJ no cadastro em sua loja virtual Magento 1.
Validação e Testes
Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.
Teste 1 — Cadastro com CPF válido
Ação: crie uma conta de teste na loja informando um CPF válido.
Resultado esperado: o cliente é criado já no grupo definido em Grupo com CPF Válido. Confira em Clientes → Gerenciar Clientes, na coluna de grupo.
Teste 2 — Cadastro com CNPJ válido
Ação: crie outra conta de teste informando um CNPJ válido.
Resultado esperado: o cliente é criado no grupo definido em Grupo com CNPJ Válido (por exemplo, Atacado).
Teste 3 — Documento inválido
Ação: tente cadastrar informando um número de documento inválido (dígitos incorretos).
Resultado esperado: o cliente cai no grupo definido em Grupo de CPF/CNPJ Inválidos, e não no grupo de CPF/CNPJ válido.
Se não funcionar, verifique:
- A tela de cadastro está mostrando o campo de CPF/CNPJ (sem o documento preenchido, não há o que analisar).
- Gerenciar Cadastro de Grupos Automaticamente está em Sim e Verificar No está em Tipo de Pessoa (Cadastro).
- Todos os campos de grupo estão preenchidos (nenhum em "Selecione...").
- Desabilitar Mudança de Grupo p/ Clientes está em Não.
- O cache foi atualizado após salvar.
- O cliente de teste é um cadastro novo (o recurso age no momento do cadastro).
Pronto! Dessa forma realizamos a configuração da atribuição automática de grupo por CPF/CNPJ em sua loja virtual Magento 1.
Observações Importantes
- Age no momento do cadastro: o grupo é definido quando o cliente cria a conta — tanto pela loja quanto durante o checkout. Clientes que já existem e apenas editam o perfil não são reclassificados automaticamente.
- CPF = pessoa física, CNPJ = pessoa jurídica: a separação é pela quantidade de dígitos do documento (11 = CPF, 14 = CNPJ).
- O documento é validado de verdade: não basta ter a quantidade certa de dígitos — o CPF/CNPJ precisa ser matematicamente válido. Documentos reprovados vão para os grupos de inválidos/problemas que você definiu.
- CNPJ alfanumérico: o recurso já reconhece o novo formato de CNPJ com letras (vigente a partir de 2026).
- Os grupos precisam existir antes: crie os grupos em Clientes → Grupos de Clientes antes de selecioná-los aqui.
- Cuidado ao combinar com regras por grupo: se a sua loja usa recursos que dependem do grupo (como valor mínimo de pedido por grupo, ou preços por grupo), lembre que o cliente segue o grupo definido automaticamente aqui.
Referências e Relacionados
- Como atualizar o cache da loja: toda alteração nessas configurações só passa a valer após atualizar o cache. Aprenda a atualizar o cache da sua loja
- Grupos de clientes: antes de configurar a atribuição automática, é preciso ter os grupos criados; veja como gerenciar os grupos de clientes da loja.
- Valor mínimo de pedido por grupo de clientes: recurso que combina bem com este — exige um valor mínimo de compra conforme o grupo do cliente.
Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br