机动车检验监管系统接口使用手册范本.docx
《机动车检验监管系统接口使用手册范本.docx》由会员分享,可在线阅读,更多相关《机动车检验监管系统接口使用手册范本.docx(190页珍藏版)》请在冰豆网上搜索。
机动车检验监管系统接口使用手册范本
机动车检验监管系统
接口使用手册
公安部交通管理科学研究所
2014年10月
第一部分接口调用规X
1.1.接口访问地址
检验监管系统对外接口访问地址:
ip:
port/pnweb/services/TmriOutAccess?
wsdl
其中IP标识Web服务器地址;port对应系统应用服务的端口号,启用80的不填写。
1.2.接口调用函数
检验监管系统对外接口包括两类:
查询类和写入类接口。
查询类接口对外提供查询服务,写入类接口对外提供将业务数据写入检验监管系统业务库。
1.2.1.查询类接口
publicStringqueryObjectOut(Stringxtlb,Stringjkxlh,Stringjkid,StringQueryXmlDoc)
表1:
查询类接口调用参数说明
序号
参数名称
参数说明
备注信息
1
xtlb
系统类别
接口提供者的业务类别代码,默认为“18”(代表机动车检验监管系统)
2
jkxlh
接口序列号
由外挂系统请求服务平台授权生成下发
3
jkid
接口标识
5位,由系统类别+C+两位接口顺序号组成,用于唯一表示一个接口。
4
QueryXmlDoc
查询条件
封装查询条件的XML格式文档
1.2.2.写入类接口
PublicStringwriteObjectOut(Stringxtlb,Stringjkxlh,Stringjkid,StringWriteXmlDoc)
表2:
写入类接口调用参数说明
序号
参数名称
参数说明
备注信息
1
xtlb
系统类别
同上
2
jkxlh
接口序列号
同上
3
jkid
接口标识
同上
4
WriteXmlDoc
写入数据
业务数据写入XML格式文档
1.3.XML文件格式定义
1.3.1.查询类接口XML文档
查询条件QueryXmlDoc的文档格式要求如下:
xmlversion="1.0"encoding="GBK"?
>
--节点标签
苏BAA123
02
1234--车辆识别代号后四位
3200000001
查询返回结果ResultXML文档格式
xmlversion="1.0"encoding="GBK"?
>
1
数据下载成功!
1
BAA123
02
……
A
1.3.2.写入类接口XML文档
写入数据WriteXmlDoc文档格式如下:
xmlversion="1.0"encoding="GBK"?
>
--节点标签
--写入数据字段
……
写入操作返回结果Xml文档格式如下:
xmlversion="1.0"encoding="GBK"?
>
1
数据保存成功
……
1.4.调用注意事项
1.4.1.XML文档的中文处理
(1)接口查询结果进行过URLDecoder和UTF-8编码处理,须进行转换(转换函数为URLDecoder.decode(str,"utf-8");)才能正常读取;
(2)写入信息中文字符必须URLEncoder成utf-8格式(转换函数为URLEncoder.encode(xmlDoc,"utf-8");)后再封装成XML文档。
(3)XML文档的【写入数据字段】和【返回结果字段】的标签均为小写字符。
XML文档【节点标签】必须和手册中注明的保持一致。
1.4.2.返回结果错误代码说明
正常返回结果code为成功与否标记(小于等于0-失败;1-成功,由提供的接口服务定义),网络异常或接口权限异常等系统原因时返回$E的标记。
写入失败时的message返回详细描述信息。
第二部分对外接口说明
2.1.接口列表
检验监管系统提供的信息接口共33个(见下表),其中写照片接口还可参考第四部分提供的方式。
序号
接口名称
接口定义
提供者
调用者
1.
检验备案信息查询接口
【1】检验机构备案信息
【2】检测线备案信息
【3】检验机构工作人员备案信息
【4】检验业务信息系统备案信息
检验监管系统
检验业务信息系统
2.
检验信息写入接口
【5】机动车检验登录信息
【6】机动车检验过程开始信息
【7】机动车检验项目开始信息
【8】机动车人工检验项目检验结果详细信息(GB21861-XXXX)
【9】机动车人工检验项目检验结果详细信息(GB21861-2008)
【10】二、三轮机动车人工检验项目检验结果详细信息(GB21861-2008)
【11】仪器设备检验项目检验结果详细信息
【12】路试检验信息
【13】机动车检验项目结束信息
【14】机动车检验过程结束信息
【15】机动车检验结果其他信息
【16】机动车交通事故责任强制保险信息
【17】机动车检验判定结果信息
【18】机动车检验照片和资料照片信息
【19】机动车检验结果资料申请审核信息
【20】机动车复检登录信息
检验监管系统
检验业务信息系统、检验智能终端系统
3.
其他查询与写入接口
【21】时间同步
【22】获取车辆所属类别对应检验项目信息
【23】获取机动车对应需拍摄照片和人工检验项目信息
【24】获取机动车检验审核不通过信息
【25】获取机动车基本信息
【26】机动车检验登录信息更正
【27】机动车检验视频异常信息
【28】检验业务信息系统操作日志
【29】写入收费信息
【30】机动车检验审核通过信息获取回执
【31】机动车检验业务退办
【32】读取车管业务流水号
【33】互联网检验预约信息下载
检验监管系统
检验业务信息系统、视频监管系统、检验智能终端系统
2.2.检验过程数据接口流程
1、上传检验信息基本流程
注:
修订后的GB21861未正式实施前,人工检验项目检验结果18C80和18C53都要上传,正式实施后,只上传18C80。
2、审核未通过,需补充材料的,通过以下接口重新上传。
3、复检
具有以下情形之一的,首先进行复检登录,然后再进行后续操作(同1,但外观检验不复检的,可跳过外观检验项目)。
1)当机动车检验过程结束,存在不合格项目需要复检的。
2)当审核(外观检验)未通过需要复检的。
2.3.检验备案信息读取接口定义
2.3.1.18C01-检验机构备案信息下载
接口类型:
查询类接口
接口标识:
18C01
功能说明:
根据检验机构编号、更新日期等信息下载检验机构备案信息。
处理过程:
①对接口输入参数进行逻辑校验;②查询相应检验机构备案信息。
查询文档QueryXmlDoc说明:
节点标签QueryCondition,查询条件数据字段如下表:
序号
参数项
名称
类型
长度
是否可空
备注
1
jczbh
检验机构编号
varchar2
10
不可空
2
gxrq
更新日期
date
可空
返回结果文档ResultXML说明:
节点标签vehispara,查询结果数据字段如下表:
表1:
检验机构备案信息
序号
参数项
名称
类型
长度
是否可空
备注
1
jczbh
检验机构编号
varchar2
20
不可空
2
jczmc
检验机构名称
varchar2
128
不可空
3
sflw
是否与公安网联网
char
1
不可空
1-是,2-否
4
rdsbh
资格许可证书编号
varchar2
32
不可空
5
rdyxqs
资格许可有效期始
date
不可空
6
rdyxqz
资格许可有效期止
date
不可空
7
shejirjl
设计日检测能力(汽车辆)
number
4
不可空
8
shijirjl
实际日检测能力(汽车辆)
number
4
不可空
9
jcryzs
检测人员总数
number
4
不可空
10
wjgwrs
外检工位人数
number
4
不可空
11
lrgwrs
录入工位人数
number
4
不可空
12
ycyrs
引车员人数
number
4
不可空
13
dpgwrs
底盘工位人数
number
4
不可空
14
zjgwrs
总检工位人数
number
4
不可空
15
qtgwrs
其他工位人数
number
4
不可空
16
tgszmkhrs
通过省级质检部门考核人数
number
4
不可空
17
wtgszmkhrs
未通过省级质检部门考核人数
number
4
不可空
18
fzjg
发证机关
varchar2
10
不可空
19
glbm
管理部门
varchar2
12
不可空
20
gxrq
更新日期
date
不可空
21
bz
备注
varchar2
4000
可空
22
shejirjcmtsl
设计日检测能力(摩托辆)
number
4
不可空
23
shijirjcmtsl
实际日检测能力(摩托辆)
number
4
不可空
24
shbj
审核标记
varchar2
2
可空
0-待审核,1-同意,2-不同意
25
syglbm
使用管理部门
varchar2
4000
可空
26
shyj
审核意见
varchar2
4000
可空
27
zt
状态标记
char
1
不可空
0-撤销,1-正常,2-停用,3-首次备案申请,4-过有效期
28
ztyy
暂停原因
varchar2
512
可空
29
dwdz
单位地址
varchar2
300
不可空
30
yzbm
邮政编码
varchar2
6
不可空
31
xkjyfw
许可检验X围
varchar2
100
不可空
00-大型车,01-小型车,02-许可路试超检验能力的车,03-上门检验
32
rdsffdw
资格许可发放单位
varchar2
300
不可空
33
frdb
法人代表
varchar2
30
不可空
34
frdbsfzh
法人代表XX号
varchar2
18
不可空
35
frdblxdh
法人代表联系
varchar2
15
不可空
36
fzr
负责人
varchar2
30
不可空
37
fzrsfzh
负责人XX号
varchar2
18
不可空
38
fzrlxdh
负责人联系
varchar2
15
不可空
39
rclxr
日常联系人
varchar2
30
不可空
40
rclxrsfzh
日常联系人XX号
varchar2
18
不可空
41
rclxrlxdh
日常联系人联系
varchar2
15
不可空
2.3.2.18C02-检测线备案信息下载
接口类型:
查询类接口
接口标识:
18C02
功能说明:
根据检验机构编号、更新日期等信息下载检测线备案信息。
处理过程:
①对接口输入参数进行逻辑校验;②查询相应检测线备案信息。
查询文档QueryXmlDoc说明:
节点标签QueryCondition,查询条件数据字段如下表:
序号
参数项
名称
类型
长度
是否可空
备注
1
jczbh
检验机构编号
varchar2
10
不可空
2
gxrq
更新日期
date
可空
返回结果文档ResultXML说明:
节点标签vehispara,查询结果数据字段如下表:
表2:
检测线备案信息
序号
参数项
名称
类型
长度
是否可空
备注
1
jczbh
检验机构编号
varchar2
20
不可空
2
jcxxh
检测线代号
varchar2
2
不可空
3
jczmc
检验机构名称
varchar2
128
不可空
4
jcxmc
检测线名称
varchar2
128
不可空
5
jcxlb
检测线类别
char
1
不可空
1-汽车,2-摩托车
6
jcxczfs
检测线控制方式
char
1
不可空
1-全自动,2-单工位检测,9-其他
7
zdsbmc
制动检测设备名称
varchar2
128
可空
8
zdsbxh
制动检测设备型号
varchar2
32
不可空
9
zdsbsccj
制动检测设备生产厂家
varchar2
128
不可空
10
zdjcsj
制动检测最少时间
number
4
不可空
11
zdjcfs
制动检测方式
char
1
可空
1-平板,2-滚筒
12
pbzs
平板制式
varchar2
32
可空
1-二板式,2-四板式
13
dpbcd
单平板长度
number
5
可空
14
pbjj
平板间距
number
5
可空
15
gtszdtzs
滚筒式制动台制式
char
1
可空
1-开槽式,2-粘砂式
16
gtszdttjfs
滚筒式制动台停机方式
char
1
可空
1-第三滚筒,2-时间停机,3-其它(如可以通过监测制动力,当制动力达到最大停电机)
17
zdsbqysj
制动检测设备启用时间
date
可空
18
zdsbjdyxqz
制动检测设备检定有效期止
date
不可空
19
zdsbzt
制动检测设备状态
char
1
不可空
1-正常,2-故障维修,3-报废
20
dgsbmc
灯光检测设备名称
varchar2
128
可空
21
dgsbxh
灯光检测设备型号
varchar2
32
可空
22
dgsbsccj
灯光检测设备生产厂家
varchar2
128
可空
23
dgjcsj
灯光检测最少时间
number
4
可空
24
dgjcfs
灯光检测方式
char
1
可空
1-双灯同检,2-单灯检测
25
dgcspyxz
灯光检测是否有车身偏移修正功能
char
1
可空
1-有,2-无
26
dgsbqysj
灯光检测设备启用时间
date
可空
27
dgsbjdyxqz
灯光检测设备检定有效期止
date
不可空
28
dgsbzt
灯光检测设备状态
char
1
不可空
1-正常,2-故障维修,3-报废
29
sdsbmc
速度检测设备名称
varchar2
128
可空
30
sdsbxh
速度检测设备型号
varchar2
32
可空
31
sdsbsccj
速度检测设备生产厂家
varchar2
128
可空
32
sdjcsj
速度检测最少时间
number
4
可空
33
sdsbqysj
速度检测设备启用时间
date
可空
34
sdsbjdyxqz
速度检测设备检定有效期止
date
不可空
35
sdsbzt
速度检测设备状态
char
1
不可空
1-正常,2-故障维修,3-报废
36
chsbmc
侧滑检测设备名称
varchar2
128
可空
37
chsbxh
侧滑检测设备型号
varchar2
32
可空
38
chsbsccj
侧滑检测设备生产厂家
varchar2
128
可空
39
chjcsj
侧滑检测最少时间
number
4
可空
40
chsbqysj
侧滑检测设备启用时间
date
可空
41
chsbjdyxqz
侧滑检测设备检定有效期止
date
不可空
42
chsbzt
侧滑检测设备状态
char
1
不可空
1-正常,2-故障维修,3-报废
43
czsbmc
称重设备名称
varchar2
128
可空
44
czsbxh
称重检测设备型号
varchar2
32
可空
45
czsbsccj
称重检测设备生产厂家
varchar2
128
可空
46
czjcsj
称重检测最少时间
number
4
可空
47
cz
称重X围
number
6
可空
设备设计最大承受车辆轴重X围,单位为千克(kg)
48
czsbjdyxqz
称重检测设备检定有效期止
date
可空
49
czsbqysj
称重检测设备启用时间
date
不可空
50
czsbzt
称重检测设备状态
char
1
不可空
1-正常,2-故障维修,3-报废
51
qxjcsj
全线检测时间
number
4
可空
52
gw1
工位1
varchar2
16
可空
53
gw2
工位2
varchar2
16
可空
54
gw3
工位3
varchar2
16
可空
55
gw4
工位4
varchar2
16
可空
56
gw5
工位5
varchar2
16
可空
57
gw6
工位6
varchar2
16
可空
58
gw7
工位7
varchar2
16
可空
59
gw8
工位8
varchar2
16
可空
60
gw9
工位9
varchar2
16
可空
61
bz
备注
varchar2
128
可空
62
fzjg
发证机关
varchar2
10
不可空
63
glbm
管理部门
varchar2
12
不可空
64
gxrq
更新日期
date
可空
65
zdsbbh
制动检验设备编号
varchar2
30
可空
66
zdsbjdzsbh
制动检验设备检定/校准证书编号
varchar2
30
可空
67
dgsbbh
灯光检验设备编号
varchar2
30
可空
68
dgsbjdzsbh
灯光检测设备检定/校准证书标号
varchar2
30
可空
69
sdsbbh
速度检验设备编号
varchar2
30
可空
70
sdsbjdzsbh
速度检验设备检定/校准证书标号
varchar2
30
可空
71
chsbbh
侧滑检验设备编号
varchar2
30
可空
72
chsbjdzsbh
侧滑检验设备检定/校准证书编号
varchar2
30
可空
73
czsbbh
称重检验设备编号
varchar2
30
可空
74
czsbjdzsbh
称重检验设备检定/校准证书编号
varchar2
30
可空
75
zt
状态标记
varchar2
1
不可空
0-撤销,1-正常,2-停用,3-首次备案申请,4-过有效期
76
ztyy
暂停原因
varchar2
512
可空
2.3.3.18C05-检验机构工作人员备案信息下载
接口类型:
查询类接口
接口标识:
18C05
功能说明:
根据XX明、XX、检验机构编号、更新时间等信息下载检验机构工作人员的基本信息。
处理过程:
①对接口输入参数进行逻辑校验;②查询相应检验机构工作人员备案信息。
查询文档QueryXmlDoc说明:
节点标签QueryCondition,查询条件数据字段如下表:
序号
参数项
名称
类型
长度
是否可空
备注
1
sfzmhm
XX明
varchar2
30
可空
2
xm
XX
varchar2
30
可空
3
jczbh
检验机构编号
varchar2
10
不可空
4
gxrq
更新时间
date
可空
返回结果文档ResultXML说明:
节点标签vehispara,查询结果数据字段如下表:
表3:
检验机构工作人员备案信息
序号
参数项
名称
类型
长度
是否可空
备注
1
sfzmhm
XX明
varchar2
18
不可空
2
xm
XX
varchar2
30
不可空
3
rylb
人员类别
varchar2
300
不可空
4
glbm
管理部门
varchar2
12
不可空
5
fzjg
发证机关
varchar2
10
不可空
6
jczbh
检验机构编号
varchar2
20
不可空
7
gxrq
更新日期
date
可空
8
bz
备注
varchar2
4000
可空
9
shbj
审核标记
varchar2
1
可空
0-待审核,1-同意,2-不同意
10
shyj
审核意见
varchar2
4000
可空
11
zt
状态标记
char
1
不可空
0-撤销,1-正常,2-停用,3-首次备案申请,4-过有效期
12
sgzbh
上岗证编号
varchar2
32