---
title: "TCO — Custo Total de Propriedade do Carro por Ano"
method: POST
path: "/api/v1/calc/custo-total-veiculo-tco"
tags: ["calc", "veiculos"]
---

# TCO — Custo Total de Propriedade do Carro por Ano

`POST /api/v1/calc/custo-total-veiculo-tco`

## Request

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

Descubra o custo real de ter um carro: depreciação, IPVA, seguro, combustível, manutenção e financiamento. Saiba quanto você gasta por km rodado.

## Request body

- object
  - `valorVeiculoCents` integer, required: Valor de mercado atual do veículo em centavos (referência FIPE). Ex: R$ 50.000 → 5000000
  - `tipoVeiculo` 'carro_popular' | 'carro_medio' | 'carro_premium' | 'caminhonete' | 'moto', required: Categoria do veículo, usada para estimar a taxa de depreciação anual. "carro_popular" = modelos de até R$ 80k; "carro_medio" = R$ 80k–150k; "carro_premium" = acima de R$ 150k; "caminhonete" = picapes (menor depreciação); "moto" = motocicletas.
  - `kmAnuais` integer: Quilômetros rodados por ano. Mínimo 1.000 km, máximo 200.000 km. Usado para calcular o custo de combustível e o custo por km. Média brasileira: 15.000 km/ano.
  - `consumoKmPorLitro` number: Consumo médio do veículo em quilômetros por litro (km/L) em uso misto (cidade + estrada). Mínimo 3 km/L, máximo 30 km/L. Carros populares flex: 11–14 km/L; motos: 20–30 km/L.
  - `precoCombustivelCentsPorLitro` integer: Preço do combustível por litro em centavos. Ex: R$ 6,00/L → 600. Gasolina comum: ~R$ 5,80–6,50; etanol: ~R$ 3,80–4,50; diesel S10: ~R$ 6,00–7,00.
  - `seguroAnualCents` integer: Prêmio anual do seguro do veículo em centavos. Ex: R$ 3.000/ano → 300000. Varia por perfil do motorista, modelo e localização. Use 0 se não tiver seguro.
  - `manutencaoAnualCents` integer: Custo anual estimado de manutenção em centavos (revisões, troca de óleo, pneus, peças). Ex: R$ 2.000/ano → 200000. Deixe em branco para usar a estimativa padrão do tipo de veículo.
  - `ipvaAliquotaPercent` number: Alíquota do IPVA do estado de emplacamento em % ao ano. Ex: 4 = 4% a.a. Referência: SP 4% (auto) / 2% (moto); RJ 4%; MG 4%; PR 3,5%; SC 2%; RS 3%.
  - `parcelaFinanciamentoCents` integer: Valor da parcela mensal do financiamento em centavos. Ex: R$ 1.200/mês → 120000. Informe 0 se o veículo estiver quitado ou for pago à vista.
  - `anosTco` integer: Horizonte de tempo para calcular o custo total de propriedade (TCO), em anos. Mínimo 1 ano, máximo 10 anos. Use 5 anos para uma análise de médio prazo típica.
  - `custosObrigatoriosAnuaisCents` object[]: Custos obrigatórios anuais categorizados (DPVAT, licenciamento, emplacamento, taxa cadastro de financiamento, seguro prestamista, transferência de propriedade, outro). Use o valor anual mesmo quando o desembolso é one-shot (ex.: emplacamento amortizado por 1 ano = valor pago integral). Cada item: { categoria, valorCents, descricao? }. Padrão []. Não inclui IPVA (campo dedicado) nem manutenção. 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)