Pular para o conteúdo
Abrir um chamadoPortal do cliente

Ainda precisa de ajuda?

Fale com nosso time

Não encontrou o que procurava? Abra um chamado e nossa equipe vai te ajudar.

Abrir um chamado
Categorias · 07. Clientes

Configurando Perfil de Cliente

Atualizado em

A tela Clientes é onde o administrador consulta, pesquisa, edita, aprova, rejeita e remove os clientes da loja. A tela oferece pesquisa simples, pesquisa avançada com quatro abas de filtros, ações em lote, exportação dos resultados em três formatos e visualização do status real do cadastro de cada cliente.

A funcionalidade ganhou recentemente duas melhorias importantes que tornam a segmentação mais precisa:

  • Novo filtro por Perfil de Cliente na Pesquisa avançada, com suporte a múltipla seleção.

  • Status corretos no filtro: agora o filtro mostra Aprovado / Aguardando Aprovação / Rejeitado (antes mostrava apenas Ativo e Inativo, o que não refletia o estado real do cadastro).

Como funciona

O administrador acessa Clientes → Clientes e vê a listagem completa paginada. Pode aplicar filtros simples direto na barra de busca ou abrir a Pesquisa avançada para combinar critérios mais ricos (perfil, datas, documentos, status, dados de PF/PJ, campos adicionais). Os resultados podem ser ordenados, exportados ou usados para ações em lote.

Como é o fluxo

  1. O administrador acessa Clientes → Clientes.

  2. Localiza o cliente via barra de busca rápida ou abre Pesquisa avançada para refinar.

  3. Combina filtros (perfil, status, dados pessoais, campos adicionais).

  4. Visualiza, edita, aprova/rejeita ou remove clientes individualmente ou em lote.

  5. Exporta os resultados quando necessário (CSV, PDF ou XLS).

1. Premissas para utilizar a funcionalidade

1.1 Requisitos obrigatórios

  • O usuário precisa ter permissão de acesso ao menu Clientes.

  • Para ações em lote (excluir), são necessárias permissões específicas

  • Para que o filtro de Perfil mostre opções, é preciso ter perfis cadastrados em Clientes → Perfis.

  • Campos adicionais precisam estar cadastrados em Clientes → Campos Adicionais para aparecer na aba correspondente.

1.2 O que é "Perfil de Cliente"

Perfil = Tipo de Cliente. Categoriza a base por segmento comercial. Cada perfil pode ter:

  • Lista de preço própria.

  • Promoções específicas.

  • Prazos e condições de pagamento próprios.

  • Restrições de pagamento.

Exemplos clássicos: Consumidor, Distribuidor, Revendedor.

❗ Sem perfis cadastrados, o filtro de Perfil fica vazio. Cadastre primeiro em Clientes → Perfis.

2. Como acessar a tela

Onde acessar no sistema

Clientes → Clientes

A tela exibe a listagem completa com paginação, filtros e botões de ação no topo.

3. Listagem de clientes

3.1 Colunas da tabela

  • Coluna · O que mostra

  • (seleção) · Caixa para selecionar clientes para ações em lote.

  • Nome · Nome do cliente. Ordenável.

  • Perfil · Tipo de Cliente vinculado (ex.: Consumidor, Distribuidor).

  • Email · Endereço de e-mail cadastrado.

  • CPF/CNPJ · Documento do cliente.

  • Telefone · Telefone principal cadastrado.

  • Loja · (Multi-loja) Nome da loja vinculada ao cliente.

  • Cadastro · Data e hora em que o cliente se cadastrou. Ordenável.

  • Status · Aprovado, Aguardando Avaliação ou Rejeitado. Ordenável.

  • Ações · Botões para ver, editar, deletar e alterar status do cliente.

3.2 Ordenação

Clique nos cabeçalhos Nome, Cadastro ou Status para ordenar a listagem.

✔ A coluna Perfil permite ver o segmento de cada cliente em uma rápida olhada, sem precisar abrir a ficha individual.

4. Pesquisa rápida

A barra de busca no topo permite consultas simples por texto livre. Aceita partes do nome, e-mail ou documento do cliente.

✔ Use a pesquisa rápida quando você quer encontrar um cliente específico. Para segmentar a base, use a Pesquisa avançada.

5. Pesquisa avançada

