Simulador (Com Score)
A calculadora é uma consulta das taxas de juros, custo efetivo total (CET) e valor da parcela mensais, além do valor da solicitação ajustado (caso haja alguma limitação entre o valor solicitado e o que poderá ser ofertado ao solicitante).
Para uso desta simulação, você vai precisar enviar na request o valor do Serasa C2BA da pessoa solicitante. Caso você não tenha esse dado e ainda assim queira ter a simulação de taxas e valores em sua experiência, você pode nos pedir uma indicação de score médio e com isso, utilizá-lo como fixo em suas requisições.
Importante ressaltar que:
- Este endpoint não cria uma solicitação de empréstimo na Creditas, apenas calcula as taxas e valores. Para envio do lead, utilize o endpoint de criação da proposta
- Os valores retornados são apenas uma simulação e não significam uma oferta pré-aprovada, uma vez que depois que a solicitação de empréstimo for criada ela passará por uma análise de crédito.
Como consultar uma simulação
Request HTTP GET
Tipo da Requisição | URL | Exemplo |
---|---|---|
| {{url_base}}/simulations |
Request Params
Campo | Tipo | Obrigatório | Descrição |
---|---|---|---|
| string | Sim | CEP residencial do cliente (sem traços, apenas números) |
| double | Sim | Valor do veículo usado como garantia |
| integer | Sim | Ano de fabricação do veículo usado como garantia (Atenção: Diferente do ano do modelo do veículo |
| integer | Sim | Número de parcelas em meses. Opções: |
| double | Sim | Valor de empréstimo solicitado pelo cliente |
| double | Sim | Renda mensal informada pelo cliente |
| integer | Sim | Score (Atualmente, nossa simulação é precificada no Score Serasa C2BA. Se você utiliza score de outros bureaus ou possui um score interno, recomendamos que realize um de/para para utilizar essa calculadora). |
| string | Não | Status profissional. |
| string | Sim | Tipo do Produto |
Response
Campo | Tipo | Descrição | Observações |
---|---|---|---|
| integer | Número de parcelas |
|
| double | Taxa mensal de juros (caso o retorno seja 0.019, a taxa é 1.9% ao mês). | Pode ter até 5 casas |
| double | Taxa que considera todos os encargos e despesas incidentes nas operações de crédito. | Pode ter até 5 casas |
| double | Valor calculado para cada parcela. | Pode ter até 2 casas |
| double | Valor minimizado cedido para o empréstimo. | Pode ter até 2 casas |
| double | Valor minimizado cedido para o empréstimo. | Pode ter até 2 casas |
Exemplo de Request e Response
curl --location --request GET '{{url_base}}/simulations?zipCode=04620000&value=21000.87&manufacturingYear=2016&loanTerm=18&intendedCredit=40000.00&monthlyIncome=10000.00&score=900&professionalStatus=SELF_EMPLOYED&productType=AUTO_REFI' \
--header 'Accept: application/vnd.creditas.v1+json' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'Authorization: Bearer {{your_access_token}}'
{
"loanTerm": 18,
"monthlyIncome": 0.0237,
"totalEffectiveCost": 0.03326,
"installmentAmount": 1184.86,
"loanAmount": 15287.01
"iof": 155.62
}
Possíveis Erros
Consulte os possíveis retornos de erros, clique aqui.
Updated about 2 months ago