Simular crédito com margem

POST/v1/simulacao/margem

🔒 Requer Bearer token

Escopo simulacao:read. Como POST /v1/simulacao, mas recebe cpf + cnpj_empregador e marca excede_margem contra a margem da última consulta do trio parceiro+CPF+empregador. Sem consulta de margem para o empregador: 422 CONSULTA_MARGEM_NAO_ENCONTRADA. Não persiste nada.

Mesma semântica de campos monetários de POST /v1/simulacao: soma(parcelas[].valor_amortizacao) = valor_financiado = valor_emprestado + iof + valor_juros_carencia, e a parcela numero: 0 é a carência (prestação zero, juros capitalizados). Também devolve as quatro taxas (taxa_mensal/taxa_anual = juros, cet_mensal/cet_anual = CET).

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

cpfstringobrigatório

CPF do trabalhador (11 dígitos)

padrão: ^\d{11}$

cnpj_empregadorstringobrigatório

CNPJ do empregador, como veio em `GET /v1/margem/vinculos`. É **string**: o CNPJ pode ser alfanumérico (IN RFB 2.229/2024, ex.: `R7ZW4H8H000140`) e zeros à esquerda são significativos. Máscara (`.`, `/`, `-`) é aceita e removida. Mesmo contrato de `numero_inscricao_empregador` nos demais endpoints — o nome `cnpj_empregador` é mantido por compatibilidade.

máx. 30 car. · padrão: ^[A-Z0-9]{1,30}$

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

excede_margembooleanobrigató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/margem' \
  -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,
  "cpf": "12345678901",
  "cnpj_empregador": "12345678000199"
}'

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,
      "excede_margem": false,
      "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,
      "excede_margem": false,
      "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
        }
      ]
    }
  ]
}