---
title: "Calculadora de Financiamento de Veículo 2026"
method: POST
path: "/api/v1/calc/financiamento-veiculo"
tags: ["calc", "veiculos"]
---

# Calculadora de Financiamento de Veículo 2026

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

## Request

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

Simule o financiamento do seu carro ou moto pelos sistemas SAC e Price. Calcule parcelas, IOF e CET (Custo Efetivo Total) antes de fechar negócio.

## Request body

- object
  - `valorVeiculoCents` integer, required: Valor total do veículo em centavos. Ex: R$ 50.000 → 5000000
  - `percentualEntrada` number, required: Percentual do valor do veículo pago como entrada. Em % (ex: 20 = 20% de entrada). 0% significa sem entrada; máximo 90% (financiamento mínimo de 10%).
  - `prazoMeses` integer, required: Prazo total do financiamento em meses. Mínimo 12 meses (1 ano), máximo 84 meses (7 anos).
  - `taxaMensalPercent` number, required: Taxa de juros mensal do financiamento em % ao mês. Ex: 1.5 = 1,5% a.m. Aceita zero para financiamentos subsidiados. Verifique a taxa oferecida pelo banco antes de simular.
  - `sistema` 'sac' | 'price': Sistema de amortização do financiamento. "price" = Tabela Price (parcela fixa durante todo o contrato, mais comum em bancos); "sac" = SAC (amortização constante, parcelas decrescentes, total pago menor).
  - `tipoPessoa` 'pf' | 'pj': Tipo de pessoa do contratante, pois afeta a alíquota do IOF. "pf" = Pessoa Física (IOF diário de 0,0082%); "pj" = Pessoa Jurídica (IOF diário de 0,0041%).
  - `custosTransacao` object[]: Custos de transação adicionais cobrados no fechamento do financiamento, agrupados por categoria (taxa_cadastro_financiamento, seguro_prestamista, transferencia_propriedade, emplacamento, dpvat, licenciamento, outro). Cada item: { categoria, valorCents, descricao? }. Padrão []. Esses custos são somados ao custo total da operação, mas NÃO entram no cálculo do CET (que considera só o saldo principal e parcelas conforme Resolução CMN 3.517/07). Use "outro" + descrição para itens não cobertos.
    - `categoria` 'dpvat' | 'licenciamento' | 'emplacamento' | 'taxa_cadastro_financiamento' | 'seguro_prestamista' | 'transferencia_propriedade' | '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)