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

深圳安车机动车检验监管系统

接口使用说明书

作者：曾宪金_________________________

完成日期：_________2017年03月01日______________

签收人：________________________________________

签收日期：________________________________________

修改情况记录：

根据公安部＜91机动车检验监管系统接口使用手册20150305.doc＞修订

版本号修改批准人修改人安装日期签收人

4.80曾宪金曾宪金2016.5.28

4.90曾宪金曾宪金2017.03.01

目录

深圳安车机动车检验监管系统.....................................................-1-

文档变更说明...................................................................-6-

第一部分接口调用规范..........................................................-9-

1.1.接口访问地址................................................................-9-

1.2.接口调用函数................................................................-9-

1.2.1.查询类接口................................................................-9-

1.2.2.写入类接口...............................................................-10-

1.3.XML文件格式定义...........................................................-10-

1.3.1.查询类接口XML文档......................................................-10-

1.3.2.写入类接口XML文档......................................................-11-

1.4.调用注意事项...............................................................-12-

1.4.1.XML文档的中文处理.......................................................-12-

1.4.2.返回结果错误代码说明....................................................-12-

第二部分对外接口说明.........................................................-13-

2.1.接口列表...................................................................-13-

2.2.检验过程数据接口流程......................................................-15-

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

2.3.1.18C01-安检机构备案信息下载...............................................-17-

2.3.2.18co2-检测线备案信息下载.................................................-20-

2.3.3.18C05-安检机构工作人员备案信息下载......................................-25-

2.3.4.18C06-检验业务信息系统备案信息下载......................................-26-

2.4.检验信息写入接口定义......................................................-28-

2.4.1.18C51-机动车检验登录信息.................................................-28-

2.4.2.18C52-机动车检验过程开始信息.............................................-34-

2.4.3.18C55-机动车检验项目开始信息.............................................-35-

2.4.4.18C80-机动车人工检验项目检验结果详细信息(按GB21861-2014).................-38-

2.4.5.18C53-机动车人工检验项目检验结果详细信息(按GB21861-2008).................-45-

2.4.6.18c68-二、三轮机动车人工检验项目检验结果详细信息(按GB21861-2008)........-54-

2.4.7.18C81-仪器设备检验项目检验结果详细信息....................................-61-

2.4.8.18C54-路试检验信息.........................................................-91-

2.4.9.18c58-机动车检验项目结束信息..............................................-94-

2.4.10.18C59-机动车检验过程结束信息.............................................-96-

2.4.11.18C82-机动车检验结果其他信息.............................................-97-

2412.18C61-机动车交通事故责任强制保险信息......................................-99-

2.4.13.18C62-机动车检验判定结果信息...........................................-101-

2.4.14.18C63-机动车检验照片和资料照片信息....................................-104-

2.4.15.18C64-机动车检验结果资料申请审核信息..................................-108-

2.4.16.18C65-机动车复检登录信息...............................................-110-

2417.18C83-机动车排放检验信息................................................-112-

2.5.其他接口定义.............................................................-114-

2.5.1.18C50-时间同步..........................................................-114-

2.5218C46-获取车辆所属类别对应检验项目信息..................................-115-

253.18C47-获取机动车对应需拍摄照片和人工检验项目信息.......................-116-

254.18C48-获取机动车检验审核不通过原因.....................................-118-

2.5.5.18c49-获取机动车基本信息................................................-120-

2.5.6.18C66-机动车检验登录信息更正............................................-124-

2.5.7.18C67-机动车检验视频异常信息............................................-128-

2.5.8.18C69-检验业务信息系统操作日志.........................................-129-

2.5.9.18c70-写入收费信息......................................................-131-

2.5.10.18C71-机动车检验审核通过信息获取回执..................................-132-

2.5.11.18C72-机动车检验业务退办...............................................-133-

2.5.12.18C21-读取车管业务流水号...............................................-135-

