【正文】 . .. . ..機(jī)動車檢驗(yàn)監(jiān)管系統(tǒng)接口使用手冊公安部交通管理科學(xué)研究所 2014年10月目錄第一部分 接口調(diào)用規(guī)范 5 . 接口訪問地址 5 . 接口調(diào)用函數(shù) 5 . 查詢類接口 5 . 寫入類接口 5 . XML文件格式定義 6 . 查詢類接口XML文檔 6 . 寫入類接口XML文檔 7 . 調(diào)用注意事項(xiàng) 8 . XML文檔的中文處理 8 . 返回結(jié)果錯誤代碼說明 8 第二部分 對外接口說明 9 . 接口列表 9 . 檢驗(yàn)過程數(shù)據(jù)接口流程 11 . 檢驗(yàn)備案信息讀取接口定義 12 . 18C01檢驗(yàn)機(jī)構(gòu)備案信息下載 12 . 18C02檢測線備案信息下載 15 . 18C05檢驗(yàn)機(jī)構(gòu)工作人員備案信息下載 20 . 18C06檢驗(yàn)業(yè)務(wù)信息系統(tǒng)備案信息下載 21 . 檢驗(yàn)信息寫入接口定義 23 . 18C51機(jī)動車檢驗(yàn)登錄信息 23 . 18C52機(jī)動車檢驗(yàn)過程開始信息 29 . 18C55機(jī)動車檢驗(yàn)項(xiàng)目開始信息 30 . 18C80機(jī)動車人工檢驗(yàn)項(xiàng)目檢驗(yàn)結(jié)果詳細(xì)信息(按GB 21861XXXX) 32 . 18C53機(jī)動車人工檢驗(yàn)項(xiàng)目檢驗(yàn)結(jié)果詳細(xì)信息(按GB 218612008) 38 . 18C68二、三輪機(jī)動車人工檢驗(yàn)項(xiàng)目檢驗(yàn)結(jié)果詳細(xì)信息(按GB 218612008) 47 . 18C81儀器設(shè)備檢驗(yàn)項(xiàng)目檢驗(yàn)結(jié)果詳細(xì)信息 54 . 18C54路試檢驗(yàn)信息 71 . 18C58機(jī)動車檢驗(yàn)項(xiàng)目結(jié)束信息 74 . 18C59機(jī)動車檢驗(yàn)過程結(jié)束信息 76 . 18C82機(jī)動車檢驗(yàn)結(jié)果其他信息 77 . 18C61機(jī)動車交通事故責(zé)任強(qiáng)制保險(xiǎn)信息 79 . 18C62機(jī)動車檢驗(yàn)判定結(jié)果信息 81 . 18C63機(jī)動車檢驗(yàn)照片和資料照片信息 84 . 18C64機(jī)動車檢驗(yàn)結(jié)果資料申請審核信息 88 . 18C65機(jī)動車復(fù)檢登錄信息 89 . 其他接口定義 91 . 18C50時(shí)間同步 91 . 18C46獲取車輛所屬類別對應(yīng)檢驗(yàn)項(xiàng)目信息 92 . 18C47獲取機(jī)動車對應(yīng)需拍攝照片和人工檢驗(yàn)項(xiàng)目信息 94 . 18C48獲取機(jī)動車檢驗(yàn)審核不通過原因 95 . 18C49獲取機(jī)動車基本信息 98 . 18C66機(jī)動車檢驗(yàn)登錄信息更正 101 . 18C67機(jī)動車檢驗(yàn)視頻異常信息 105 . 18C69檢驗(yàn)業(yè)務(wù)信息系統(tǒng)操作日志 107 . 18C70寫入收費(fèi)信息 109 . 18C71機(jī)動車檢驗(yàn)審核通過信息獲取回執(zhí) 110 . 18C72機(jī)動車檢驗(yàn)業(yè)務(wù)退辦 111 . 18C21讀取車管業(yè)務(wù)流水號 112 . 18C07互聯(lián)網(wǎng)檢驗(yàn)預(yù)約信息下載 113 第三部分 接口調(diào)用范例 116 . JAVA調(diào)用示例 116 . 中文轉(zhuǎn)碼及XML文檔封裝代碼 116 . 查詢接口示例 118 . 寫接口示例 119 . 其他調(diào)用示例 120 第四部分 寫照片接口說明 121 . 示例代碼 121 . java調(diào)用示例代碼 121 . 接口調(diào)用請求說明 122 . 寫機(jī)動車檢驗(yàn)照片表信息 122 第一部分 接口調(diào)用規(guī)范. 接口訪問地址檢驗(yàn)監(jiān)管系統(tǒng)對外接口訪問地址：://ip:port/pnweb/services/TmriOutAccess?wsdl其中IP標(biāo)識Web服務(wù)器地址；port對應(yīng)系統(tǒng)應(yīng)用服務(wù)的端口號，啟用80的不填寫。. 接口調(diào)用函數(shù)檢驗(yàn)監(jiān)管系統(tǒng)對外接口包括兩類：查詢類和寫入類接口。查詢類接口對外提供查詢服務(wù)，寫入類接口對外提供將業(yè)務(wù)數(shù)據(jù)寫入檢驗(yàn)監(jiān)管系統(tǒng)業(yè)務(wù)庫。. 查詢類接口public String queryObjectOut(String xtlb,String jkxlh,String jkid,String QueryXmlDoc)表1：查詢類接口調(diào)用參數(shù)說明序號參數(shù)名稱參數(shù)說明備注信息1xtlb系統(tǒng)類別接口提供者的業(yè)務(wù)類別代碼，默認(rèn)為“18”（代表機(jī)動車檢驗(yàn)監(jiān)管系統(tǒng)）2jkxlh接口序列號由外掛系統(tǒng)請求服務(wù)平臺授權(quán)生成下發(fā)3jkid接口標(biāo)識5位，由系統(tǒng)類別＋C＋兩位接口順序號組成，用于唯一表示一個(gè)接口。4QueryXmlDoc查詢條件封裝查詢條件的XML格式文檔. 寫入類接口Public String writeObjectOut (String xtlb,String jkxlh,String jkid,String WriteXmlDoc)表2：寫入類接口調(diào)用參數(shù)說明序號參數(shù)名稱參數(shù)說明備注信息1xtlb系統(tǒng)類別同上2jkxlh接口序列號同上3jkid接口標(biāo)識同上4WriteXmlDoc寫入數(shù)據(jù)業(yè)務(wù)數(shù)據(jù)寫入XML格式文檔. XML文件格式定義. 查詢類接口XML文檔查詢條件QueryXmlDoc的文檔格式要求如下：?xml version= encoding=GBK?root QueryCondition 節(jié)點(diǎn)標(biāo)簽 hphm蘇BAA123/hphm hpzl02/hpzl clsbdh1234/clsbdh 車輛識別代號后四位 jyjgbh3200000001/jyjgbh /QueryCondition/root查詢返回結(jié)果ResultXML文檔格式?xml version= encoding=GBK?rootheadcode1/codemessage數(shù)據(jù)下載成功！/messagerownum1/rownum/headbodyvehispara id=0hphm BAA123/hphmhpzl02/hpzl…… ztA/zt/vehispara/body/root. 寫入類接口XML文檔寫入數(shù)據(jù)WriteXmlDoc文檔格式如下：?xml version= encoding=GBK?root vehispara 節(jié)點(diǎn)標(biāo)簽 jylsh/jylsh 寫入數(shù)據(jù)字段 jyjgbh/jyjgbh jcxdh/jcxdh …… clsslb/clsslb /vehispara/root寫入操作返回結(jié)果Xml文檔格式如下：?xml version= encoding=GBK?roothead code1/code message數(shù)據(jù)保存成功/message ……/head/root. 調(diào)用注意事項(xiàng). XML文檔的中文處理（1）接口查詢結(jié)果進(jìn)行過URLDecoder和UTF8編碼處理,須進(jìn)行轉(zhuǎn)換（(str, utf8)。）才能正常讀取；（2）寫入信息中文字符必須URLEncoder成utf8格式（(xmlDoc, utf8)；）后再封裝成XML文檔。（3）XML文檔的【寫入數(shù)據(jù)字段】和【返回結(jié)果字段】的標(biāo)簽均為小寫字符。XML文檔【節(jié)點(diǎn)標(biāo)簽】必須和手冊中注明的保持一致。. 返回結(jié)果錯誤代碼說明正常返回結(jié)果code為成功與否標(biāo)記（小于等于0失敗；1成功，由提供的接口服務(wù)定義），網(wǎng)絡(luò)異?；蚪涌跈?quán)限異常等系統(tǒng)原因時(shí)返回$E的標(biāo)記。寫入失敗時(shí)的message返回詳細(xì)描述信息。第二部分 對外接口說明. 接口列表檢驗(yàn)監(jiān)管系統(tǒng)提供的信息接口共33個(gè)（見下表），其中寫照片接口還可參考第四部分提供的方式。序號接口名稱接口定義提供者調(diào)用者1.檢驗(yàn)備案信息查詢接口【1】 檢驗(yàn)機(jī)構(gòu)備案信息【2】 檢測線備案信息【3】 檢驗(yàn)機(jī)構(gòu)工作人員備案信息【4】 檢驗(yàn)業(yè)務(wù)信息系統(tǒng)備案信息檢驗(yàn)監(jiān)管系統(tǒng)檢驗(yàn)業(yè)務(wù)信息系統(tǒng)2.檢驗(yàn)信息寫入接口【5】 機(jī)動車檢驗(yàn)登錄信息【6】 機(jī)動車檢驗(yàn)過程開始信息【7】 機(jī)動車檢驗(yàn)項(xiàng)目開始信息【8】 機(jī)動車人工檢驗(yàn)項(xiàng)目檢驗(yàn)結(jié)果詳細(xì)信息（GB21861XXXX）【9】 機(jī)動車人工檢驗(yàn)項(xiàng)目檢驗(yàn)結(jié)果詳細(xì)信息（GB218612008）【10】 二、三輪機(jī)動車人工檢驗(yàn)項(xiàng)目檢驗(yàn)結(jié)果詳細(xì)信息（GB218612008）【11】 儀器設(shè)備檢驗(yàn)項(xiàng)目檢驗(yàn)結(jié)果詳細(xì)信息【12】 路試檢驗(yàn)信息【13】 機(jī)動車檢驗(yàn)項(xiàng)目結(jié)束信息【14】 機(jī)動車檢驗(yàn)過程結(jié)束信息【15】 機(jī)動車檢驗(yàn)結(jié)果其他信息【16】 機(jī)動車交通事故責(zé)任強(qiáng)制保險(xiǎn)信息【17】 機(jī)動車檢驗(yàn)判定結(jié)果信息【18】 機(jī)動車檢驗(yàn)照片和資料照片信息【19】 機(jī)動車檢驗(yàn)結(jié)果資料申請審核信息【20】 機(jī)動車復(fù)檢登錄信息檢驗(yàn)監(jiān)管系統(tǒng)檢驗(yàn)業(yè)務(wù)信息系統(tǒng)、檢驗(yàn)智能終端系統(tǒng)3.其他查詢與寫入接口【21】 時(shí)間同步【22】 獲取車輛所屬類別對應(yīng)檢驗(yàn)項(xiàng)目信息【23】 獲取機(jī)動車對應(yīng)需拍攝照片和人工檢驗(yàn)項(xiàng)目信息【24】 獲取機(jī)動車檢驗(yàn)審核不通過信息【25】 獲取機(jī)動車基本信息【26】 機(jī)動車檢驗(yàn)登錄信息更正【27】 機(jī)動車檢驗(yàn)視頻異常信息【28】 檢驗(yàn)業(yè)務(wù)信息系統(tǒng)操作日志【29】 寫入收費(fèi)信息【30】 機(jī)動車檢驗(yàn)審核通過信息獲取回執(zhí)【31】 機(jī)動車檢驗(yàn)業(yè)務(wù)退辦【32】 讀取車管業(yè)務(wù)流水號【33】 互聯(lián)網(wǎng)檢驗(yàn)預(yù)約信息下載檢驗(yàn)監(jiān)管系統(tǒng)檢驗(yàn)業(yè)務(wù)信息系統(tǒng)、視頻監(jiān)管系統(tǒng)、檢驗(yàn)智能終端系統(tǒng). 檢驗(yàn)過程數(shù)據(jù)接口流程上傳檢驗(yàn)信息基本流程注：修訂后的GB21861未正式實(shí)施前，人工檢驗(yàn)項(xiàng)目檢驗(yàn)結(jié)果18C80和18C53都要上傳，正式實(shí)施后，只上傳18C80。審核未通過，需補(bǔ)充材料的，通過以下接口重新上傳。復(fù)檢具有以下情形之一的，首先進(jìn)行復(fù)檢登錄，然后再進(jìn)行后續(xù)操作（同1，但外觀檢驗(yàn)不復(fù)檢的，可跳過外觀檢驗(yàn)項(xiàng)目）。1）當(dāng)機(jī)動車檢驗(yàn)過程結(jié)束，存在不合格項(xiàng)目需要復(fù)檢的。2）當(dāng)審核（外觀檢驗(yàn)）未通過需要復(fù)檢的。. 檢驗(yàn)備案信息讀取接口定義. 18C01檢驗(yàn)機(jī)構(gòu)備案信息下載接口類型：查詢類接口接口標(biāo)識：18C01功能說明：根據(jù)檢驗(yàn)機(jī)構(gòu)編號、更新日期等信息下載檢驗(yàn)機(jī)構(gòu)備案信息。處理過程：①對接口輸入?yún)?shù)進(jìn)行邏輯校驗(yàn)；②查詢相應(yīng)檢驗(yàn)機(jī)構(gòu)備案信息。查詢文檔QueryXmlDoc說明：節(jié)點(diǎn)標(biāo)簽QueryCondition，查詢條件數(shù)據(jù)字段如下表：序號參數(shù)項(xiàng)名稱類型長度是否可空備注1jczbh檢驗(yàn)機(jī)構(gòu)編號varchar210不可空2gxrq更新日期date可空返回結(jié)果文檔ResultXML說明：節(jié)點(diǎn)標(biāo)簽vehispara，查詢結(jié)果數(shù)據(jù)字段如下表：表1： 檢驗(yàn)機(jī)構(gòu)備案信息序號參數(shù)項(xiàng)名稱類型長度是否可空備注1jczbh檢驗(yàn)機(jī)構(gòu)編號varchar220不可空2jczmc檢驗(yàn)機(jī)構(gòu)名稱varchar2128不可空3sflw是否與公安網(wǎng)聯(lián)網(wǎng)char1不可空1是，2否4rdsbh資格許可證書編號varchar232不可空5rdyxqs資格許可有效期始date不可空6rdyxqz資格許可有效期止date不可空7shejirjl設(shè)計(jì)日檢測能力(汽車輛)number4不可空8shijirjl實(shí)際日檢測能力(汽車輛)number4不可空9jcryzs檢測人員總數(shù)number4不可空10wjgwrs外檢工位人數(shù)number4不可空11lrgwrs錄入工位人數(shù)number4不可空12ycyrs引車員人數(shù)number4不可空13dpgwrs底盤工位人數(shù)number4不可空14zjgwrs總檢工位人數(shù)number4不可空15qtgwrs其他工位人數(shù)number4不可空16tgszjbmkhrs通過省級質(zhì)檢部門考核人數(shù)number4不可空17wtgszjbmkhrs未通過省級質(zhì)檢部門考核人數(shù)number4不可空18fzjg發(fā)證機(jī)關(guān)varchar210不可空19glbm管理部門varchar212不可空20gxrq更新日期date不可空21bz備注varchar24000可空22shejirjcmtsl設(shè)計(jì)日檢測能力(摩托輛)number4不可空23shijirjc