Simulador de Compra do Veículo dos Sonhos

Simule o custo completo de comprar um veículo: parcela CDC ou consórcio, IPVA por estado, seguro estimado, depreciação e custo total de propriedade em 5 anos.

post/api/v1/calc/planejamento-compra-veiculo

Request

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

Request body

valorVeiculoCentsinteger required

Valor do veículo em centavos. Ex: R$ 80.000 → 8000000

percentualEntradanumber required

Percentual de entrada (%). Ex: 30 = 30%

prazoMesesinteger required

Prazo do financiamento em meses. Ex: 48 = 4 anos

taxaJurosAnualBpsinteger required

Taxa de juros anual em basis points. Ex: 1850 = 18,5% ao ano (CDC típico em 2026)

modalidade'cdc' | 'consorcio' required

"cdc" = Crédito Direto ao Consumidor (financiamento bancário com juros), "consorcio" = sem juros com taxa de administração

taxaAdminConsorcionumber

Taxa de administração total do consórcio (%). Ex: 20 = 20% diluídos ao longo do prazo

estadoUf'AC' | 'AL' | 'AP' | 'AM' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MT' | 'MS' | 'MG' | 'PA' | 'PB' | 'PR' | 'PE' | 'PI' | 'RJ' | 'RN' | 'RS' | 'RO' | 'RR' | 'SC' | 'SP' | 'SE' | 'TO' required

Estado de emplacamento do veículo. Usado para calcular o IPVA anual (alíquota varia por UF).

anoFabricacaoVeiculointeger required

Ano de fabricação do veículo. Afeta a depreciação estimada no custo total de propriedade.

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.