> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zipdin.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Simulação do empréstimo

> Calcula as condições da operação (parcelas, CET, IOF) antes de formalizar

<Note>Etapa **opcional** — dispensável quando o contratante já tem cálculo próprio da operação.</Note>

Calcula as condições do empréstimo (parcelas, CET, IOF, seguro) antes de formalizar a operação. Use esta
funcionalidade quando o contratante não tem cálculo próprio (CET, IOF, taxas).

<Info>
  Todos os endpoints requerem autenticação via **Bearer token** no header `Authorization`.
  Consulte o [guia de autenticação](/docs/primeiros-passos/authentication) para obter suas credenciais e gerar um token.
</Info>

## Chamada

`POST /simulation/calculate` · **sempre síncrono** (ignora o header `x-version`)

Diferente dos endpoints `worker-*`, a simulação é sempre processada de forma síncrona e retorna `200` com o
resultado imediato. Fica sob a URL base `https://hml.zipdin.com.br/dataprev-controller`.

## Parâmetros

O corpo é um **array** de simulações. Cada item aceita os campos abaixo.

<Note>
  Este endpoint não tem schema de validação no Dataprev Controller — ele é um proxy direto para o serviço
  de cálculo. Os campos abaixo vêm do exemplo real da coleção de requisições do serviço; o contrato
  completo deve ser confirmado com o time de API.
</Note>

<ParamField body="[].monthlyRate" type="number">Taxa mensal da operação</ParamField>
<ParamField body="[].installmentsNumber" type="number">Quantidade de parcelas</ParamField>
<ParamField body="[].loanValue" type="number">Valor do empréstimo</ParamField>
<ParamField body="[].installmentValue" type="number">Valor da parcela</ParamField>
<ParamField body="[].insurance" type="number">Valor/indicador de seguro</ParamField>
<ParamField body="[].insuranceType" type="string">Tipo de seguro</ParamField>

## Exemplo

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://hml.zipdin.com.br/dataprev-controller/simulation/calculate \
    -H "x-api-key: SUA_API_KEY" \
    -H "Authorization: Bearer SEU_TOKEN" \
    -H "x-idempotency-key: 3f8a91b2-7c4d-4e5f-a6b7-8c9d0e1f2a3b" \
    -H "Content-Type: application/json" \
    -d '[
      {
        "monthlyRate": 1.8,
        "installmentsNumber": 48,
        "loanValue": 10000.00,
        "installmentValue": 300.00,
        "insurance": 0,
        "insuranceType": "NONE"
      }
    ]'
  ```
</CodeGroup>