积智数据 VIN 精准译码（ VIN+PARTSNAME）

基于 [VIN 精准译码 API] 的 OpenClaw 技能，支持：

• VIN PARTSNAME 精准译码：通过 17 位 VIN 车架号 与 待译码的配件别名列表, 精准解出这些配件的 标准配件编码OE 与 标准配件名称等信息

使用技能前需要申请数据，请联系【积智数据】 MOBILE (+86 13916450206/15821282326) ; EMAIL( juyuan@jikugroup.com/jiangzhihui@jikugroup.com) 获取。

后端服务

本技能依赖 VIN-PARTSNAME 精准译码 服务，接口地址：https://erp.qipeidao.com/jzOpenClaw/getVinOe

环境变量配置

# Linux / macOS
export JZ_API_KEY="your_appkey_here"

# Windows PowerShell
$env:JZ_API_KEY="your_appkey_here"

脚本路径

脚本文件：skills/vinoe/get_vin_oe.py

使用方式

1. 根据 VIN + 询价配件别名列表 精准解析出 询价配件的标准配件编码 与 标准配件名称 信息

python3 skills/vinoe/get_vin_oe.py {"vinCode":"LSVAL41Z882104202","partsNameList":["前保险杠皮","中网"]}

##VIN 精准译码 请求参数

| 字段名  | 类型   | 必填 | 说明                                           |
|--------|--------|------|------------------------------------------------|
| vin    | string | 是   | 17 位 VIN 车架号                               |
| partsNames | list | 是   | 配件名称列表，每个元素为一个字符串。 |

示例：

LSVAL41Z882104202 ["前保险杠皮","中网"]

## VIN 查询返回结果示例

脚本直接输出接口 `model` 字段，结构与示例一致（示例简化）：

[

{

"partsOe": "1ZD807221GRU",

"aliasName": "前保险杠皮",

"stdName": "前保险杠皮",

"price4sSales": "1411.00",

"price4sNet": "1007.45",

"price4sSalesNoTax": "1248.67",

"dummy": false,

"oeSource": null,

"remark": null,

"referType": 0,

"priceRefer": null,

"priceSource": null

},

{

"partsOe": "1ZD8536689B9",

"aliasName": "中网",

"stdName": "中网",

"price4sSales": "378.00",

"price4sNet": "292.50",

"price4sSalesNoTax": "334.51",

"dummy": false,

"oeSource": null,

"remark": null,

"referType": 0,

"priceRefer": null,

"priceSource": null

}

]

当出现错误（如 VIN 不正确或无数据），脚本会输出：

{

"error": "api_error",

"state": 202,

"msg": "VIN不正确"

}

## 常见错误码


| 代号   | 说明      |
|------|---------|
| 10001 | 参数错误    |
| 10004 | VIN 不正确或无数据 |


## 在 OpenClaw 中的推荐用法

1. 用户给出车架号和待译码e配件名称列表：「帮我查一下 VIN  `LSVAL41Z882104202` 询价配件： 前保险杠皮 中网 的 标准配件编码与标准名信息」。  
2. 调用：  
   `python3 skills/vinoe/get_vin_oe.py LSVAL41Z882104202 '["前保险杠皮","中网"]'`  
3. 从返回中选取 `partsOe/aliasName/stdName/price4sSales/price4sNet/price4sSalesNoTax` 等字段，给出自然语言总结；