安車機動車檢驗監(jiān)管系統(tǒng)接口使用手冊V4

深圳安車機動車檢驗監(jiān)管系統(tǒng)

接口使用說明書

作者：曾憲金_________________________

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

簽收人：________________________________________

簽收日期：________________________________________

修改情況記錄：

根據公安部＜91機動車檢驗監(jiān)管系統(tǒng)接口使用手冊20150305.doc＞修訂

版本號修改批準人修改人安裝日期簽收人

4.80曾憲金曾憲金2016.5.28

4.90曾憲金曾憲金2017.03.01

目錄

深圳安車機動車檢驗監(jiān)管系統(tǒng).....................................................-1-

文檔變更說明...................................................................-6-

第一部分接口調用規(guī)范..........................................................-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-檢驗業(yè)務信息系統(tǒng)備案信息下載......................................-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-檢驗業(yè)務信息系統(tǒng)操作日志.........................................-129-

2.5.9.18c70-寫入收費信息......................................................-131-

2.5.10.18C71-機動車檢驗審核通過信息獲取回執(zhí)..................................-132-

2.5.11.18C72-機動車檢驗業(yè)務退辦...............................................-133-

2.5.12.18C21-讀取車管業(yè)務流水號...............................................-135-

2.5.13.18C07-互聯(lián)網檢驗預約信息下載...........................................-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-觸發(fā)項目拍照....................................................-155-

2.6518S06-車輛外廓尺寸測量照片上傳........................................-157-

2.6.6.18S14-機動車檢驗行為監(jiān)管..............................................-158-

2.6.7.18S16-檢測設備自檢信息上傳............................................-160-

2.6.1.18S17-檢測項目錄像信息上傳...............................................-161-

268.18S20-環(huán)保檢驗結果信息上傳...............................................-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-檢驗業(yè)務信息系統(tǒng)備案信息下載部屬

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-檢驗業(yè)務信息系統(tǒng)操作日志部屬

2918c70-寫入收費信息部屬

3018c71-機動車檢驗審核通過信息獲取回執(zhí)部屬

3118c72-機動車檢驗業(yè)務退辦部屬

3218c21-讀取車管業(yè)務流水號部屬

3318co7-互聯(lián)網檢驗預約信息下載部屬

3418co8-機動車公告技術參數文本信息下載部屬

3518co9-機動車公告技術參數圖片信息下載部屬

3618S01-獲取檢驗流水號市.屬新增

3718so2-獲取機動車檢驗登錄信息市屬新增

3818so3-獲取外觀檢測數據市一屬新增

3918so4-觸發(fā)項目拍照市屬新增

4018so6-車輛外廓尺寸測量照片上傳市屈新增

4118sl4-機動車檢驗行為監(jiān)管市屬新增

4218sl6-檢測設備自檢信息上傳市屬新增

4318C83機動車排放檢驗信息上傳部署新增

2015-12-04

18C55及18C58中的檢驗項目增加了整備質量項目G

2016-02-22接口調用中的系統(tǒng)類別，劃分如下：

18:檢測業(yè)務系統(tǒng)

28:檢驗智能終端

38:視頻監(jiān)管系統(tǒng)

2017-03-01根據公安部《20170225機動車檢驗監(jiān)管系統(tǒng)接口使用

手冊》，接口增加了整備質量測量、加載制動測量

121.查詢類接口

