✕ Fechar

💰 Manual — Financeiro

Contas a pagar e receber, títulos, plano de contas, DRE e cobrança — explicado sem jargão, com “saiba mais” técnico opcional.

O que é o módulo Financeiro?

É onde a empresa controla o dinheiro que entra e que sai: o que você tem a receber de clientes e o que tem a pagar a fornecedores, mais o caixa, os bancos e os relatórios (DRE).

Cada conta a pagar ou receber vira um título. A partir deles a plataforma monta o fluxo de caixa, cobra clientes e gera o resultado da empresa.

Passo a passo — do título ao caixa

  1. Lance o título. A pagar (CP) ou a receber (CR), com valor, vencimento e categoria. (quase todos já entram sozinhos: venda → Faturamento → CR previsto; compra, folha, nota de entrada → CP — veja "De onde vêm os títulos")
  2. Classifique na categoria certa (plano de contas). É o que alimenta o DRE. (seção Categoria)
  3. Acompanhe vencimentos no fluxo de caixa; ligue a régua de cobrança nos clientes. (seção Cobrança)
  4. Baixe (quite) quando pagar/receber — concilie com o extrato do banco. (seção Tesouraria)
  5. Veja o resultado no DRE e nos indicadores.

CP × CR ⭐ o que mais confunde

Tudo no Financeiro é uma destas duas direções:

CR Contas a Receber
Dinheiro que vai entrar — o que os clientes te devem. Nasce da venda / NF-e emitida.
CP Contas a Pagar
Dinheiro que vai sair — o que você deve a fornecedores, impostos, salários. Nasce da compra / nota de entrada.
Regra simples: vendeu → CR (entra). Comprou/contratou → CP (sai). O saldo do caixa é CR − CP ao longo do tempo.

Título e parcela

O título é a conta inteira (ex.: “NF 123 do cliente X, R$ 12.000”). As parcelas são os pedaços com vencimentos (ex.: 3× de R$ 4.000). Você quita parcela por parcela.

TermoEm português simples
VencimentoA data-limite para pagar/receber a parcela.
BaixaMarcar a parcela como paga/recebida (quitada).
Em abertoAinda não foi pago/recebido.
VencidoPassou do vencimento e continua em aberto.
x
Modelos `TituloFinanceiro` (PAGAR/RECEBER) + `ParcelaTitulo` (PENDENTE/PAGA). A baixa registra data e valor efetivo; conciliação casa com o lançamento bancário. Réguas de cobrança e fluxo de caixa leem as parcelas PENDENTE por vencimento.

De onde vêm os títulos ⭐ regra da plataforma

Você quase nunca precisa lançar título na mão: cada módulo manda o seu para cá, sempre do mesmo jeito.

CR Dinheiro que entra
Toda receita nova nasce pelo Faturamento: o módulo de origem (contrato, projeto, CRM, marketplace…) cria um Pedido de Venda e, junto, o CR previsto. Ele aparece em Títulos com "previsto (aguardando nota)" e o código do pedido. Ao emitir a nota, ela assume o título — sem duplicar.
CP Dinheiro que sai
Todo pagamento nosso nasce aqui em Contas a Pagar: pedido de compra aprovado, nota de entrada, despesa de importação, folha e benefícios, tarifa do banco, guias de retenção, medição de fornecedor, orçamento de terceiros aprovado na Manutenção, repasse do marketplace.
  • Sempre com parcela(s) e forma de pagamento (boleto, PIX, transferência…). Título sem parcela some dos totais, do fluxo de caixa e da quitação — por isso nenhum nasce assim. Quando ninguém informa a forma, vale o padrão da plataforma (boleto). Se você digitar "TED" ou "DOC", entra como Transferência.
  • Refazer não duplica. Cada documento tem uma chave: aprovar o mesmo orçamento ou reenviar o mesmo ciclo duas vezes gera um único título.
  • Cliente sem cadastro fiscal: não existe Pedido de Venda. O valor entra direto no Contas a Receber, com parcela, sem pedido e sem nota, e o módulo de origem mostra um aviso. Cadastre o cliente no Faturamento.