Clique no botão Pesquisa avançada (ícone de lupa) para abrir o modal com filtros completos, divididos em quatro abas.

5.1 Aba "Geral"

Filtros aplicáveis a qualquer tipo de cliente.

  • Filtro · Tipo · Observação

  • Cadastrado entre · Datas · Data inicial e final do cadastro.

  • Telefone principal · Texto · Formato (XX) XXXXX-XXXX.

  • Telefone alternativo · Texto · Formato (XX) XXXXX-XXXX.

  • Status do cliente · Seleção · Todos / Aprovado / Aguardando Aprovação / Rejeitado.

  • Perfil de cliente · Multi-seleção · Lista todos os perfis cadastrados. Múltipla seleção com Ctrl+clique.

❗ Novidade: os filtros Perfil de cliente e Status do cliente receberam melhorias recentes. O filtro de Perfil é novo; o filtro de Status agora mostra as opções reais (Aprovado / Aguardando Aprovação / Rejeitado), em vez de Ativo / Inativo como era antes.

5.2 Aba "Pessoa Física"

Filtros específicos para clientes pessoa física (CPF).

  • Filtro · Tipo · Observação

  • Nome · Texto · Primeiro nome do cliente.

  • Sobrenome · Texto · Sobrenome do cliente.

  • CPF · Texto · O sistema valida o CPF automaticamente.

  • Nascido entre · Datas · Faixa de data de nascimento.

  • Sexo · Seleção · Ambos / Feminino / Masculino.

5.3 Aba "Pessoa Jurídica"

Filtros específicos para clientes pessoa jurídica (CNPJ).

  • Filtro · Tipo · Observação

  • Razão social · Texto · Razão social cadastrada.

  • Nome fantasia · Texto · Nome fantasia da empresa.

  • CNPJ · Texto · O sistema valida o CNPJ automaticamente.

  • Responsável · Texto · Nome do responsável cadastrado.

5.4 Aba "Campos Adicionais"

Filtros pelos campos customizados cadastrados em Clientes → Campos Adicionais.

❗ A aba mostra apenas os campos do tipo texto. Se nenhum campo adicional estiver cadastrado, aparece a mensagem:

"Nenhum campo adicional cadastrado"

✔ Use esta aba para buscar clientes por informações exclusivas da sua operação (ex.: código interno, CNAE, segmento de atuação, indicação).

5.5 Botões do modal

  • Limpar Pesquisa: zera todos os campos preenchidos.

  • Cancelar: fecha o modal sem aplicar filtros.

  • Pesquisar: aplica os filtros e atualiza a tabela.

6. Status do cliente

O status do cliente aparece na coluna Status da tabela e também é filtrável na aba Geral da Pesquisa avançada.

6.1 Opções disponíveis

  • Status · O que significa

  • Aprovado · Cliente liberado para acessar a loja e comprar.

  • Aguardando Aprovação · Cadastro pendente de avaliação. Útil em operações B2B com curadoria de cadastro.

  • Rejeitado · Cliente rejeitado pelo administrador. Sem acesso à loja.

❗ Antes da última melhoria, o filtro mostrava apenas "Ativo" e "Inativo", o que não permitia identificar clientes Aguardando Aprovação ou Rejeitados. Agora cada situação tem seu próprio valor.

✔ Use o filtro de Status para acompanhar separadamente clientes que precisam de avaliação ou para auditar cadastros rejeitados.

7. Combinação de filtros

O grande ganho da Pesquisa avançada é combinar critérios entre as abas e gerar visões precisas.

7.1 Exemplos práticos

  • "Distribuidores aguardando aprovação": Perfil = Distribuidor + Status = Aguardando Aprovação. Ajuda a equipe comercial a priorizar cadastros B2B pendentes.

  • "Revendedores rejeitados": Perfil = Revendedor + Status = Rejeitado. Útil para auditoria de cadastros recusados.

  • "Consumidores aprovados cadastrados no mês": Perfil = Consumidor + Status = Aprovado + Cadastrado entre = mês atual. Base para campanhas de boas-vindas.

  • "Distribuidor + Revendedor + Aprovado": Múltipla seleção de perfis B2B ativos. Base para newsletters segmentadas.

  • "Pessoa jurídica com CNAE específico": Campo adicional cnae + aba PJ. Base para abordagem comercial vertical.

