Conta Corrente
O módulo de Conta Corrente permite gerenciar o histórico de vendas devidas do tipo convênio para cada cliente, acompanhando saldo, status da conta (aberta ou finalizada) e todos os lançamentos de crédito e débito. Neste guia você aprenderá a localizar uma conta corrente, visualizar o extrato de lançamentos e registrar novos lançamentos (pagamentos, débitos e créditos).
Visão Geral
A tela de Conta Corrente apresenta uma lista de clientes com conta corrente, com funcionalidades para:
- ✅ Pesquisar contas correntes por cliente
- ✅ Filtrar por status (ABERTA ou FINALIZADA)
- ✅ Visualizar a data de fechamento e o saldo total da conta
- ✅ Abrir o detalhamento da conta para ver todos os lançamentos
- ✅ Adicionar novos lançamentos (pagamentos, débitos e créditos simples)
Acessando o Módulo
Para acessar Conta Corrente:
- Faça login no sistema
- No menu lateral, clique em Financeiro
- Clique em Conta Corrente (descrição: Gerencie o histórico de vendas devidas do tipo convênio)
- A listagem de contas correntes por cliente será exibida
Lista de Contas Corrente
A lista exibe uma linha por conta corrente de cliente:
| Campo | Descrição |
|---|---|
| ID | Código único da conta corrente no sistema |
| CLIENTE | Nome do cliente vinculado à conta |
| DATA FECHAMENTO | Data de fechamento da conta (período de apuração do convênio) |
| TOTAL | Saldo total da conta (R$). Pode ser positivo ou zero, conforme lançamentos de crédito/débito |
| STATUS | Situação da conta: ABERTA (padrão) ou FINALIZADA |
| AÇÕES | Acessar detalhes, imprimir/relatórios e outras ações (ícones na coluna de ações) |
Ordenação
Clique no cabeçalho da coluna para ordenar a lista (ex.: por ID ou Data Fechamento). A URL pode incluir parâmetros como sortField=id e order=DESC, exibindo as contas mais recentes primeiro.
Pesquisa e Filtros
- Pesquisa rápida: use o campo "Pesquisar clientes..." para localizar rapidamente pela descrição do cliente.
- Filtros avançados (botão "+ Adicionar Filtro"):
| Filtro | Descrição |
|---|---|
| Status | ABERTA ou FINALIZADA |
| Empresa | Filtrar por empresa (empresaId) |
| Cliente | Filtrar por cliente específico (clienteId) |
| Data de Fechamento | Intervalo de datas no formato início|fim |
| Ordenação | Campo (ex.: id ou dataFechamento) e direção (ASC/DESC) |
Detalhes da Conta Corrente (Extrato)
Ao clicar na ação de visualizar para um cliente, é aberta a tela de detalhes da conta corrente, contendo:
- Cabeçalho com nome do cliente, data de fechamento, status (ABERTA ou FINALIZADA) e saldo atual.
- Uma tabela de lançamentos (extrato), listando todos os créditos e débitos da conta.
Tabela de Lançamentos
Cada linha da tabela representa um lançamento (evento) da conta corrente:
| Campo | Descrição |
|---|---|
| PDV | Identificador do ponto de venda ou origem (quando disponível) |
| DATA | Data e hora do lançamento (createdAt) |
| DESCRIÇÃO | Descrição do lançamento (ex.: venda, pagamento, ajuste) |
| TIPO | CRÉDITO (valor positivo) ou DÉBITO (valor negativo) |
| VALOR | Valor do lançamento. Créditos aparecem em verde com prefixo +R$; débitos em vermelho com prefixo -R$ |
Os lançamentos são armazenados como eventos (eventos) e impactam o total da conta corrente.
Adicionando um Lançamento
Na tela de detalhes da conta, clique em "+ Adicionar Lançamento" para abrir o assistente de lançamento.
Passo 1 – Tipo de Lançamento
Selecione o tipo de lançamento que deseja registrar:
- Adicionar pagamento – registrar um pagamento recebido do cliente (lançamento de CRÉDITO que reduz o saldo devedor)
- Débito simples – registrar um novo débito na conta (lançamento de DÉBITO, aumentando o saldo devedor)
- Crédito simples – registrar um crédito direto na conta (lançamento de CRÉDITO, reduzindo o saldo devedor)
Clique em "Próximo" para avançar.
Passo 2 – Valor do Lançamento
Dependendo do tipo selecionado, o sistema apresenta opções para o valor:
- Lançar saldo parcial – informe manualmente o valor desejado
- Lançar saldo total – usar automaticamente o saldo devedor total atual da conta
Campos do formulário de lançamento
| Campo | Obrigatório | Descrição |
|---|---|---|
| Tipo | ✅ | CREDITO ou DEBITO (conforme seleção inicial) |
| Valor | ✅ | Valor do lançamento (R$). Quando "Lançar saldo total" for usado, o sistema preenche este valor automaticamente |
| Descrição | ✅ | Texto que descreve o lançamento (ex.: "Pagamento convênio janeiro", "Ajuste de débito") |
| Pedido | ❌ | Campo opcional para vincular o lançamento a um pedido específico (pedidoId), quando aplicável |
Após preencher as informações, clique em "Adicionar Lançamento" para confirmar. O novo lançamento aparecerá na tabela e o saldo total será recalculado.
Status da Conta Corrente
O campo status da conta corrente indica se a conta está:
| Status | Descrição |
|---|---|
| ABERTA | Conta corrente ativa para o cliente, aceitando novos lançamentos |
| FINALIZADA | Conta encerrada para o período; normalmente não recebe novos lançamentos (apenas consulta e relatórios) |
O status é definido no cadastro da conta corrente (status) e pode ser atualizado conforme a regra do sistema.
Resumo dos Campos do Módulo (referência técnica)
Os dados são armazenados conforme o módulo contaCorrente (entidade/schema):
ContaCorrente (cabeçalho):
id, status (ABERTA | FINALIZADA), empresaId, cliente (objeto com id e nome), dataFechamento, eventos (array de eventos), total, createdAt, updatedAt, deleted.
Evento de Conta Corrente (eventos):
pedidoId (opcional), createdAt, descricao, tipo (CREDITO | DEBITO), valor.
Dicas e Boas Práticas
Utilize data de fechamento para agrupar as vendas de convênio por período (ex.: mês de competência). Isso facilita a conferência e o fechamento com o cliente.
Ao registrar lançamentos, use descrições que identifiquem claramente a origem (ex.: "Venda PDV 03/01", "Pagamento boleto", "Ajuste manual").
Consulte o saldo no cabeçalho da conta corrente antes de lançar pagamentos parciais ou totais, garantindo que o valor lançado corresponde ao combinado com o cliente.
Perguntas Frequentes
O que é uma conta corrente de convênio?
É um controle de vendas e pagamentos feitos para clientes que utilizam convênios, permitindo acumular lançamentos (débitos e créditos) em uma conta por período, em vez de pagar cada venda individualmente.
Qual a diferença entre CRÉDITO e DÉBITO na conta corrente?
CRÉDITO reduz o saldo devedor do cliente (pagamentos ou ajustes favoráveis). DÉBITO aumenta o saldo devedor (novas vendas, taxas ou ajustes).
Posso lançar todo o saldo de uma vez?
Sim. Use a opção "Lançar saldo total" no passo 2 do assistente de lançamento para usar automaticamente o saldo devedor total atual.
Posso ter mais de uma conta corrente por cliente?
Sim. Cada registro em contaCorrente possui cliente e dataFechamento. É possível criar novas contas para o mesmo cliente em períodos diferentes (por exemplo, uma conta por mês).
Próximos Passos
Após dominar Conta Corrente, explore outros módulos do Financeiro:
- Contas a Receber — Controle das cobranças e recebimentos
- Contas a Pagar — Controle das despesas e pagamentos
- Condições de Pagamento — Configurar prazos e formas de pagamento usadas nos convênios
- Cadastro de Clientes — Clientes vinculados às contas correntes