Bancos e conciliação

Conta, extrato e matching. A conciliação não substitui o título.

Cadastro

  • Bancos: /apps/banks/list
  • Contas: /apps/banks/accounts (accountId / bankAccountId no título)
  • Integrações: /apps/financeiro/integracoes-bancarias (ex. PagHiper em /apps/financeiro/integracoes/paghiper)

Conciliação

Tela /apps/bank-conciliation (a imagem do site institucional usa este fluxo). Extratos: /apps/financeiro/extratos-bancarios. Relatório: /apps/financeiro/relatorios/conciliacao-bancaria.

O matching confronta linhas de extrato com baixas/títulos. Não cria obrigação comercial: a obrigação continua sendo FAB012 gerada pela NF ou pelo faturamento.

KPIs

GET /financial-transactions/dashboard/:filialId — 1 SQL + listas top-15; cache Redis 45s.
GET .../summary/:filialId · cash-flow/:filialId · aging/:filialId · monthly-comparison/:filialId · top-suppliers / top-customers.

Cache invalidado em create/pay/cancel/estorno (fail-open).

Fluxo de caixa

Tela /apps/financeiro/fluxo-de-caixa + relatórios diário/projetado. Budget: serviço CashFlowBudgetService e relatório /apps/financeiro/relatorios/budget.