Clientes¶

A tela de Clientes permite cadastrar, consultar e editar os clientes da loja, além de registrar recebimentos e visualizar o extrato de conta-corrente.

Como abrir¶

Menu: Pessoas → Clientes
Atalho de teclado: Ctrl+Shift+C

Layout da tela¶

A tela usa um layout mestre-detalhe:

Painel esquerdo — lista de clientes dividida em duas seções: ativos (exibidos normalmente) e inativos (com opacidade reduzida). Uma barra de pesquisa por nome e um botão + para novo cadastro ficam na parte superior do painel.
Painel direito — exibe um estado vazio ao iniciar. Ao selecionar um cliente, aparece um cabeçalho com nome, número e badges de status, seguido de três abas: Detalhes, Pagamentos e Extrato.

O divisor entre os painéis pode ser arrastado para ajustar a largura.

Clientes bloqueados aparecem com um badge vermelho BLOQUEADO na lista, independentemente de estarem ativos ou inativos. Clientes inativos são exibidos com opacidade reduzida e um badge INATIVO.

Aba Detalhes — Referência de campos¶

Geral¶

Campo	Descrição
Nome	Razão social ou nome completo do cliente (obrigatório).
Apelido / Nome Fantasia	Nome comercial ou apelido.
Contato	Nome da pessoa de contato.
Telefone	Número de telefone principal.
E-mail	Endereço de e-mail.
Endereço	Logradouro (rua, avenida, etc.).
Número	Número do endereço.
Complemento	Complemento (bloco, sala, etc.).
Bairro	Bairro ou distrito.
Cidade	Município.
Estado	Unidade federativa (UF).
CEP	Código de endereçamento postal.
CPF/CNPJ	Número de identificação fiscal do cliente.
RG / IE (campo legado)	RG ou inscrição estadual no formato legado.
Inscrição (campo legado)	Campo de registro adicional legado.
Loja	Loja à qual o cliente pertence. Somente leitura.
Detalhes	Campo de texto livre para observações internas.
Ativo	Interruptor que indica se o cliente está ativo.
Bloqueado	Interruptor que bloqueia futuras vendas a prazo para este cliente.
Saldo	Saldo atual do cliente. Somente leitura.

Ativo vs. Bloqueado

Os campos Ativo e Bloqueado são independentes. Um cliente pode estar ativo e ainda assim bloqueado para vendas a prazo. Bloquear um cliente não o desativa — ele permanece visível e consultável na lista.

Venda Balcão

Registros de Venda Balcão são configurações de sistema e nunca aparecem nesta tela. Eles são gerenciados pela tela de Lojas.

Produção

O flag de Produção está previsto no sistema mas ainda em desenvolvimento.

Programação de Nota Fiscal (seção recolhível)¶

Clique no cabeçalho Programação de NF para expandir ou recolher esta seção.

Campo	Descrição
Próxima data de NF	Data programada para a próxima nota fiscal deste cliente.
Instruções	Instruções de faturamento para este cliente.

Limpeza automática quando o cliente não tem mais dívida

Esses campos são limpos automaticamente sempre que o saldo do cliente é recalculado e fica zero ou positivo (por exemplo, após o recebimento de um pagamento). As informações de cobrança deixam de ser relevantes quando o cliente não está mais em débito.

Aba Pagamentos¶

A aba Pagamentos exibe o ledger de recebimentos (AR) do cliente selecionado. Os dados são carregados na primeira vez que a aba é aberta para cada cliente.

Referência de campos e cenários complexos

O modal de adicionar/editar é documentado na página Modal de Pagamento, que também cobre arredondamento com desconto, divisão em cheque + dinheiro e pagamentos em bloco para vários pedidos.

Filtro de status¶

Use o seletor no topo da aba para filtrar os pagamentos:

Opção	O que exibe
Todos	Todos os pagamentos registrados.
Recebidos	Apenas pagamentos com data de recebimento preenchida.
Pendentes	Apenas pagamentos sem data de recebimento.

Colunas da grade¶

Coluna	Descrição
Pedido	Número do pedido relacionado, se houver.
Usuário	Usuário que registrou o pagamento.
Método	Forma de pagamento (CHEQUE, DINHEIRO, PIX, etc.).
Valor	Valor do pagamento.
Vencimento	Data de vencimento. Vermelho = vencido, verde = a vencer, âmbar = hoje.
Recebido	Data em que o pagamento foi recebido. Vazio se ainda pendente.
Detalhes	Observações do pagamento.

Adicionar um pagamento¶