⚠️ Exceção: o módulo Gás-leilão ainda não segue essa regra.
x
Rotina central `lib/financeiro/titulosCentral.js`: `faturarNoFaturamento` (Pedido de Venda + CR previsto, `numeroDocumento` = código do pedido) e `criarTitulo` (CR/CP com parcelas, código CP-AAAA-NNNN / CR-AAAA-NNNN, forma padronizada, idempotência por `chaveDocumento`). Exemplos de chave: `MFA-COT-<id>` (orçamento de terceiros da Manutenção, categoria "manutenção" quando existir), `MED-<contrato>-<id>` (medição de fornecedor).

Categoria / plano de contas

A categoria diz “do que é” aquele dinheiro (ex.: “Receita de vendas”, “Aluguel”, “Energia”, “Folha”). É o plano de contas da empresa.

💡 Classificar certo é o que faz o DRE sair correto. Um pagamento sem categoria é dinheiro que “sumiu” do relatório. Na dúvida, use a categoria mais próxima — o contador ajusta.

DRE — o resultado da empresa

DRE = “Demonstração do Resultado”. É o relatório que mostra se a empresa teve lucro ou prejuízo no período.

Ele pega tudo que entrou (receitas) menos tudo que saiu (custos e despesas), agrupado por categoria. Por isso a categoria de cada título importa tanto.

x
DRE gerencial montado por `CategoriaFinanceira` (receita/custo/despesa) sobre os títulos no regime configurado (caixa ou competência). Os mesmos dados alimentam a ECD do Hub Contábil.

Tesouraria e conciliação bancária

É o controle de contas bancárias e caixa: saldos, transferências, cheques e a conciliação — conferir se cada lançamento do banco bate com um título baixado na plataforma.

A integração bancária (Open Finance) pode trazer o extrato automático para facilitar essa conferência.

Réguas de cobrança

São lembretes e cobranças automáticas enviados ao cliente — antes e depois do vencimento — para reduzir inadimplência.

RéguaO que faz
Pré-vencimentoLembrete amigável antes de vencer (ex.: 7, 1 e 0 dias antes).
Pós-vencimentoCobrança depois de vencer + tarefa de ligação para o time.

Você liga/desliga por cliente (tela /financeiro/cobranca). A plataforma sugere ativar quando há faturamento.

Notas de entrada (NF-e → Contas a Pagar)

Quando um fornecedor emite uma NF-e contra o seu CNPJ, ela chega aqui: você concilia com o pedido de compra, gera o título a pagar e a nota fica arquivada legalmente (5 anos). Tela /financeiro/notas-entrada.

⚠️ Fique de olho nas notas sem pedido ou com divergência — a plataforma sinaliza e pode abrir um fluxo para o fornecedor problemático.

Alçadas de aprovação

São limites por cargo: até quanto cada pessoa pode aprovar um pagamento. Acima do limite, sobe automaticamente para o superior. Garante controle sem travar o dia a dia.

Perguntas frequentes

Qual a diferença entre CP e CR?
CR = a receber (dinheiro entra, vem da venda). CP = a pagar (dinheiro sai, vem da compra).
Preciso lançar todo título na mão?
Não. A receita nova entra pelo Faturamento (Pedido de Venda + CR previsto) e os pagamentos nascem em Contas a Pagar, sempre com parcelas e forma de pagamento. Você lança na mão só o que não tem origem automática.
O valor entrou no Contas a Receber, mas não tem pedido nem nota. Por quê?
O cliente não tinha cadastro fiscal no Faturamento. O dinheiro não se perde, mas a nota não sai sozinha: cadastre o cliente.
Se a mesma ação rodar duas vezes, o título duplica?
Não. Cada documento tem uma chave e o título existente é reaproveitado.
Por que classificar na categoria certa?
Porque o DRE (lucro/prejuízo) é montado por categoria. Sem ela, o valor não aparece direito no resultado.
O que é “dar baixa”?
Marcar a parcela como paga/recebida. Depois você concilia com o extrato do banco.
Como reduzo inadimplência?
Ative as réguas de cobrança (pré e pós-vencimento) nos clientes, em /financeiro/cobranca.