Razão de Crédito (Ledger)
Pré-requisitos de acesso
- Permissão (módulo):
viewCredits(consulta do razão). - Licença/Feature:
CREDIT_INVESTMENTShabilitada na licença do tenant (Vault). - Contêiner do menu: TOKENIZAÇÃO → grupo Crédito Tokenizado
O que é / quando usar
A tela de Razão de Crédito é o livro-razão (ledger) que registra todos os lançamentos contábeis internos das operações de crédito: desembolsos, recebimentos de cobrança, liquidações, recompras, taxas e ajustes. Cada lançamento aponta para uma entidade (deal, recebível, cobrança, posição), tem um tipo de lançamento, um valor e um tipo de conta.
Use esta tela para auditar e conciliar o movimento financeiro de um deal — somar débitos/créditos, rastrear de onde veio cada valor e fechar o saldo por conta (getDealBalance).
Pré-condições
- Permissão:
viewCredits(permissão dupla — enum CPM + módulo dinâmico no DB). - Licença/Feature:
CREDIT_INVESTMENTShabilitada. Sem ela o grupo nem aparece no menu. - Dependências de outras telas: os lançamentos são gerados automaticamente pelos fluxos de Desembolsos, Liquidações, Cobranças e Recompras — esta tela é somente leitura.
Passo a passo
- Acesse o menu Crédito Tokenizado → Razão / Ledger.
- Preencha os filtros: Deal ID, Tipo de Entidade e/ou Tipo de Lançamento.
- Clique em Filtrar (ou Enter no campo) para carregar os lançamentos.
- Percorra a tabela para auditar o movimento; pagine conforme necessário.
Filtros e colunas
| Filtro/Coluna | O que mostra | Origem do dado |
|---|---|---|
| Deal ID (filtro) | Restringe ao deal informado | parâmetro dealId em getLedgerEntries |
| Tipo de Entidade (filtro/coluna) | A que objeto o lançamento se refere (DEAL, RECEIVABLE, CHARGE, POSITION…) | entry.entityType |
| ID da Entidade (coluna) | Identificador do objeto referenciado | entry.entityId |
| Tipo de Lançamento (filtro/coluna) | Natureza contábil do lançamento (ex.: desembolso, recebimento, taxa, recompra) | entry.entryType |
| Valor (coluna) | Montante do lançamento | entry.amount (BigNumber) |
| Tipo de Conta (coluna) | Conta interna afetada (accountType) | entry.accountType |
| Deal (coluna) | Deal vinculado | entry.dealId |
| Criado em (coluna) | Data/hora do lançamento | entry.createdAt |
Os filtros Tipo de Entidade e Tipo de Lançamento são campos de texto livre — informe o valor exato (ex.:
DEAL,CHARGE) para casar com os registros.
Ações e modais
Tela somente leitura: filtrar e paginar. Não há criação/edição/exclusão de lançamentos pela interface — o razão é alimentado pelos fluxos financeiros do crédito. O saldo por conta de um deal é calculado no backend (getDealBalance(dealId, accountType)).
Regras de negócio / cuidados
Atenção
- Razão é imutável. Lançamentos não se editam nem se apagam — correções entram como novos lançamentos (estorno/ajuste), preservando a trilha de auditoria.
- Concilie por
dealId+accountType. Para fechar o saldo de uma conta de um deal, filtre pelo deal e some por tipo de conta; o backend expõegetDealBalancepara o total. - Cada evento gera lançamento. Desembolso, recebimento de cobrança, liquidação e recompra produzem entradas correspondentes — a ausência de um lançamento esperado indica falha no fluxo de origem.
- Valores financeiros:
amounté BigNumber no backend; a UI exibe formatado, mas a conciliação deve usar a precisão plena — não arredonde.