Simular crédito

POST/v1/simulacao

🔒 Requer Bearer token

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

**Como conferir a tabela de parcelas.** parcelas traz o cronograma completo. A parcela numero: 0 é a **carência**: tem valor_parcela: 0 e valor_amortizacao: 0, mas tem valor_juros — esses juros são **capitalizados no saldo**, não pagos. Por isso:

- valor_financiado = valor_emprestado + iof + valor_juros_carencia (+ CAD/seguro, quando financiados) = saldo devedor no início da amortização (valor_saldo_anterior da parcela 1); - soma(parcelas[].valor_amortizacao) = **valor_financiado** (a menos de centavos de arredondamento); - somar as amortizações e comparar com valor_emprestado + iof **não fecha** — a diferença é exatamente valor_juros_carencia; - valor_emprestado é o valor **líquido** creditado ao trabalhador, não o saldo financiado; - total_a_pagar é a soma das prestações pagas (numero >= 1); - valor_seguro e percentual_seguro trazem o prêmio do seguro prestamista cobrado pela linha e o percentual que o originou (em pontos percentuais: 6 = 6%). Vêm null em linha sem seguro.

As quatro taxas vêm na resposta: taxa_mensal/taxa_anual são os **juros** contratuais, e cet_mensal/cet_anual são o **CET**, que embute IOF, CAD e seguro (por isso é sempre maior). Anual e mensal são a mesma taxa capitalizada — a.a. = (1 + a.m.)^12 − 1, nunca a.m. × 12.

taxa_mensal é opcional: se omitida, a simulação usa a taxa contratual padrão do produto (**1,79% a.m.**) — não a taxa da linha nem taxa_padrao do parceiro. Envie a taxa explicitamente para não depender desse default.

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 em % a.m. (ex.: `1.79` = 1,79%). **Opcional**: se omitida, a simulação usa a taxa contratual padrão do produto (1,79% a.m.) — não a taxa da linha de crédito nem a `taxa_padrao` do cadastro do parceiro. Quando enviada, precisa estar dentro da faixa `taxa_minima`/`taxa_maxima` da linha, senão `400 ERRO_VALIDACAO`.

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

Corpo da resposta 200

resultadosarray<object>obrigatório

prazointegerobrigatório

valor_emprestadonumberobrigatório

parcela_valornumberobrigatório

total_a_pagarnumberobrigatório

cet_anualnumberobrigatório

cet_mensalnumberobrigatório

iofnumberobrigatório

valor_juros_carencianumberobrigatório

valor_financiadonumberobrigatório

valor_seguronumberobrigatórionullable

percentual_seguronumberobrigatórionullable

taxa_mensalnumberobrigatório

taxa_anualnumberobrigatório

parcelasarray<object>obrigatório

numerointegerobrigatório

data_vencimentostring<date>obrigatório

diasintegerobrigatório

valor_saldo_anteriornumberobrigatório

valor_jurosnumberobrigatório

valor_amortizacaonumberobrigatório

valor_parcelanumberobrigatório

Request

curl -X POST 'https://econsignado-api.socinal.com.br/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": 12,
      "valor_emprestado": 10000,
      "parcela_valor": 990.48,
      "total_a_pagar": 11885.76,
      "cet_anual": 28.68,
      "cet_mensal": 2.13,
      "iof": 253.2,
      "valor_juros_carencia": 357.79,
      "valor_financiado": 10610.99,
      "valor_seguro": null,
      "percentual_seguro": null,
      "taxa_mensal": 1.79,
      "taxa_anual": 23.7261,
      "parcelas": [
        {
          "numero": 0,
          "data_vencimento": "2026-08-28",
          "dias": 58,
          "valor_saldo_anterior": 10253.2,
          "valor_juros": 357.79,
          "valor_amortizacao": 0,
          "valor_parcela": 0
        },
        {
          "numero": 1,
          "data_vencimento": "2026-09-28",
          "dias": 31,
          "valor_saldo_anterior": 10610.99,
          "valor_juros": 189.94,
          "valor_amortizacao": 800.54,
          "valor_parcela": 990.48
        }
      ]
    },
    {
      "prazo": 24,
      "valor_emprestado": 10000,
      "parcela_valor": 550.56,
      "total_a_pagar": 13213.44,
      "cet_anual": 27.15,
      "cet_mensal": 2.02,
      "iof": 305.72,
      "valor_juros_carencia": 359.62,
      "valor_financiado": 10665.35,
      "valor_seguro": null,
      "percentual_seguro": null,
      "taxa_mensal": 1.79,
      "taxa_anual": 23.7261,
      "parcelas": [
        {
          "numero": 0,
          "data_vencimento": "2026-08-28",
          "dias": 58,
          "valor_saldo_anterior": 10305.72,
          "valor_juros": 359.62,
          "valor_amortizacao": 0,
          "valor_parcela": 0
        },
        {
          "numero": 1,
          "data_vencimento": "2026-09-28",
          "dias": 31,
          "valor_saldo_anterior": 10665.35,
          "valor_juros": 190.91,
          "valor_amortizacao": 359.65,
          "valor_parcela": 550.56
        }
      ]
    }
  ]
}