Detalhe de Conta a Pagar
Módulo: Financeiro Caminho na aplicação: Menu > Financeiro > Contas a Pagar > clique na linha (/financeiro/contas-pagar/:id) Última atualização: 20/04/2026
Para que serve
Exibe todos os dados de uma conta a pagar específica: dados cadastrais, totalizadores (valor original, pago e em aberto), histórico completo de baixas e estornos, e vínculo com NF-e. Permite registrar baixas, estornar baixas, cancelar a conta, editar e remover (contas sem baixas).
Quem pode usar
Usuários com acesso ao módulo Financeiro.
Como usar (passo a passo)
- Na Lista de Contas a Pagar, clique no ícone Editar (lápis) na coluna de ações da linha.
- A tela exibe os totalizadores no topo, os dados cadastrais e a tabela de baixas.
- Use os botões disponíveis conforme a situação da conta:
Registrar baixa
- Clique em Registrar baixa (visível quando a conta não está paga nem cancelada).
- 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).
- Clique em Registrar.
Estornar uma baixa
- Na tabela de baixas, localize a linha desejada.
- Clique no ícone de estorno (seta circular).
- Confirme no popup "Estornar esta baixa?".
- Um evento de estorno é criado e o saldo em aberto é recomposto.
Cancelar a conta
- Clique em Cancelar (visível apenas quando não há baixas registradas).
- Informe o Motivo do cancelamento (mínimo 3, máximo 255 caracteres).
- Clique em Cancelar conta.
Editar a conta
Disponível quando a conta não está cancelada e não possui baixas. Clique em Editar para abrir o Cadastro de Conta a Pagar 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 |
|---|---|
| Fornecedor | Nome do fornecedor |
| 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 |
| 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 |
| 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'esituacao != 'paga'. - O botão Cancelar aparece somente quando
situacao != 'cancelada'evalor_pago == 0. Se houver baixas, estorne-as primeiro. - Os botões Editar e Remover aparecem somente quando
situacao != 'cancelada'evalor_pago == 0. - Diferente das contas a receber, contas a pagar podem ser editadas independentemente de terem sido geradas por NF-e de entrada, desde que não tenham baixas.
- Baixas já estornadas não exibem o ícone de estorno.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Erro ao carregar conta a pagar" | 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 pagar cancelada" | Confirmação de sucesso | — |
| "Conta a pagar 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
- Baixas registradas aqui alimentam o Fluxo de Caixa.
Dúvidas frequentes
Por que não consigo editar a conta? A edição está disponível apenas para contas 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".
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |