安徽省机动车检验监管平台接口文档.docx
《安徽省机动车检验监管平台接口文档.docx》由会员分享，可在线阅读，更多相关《安徽省机动车检验监管平台接口文档.docx（182页珍藏版）》请在冰豆网上搜索。
安徽省机动车检验监管平台接口文档
安徽省机动车检验监管平台
接口使用手册
安徽科力信息产业有限责任公司
2014年10月8日
目录
第一部分接口调用规范5
1、接口访问地址5
2、检验流程6
2.1检验基本流程6
3、接口调用说明6
3.1查询XML格式定义6
3.2写入类接口XML文档格式7
3.3调用注意事项8
3.4返回结果错误代码说明8
第二部分对外接口说明9
1、时间同步接口9
1.1接口方法名9
1.2接口功能说明9
1.3查询参数说明9
1.4返回结果XML文档说明9
2、车辆信息查询接口10
2.1接口方法名10
2.2接口功能说明10
2.3查询参数说明10
2.4返回结果XML文档说明10
3、机动车检验登录12
3.1接口方法名12
3.2接口功能说明13
3.3写入参数说明13
3.4返回结果XML文档说明17
4、机动车复检登录17
4.1接口方法名17
4.2接口功能说明17
4.3写入参数说明17
4.4返回结果XML文档说明18
5、请求检测过程开始19
5.1接口方法名19
5.2接口功能说明19
5.3写入参数说明19
5.4返回结果XML文档说明20
6、请求检验项目开始20
6.1接口方法名20
6.2接口功能说明20
6.3写入参数说明20
6.4返回结果XML文档说明21
7、写检验结果详细数据22
7.1接口方法名22
7.2接口功能说明22
7.3写入参数说明22
7.4返回结果XML文档说明40
8、请求检验项目结束40
8.1接口方法名40
8.2接口功能说明40
8.3写入参数说明41
8.4返回结果XML文档说明41
9、写检验结果其它信息（整车制动等）42
9.1接口方法名42
9.2接口功能说明42
9.3写入参数说明42
9.4返回结果XML文档说明43
10、请求检验过程结束43
10.1接口方法名43
10.2接口功能说明44
10.3写入参数说明44
10.4返回结果XML文档说明44
11、写检验结论45
11.1接口方法名45
11.2接口功能说明45
11.3写入参数说明45
11.4返回结果XML文档说明47
12、机动车检验登录信息修正47
12.1接口方法名47
12.2接口功能说明48
12.3写入参数说明48
13、检测线备案信息下载51
13.1接口方法名51
13.2接口功能说明51
13.3查询参数说明51
14、安检机构工作人员备案信息下载58
14.1接口方法名58
14.2接口功能说明58
14.3查询参数说明58
15、查询车辆所属类别对应检验项目信息59
15.1接口方法名59
15.2接口功能说明59
15.3查询参数说明60
16、请求抓拍照片61
16.1接口方法名61
16.2接口功能说明61
16.3请求参数说明61
16.4返回结果XML文档说明62
17、查询车辆外观检验结果62
17.1接口方法名62
17.2接口功能说明62
17.3请求参数说明62
17.4返回结果XML文档说明63
18、写车辆底盘动态、底盘查验结果（GB21861-2008）66
18.1接口方法名66
18.2接口功能说明66
18.3请求参数说明66
17.4返回结果XML文档说明70
第三部分相关代码表70
1、车辆外观检验结果项目70
2、号牌种类代码表77
3、车身颜色代码表77
4、使用性质代码表78
5、车辆状态代码表78
6、车辆类型代码表79
7、燃料种类代码表82
8、国产/进口代码表83
9、身份证名称代码表83
10、制造国代码表84
第一部分接口调用规范
1、接口访问地址
安徽省检验监管系统对外访问接口地址：
http:
//ip:
port/vehcheckweb/services/OutService?
wsdl
其中IP标识Web服务器地址；port对应系统应用服务的端口号，启用80的不填写
2、检验流程
2.1检验基本流程
3、接口调用说明
3.1查询XML格式定义
查询车辆信息返回结果XML文档格式：
xmlversion="1.0"encoding="GBK"?
>
1
数据下载成功！
BAA123
02
……
A
3.2写入类接口XML文档格式
写入数据文档格式如下：
xmlversion="1.0"encoding="GBK"?
>
--节点标签
--写入数据字段
……
写入操作返回XML格式如下：
xmlversion="1.0"encoding="GBK"?
>
0
数据保存成功
3.3调用注意事项
（1）接口查询结果进行过URLEncoder和UTF-8编码处理，须进行转换（转换函数为URLDecoder.decode（str,”utf-8”）;）才能正常读取中文。
（2）写入信息中文字符必须用URLEncoder变成utf-8编码格式，转换函数为URLEncoder.encode（xmldoc,”utf-8”）;
（3）XML文档的【写入数据节点】和【返回节点】的标签均为小写字符。
XML文档【节点标签】必须和手册中注明的保持一致。
（4）注：
修订后的GB21861未正式实施前，人工检验项目检验结果机动车人工检验项目检验结果详细信息（按GB21861-XXXX）和机动车人工检验项目检验结果详细信息（按GB21861-2008）都要上传，正式实施后，只上传机动车人工检验项目检验结果详细信息（按GB21861-XXXX）。
3.4返回结果错误代码说明
调用成功与否标记code（0-调用成功；1-调用失败）。
失败时message返回详细描述信息。
第二部分对外接口说明
1、时间同步接口
1.1接口方法名
publicStringgetSynchTime（Stringjkxlh）
1.2接口功能说明
检验业务信息系统与检验监管系统时间同步时使用。
建议每天同步1-2次。
1.3查询参数说明
查询条件数据字段如下表。
序号
字段名
字段描述
类型
长度
是否可空
备注
1
jkxlh
接口序列号
字符
由接口提供者提供
1.4返回结果XML文档说明
序号
字段名
字段描述
类型
备注
1
code
调用成功与否标记
字符
0-成功；1-失败
2
message
消息
字符
成功时,返回日期，
如2014-08-1913:
28:
45.678；
失败时，返回错误信息。
2、车辆信息查询接口
2.1接口方法名
publicStringqueryVehicleOut（Stringjkxlh,Stringhpzl,Stringhphm,Stringclsbdh）
2.2接口功能说明
车辆检验上线前，查询车辆基本信息。
2.3查询参数说明
查询条件数据字段如下表。
序号
字段名
字段描述
类型
是否可空
备注
1
jkxlh
接口序列号
字符
不可空
由接口提供者提供
2
hpzl
号牌种类
字符
不可空
号牌种类代码
3
hphm
号牌号码
字符
不可空
填写格式如：
“皖AWS345”填写“皖BWS345”、“皖A1234挂”填写“皖A1234”、“皖A1234学”填写“皖A1234”
4
clsbdh
车辆识别代号
字符
不可空
可填写后四位
2.4返回结果XML文档说明
序号
参数项
名称
类型
长度
是否可空
备注
1
xh
机动车序号
char
14
2
hpzl
号牌种类
char
2
号牌种类代码
3
hphm
号牌号码
varchar2
15
4
clpp1
中文品牌
varchar2
32
5
clxh
车辆型号
varchar2
32
6
clpp2
英文品牌
varchar2
32
7
gcjk
国产/进口
char
1
国产/进口代码
8
zzg
制造国
char
3
制造国代码
9
zzcmc
制造厂名称
varchar2
64
10
clsbdh
车辆识别代号
varchar2
25
11
fdjh
发动机号
varchar2
30
12
cllx
车辆类型
char
3
车辆类型代码
13
csys
车身颜色
varchar2
5
车身颜色代码
14
syxz
使用性质
char
1
使用性质代码
15
sfzmhm
身份证明号码
varchar2
18
身份证明名称代码
16
sfzmmc
身份证明名称
char
1
17
syr
机动车所有人
varchar2
128
18
ccdjrq
初次登记日期
date
7
19
djrq
最近定检日期
date
7
20
yxqz
检验有效期止
date
7
21
qzbfqz
强制报废期止
date
7
22
fzjg
发证机关
varchar2
10
23
glbm
管理部门
varchar2
12
24
bxzzrq
保险终止日期
date
7
25
zt
机动车状态
varchar2
6
26
dybj
抵押标记0-未抵押，1-已抵押
char
1
27
fdjxh
发动机型号
varchar2
64
28
rlzl
燃料种类
varchar2
3
燃料种类代码
29
pl
排量
number
6
30
gl
功率
number
5,1
31
zxxs
转向形式
char
1
0-无，1-方向盘，2-方向把
32
cwkc
车外廓长
number
5
33
cwkk
车外廓宽
number
4
34
cwkg
车外廓高
number
4
35
hxnbcd
货箱内部长度
number
5
36
hxnbkd
货箱内部宽度
number
4
37
hxnbgd
货箱内部高度
number
4
38
gbthps
钢板弹簧片数
number
3
39
zs
轴数
number
1
40
zj
轴距
number
5
41
qlj
前轮距
number
4
42
hlj
后轮距
number
4
43
ltgg
轮胎规格
varchar2
64
44
lts
轮胎数
number
2
45
zzl
总质量
number
8
46
zbzl
整备质量
number
8
47
hdzzl
核定载质量
number
8
48
hdzk
核定载客
number
3
49
zqyzl
准牵引总质量
number
8
50
qpzk
驾驶室前排载客人数
number
1
51
hpzk
驾驶室后排载客人数
number
2
52
hbdbqk
环保达标情况
varchar2
128
53
ccrq
出厂日期
date
7
54
clyt
车辆用途
char
2
55
ytsx
用途属性
char
1
56
xszbh
行驶证证芯编号
varchar2
20
57
jyhgbzbh
检验合格标志
varchar2
20
3、机动车检验登录
3.1接口方法名
publicStringregisterVehicleOut（Stringjkxlh,StringvehXmlDoc）
3.2接口功能说明
车辆上线前，登录检测车辆信息。
3.3写入参数说明
写入数据字段如下表。
序号
字段名
字段描述
类型
是否可空
备注
1
jkxlh
接口序列号
字符
不可空
由接口提供者提供
2
vehXmlDoc
请求信息
XML格式字符串
不可空
vehXmlDoc格式内含字段如下表：
序号
参数项
名称
类型
长度
是否可空
备注
1
jylsh
检验流水号
varchar2
17
不可空
对同一安检机构，此检验流水号必须唯一，下同
2
jcxdh
检测线代号
varchar2
2
可空
按检测线备案信息，下同，如：
1、2、3、4、5、6、7、8、9、10,…
3
xh
机动车序号
varchar2
14
可空
4
hpzl
号牌种类
varchar2
2
可空
按GA/T16.7。
在用车不可空。
5
hphm
号牌号码
varchar2
15
可空
在用车不可空。
填写格式如：
“苏BAA345”填写“苏BAA345”、“苏B1234挂”填写“苏B1234”，下同。
6
clsbdh
车辆识别代号
varchar2
25
不可空
填写完整的VIN号或车架号。
7
fdjh
发动机/电动机号码
varchar2
30
可空
8
csys
车身颜色
varchar2
5
可空
按GA/T16.8
9
syxz
使用性质
char
1
可空
按GA/T16.3
10
ccdjrq
初次登记日期
date
可空
按“yyyy-mm-dd”格式填写
11
jyrq
最近定检日期
date
可空
按“yyyy-mm-dd”格式填写
12
jyyxqz
检验有效期止
date
可空
按“yyyy-mm-dd”格式填写
13
bxzzrq
保险终止日期
date
可空
按“yyyy-mm-dd”格式填写
14
rlzl
燃料种类
varchar2
3
可空
可同时输入三种，每种按GA/T16.9
15
gl
功率
number
5,1
可空
单位为千瓦（kw），四位整数，一位小数
16
zs
轴数
number
1
不可空
17
zj
轴距
number
5
可空
单位为毫米（mm）
18
qlj
前轮距
number
4
可空
单位为毫米（mm）
19
hlj
后轮距
number
4
可空
单位为毫米（mm）
20
zzl
总质量
number
8
不可空
单位为千克（kg）
21
zbzl
整备质量
number
8
不可空
单位为千克（kg）
22
ccrq
出厂日期
date
不可空
按“yyyy-mm-dd”格式填写
23
qdxs
驱动形式（驱动轴位）
varchar2
5
不可空
组合串:
如1234（1表示一轴..）
24
zczs
驻车轴数
number
1
可空
摩托车无此参数
25
zczw
驻车轴位
varchar2
5
可空
组合串:
如1234（1表示一轴..）
26
zzs
主轴数
number
1
可空
27
zzly
制动力源
char
1
可空
0-气压制动，1-液压制动，2-气推油制动
28
qzdz
前照灯制
varchar2
2
可空
01-四灯远近光，02-四灯远光，03-二灯远近光，04-二灯近光，05-一灯远光
29
ygddtz
远光单独调整
char
1
可空
0-不能单独调整，1-单独调整
30
zxzxjxs
转向轴（前轴）悬架形式
char
1
可空
0-独立悬架，1-非独立悬架
31
lcbds
里程表读数
number
8
可空
单位为千米（km）
32
jyxm
检验项目
varchar2
100
不可空
多值，英文半角逗号分隔。
各项目代码为：
F1-车辆外观检验
C1-底盘检验
DC-动态底盘检验
B1-一轴制动
B2-二轴制动
B3-三轴制动
B4-四轴制动
B5-五轴制动
B6-六轴制动
B0-驻车制动
H1-左外灯或二三轮机动车的左灯
H2-左内灯
H3-右内灯
H4-右外灯或二三轮机动车的右灯
S1-车速表
A1-侧滑
R1-路试制动
R2-路试坡道驻车
R3-路试车速表
M1-外廓尺寸自动测量
33
jylb
检验类别
varchar2
2
不可空
00-注册登记检验，01-在用车检验（定检），02-临时检验，03-特殊检验，04-在用车检验（非定检）
34
bhgx
不合格项
varchar2
50
可空
35
ccdlsj
初次登录时间
date
可空
按“yyyy-mm-ddhh24:
mi:
ss”格式填写
36
dlsj
登录时间
date
不可空
按“yyyy-mm-ddhh24:
mi:
ss”格式填写
37
jycs
检验次数
number
2
不可空
38
dly
登录员
varchar2
30
不可空
39
ycy
引车员
varchar2
30
可空
40
wjy
外检员
varchar2
30
可空
41
dtjyy
动态检验员
varchar2
30
可空
42
dpjyy
底盘检验员
varchar2
30
可空
43
clpp1
车辆品牌
varchar2
32
不可空
44
clxh
车辆型号
varchar2
32
不可空
45
syr
机动车所有人
varchar2
128
可空
46
cllx
车辆类型
varchar2
3
可空
在用车不可空
47
cwkc
车外廓长
number
5
不可空
48
cwkk
车外廓宽
number
4
不可空
49
cwkg
车外廓高
number
4
不可空
50
clyt
车辆用途
char
2
51
ytsx
用途属性
char
1
52
dlysfzh
登录员（身份证号）
varchar2
30
不可空
53
ycysfzh
引车员（身份证号）
varchar2
30
可空
54
wjysfzh
外检员（身份证号）
varchar2
30
可空
55
dtjyysfzh
动态检验员（身份证号）
varchar2
30
可空
56
dpjyysfzh
底盘检验员（身份证号）
varchar2
30
可空
57
clsslb
车辆所属类别
varchar2
2
不可空
01-常规汽车
02-全时四驱
03-超重
04-超宽
05-驱动防滑
06-双后轴驱动
07-挂车
08-灯位超高
09-多轴车
10-其他特种车
11-常规（摩托车）
58
jcxlb
检测线类别
char
1
不可空
1-汽车，2-摩托车
59
sjr
送检人（姓名）
varchar2
30
可空
60
sjrsfzh
送检人身份证号
varchar2
30
可空
3.4返回结果XML文档说明
序号
字段名
字段描述
类型
备注
1
code
调用成功与否标记
字符
0-成功；1-失败
2
message
消息
字符
失败时，返回错误信息。
3
pdyj
判定依据
1-旧标准，2-新标准
4、机动车复检登录
4.1接口方法名
publicStringrecheckRegisterVehicleOut（Stringjkxlh,StringvehXmlDoc）
4.2接口功能说明
车辆复检上线前，登录复检检测车辆信息。
4.3写入参数说明
写入数据字段如下表。
序号
字段名
字段描述
类型
是否可空
备注
1
jkxlh
接口序列号
字符
不可空
由接口提供者提供
2
vehXmlDoc
登记车辆信息
XML格式字符串
不可空
vehXmlDoc内含字段如下表：
序号
参数项
名称
类型
长度
是否可空
备注
1
jylsh
检验流水号
varchar2
17
不可空
2
jcxdh
检测线代号
varchar2
2
可空
如：
1、2、3、4、5、6、7、8、9、10,…
3
xh
机动车序号
varchar2
14
可空
4
hpzl
号牌种类
varchar2
2
可空
在用车不可空
5
hphm
号牌号码
varchar2
15
可空
在用车不可空
6
clsbdh
车辆识别代号
varchar2
25
不可空
填写完整的VIN号或车架号。
7
fdjh
发动机/电动机号码
varchar2
升级会员 