guia-veiculos-brasileiros

Complete real-time Tabela FIPE API with 27-state IPVA tax calculation, 5-year depreciation projection, PCD catalog, and automotive rankings.

原始信息汇总

数据集概述：巴西车辆指南与FIPE表API（guia-veiculos-brasileiros）

该API是一个综合性的巴西车辆数据服务，核心功能围绕FIPE表（巴西官方车辆参考价格表）提供价格查询、税务计算和汽车市场分析。服务覆盖汽车、摩托车和卡车三类车型，所有接口返回符合OpenAPI 3.0标准的标准化JSON数据。

核心功能模块

1. FIPE价格查询

   • 支持按品牌、型号、年份/燃料类型进行层级导航查询。
   • 支持通过官方FIPE代码（如095022-0或0950220）直接查询车辆，并返回所有年份变体。
   • 提供与月度官方FIPE参考表同步的平均市场价格。

2. IPVA州税计算（覆盖巴西全部27个州）

   • 根据各州法律，对汽车、摩托车、卡车进行精确的IPVA（巴西机动车财产税）计算。
   • 支持单次付款现金折扣和分期付款方案计算。
   • 自动核查基于车龄的州级免税规则（10年、15年、20年或30年）。

3. 5年折旧预测

   • 基于车辆年龄和类别的市场平均折旧率，提供未来5年的年度残值预测曲线。
   • 计算第一年名义货币损失。

4. PCD（残障人士）车辆目录与税收减免

   • 根据法定限额（联邦IPI最高20万雷亚尔，州ICMS最高12万雷亚尔）动态计算税收减免。
   • 对比公开建议零售价与PCD买家估计最终价格。

5. 车辆对比引擎

   • 单次API调用支持2至5辆车并排对比分析。
   • 自动识别最低市场价格、最低年IPVA和最低累计折旧。

6. 市场排名与分类筛选

   • 提供0km新车和二手车按价格、价值等分类的排名列表。
   • 支持价格区间、品牌、车身风格（如hatch、sedan、suv）等组合筛选搜索。

主要接口汇总

接口类别	路径示例	功能说明
健康检查	GET /api/fipe/health	验证FIPE模块在线状态
参考表	GET /api/fipe/referencias 或 /atual	获取月度参考表列表及当前活跃参考期
车辆类型	GET /api/fipe/tipos	获取支持的车辆类别（汽车、摩托车、卡车）
品牌/型号/年份	GET /api/fipe/{tipo}/marcas 等	层级查询品牌、型号及年份/燃料组合
车辆估值	GET /api/fipe/{tipo}/marcas/{marca_id}/modelos/{modelo_id}/anos/{ano_id}	获取FIPE官方价格，可选带IPVA和折旧分析
FIPE代码查询	GET /api/fipe/codigo/{codigo_fipe}	通过FIPE代码直接查询车辆信息
排名	GET /api/fipe/rankings 等	获取各类0km新车及二手车市场排名
PCD目录	GET /api/fipe/catalogo/pcd	获取符合PCD免税条件的车型及估计价格
IPVA计算器	GET/POST /api/fipe/calculadoras/ipva	独立计算车辆IPVA税额
折旧计算器	GET/POST /api/fipe/calculadoras/depreciacao	计算5年折旧预测曲线
车辆对比	POST /api/fipe/comparar	并排比较多辆车的价格、IPVA和折旧
多筛选搜索	GET /api/fipe/busca	按关键词、类别、价格范围搜索车辆

数据特性

• 价格数据：与FIPE月度官方参考表同步，返回数值和格式化金额（如R$ 6.147,00）。
• 税务信息：包含具体州税率、折扣比例（如单次付款3%折扣）、分期选项及免税规则说明。
• 折旧数据：提供逐年预测值、累计折旧百分比和5年完整变化曲线。
• 排名数据：包含车辆排名位置、市场亮点标签（如“巴西最实惠0km车”）及对应的FIPE代码。

技术说明

• 定价模式：免费使用，但每分钟请求上限为100次（另有付费PRO和ULTRA版本）。
• 服务状态：服务可靠性100%，平均延迟592毫秒，社区测试通过率100%。
• 合规性：所有响应遵循OpenAPI 3.0规范，支持MCP Playground。

注：该API由FIPE官方数据源（含Parallelum v2、Official FIPE和BrasilAPI多级解析器）聚合数据，并添加财务和税务计算层，适用于汽车市场分析、购车决策支持及税务规划工具开发。