Pular para o conteúdo
EntrarCriar conta
Ver .md Abrir no Claude Abrir no ChatGPT

FIPE pela placa

O objeto fipe traz o valor da Tabela FIPE do mês atual para o veículo da placa. A FIPE é a referência de preço médio de veículos usada em compra, venda, seguro e financiamento no Brasil.

Como o valor é encontrado

  1. O registro do veículo traz o código FIPE mais provável. Buscamos o valor do mês corrente para esse código e ano-modelo, então o preço nunca chega desatualizado.
  2. Quando o registro não traz o código, buscamos por marca, modelo e ano.
    • Uma versão compatível: fipe vem preenchido normalmente.
    • Mais de uma versão (1.0, 1.6, 2.0…): fipe.valor vem null e fipe.versoes traz a lista com o valor de cada uma, para o usuário escolher.
  3. Se nada for encontrado, fipe vem null. A consulta da placa continua válida.

Campos

CampoTipoDescrição
codigostring ou nullCódigo FIPE (ex.: 005225-6)
marcastring ou nullMarca como aparece na FIPE
modelostring ou nullModelo e versão como aparecem na FIPE
ano_modelonumber ou nullAno do modelo usado na busca
combustivelstring ou nullCombustível da tabela FIPE
valornumber ou nullValor em reais (ex.: 28799.0)
valor_textostring ou nullValor formatado (ex.: R$ 28.799,00)
referenciastring ou nullMês de referência (ex.: novembro de 2026)
versoesarrayOutras versões possíveis, cada uma com codigo, modelo, valor e valor_texto

Exemplo com várias versões

json
"fipe": {
  "codigo": null,
  "marca": "Fiat",
  "modelo": null,
  "ano_modelo": 2019,
  "combustivel": null,
  "valor": null,
  "valor_texto": null,
  "referencia": "novembro de 2026",
  "versoes": [
    { "codigo": "001461-3", "modelo": "ARGO 1.0 6V Flex.", "valor": 52310.0, "valor_texto": "R$ 52.310,00" },
    { "codigo": "001462-1", "modelo": "ARGO DRIVE 1.3 8V Flex", "valor": 57940.0, "valor_texto": "R$ 57.940,00" }
  ]
}

Como mostrar na sua tela

js
function textoFipe(fipe) {
  if (!fipe) return 'FIPE não encontrada para este veículo';
  if (fipe.valor) return `${fipe.valor_texto} (FIPE ${fipe.referencia})`;
  if (fipe.versoes.length) {
    return 'Escolha a versão: ' + fipe.versoes.map((v) => `${v.modelo} ${v.valor_texto}`).join(' · ');
  }
  return 'FIPE não encontrada para este veículo';
}

Atualização

A Tabela FIPE muda uma vez por mês. O valor é sempre o do mês de referencia; não é preciso nenhum parâmetro para pedir o mês atual.