Pular para o conteúdo principal

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.

nota

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.

Image

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 propósitos distintos para atender às necessidades específicas da sua empresa. Podendo ter os comportamentos:

OpçãoDescrição
EstáticoO cálculo de elegibilidade é realizado pela plataforma, sem interagir com cálculos externos.
DinâmicoO 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).
TesteO 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.

StatusQuantidadeDescrição
Aberto e Pendente1Será permitido apenas um empréstimo em análise ou pendente
Desembolsando e Desembolsado1Será 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 Paketa 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:

NomeTipoDescrição
availablebooleanDetermina 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
}
]
}