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.

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

cpfstringobrigatório

CPF do trabalhador (11 dígitos)

padrão: ^\d{11}$

cnpj_empregadorstringobrigatório

CNPJ do empregador (14 dígitos)

padrão: ^\d{14}$

Respostas

200Simulações, uma por prazo, com `excede_margem`.

400Dados inválidos (`ERRO_VALIDACAO`).

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

Request

curl -X POST 'http://localhost:3101/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": 10,
      "valor_emprestado": 1000,
      "parcela_valor": 112.07,
      "total_a_pagar": 1120.7,
      "cet_anual": 28.32,
      "iof": 17.86,
      "taxa_mensal": 1.79,
      "excede_margem": false
    },
    {
      "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,
      "excede_margem": false
    }
  ]
}