Financeiro - Contas a Pagar

O que é

A página Contas a Pagar concentra todos os compromissos financeiros da sua empresa - boletos de fornecedores, despesas fixas, custos vinculados a excursões, parcelamentos e séries recorrentes. Cada linha representa uma obrigação com fornecedor, valor, data de vencimento e status (Pendente, Pago, Parcialmente Pago, Vencido ou Cancelado).

Os usuários do setor financeiro chegam aqui no dia a dia para conferir o que vence na semana, registrar o pagamento de um boleto que já foi quitado no banco ou cadastrar uma nova despesa. No topo, três KPIs mostram o Pendente, o Vencido e o Pago este mês, facilitando a leitura rápida da situação.

Como usar

1. Vá em Financeiro > Contas a Pagar no sidebar.
2. Use a barra de filtros para localizar contas:
   • Descrição, fornecedor, documento... - busca livre nos três campos.
   • Status - Todos, Pendentes (atalho para tudo que ainda não foi quitado), Pendente, Pago, Parcialmente Pago, Vencido ou Cancelado.
   • Categoria - restringe pela categoria de despesa cadastrada em Financeiro > Categorias.
3. Para cadastrar uma nova conta, clique em Nova Conta (botão flutuante no topo direito).
4. Preencha o formulário Nova Conta a Pagar:
   • Descrição (obrigatório) - texto livre, ex.: "Aluguel sede", "Conta de luz".
   • Fornecedor - nome de quem vai receber.
   • Documento/NF - número da nota fiscal ou boleto.
   • Categoria - categoria de despesa para o relatório.
   • Vincular a excursão - opcional; associa o custo a uma excursão específica.
   • Valor (obrigatório) - em reais, com máscara de dinheiro.
   • Data de Emissão - padrão hoje.
   • Data de Vencimento (obrigatório) - data em que a conta vence.
   • Conta Bancária - opcional aqui; pode ser definida na hora de pagar.
   • Anexar Documento - PDF, JPG ou PNG até 5 MB.
5. Para finalizar, escolha no rodapé:
   • Cadastrar Conta - salva e volta para a listagem.
   • Salvar e Continuar Editando - salva e abre a tela de edição.
   • Salvar e Cadastrar Nova - salva e abre um novo formulário em branco.

Dar baixa em uma conta (Pagar)

1. Na linha da conta pendente, clique no ícone verde de cédulas (Pagar).
2. No modal Registrar Pagamento:
   • Valor a Pagar - vem preenchido com o valor restante; reduza para registrar pagamento parcial.
   • Conta para Débito (obrigatório) - escolha a conta bancária que será debitada.
   • Data do Pagamento - padrão hoje.
3. Clique em Confirmar Pagamento. Se o valor for igual ao restante, o status vira Pago; se for menor, vira Parcialmente Pago e o saldo continua aberto.

Cancelar uma conta

1. Clique no ícone de X cinza na coluna Ações da linha.
2. Confirme em Cancelar Conta no modal de confirmação.
3. A conta passa para o status Cancelado e some das somatórias de pendente e vencido.

Casos especiais

Parcelamento na criação

No formulário de nova conta, marque o checkbox Parcelar esta conta e escolha o Número de Parcelas (de 2x a 24x). O valor informado é dividido igualmente entre as parcelas e cada uma recebe vencimento mensal contado a partir da Data de Vencimento. A primeira parcela é a "mãe" e as demais ficam vinculadas a ela por parcela_pai_id.

Recorrência (despesas fixas)

Para despesas que se repetem (aluguel, internet, salários), marque Repetir esta conta automaticamente e configure:

• Periodicidade - Diária, Semanal, Quinzenal, Mensal, Bimestral, Trimestral, Semestral ou Anual.
• Repetir até - escolha Número de parcelas (mínimo 2, máximo 120) ou Data final.

Todas as parcelas da série são criadas no ato do cadastro com status Pendente e podem ser editadas individualmente depois. Na listagem, cada linha de uma série recebe um ícone de seta circular indicando a posição na série e a periodicidade.

Edição que afeta a série inteira

Ao editar uma conta que faz parte de uma série recorrente, aparece o campo Escopo da edição com três opções:

• apenas esta - altera só a parcela em edição.
• esta e futuras - altera a parcela atual e todas as próximas ainda não pagas.
• todas não pagas - propaga para qualquer parcela da série que ainda não foi quitada.

Só os campos editáveis (fornecedor, documento, categoria, conta, excursão, descrição, observação, valor) são propagados; vencimentos individuais permanecem.

Exclusão de série

Ao excluir uma parcela de série recorrente, o sistema oferece os mesmos três escopos (apenas esta, esta e futuras, todas não pagas). Contas com status Pago nunca são excluídas, mesmo dentro do escopo.

Custos variáveis vinculados a excursão

Contas com tipo_custo = variavel e excursão vinculada (cadastradas pelo módulo de custos da excursão) mostram o valor unitário multiplicado pelo número de passageiros ativos, com a indicação R$ X,XX × N pax logo abaixo do total. O somatório de Pendente e Vencido no topo já expande esses custos automaticamente; o Pago este mês soma só o que foi efetivamente quitado.

Vencimentos automáticos

Toda visita à página dispara FinContaPagar::atualizarVencimentos(), que marca como Vencido qualquer conta Pendente ou Parcialmente Pago cuja data de vencimento já passou. Não é preciso rodar nada manual.

Erros comuns e como resolver

• "Esta conta não pode ser editada." - Causa: a conta está com status Pago ou Cancelado. Solução: contas pagas só podem ser consultadas; se houve erro no pagamento, cancele o lançamento na conta bancária e crie uma nova conta a pagar.
• "Esta conta não pode receber pagamento." - Causa: o usuário tentou pagar uma conta já quitada ou cancelada. Solução: confira o status na coluna antes de clicar em Pagar.
• "Esta conta já está cancelada." - Causa: clique duplo ou tentativa de cancelar pela segunda vez. Solução: nenhuma, a operação anterior já surtiu efeito.
• "Contas pagas não podem ser excluídas." - Causa: ao excluir uma conta de série, o sistema preserva qualquer parcela com status Pago. Solução: cancele o pagamento na conta bancária correspondente antes de tentar excluir.
• Validação "O campo valor a pagar deve ser menor ou igual a X" - Causa: o valor digitado no modal Registrar Pagamento supera o saldo restante da conta. Solução: ajuste o valor para o restante exibido em Valor restante.
• Comprovante não anexado - Causa: arquivo fora dos formatos aceitos (PDF, JPG, JPEG, PNG) ou maior que 5 MB. Solução: converta ou comprima o arquivo antes de subir.

Onde encontrar

• URL: /admin/financeiro/contas-pagar
• Caminho no menu: Financeiro > Contas a Pagar
• Permissões necessárias: financeiro.contas-pagar (acessar/editar) e financeiro.contas-pagar.pagar (registrar pagamento)
• Módulo necessário: Gestão Financeira

Veja também

• Visão Geral do Financeiro
• Transações Financeiras
• Contas Bancárias
• Categorias Financeiras
• Dashboard Financeiro