Pular para conteúdo

Contas a pagar e orçamento

Tela do Telvora ERP — Contas a pagar e orçamento

Captura do Telvora ERP em ambiente autorizado. Valores de tabelas e formulários foram ocultados para privacidade.

Módulo: Financeiro
Menu: Financeiro → Contas a Pagar
Público: Financeiro / Operador
Status: Publicado
Atualizado: 2026-09-03
Refs técnicas: ADR-013 · ADR-014 · ADR-015 · 01-ARQUITETURA/59-financeiro-pagar-ixc.md

O que faz

Ao lançar uma despesa, o sistema exige conta contábil e centro de custo e, se houver orçamento ativo, valida o saldo disponível antes de gravar o título. É possível lançar parcelado (valor dividido) ou parcela recorrente (títulos iguais a cada 30 dias).

Quem pode usar

  • finance.payable.create / update / read / cancel
  • Preview de saldo também aceita accounting.budget.read

Pré-requisitos

  • Fornecedor, carteira/conta de pagamento, nota fiscal (quando exigido).
  • Conta contábil analítica (despesa/investimento).
  • Centro de custo analítico na filial.
  • (Opcional) Orçamento ACTIVE no período da competência (issue_date).

Passo a passo

  1. Abra nova conta a pagar.
  2. Preencha filial, fornecedor, datas, valor, conta e centro.
  3. No campo fornecedor, digite o código (ID) e Tab/Enter: o sistema grava exatamente esse fornecedor (não o primeiro da busca por documento/nome).
  4. Também pode buscar pela lupa (nome, documento ou código).
  5. (Opcional) Marque Parcelado ao lado do valor:
  6. Informe o nº de parcelas (2 a 60).
  7. Confira o valor por parcela (valor total dividido).
  8. Preencha o vencimento de cada parcela.
  9. Ao salvar, o sistema cria um título por parcela (mesmo grupo).
  10. (Opcional) Marque Parcela recorrente (não combine com Parcelado):
  11. Informe o nº de parcelas (2 a 60).
  12. O valor do formulário é o valor de cada título (iguais).
  13. Vencimentos: 1º = data de vencimento; demais a cada 30 dias.
  14. Ao salvar, gera N títulos vinculados.
  15. Observe o bloco Orçamento (disponível / excedente / soft / nível).
  16. Salve:
  17. Dentro do saldo (ou soft) → título(s) OPEN.
  18. Excedente com enforcement APPROVAL → informe justificativa → PENDING_BUDGET.
  19. Enforcement BLOCK → lançamento impedido.

Cancelar título parcelado / recorrente

  1. Abra qualquer parcela do grupo e informe o motivo na aba Informações.
  2. Clique em Cancelar título.
  3. Confirme: o sistema avisa que todo o grupo será cancelado e lista os números.
  4. O toast mostra os títulos cancelados (ex.: #10, #11, #12).
  5. Se alguma parcela já tiver pagamento, o cancelamento em grupo é bloqueado — estorne antes.

Regras importantes

  • Competência orçamentária usa a data de emissão (issue_date) no MVP.
  • Título PENDING_BUDGET não compromete o orçamento até aprovação.
  • Após aprovação do excedente, o título vira OPEN.
  • Parcelas/recorrências do mesmo lançamento compartilham installment_group_id; cancelar uma cancela todas.
  • Parcelado divide o valor; recorrente repete o mesmo valor.
  • Listas paginadas (grids) ordenam por padrão por ID/código; clique no cabeçalho da coluna para alternar asc/desc. A ordenação vale para toda a consulta (não só a página visível).
  • Ao editar um título sem rateio, trocar o centro de custo e salvar grava o novo centro (cabeçalho e linha de alocação). Com rateio em várias linhas, altere as linhas do rateio (ou desative o rateio) para mudar a distribuição.

Erros / avisos comuns

Situação O que fazer
NEEDS_APPROVAL Informe justificativa e solicite excedente
BLOCKED Reduza o valor ou ajuste o orçamento
Conta/centro obrigatório Selecione analíticos ativos
Parcelamento/recorrência com título pago Estorne o pagamento antes de cancelar o grupo

Relacionados

Referências