机动车检验监管系统接口使用手册.docx
- 文档编号:28467188
- 上传时间:2023-07-14
- 格式:DOCX
- 页数:199
- 大小:205.60KB
机动车检验监管系统接口使用手册.docx
《机动车检验监管系统接口使用手册.docx》由会员分享,可在线阅读,更多相关《机动车检验监管系统接口使用手册.docx(199页珍藏版)》请在冰豆网上搜索。
机动车检验监管系统接口使用手册
机动车检验监管系统
接口使用手册
公安部交通管理科学研究所
2014年10月
目录
第一部分接口调用规范-5-
1.1.接口访问地址-5-
1.2.接口调用函数-5-
1.2.1.查询类接口-5-
1.2.2.写入类接口-5-
1.3.XML文件格式定义-6-
1.3.1.查询类接口XML文档-6-
1.3.2.写入类接口XML文档-7-
1.4.调用注意事项-8-
1.4.1.XML文档的中文处理-8-
1.4.2.返回结果错误代码说明-8-
第二部分对外接口说明-9-
2.1.接口列表-9-
2.2.检验过程数据接口流程-11-
2.3.检验备案信息读取接口定义-12-
2.3.1.18C01-检验机构备案信息下载-12-
2.3.2.18C02-检测线备案信息下载-15-
2.3.3.18C05-检验机构工作人员备案信息下载-20-
2.3.4.18C06-检验业务信息系统备案信息下载-21-
2.4.检验信息写入接口定义-23-
2.4.1.18C51-机动车检验登录信息-23-
2.4.2.18C52-机动车检验过程开始信息-29-
2.4.3.18C55-机动车检验项目开始信息-30-
2.4.4.18C80-机动车人工检验项目检验结果详细信息(按GB21861-XXXX)-32-
2.4.5.18C53-机动车人工检验项目检验结果详细信息(按GB21861-2008)-38-
2.4.6.18C68-二、三轮机动车人工检验项目检验结果详细信息(按GB21861-2008)-47-
2.4.7.18C81-仪器设备检验项目检验结果详细信息-54-
2.4.8.18C54-路试检验信息-71-
2.4.9.18C58-机动车检验项目结束信息-74-
2.4.10.18C59-机动车检验过程结束信息-76-
2.4.11.18C82-机动车检验结果其他信息-77-
2.4.12.18C61-机动车交通事故责任强制保险信息-79-
2.4.13.18C62-机动车检验判定结果信息-81-
2.4.14.18C63-机动车检验照片和资料照片信息-84-
2.4.15.18C64-机动车检验结果资料申请审核信息-88-
2.4.16.18C65-机动车复检登录信息-89-
2.5.其他接口定义-91-
2.5.1.18C50-时间同步-91-
2.5.2.18C46-获取车辆所属类别对应检验项目信息-92-
2.5.3.18C47-获取机动车对应需拍摄照片和人工检验项目信息-94-
2.5.4.18C48-获取机动车检验审核不通过原因-95-
2.5.5.18C49-获取机动车基本信息-98-
2.5.6.18C66-机动车检验登录信息更正-101-
2.5.7.18C67-机动车检验视频异常信息-105-
2.5.8.18C69-检验业务信息系统操作日志-107-
2.5.9.18C70-写入收费信息-109-
2.5.10.18C71-机动车检验审核通过信息获取回执-110-
2.5.11.18C72-机动车检验业务退办-111-
2.5.12.18C21-读取车管业务流水号-112-
2.5.13.18C07-互联网检验预约信息下载-113-
第三部分接口调用范例-116-
3.1.JAVA调用示例-116-
3.1.1.中文转码及XML文档封装代码-116-
3.1.2.查询接口示例-118-
3.1.3.写接口示例-119-
3.2.其他调用示例-120-
第四部分写照片接口说明-121-
4.1.示例代码-121-
4.1.1.java调用示例代码-121-
4.2.接口调用请求说明-122-
4.2.1.写机动车检验照片表信息-122-
第一部分接口调用规范
1.1.接口访问地址
检验监管系统对外接口访问地址:
http:
//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"?
>
查询返回结果ResultXML文档格式
xmlversion="1.0"encoding="GBK"?
>
1
……
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
shejirjcnl
设计日检测能力(汽车辆)
number
4
不可空
8
shijirjcnl
实际日检测能力(汽车辆)
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
tgszjbmkhrs
通过省级质检部门考核人数
number
4
不可空
17
wtgszjbmkhrs
未通过省级质检部门考核人数
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
许可检验范围
varchar2
100
不可空
00-大型车,01-小型车,02-许可路试超检验能力的车,03-上门检验
32
rdsffdw
资格许可发放单位
varchar2
300
不可空
33
frdb
法人代表
varchar2
30
不可空
34
frdbsfzh
法人代表身份证号
varchar2
18
不可空
35
frdblxdh
法人代表联系电话
varchar2
15
不可空
36
fzr
负责人
varchar2
30
不可空
37
fzrsfzh
负责人身份证号
varchar2
18
不可空
38
fzrlxdh
负责人联系电话
varchar2
15
不可空
39
rclxr
日常联系人
varchar2
30
不可空
40
rclxrsfzh
日常联系人身份证号
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
czjb
称重范围
number
6
可空
设备设计最大承受车辆轴重范围,单位为千克(kg)
48
czsbjdyxqz
称重检测设备检定有效期止
date
可空
49
czsbqysj
称重检测设备启用时间
date
不可空
50
czsbzt
称重检测设备状态
char
1
不可空
1-正常,2-故障维修,3-报废
51
qxjcsj
全线检测时间
number
4
可空
52
gw1
工
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 机动车 检验 监管 系统 接口 使用手册