机动车检验监管系统接口使用手册Word下载.docx
《机动车检验监管系统接口使用手册Word下载.docx》由会员分享,可在线阅读,更多相关《机动车检验监管系统接口使用手册Word下载.docx(201页珍藏版)》请在冰点文库上搜索。
![机动车检验监管系统接口使用手册Word下载.docx](https://file1.bingdoc.com/fileroot1/2023-5/3/5dae1b81-abd8-4967-8edd-f2066557836a/5dae1b81-abd8-4967-8edd-f2066557836a1.gif)
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:
写入类接口调用参数说明
同上
WriteXmlDoc
写入数据
业务数据写入XML格式文档
1.3.XML文件格式定义
1.3.1.查询类接口XML文档
查询条件QueryXmlDoc的文档格式要求如下:
<
?
xmlversion="
1.0"
encoding="
GBK"
>
root>
<
QueryCondition>
--节点标签
hphm>
苏BAA123<
/hphm>
hpzl>
02<
/hpzl>
clsbdh>
1234<
/clsbdh>
--车辆识别代号后四位
jyjgbh>
3200000001<
/jyjgbh>
/QueryCondition>
/root>
查询返回结果ResultXML文档格式
head>
code>
1<
/code>
message>
数据下载成功!
/message>
rownum>
/rownum>
/head>
body>
vehisparaid="
0"
BAA123<
……
zt>
A<
/zt>
/vehispara>
/body>
1.3.2.写入类接口XML文档
写入数据WriteXmlDoc文档格式如下:
vehispara>
jylsh>
/jylsh>
--写入数据字段
jcxdh>
/jcxdh>
……
clsslb>
/clsslb>
写入操作返回结果Xml文档格式如下:
数据保存成功<
1.4.调用注意事项
1.4.1.XML文档的中文处理
(1)接口查询结果进行过URLDecoder和UTF-8编码处理,须进行转换(转换函数为URLDecoder.decode(str,"
utf-8"
);
)才能正常读取;
(2)写入信息中文字符必须URLEncoder成utf-8格式(转换函数为URLEncoder.encode(xmlDoc,"
);
)后再封装成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】互联网检验预约信息下载
检验业务信息系统、视频监管系统、检验智能终端系统
检验过程数据接口流程
1、上传检验信息基本流程
注:
修订后的GB21861未正式实施前,人工检验项目检验结果18C80和18C53都要上传,正式实施后,只上传18C80。
2、审核未通过,需补充材料的,通过以下接口重新上传。
3、复检
具有以下情形之一的,首先进行复检登录,然后再进行后续操作(同1,但外观检验不复检的,可跳过外观检验项目)。
1)当机动车检验过程结束,存在不合格项目需要复检的。
2)当审核(外观检验)未通过需要复检的。
2.2.检验备案信息读取接口定义
2.3.1.18C01-检验机构备案信息下载
接口类型:
查询类接口
接口标识:
18C01
功能说明:
根据检验机构编号、更新日期等信息下载检验机构备案信息。
处理过程:
①对接口输入参数进行逻辑校验;
②查询相应
检验机构备案信息。
查询文档QueryXmlDoc说明:
节点标签QueryCondition,查询条件数据字段如下表:
参数项
名称
类型
长度
是否可空
备注
jczbh
检验机构编号
varchar2
10
不可空
gxrq
更新日期
date
可空
返回结果文档ResultXML说明:
节点标签vehispara,查询结果数据字段如下表:
检验机构备案信息
20
jczmc
检验机构名称
128
sflw
是否与公安网联网
char
1-是,2-否
rdsbh
资格许可证书编号
32
5
rdyxqs
资格许可有效期始
6
rdyxqz
资格许可有效期止
7
shejirjcnl
设计日检测能力(汽车辆)
number
8
shijirjcnl
实际日检测能力(汽车辆)
9
jcryzs
检测人员总数
wjgwrs
外检工位人数
11
lrgwrs
录入工位人数
12
ycyrs
引车员人数
13
dpgwrs
底盘工位人数
14
zjgwrs
总检工位人数
15
qtgwrs
其他工位人数
16
tgszjbmkhrs
通过省级质检部门考核人数
17
wtgszjbmkhrs
未通过省级质检部门考核人数
18
fzjg
发证机关
19
glbm
管理部门
21
bz
4000
22
shejirjcmtsl
设计日检测能力(摩托辆)
23
shijirjcmtsl
实际日检测能力(摩托辆)
24
shbj
审核标记
0-待审核,1-同意,2-不同意
25
syglbm
使用管理部门
26
shyj
审核意见
27
zt
状态标记
0-撤销,1-正常,2-停用,3-首次备案申请,4-过有效期
28
ztyy
暂停原因
512
29
dwdz
单位地址
300
30
yzbm
邮政编码
31
xkjyfw
许可检验范围
100
00-大型车,01-小型车
,02-许可路试超检验能力的车,03-上门检验
rdsffdw
资格许可发放单位
33
frdb
法人代表
34
frdbsfzh
法人代表身份证号
35
frdblxdh
法人代表联系电话
36
fzr
负责人
37
fzrsfzh
负责人身份证号
38
fzrlxdh
负责人联系电话
39
rclxr
日常联系人
40
rclxrsfzh
日常联系人身份证号
41
rclxrlxdh
日常联系人联系电话
2.3.2.18C02-检测线备案信息下载
18C02
根据检验机构编号、更新日期等信息下载检测线备案信息。
②查询相应检测线备案信息。
检测线备案信息
jcxxh
检测线代号
jcxmc
检测线名称
jcxlb
检测线类别
1-汽车,2-摩托车
jcxczfs
检测线控制方式
1-全自动,2-单工位检测,9-其他
zdsbmc
制动检测设备名称
zdsbxh
制动检测设备型号
zdsbsccj
制动检测设备生产厂家
zdjcsj
制动检测最少时间
zdjcfs
制动检测方式
1-平板,2-滚筒
pbzs
平板制式
1-二板式,2-四板式
dpbcd
单平板长度
pbjj
平板间距
gtszdtzs
滚筒式制动台制式
1-开槽式,2-粘砂式
gtszdttjfs
滚筒式制动台停机方式
1-第三滚筒,2-时间停机,3-其它(如可以通过监测制动力,当制动力达到最大停电机)
zdsbqysj
制动检测设备启用时间
zdsbjdyxqz
制动检测设备检定有效期止
zdsbzt
制动检测设备状态
1-正常,2-故障维修,3-报废
dgsbmc
灯光检测设备名称
dgsbxh
灯光检测设备型号
dgsbsccj
灯光检测设备生产厂家
dgjcsj
灯光检测最少时间
dgjcfs
灯光检测方式
1-双灯同检,2-单灯检测
dgcspyxz
灯光检测是否有车身偏移修正功能
1-有,2-无
dgsbqysj
灯光检测设备启用时间
dgsbjdyxqz
灯光检测设备检定有效期止
dgsbzt
灯光检测设备状态
sdsbmc
速度检测设备名称
sdsbxh
速度检测设备型号
sdsbsccj
速度检测设备生产厂家
sdjcsj
速度检测最少时间
sdsbqysj
速度检测设备启用时间
sdsbjdyxqz
速度检测设备检定有效期止
sdsbzt
速度检测设备状态
chsbmc
侧滑检测设备名称
chsbxh
侧滑检测设备型号
chsbsccj
侧滑检测设备生产厂家
chjcsj
侧滑检测最少时间
chsbqysj
侧滑检测设备启用时间
chsbjdyxqz
侧滑检测设备检定有效期止
42
chsbzt
侧滑检测设备状态
43
czsbmc
称重设备名称
44
czsbxh
称重检测设备型号
45
czsbsccj
称重检测设备生产厂家
46
czjcsj
称重检测最少时间
47
czjb
称重范围
设备设计最大承受车辆轴重范围,单位为千克(kg)
48
czsbjdyxqz
称重检测设备检定有效期止
49
czsbqysj
称重检测设备启用时间
50
czsbzt
称重检测设备状态
51
qxjcsj
全线检测时间
52
gw1
工位1
53
gw2
工位2