Pular para o conteúdo principal
Tipo: Síncrona Este endpoint permite realizar a simulação de um empréstimo consignado com base em um conjunto reduzido de informações.
A simulação pode ser realizada com ou sem a definição prévia de prazo e taxa de juros, conforme as regras abaixo.

Regras de Simulação

  • Quando o prazo (número de parcelas) é informado na requisição, o retorno será uma simulação detalhada, contendo o cálculo completo da operação e o detalhamento das parcelas;
  • Quando o prazo não é informado, o retorno será uma lista de alternativas de parcelamento, com seus respectivos valores de parcela e taxas;
  • Quando a taxa de juros é informada na requisição, o cálculo será realizado com base na taxa enviada;
  • Quando a taxa de juros não é informada, o cálculo será realizado com base na taxa previamente cadastrada na BMP;
  • O onboarding do trabalhador não é obrigatório para a realização da simulação, porém é recomendado, pois permite desabilitar opções de parcelamento que excedam a margem consignável disponível do trabalhador.

Endpoint

POST /contrato/oferta-ativa/simular-consignado

Modalidades de Simulação

4.1 Simulação Detalhada (Prazo Definido)

Utilize esta modalidade quando já houver definição da quantidade de parcelas a ser ofertada ao trabalhador.
O retorno será uma lista com o detalhamento completo das parcelas da simulação.

4.2 Simulação Multiparcelamento (Prazo Aberto)

Utilize esta modalidade para apresentar ao trabalhador diferentes alternativas de parcelamento, com base no intervalo de prazo configurado para o produto do parceiro.
O retorno será uma lista de opções de empréstimo, variando conforme o número de parcelas.

4.3 Simulação por Valor de Parcela

Esta modalidade permite simular o empréstimo a partir do valor da parcela desejada pelo trabalhador.
Com base nesse valor, o sistema calcula automaticamente o valor total liberado, considerando taxa, prazo e demais encargos.
Essa abordagem é indicada para cenários em que o trabalhador tem como referência o valor máximo que pode comprometer mensalmente, alinhando-se à margem consignável disponível.

Garantias

Para facilitar a jornada do parceiro e cálculos dos valores mínimos de garantia, no retornos das simulações será apresentado os valores indicados de garantia para viabilizar a oferta na CTPS, a geração da CCB e averbação da proposta com sucesso.
MargemDisponivelInformada
number
Corresponde ao valor de margemDisponivel informado na requisição.
ofertaAtiva
object
Objeto que apresenta os valores necessários de garantia em contratação no canal do parceiro. Considerando cobertura de 50%.
ofertaAtiva.ApenasVerbasRescisorias
number
Se for utilizar de garantias apenas as verbas rescisórias, os valores de FGTS não compõem o cálculo de cobertura, então apenas o valor da margem disponível do cliente é considerado para o cálculo. Sendo assim este retorno indica qual é o valor mínimo de margem disponível para conseguir averbar o empréstimo usando como garantia apenas as verbas rescisórias.
ofertaAtiva.VerbasRescisoriasMaisFGTS
number
Neste cenário, tanto valores do FGTS quanto a margem disponível compõem o cálculo para cobertura. Serão retornadas duas informações:
  • ValorMinimoMargem - Corresponde a margemDisponivel, se este foi informado na requisição ou se não foi informado corresponderá ao valor de parcela da simulação.
  • ValorGarantiasFGTS - Corresponde a 50% do valor do empréstimo - valor margemDisponivel, para garantir o cálculo de cobertura exato de 50%.
ofertaAtiva.ApenasFGTS
number
Se for utilizar de garantias apenas valores do FGTS, o valor saldo disponível não compõem o cálculo de cobertura. Sendo assim este retorno indica qual é o valor mínimo de FGTS(Pode ser saldo e/ou multa, contanto que corresponda a 50% do valor do empréstimo) para conseguir averbar o empréstimo usando como garantia apenas os valores do FGTS.
ofertaLeilao
object
Objeto que apresenta os valores necessários de garantia em contratação no leilão. Considerando cobertura de 100%.
ofertaLeilao.ApenasVerbasRescisorias
number
Se for utilizar de garantias apenas as verbas rescisórias, os valores de FGTS não compõem o cálculo de cobertura, então apenas o valor da margem disponível do cliente é considerado para o cálculo. Sendo assim este retorno indica qual é o valor mínimo de margem disponível para conseguir averbar o empréstimo usando como garantia apenas as verbas rescisórias.
ofertaLeilao.VerbasRescisoriasMaisFGTS
number
Neste cenário, tanto valores do FGTS quanto a margem disponível compõem o cálculo para cobertura. Serão retornadas duas informações:
  • ValorMinimoMargem - Corresponde a margemDisponivel, se este foi informado na requisição ou se não foi informado corresponderá ao valor de parcela da simulação.
  • ValorGarantiasFGTS - Corresponde a 100% do valor do empréstimo - valor margemDisponivel, para garantir o cálculo de cobertura exato de 100%.
ofertaLeilao.ApenasFGTS
number
Se for utilizar de garantias apenas valores do FGTS, o valor saldo disponível não compõem o cálculo de cobertura. Sendo assim este retorno indica qual é o valor mínimo de FGTS(Pode ser saldo e/ou multa, contanto que corresponda a 100% do valor do empréstimo) para conseguir averbar o empréstimo usando como garantia apenas os valores do FGTS.