單一窗口空運(yùn)貨物艙單申報(bào)接口說(shuō)明v1.0

單一窗口空運(yùn)貨物艙單申報(bào)接口說(shuō)明廣州國(guó)際貿(mào)易“單一窗口”空運(yùn)貨物艙單申報(bào)接口說(shuō)明2016年8月修訂歷史日期版本描述作者2016-8-201.0初稿鄭新灶、黃從敏目錄1 數(shù)據(jù)接口 21.1 文檔描述 21.2 閱讀對(duì)象 31.3 接口協(xié)議 31.4 功能描述 31.5 接口使用前提條件 31.6 報(bào)文編碼 31.7 報(bào)文交換流程圖 32 數(shù)據(jù)接口說(shuō)明 42.1 接數(shù)據(jù)口列表 42.2 接數(shù)據(jù)口定義 42.2.1 申報(bào)接口 42.2.2 聯(lián)檢單位回執(zhí)推送 15數(shù)據(jù)接口文檔描述本文檔主要描述“單一窗口”平臺(tái)通過(guò)接口的方式接收空運(yùn)貨物艙單代理企業(yè)申報(bào)數(shù)據(jù)，以及提供相關(guān)回執(zhí)數(shù)據(jù)推送給空運(yùn)貨物艙單代理企業(yè)，作為接口開(kāi)發(fā)人員實(shí)現(xiàn)接口功能設(shè)計(jì)的參考。本文檔當(dāng)中申報(bào)報(bào)文字段包含了海關(guān)、檢驗(yàn)檢疫和貨站的內(nèi)容，在設(shè)計(jì)時(shí)需注意。閱讀對(duì)象系統(tǒng)分析人員、接口開(kāi)發(fā)人員、維護(hù)人員。接口協(xié)議接口采用RESTful

Webservice方式的設(shè)計(jì)，接口中的業(yè)務(wù)數(shù)據(jù)以及接口返回結(jié)果采用Xml格式進(jìn)行封裝,格式定義詳細(xì)接口使用說(shuō)明。功能描述空運(yùn)貨物艙單代理企業(yè)可通過(guò)此接口向單一窗口發(fā)送空運(yùn)貨物艙單申報(bào)數(shù)據(jù)，由單一窗口登記入庫(kù)并向海關(guān)以及檢驗(yàn)檢疫進(jìn)行申報(bào)，并展示在單一窗口。單一窗口提供聯(lián)檢單位審批回執(zhí)查詢接口，空運(yùn)貨物艙單代理企業(yè)可通過(guò)此接口查詢空運(yùn)貨物艙單所有申報(bào)的回執(zhí)信息。接口使用前提條件空運(yùn)貨物艙單代理企業(yè)可通過(guò)電子口岸限定網(wǎng)絡(luò)進(jìn)行訪問(wèn)。報(bào)文編碼報(bào)文編碼統(tǒng)一采用UTF-8格式。報(bào)文交換流程圖數(shù)據(jù)接口說(shuō)明接數(shù)據(jù)口列表報(bào)文接口名稱接口功能說(shuō)明調(diào)用關(guān)系接口提供方接口使用方申報(bào)接口企業(yè)->電子口岸電子口岸企業(yè)聯(lián)檢單位回執(zhí)推送電子口岸->企業(yè)企業(yè)電子口岸接數(shù)據(jù)口定義申報(bào)接口接口功能說(shuō)明企業(yè)調(diào)用單一窗口接口進(jìn)行申報(bào)，接口采用RESTful

