四川省汽车维修电子健康档案系统对接规范

全国汽车电子健康档案系统

2019年3月

前言

请各ERP软件企业仔细阅读对接规范,对接前需获取开发ApplicationID,获取ApplicationID请发送邮件到:cedk@qq.com 并抄送42362647@qq.com,邮件内容包括:营业执照号码、企业名称、ERP软件名称、联系电话、联系人、法人、地址。其中企业名称、ERP软件名称、联系电话、营业执照号码、详细地址会在对接成功后更新到ERP供应商列表。

第一章 接入要求

1、本规范说明适用于ERP企业对全国汽车维修电子健康档案系统的接入。

2、根据汽车维修电子健康档案系统建设标准(JT/T 1132-2017)、《交通运输部办公厅关于开展汽车维修电子健康档案系统建设工作的通知》(交办运〔2017〕69号)的要求,维修企业应实时、全部、自动上传维修记录数据。由ERP企业为维修企业提供的上传工具必须满足实时、全部、自动上传维修记录数据的功能要求。

第二章 接入指引

2.1 接入需知

请严格按照文档规范内容进行数据请求。

第三章 接入规范

本章规定了请求接口过程中需要遵守规范要求,包括数据接口规范、安全规范以及接口详细信息,对接ERP需按照本章的接入规范开发符合规范要求的应用服务,保证符合汽车电子健康档案系统的接口要求。

3.1 数据接口规范

3.1.1 接口调用方法

POST

文档内示例地址结尾测试地址,正式启用请将http://git.96515.cc:11000/替换为https://archive.12328.tv/

3.1.2 接口请求内容格式

JSON

3.1.3 接口样例(仅作样例示范)
3.1.3.1 维修记录结构图(13个数据元)
序号 层级 父元素名称 元素名称 约束 类型 长度 描述 取值
1 1.1 —— basicInfo l —— —— 维修基础信息 ——
2 1.1.1 basicInfo platenumber l 字符串 V8 车牌号码 ——
3 1.1.2 basicInfo companyname l 字符串 V100 维修企业名称 ——
4 1.1.3 basicInfo vin l 字符串 V17 车辆识别代码 ——
5 1.1.4 basicInfo repairdate l 字符串 F8 送修日期 YYYY-MM-DD
6 1.1.5 basicInfo miles l 字符串 V8 送修里程 ——
7 1.1.6 basicInfo settledate l 字符串 F8 结算日期 YYYY-MM-DD
8 1.1.7 basicInfo faultdescription l 字符串 V200 故障描述 ——
9 1.1.8 basicInfo costcode l 字符串 V50 结算清单编号 ——
10 1.2 —— stufflist * —— —— 维修配件列表 ——
11 1.2.1 stufflist code * 字符串 V50 配件编码 ——
12 1.2.2 stufflist quantity l 数字 N12,2 配件数量 ——
13 1.2.3 stufflist stuff l 字符串 v50 配件名称 ——
14 1.3 —— repairitemlist * —— —— 维修项目列表 ——
15 1.3.1 repairitemlist item l 字符串 V200 维修项目 ——
16 1.3.2 repairitemlist hours l 字符串 N12,1 维修工时 ——
3.1.3.2 erp对省级接口
3.1.3.2.1:维修企业注册
参数 中文描述 数据类型 空/非空 长度 代码表 描述
applicationid ERP企业编码 String 非空 32 本平台提供,对接前向本平台申请
companyname 维修企业名称 String 非空 100 取自维修企业名称
password 维修企业登录密码 String 非空 100 自行设置密码,用于在调用获取access_token
road_transportation_license 维修企业道路运输经营许可证号 String 非空 40 取自维修企业道路经营许可证号/机动车维修经营许可证号
licenseno 统一社会信用代码 String 非空 18 取自维修企业统一社会信用代码
address 维修企业地址 String 非空 100 取自维修企业的详细地址
zip_code 维修企业邮政编码 String 非空 6 维修企业所在地区的邮政编码;
economic_category 维修企业经济类型 String 非空 3 企业经济类型 维修企业的经济类型,内资或合资等,详情见代码表
category 维修企业经营业务类别 String 非空 2 企业经营业务类别 维修企业经营业务类别,如一(二、三)类维修经营业务,详情见代码表
link_man 维修企业联系人姓名 String 非空 维修企业联系人姓名
link_man_tel 维修企业联系人联系方式 String 非空 18 维修企业联系人联系方式
super_intendent_name 维修企业负责人姓名 String 非空 30 维修企业负责人姓名
super_intendent_tel 维修企业负责人联系方式 String 非空 18 维修企业负责人联系方式
business_scope 维修企业经营范围 String 非空 200 维修企业业务经营范围
road_transportation_license_start 道路运输经营许可证起始日期 String 非空 YYYY-MM-DD 道路运输经营许可证开始日期
road_transportation_license_end 道路运输经营许可证结束日期 String 非空 YYYYMMDD 道路运输经营许可证结束日期
operation_state 维修企业经营状态 String 非空 1 企业经营状态 维修企业现在的经营状态,如(营业、停业、整改)等,详情见代码表
areacode 维修企业注册区域编码 String 非空 6 维修企业所在地的行政区域划分(区域编码); 例如北京市东城区:11010
email 维修企业注册邮箱 String 非空 60 邮箱用于在企业注册完成之后,接收地方运管的审核结果

