---
title: "Financiamento Imobiliário — SAC vs Price"
method: POST
path: "/api/v1/calc/financiamento-imobiliario"
tags: ["calc", "imoveis"]
---

# Financiamento Imobiliário — SAC vs Price

`POST /api/v1/calc/financiamento-imobiliario`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/financiamento-imobiliario`
- Auth: HTTP bearer

Simule seu financiamento imobiliário nos dois sistemas mais comuns: SAC (parcela decrescente) e Price (parcela fixa). Veja total pago, juros, primeira e última parcela.

## Request body

- object
  - `valorFinanciadoCents` integer, required: Valor total financiado pelo banco em centavos (valor do imóvel menos a entrada). Ex: R$ 400.000 → 40000000
  - `prazoMeses` integer, required: Prazo total do financiamento em meses. Ex: 360 = 30 anos, 240 = 20 anos. Máximo: 420 meses (35 anos).
  - `taxaMensalPercent` number, required: Taxa de juros mensal do financiamento. Ex: 0.875 = 0,875% ao mês (equivale a ~11% ao ano). Consulte a taxa efetiva mensal informada pelo banco, não a taxa nominal anual.
  - `sistema` 'SAC' | 'Price': Sistema de amortização do financiamento. "SAC" = parcela decrescente (amortização constante, juros caem a cada mês — total pago é menor); "Price" = parcela fixa do início ao fim (amortização crescente). Padrão: SAC.
  - `custosTransacao` object[]: Custos de transação one-shot pagos no ato da compra/financiamento, agrupados por categoria: itbi, registro_cartorio, escritura, avaliacao, mip (seguro de morte), dfi (danos físicos do imóvel), vistoria_perícia, corretagem, taxa_cadastro, iof_financiamento, outro. Cada item: { categoria, valorCents, descricao? }. ATENÇÃO: MIP/DFI já costumam estar embutidos na taxa efetiva (CET) cobrada pelo banco — se o seu CET já contempla, NÃO duplique aqui. Padrão: [].
    - `categoria` 'itbi' | 'registro_cartorio' | 'escritura' | 'avaliacao' | 'mip' | 'dfi' | 'vistoria_perícia' | 'corretagem' | 'taxa_cadastro' | 'iof_financiamento' | 'outro', required
    - `valorCents` integer, required: Valor em centavos. Ex: R$ 200 → 20000.
    - `descricao` string: Descrição livre do item (opcional, especialmente útil quando categoria = "outro"). Máx. 60 caracteres.
  - `currentDate` string, date-time: ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

## Response `200`

OK

- object
  - `ok` true, required
  - `data` object, required: Resultado dependente da calc — ver schema individual
  - `meta` object

## Other responses

- `422`: Input invalido (Zod parse falhou)
- `500`: Engine error

---

[API](https://skmtc.dev/calculas/apis/contai-api.md) · [All operations](https://skmtc.dev/calculas/apis/contai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/calculas/apis/contai-api/revisions/26a00749292b?raw)