Contas a Receber
O módulo de Contas a Receber permite gerenciar todas as contas a receber da sua empresa: registrar valores, vencimentos, origem (clientes, fornecedor ou outro), destinatário, descontos e multas, além de marcar contas como recebidas e acompanhar totais. Neste guia você aprenderá a cadastrar, editar, pesquisar e controlar as contas a receber.
Visão Geral
A tela de Contas a Receber apresenta uma lista de todas as contas cadastradas, com funcionalidades para:
- ✅ Adicionar novas contas a receber
- ✅ Editar contas existentes
- ✅ Pesquisar contas a receber
- ✅ Filtrar por origem, status, datas e outros critérios
- ✅ Marcar contas como recebidas
- ✅ Visualizar resumo: Total Recebido, Total a Receber e Total Geral
Acessando o Módulo
Para acessar Contas a Receber:
- Faça login no sistema
- No menu lateral, clique em Financeiro
- Clique em Contas a Receber (descrição: Gerenciar contas a receber)
- A listagem de contas será exibida
Lista de Contas a Receber
A lista exibe os seguintes campos para cada conta:
| Campo | Descrição |
|---|---|
| ID | Código único da conta no sistema |
| DESCRIÇÃO | Descrição da conta |
| VENCIMENTO | Data de vencimento |
| VALOR | Valor da conta (ou valor total, conforme exibição) |
| ORIGEM | Origem da conta: Clientes, Fornecedor ou Outro |
| STATUS | Situação: pendente (a receber) ou recebida |
| AÇÕES | Editar e opções (ícones de lápis e engrenagem) |
Ordenação
Clique no cabeçalho da coluna para ordenar a lista (ex.: por Vencimento). A URL pode incluir parâmetros como sortField=vencimento e order=DESC para ordenação por data de vencimento decrescente. Use o ícone no cabeçalho para alternar entre ordem crescente e decrescente.
Seleção Múltipla
- Selecionar individual: Clique na caixa de seleção à esquerda de cada linha
- Selecionar todos: Clique na caixa de seleção no cabeçalho da tabela
- Útil para marcar várias contas como recebidas ou outras ações em lote
Resumo Financeiro
Na parte inferior da página, o Resumo exibe três totais:
| Campo | Descrição |
|---|---|
| Total Recebido | Soma das contas já marcadas como recebidas (R$) |
| Total a Receber | Soma das contas ainda pendentes (R$) |
| Total Geral | Soma total (recebido + a receber) (R$) |
Esses valores são calculados com base nas contas listadas (e filtros aplicados), permitindo uma visão rápida da situação financeira.
Pesquisa e Filtros
Pesquisa Rápida
Utilize o campo "Pesquisar contas a receber..." no topo da lista para buscar por:
- Descrição
- Documento
- Outros dados exibidos na lista
Filtros Avançados
Clique no botão "+ Adicionar Filtro" para refinar a busca. Os filtros disponíveis (conforme o módulo) incluem:
| Filtro | Descrição |
|---|---|
| Descrição | Texto na descrição |
| Empresa | Filtrar por empresa (empresaId) |
| Funcionário | Filtrar por funcionário (funcionarioId) |
| Origem | Clientes, Fornecedor, Outro |
| Pago | Sim/Não (conta recebida ou pendente) |
| Vencimento | Data ou intervalo de vencimento |
| Ordenação | Campo (ex.: vencimento) e direção (ASC/DESC) |
Adicionando uma Nova Conta
Para adicionar uma nova conta a receber:
- Clique no botão "+ Adicionar Conta" no canto superior direito da listagem
- O formulário de cadastro será aberto
- Preencha as seções (detalhadas abaixo)
- Clique em "Salvar" para gravar
O ícone de três pontos (⋯) ao lado de "Adicionar Conta" pode oferecer outras ações rápidas, se configuradas no sistema.
Formulário de Conta a Receber
O formulário está organizado em seções: Informações Básicas, Origem e Destinatário, Observações e Status.
1. Informações Básicas
Contém os dados principais da conta: valor, datas e identificação.
Campos do formulário
| Campo | Obrigatório | Descrição |
|---|---|---|
| Descrição | ✅ | Descrição da conta a receber |
| Valor | ✅ | Valor da conta (R$). Deve ser maior ou igual a zero |
| Desconto | ❌ | Desconto aplicado (R$). Padrão: 0,00 |
| Multa | ❌ | Multa (R$). Padrão: 0,00 |
| TOTAL | — | Valor calculado (ex.: valor − desconto + multa). Exibido em destaque; normalmente calculado automaticamente |
| Vencimento | ✅ | Data de vencimento da conta |
| Documento | ❌ | Número ou referência do documento |
| Parcela | ❌ | Número da parcela (ex.: 1/3). Deve ser ≥ 1 quando informado |
O campo TOTAL é exibido em destaque (ex.: fundo azul) e representa o valor líquido da conta após desconto e multa. O sistema pode calcular automaticamente com base em Valor, Desconto e Multa.
2. Origem e Destinatário
Define de onde vem a conta e para quem está vinculada.
Campos
| Campo | Obrigatório | Descrição |
|---|---|---|
| Origem | ✅ | Clientes — conta originada de cliente; Fornecedor — de fornecedor; Outro — outras origens |
| Destinatário | Condicional | Quando origem for Clientes ou Fornecedor, informe o destinatário (id e nome). Para Outro, o destinatário pode não ser obrigatório |
O dropdown Origem exibe as opções: Clientes, Fornecedor e Outro. Ao selecionar Clientes ou Fornecedor, o sistema pode exibir um seletor de cliente ou fornecedor para preencher o destinatário (id e nome).
3. Observações
| Campo | Descrição |
|---|---|
| Observações | Campo de texto livre para notas adicionais sobre a conta |
4. Status
| Campo | Descrição |
|---|---|
| Conta Recebida | Caixa de seleção. Quando marcada, a conta é considerada recebida (pago = true). Opcionalmente o sistema pode solicitar ou preencher a Data de recebimento |
Ao marcar Conta Recebida, a conta passa a constar como recebida na listagem e no resumo (Total Recebido).
Editando uma Conta
Para editar uma conta existente:
- Na lista, localize a conta desejada
- Clique no ícone de edição (lápis) na coluna Ações
- O formulário será aberto com os dados preenchidos
- Altere os campos necessários
- Clique em "Salvar"
Marcando Conta(s) como Recebida(s)
Para registrar o recebimento:
- Uma conta: Abra a conta, marque Conta Recebida (e informe a data de recebimento, se solicitado) e salve.
- Várias contas: Selecione as contas na lista e use a ação em lote Marcar como recebido (ou equivalente), se disponível no menu de opções.
O backend expõe a operação via MarcarRecebidoContasReceberDto (array de ids), permitindo marcar múltiplas contas como recebidas de uma vez.
Ações e Menu de Opções
Na coluna Ações da lista:
- Editar (ícone de lápis): Abre o formulário para edição
- Opções (ícone de engrenagem): Menu com ações adicionais (ex.: excluir, marcar como recebido, relatórios), conforme configurado no sistema
Estado Vazio
Quando não houver nenhuma conta a receber cadastrada (ou após filtrar sem resultados), a tela exibe:
- Ícone de carteira
- Mensagem: "Nenhuma conta a receber encontrada"
- Texto: "Comece adicionando sua primeira conta a receber"
Use o botão "+ Adicionar Conta" para criar a primeira conta.
Resumo dos Campos do Módulo (referência técnica)
Os dados são armazenados conforme o módulo contasReceber (entidade/schema):
Campos principais:
id, descricao, valor, desconto, multa, total, vencimento, documento, origem (Clientes | Fornecedor | Outro), parcela, funcionarioId, empresaId, destinatario (id, nome), observacoes, pago, dataRecebimento, createdAt, updatedAt, deleted.
Dicas e Boas Práticas
Use uma descrição que identifique facilmente a origem da conta (ex.: "Venda parcela 2 - NF 123" ou "Aluguel mar/2026").
Sempre preencha Origem e Destinatário (quando aplicável) para relatórios e filtros por cliente ou fornecedor.
Mantenha a ordenação por Vencimento (decrescente ou crescente) para priorizar contas mais próximas do vencimento.
Perguntas Frequentes
O que é "Total Recebido" e "Total a Receber"?
Total Recebido é a soma das contas já marcadas como recebidas. Total a Receber é a soma das contas ainda pendentes. Total Geral é a soma de todas.
Posso ter contas de várias origens?
Sim. A origem pode ser Clientes, Fornecedor ou Outro. Isso ajuda a filtrar e a vincular a conta a um cliente ou fornecedor (destinatário).
O destinatário é obrigatório?
Quando a origem for Clientes ou Fornecedor, o sistema pode exigir o destinatário (id e nome). Para Outro, o destinatário geralmente não é obrigatório.
Como marcar várias contas como recebidas de uma vez?
Selecione as contas na lista (checkboxes) e use a ação em lote "Marcar como recebido" (ou similar) no menu de opções, se disponível. O sistema envia os IDs das contas para a API de marcação em lote.
Próximos Passos
Após dominar Contas a Receber, explore outros módulos do Financeiro:
- Contas a Pagar — Gerenciar contas a pagar
- Conta Corrente — Movimentações de conta corrente
- Condições de Pagamento — Cadastro de condições de pagamento
- Centro de Custo — Centros de custo para classificação
- Cadastro de Clientes — Clientes vinculados como destinatários das contas