接口返回参数:

字段名 参数说明 数据类型 描述及要求
code 结果状态码 string 0 — 失败 1 — 成功 -99 — 异常
status 返回描述 string :维修企业名称为空 :维修企业统一社会信用代码为空 :维修企业道路运输许可证为空 :道路经营许可证开始日期格式不正确,格式例如'20150101 :道路经营许可证结束日期格式不正确,格式例如'20150101 :维修企业注册区域编码输入有误 :维修企业注册区域编码需要确认到区,例如杭州市上城区:330102 :维修企业道路经营许可证结束日期不能小于维修企业道路经营许可证开始日期 :道路运输经营许可证号长度大于20 :请输入6到16位字母、数字组成的维修企业登录密码 :注册失败,维修企业统一社会信用代码已注册 :注册失败,维修企业道路运输经营许可证号已注册,目前处于待审核状态 :注册失败,维修企业道路运输经营许可证号已注册 :ERP企业编码为空 :ERP企业编码异常 :系统运行异常
companycode 维修企业编码 string 维修企业编码

接口URL:

http://git.96515.cc:11000/archive/register

接口参数示例:

                {
                    "applicationid": "vvcc8ss86a31fa0e4ffc9e3ce7df0af2",
                    "companyname":"测试维修企业",
                    "password":"123456789",
                    "licenseno":"wx13565243355",
                    "road_transportation_license":"322669514283X",
                    "address":"前进街办事处江汉路206号",
                    "zip_code":"310006",
                    "economic_category":"100",
                    "category":"1",
                    "link_man":"王大柱",
                    "link_man_tel":"13857225229",
                    "super_intendent_name":"李安",
                    "super_intendent_tel":"13887266396",
                    "business_scope":"周边区域",
                    "road_transportation_license_start":"2016-05-20",
                    "road_transportation_license_end":"2018-09-20",
                    "operation_state":"1",
                    "areacode":"330101",
                    "email":"123456767@qq.com"
                }
            

接口返回示例:

            {
                "status":"注册成功!请上传营业执照图片",
                "code":"1",
                "companycode":"330105000235911"
            }
            
3.1.3.2.2 :获取接口调用凭证
参数 中文描述 数据类型 空/非空 长度 描述
companycode 维修企业编码 String 非空 100 取自调用维修企业注册接口后返回15位的维修企业编码
password 维修企业登入密码 String 非空 100 取自调用维修企业注册接口时自行填写的维修企业密码
applicationid ERP供应商企业的编码 String 非空 100 ERP企业向四川省平台备案注册时获取的applicationid
接口返回参数:
字段名 参数说明 数据类型 描述及要求
code 结果状态码 string 0 — 失败 1 — 成功 -99 — 异常
status 返回描述 string :维修企业编码为空 :维修企业编码输入有误 :获取失败 :获取成功
access_token 接口调用凭证 string 接口调用凭证

接口URL:

http://git.96515.cc:11000/archive/login

接口参数示例:

            {
                "companycode":"330105000235911" ,
                "password":"123456789",
                "applicationid": "vvcc8ss86a31fa0e4ffc9e3ce7df0af2"
            }
        

接口返回示例:

            {
                "code":"1",
                "status":"登陆成功。",
                "access_token":"3303ce5b02bdb08447f086fcdc5920f9"
            }
            
3.1.3.2.3 :上传营运证图片(该接口已弃用,请直接参照3.1.3.2.4新增维修记录。)
参数 中文描述 数据类型 空/非空 长度 描述
access_token 接口调用凭证 String 非空 32 取自调用获取access_token方法返回32位access_token
file 图片文件 file 非空 100 请使用httppost方式将文件附加上传。

接口返回参数:

字段名 参数说明 数据类型 描述及要求
code 结果状态码 string 0 — 失败 1 — 成功 -99 — 异常
status 返回描述 string :接口调用凭证无效 :请上传文件 :文件不能大于2M :请勿重复上传营业执照。 :上传成功
access_token 接口调用凭证 string 接口调用凭证