Selecione o cliente no painel esquerdo.
Clique na aba Pagamentos.
Clique em Adicionar pagamento.
Preencha os campos na janela modal: ref. nº pedido, método, valor, vencimento, data de recebimento e observações.
Clique em Salvar.

Para detalhes completos — incluindo o fluxo de cheques em lote que se abre quando a forma é definida como CHEQUE, os campos de notas para PIX/Boleto/Cartão e os cenários de lançamento — consulte a página de referência Modal de Pagamento.

Editar ou excluir um pagamento¶

Clique no ícone de lápis (✏) para editar ou no ícone de lixeira (🗑) para excluir um pagamento.

Permissões

Usuários sem permissão sales:manage ou owner só podem editar os próprios pagamentos com data de recebimento igual a hoje ou no futuro. Pagamentos de outros usuários ou com data já passada exigem privilégio elevado.
O mesmo privilégio é exigido para registrar um pagamento com data de recebimento anterior a hoje (retroativa). Datas futuras são bloqueadas para todos — não há exceção por privilégio.

Pagamentos offline

Pagamentos requerem conexão com o servidor. Em modo offline, a operação não é concluída e um aviso é exibido.

Carregar mais¶

A grade exibe até 20 pagamentos por vez. Clique em Carregar mais para buscar o próximo lote de registros.

Método CHEQUE — dados do cheque¶

Quando um pagamento usa o método CHEQUE, clicar no nome do método na grade abre o modal de edição com os campos do cheque preenchidos. Cada pagamento carrega um único registro de cheque com estes campos:

Campo	Descrição
Data pré-datada	Data em que o cheque pode ser depositado.
CPF/CNPJ	CPF ou CNPJ do emitente.
Nome	Nome do emitente.
Banco	Código do banco.
Agência	Número da agência.
Conta	Número da conta.
Cheque Nº	Número do cheque.

Use o botão Autopreenchimento para buscar os dados do emitente cadastrado a partir do CPF/CNPJ informado.

Ao adicionar um novo pagamento em cheque, o modal alterna para o modo lote, permitindo lançar vários cheques compartilhando a mesma referência de pedido e data de vencimento numa única sessão e gravá-los juntos. Veja a referência Modal de Pagamento para o fluxo completo.

Aba Extrato¶

A aba Extrato exibe o extrato de conta-corrente completo do cliente. Os dados são carregados na primeira vez que a aba é aberta para cada cliente.

Tipos de lançamento¶

O extrato reúne seis tipos de atividade, ordenados cronologicamente:

Tipo	Descrição
Pagamento	Pagamento recebido do cliente (linha de crédito).
Entrega	Entrega confirmada de um pedido (linha de débito).
Pedido	Pedido sem entrega registrada ou com tipo de entrega não definido (linha de atividade).
Cancelado	Pedido cancelado (linha de atividade).
Orçamento	Orçamento ou pedido consumido (linha de atividade).

Linhas de débito (entregas) reduzem o saldo acumulado. Linhas de crédito (pagamentos) aumentam o saldo. Linhas de atividade (Pedido, Cancelado, Orçamento) não possuem valor e não afetam o saldo; são exibidas para fornecer um histórico completo de movimentações.

Colunas¶

Coluna	Descrição
Data	Data do lançamento.
Tipo	Tipo do lançamento (Pagamento, Entrega, Pedido, Cancelado, Orçamento).
Referência	Número de referência (número do pedido para lançamentos de pedido; ID do pagamento para pagamentos).
Descrição	Para entregas únicas: Entrega única. Para entregas parciais: Entrega parcial N (N = número da entrega). Para pedidos retirados pelo cliente: Retirado pelo cliente. Para pedidos aguardando retirada: Aguardando retirada. Para pagamentos: o método de pagamento.
Débito	Valor entregue (apenas linhas de débito).
Crédito	Valor recebido (apenas linhas de crédito).
Saldo	Saldo acumulado até esta linha. Positivo em verde, negativo em vermelho. Exibido apenas para linhas financeiras (débitos e créditos).

Filtro de movimentos financeiros¶

Use a caixa de seleção Apenas movimentos financeiros na barra de ferramentas para ocultar as linhas de atividade sem valor (Pedido, Cancelado, Orçamento). Quando marcada, apenas débitos e créditos são exibidos.

Barra de resumo¶

A barra de ferramentas exibe o período coberto pelos lançamentos carregados, o total recebido e o total entregue.

Paginação por período¶

O extrato é paginado por data descendente, exibindo até 50 lançamentos por vez. Se houver entradas anteriores ao período atual, o botão Carregar período anterior aparece no topo da grade. Clique nele para adicionar os lançamentos mais antigos acima dos já exibidos.

