Simular crédito

POST/v1/simulacao

🔒 Requer Bearer token

Escopo simulacao:read. Calcula parcela/CET/IOF/total por prazo no BaaS para uma linha de crédito. Para checar margem, use POST /v1/simulacao/margem.

Corpo da requisição

numero_linhastringobrigatório

Número da linha de crédito a simular (do `GET /v1/linhas-credito`).

padrão: ^\d+$

valornumberobrigatório

Valor solicitado

≥ 1

prazosarray<number>obrigatório

Prazos (meses) a simular

taxa_mensalnumberopcional

Taxa mensal (% a.m.); sem ela usa a da linha

≥ 0

data_liberacaostringopcional

Data de liberação (YYYY-MM-DD)

padrão: ^\d{4}-\d{2}-\d{2}$

valor_seguronumberopcional

Valor de seguro (quando a linha aceita)

≥ 0

Respostas

200Simulações, uma por prazo.

400Dados inválidos (`ERRO_VALIDACAO`).

401Token ausente ou inválido (`CREDENCIAL_INVALIDA`).

Request

curl -X POST 'http://localhost:3101/v1/simulacao' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "numero_linha": "92",
  "valor": 10000,
  "prazos": [
    12,
    24,
    36
  ],
  "taxa_mensal": 1.79,
  "data_liberacao": "string",
  "valor_seguro": 0
}'

Response

{
  "resultados": [
    {
      "prazo": 10,
      "valor_emprestado": 1000,
      "parcela_valor": 112.07,
      "total_a_pagar": 1120.7,
      "cet_anual": 28.32,
      "iof": 17.86,
      "taxa_mensal": 1.79
    },
    {
      "prazo": 24,
      "valor_emprestado": 1000,
      "parcela_valor": 53.05,
      "total_a_pagar": 1273.2,
      "cet_anual": 26.97,
      "iof": 27.66,
      "taxa_mensal": 1.79
    }
  ]
}