维保报告购买及查询
1. 简介
1.1 插件简介
维保报告购买及查询场景，是指在购买维保报告接口后，根据提交车辆的车架号（VIN）以及行驶证等关键信息，支持生成并查询维保报告订单，并将查询信息回填至表单字段内。
1.2 应用场景
- 汽车交易平台：在二手车交易过程中，平台可调用该接口为买卖双方提供车辆相关报告购买服务。买方通过平台发起购买请求，获取报告后能了解车辆的保险等相关信息（不带事故车信息），辅助做出交易决策；卖方也可主动购买报告，向买方展示车辆状况，增加交易可信度。
- 汽车金融机构：金融机构在开展汽车贷款等业务时，为评估车辆价值和风险，可通过该接口购买车辆报告。依据报告中的信息，结合其他评估因素，判断是否批准贷款以及确定贷款额度等。
- 汽车维修企业：维修企业在接收车辆进行维修前，可购买报告了解车辆相关背景信息，以便更有针对性地制定维修方案，同时也能让车主清楚维修的依据和必要性。
1.3 预期效果
以查询维保报告详情为例，效果如下所示：
1.4 使用说明
维保报告购买及查询包含如下 2 个函数事件：
- 购买维保报告：每次调用消耗 39 个 云币；
- 维保报告详情：免费。
在使用对应函数时自动扣除云币数量，当云币余额可支付的次数为 0 时，将无法使用此插件。
2. 插件安装及启用
2.1 安装插件
1）直接安装
- 您可点击右方链接直接安装插件：车架号（VIN）查询车辆信息插件安装。
- 安装成功后，可参考本文【2.2 启用插件】，前往「开放平台 >> 插件管理」处启用插件。
2） 插件市场处安装
在简道云「插件市场」处，安装「车架号（VIN）查询车辆信息」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。
2.2 配置插件
安装后，在「插件管理」处，点击插件右侧的「设置」按钮，配置以下内容：
- jdy_api_key：将「开放平台 >> 密钥管理 >> API Key」中获取的简道云「ApiKey」配置进去。
- 应用 id：在「开放平台 >> 开发文档 >> 参数说明 」处，切换应用至「VIN 查询车辆信息插件」中，将获取到的应用 ID 配置进去。
2.3 启用插件
在插件管理中，打开「车架号（VIN）查询车辆信息」插件右侧开关，启用插件。
3. 表单搭建
插件使用可先安装：VIN 查询车辆信息插件应用模板，本文将按照示例表单进行讲解。（请选择带数据安装，辅助表单数据不可缺少）。
插件配置需要使用 2 张表单，分别是：
- 购买维保报告：输入车架号和行驶证信息，并获取维保报告单号；
- 维保报告详情：获取维保报告详情。
4. 前端事件配置
4.1 购买维保报告
4.1.1 添加按钮执行动作
进入「购买维保报告」表单内，点击「获取报告」按钮，在「字段属性 >> 执行动作」处点击「设置」，添加前端事件。
4.1.2 设置事件名称和说明
在「前端事件 >> 名称信息」处，设置事件名称和事件说明，用于区分前端事件。设置完成后，点击「下一步」。
4.1.3 设置执行动作
在「触发与执行」处，设置执行动作如下：
- 插件：选择「vin 查询车辆信息 >> 购买维保报告」；
- vin：设置为「字段值」，即「vin」字段；
- 行驶证照片：设置为「字段值」，即「行驶证照片」字段；
- jdy_app_id：设置为「字段值」，即「应用 ID」字段；
- jdy_entry_id：设置为「字段值」，即「表单 ID」字段；
- vin-id：设置为「自定义」，在「开放平台 >> 开发文档 >> 参数说明」中，将应用切换至「vin 查询车辆信息 >> 购买维保报告」中，复制「 vin 」对应的字段 ID；
- 行驶证照片-id：设置为「自定义」，在「开放平台 >> 开发文档 >> 参数说明」中，将应用切换至「vin 查询车辆信息 >> 购买维保报告」中，复制「行驶证照片」对应的字段 ID；
- 订单号-id：设置为「自定义」，在「开放平台 >> 开发文档 >> 参数说明」中，将应用切换至「vin 查询车辆信息 >> 购买维保报告」中，复制「单号」对应的字段 ID；
- 字段存储关系：点击「添加」按钮，将「订单单号」的值存储到「单号」中。
4.2 维保报告查询
4.2.1 添加按钮执行动作
进入「维保报告详情」表单中，点击「获取报告详情」按钮字段，在「字段属性 >> 执行动作」处点击「设置」，添加前端事件。
4.2.2 设置事件名称和说明
在「前端事件 >> 名称信息」处，设置事件名称和事件说明，用于区分前端事件。设置完成后，点击「下一步」。
4.2.3 设置执行动作
在「触发与执行」处，设置执行动作如下：
- 插件：选择「vin 查询车辆信息 >> 维保报告详情」；
- 订单号：设置为「字段值」，即「订单号」字段；
- 字段存储关系：点击「添加」按钮，进行如下设置：
- 将「报告链接」的值存储到「报告链接」中；
- 将「是否事故车」的值存储到「是否事故车」中；
- 将「事故等级」的值存储到「事故等级」中；
- 将「最后进店时间」的值存储到「最后进店时间」中；
- 将「维保记录.维保日期」的值存储到「维保记录.维保日期」中；
- 将「维保记录.进店里程（公里）」的值存储到「维保记录.进店里程（公里）」中；
- 将「维保记录.保养类型（保养/维修/事故）」的值存储到「维保记录.保养类型（保养/维修/事故）」中；
- 将「维保记录.维保内容描述」的值存储到「维保记录.维保内容描述」中；
- 将「维保记录.附加材料或备注」的值存储到「附加材料或备注」中；
- 将「部件维修记录.维修部件名称」的值存储到「部件维修记录.维修部件名称」中；
- 将「部件维修记录.维修等级（一般/事故）」的值存储到「部件维修记录.维修等级（一般/事故）」中；
- 将「部件维修记录.部件所在车身位置」的值存储到「部件维修记录.部件所在车身位置」中；
- 将「部件维修记录.维修动作（更换/修复/喷漆）」的值存储到「部件维修记录.维修动作（更换/修复/喷漆）」中；
- 子表单填充方式：选择「先清空子表单再填充」。
全部设置完成后，点击「保存」。
4.3 效果演示
效果参见本文【1.3 预期效果】。
5. 注意事项
1）报告信息准确率受上传图片的清晰度及质量的影响，拍照上传时请尽量在光源较为充足的情况下进行。
2）一分钟内车架号不允许重复查询。
3）单号获取后点击提交才会保留，配合下一步操作。
4）17位车架号确保输入准确、完整。
6. 联系方式
该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询，我们将提供免费的技术指导和技术落地方案:
- 公司：摇火软件科技（无锡）有限公司
- 联系人：吕金窈
- 联系电话：13376219931
400-111-0890
在线咨询