publicStringquervObjectOut(Stringxtlb,Stringjkxlh,String

jkid,StringQueryXmlDoc）

表1:查詢類接口調用參數說明

參數名稱多數說明備注信息

xtfb系統(tǒng)類別接口提供者的業(yè)務類別代碼，默認為“18”

（代表檢測業(yè)務系統(tǒng)）

1

28:檢驗智育整端

38才賺監(jiān)管系統(tǒng)

2jkxlh接口用^號由外掛系統(tǒng)請利艮務平臺授權生成下發(fā)

jkid接口標識5位，由系獻別+—《海別代碼十兩位接

3

口順序號組成，用千唯一—接口。

4QuervXndDoc查詢條件封裝查詢條件的XML格式文檔

第一部分接口調用規(guī)范

1.1.接口訪問地址

檢驗監(jiān)管系統(tǒng)對外接口訪問地址：

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

識Web服務器地址；port對應系統(tǒng)應用服務的端口號，啟用80

的不填寫。

1.2.接口調用函數

檢驗監(jiān)管系統(tǒng)對外接口包括兩類：查詢類和寫入類接口。查

詢類接口對外提供查詢服務，寫入類接口對外提供將業(yè)務數據寫

入檢驗監(jiān)管系統(tǒng)業(yè)務庫。

1.2.1.查詢類接口

publicStringqueryObjectOut(Stringxtlb,Stringjkxlh,String

jkid,StringQueryXmlDoc)

表1:查詢類接口調用參數說明

序號參數名稱參數說明備注信息

xtlb系統(tǒng)類別接口提供者的業(yè)務類別代碼，默認為“18”

(代表檢測業(yè)務系統(tǒng))

1

28:檢驗智能終端

38:視頻監(jiān)管系統(tǒng)

2jkxlh接口序列號由外掛系統(tǒng)請求服務平臺授權生成下發(fā)

jkid接口標識5位，由系統(tǒng)類別+一位級別代碼+兩位接

3

口順序號組成，用于唯一表示一個接口。

4QueryXmlDoc查詢條件封裝查詢條件的XML格式文檔

1.2.2.寫入類接口

PublicStringwriteObjectOut(Stringxtlb,Stringjkxlh,String

jkid,StringWriteXmlDoc)

表2：寫入類接口調用參數說明

序號參數名稱參數說明備注信息

1xtlb系統(tǒng)類別同上

2jkxlh接口序列號同上

3jkid接口標識同上

4WriteXmlDoc寫入數據業(yè)務數據寫入XML格式文檔

1.3.XML文件格式定義

1.3.1.查詢類接口XML文檔

查詢條件QueryXmlDoc的文檔格式要求如下:

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

<root>

<QueryCondition>一節(jié)點標簽

<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>一節(jié)點標簽

<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文檔【節(jié)點標簽】必須和手冊中注明的保

持一致。

1.4.2.返回結果錯誤代碼說明

正常返回結果code為成功與否標記(小于等于0-失??；1-

成功，由提供的接口服務定義)，網絡異?；蚪涌跈嘞蕻惓５认?/p>

統(tǒng)原因時返回$E的標記。寫入失敗時的message返回詳細描述信

息。

第二部分對外接口說明

2.1.接口列表

檢驗監(jiān)管系統(tǒng)提供的信息接口共30個（見下表），其中寫

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

序號接口名稱接口定義提供者調用者

[1]檢驗機構備案信息

檢驗備案信[2]檢測線備案信息檢驗監(jiān)檢驗業(yè)務信息

1

息查詢接口[3]檢驗機構工作人員備案信息管系統(tǒng)系統(tǒng)

[4]檢驗業(yè)務信息系統(tǒng)備案信息

[5]機動車檢驗登錄信息

[6]機動車檢驗過程開始信息

[7]機動車檢驗項目開始信息

【8】機動車人工檢驗項目檢驗結果詳細信

息(GB21861-XXXX)

[9]機動車人工檢驗項目檢驗結果詳細信

息(GB21861-2008)

[10]二、三輪機動車人工檢驗項目檢驗結

果詳細信息(GB21861-2008)檢驗業(yè)務信息

檢驗信息寫檢驗監(jiān)

2[11]儀器設備檢驗項目檢驗結果詳細信息系統(tǒng)、檢驗智能

入接口[12]路試檢驗信息管系統(tǒng)

終端系統(tǒng)

[13]機動車檢驗項目結束信息

[14]機動車檢驗過程結束信息

[15]機動車檢驗結果其他信息

[16]機動車交通事故責任強制保險信息

[17]機動車檢驗判定結果信息

[18]機動車檢驗照片和資料照片信息

[19]機動車檢驗結果資料申請審核信息

[201機動車復檢登錄信息

[21]時間同步

【22】獲取車輛所屬類別對應檢驗項目信息

[23]獲取機動車對應需拍攝照片和人工檢

驗項目信息

[24]獲取機動車檢驗審核不通過信息

檢驗業(yè)務信息

[25]獲取機動車基本信息

其他查詢與[26]機動車檢驗登錄信息更正檢驗監(jiān)系統(tǒng)、視頻監(jiān)管

3

寫入接口[27]機動車檢驗視頻異常信息管系統(tǒng)系統(tǒng)、檢驗智能

[28]檢驗業(yè)務信息系統(tǒng)操作日志

終端系統(tǒng)

[29]寫入收費信息

[30]機動車檢驗審核通過信息獲取回執(zhí)

【31】機動車檢驗業(yè)務退辦

【32】讀取車管業(yè)務流水號

【33】互聯(lián)網檢驗預約信息下載

22檢驗過程數據接口流程

1、上傳檢驗信息基本流程

否,

注：修訂后的GB21861未正式實施前，人工檢驗項目檢驗結

果18C80和18c53都要上傳，正式實施后，只上傳18C80o

IHS04-觸發(fā)

項目拍照

①(2)③④⑤部分，由安車版監(jiān)管系統(tǒng)來實現，其他由檢測線控制系

統(tǒng)根據安車版接口協(xié)議來實現

2、審核未通過，需補充材料的，通過以下接口重新上傳。

3、復檢

具有以下情形之一的，首先進行復檢登錄，然后再進行后續(xù)

操作（同1,但外觀檢驗不復檢的，可跳過外觀檢驗項目）。

1）當機動車檢驗過程結束，存在不合格項目需要復檢的。

2）當審核（外觀檢驗）未通過需要復檢的。

2.3.檢驗備案信息讀取接口定義

8col-安檢機構備案信息下載

接口類型：查詢類接口

接口標識：18C01

功能說明：根據安檢機構編號、更新日期等信息下載安檢機

構備案信息。

處理過程：①對接口輸入參數進行邏輯校驗；②查詢相應安

檢機構備案信息。

查詢文檔QueryXmlDoc說明：節(jié)點標簽QueryCondition,查

詢條件數據字段如下表：

序號參數項名稱類型長度是否可備注

空

1jczbh安檢機構編號varchar210不可空

2gxrq更新日期date可空

返回結果文檔ResultXML說明：節(jié)點標簽vehispara,查詢

結果數據字段如下表：

表1：安檢機構備案信息

序號參數項名稱類型長度是否可備注

空

1jczbh安檢機構編號varchar220不可空

2jczmc安檢機構名稱varchar2128不可空

3sflw是否與公安網聯(lián)網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發(fā)證機關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狀態(tài)標記char1不可空用，3-首次備案申請，

4-過有效期

28ztyy暫停原因varchar2512可空

29dwdz單位地址varchar2300不可空

30yzbm郵政編碼varchar26不可空

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

xkjyfw許可檢驗范圍varchar2100不可空02-許可路試超檢驗能

力的車，03-上門檢驗

32rdsffdw資格許可發(fā)放單位varchar2300不可空

33frdb法人代表varchar230不可空

34frdbsfzh法人代表身份證號varchar218不可空

35frdblxdh法人代表聯(lián)系電話varchar215不可空

36fzr負責人varchar230不可空

37fzrsfzh負責人身份證號varchar218不可空

38fzrlxdh負責人聯(lián)系電話varchar215不可空

39rclxr日常聯(lián)系人varchar230不可空

40日常聯(lián)系人身份證

rclxrsfzhvarchar218不可空

號

41日常聯(lián)系人聯(lián)系電

rclxrlxdhvarchar215不可空

話

8c02-檢測線備案信息下載

接口類型：查詢類接口

接口標識：18co2

功能說明：根據安檢機構編號、更新日期等信息下載檢測線

備案信息。

處理過程：①對接口輸入參數進行邏輯校驗；②查詢相應檢

測線備案信息。

查詢文檔QueryXmlDoc說明：節(jié)點標簽QueryCondition,查

詢條件數據字段如下表:

是否可

序號參數項名稱類型長度備注

空

1jczbh安檢機構編號varchar210不可空

2gxrq更新日期date可空

返回結果文檔ResultXML說明：節(jié)點標簽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

監(jiān)測制動力，當制動力

達到最大停電機）

制動檢測設備啟用

17可空

zdsbqysj時間date

制動檢測設備檢定

18不可空

zdsbjdyxqz有效期止date

19zdsbzt制動檢測設備狀態(tài)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燈光檢測設備狀態(tài)char1不可空