接口URL

http://git.96515.cc:11000/archive/upload

3.1.3.2.4 :新增维修记录
参数 中文描述 数据类型 空/非空 长度 代码表 描述
access_token 接口调用凭证 String 非空 32 取自调用获取access_token方法返回32位access_token
basicInfo 维修基础信息 Json对象 非空 { "platenumber":"车牌号码", "platetype":"车牌颜色代码", "vin":"车辆识别代码", "repairdate":"送修日期,格式: 2010-08-08 ", " miles ":"送修里程", "settledate":"结算日期 ,格式: 2010-08-08","faultdescription":"故障描述", "costcode":"结算清单编号" }
stufflist 维修配件列表 Json数组 [ { "stuff":"配件名称", "code":"配件编码", "quantity":"配件数量" }, { "stuff":"配件名称", "code":"配件编码", "quantity":"配件数量" } ]
repairitemlist 维修项目列表 Json数组 [ { "item":"维修项目", "hours":"维修工时" }, { "item":"维修项目", "hours":"维修工时" } ]

接口返回参数:

字段名 参数说明 数据类型 描述及要求
code 结果状态码 string 0 — 失败 1 — 成功 -99 — 异常
status 返回描述 string :车辆维修基础信息为空 :接口调用凭证为空 :接口调用凭证输入有误 :送修日期格式不正确,格式例如'2015-01-01 :接口调用凭证无效 :获取接口调用凭证信息失败 :获取维修企业信息失败 :结算日期不能小于送修日期 :尚未上传营业执照照片。 :新增成功 :系统运行异常

接口URL:

http://git.96515.cc:11000/archive/save

接口参数示例:

            {
                "access_token": "330385586a31fa0e4ffc9e3ce7df0af2",
                "basicInfo": {
                    "platenumber": "川A11231",
                    "platetype": 0,
                    "vin": "3de69a7dc137",
                    "repairdate": "2016-01-01",
                    "miles": "7",
                    "settledate": "2017-01-01",
                    "faultdescription": "后车车灯损坏",
                    "costcode": "S55622"
                },
                "stufflist": [{"code":"233","quantity":"2","stuff":"大灯"}],
                "repairitemlist": [{"item":"测试","hours":"20.5"}]
            }
            

接口返回示例:

                {
                "code":"1",
                "status":"新增成功"
                }
            

3.1.3.3 代码表

3.1.3.3.1 燃料类型
中文描述 燃料类型
代码值 中文描述
0 汽油
1 柴油
2 CNG
3 双燃料
4 电动
5 液化气
6 LNG
7 LPG
8 其他
9 混合动力
3.1.3.3.2 企业经营业务类别
中文描述 企业经营业务类别
代码值 中文描述
1 一类维修经营业务
2 二类维修经营业务
3 三类维修经营业务
3.1.3.3.3 企业经营状态
中文描述 企业经营状态
代码值 中文描述
1 营业
2 停业
3 整改
4 停业整顿
5 歇业
6 注销
9 其他
3.1.3.3.4 企业经济类型
中文描述 企业经济类型
代码值 中文描述
100 内资
110 国有全资
120 集体全资
130 股份合作
140 联营
141 国有联营
142 集体联营
143 国有与集体联营
149 其他联营
150 有限责任(公司)
159 其他有限责任(公司)
160 股份有限(公司)
170 私有
171 私有独资
172 私有合伙
173 私营有限责任(公司)
174 私营股份有限(公司)
175 个体经营
179 其他私有
190 其他内资
200 港、澳、台投资
210 内地和港、澳或台合资
220 内地和港、澳或台合作
230 港、澳或台独资
240 港、澳或台投资股份有限(公司)
290 其他港澳台投资
300 国外投资
310 中外合资
320 中外合作
330 外资
340 国外投资股份有限(公司)
390 其他国外投资
900 其他
3.1.3.3.5 车牌颜色代码
中文描述 车牌颜色代码
代码值 中文描述
0 黄牌照
1 蓝牌照
2 农用牌照
3 黑牌照
4 白牌照
5 绿牌照
6 黄绿牌照
3.1.3.4 流程图

1:维修企业注册;

2:获取接口调用凭证(调用凭证有效期为2小时,如已获取并在有效期内可以直接执行第3步);

3:上传营运证件图片,完成注册流程。

4:新增维修记录

3.1.3.5 关于测试

由本平台提供测试ApplicationID,用于ERP开发接口,调用测试接口完成测试后再切换为正式接口即可。

第四章 联系方式

邮箱:cedk@qq.com

电话:18980050506(钟)

沟通交流群: 694596478