Dicionário de campos
Campos ausentes vêm como null (ou lista vazia), nunca são omitidos, então seu parser pode contar com a estrutura. Use fields= para pedir só o que precisa. O Datacar não inventa dados: o que nenhuma fonte informa fica null.
Visão completa (view=full)
| Campo | Tipo | Descrição |
|---|---|---|
id | string | Identificador estável: <código FIPE>:<ano>-<combustível> (005340-6:2015-3; 0 km = 0km-5). |
fipe_code | string | Código FIPE com dígito verificador. |
model_year / zero_km | integer | null / boolean | Ano modelo; null e zero_km=true para 0 km. |
fipe_fuel_code | integer | Combustível na FIPE: 1 gasolina, 2 álcool, 3 diesel, 4 elétrico, 5 flex, 6 híbrido. |
vehicle_type | enum | null | car, motorcycle, truck. |
brand | string | null | Marca normalizada (“VW - VolksWagen” → “Volkswagen”). |
model / version | string | null | Família (“Amarok”) e o restante da descrição FIPE (versão). |
fipe_description | string | null | Descrição exatamente como a FIPE publica. |
fuel | enum | null | gasoline, ethanol, diesel, flex, electric, hybrid, plugin_hybrid, cng, other. |
body_type | enum | null | hatchback, sedan, wagon, suv, pickup, minivan, coupe, convertible, van, truck, bus, motorcycle, scooter, other. |
cabin | enum | null | Picapes: single, extended, double. |
doors / seats | integer | null | Portas e lugares (null para motos). |
engine | { displacement_cc, displacement_l, cylinders, valves, aspiration, power_cv, torque_kgfm, electric, hybrid } | aspiration: natural, turbo, supercharged. Cilindrada lida da FIPE é arredondada (1.0 → 1000 cm³). |
transmission | { type, gears } | type: manual, automatic, cvt, automated (Dualogic, I-Motion…), dct. |
drivetrain | enum | null | 4x2, 4x4, awd. |
dimensions | { length_mm, width_mm, height_mm, wheelbase_mm } | Medidas em milímetros (curadoria ou fontes parceiras). |
weight_kg / trunk_l / fuel_tank_l | integer | null | Peso, porta-malas e tanque. |
consumption | { gasoline_city_km_l, …, range_km, co2_g_km, energy_rating } | Inmetro PBE Veicular: km/l na cidade e na estrada por combustível, autonomia de elétricos, CO₂ e classe A–E. |
price | { amount, amount_cents, currency, reference_month, fipe_reference } | Preço médio da Tabela FIPE no mês de referência mais recente. |
price_history[] | { month, amount, amount_cents } | Com include=history. Série completa em /prices. |
manufacturer / country_of_origin | string | null | Fabricante e país de origem do modelo (Wikidata). |
images | { url, alternatives[] } | Fotos ilustrativas do modelo (Wikimedia Commons, licenças livres). |
fiscal | { hs_code, description } | Subposição do SH (6 primeiros dígitos do NCM), capítulo 87. |
quality | { score, warnings[] } | Score 0–100 e alertas (conflict, low_confidence, implausible, price_jump, missing). |
sources[] | string[] | Fontes que contribuíram para o registro. |
provenance | objeto | Com include=provenance: { campo: { confidence, sources, dissent } }. inferred:fipe = lido da descrição FIPE. |
Visão plana (view=flat)
Projeção plana com chaves em português, pensada para DMS, ERPs, planilhas de importação e integrações chave/valor. É também o formato do CSV exportado no painel.
| Chaves | Observação |
|---|---|
id, codigo_fipe, ano_modelo, zero_km | Identificadores |
tipo, marca, modelo, versao, descricao_fipe | tipo em português: Carro, Moto, Caminhão |
combustivel, carroceria, cabine, portas, lugares | Rótulos em português: Flex, Picape, Dupla… |
motor_litros, cilindrada_cc, cilindros, valvulas, turbo, potencia_cv, torque_kgfm | turbo é booleano |
eletrico, hibrido, cambio, marchas, tracao | cambio: Manual, Automático, CVT, Automatizado, Dupla embreagem |
comprimento_mm, largura_mm, altura_mm, entre_eixos_mm, peso_kg, porta_malas_l, tanque_l | |
consumo_gasolina_cidade … consumo_diesel_estrada, autonomia_km, co2_g_km, classificacao_pbe | km/l do Inmetro |
preco_fipe, mes_referencia | preco_fipe em reais (número) |
fabricante, pais_origem, imagem_url | |
sh_ncm, qualidade | Subposição do SH e score 0–100 |
De onde vem cada campo
| Fonte | Campos | Licença |
|---|---|---|
| Tabela FIPE (espelhos Parallelum e BrasilAPI; site oficial opcional) | marca, descrição, tipo, combustível, preço e histórico | Dados públicos da FIPE |
| Descrição FIPE (leitura do Datacar) | modelo, versão, motor, válvulas, turbo, câmbio, tração, carroceria, cabine, portas | — |
| Inmetro PBE Veicular | consumo, CO₂, classificação, câmbio/marchas | Dados abertos do Inmetro |
| Wikidata / Wikimedia Commons | carroceria, fabricante, país de origem, fotos | CC0; fotos com licença livre por arquivo |
| NHTSA vPIC | decodificação de chassi (GET /v1/vin) | Domínio público (EUA) |
Preço FIPE e dados fiscais são referências. O preço FIPE é uma média de mercado, não a avaliação de um veículo específico. A subposição do SH é uma sugestão: os dois últimos dígitos do NCM e a classificação final na NF-e são responsabilidade da sua contabilidade.