2.5.13.18C07-互联网检验预约信息下载...........................................-135-

2.5.14.18C08-机动车公告技术参数文本信息下载..................................-137-

2515.18C09-机动车公告技术参数图片信息下载...................................-143-

2.6.省市新增接口.............................................................-144-

261.18S01-获取检验流水号..................................................-144-

2.6218S02-获取机动车检验登录信息..........................................-146-

2.6.3.18so3-获取外观检测数据................................................-151-

2.6.4.18so4-触发项目拍照....................................................-155-

2.6518S06-车辆外廓尺寸测量照片上传........................................-157-

2.6.6.18S14-机动车检验行为监管..............................................-158-

2.6.7.18S16-检测设备自检信息上传............................................-160-

2.6.1.18S17-检测项目录像信息上传...............................................-161-

268.18S20-环保检验结果信息上传...............................................-163-

2.6918S21-检测收费信息上传...................................................-166-

2.6.10.18S22-检测项目录像结束信息上传..........................................-168-

第三部分接口调用范例........................................................-169-

3.1.JAVA调用示例.............................................................-169-

3.1.1.中文转码及XML文档封装代码.............................................-169-

3.1.2.查询接口示例............................................................-171-

3.1.3.写接口示例..............................................................-172-

3.2.其他调用示例..............................................................-173-

第四部分写照片接口说明......................................................-175-

1.1.示例代码..................................................................-175-

4.1.1.java调用示例代码........................................................-175-

1.2.接口调用请求说明.........................................................-176-

4.2.1.写机动车检验照片表信息..................................................-176-

第五部分附件.................................................................-178-

5.1车辆用途...................................................................-178-

5.2用途属性..................................................................-178-

5.3车身颜色..................................................................-178-

5.4使用性质..................................................................-179-

5.5车辆类型..................................................................-179-

文档变更说明

序号接口归属备注

118coi-安检机构备案信息下载部属

218co2-检测线备案信息下载部属

318co5-安检机构工作人员备案信息下载部属

418c06-检验业务信息系统备案信息下载部属

518c51-机动车检验登录信息部属

618c52-机动车检验过程开始信息部属

718c55-机动车检验项目开始信息部属

818C80机动车人工检验项目检验结果详细信息部属

918c53-机动车人工检验项目检验结果详细信息(按GB部属

21861-2008)

1018c68-二、三轮机动车人工检验项目检验结果详细信息(按部属

GB21861-2008)

1118c81-仪器设备检验项目检验结果详细信息部署

1218c54-路试检验信息部属

1318c58-机动车检验项目结束信息部属

1418c59-机动车检验过程结束信息部属

1518c82-机动车检验结果其他信息部属

1618c61-机动车交通事故责任强制保险信息部属

1718c62-机动车检验判定结果信息部属

1818c63-机动车检验照片和资料照片信息部属

1918c64-机动车（查验）检验结果资料申请审核信息部属

2018c65-机动车复检登录信息部属

2118c50-时间同步部属

2218c46-获取车辆类型、使用性质对应检验项目信息部属

2318c47-获取机动车对应需拍摄照片和人工检验项目信息部属

2418c48-获取机动车检验审核不通过原因部属

2518c49-获取机动车基本信息部属

2618c66-机动车检验登录信息更正部属

2718c67-机动车检验视频异常信息部属

2818c69-检验业务信息系统操作日志部属

2918c70-写入收费信息部属

3018c71-机动车检验审核通过信息获取回执部属

3118c72-机动车检验业务退办部属

3218c21-读取车管业务流水号部属

3318co7-互联网检验预约信息下载部属

3418co8-机动车公告技术参数文本信息下载部属

3518co9-机动车公告技术参数图片信息下载部属

3618S01-获取检验流水号市.属新增

3718so2-获取机动车检验登录信息市属新增

3818so3-获取外观检测数据市一属新增

3918so4-触发项目拍照市属新增

4018so6-车辆外廓尺寸测量照片上传市屈新增

