Detalhe de Conta a Receber

Módulo: Financeiro Caminho na aplicação: Menu > Financeiro > Contas a Receber > clique na linha (/financeiro/contas-receber/:id) Última atualização: 23/04/2026

Para que serve

Exibe todos os dados de uma conta a receber específica: dados cadastrais, totalizadores (valor original, pago e em aberto), histórico completo de baixas e estornos, e vínculo com pedido de venda ou NF-e. Permite registrar baixas, estornar baixas, cancelar a conta, editar (contas manuais) e remover (contas manuais sem baixas).

Quem pode usar

Usuários com acesso ao módulo Financeiro.

Como usar (passo a passo)

1. Na Lista de Contas a Receber, clique no ícone Editar (lápis) na coluna de ações da linha.
2. A tela exibe os totalizadores no topo, os dados cadastrais e a tabela de baixas.
3. Use os botões disponíveis conforme a situação da conta:

Registrar baixa

1. Clique em Registrar baixa (visível quando a conta não está paga nem cancelada).
2. No modal, informe:
   • Valor da baixa: pré-preenchido com o valor em aberto.
   • Data da baixa: obrigatória.
   • Forma de pagamento: opcional.
   • Observações: opcional (até 500 caracteres).
3. Clique em Registrar.

Estornar uma baixa

1. Na tabela de baixas, localize a linha da baixa que deseja estornar.
2. Clique no ícone de estorno (seta circular).
3. Confirme no popup "Estornar esta baixa?".
4. Um evento de estorno é criado e o saldo em aberto é recomposto.

Cancelar a conta

1. Clique em Cancelar (visível apenas quando não há baixas registradas).
2. Informe o Motivo do cancelamento (mínimo 3, máximo 255 caracteres).
3. Clique em Cancelar conta.

Editar a conta

Disponível apenas para contas manuais (não originadas de pedido de venda) sem baixas e não canceladas. Clique em Editar para abrir o Cadastro de Conta a Receber em modo edição.

Remover a conta

Disponível nas mesmas condições que editar. Clique em Remover e confirme. A conta é desativada (soft delete) e o sistema retorna à lista.

Campos da tela

Totalizadores

Campo	Descrição
Valor original	Valor total da conta no momento do cadastro
Total pago	Soma de todas as baixas (menos estornos)
Em aberto	Diferença entre original e pago

Dados da conta

Campo	Descrição
Cliente	Nome do cliente
Documento	CPF ou CNPJ formatado
Parcela	Número da parcela / total de parcelas
Emissão	Data de emissão (DD/MM/AAAA)
Vencimento	Data de vencimento; vermelho se vencida
Liquidação	Data em que a conta foi totalmente quitada
Forma de pagamento	Forma cadastrada na conta
Filial	Filial responsável
Pedido de venda	Link para o pedido de origem, quando houver
NF-e	Número da NF-e
Chave NF-e	Chave de 44 dígitos, copiável

Tabela de baixas e estornos

Coluna	Descrição
Data	Data do evento (DD/MM/AAAA)
Tipo	Tag: "Baixa" (verde), "Baixa (estornada)" (cinza), "Estorno" (amarelo)
Valor	Valor com sinal: + para baixa, - para estorno
Forma	Forma de pagamento usada na baixa
Usuário	Quem registrou a baixa
Observações	Texto livre da baixa

Modal — Registrar baixa

Campo	Obrigatório	O que preencher	Observações
Valor da baixa	Sim	Valor numérico (R$)	Deve ser positivo; pré-preenchido com saldo em aberto
Data da baixa	Sim	Data (DD/MM/AAAA)	Pré-preenchida com a data atual
Forma de pagamento	Não	Lista de formas ativas	Pré-preenchida com a forma da conta
Conta bancária / caixa	Sim	Lista de contas ativas	Conta onde o dinheiro entra — obrigatória
Observações	Não	Texto livre	Até 500 caracteres

Modal — Cancelar conta

Campo	Obrigatório	O que preencher	Observações
Motivo do cancelamento	Sim	Texto livre	Entre 3 e 255 caracteres

