机动车检验监管系统接口使用手册

机动车检验监管系统

接口使用手册

公安部交通管理科学研究所

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.18co2-检测线备案信息下载..............................................-15-

2.3.3.18co5-检验机构工作人员备案信息下载....................................-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-机动车检验结果其他信息...........................................-11-

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.18co7-互联网检验预约信息下载.........................................-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,String

jkid,StringQueryXmlDoc)

表L查询类接口调用参数说明

序号参数名称参数说明备注信息

xtlb系统类别接口提供者的业务类别代码，默认为“18”

1

（代表机动车检验监管系统）

2jkxlh接口序列号由外挂系统请求服务平台授权生成下发

jkid接口标识5位，由系统类别+C+两位接口顺序号组

3

成，用于唯一表示一个接口。

4QueryXmlDoc查询条件封装查询条件的XML格式文档

1.2.2.写入类接口

PublicStringwriteObjectOut(Stringxtlb,Stringjkxlh,String

jkid,StringWriteXmlDoc)

表2：写入类接口调用参数说明

序号参数名称参数说明备注信息

1xtlb系统类别同上

2jkxlh接口序列号同上

3jkid接口标识同上

4WriteXmlDoc写入数据业务数据写入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文档格式

<?xmlversion="1.0〃encoding二〃GBK〃？>

<root>

<head>

<code>l</code>

〈message〉数据下载成功！</message>

<rownum>1</rownum>

</head>

<body>

<vehisparaid=〃0〃>

<hphm>BAA123</hphm>

<hpzl>02</hpzl>

<zt>A</zt>

</vehispara>

</body>

</root>

1.3.2.写入类接口XML文档

写入数据WriteXmlDoc文档格式如下：

<?xmlversion=〃1.0〃encoding=〃GBK”?>

<root>

<vehispara>一节点标签

<jylsh></jylsh>一写入数据字段

<jyjgbh></jyjgbh>

<jcxdh></jcxdh>

<clsslb></clsslb>

</vehispara>

</root>

写入操作返回结果Xml文档格式如下：

<?xmlversion=〃1.0〃encoding二〃GBK〃？〉

<root>

<head>

<code>l</code>

<message>数据保存成功〈/message)

</head>

</root>

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]检验机构备案信息

