随着国内新能源汽车保有量持续上升，新能源二手车交易、汽车融资租赁、第三方车况检测、网约车车队管理等业务迎来快速发展。动力电池是新能源车的核心部件，电池的健康衰减情况，直接影响车辆的交易价格与使用安全。
一、业务价值与典型应用场景
业务价值
- 量化电池状态：输出SOH健康度、衰退评分、风险等级，改变以往只靠经验估车价的模式，给新能源车辆估值提供标准化参考。
- 支撑资产风控：金融、租赁、车队在车辆入库、放款、回收时评估电池残值，降低电池大幅衰减带来的资产贬值风险。
- 提升核验效率：支持程序自动调用，适合批量验车，减少人工查询的时间成本。
- 减少交易纠纷：结构化数据搭配解读文字，可直接生成电池检测报告，缓解买卖双方信息不对称的问题。
典型场景
- 二手车交易：收车验车、车辆定价，出具配套电池检测报告
- 汽车金融、融资租赁：车辆抵押风控、残值评估、逾期车辆处置
- 第三方检测机构、维保门店：增加新能源三电专项检测项目
- 保险机构：延保承保、出险定损，区分电池自然老化和事故损伤
二、接口基础信息
| 项目 | 说明 |
|---|---|
| 接口名称 | 新能源电池健康报告查询API |
| 请求协议 | HTTPS |
| 请求方式 | GET |
| 入参 | key（接口密钥）、vin（17位车架号） |
| 返回格式 | JSON |
返回示例
{
"code": 1,
"msg": "操作成功",
"data": {
"vin": "LC0C6666666127672", // 车架号
"brand_name": "比亚迪", // 品牌
"battery_manufacturer": "比亚迪", // 电池厂商
"rate_capacity": "135", // 标称容量(Ah)
"rate_mileage": "605", // 标称续航(km)
"nominal_energy": "76.9", // 标称能量(kWh)
"battery_type": "磷酸铁锂电池", // 电池类型
"manufacturer_date": "2021", // 车辆生产年份
"refer_rate_mileage": "483", // 当前参考续航(km)
"refer_rate_mileage_desc": "↓20.2%", // 当前参考续航-分析
"battery_soh": "88.01", // 电池健康度(SOH)
"battery_soh_level": "中等", // 电池健康度(SOH)-等级，优秀、良好、中等、较差、差
"volume_score_recession": "1", // 电池衰退水平值
"volume_score_recession_level": "较低", // 安全风险水平-等级，低，较低，较高，高
"volume_score_recession_desc": "[\"本车动力电池SOH（电池健康度）为<strong>88.01</strong>%，车辆电池衰退水平值超过同类车型平均的<strong>1.0</strong>倍，动力系统发生严重故障的概率较低。\"]", // 安全风险水平-分析
"total_charge_count": "581", // 总充电次数
"total_charge_soc": "409.9", // 循环次数
"fast_ratio": "36", // 快充占比(%)
"fast_ratio_desc": "偏高", // 快充占比-分析，正常、偏高
"battery_habit_level": "良好", // 电池使用习惯等级，优秀、良好、中等、较差
"discharging_attention": "[\"快充占比偏高，电池容易衰退。\"]", // 车辆充放电模块-注意
"discharging_suggest": "[\"减少快充比例。\"]" // 车辆充放电模块-建议
}
}
三、返回字段分类与解读
返回数据分为六大模块，下面重点介绍电池健康衰减、续航参考评估、充电习惯统计三大核心模块。
3.1 电池健康衰减指标（估值与风险排查核心）
这一组属于动态数据，会随着车辆使用不断变化，是判断车况、识别隐患最关键的内容。
| 参数 | 说明 | 业务意义 |
|---|---|---|
| battery_soh | 电池健康度SOH（百分比），即当前实际容量÷出厂标称容量 | 行业常用的电池老化指标，是车辆残值评估的主要参考 |
| battery_soh_level | SOH等级：优秀、良好、中等、较差、差 | 简化评级，方便在报告和页面上直接展示，普通人更容易看懂 |
| volume_score_recession | 电池衰退综合分值 | 不只是看SOH，还结合电芯压差、异常记录、衰减速度综合计算，避免单一指标带来误判 |
| volume_score_recession_level | 安全风险等级：低、较低、较高、高 | 风控重点字段，高风险车辆需要重点复核电池隐患 |
| volume_score_recession_desc | 安全风险文字分析 | 可以放到检测报告中，说明衰退原因和潜在风险 |
提示：只看SOH存在局限性。有些车辆SOH数值尚可，但电芯压差异常，综合衰退评分和风险等级能够发现这类隐藏问题，业务上建议结合多个指标一起判断。
3.2 续航参考评估模块（直观感知指标）
车辆原厂标称续航是新车状态下的标定值，电池老化之后实际能跑的里程会缩水。这部分数据把电池衰减换算成预估里程，方便前端展示和报告解读。
| 参数 | 说明 | 业务意义 |
|---|---|---|
| refer_rate_mileage | 当前参考续航(km) | 根据电池健康度折算的预估续航，不是车机实时表显里程，仅作评估参考 |
| refer_rate_mileage_desc | 续航衰减文字分析 | 和原厂续航做对比，描述衰减程度，降低理解门槛 |
业务建议：该数值仅作为评估参考，不建议作为续航承诺对外使用，报告中需要注明。
3.3 充电循环使用数据模块（追溯衰减诱因）
两台SOH相同的新能源车，如果快充频率、循环次数不一样，后续老化速度也会有区别。这组数据用来分析电池损耗原因，辅助车况解释和议价。
| 参数 | 说明 | 业务意义 |
|---|---|---|
| total_charge_count | 总充电次数，包含快充、慢充 | 反映车辆整体充电频次，充电频繁的电池损耗压力更大 |
| total_charge_soc | 充放电循环次数 | 完整循环代表累计消耗100%电量，多次浅充浅放会合并统计，是辅助判断老化的指标 |
| fast_ratio | 快充占比（%） | 快充次数占总充电次数的比例，长期频繁快充会加速电芯老化 |
| fast_ratio_desc | 快充占比结论：正常、偏高 | 简单标注快充风险，用于车况说明 |
| battery_habit_level | 电池使用习惯等级：优秀、良好、中等、较差 | 综合快充比例、充放电区间得出，区分是正常老化还是不良用车习惯造成的损耗 |
3.4 其他模块简要说明
- 车辆基础标识：
vin、brand_name、manufacturer_date，用于车辆识别和报告归档。 - 电池出厂静态参数：电池厂商、标称容量、标称电量、电池类型、原厂续航，属于出厂固定信息，用来核验原车电池配置，排查换电池包、改装的情况。
- 报告文案模块：
discharging_attention、discharging_suggest，可以嵌入PDF、小程序报告，作为充放电风险提示和养护建议。
四、接入注意事项
- 数据覆盖限制：数据取决于车企BMS对外开放程度，部分品牌、年份的车型无法返回动态健康数据，接口会返回无数据，不计费。
- 数据定位：电池评估结果是基于BMS记录推算的参考值，不等同于线下机房专业检测，适合商业评估，不适合直接作为司法鉴定唯一依据。
- 批量请求：大批量核验时做好请求限流，高频并发容易触发接口风控。
- 密钥安全：key是身份凭证，不要直接暴露在前端页面。
