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.

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 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:

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
    }
  ]
}