✔ Os resultados respeitam todos os filtros combinados ao mesmo tempo.

8. Ações disponíveis

8.1 Por cliente (na linha)

  • Ação · Função

  • Ver (lupa/olho) · Abre a ficha detalhada do cliente.

  • Editar (lápis) · Abre o cadastro completo para alteração.

  • Alterar Status (ícone de usuário) · Aprova, rejeita ou reativa o cliente.

  • Deletar (X) · Remove o cliente. Pode exigir permissão RULE_CUSTOMER_DELETE.

8.2 Em lote (no topo)

  • Excluir: remove todos os clientes selecionados nos checkboxes.

  • Exportar: baixa os resultados em CSV, PDF ou XLS.

❗ Para usar ações em lote, marque as caixas de seleção da primeira coluna antes de clicar no botão correspondente.

9. Alterar status do cliente

9.1 Como alterar

  1. Localize o cliente na listagem.

  2. Clique no botão Alterar Status (ícone de usuário).

  3. Escolha entre aprovar, rejeitar ou reativar.

  4. Para rejeitar, é necessário preencher uma justificativa.

9.2 Regras da rejeição

  • A justificativa é obrigatória ao rejeitar.

  • Aceita até 1.000 caracteres.

  • Fica registrada no histórico do cliente para auditoria.

❗ Escreva uma justificativa clara. Ela serve de referência tanto para auditoria interna quanto para responder ao cliente caso ele questione.

10. Exportação dos resultados

A exportação respeita os filtros aplicados. Disponível em três formatos:

  • CSV: abre em Excel ou Google Sheets.

  • PDF: relatório formatado para impressão.

  • XLS: Excel nativo.

10.1 Colunas exportadas

  • Nome

  • Gênero

  • Responsável

  • Data de Nascimento

  • Tipo (perfil)

  • Email

  • CPF/CNPJ

  • Fone principal

  • Fone secundário

  • Cadastro

  • Endereço

  • CEP

  • Cidade

  • Estado

11. Multi-loja

Em contas com mais de uma loja:

  • A coluna Loja aparece na listagem mostrando o vínculo do cliente.

  • A pesquisa segue o escopo do usuário logado (não há filtro de loja na pesquisa avançada).

  • Cada loja pode ter seus próprios perfis (Tipos de Cliente) e atributos adicionais.

12. Ajuda contextual

A tela tem ícone de interrogação que abre um tutorial passo a passo explicando cada coluna, filtro e ação.

13. O que muda após a configuração

  • ✔ A tabela é atualizada com apenas os clientes que atendem aos filtros.

  • ✔ A URL do navegador passa a refletir os parâmetros aplicados, permitindo compartilhar o link da busca.

  • ✔ A exportação respeita os filtros ativos.

  • ✔ Ações em lote agem apenas sobre os clientes selecionados.

  • ✔ A coluna Perfil aparece na tabela de resultados.

  • ✔ O Tipo (perfil) é incluído na exportação.

  • ✔ Filtros podem ser combinados livremente entre as quatro abas.

15. Dicas e boas práticas

✔ Cadastre perfis claros e padronizados em Clientes → Perfis antes de operar. Sem perfis, a segmentação perde valor.

✔ Aproveite os campos adicionais para guardar informações estratégicas da sua operação (segmento, prioridade, indicação). Eles ficam pesquisáveis pela aba Campos Adicionais.

✔ Para fechar comissão ou enviar campanhas, filtre por perfil + status Aprovado, exporte em XLS e use a planilha como base de envio.

✔ Use o filtro de Cadastrado entre para identificar clientes novos do mês e acompanhar crescimento.

✔ Combine Status: Aguardando Aprovação com perfis B2B específicos para acelerar a curadoria de cadastro.

✔ Use o filtro Rejeitado periodicamente para auditar cadastros recusados.

✔ Em rejeições, escreva uma justificativa clara. Ela fica no histórico do cliente e ajuda em auditoria.

✔ Para listas grandes, filtre antes de exportar para evitar arquivos pesados.

✔ Compartilhe links de busca com o time. A URL preserva todos os filtros aplicados.

✔ Atribua perfil a todos os clientes já cadastrados. Clientes sem perfil não aparecem quando você filtra por Perfil de Cliente.

❗ Cuidado com exclusão em lote. A ação é definitiva e remove o cadastro do cliente do sistema.