Elegibilidade
Elegibilidade é o processo de avaliação de um cliente para determinar se ele pode ou não contratar um produto. A elegibilidade é determinada por um conjunto de regras que podem ser configuradas para cada produto. Ser elegível ao produto não significa que o empréstimo será aprovado ou que alguma análise de crédito foi feita.
Os produtos elegíveis são exibidos na tela inicial no Portal do Cliente.
Página do Portal Cliente que exibe o resultado da elegibilidade
Regras de elegibilidade
Existem regras de elegibilidade nativas da plataforma. Além dessas regras, também é possível configurar uma consulta externa para processar regras mais complexas ou consultar informações em outros bancos de dados.
Tipos de configuração da elegibilidade
A elegibilidade pode ser personalizada com opções com propósitos distintos para atender às necessidades específicas da sua empresa. Podendo ter os comportamentos:
Static
: O cálculo de elegibilidade é realizado pela plataforma, sem interagir com cálculos externos.Dynamic
: O cálculo de elegibilidade é realizado pela plataforma e, em seguida, será feita uma consulta externa possibilitando um ponto de customização para regras específicas (por exemplo, validação do Serasa e análise de crédito).Mock
: O cálculo de elegibilidade não é realizado pela plataforma, a resposta de elegibilidade são campos com valores fixos informados na configuração. Útil para testes.
Limite de empréstimos simultâneos
É possível determinar o número máximo de empréstimos que um cliente pode ter simultaneamente em cada status. Por exemplo, um cliente pode ter no máximo dois empréstimos em análise e um empréstimo desembolsado.
Para configurar o limite de empréstimos simultâneos, é necessário informar o número máximo de empréstimos em cada status na configuração do produto. Também é possível considerar um grupo de status.
Status | Quantidade | Descrição |
---|---|---|
Aberto e Pendente | 1 | Será permitido apenas um empréstimo em análise ou pendente |
Desembolsando e Desembolsado | 1 | Será permitido apenas um empréstimo desembolsado ou em processo de desembolso, que pode ser o tempo até que a transferência seja concluída. |
Veja como configurar os parâmetros de limite de empréstimos simultâneos:
A configuração pode ser feita no parâmetro concurrency
através do endpoint Atualizar produto da API de Produtos.
Por exemplo:
{
"settings": {
"loans": {
"concurrency": [
{
"status": ["open"],
"quantityAllowed": 1
},
{
"status": ["disbursing", "disbursed"],
"quantityAllowed": 1
},
]
}
}
}
Consulta externa
A configuração pode ser feita no parâmetro settings.products.eligibility
através do endpoint Atualizar produto da API de Produtos.
Por exemplo:
{
"settings": {
"products": {
"eligibility": {
"type": "dynamic",
"options": {
"url": "<url-da-api-externa>",
"headers": {}
}
}
}
}
}
A consulta externa corresponde à uma API HTTP, ela permite que um aplicativo faça solicitações e receba respostas de servidores WEB.
O endpoint da API HTTP é desenvolvido e fornecido inteiramente pelo Cliente, a Base39 não tem responsabilidade sobre a exatidão do mesmo.
O cálculo de elegibilidade é executado uma vez para cada Produto cadastrado e, em cada Produto, para cada Vínculo Empregatício válido existente.
A consulta externa será executada uma vez para cada Vínculo Empregatício processado.
Regras
Por meio da consulta externa, é possível sobrescrever campos do retorno da Elegibilidade utilizados pelo Portal do Cliente, portanto, o resultado da API HTTP deverá respeitar os campos de entrada do contrato.
Campos permitidos para sobrescrição:
Nome | Tipo | Descrição |
---|---|---|
available | boolean | Determina se o cliente está elegível ao Produto |
Input
{
"document": "12345678900"
}
Output
{
"data": [
{
"product": "prod_6565ea3902dde9b885583123",
"slug": "consignado",
"name": "Consignado",
"description": "Produto de empréstimo consignado",
"image": "",
"maxLoanAmount": 55257.9,
"minLoanAmount": 200,
"maxNumberOfInstallments": 34,
"minNumberOfInstallments": 7,
"maxInstallmentValue": 3050.87,
"minInstallmentValue": 0,
"customer": "cust_64c1293f321997b7afe4b123",
"employment": "empl_664cd588244192875e65f123",
"available": true
},
{
"product": "prod_656f73c3fde863611471234",
"slug": "antecipacao",
"name": "Antecipação de Salário",
"description": "Produto de antecipação de salário",
"maxLoanAmount": 0,
"minLoanAmount": 0,
"maxNumberOfInstallments": 0,
"minNumberOfInstallments": 0,
"maxInstallmentValue": 0,
"minInstallmentValue": 0,
"employment": "empl_661d9315951a29fe0f771123",
"available": false
}
]
}