Lista de clientes CD10¶
Tela principal para consultar, filtrar e abrir clientes cadastrados. É a porta de entrada para criar, editar, duplicar e desativar clientes da sua base.
Pré-requisitos¶
- Estar logado no sistema (veja Acessando o sistema)
- Ter permissão Clientes: consultar atribuída ao seu usuário
Cliente ≠ Empresa
Cliente é o consumidor final (PF ou PJ) que compra de você. Empresa é a sua própria loja cadastrada para emitir NFe. As duas coisas não se misturam.
Passo a passo¶
1. Acessar a tela¶
No menu lateral, clique em Cadastros → Clientes.
A lista abre com o contador total ao lado do título e a tabela com todos os clientes cadastrados.
2. Pesquisar um cliente¶
No campo de busca no topo da tabela, digite e pressione Enter. A busca procura simultaneamente em:
- Nome / Razão Social
- CNPJ ou CPF
- Cidade
3. Filtrar a lista¶
A barra superior tem três filtros que podem ser combinados:
| Filtro | O que faz |
|---|---|
| UF | Mostra só clientes do estado escolhido |
| Situação | Filtra pela situação cadastrada (ex.: ativo, inadimplente, especial — depende do que sua empresa configurou) |
| Status | Ativo ou Inativo |
Os filtros usam Select2 e auto-aplicam ao mudar — não é preciso clicar em "Aplicar".
Para resetar tudo, clique em Limpar filtros (botão vermelho que aparece quando há algum filtro aplicado).
4. Ler a tabela¶
Cada linha mostra:
| Coluna | Descrição |
|---|---|
| Código | Identificador interno do cliente |
| Razão Social | Nome completo (PJ) ou nome civil (PF). É clicável e abre o cadastro |
| Fantasia | Nome fantasia (PJ). Para PF, mostra — |
| CNPJ/CPF | Documento formatado |
| Cidade/UF | Município e estado |
| Situação | Badge com a situação cadastral |
| Última Compra | Data da última venda. Nunca se ainda não comprou |
| Status | Badge Ativo (verde) ou Inativo (vermelho) |
| Ações | Editar, Duplicar, Desativar |
Você pode ordenar clicando no cabeçalho das colunas Código, Razão Social, Fantasia, Cidade/UF, Última Compra e Status. A seta indica o sentido (ascendente / descendente).
5. Abrir um cliente¶
Clique no nome (Razão Social) ou no botão Editar (ícone de lápis) na coluna Ações.
A tela de edição abre com todos os campos do cliente.
6. Criar um novo cliente¶
No canto superior direito, clique em Novo cliente — abre a tela CD11 — Novo cliente.
7. Duplicar um cliente¶
Na coluna Ações, clique no ícone de Duplicar (dois retângulos).
O sistema abre o formulário de novo cliente já preenchido com os dados do cliente original — exceto CNPJ/CPF e Código, que precisam ser únicos.
Quando duplicar
Use para filial de um mesmo grupo empresarial ou para criar variações de cadastro (ex.: mesma empresa com endereços de entrega diferentes).
8. Desativar um cliente¶
Na coluna Ações, clique no ícone de Desativar (círculo cortado, vermelho). O sistema pede confirmação:
Desativar este cliente?
Clique em OK. O cliente sai da lista padrão mas pode ser reativado depois mudando o filtro Status para Inativo e abrindo o cadastro.
Desativar não é excluir
O cadastro continua no banco — vinculado a vendas, NFes e financeiro. Não é possível apagar o histórico.
9. Paginar resultados¶
Quando há mais clientes do que cabem numa página, o rodapé mostra os botões de página: 1, 2, 3, ... com a página atual destacada em azul.
Erros comuns¶
Nenhum cliente encontrado
Se a lista aparece vazia, verifique:
- A busca digitada (CNPJ tem que ter formato compatível ou apenas dígitos)
- O filtro Status — pode estar fixado em Ativo e o cliente procurado está inativo
- Os filtros UF e Situação — clique em Limpar filtros
Última compra: Nunca
Significa que o cliente está cadastrado mas ainda não tem nenhuma venda lançada para ele. Não é erro.