Solicitações de Empréstimos
Pré-requisitos de acesso
- Permissão (módulo):
viewCredits - Licença/Feature:
LOANS - Contêiner do menu: GERAL → grupo Investimentos / Distribuições Financeiras
O que é / quando usar
Quando o modelo de negócio do tenant oferece empréstimos, o usuário final pode solicitar um empréstimo pelo app. Esta tela é o histórico de solicitações recebidas: o operador consulta quem pediu, de que tipo e quanto, podendo buscar por e-mail e exportar a base para análise.
É uma tela de consulta/triagem: o tratamento (aprovação, desembolso, garantias, liquidação) acontece no domínio de Crédito Tokenizado, não aqui. Use esta lista para acompanhar a demanda e dar entrada no fluxo de crédito.
Pré-condições
- Permissão:
viewCreditscadastrado para a role do operador (dupla — enum CPM no backend + módulo no DB). - Licença/Feature:
LOANShabilitada na licença do tenant (Vault). Se desabilitada, o item não aparece no menu. - Dependências: já devem existir solicitações criadas pelos usuários (tipos de empréstimo configurados conforme o modelo de negócio).
Passo a passo
- Acesse Investimentos → Solicitações de Empréstimos (rota
/manage-loans). - Use a busca por e-mail para localizar uma solicitação específica.
- Exporte o CSV se precisar analisar/conciliar fora da plataforma.
Filtros e colunas
| Filtro / Coluna | O que mostra | Origem do dado |
|---|---|---|
| Busca por e-mail | Filtra as solicitações pelo e-mail do solicitante | Filtro local sobre user.email |
| Data | Quando a solicitação foi criada | createTimeStamp |
| Nome | Primeiro nome do solicitante | user.firstName |
| Telefone | Telefone de contato | user.phone |
| E-mail do solicitante | user.email | |
| Tipo | Tipo de empréstimo solicitado | type (traduzido por loan.type.*) |
| Valor | Montante solicitado | amount (BigNumber, exibido com 2 casas) |
Ações e modais
- Buscar: filtra a lista carregada pelo e-mail digitado (filtro client-side).
- Exportar: gera um CSV com data, nome, telefone, e-mail, tipo e valor de cada solicitação.
Regras de negócio / cuidados
Atenção
- Esta tela não aprova nem desembolsa empréstimos — é apenas o histórico/triagem das solicitações. O ciclo de vida do crédito (políticas, desembolso, liquidação, recompra) é tratado no domínio de Crédito Tokenizado.
- A disponibilidade da funcionalidade depende do modelo de negócio do tenant (licença
LOANS).
- Valores financeiros:
amounté tratado como BigNumber; a exibição usa 2 casas, mas o valor de origem mantém a precisão completa.