Tarefas comuns¶

Cadastrar um novo cliente¶

No painel esquerdo, clique no botão +.
Preencha os campos obrigatórios na aba Detalhes (ao menos o Nome).
Clique em Salvar.

O sistema atribui um número automático ao cliente e o exibe na lista.

Editar um cliente existente¶

No painel esquerdo, localize o cliente pelo campo de pesquisa ou percorrendo a lista.
Clique no nome para carregar os dados no painel direito.
Edite os campos desejados na aba Detalhes.
Clique em Salvar.

Cada gravação gera automaticamente um registro no log de auditoria.

Bloquear ou desbloquear um cliente¶

Selecione o cliente.
Na aba Detalhes, ative ou desative o interruptor Bloqueado.
Clique em Salvar.

Clientes bloqueados permanecem ativos e visíveis, mas são marcados com o badge BLOQUEADO em vermelho na lista.

Desativar um cliente¶

Selecione o cliente.
Na aba Detalhes, desative o interruptor Ativo.
Clique em Salvar.

Clientes inativos aparecem na seção inferior da lista com opacidade reduzida. A exclusão de clientes não está disponível nesta tela; clientes com histórico de transações são apenas desativados.

Aba Relatório¶

A aba Relatório fornece uma avaliação de crédito do cliente selecionado com base no histórico completo de pedidos e pagamentos.

O relatório é dividido em três seções:

Pedidos — número de pedidos, datas do primeiro e último pedido, totais pedido e entregue, saldo devedor e percentual de endividamento.
Comportamento — tempo médio de pagamento, dias desde o último pagamento e valor médio por pedido.
Observações — avaliações automáticas como padrão de pagamento (paga em dia, paga com atraso, etc.) e recomendações (considere cobrar, considere bloquear, cliente excelente, etc.).

Um banner de aviso vermelho aparece no topo se o cliente estiver bloqueado ou com endividamento elevado prolongado.

Entendendo as observações¶

As observações são geradas por um algoritmo de pontuação que avalia múltiplos fatores. Algumas orientações para interpretá-las:

Quanto mais histórico de pedidos e pagamentos existir para um cliente, mais úteis serão as observações. Clientes com poucos pedidos geram resultados limitados.
Um tempo médio para pagar superior a 90 dias é tratado como sinal de alerta; acima de 120 dias surgem recomendações mais fortes. A maioria das empresas financia prazos maiores que 120 dias por meio de financeiras e recebe o pagamento em até 35 dias — clientes que ultrapassam esse prazo afetam o fluxo de caixa de forma desproporcional.
Um longo período de vendas pode indicar um cliente fiel e estabelecido ou simplesmente um projeto de longa duração. O algoritmo pondera isso junto com saldo e comportamento de pagamento, mas seu conhecimento do relacionamento é sempre o fator mais importante.
Um padrão de pagar pontualmente nos primeiros pedidos e atrasar depois que a confiança é estabelecida é um indicador de risco conhecido. Para clientes novos sem histórico significativo, vale considerar vendas à vista (mesmo com pequeno desconto) até construir um histórico sólido de pagamentos.
Observações como considere cobrar ou considere bloquear são sugestões, não instruções. Use seu julgamento.

O relatório é somente leitura e está disponível para todos os usuários com acesso à tela de Clientes.

Aba Unificar¶

A aba Unificar permite mesclar um registro duplicado de cliente no cliente atualmente selecionado. Todos os pagamentos, cheques, pedidos e registros relacionados ao registro de origem (duplicado) são reatribuídos ao cliente sobrevivente, e o registro de origem é excluído permanentemente.

Para unificar registros:

Selecione o cliente que deseja manter (o registro sobrevivente).
Abra a aba Unificar.
Digite o nome do cliente duplicado na caixa de pesquisa e pressione Enter.
Selecione o registro correspondente na lista de resultados.
Revise a descrição de confirmação e clique em Unificar e Excluir Origem.
Confirme a ação irreversível na caixa de diálogo de confirmação.

Esta operação não pode ser desfeita

Após a unificação, o registro do cliente de origem é excluído permanentemente. Verifique se selecionou os registros corretos antes de confirmar.

Esta aba está disponível apenas para usuários com permissão de Proprietário.

Ver também¶

Fornecedores — cadastro de fornecedores (mesmo grupo de menu: Pessoas)
Cheques — visualização e gestão de cheques de clientes
Usuários — gestão de usuários (mesmo grupo de menu: Pessoas)