4118sl4-机动车检验行为监管市属新增

4218sl6-检测设备自检信息上传市属新增

4318C83机动车排放检验信息上传部署新增

2015-12-04

18C55及18C58中的检验项目增加了整备质量项目G

2016-02-22接口调用中的系统类别，划分如下：

18:检测业务系统

28:检验智能终端

38:视频监管系统

2017-03-01根据公安部《20170225机动车检验监管系统接口使用

手册》，接口增加了整备质量测量、加载制动测量

121.查询类接口

publicStringquervObjectOut(Stringxtlb,Stringjkxlh,String

jkid,StringQueryXmlDoc）

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

参数名称多数说明备注信息

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

（代表检测业务系统）

1

28:检验智育整端

38才赚监管系统

2jkxlh接口用^号由外挂系统请利艮务平台授权生成下发

jkid接口标识5位，由系献别+—《海别代码十两位接

3

口顺序号组成，用千唯一—接口。

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

第一部分接口调用规范

1.1.接口访问地址

检验监管系统对外接口访问地址：

http://ip:port/jcxws/TmriOutAccess.asmx?wsdl其中IP标

识Web服务器地址；port对应系统应用服务的端口号，启用80

的不填写。

1.2.接口调用函数

检验监管系统对外接口包括两类：查询类和写入类接口。查

询类接口对外提供查询服务，写入类接口对外提供将业务数据写

入检验监管系统业务库。

1.2.1.查询类接口

publicStringqueryObjectOut(Stringxtlb,Stringjkxlh,String

jkid,StringQueryXmlDoc)

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

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

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

(代表检测业务系统)

1

28:检验智能终端

38:视频监管系统

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

jkid接口标识5位，由系统类别+一位级别代码+两位接

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>320000000l</jyjgbh>

</QueryCondition>

</root>

查询返回结果ResultXML文档格式

<?xmlversion=//l.0，zencoding="GBK〃？>

<root>

<head>

<code>K/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.接口列表

检验监管系统提供的信息接口共30个（见下表），其中写

照片接口还可参考第四部分提供的方式。

序号接口名称接口定义提供者调用者

[1]检验机构备案信息

检验备案信[2]检测线备案信息检验监检验业务信息

1

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

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

[5]机动车检验登录信息

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

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

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

息(GB21861-XXXX)

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

息(GB21861-2008)

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

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

检验信息写检验监

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

入接口[12]路试检验信息管系统

终端系统

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

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

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

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

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

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

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

[201机动车复检登录信息

[21]时间同步

【22】获取车辆所属类别对应检验项目信息

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

验项目信息

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

检验业务信息

[25]获取机动车基本信息

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

3

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

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

终端系统

[29]写入收费信息

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

【31】机动车检验业务退办

【32】读取车管业务流水号

【33】互联网检验预约信息下载

22检验过程数据接口流程

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

否,

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

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

IHS04-触发

项目拍照

①(2)③④⑤部分，由安车版监管系统来实现，其他由检测线控制系

统根据安车版接口协议来实现

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

3、复检

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

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

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

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

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

8col-安检机构备案信息下载

接口类型：查询类接口

接口标识：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可空

26

shyj审核意见varchar24000可空

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

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

4-过有效期

28ztyy暂停原因varchar2512可空

29dwdz单位地址varchar2300不可空

30yzbm邮政编码varchar26不可空

3100-大型车,01-小型车，

xkjyfw许可检验范围varchar2100不可空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-粘砂式

161-第三滚筒，2-时间停

滚筒式制动台停机机,3-其它（如可以通过

可空

gtszdttjfs方式char1

监测制动力，当制动力

达到最大停电机）

制动检测设备启用

17可空

zdsbqysj时间date

制动检测设备检定

18不可空

zdsbjdyxqz有效期止date

19zdsbzt制动检测设备状态char1不可空1-正常，2-故障维修，

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不可空