Webservice方式的設(shè)計(jì)，接口中的業(yè)務(wù)數(shù)據(jù)以及接口返回結(jié)果采用Xml格式進(jìn)行封裝,格式定義詳細(xì)接口使用說(shuō)明。調(diào)用成功與失敗見(jiàn)接口返回結(jié)果接口地址HYPERLINKhttp://<DOMAIN>/$CONTEXT_PATH/airManifestDeclare/接口服務(wù)描述說(shuō)明調(diào)用方法無(wú)需指定方法，系統(tǒng)根據(jù)入?yún)⒅械膁eclare的Xml格式數(shù)據(jù)Manifest.Head.MessageType進(jìn)行處理輸入?yún)?shù)參數(shù)標(biāo)識(shí)參數(shù)名稱參數(shù)類型長(zhǎng)度必須傳入（Y/N）參數(shù)格式userName用戶帳號(hào)字符串30Y電子口岸分配的帳戶名，請(qǐng)聯(lián)系電子口岸獲取tokenKey密鑰字符串50Y密鑰信息，請(qǐng)聯(lián)系電子口岸獲取messagetype報(bào)文類型代碼字符串10Y報(bào)文對(duì)應(yīng)業(yè)務(wù)類型，此項(xiàng)與海關(guān)業(yè)務(wù)報(bào)文類型保持一致declareXml格式數(shù)據(jù)字符串1Y具體內(nèi)容見(jiàn)本文子節(jié)點(diǎn);如.1為原始艙單申報(bào);請(qǐng)進(jìn)行壓縮原始艙單申報(bào)報(bào)文節(jié)點(diǎn)說(shuō)明報(bào)文節(jié)點(diǎn)概要圖1-空運(yùn)貨物艙單原始艙單申報(bào)報(bào)文結(jié)構(gòu)圖消息體定義見(jiàn)下節(jié)：報(bào)文定義及示例報(bào)文定義及示例預(yù)配艙單申報(bào)報(bào)文節(jié)點(diǎn)說(shuō)明報(bào)文節(jié)點(diǎn)概要圖1-空運(yùn)貨物艙單預(yù)配艙單申報(bào)報(bào)文結(jié)構(gòu)圖消息體定義見(jiàn)下節(jié)：報(bào)文定義及示例報(bào)文定義及示例理貨報(bào)告申報(bào)報(bào)文節(jié)點(diǎn)說(shuō)明報(bào)文節(jié)點(diǎn)概要圖1-空運(yùn)貨物艙單理貨報(bào)告申報(bào)報(bào)文結(jié)構(gòu)圖消息體定義見(jiàn)下節(jié)：報(bào)文定義及示例報(bào)文定義及示例運(yùn)抵報(bào)告申報(bào)報(bào)文節(jié)點(diǎn)說(shuō)明報(bào)文節(jié)點(diǎn)概要圖1-空運(yùn)貨物艙單運(yùn)抵報(bào)告申報(bào)報(bào)文結(jié)構(gòu)圖消息體定義見(jiàn)下節(jié)：報(bào)文定義及示例報(bào)文定義及示例裝載艙單申報(bào)報(bào)文節(jié)點(diǎn)說(shuō)明報(bào)文節(jié)點(diǎn)概要圖1-空運(yùn)貨物艙單裝載艙單申報(bào)報(bào)文結(jié)構(gòu)圖消息體定義見(jiàn)下節(jié)：報(bào)文定義及示例報(bào)文定義及示例接口返回結(jié)果報(bào)文節(jié)點(diǎn)概要圖2-空運(yùn)航線航空器備案申報(bào)報(bào)文回執(zhí)結(jié)構(gòu)圖消息體定義報(bào)文[Head]節(jié)點(diǎn)定義： [Head]節(jié)點(diǎn)只涉及基礎(chǔ)信息說(shuō)明，不涉及具體業(yè)務(wù)內(nèi)容，如下表：節(jié)點(diǎn)節(jié)點(diǎn)名稱描述RespCode單一窗口接收響應(yīng)代碼單一窗口服務(wù)響應(yīng)代碼：000響應(yīng)成功;999對(duì)應(yīng)異常信息（注意：后續(xù)根據(jù)情況會(huì)逐步增加）RespMsg單一窗口接收響應(yīng)信息單一窗口服務(wù)響應(yīng)信息[MessageID]報(bào)文唯一編號(hào)為請(qǐng)求參數(shù)declare中Xml格式的Head數(shù)據(jù)[FunctionCode]報(bào)文功能代碼為請(qǐng)求參數(shù)declare中Xml格式的Head數(shù)據(jù)[MessageType]報(bào)文類型為請(qǐng)求參數(shù)declare中Xml格式的Head數(shù)據(jù)[SenderID]發(fā)送方代碼為請(qǐng)求參數(shù)declare中Xml格式的Head數(shù)據(jù)[ReceiverID]接收方代碼為請(qǐng)求參數(shù)declare中Xml格式的Head數(shù)據(jù)[SendTime]發(fā)送時(shí)間為請(qǐng)求參數(shù)declare中Xml格式的Head數(shù)據(jù)[Version]報(bào)文版本號(hào)為請(qǐng)求參數(shù)declare中Xml格式的Head數(shù)據(jù)報(bào)文[Response]定義：節(jié)點(diǎn)節(jié)點(diǎn)名稱描述Code數(shù)據(jù)處理類型代碼單一窗口數(shù)據(jù)處理結(jié)果:

Success成功;Fail失敗Text數(shù)據(jù)處理類型詳細(xì)描述單一窗口數(shù)據(jù)處理結(jié)果詳細(xì)描述報(bào)文定義及示例調(diào)用示例前端調(diào)用$.ajax({url:"HYPERLINKhttp://<DOMAIN>/$CONTEXT_PATH/airManifestDeclare/",data:userName=XXX&tokenkey=XXX&messagetype=XXX&&declare=XXX})后端調(diào)用 HttpClienthttpClient=newHttpClient(); HttpConnectionManagerParamsmanagerParams=httpClient .getHttpConnectionManager().getParams(); managerParams.setConnectionTimeout(240000); managerParams.setSoTimeout(240000); StringstrResponse=null; PostMethodpostMethod=newPostMethod("http://<DOMAIN>/$CONTEXT_PATH/airManifestDeclare/"); //將請(qǐng)求參數(shù)的值放入postMethod中 reportStr="<?xmlversion=\"1.0\"encoding=\"UTF-8\"?>\n"+reportStr; NameValuePair[]pairs={newNameValuePair("userName",""), newNameValuePair("tokenkey",""), newNameValuePair("messagetype",""), newNameValuePair("declare","")}; postMethod.getParams().setParameter( HttpMethodParams.HTTP_CONTENT_CHARSET,"utf-8"); postMethod.setRequestBody(pairs); try{ intstatusCode=httpClient.executeMethod(postMethod); if(statusCode!=HttpStatus.SC_OK){ //調(diào)用異常 thrownewBusinessException("Methodfailed:" +postMethod.getStatusLine()); } strResponse=postMethod.getResponseBodyAsString(); }catch(Exceptionex){ thrownewBusinessException("Http調(diào)用出錯(cuò):" +postMethod.getStatusLine()); }finally{ //釋放連接 postMethod.releaseConnection(); } returnstrResponse;接口返回結(jié)果示例返回一個(gè)處理結(jié)果報(bào)文<Manifest><Head><RespCode>0000</RespCode><RespMsg></RespMsg><MessageID>CN_MT5201_1p0_5100725066955_20150521073100079</MessageID><FunctionCode>2</FunctionCode><MessageType>MT5201</MessageType><SenderID>5100725066955</SenderID><ReceiverID>5141</ReceiverID><SendTime>20150521073100790</SendTime><Version>1.0</Version></Head><Response><Code>Success或Fail</Code><Text>詳細(xì)描述</Text></Response></Manif