碰撞报告购买及查询
1. 简介
1.1 插件简介
碰撞报告购买及查询场景,是指在购买碰撞报告接口后,根据提交车辆的车架号(VIN)以及行驶证等关键信息,支持查询并生成碰撞报告订单,并将查询信息回填至表单字段内。
1.2 应用场景
- 汽车交易平台:在二手车交易过程中,为二手车买卖双方提供车辆相关报告购买服务。,在购买报告后能了解车辆的保险等相关信息(不带事故车信息),辅助做出交易决策,增加二手车交易可信度,降低双方风险。
- 汽车金融机构:金融机构在开展汽车贷款等业务时,用户可使用本表单购买车辆相关报告或评估车辆价值和风险。用户可根据报告中的信息,结合其他评估因素,判断是否批准贷款以及确定贷款额度等。
- 汽车维修企业:维修企业在接收车辆进行维修前,用户可使用本表单购买车辆相关报告,从而深度了解车辆相关背景信息,以便更有针对性地制定维修方案,同时也能让车主明晰维修的依据和必要性。
1.3 预期效果
以查询碰撞报告详情为例,效果如下所示:
1.4 使用说明
维保报告购买及查询包含如下 2 个函数事件:
- 购买碰撞查询报告:每次调用消耗 29 个 云币;
- 碰撞报告详情:免费。
在使用对应函数时自动扣除云币数量,当云币余额可支付的次数为 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」字段;
- 证件类型:设置为「字段值」,即「上传证件类型」字段;
- 登记证书图片:设置为「字段值」,即「登记证书图片」字段;
- 行驶证图片:设置为「字段值」,即「行驶证图片」字段;
- 表单 ID:设置为「字段值」,即「表单 ID」字段;
- vin-id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」中,将应用切换至「vin 查询车辆信息 >> 购买维保报告」中,复制「 vin 」对应的字段 ID;
- 证件类型-id:设置为「自定义」,在「开放平台 >> 开发文档 >> 参数说明」中,将应用切换至「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