Visão geral
A lista de Clientes foi feita para você encontrar, filtrar e agir sobre sua base rapidamente - seja para localizar um contato, fazer uma ação em lote ou exportar dados.
Legenda: Abas de status (Todos, Ativo, Inativo, Bloqueado, Arquivado), busca, filtro lateral e ordenação.
Quando utilizar
- Para localizar um cliente específico (nome, e-mail, telefone)
- Para ver apenas clientes ativos, inativos ou arquivados
- Para ordenar por maior gasto, mais pedidos, último pedido, etc.
- Para ativar/desativar/excluir vários de uma vez
- Para exportar a base para planilha
Como fazer
1. Navegar pelas abas de status
No topo da lista, clique nas abas:
| Aba | Mostra | Quando usar |
|---|---|---|
| Todos | Ativos + Inativos + Bloqueados (sem arquivados) | Visão geral do dia a dia |
| Ativo | Só status "Ativo" | Seleção para vendas/agendamentos |
| Inativo | Só status "Inativo" | Reativar clientes pausados |
| Bloqueado | Só status "Bloqueado" | Gerenciar restrições |
| Arquivado | Só status "Arquivado" | Recuperar clientes antigos |
Cada aba mostra um contador ao lado do nome.
2. Buscar cliente
Digite no campo Buscar (canto superior direito):
- Parte do nome ("joão", "silva", "empresa")
- E-mail completo ou parcial ("@gmail", "joao@")
- Telefone com ou sem formatação ("1199999", "(11) 99999-9999")
A busca é instantânea (debounced) e filtra todas as colunas visíveis.
3. Filtrar por status (painel lateral)
- Clique no ícone de Filtro (funil) ao lado da busca.
- Marque/desmarque os status desejados (checkbox).
- O painel mostra só os status que existem na sua base.
- Clique em Limpar filtros para voltar ao padrão.
Dica
> Combine aba + filtro: ex: aba "Todos" + filtro "Bloqueado" = vê só bloqueados entre os não-arquivados.
4. Ordenar a lista
Clique no cabeçalho da coluna na visualização tabela:
| Coluna | Ordena por |
|---|---|
| Cliente | Nome A–Z / Z–A |
| Pedidos | Quantidade de pedidos (maior/menor) |
| Total Gasto | Valor total gasto (maior/menor) |
| Crédito | Saldo de vale-compra (maior/menor) |
| Status | Alfabético do status |
| Último Pedido | Data mais recente/antiga |
Clique novamente na mesma coluna para inverter (asc/desc). Uma seta indica a direção.
5. Alternar visualização
- Lista (tabela) - padrão no desktop; mais colunas, ordenação, seleção em massa.
- Grade (cards) - padrão no mobile/tablet; mostra avatar, nome, pedidos, total gasto, status.
- Botão no canto superior direito alterna entre as duas.
6. Ações em um cliente (individual)
Passe o mouse sobre a linha (tabela) ou use o menu ⋮ no card (grade):
- Ver detalhes - abre tela completa com histórico, pedidos, vales, endereços.
- Editar - abre formulário de cadastro preenchido.
- Arquivar - move para aba "Arquivado" (sai das listas normais).
- Desarquivar - volta para "Ativo" (disponível só na aba Arquivado).
- Excluir - soft delete; mantém histórico, remove da base. Confirmação obrigatória.
7. Ações em massa (vários clientes)
- Marque a checkbox na primeira coluna (tabela) ou segure/ative seleção múltipla (grade).
- Selecione quantos quiser - contador na barra flutuante inferior.
- Escolha a ação na Barra Flutuante:
- Ativar / Desativar - alterna status entre Ativo ↔ Inativo para todos selecionados.
- Excluir - soft delete em lote (confirmação com contador).
- Ou use Exportar → "Selecionados" para baixar só os marcados.
Importante
> Arquivar não está na ação em massa - faça individualmente para confirmar cada um.
8. Exportar clientes
Dois caminhos:
Exportar tudo (com filtros atuais):
- Clique em Exportar no cabeçalho.
- Escolha colunas (padrão: todas visíveis + algumas extras).
- Formato: .xlsx (Excel).
- O arquivo baixa com os clientes que estão na lista respeitando aba, busca, filtro e ordenação atuais.
Exportar seleção:
- Marque os clientes desejados.
- Na barra flutuante, clique Exportar → "Selecionados".
Dica
> Use exportação para: backup periódico, enviar para contador, criar mala direta, analisar no Excel.
9. Importar clientes (planilha)
- No cabeçalho, clique Importar (ou acesse `/erp/clientes/importar`).
- Passo 1 - Upload: arraste .xlsx, .xls ou .csv (até 10 MB, 2.000 linhas).
- Passo 2 - Mapeamento: o sistema sugere mapear colunas da planilha para campos do cadastro (nome, e-mail, CPF, etc.). Cada coluna tem confiança (Exato/Alto/Médio/Baixo). Ajuste o que precisar.
- Passo 3 - Preview: veja os primeiros clientes como ficarão. Confira.
- Importar: opções "Pular duplicatas" (por CPF/CNPJ/e-mail) e "Pular erros". Clique Importar.
Legenda: Mapeamento de colunas com indicador de confiança.
Dicas importantes
- Mantenha a aba "Ativo" como padrão - é a que o PDV e agendamentos usam para busca rápida.
- Arquive, não exclua - cliente arquivado some da lista mas volta com 1 clique. Excluído some de vez.
- Use ordenação "Total Gasto" desc - identifica seus melhores clientes (top 20% = 80% da receita).
- Combine busca + aba - ex: aba "Inativo" + busca "joão" = acha "João" inativo rápido.
- Exporte antes de importar em massa - faz backup da base atual.
- Limpe duplicatas antes de importar - a opção "Pular duplicatas" usa CPF/CNPJ/e-mail como chave.
Problemas comuns
| Problema | Causa | Solução |
|---|---|---|
| Cliente não aparece na busca | Está arquivado ou inativo | Mude para aba "Todos" ou "Arquivado"/"Inativo" |
| Ordenação não funciona | Visualização em grade (cards) | Mude para Lista (tabela) - ordenação só funciona lá |
| Exportação vem vazia | Filtro muito restritivo | Limpe filtros/aba/busca antes de exportar |
| Importação falha em algumas linhas | CPF/CNPJ inválido ou duplicado | Ative "Pular erros" e "Pular duplicatas"; revise planilha |
| Não consegue desarquivar | Limite do plano atingido | Upgrade do plano ou exclua/arquive outros para abrir vaga |
Perguntas frequentes
Quantos clientes posso cadastrar?
Depende do seu plano. O sistema avisa quando atingir o limite. Clientes arquivados não contam para o limite.
Posso restaurar um cliente excluído?
Excluído é soft delete (não aparece mais). Para restaurar, contate o suporte técnico.
A importação atualiza clientes existentes?
Não. A importação só cria novos. Se encontrar CPF/CNPJ/e-mail já cadastrado, pula (se "Pular duplicatas" ligado) ou dá erro. Para atualizar em massa, edite individualmente ou use API.
Como vejo clientes que não compram há 6 meses?
Ordene por Último Pedido (ascendente) na aba "Ativo". Os sem data ficam no final. Ou exporte e filtre no Excel.
Posso criar listas/tag personalizadas?
Não há tags nativas. Use Observações no cadastro (ex: "TAG: VIP", "TAG: Revenda") e busque por "TAG: VIP" na busca global.
A busca acha por observações?
Não. Busca só nome, e-mail e telefone. Para achar por observação, use a exportação e filtre no Excel.