Validações e regras

• O botão Registrar baixa aparece somente quando situacao != 'cancelada' e situacao != 'paga'.
• O botão Cancelar aparece somente quando situacao != 'cancelada' e valor_pago == 0. Se houver baixas, estorne-as primeiro.
• Os botões Editar e Remover aparecem somente para contas manuais (sem pedido de venda vinculado), não canceladas e sem baixas registradas.
• Baixas já estornadas não exibem o ícone de estorno.
• O estorno não exclui a baixa original; cria um novo evento do tipo "estorno" vinculado à baixa original.

Baixa automática na emissão da NF-e

Quando a conta nasce a partir de um pedido de venda e a forma de pagamento da parcela tem Liquidação automática habilitada (ver Cadastro de Forma de Pagamento):

• A ContaReceber já é criada com situacao = 'paga' no mesmo momento em que a NF-e é autorizada.
• Na tabela de baixas, aparece uma linha do tipo "Baixa" com a observação "Baixa automática — liquidação na emissão da NF-e".
• O usuário registrado é quem autorizou a NF-e.
• A conta de destino vinculada à forma de pagamento é a que recebe o crédito — o saldo dessa conta em Contas Bancárias / Caixa é atualizado imediatamente.
• Se a conta de destino configurada na forma de pagamento estiver inativa ou deletada no momento da autorização, a baixa automática é ignorada silenciosamente e a CR fica aberta para baixa manual (a emissão da NF-e não falha por esse motivo).
• A baixa automática pode ser estornada normalmente quando necessário.

Mensagens de erro e o que fazer

Mensagem	Causa	Como resolver
"Erro ao carregar conta a receber"	Falha na comunicação com a API	Recarregue a página
"Baixa registrada com sucesso"	Confirmação de sucesso	—
"Baixa estornada com sucesso"	Confirmação de sucesso	—
"Conta a receber cancelada"	Confirmação de sucesso	—
"Conta a receber removida"	Confirmação de sucesso	—
"Informe o valor"	Campo valor em branco no modal de baixa	Preencha o valor
"Valor deve ser positivo"	Valor zero ou negativo no modal de baixa	Informe um valor maior que zero
"Informe a data"	Data em branco no modal de baixa	Selecione a data
"Informe o motivo"	Motivo em branco no cancelamento	Preencha o motivo
"Motivo muito curto"	Motivo com menos de 3 caracteres	Escreva ao menos 3 caracteres
"Maximo 255 caracteres"	Motivo excede o limite	Reduza o texto
—	Regra de negócio no servidor	Verifique a situação da conta e tente novamente

Integrações e dependências

• Formas de pagamento cadastradas em Formas de Pagamento.
• Contas bancárias / caixa cadastradas em Contas Bancárias / Caixa.
• Contas originadas de pedido de venda exibem link para o Pedido de Venda correspondente.
• Baixas registradas aqui alimentam o Fluxo de Caixa e atualizam o saldo da conta em Contas Bancárias / Caixa.

Dúvidas frequentes

Por que não consigo editar a conta? A edição está disponível apenas para contas manuais (não vinculadas a pedido de venda), sem baixas e não canceladas. Se a conta tiver baixas, estorne-as primeiro para liberar a edição.

Posso registrar uma baixa parcial? Sim. Informe qualquer valor menor que o saldo em aberto. A situação passará de "Aberta" para "Parcial".

O que acontece ao estornar uma baixa? O sistema cria um evento de estorno que reverte o valor no saldo em aberto. A baixa original permanece na tabela marcada como "estornada".

Por que essa conta já veio como "paga" sem eu fazer nada? A forma de pagamento da parcela provavelmente está com Liquidação automática habilitada. Ver a seção "Baixa automática na emissão da NF-e" acima.

Histórico de alterações

Data	Alteração
23/04/2026	Adicionada seção "Baixa automática na emissão da NF-e" e documentado o campo "Conta bancária / caixa" no modal de baixa.
20/04/2026	Documento inicial criado.