安车机动车检验监管系统接口使用手册V440设备厂家解析.docx
《安车机动车检验监管系统接口使用手册V440设备厂家解析.docx》由会员分享，可在线阅读，更多相关《安车机动车检验监管系统接口使用手册V440设备厂家解析.docx（287页珍藏版）》请在冰豆网上搜索。
安车机动车检验监管系统接口使用手册V440设备厂家解析
深圳安车机动车检验监管系统
接口使用说明书
作者：
曾宪金
完成日期：
2015年3月12日
签收人：
签收日期：
修改情况记录：
根据公安部<91机动车检验监管系统接口使用手册20150305.doc>修订
版本号
修改批准人
修改人
安装日期
签收人
目录
深圳安车机动车检验监管系统-1-
文档变更说明-6-
第一部分接口调用规范-8-
1.1.接口访问地址-8-
1.2.接口调用函数-8-
1.2.1.查询类接口-8-
1.2.2.写入类接口-9-
1.3.XML文件格式定义-9-
1.3.1.查询类接口XML文档-9-
1.3.2.写入类接口XML文档-10-
1.4.调用注意事项-11-
1.4.1.XML文档的中文处理-11-
1.4.2.返回结果错误代码说明-11-
第二部分对外接口说明-12-
2.1.接口列表-12-
2.2.检验过程数据接口流程-14-
2.3.检验备案信息读取接口定义-16-
2.3.1.18C01-安检机构备案信息下载-16-
2.3.2.18C02-检测线备案信息下载-19-
2.3.3.18C05-安检机构工作人员备案信息下载-24-
2.3.4.18C06-检验业务信息系统备案信息下载-26-
2.4.检验信息写入接口定义-27-
2.4.1.18C51-机动车检验登录信息-27-
2.4.2.18C52-机动车检验过程开始信息-34-
2.4.3.18C55-机动车检验项目开始信息-35-
2.4.4.18C80-机动车人工检验项目检验结果详细信息（按GB21861-2014）-38-
2.4.5.18C53-机动车人工检验项目检验结果详细信息（按GB21861-2008）-44-
2.4.6.18C68-二、三轮机动车人工检验项目检验结果详细信息（按GB21861-2008）-54-
2.4.7.18C81-仪器设备检验项目检验结果详细信息-61-
2.4.8.18C54-路试检验信息-88-
2.4.9.18C58-机动车检验项目结束信息-92-
2.4.10.18C59-机动车检验过程结束信息-94-
2.4.11.18C82-机动车检验结果其他信息-95-
2.4.12.18C61-机动车交通事故责任强制保险信息-98-
2.4.13.18C62-机动车检验判定结果信息-100-
2.4.14.18C63-机动车检验照片和资料照片信息-103-
2.4.15.18C64-机动车检验结果资料申请审核信息-107-
2.4.16.18C65-机动车复检登录信息-109-
2.5.其他接口定义-111-
2.5.1.18C50-时间同步-111-
2.5.2.18C46-获取车辆所属类别对应检验项目信息-112-
2.5.3.18C47-获取机动车对应需拍摄照片和人工检验项目信息-114-
2.5.4.18C48-获取机动车检验审核不通过原因-116-
2.5.5.18C49-获取机动车基本信息-118-
2.5.6.18C66-机动车检验登录信息更正-122-
2.5.7.18C67-机动车检验视频异常信息-126-
2.5.8.18C69-检验业务信息系统操作日志-128-
2.5.9.18C70-写入收费信息-130-
2.5.10.18C71-机动车检验审核通过信息获取回执-131-
2.5.11.18C72-机动车检验业务退办-133-
2.5.12.18C21-读取车管业务流水号-134-
2.5.13.18C07-互联网检验预约信息下载-135-
2.5.14.18C08-机动车公告技术参数文本信息下载-137-
2.5.15.18C09-机动车公告技术参数图片信息下载-143-
2.6.省市新增接口-144-
2.6.1.18S01-获取检验流水号-144-
2.6.2.18S02-获取机动车检验登录信息-146-
2.6.3.18S03-获取外观检测数据-152-
2.6.4.18S04-触发项目拍照-156-
2.6.5.18S06-车辆外廓尺寸测量照片上传-158-
2.6.6.18S14-机动车检验行为监管-160-
2.6.7.18S16-检测设备自检信息上传-162-
2.6.1.18S17-检测项目录像信息上传-163-
2.6.8.18S20-环保检验结果信息上传-165-
2.6.9.18S21-检测收费信息上传-168-
2.6.10.18S22-检测项目录像结束信息上传-170-
第三部分接口调用范例-171-
3.1.JAVA调用示例-172-
3.1.1.中文转码及XML文档封装代码-172-
3.1.2.查询接口示例-173-
3.1.3.写接口示例-174-
3.2.其他调用示例-175-
第四部分写照片接口说明-177-
1.1.示例代码-177-
4.1.1.java调用示例代码-177-
1.2.接口调用请求说明-178-
4.2.1.写机动车检验照片表信息-178-
第五部分附件-180-
5.1车辆用途-180-
5.2用途属性-180-
5.3车身颜色-180-
5.4使用性质-181-
5.5车辆类型-181-
文档变更说明
序号
接口
归属
备注
11
18C01-安检机构备案信息下载
部属
22
18C02-检测线备案信息下载
部属
3
18C05-安检机构工作人员备案信息下载
部属
4
18C06-检验业务信息系统备案信息下载
部属
5
18C51-机动车检验登录信息
部属
6
18C52-机动车检验过程开始信息
部属
7
18C55-机动车检验项目开始信息
部属
8
18C80机动车人工检验项目检验结果详细信息
部属
9
18C53-机动车人工检验项目检验结果详细信息（按GB21861-2008）
部属
10
18C68-二、三轮机动车人工检验项目检验结果详细信息（按GB21861-2008）
部属
11
18C81-仪器设备检验项目检验结果详细信息
部署
12
18C54-路试检验信息
部属
13
18C58-机动车检验项目结束信息
部属
14
18C59-机动车检验过程结束信息
部属
15
18C82-机动车检验结果其他信息
部属
16
18C61-机动车交通事故责任强制保险信息
部属
17
18C62-机动车检验判定结果信息
部属
18
18C63-机动车检验照片和资料照片信息
部属
19
18C64-机动车（查验）检验结果资料申请审核信息
部属
20
18C65-机动车复检登录信息
部属
21
18C50-时间同步
部属
22
18C46-获取车辆类型、使用性质对应检验项目信息
部属
23
18C47-获取机动车对应需拍摄照片和人工检验项目信息
部属
24
18C48-获取机动车检验审核不通过原因
部属
25
18C49-获取机动车基本信息
部属
26
18C66-机动车检验登录信息更正
部属
27
18C67-机动车检验视频异常信息
部属
28
18C69-检验业务信息系统操作日志
部属
29
18C70-写入收费信息
部属
30
18C71-机动车检验审核通过信息获取回执
部属
31
18C72-机动车检验业务退办
部属
32
18C21-读取车管业务流水号
部属
33
18C07-互联网检验预约信息下载
部属
34
18C08-机动车公告技术参数文本信息下载
部属
35
18C09-机动车公告技术参数图片信息下载
部属
36
18S01-获取检验流水号
市属
新增
37
18S02-获取机动车检验登录信息
市属
新增
38
18S03-获取外观检测数据
市属
新增
39
18S04-触发项目拍照
市属
新增
40
18S06-车辆外廓尺寸测量照片上传
市属
新增
41
18S14-机动车检验行为监管
市属
新增
42
18S16-检测设备自检信息上传
市属
新增
第一部分接口调用规范
1.1.接口访问地址
检验监管系统对外接口访问地址：
http:
//ip:
port/jcxws/TmriOutAccess.asmx?
wsdl其中IP标识Web服务器地址；port对应系统应用服务的端口号，启用80的不填写。
1.2.接口调用函数
检验监管系统对外接口包括两类：
查询类和写入类接口。
查询类接口对外提供查询服务，写入类接口对外提供将业务数据写入检验监管系统业务库。
1.2.1.查询类接口
publicStringqueryObjectOut（Stringxtlb,Stringjkxlh,Stringjkid,StringQueryXmlDoc）
表1：
查询类接口调用参数说明
序号
参数名称
参数说明
备注信息
1
xtlb
系统类别
接口提供者的业务类别代码，默认为“18”（代表机动车检验监管系统）
2
jkxlh
接口序列号
由外挂系统请求服务平台授权生成下发
3
jkid
接口标识
5位，由系统类别＋一位级别代码＋两位接口顺序号组成，用于唯一表示一个接口。
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.接口列表
检验监管系统提供的信息接口共30个（见下表），其中写照片接口还可参考第四部分提供的方式。
序号
接口名称
接口定义
提供者
调用者
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
升级会员 