Listar Clientes
A tela Listar Clientes é o cadastro central de clientes da empresa: lista todos os clientes (pessoa física e pessoa jurídica) com dados de contato, status, receita acumulada, quantidade de pedidos, vendedor responsável e prioridade. A partir desta tela você cadastra um novo cliente (PF ou PJ), edita os dados de quem já existe, remove cadastros que não são mais usados, importa em massa via planilha Excel e busca rapidamente por nome, e-mail ou documento.
Cada linha mostra a situação (Ativo, Inativo, Inadimplente) destacada por cor, o nome / razão social, e-mail, CPF/CNPJ, telefone, soma da receita de pedidos e serviços já realizados, quantidade total de pedidos, data de cadastro, prioridade interna e vendedor responsável. O detalhe do cliente, aberto por duplo-clique ou pelo ícone Editar, traz endereços, contatos, vales, créditos, vendedores vinculados, histórico de pedidos e movimentações de estoque — cada bloco com seus próprios privilégios.
A tela é única, sem abas — todos os filtros e ações ficam à vista. Os cadastros que precisam existir antes (vendedor, categoria de fornecedor para vincular ao cliente PJ etc.) estão descritos nas perguntas correspondentes.
Índice
Conceito
- O que é a tela Listar Clientes?
- Qual a diferença entre Pessoa Física e Pessoa Jurídica no cadastro?
- O que significa o Status do cliente?
- O que são as colunas de receita (R$ pedidos, Qtd pedidos, R$ serviços)?
- O que é a coluna Prioridade?
Cadastro e edição
- Como cadastrar um novo cliente?
- Como editar um cliente?
- Como remover um cliente?
- Como importar vários clientes de uma vez por planilha?
- Como vincular um vendedor a um cliente?
Busca e visualização
- Como buscar rapidamente um cliente?
- Como usar os filtros avançados?
- Como abrir o detalhe completo de um cliente?
Regras de negócio
- Por que o botão Remover está desabilitado?
- O que é a restrição de vendedor (cada vendedor só vê seus clientes)?
- Como organizar clientes por categoria de fornecedor?
Configurações
- Como definir um vendedor automaticamente ao criar um pedido?
- Como consultar a Inscrição Estadual do cliente PJ automaticamente?
Referência rápida
O que é a tela Listar Clientes?
É o cadastro central de clientes da empresa. Cada linha é um cliente — pode ser pessoa física (PF) ou pessoa jurídica (PJ) — com dados básicos (nome, CPF/CNPJ, e-mail, telefone), status, vendedor responsável, prioridade interna e métricas de quanto esse cliente já gerou em pedidos e serviços. É a tela onde você cadastra novos clientes, edita os existentes, importa em massa e gerencia toda a base.
📍 Onde: menu lateral → Clientes → Listar Clientes.
Qual a diferença entre Pessoa Física e Pessoa Jurídica no cadastro?
Os dois tipos compartilham os mesmos campos de contato (e-mail, telefone, endereço) e funcionalidades (pedidos, vales, créditos, vendedores). O que muda é o documento de identificação e os campos fiscais específicos:
| Pessoa Física | Pessoa Jurídica | |
|---|---|---|
| Documento | CPF (11 dígitos). | CNPJ (14 dígitos). |
| Nome do registro | Nome | Razão social |
| Identificação fiscal extra | RG (opcional). | Inscrição Estadual (IE) — relevante para emissão de nota fiscal contra contribuinte. Pode ser consultada automaticamente na SEFAZ (parametrização Consultar IE ao finalizar pedido). |
| Como você escolhe | No formulário Novo Cliente, no seletor Tipo no topo. | No mesmo seletor, opção PJ. |
No formulário Novo Cliente, o seletor PF/PJ no topo muda os campos exibidos dinamicamente.
O que significa o Status do cliente?
A primeira coluna da lista (com bolinha colorida) mostra o status atual do cliente:
| Status | Significado |
|---|---|
| Ativo (verde) | Cliente com cadastro válido — pode comprar e receber emissão de nota fiscal normalmente. É o padrão para clientes recém-cadastrados. |
| Inativo (vermelho) | Cliente desativado — não recebe novos pedidos, mas o histórico (pedidos antigos, contas a receber) é preservado. Use quando o cliente parou de comprar ou pediu para ser removido da base. |
| Inadimplente (cinza) | Cliente em situação financeira ruim. Aparece no filtro mas pode ser tratado de forma diferente pelos fluxos de venda (depende das regras de cada operação). |
| Deletado | Cliente apagado — não aparece na lista por padrão. Apenas administradores conseguem ver. |
O status pode ser alterado a qualquer momento no detalhe do cliente.
O que são as colunas de receita (R$ pedidos, Qtd pedidos, R$ serviços)?
Três colunas trazem métricas agregadas do cliente, calculadas em tempo real a partir do banco de dados:
| Coluna | O que mostra |
|---|---|
| R$ pedidos | Soma de todas as contas a receber geradas para este cliente (valor total dos pedidos em vendas — independente de pagas ou não). |
| Qtd pedidos | Quantidade total de pedidos já lançados para este cliente. |
| R$ serviços | Soma do valor das notas fiscais de serviço emitidas para este cliente (NfsServiceQuantity * NfsServiceUnitValue), considerando apenas as notas com situação emitida. |
Servem para identificar rapidamente clientes mais valiosos e priorizar atendimento.
O que é a coluna Prioridade?
A Prioridade é um campo numérico livre (geralmente de 1 a 5 ou 1 a 10, definido pela operação) que serve para classificar internamente quais clientes têm tratamento prioritário no atendimento, separação e expedição. O valor é cadastrado no detalhe do cliente e pode ser filtrado pelo painel Filtros → Prioridade.
Algumas operações usam essa prioridade na geração automática de picking-list (ver tela Configuração Picking List) — assim os pedidos de clientes prioritários são separados primeiro.
Como cadastrar um novo cliente?
Clique em Novo Cliente no topo da tela. A janela abre com um seletor Tipo (Pessoa Física ou Pessoa Jurídica) — escolha primeiro. O formulário ajusta os campos conforme o tipo.
Para Pessoa Física, preencha:
- Nome (obrigatório).
- CPF (obrigatório).
- E-mail (recomendado para envio de NF e comunicação).
- Telefone (opcional).
- Outros campos: RG, data de nascimento, sexo, endereço, etc.
Para Pessoa Jurídica, preencha:
- Razão Social (obrigatório).
- CNPJ (obrigatório).
- Nome Fantasia (opcional).
- Inscrição Estadual (relevante para vendas com nota fiscal contra contribuinte).
- E-mail corporativo e telefone.
- Outros campos: endereço, contatos da empresa, observações.
Clique em Salvar. O cliente aparece na lista e o detalhe é aberto em uma aba nova para você completar endereços, vendedores vinculados, etc.
Cadastros que você precisa ter antes
O cadastro não depende de outros cadastros para funcionar — você pode salvar com os campos mínimos. Itens opcionais que dependem de outras telas:
- Vendedor — em Vendas → Usuários (precisa ter usuário do tipo vendedor cadastrado para vincular no cliente).
- Categoria do cliente — alguns ramos usam categorias customizadas; cadastre em Configurações → Categorias se necessário.
Pré-requisito: privilégio Criar Consumidor.
Como editar um cliente?
Clique no ícone EditOutlined (Editar) na coluna de ações da linha, ou dê duplo-clique na linha. O cliente abre em uma aba nova com vários blocos: dados básicos, endereços, contatos, vendedores vinculados, vales, créditos, histórico de pedidos e movimentações de estoque. Cada bloco tem seus privilégios próprios — campos cinza significam que o seu usuário não tem permissão para alterar aquele bloco.
Faça as alterações nos campos editáveis e clique em Salvar no rodapé do bloco correspondente.
Pré-requisito: privilégio Visualizar consumidor (para abrir) e Editar Consumidor (para salvar alterações).
Como remover um cliente?
Selecione a linha do cliente que deseja remover e clique no ícone DeleteOutlined (Remover) na coluna de ações. O sistema mostra uma janela de confirmação com o nome do cliente — clique em Confirmar.
⚠️ A remoção marca o cadastro como Deletado — o registro continua existindo no banco (para preservar o histórico de pedidos, notas fiscais e contas a receber), mas o cliente não aparece mais na lista padrão. Não é possível recriar um cliente com o mesmo CPF/CNPJ depois — para reativá-lo, é preciso suporte interno.
Pré-requisito: privilégio Deletar Consumidor.
Como importar vários clientes de uma vez por planilha?
Clique em Mais Ações → Importar Clientes. A janela abre com:
- Baixar Modelo — gera uma planilha Excel pré-formatada com as colunas certas e um comentário em cada explicando o que preencher.
- Preencha a planilha com uma linha por cliente. Colunas obrigatórias: CONTA, TIPO (
1= PF,2= PJ), CPF/CNPJ, NOME/RAZÃO SOCIAL e outras conforme o modelo. - Importar Arquivo — escolha a planilha preenchida.
- Processar Importação — o sistema processa linha a linha, mostra barra de progresso e tabela com Status (Sucesso / Atenção) e Mensagem específica de cada linha.
- Ao final, Exportar Resultado baixa o relatório da operação em planilha — útil para identificar e corrigir as linhas que falharam.
Pré-requisito: privilégio Criar Consumidor.
Como vincular um vendedor a um cliente?
Abra o detalhe do cliente (duplo-clique ou ícone Editar) e vá ao bloco Vendedores. Clique em Adicionar Vendedor, escolha o vendedor no seletor (lista os usuários do tipo vendedor da conta) e salve.
Um cliente pode ter mais de um vendedor vinculado. O sistema usa essa relação para:
- Restringir a visualização (cada vendedor vê apenas os clientes vinculados a ele — depende da configuração do usuário).
- Atribuir automaticamente o vendedor na criação de novos pedidos (depende da parametrização Definir vendedor na criação pedido).
Pré-requisito: privilégio Adicionar vendedor cliente.
Como buscar rapidamente um cliente?
Use a barra de busca rápida no topo da tela. Ela pesquisa simultaneamente por:
- Nome ou Razão Social (busca parcial — basta digitar parte do nome).
- E-mail (busca parcial).
- CPF/CNPJ (busca exata — aceita com ou sem pontuação).
- Código do cliente (campo numérico interno) quando você digita apenas números.
Pressione Enter para aplicar.
Como usar os filtros avançados?
Clique em Filtros para abrir o painel lateral com filtros mais específicos:
- Conta — separa por conta (subdomínio) quando a empresa opera várias.
- Data criação — intervalo de datas de cadastro do cliente.
- Nome / razão social — busca textual no nome.
- Status cliente — Ativo, Inativo, Inadimplente (pode selecionar mais de um).
- E-mail — busca textual no e-mail.
- CPF / CNPJ — busca exata pelo documento.
- Prioridade — número da prioridade (1, 2, 3, etc.).
- Vendedor — filtra apenas clientes vinculados ao vendedor escolhido.
Os filtros são cumulativos. Clique em Aplicar para atualizar a lista.
Como abrir o detalhe completo de um cliente?
Há três maneiras:
- Duplo-clique na linha do cliente — abre em uma aba nova.
- Ícone Editar (lápis) na coluna de ações — mesmo efeito do duplo-clique.
- Ícone de olho ao lado do nome na coluna — abre o detalhe.
No detalhe você encontra todos os blocos do cliente: dados básicos, endereços, contatos, vendedores, vales, créditos, histórico de pedidos, notas fiscais de serviço, movimentações de estoque e relatórios.
Por que o botão Remover está desabilitado?
O ícone Remover fica desabilitado quando:
- Você não tem o privilégio Deletar Consumidor.
- A linha do cliente é de uma conta diferente da que você tem acesso (cliente compartilhado entre contas com permissão restrita).
Quando você tem o privilégio e a conta é a sua, mas mesmo assim o sistema reclama ao confirmar a remoção, é porque o cliente tem vínculos ativos (pedidos abertos, vales, créditos). Nesses casos, abra o detalhe do cliente, resolva os vínculos pendentes (cancelar pedidos, estornar vales) e tente novamente.
O que é a restrição de vendedor (cada vendedor só vê seus clientes)?
Quando um usuário é cadastrado como Vendedor e marcado com a opção Restringir acesso aos clientes vinculados no detalhe do usuário, a tela Listar Clientes mostra apenas os clientes vinculados a ele no bloco Vendedores do cliente.
A restrição é aplicada automaticamente pelo sistema — não há opção visível na tela. Para um vendedor enxergar todos os clientes (ou um conjunto maior), o administrador precisa:
- Vincular o vendedor aos clientes desejados (no detalhe do cliente, bloco Vendedores).
- Ou desabilitar a restrição no cadastro do usuário.
Como organizar clientes por categoria de fornecedor?
Apesar do nome "categoria de fornecedor", esse mecanismo também serve para categorizar clientes em algumas operações. Em Fornecedores → Categorias de Fornecedor, cadastre as categorias que fazem sentido (Atacado, Varejo, VIP, etc.). No detalhe do cliente PJ, vincule a categoria correspondente.
O uso típico é restringir a visualização: usuários com categorias vinculadas em Configurações → Usuários só enxergam clientes da mesma categoria, quando a parametrização correspondente está ativa.
Como definir um vendedor automaticamente ao criar um pedido?
Ative a parametrização Definir vendedor na criação pedido. Acesse Configurações → Parametrizações → Vendedor, marque Definir vendedor na criação pedido e salve.
A partir desse momento, sempre que um novo pedido for criado para um cliente que tem vendedor vinculado, o sistema atribui automaticamente o vendedor no pedido. Quando o cliente tem mais de um vendedor, o sistema usa o primeiro da lista.
Como consultar a Inscrição Estadual do cliente PJ automaticamente?
Ative a parametrização Consultar IE ao finalizar pedido. Acesse Configurações → Parametrizações → Pedido, marque Consultar IE ao finalizar pedido e salve.
A partir desse momento, sempre que um pedido para cliente pessoa jurídica for finalizado e o campo Inscrição Estadual do cliente estiver vazio, o sistema consulta a SEFAZ automaticamente e preenche. Útil para garantir que a IE esteja correta antes da emissão da nota fiscal.
Resumo de parametrizações
Configurações da empresa que afetam esta tela ou o detalhe do cliente. Para ativar ou desativar, acesse Configurações → Parametrizações, abra o submenu indicado e habilite ou desabilite a parametrização.
| Parametrização | Submenu | O que muda quando ativada |
|---|---|---|
| Definir vendedor na criação pedido | Vendedor | Ao criar um pedido, o sistema atribui automaticamente o primeiro vendedor vinculado ao cliente. Sem ela, o vendedor do pedido precisa ser preenchido manualmente. |
| Consultar IE ao finalizar pedido | Pedido | Ao finalizar um pedido para cliente PJ, o sistema consulta a Inscrição Estadual na SEFAZ automaticamente quando o campo está vazio no cadastro do cliente. |
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar consumidor | Acesso à tela, à lista e ao detalhe do cliente. |
| Criar Consumidor | Botão Novo Cliente e ação Importar Clientes em Mais Ações. |
| Editar Consumidor | Salvar alterações nos campos do detalhe do cliente. |
| Deletar Consumidor | Ícone Remover (lixeira) na linha. |
| Visualizar Endereço Cliente | Bloco Endereços no detalhe do cliente. |
| Criar Endereço Cliente | Botão de cadastrar endereço no bloco. |
| Editar Endereço Cliente | Salvar alterações em endereços. |
| Deletar Endereço Cliente | Remover endereços do cliente. |
| Adicionar vendedor cliente | Vincular vendedor ao cliente no bloco Vendedores. |
| Criar Crédito Consumidor | Lançar crédito no cliente (bloco Créditos). |
| Editar Crédito Consumidor | Alterar crédito já lançado. |
| Deletar Crédito Consumidor | Remover crédito lançado. |
| Gerar vale cliente | Gerar vale-presente / vale-troca para o cliente. |
| Excluir vale cliente | Cancelar um vale antes do uso. |