1、第 1 页 共 32 页机动车维 修竣工出厂合格 证管理系统接口规范四川省机动车维修竣工出厂合格证管理系统接口规范当前版本：2.0当前状态：正式发布发布日期：2015年7月13日第 2 页 共 32 页机动车维修竣工出厂合格证管理系统接口规范目录1 引言1.1 编 写目的2 概述3 2.0版本中作出的调整3.1 开放合格证查验接口3.2 增加IOS系统接口3.3新的三单3.4 照片调整3.5 时间期限调整4合格证管理系统接口新增现场照片真实性限制措施4.1目的4.2合格证管理系统对维修企业上传IP的限制4.3合格证管理系统对进厂、出厂照片真 实性验证4.4合格证管理系统2.0版本接口启用时间5
2、 开发指南 5.1 关于文档部分约定说明5.2 初始化并登录平台5.3 激活5.4 开始一个维修流程5.5 进 厂检验单5.5.1 上传数据5.5.2 上传照片、签名5.6 过 程检验单5.6.1 上传数据5.6.2 上传照片、签名第 3 页 共 32 页机动车维修竣工出厂合格证管理系统接口规范5.7 竣工检验单5.7.1 上传数据5.7.2 上传照片、签名5.8 上 传照片/签名编码列表5.9 动态验证码5.9.1 动态验证码说明5.9.2 取得动态验证码5.10 网络异常判断5.10.2 自动重连5.10.3 手动重连6 数据字典6.1 企业类型6.2 燃油类型6.3 牌照类型6.4 车辆
3、类型6.5 车型划分6.6 区域代码7 维修单 式样7.1 进厂检验单7.2 过程检验单7.3 竣工检验单第 4 页 共 32 页机动车维修竣工出厂合格证管理系统接口规范第 5 页 共 32 页机动车维修竣工出厂合格证管理系统接口规范1 引言根据四川省交通运输厅道路运输管理局关于印发汽车二级维护信息化管理系统安装使用工作方案的通知的要求：从事民用汽车二级维护的汽车维修企业应安装使用汽车二级维护信息化管理系统，严格按照国家标准 汽车维护、 检测、诊断技术规范（GB/T 18344）进行二级维护作业，汽车 二级维护竣工经检验合格后，通过与汽车二级维护信息化管理系统对接的机动车维修竣工出厂合格证管理
4、系统，打印全省 统 一格式、 带防伪二维码的机动车维修竣工出厂合格证。所有安装二 级维护信息化管理系统的汽 车维修企业均需按四川省汽车二级维护信息化管理系统作业规范（试行）的要求，将 维修作业 数据通过接口传送至四川省机动车维修竣工出厂合格证管理系统后，方可打印机 动车维修竣工出厂合格证。1.1编 写目的作为四川省汽车二级维护信息化管理系统供应商对接四川省机动车维修竣工出厂合格证管理系统的参考依据。2 概述该接口提供给四川省汽车二级维护信息化管理系统供应商将维修数据实时传送至四川省机动车维修竣工出厂合格证管理系统。需要对接四川省机动车维修竣工出厂合格证管理系统的系统供应商应到四川省交通运输厅道
5、路运输管理局车辆维修管理处进行登记，取得开 发者密钥 后进行开发，并与四川省机 动车维修竣工出厂合格证管理系统进行对接和联调。需传送至四川省机动车维修竣工出厂合格证管理系统的维修数据如下表。单证名称 单证数据 GPS信息 电子签名进厂检验单 过程检验单 竣工检验单 3 合格证管理系统接口规范2.0版本中作出的调整第 6 页 共 32 页机动车维修竣工出厂合格证管理系统接口规范3.1 开放合格证查验接口，方便汽车 二级维护信息化管理系统供应商自行开发合格证查验工具校验合格证真伪；3.2 增加IOS系统接口，以便覆盖主流的移动操作系统；3.3 按照新的汽车二级维护进厂检验单、过程检验单、竣工 检验
6、单 修改相应维修数据传送接口；3.4 将原规定的4张现场照片调整为进厂、出厂照片共 计2张；3.5 将从进厂检验单起至竣工检验单止的接收时限（即1辆车的二级维护作业时长）调整为7天，超过7天的需维修企业用户在合格证管理系统中注明原因。4 合格证管理系统接口新增现场照片真实性限制措施4.1目的提供统一的照片辨识方式，有效防止 维修企业用户传送虚假现场照片，保 证合格证管理系统留档照片的客观、真实性。4.2合格证管理系统对维修企业上传IP的限制合格证管理系统只接收不同IP地址传送的不同修理企业的维修数据，并在合格证管理系统后台予以记录留档其IP地址，以保 证维修档案的原始真实性，必要时复现其数据传
7、送的物理地址。4.3合格证管理系统对车辆进厂、出厂照片的真 实性验证二级维护供应商应向维修企业配发电子显示设备。在拍摄进厂、出厂照片 时，该设备放置于车辆号牌旁，并在拍照时自动显 示合格证管理系统下发的限 时1分钟内有效的动态验证码（4位阿拉伯数字）。在传送到合格证管理系 统的照片中， 应能清楚的 识别电子显示设备所显示的动态验证码。其照片拍摄流程图如下：二级维护 系统拍摄请求合格证管理系统发送动态验证码第 7 页 共 32 页机动车维修竣工出厂合格证管理系统接口规范维修企业用户进行进厂、出厂照片拍 摄时，照片中 电子显示屏的 动态验证码与合格证管理系统自动标识出的动态验证码一致即为真实照片。
8、4.4合格证管理系统2.0版本接口启用时间2015年8月1日，合格证管理系统 2.0版本启用，并与合格 证管理系 统1.0版本并行。2016年1月1日，关停1.0版本。5 接口软件开发指南5.1关于文档部分约定 说明5.1.1、 xml中注释为保留的字段若无特殊说明统一传默认值0。5.1.2、数据上传之后，单证和图片可以修改，签名不能修改。5.1.3、关于seqno的说明：seqno是系统供应商提供的最长为36位的一个字符串，seqno 不能重复，每次二级维护作业对应一个seqno。5.1.4、其它错误代码说明返回参数 参数说明-106 图片编码超出范围-198 接口或数据错误-999 服务器
9、正在维护-1000 服务器连接超时-1001 动态验证码为空-1002 动态验证码超时-1003 再次获取动态验证码的时间间隔未达一分钟电 子显示设备显示上传照片合格证管理系 统第 8 页 共 32 页机动车维修竣工出厂合格证管理系统接口规范5.2初始化并登录平台在AndroidManifest/application中添加开发密钥 函数原型：int init()返回参数 参数说明0 成功-199 失败函数原型：int login(string username,string password)请求参数 参数说明username 维修厂用户名，由四川省交通运 输厅道路运输管理局车辆维修管理处发
10、放password 维修厂密码返回参数 参数说明0 成功-101 失败5.3激活在帐号未激活情况下，调用登录 接口， 若返回-101则直接调用激活接口。函数原型：int activate(float gpsx,float gpsy)请求参数 参数说明gpsx 纬度gpsy 经度返回参数 参数说明0 成功第 9 页 共 32 页机动车维修竣工出厂合格证管理系统接口规范-103 已经激活-199 失败5.4开始一个维修流程函数原型：int start(string seqno, string xmldata)请求参数 参数说明seqno 流水号xmldata5四川省乐山汽车运输有限公司犍为分公司5
11、11101县内班车客运（农村客运）川J659531捷达FV7160C1FE2510923645835LFV2A11G49391121732009-09-11 00:00:0051返回参数 参数说明0 成功-104 流程状态验证失败-198 接口调用错误-199 失败第 10 页 共 32 页机动车维修竣工出厂合格证管理系统接口规范5.5进 厂检验单5.5.1上传数据函数原型：int uploaddata(string seqno, string xmldata)请求参数 参数说明seqno 流水号xmldata258902问2提11111112来了句不字手 30.630716104.080124
