Contrato — gerar financeiro (com venda)¶

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

Módulo: Cadastros / Financeiro
Menu: Cadastros → Contratos → (editar) → aba Financeiro
Público: Operador | Gestor | Administrador
Status: Publicado
Atualizado: 2026-09-10
Refs técnicas: GenerateFinanceFromContract · ADR-018 · 01-ARQUITETURA/64-receber-geracao-financeiro-ixc.md

O que faz¶

Na aba Financeiro do contrato, Gerar financeiro / Gerar adicional cria os títulos em Contas a receber e, para cada título, uma venda (tipo 501) vinculada já finalizada. No grid, a coluna Venda mostra o ID da venda (clique para abrir).

Antes de gerar, você pode ajustar a data base financeira do contrato e/ou informar o 1º vencimento (opcional) só para aquela geração.

Quem pode usar¶

finance.receivable.create — gerar financeiro do contrato

Pré-requisitos¶

Contrato ACTIVE (ou SUSPENDED)
Vendedor preenchido no contrato
Carteira de cobrança no contrato
Produto(s) do contrato com conta de receita
Tipo de documento 501 cadastrado nos auxiliares

Passo a passo¶

Abra o contrato do cliente.
(Opcional) Na faturamento/dados, ajuste a Data base financeira.
Vá na aba Financeiro.
(Opcional) Informe 1º vencimento na barra da geração.
Clique em Gerar financeiro (primeira geração) ou Gerar adicional (já existem títulos abertos).
Confira no grid: cada linha tem ID do título e Venda (#…).
Na aba Vendas, as vendas aparecem com status Finalizada.
Use Imprimir boletos / Receber como no Contas a receber.

Regras importantes¶

Cada título gerado pelo contrato recebe um sale_id (venda própria, paridade IXC id_saida).
A venda é criada e finalizada no mesmo fluxo (botão Gerar financeiro, Gerar adicional e geração AUTO na ativação).
Quantidade de títulos/vendas gerados = Nº de parcelas (vendas) do contrato (billing_sale_count, 1–12).
Se informar 1º vencimento, ele tem prioridade sobre o cálculo pela data base + dia fixo.
Se Gera financeiro = Automático, ao ativar o contrato o sistema tenta gerar o financeiro na hora (vendas já finalizadas).
O job agendado GENERATE_FINANCE usa o mesmo comportamento.
Título avulso criado em Contas a receber → Novo ainda pode existir sem venda (cadastro manual).

Erros / avisos comuns¶

Mensagem / situação	O que fazer
Já existem títulos… Use geração adicional	Use Gerar adicional
Vendedor é obrigatório…	Informe o vendedor na aba principal do contrato
Carteira de cobrança é obrigatória…	Informe a carteira na aba Faturamento
Produto sem conta de receita	Cadastre a conta no produto
Tipo 501 não cadastrado	Rode seed de auxiliares / cadastre o tipo
Contrato sem produto	Inclua itens/plano no contrato
Gere o financeiro antes de validar…	Não se aplica a este fluxo (financeiro já vem com a venda)

Relacionados¶

Na aba Vendas do contrato, as vendas comerciais com contract_id aparecem no grid (incluindo as criadas ao gerar financeiro).