O módulo de Clientes centraliza o cadastro e a gestão de todos os clientes da operação — pessoa física ou jurídica — com endereço, contatos, vendedor responsável, limite de crédito e situação cadastral. É a base comercial do ERP: sem cliente cadastrado, não há proposta, pedido ou remessa no CRM de Locação.
Para quem é esta documentação: comercial, administrativo, financeiro e gestores que precisam manter a base de clientes atualizada.
O que você aprende aqui:
- Como acompanhar indicadores na Visão Geral de Clientes
- Como cadastrar, editar, visualizar e filtrar clientes
- Como gerenciar contatos por cliente
- Como importar e exportar planilhas Excel
- Como inativar, suspender ou bloquear clientes (regras de permissão)
- Como o cadastro se conecta ao CRM, Faturamento e Expedição
Pré-requisito principal: ter empresa e filiais cadastradas no Painel de Controle — todo cliente deve ser vinculado a uma filial (ou empresa matriz).
Menu no sistema:
- Visão Geral →
/cliente - Cadastro Cliente →
/cliente/cadastro
3.1 Visão Geral de Clientes
Foco: Painel analítico — números, distribuição e clientes recentes.
Para que serve
A Visão Geral de Clientes consolida estatísticas da base cadastral. Ela não cadastra nem edita clientes — serve para monitorar volume, perfil e saúde da carteira antes de entrar em Cadastro Cliente.
Regra em uma linha: Visão Geral mostra como está a base; Cadastro Cliente é onde você cria e mantém os registros.
Cabeçalho
- Título: Dashboard de Clientes — Visão geral e estatísticas dos seus clientes
- Filtro de empresa/filial: recorta todos os indicadores e listas para a unidade selecionada (ou Todos)
Indicadores principais (8 cards)
Primeira linha:
| Card | O que mostra |
| Total de Clientes | Quantidade no recorte filtrado |
| Clientes Ativos | Ativos + % do total |
| Novos Este Mês | Cadastros criados no mês corrente |
| Limite Total | Soma dos limites de crédito + média por cliente |
Segunda linha:
| Card | O que mostra |
| Pessoa Física | Quantidade + % |
| Pessoa Jurídica | Quantidade + % |
| Clientes Inativos | Quantidade + % |
| Taxa de Ativação | % de clientes ativos |
Gráficos e listas
- Distribuição por Segmento — Varejo, Atacado, Indústria, Serviços, Governo, Outros (somente segmentos com clientes)
- Status dos Clientes — Ativos vs. Inativos
- Tipos de Cliente — PF vs. PJ
- Clientes Recentes — últimos 5 cadastros (nome, tipo, cidade, badge de status)
Resumo Executivo
Bloco final com três leituras rápidas: Performance, Crescimento (novos no mês) e Objetivos (meta estimada de crescimento da base).
3.2 Cadastro Cliente
Foco: Tela operacional — listagem, cadastro, edição, planilha e ações por cliente.
Cabeçalho e ações rápidas
- Título: Gestão de Clientes — Cadastre e gerencie seus clientes
- Planilha (menu dropdown):
- Exportar backup — todos os clientes
- Exportar filtro atual — só o que está visível na listagem
- Baixar modelo vazio — template para importação em massa
- Importar planilha — upload
.xlsx/.xls
- Novo Cliente — abre o modal de cadastro
Busca e filtros
Busca principal: nome, e-mail, telefone ou documento (CPF/CNPJ).
Checkbox Incluir contatos: estende a busca aos nomes/e-mails dos contatos vinculados ao cliente.
| Filtro | Opções | Padrão |
| Status | Todos, Ativo, Inativo, Suspenso, Bloqueado | Ativo |
| Tipo | Todos, Pessoa Física, Pessoa Jurídica | Todos |
| Filial | Todas + empresa matriz e filiais | Todas |
| Vendedor | Campo de busca por nome | — |
Botões auxiliares: Atualizar, Limpar filtros.
A listagem mostra contador de resultados e paginação de 50 clientes por página.
3.2.1 Novo / Editar Cliente (modal)
Informações Básicas
| Campo | Obrigatório | Observação |
| Filial | Sim | Empresa matriz ou filial |
| Tipo | Sim | Pessoa Física ou Pessoa Jurídica |
| Vendedor | Não | Busca por nome (cadastrado no RH/Vendedores) |
| CPF + RG | CPF sim (PF) | Validado; não permite duplicidade |
| CNPJ + IE | CNPJ sim (PJ) | Validado; não permite duplicidade |
| Nome / Razão Social | Sim | Normalizado em CAIXA ALTA |
| Sim | Único no sistema | |
| Telefone / Celular | Não | Formatados automaticamente |
| Contato principal | Não | Nome do responsável no cliente |
Endereço
CEP com busca automática (ViaCEP): logradouro, número, complemento, bairro, cidade e UF.
Contatos
Seção Contatos com gerenciador dedicado:
- Adicionar contatos com nome, e-mail, telefone, cargo
- Marcar contato principal
- Tipos de contato configuráveis
- Importação em lote (várias linhas de uma vez)
(Você pode adicionar contatos no cadastro ou depois, na edição.)
3.2.2 Visualizar Cliente
Modal Dados do Cliente (somente leitura) com seções:
- Informações Básicas — documentos, contatos, tipo
- Endereço — completo
- Informações Adicionais — categoria, segmento, status, limite, forma de pagamento, vendedor, observações
- Contatos — lista dos contatos vinculados
- Cliente Inativo (se aplicável) — destaque vermelho com motivo da inativação
3.2.4 Importação e exportação por planilha
Modelo padrão (modelo-importacao-clientes-AAAA-MM-DD.xlsx) com colunas:
Filial · Nome · Documento · Tipo · Contato · E-mail · Telefone · Celular · CEP · Endereço · Número · Complemento · Bairro · Cidade · Estado · Categoria · Segmento · Status · Observações
Regras na importação:
- CPF (11 dígitos) → Pessoa Física; CNPJ (14 dígitos) → Pessoa Jurídica
- Documentos já cadastrados são pulados (não duplica)
- Filial deve corresponder ao nome cadastrado no sistema
- Categoria e segmento devem existir previamente (ou ser criados no cadastro manual)
- Linha de exemplo do modelo é ignorada automaticamente
Ao final, o sistema informa quantos registros foram importados, pulados ou falharam.
3.3 Considerações
- Cliente é pré-requisito do CRM de Locação — propostas e pedidos selecionam clientes desta base.
- O vendedor vinculado vem do cadastro de funcionários marcados como vendedor no RH.
- Inativar e excluir são restritos ao perfil Master; demais usuários cadastram e editam normalmente.
- A listagem abre por padrão filtrando só ativos — para ver inativos, altere o filtro de status.
- Importação de backup do módulo clientes recarrega a listagem automaticamente.
- Cliente suspenso ou bloqueado permanece na base com status distinto de inativo simples — útil para controle comercial/financeiro.