检验备案信息查[21检测线备案信息检验监检验业务信息

1.

询接口[31检验机构工作人员备案信息管系统系统

[4]检验业务信息系统备案信息

(51机动车检验登录信息

[6]机动车检验过程开始信息

[7]机动车检验项目开始信息

【8】机动车人工检验项目检验结果详

细信息(GB21861-XXXX)

[9]机动车人工检验项目检验结果详

细信息(GB21861-2008)

[10]二、三轮机动车人工检验项目检验

结果详细信息(GB21861-2008)检验业务信息

检验信息写入接检验监

2.[11]仪器设备检验项目检验结果详细系统、检验智能

口管系统

信息终端系统

[12]路试检验信息

[13]机动车检验项目结束信息

[14]机动车检验过程结束信息

[15]机动车检验结果其他信息

[16]机动车交通事故责任强制保险信

息

[17]机动车检验判定结果信息

[18]机动车检验照片和资料照片信息

[19]机动车检验结果资料申请审核信

[20]机动车复检登录信息

[21]时间同步

[22]获取车辆所属类别对应检验项目

信息

[23]获取机动车对应需拍摄照片和人

工检验项目信息

[24]获取机动车检验审核不通过信息

【25】获取机动车基本信息检验业务信息

其他查询与写入【26】机动车检验登录信息更正检验监系统、视频监管

3.

接口[27]机动车检验视频异常信息管系统系统、检验智能

[28]检验业务信息系统操作日志终端系统

[29]写入收费信息

[30]机动车检验审核通过信息获取回

执

[31]机动车检验业务退办

[32]读取车管业务流水号

[33]互联网检验预约信息下载

22检验过程数据接口流程

1、上传检验信息基本流程

否,

注：修订后的GB21861未正式实施前，人工检验项目检验结

果18C80和18c53都要上传，正式实施后，只上传18C80o

2、审核未通过，需补充材料的，通过以下接口重新上传。

交强险信息写入检验资料图片写

接口18c61入接Hl8c63

机动车检验资料申请审核

信息写入接U18C64

3、复检

具有以下情形之一的，首先进行复检登录，然后再进行后续

操作（同1,但外观检验不复检的，可跳过外观检验项目）。

1）当机动车检验过程结束，存在不合格项目需要复检的。

2）当审核（外观检验）未通过需要复检的。

2.3.检验备案信息读取接口定义

2.3.1J8C01-检验机构备案信息下载

接口类型：查询类接口

接口标识：18C01

功能说明：根据检验机构编号、更新日期等信息下载检验机

构备案信息。

处理过程：①对接口输入参数进行逻辑校验；②查询相应检

验机构备案信息。

查询文档QueryXmlDoc说明：节点标签QueryCondition,查

询条件数据字段如下表：

是否可

序号参数项名称类型长度备注

空

1jczbh检验机构编号varchar210不可空

2gxrq更新日期date可空

返回结果文档ResultXML说明：节点标签vehispara,查询

结果数据字段如下表：

表1：检验机构备案信息

序号参数项名称类型长度是否可备注

空

1jczbh检验机构编号varchar220不可空

2jczmc检验机构名称varchar2128不可空

3sflw是否与公安网联网char1不可空1-是,2-否

4rdsbh资格许可证书编号varchar232不可空

5rdyxqs资格许可有效期始date不可空

6rdyxqz资格许可有效期止date不可空

7设计日检测能力

shejirjcnlnumber4不可空

（汽车辆）

8实际日检测能力

shijirjcnlnumber4不可空

（汽车辆）

9jcryzs检测人员总数number4不可空

10wjgwrs外检工位人数number4不可空

11Irgwrs录入工位人数number4不可空

12ycyrs引车员人数number4不可空

13dpgwrs底盘工位人数number4不可空

14zjgwrs总检工位人数number4不可空

15qtgwrs其他工位人数number4不可空

16tgszjbmkhr通过省级质检部门

number4不可空

s考核人数

17wtgszjbmkh未通过省级质检部

number4不可空

rs门考核人数

18

fzjg发证机关varchar210不可空

19glbm管理部门varchar212不可空

20gxrq更新日期date不可空

21bz备注varchar24000可空

22shejirjcmt设计日检测能力

number4不可空

si（摩托辆）

23shijirjcmt实际日检测能力

number4不可空

si（摩托辆）

240-待审核，1-同意，2-

shbj审核标记varchar22可空

不同意

25syglbm使用管理部门varchar24000可空

26shyj审核意见varchar24000可空

270-撤销，1-正常，2-停

zt状态标记char1不可空用，3-首次备案申请，

4-过有效期

28

ztyy暂停原因varchar2512可空

29dwdz单位地址varchar2300不可空

30yzbm邮政编码varchar26不可空

31xkjyfw许可检验范围varchar2100不可空00-大型车,01-小型车，

02-许可路试超检验能

力的车，03-上门检验

32rdsffdw资格许可发放单位varchar2300不可空

33frdb法人代表varchar230不可空

34frdbsfzh法人代表身份证号varchar218不可空

35frdblxdh法人代表联系电话varchar215不可空

36fzr负责人varchar230不可空

37fzrsfzh负责人身份证号varchar218不可空

38fzrlxdh负责人联系电话varchar215不可空

39rclxr日常联系人varchar230不可空

40日常联系人身份证

rclxrsfzhvarchar218不可空

号

41日常联系人联系电

rclxrlxdhvarchar215不可空

话

8c02-检测线备案信息下载

接口类型：查询类接口

接口标识：18co2

功能说明：根据检验机构编号、更新日期等信息下载检测线

备案信息。

处理过程：①对接口输入参数进行逻辑校验；②查询相应检

测线备案信息。

查询文档QueryXmlDoc说明：节点标签QueryCondition,查

询条件数据字段如下表:

是否可

序号参数项名称类型长度备注

空

1jczbh检验机构编号varchar210不可空

2gxrq更新日期date可空

返回结果文档ResultXML说明：节点标签vehispara,查询

结果数据字段如下表：

表2：检测线备案信息

序号参数项名称类型长度是否可备注

空

1jczbh检验机构编号varchar220不可空

2jcxxh检测线代号varchar22不可空

3jczmc检验机构名称varchar2128不可空

4jcxmc检测线名称varchar2128不可空

5jcxlb检测线类别char1不可空1-汽车，2-摩托车

61-全自动，2-单工位检

jcxczfs检测线控制方式char1不可空

测，9-其他

7zdsbmc制动检测设备名称varchar2128可空

8zdsbxh制动检测设备型号varchar232不可空

制动检测设备生产

9不可空

zdsbsccj厂家varchar2128

10zdjcsj制动检测最少时间number4不可空

11zdjcfs制动检测方式char1可空1-平板，2-滚筒

12pbzs平板制式varchar232可空1-二板式，2-四板式

13dpbcd单平板长度number5可空

14

pbjj平板间距number5可空

15gtszdtzs滚筒式制动台制式char1可空1-开槽式，2-粘砂式

16滚筒式制动台停机1-第三滚筒，2-时间停

可空

gtszdttjfs方式char1

机,3-其它（如可以通过

监测制动力，当制动力

达到最大停电机）

制动检测设备启用

17可空

zdsbqysj时间date

制动检测设备检定

18不可空

zdsbjdyxqz有效期止date

191-正常，2-故障维修，

zdsbzt制动检测设备状态char1不可空

3-报废

20dgsbmc灯光检测设备名称varchar2128可空

21dgsbxh灯光检测设备型号varchar232可空

灯光检测设备生产

22可空

dgsbsccj厂家varchar2128

23dgjcsj灯光检测最少时间number4可空

241-双灯同检，2-单灯检

dgjcfs灯光检测方式char1可空

测

灯光检测是否有车

25可空1-有，2-无

dgcspyxz身偏移修正功能char1

灯光检测设备启用

26可空

dgsbqysj时间date

灯光检测设备检定

27不可空

dgsbjdyxqz有效期止date

281-正常，2-故障维修，

dgsbzt灯光检测设备状态char1不可空

3-报废

29sdsbmc速度检测设备名称varchar2128可空

30sdsbxh速度检测设备型号varchar232可空

速度检测设备生产

31可空

sdsbsccj厂家varchar2128

32sdjcsj速度检测最少时间number4可空

速度检测设备启用

33可空

sdsbqysj时间date

速度检测设备检定

34不可空

sdsbjdyxqz有效期止date

35sdsbzt速度检测设备状态char1不可空1-正常，2-故障维修，

3-报废

36chsbmc侧滑检测设备名称varchar2128可空

37chsbxh侧滑检测设备型号varchar232可空

侧滑检测设备生产

38可空

chsbsccj厂家varchar2128

39chjcsj侧滑检测最少时间number4可空

侧滑检测设备启用

40可空

chsbqysj时间date

侧滑检测设备检定

41不可空

chsbjdyxqz有效期止date

421-正常，2-故障维修，

chsbzt侧滑检测设备状态char1不可空

3-报废

43czsbmc称重设备名称varchar2128可空

44czsbxh称重检测设备型号varchar232可空

称重检测设备生产

45可空

czsbsccj厂家varchar2128

46czjcsj称重检测最少时间number4可空

47设备设计最大承受车

czjb称重范围number6可空辆轴重范围，单位为千

克(kg)

称重检测设备检定

48可空

czsbjdyxqz有效期止date

称重检测设备启用

49不可空

czsbqysj时间date

501-正常，2-故障维修，

czsbzt称重检测设备状态char1不可空

3-报废

51qxjcsj全线检测时间number4可空

52

gwl工位1varchar216可空

53gw2工位2varchar216可空

54gw3工位3varchar216可空

55gw4工位4varchar216可空

56gw5工位5varchar216可空

57gw6工位6varchar216可空

58gw7工位7varchar216可空

59gw8工位8varchar216可空

60gw9工位9varchar216可空

61

bz备注varchar2128可空

62

fzjg发证机关varchar210不可空

63glbm管理部门varchar212不可空

64gxrq更新日期date可空

65zdsbbh制动检验设备编号varchar230可空

制动检验设备检定

66可空

zdsbjdzsbh/校准证书编号varchar230

67dgsbbh灯光检验设备编号varchar230可空

灯光检测设备检定

68可空

dgsbjdzsbh/校准证书标号varchar230

69sdsbbh速度检验设备编号varchar230可空

速度检验设备检定

70可空

sdsbjdzsbh/校准证书标号varchar230

71chsbbh侧滑检验设备编号varchar230可空

侧滑检验设备检定

72可空

chsbjdzsbh/校准证书编号varchar230

73czsbbh称重检验设备编号varchar230可空

称重检验设备检定

74可空

czsbjdzsbh/校准证书编号varchar230

750-撤销，1-正常，2-停

zt状态标记varchar21不可空

用，3-首次备案申请，

4-过有效期

76ztyy暂停原因varchar2512可空

8C05-检验机构工作人员备案信息下载

接口类型：查询类接口

接口标识：18C05

功能说明：根据身份证明号码、姓名、检验机构编号、更新

时间等信息下载检验机构工作人员的基本信息。

处理过程：①对接口输入参数进行逻辑校验；②查询相应检

验机构工作人员备案信息。

查询文档QueryXmlDoc说明：节点标签QueryCondition,查

询条件数据字段如下表:

是否可

序号参数项名称类型长度备注

空

1sfzmhm身份证明号码varchar230可空

2xm姓名varchar230可空

3jczbh检验机构编号varchar210不可空

4gxrq更新时间date可空

返回结果文档ResultXML说明：节点标签vehispara,查询

结果数据字段如下表：

表3：检验机构工作人员备案信息

序号参数项名称类型长度是否可备注

空

1sfzmhm身份证明号码varchar218不可空

2xm姓名varchar230不可空

3rylb人员类别varchar2300不可空

4glbm管理部门varchar212不可空

5fzjg发证机关varchar210不可空

6jczbh检验机构编号varchar220不可空

7gxrq更新日期date