Clientes
A tela de Clientes gerencia o cadastro unificado de clientes, fornecedores e funcionários do sistema. Um mesmo registro pode ter múltiplos papéis simultaneamente.
Filtros
Busca por nome
Campo lookup no topo com busca por nome, nome fantasia, CNPJ/CPF ou código. Ao selecionar um registro, a lista é filtrada para aquele cadastro específico.
Filtros por tipo e situação (badges)
Badges clicáveis que restringem a lista:
| Badge | Filtra por |
|---|---|
| Cliente | Registros marcados como cliente |
| Fornecedor | Registros marcados como fornecedor |
| Funcionário | Registros marcados como funcionário |
| PF | Pessoas físicas |
| PJ | Pessoas jurídicas |
| Inativos | Exibe registros inativos (ocultados por padrão) |
Múltiplos badges podem ser ativados simultaneamente. Cada seleção reinicia a paginação.
Tabela de clientes
Colunas ordenáveis (clique no cabeçalho):
| Coluna | Conteúdo |
|---|---|
| Código | Código interno do registro |
| Razão Social | Nome (linha 1) e fantasia (linha 2) |
| CNPJ/CPF | Documento formatado |
| Cidade | Código da cidade cadastrada |
| Telefone | Telefone principal |
| Status | Badge Ativo ou Inativo |
| (ações) | Botões de editar e excluir |
Busca na tabela
Campo de texto no topo da tabela filtra localmente dentro da página atual.
Visualização em cards
Botão de alternância de layout disponível no cabeçalho da tabela.
Excluir cliente
Clique no ícone de lixeira na linha. Um diálogo de confirmação é exibido antes de efetivar a exclusão.
A exclusão é irreversível. Verifique se o registro não possui títulos ou vínculos ativos antes de excluir.
Cadastrar / Editar cliente
Clique em Novo ou no ícone de lápis para abrir o formulário. O formulário é organizado em abas.
Aba Principal — Dados gerais
Identificação
| Campo | Obrigatório | Descrição |
|---|---|---|
| Tipo | Sim | PJ (pessoa jurídica) ou PF (pessoa física) — altera a máscara do CNPJ/CPF |
| Nome / Razão Social | Sim | Máx. 60 caracteres |
| Fantasia | Sim | Máx. 60 caracteres |
| CNPJ / CPF | Sim | Validado (dígito verificador) conforme o tipo |
| IE / RG | Não | Máx. 25 caracteres |
| Data de nascimento | Não | |
| Data de cadastro | Não |
Endereço
| Campo | Obrigatório | Descrição |
|---|---|---|
| Endereço | Sim | Máx. 100 caracteres |
| Número | Não | Máx. 20 caracteres |
| Complemento | Não | Máx. 80 caracteres |
| Bairro | Sim | Máx. 50 caracteres |
| Cidade | Sim | Lookup — busca por nome ou código |
| Estado (UF) | Sim | Select com todas as UFs brasileiras + EX |
| CEP | Sim | Formatado automaticamente (NNNNN-NNN) |
| País | Não | Máx. 40 caracteres |
Contato
| Campo | Obrigatório | Descrição |
|---|---|---|
| Telefone | Não | Formatado automaticamente |
| Celular | Não | Formatado automaticamente |
| Fax | Não | |
| Não | Validado como endereço de e-mail | |
| Contato | Não | Nome do contato principal |
Classificações e papéis
| Campo | Obrigatório | Descrição |
|---|---|---|
| É Cliente | Não | Checkbox — marca o registro como cliente |
| É Fornecedor | Não | Checkbox — marca como fornecedor |
| É Funcionário | Não | Checkbox — marca como funcionário |
| Ativo | Não | Checkbox — registro ativo no sistema |
| Bloqueado | Não | Checkbox — bloqueia operações |
| Vendedor | Não | Lookup — vincula um vendedor ao cliente |
| Limite de Crédito | Não | Valor numérico |
| Limite de Crédito Mensal | Não | Valor numérico |
| Observações | Não | Texto livre (máx. 4000 caracteres) |
Papéis de funcionário (visível quando "É Funcionário" está marcado)
| Papel | Campo |
|---|---|
| Vendedor interno | eVendedor |
| Cobrador | eCobrador |
| Consultor | eConsultor |
| Caixa | eCaixa |
| Farmacêutico | eFarmaceutico |
| Técnico | eTecnico |
| Gerente Financeiro | gerenteFinanceiro |
| Gerente de Vendas | gerenteVenda |
Aba Complemento
Dados pessoais adicionais (principalmente para PF):
- Cônjuge, trabalho e função do cônjuge, salário do cônjuge, telefone do cônjuge
- Nome do pai e da mãe
- Estado civil (Solteiro, Casado, Divorciado, Viúvo, Amasiado, Separado)
- Sexo, naturalidade, profissão, área de negócio, fone comercial
- Dados trabalhistas: salário, CTPS, datas de admissão e demissão
- Suframa
Aba Comercial
Configurações de venda e relacionamento comercial:
- Vendedores 2 e 3 — lookups para vendedores adicionais
- Faturamento — valor de faturamento de referência
- Pedido mínimo e preço base
- Contrato técnico — checkbox + valor do contrato
- Revenda
- Atacado — checkbox
- Venda interna e Altera preço de venda — checkboxes
- Nível de vendedor
- Bloqueia histórico de venda — checkbox
- Campos AVS e AF
Aba Comissões/Descontos
Percentuais individuais para este cadastro:
| Campo | Descrição |
|---|---|
| Comissão à Vista | % de comissão em vendas à vista |
| Comissão a Prazo | % de comissão em vendas a prazo |
| Comissão Cobrador | % para o cobrador |
| Desconto à Vista | % de desconto máximo à vista |
| Desconto a Prazo | % de desconto máximo a prazo |
| Desconto Lista Fornecedor | % de desconto sobre lista do fornecedor |
Aba Convênio/Cobrança
Configurações financeiras e de cobrança:
- Convênio — checkbox de ativação + código do convênio
- Limite de crédito convênio/mês
- Dia de vencimento do convênio e da cobrança
- Carência (dias)
- Não cobrança — data de suspensão de cobrança
- Preferência de cobrança — Cobrador / Telefone / E-mail
- Título padrão — lookup
- Forma de pagamento e prazo — lookups
- Plano de pagamento — lookup
Aba Fiscal
Configurações fiscais e tributárias:
- Tem Suframa — checkbox
- Simples Nacional — checkbox
- Jurídica Pública — checkbox
- Não contribuinte ICMS — checkbox
- Motivo de desoneração ICMS — select com 12 opções fiscais SEFAZ
- Exceção fiscal
- ISS Retido — checkbox
- Valida devolução condicional — checkbox
- IE/RG: órgão emissor e data de emissão
- IE Produtor Rural
Aba Banco/Residência/Avalista
Dados bancários e de garantia:
- Banco: nome, agência, conta corrente
- Tipo de residência — Própria / Financiada / Alugada / Outros
- Quantidade de pessoas na residência
- Avalista 1 — lookup por cliente cadastrado
- Avalista 2 — nome, endereço e CNPJ/CPF (não cadastrado)
Aba Crédito/Restrições
Informações de risco e controle de crédito:
- SPC — data de consulta
- Negativado — checkbox
- Data de consulta Serasa
- Mala direta — checkbox (inclusão em comunicações)
- Cadastro pendente — checkbox + nome do liberador
- Data de inativação
- Número do cartão fidelidade
Aba Funcionário (visível apenas para funcionários)
Campos exclusivos para funcionários:
- CRF (farmacêutico)
- É VIP — checkbox
- Usa palm — checkbox
- Exige técnico — checkbox
- Portador de arma — checkbox + observação
Usuário do sistema: login e senha para acesso; senha interna do vendedor.
Aba Fornecedor (visível apenas para fornecedores)
Campos exclusivos para fornecedores:
- Código no fornecedor — referência interna do fornecedor
- Não atualiza fornecedor — checkbox
- Dias do ciclo de compra
- Frequência de compra — 1x semana / 2x semana / Quinzenal 1/3 / Quinzenal 2/4 / Mensal
- Observação fornecedor e observação de venda
Sub-grids (dentro do formulário)
O formulário também exibe três sub-grids editáveis:
| Sub-grid | Descrição |
|---|---|
| Contatos | Lista de contatos adicionais do cadastro (nome, cargo, telefone, e-mail) |
| Endereços de entrega | Endereços alternativos para entrega |
| Referências | Referências comerciais (nome, telefone, observação) |
Cada sub-grid permite adicionar, editar e remover linhas sem sair do formulário principal.