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

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.

❗ 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).

5.3 Aba "Pessoa Jurídica"

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

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

❗ 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)

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.