接口核心能力：输入 17 位 VIN 车架号，拉取工信部备案的动力电池出厂静态档案，部分增值版接口附带 SOH 健康、衰减评估；广泛用于二手车估价、车险定损、汽修配件匹配、电池溯源。注意：基础版接口大多是出厂备案固定参数，不是车机实时动态数据，不能直接等同于当前电池健康状态。
一、接口基础信息
- 请求方式：POST / GET
- 鉴权：Token /appKey
- 入参：vin（字符串，17 位车架号，大小写不敏感，接口自带格式校验）
- 返回格式：JSON
- 调用限制：部分服务商需要车主授权才能读取动态健康数据；静态出厂参数一般无需授权
- 区分两类版本：
- 静态档案版：只返回出厂原始规格，稳定、延迟低，适合配件核验、验车
- 动态评估版：对接车联网，附带 SOH、估算续航、衰减风险，有数据缺失概率（车辆不在线、品牌不开放）
二、入参说明
| 字段名 | 类型 | 必填 | 通俗解读 |
|---|---|---|---|
| vin | string | 是 | 17 位车架号，车辆唯一身份证，是整个查询的唯一主键，少一位、错一位都会查不到 |
| auth_code | string | 否 | 授权码，读取车机实时电池数据时需要，静态查询不用 |
| report_type | string | 否 | 返回类型：simple（精简）/full（完整电芯 + BMS） |
三、返回字段分层通俗解读
3.1 车辆基础档案层
| 字段 | 示例 | 通俗解释 | 业务用处 |
|---|---|---|---|
| vin | LRWYGCFJ9…… | 回显查询的车架号，用来做结果对账 | 防止串号、返回错车数据 |
| brand_name | 特斯拉 | 车辆品牌 | 快速归类，判断电池配套体系 |
| series_name | Model Y | 车系名称 | 区分同品牌不同电池方案 |
| production_date | 2025-03 | 出厂日期 | 电池是消耗品，出厂时间是估值基础 |
| rlxs | 纯电动 | 动力类型：纯电 / 插混 | 插混电池容量普遍更小，不能按纯电标准评估 |
| nominal_mileage | 554 | 原厂 CLTC 标称续航公里 | 新车满电理论续航，仅出厂标准 |
3.2 电芯层（最小电池单元，维修、验改装重点）
| 字段 | 示例 | 通俗解释 | 通俗人话 |
|---|---|---|---|
| cell_type | 磷酸铁锂 | 电芯化学体系 | 磷酸铁锂：更安全、寿命长、冬天掉电多；三元锂：能量密度高、冬天续航更好、稳定性弱一点 |
| cell_supplier | 宁德时代 | 电芯厂家 | 判断电芯是不是原厂大牌，二手车买家很看重 |
| cell_code | CB280 | 电芯型号 | 维修换电芯必须匹配型号，型号不对容易发热、故障 |
| cell_shape | 方壳 | 电芯形态：方壳 / 圆柱 / 软包 | 方壳现在主流；圆柱代表特斯拉 4680 这类；软包多见于早期车型 |
| cell_voltage | 3.2V | 单颗电芯标称电压 | 磷酸铁锂基准 3.2V，三元锂一般 3.7V |
| cell_capacity | 172Ah | 单颗电芯容量 | Ah 代表电芯存电能力，和电压相乘得到单颗电量 |
| cell_count | 108 | 电芯总数量 | 整车一共多少颗电芯，用来核对有没有私自拆改增配电芯 |
| cell_gravimetric_energy_density | 160Wh/kg | 电芯能量密度 | 数字越高，同样重量下存电越多，技术相对新一点 |
3.3 电池包 PACK 层（日常业务最核心）
| 字段 | 示例 | 通俗解释 | 通俗人话 |
|---|---|---|---|
| batt_pack_supplier | 宁德时代 | 电池包总成厂家 | 电芯和包厂不一定是同一家 |
| nominal_energy | 76.9kWh | 电池包总电量（度） | 大家最关心的指标，76.9 就是满电 76.9 度电，决定基础续航上限 |
| batt_pack_voltage | 345.6V | 电池包标称总电压 | 快充平台、充电桩匹配、高压维修都看这个 |
| batt_pack_capacity | 222Ah | 电池包总容量安时 | 电工维修用，普通用户不用重点看 |
| batt_pack_combon | 1P108S | 串并联方式，1 并 108 串 | S = 串联（升压）、P = 并联（加容量）；1P108S 就是 1 串 108 颗电芯，核验改装、换电匹配 |
| batt_pack_mass | 420kg | 电池包重量 | 评估运输、吊装、拆解成本 |
| batt_pack_density | 145Wh/kg | 整包能量密度 | 包含外壳、BMS、冷却结构，比裸电芯密度低 |
| bms_supplier | 汇川 | BMS 电池管理系统厂家 | BMS 是电池大脑，负责均衡、保护、温控 |
3.4 动态评估扩展字段（增值接口才有，非出厂备案）
重要提醒：这部分是算法估算，不是国标硬备案参数，存在误差，页面展示必须标注
【评估参考】
| 字段 | 示例 | 通俗解释 | 风险提示 |
|battery_soh|92%| 电池健康度 | 100% 新车状态，越低代表容量衰减越多；不同厂商 BMS 算法口径不一样，不能跨品牌直接对比 |
|refer_rate_mileage|480km | 当前参考估算续航 | 根据 SOH 算出来的预估续航，不是车机实时表显 |
|volume_score_recession_level | 低 | 电池衰退风险等级 | 低 / 较低 / 较高 / 高，给报告用的评级标签 |
|soh_update_time|2026-11-01 | 健康数据采集时间 | 判断数据是不是新鲜，车辆离线很久会是旧数据 |
3.5 公共返回状态字段
| 字段 | 示例 | 解读 |
|---|---|---|
| code | 0 | 0 = 成功；400=VIN 格式错误；404 = 无备案数据；403 = 无授权 |
| msg | success | 状态描述文案，给前端展示报错 |
| data | null | 查不到数据时返回空，常见于小众改装车、海外平行进口车、早期未备案车型 |
四、JSON 最简返回示例
{
"code": 0,
"msg": "success",
"data": {
"vin": "LRWYGCFJ9MXXXXXXX",
"brand_name": "特斯拉",
"production_date": "2025-03",
"nominal_mileage": 554,
"cell_type": "磷酸铁锂",
"cell_supplier": "宁德时代",
"nominal_energy": "76.9",
"batt_pack_voltage": "345.6",
"batt_pack_combon": "1P108S",
"bms_supplier": "特斯拉自研"
}
}
五、业务接入踩坑清单
- 静态接口的 kWh、电压、电芯数量，出厂固定，不会随电池老化变化；想拿 SOH 要单独开动态评估接口
- 不同厂商 BMS 的 SOH 算法口径不一致，90% 在 A 品牌和 B 品牌衰减程度不一定对等，不要直接横向比价
- 平行进口车、小众改装车型、老款早期新能源车，VIN 查不到电池备案档案
- 串并联（1P108S）是核验是否私自改包的核心依据，一旦返回值和实车拆开不一致，大概率电池包被更换
- 磷酸铁锂的 SOH 跳变很常见，满充、浅充测出来健康度会有差异，不能单看一次结果下定论
【相关 FAQ】
问题 1：VIN 新能源电池参数查询接口，拿到的电池容量是当前实际剩余容量吗？
回答 1：基础版 VIN 电池参数接口返回的是出厂备案标称容量，是新车标准值；只有带车联网动态评估的增值接口，才会返回估算剩余容量、SOH 健康度。
问题 2：VIN 电池接口里的串并联字段 batt_pack_combon（1P108S）有什么用？
回答 2：S 代表串联升压，P 代表并联扩容；这个字段用来核验电池包有没有私自改装、换包，维修配组、换电业务也需要和这个参数匹配。
问题 3：VIN 电池接口里 cell_type 磷酸铁锂和三元锂，对业务评估有什么差别？
回答 3：磷酸铁锂寿命更长、安全冗余高，但低温衰减明显；三元锂能量密度高、冬天续航更好，热稳定性更差，二手车估价、保险定损时两个类型的折旧模型不一样。
问题 4：调用 VIN 新能源电池参数接口，为什么有的车查不到 SOH 健康字段？
回答 4：SOH 属于动态车机数据，不是工信部备案静态数据；一方面接口没开通增值评估权限，另一方面车辆品牌不开放车联网、车辆长期离线，都会返回该字段为空。
【参考资料】
[2026-10-28]（VIN 车架号查询动力电池报告 API：新能源电池评估能力接入方案）腾讯云开发者社区
[2026-08-24]（新能源汽车三电数据怎么查？用 VIN 接口获取电池、电机参数实战）腾讯云开发者社区
[2026-10-23]（新能源车电池出厂数据怎么查？VIN 车架号查询车辆三电数据 API）阿里云开发者社区
[2026-11-09]（新能源电池参数查询 API：返回电池、电芯、BMS 生产企业等信息）腾讯云开发者社区
免责声明：本文为通用 VIN 电池查询接口文档与字段解读，不同服务商、平台的字段命名、数据口径存在差异；静态备案数据仅用于核验原厂规格，不能替代专业电池检测设备；SOH、衰减评估为算法估算值，仅作业务参考，不具备司法鉴定效力。