TCO — Custo Total de Propriedade do Carro por Ano

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.

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

Request body

valorVeiculoCentsinteger 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.

kmAnuaisinteger

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.

consumoKmPorLitronumber

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.

precoCombustivelCentsPorLitrointeger

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.

seguroAnualCentsinteger

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.

manutencaoAnualCentsinteger

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.

ipvaAliquotaPercentnumber

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%.

parcelaFinanciamentoCentsinteger

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.

anosTcointeger

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.

currentDatestring date-time

ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

Response

oktrue required

dataobject required

Resultado dependente da calc — ver schema individual

metaobject

Changes

No recorded changes to this operation across all 1 revision of this API.