附件5、電子口岸單一窗口海關(guān)預(yù)錄入組件-開(kāi)發(fā)白皮書(shū)

電子口岸單一窗口海關(guān)預(yù)錄入組件開(kāi)發(fā)白皮書(shū)目錄1 文檔說(shuō)明 42 術(shù)語(yǔ) 52.1 電子口岸單一窗口海關(guān)預(yù)錄入組件 53 預(yù)錄入組件設(shè)計(jì)介紹 54 環(huán)境準(zhǔn)備 74.1 運(yùn)行環(huán)境要求 74.1.1 單一窗口平臺(tái)服務(wù)端要求 74.1.2 客戶端要求 74.2 網(wǎng)絡(luò)環(huán)境 85 安全組件說(shuō)明 95.1 安全組件接口說(shuō)明 95.1.1 組件信息 95.1.2 方法說(shuō)明 95.2 安全組件使用說(shuō)明 105.2.1 B/S使用步驟說(shuō)明 105.2.2 C/S使用步驟說(shuō)明 106 業(yè)務(wù)組件說(shuō)明 116.1 預(yù)錄入組件接口說(shuō)明 116.1.1 組件信息 116.1.2 方法說(shuō)明 116.1.3 屬性說(shuō)明 136.2 業(yè)務(wù)組件使用說(shuō)明 146.2.1 B/S應(yīng)用使用步驟說(shuō)明 146.2.2 C/S應(yīng)用使用步驟說(shuō)明 146.3 報(bào)關(guān)單業(yè)務(wù)模塊說(shuō)明 146.4 運(yùn)輸工具業(yè)務(wù)模塊說(shuō)明 146.5 新艙單業(yè)務(wù)模塊說(shuō)明 146.6 轉(zhuǎn)關(guān)單業(yè)務(wù)模塊說(shuō)明 156.7 轉(zhuǎn)關(guān)運(yùn)抵報(bào)告業(yè)務(wù)模塊說(shuō)明 156.8 快件轉(zhuǎn)運(yùn)中心業(yè)務(wù)模塊說(shuō)明 156.9 新快件業(yè)務(wù)模塊說(shuō)明 156.10 展覽品業(yè)務(wù)模塊說(shuō)明 156.11 減免稅業(yè)務(wù)模塊說(shuō)明 156.12 公路運(yùn)輸工具業(yè)務(wù)模塊說(shuō)明 156.13 公路艙單業(yè)務(wù)模塊說(shuō)明 166.14 稽查作業(yè)業(yè)務(wù)模塊說(shuō)明 166.15 保稅貨物流轉(zhuǎn)業(yè)務(wù)模塊說(shuō)明 166.16 加工貿(mào)易電子手冊(cè)業(yè)務(wù)模塊說(shuō)明 166.17 新車輛證明書(shū)業(yè)務(wù)模塊說(shuō)明 166.18 數(shù)據(jù)字段規(guī)范定義 167 平臺(tái)身份認(rèn)證服務(wù)封裝 167.1 第三方平臺(tái)的身份認(rèn)證說(shuō)明 167.2 第三方平臺(tái)身份認(rèn)證流程圖 177.3 第三方平臺(tái)身份認(rèn)證流程說(shuō)明 172、 用戶登錄成功后，第三方平臺(tái)針對(duì)每個(gè)用戶生成并保存用戶臨時(shí)唯一編號(hào)（以下簡(jiǎn)稱該編號(hào)為UserID），將該UserID返回給客戶端。用戶登陸第三方平臺(tái)。（需第三方平臺(tái)實(shí)現(xiàn)） 187.4 平臺(tái)身份認(rèn)證服務(wù) 187.5 平臺(tái)身份認(rèn)證代理接口定義 188 附錄 198.1 B/S架構(gòu)代碼示例 198.1.1 安全組件代碼示例 198.1.2 報(bào)關(guān)單預(yù)錄入組件代碼示例 218.1.3 空運(yùn)航線航空器備案申報(bào)代碼示例 228.2 C/S架構(gòu)代碼示例 238.2.1 安全組件代碼示例 238.2.2 報(bào)關(guān)單預(yù)錄入組件代碼示例 238.2.3 空運(yùn)航線航空器備案申報(bào)代碼示例 248.2.4 客戶端部署注意事項(xiàng) 24

文檔更新記錄更新日期更新內(nèi)容備注2015.6.11報(bào)關(guān)單JSON格式中節(jié)點(diǎn)名稱Attachment變更為DecSign#報(bào)關(guān)單JSON數(shù)據(jù)格式2015.6.15補(bǔ)充完善CSM101水運(yùn)進(jìn)出單據(jù)申報(bào)JSON格式定義水運(yùn)進(jìn)出單據(jù)申報(bào)JSON數(shù)據(jù)格式2015.6.15CSM002、CSM003、CSM004、CSM005、CSM007中補(bǔ)充了JourneyID格式的定義2015.6.16安全組件boolLogin()，變更為stringLogin()2015.6.16業(yè)務(wù)組件增加LoginResult屬性，需要傳入Login()登陸成功后的返回值2015.6.17附錄示例代碼更新2015.8.20“自動(dòng)更新組件”名稱更改為“安全組件”增加C/S版程序使用說(shuō)明2015.9.17網(wǎng)絡(luò)環(huán)境自動(dòng)更新組件2015.10.13修改了3.2網(wǎng)絡(luò)環(huán)境的說(shuō)明2015.10.141.修改了客戶端傳入?yún)?shù)及說(shuō)明;2.運(yùn)輸工具json格式2015.10.21接受了之前對(duì)文檔的修訂；統(tǒng)一了命名：將“平臺(tái)加簽”“平臺(tái)簽名”等命名統(tǒng)一為“平臺(tái)身份認(rèn)證”2015.10.21修改了標(biāo)題有大括號(hào)的問(wèn)題2015.10.26修改了”空運(yùn)航空器在港動(dòng)態(tài)申報(bào)JSON數(shù)據(jù)格式”2015.10.26增加了支持青島和寧波分布式部署的情況2015.10.27修改了運(yùn)輸工具的JSON數(shù)據(jù)格式2015.10.30增加新艙單業(yè)務(wù)模塊說(shuō)明2015.11.3修改青島和寧波分布式的傳入?yún)?shù)2015.11.3增加客戶端組件的運(yùn)行環(huán)境說(shuō)明2015.11.9增加第三方平臺(tái)身份認(rèn)證相關(guān)說(shuō)明2015.11.9修改所有JSON報(bào)文格式為正文文本2015.11.9補(bǔ)充總體設(shè)計(jì)圖2015.11.10修改新艙單空運(yùn)JSON報(bào)文的Version格式2015.11.12修改新艙單刪除報(bào)文的JSON格式2015.11.17刪除stringPlatfromService接口2015.12.9客戶端業(yè)務(wù)組件增加卡控件的8個(gè)查詢方法2015.12.22將客戶端業(yè)務(wù)組件查詢卡控件合并成一個(gè)方法2015.12.23增加獲取參數(shù)接口說(shuō)明2015.12.28修改帶屬性的艙單變更的JSON數(shù)據(jù)格式2015.12.29修改報(bào)關(guān)單業(yè)務(wù)JSON報(bào)文及數(shù)據(jù)規(guī)范文檔說(shuō)明本文檔供單一窗口平臺(tái)系統(tǒng)開(kāi)發(fā)團(tuán)隊(duì)使用，文檔內(nèi)容描述了如何在自己的業(yè)務(wù)平臺(tái)上集成單一窗口預(yù)錄入組件，以及如何調(diào)用這些組件，包括組件調(diào)用規(guī)范，數(shù)據(jù)接口規(guī)范說(shuō)明等內(nèi)容。術(shù)語(yǔ)電子口岸單一窗口海關(guān)預(yù)錄入組件以下簡(jiǎn)稱預(yù)錄入組件，是由中國(guó)電子口岸數(shù)據(jù)中心提供的一組業(yè)務(wù)組件，用于配合單一窗口平臺(tái)實(shí)現(xiàn)關(guān)單、運(yùn)輸工具等業(yè)務(wù)功能。

預(yù)錄入組件設(shè)計(jì)介紹構(gòu)件邏輯圖說(shuō)明：客戶端組件的形式是AcitveX組件，通過(guò)訪問(wèn)數(shù)據(jù)中心的地址獲得。聯(lián)調(diào)測(cè)試環(huán)境地址：/DownloaderPlatform/Eport.PreInput.Setup.AutoUpdate.msi運(yùn)行環(huán)境地址：/DownloaderPlatform/Eport.PreInput.Setup.AutoUpdate.msi數(shù)據(jù)在上行過(guò)程中，不經(jīng)過(guò)交換平臺(tái)數(shù)據(jù)在上行過(guò)程中，通過(guò)外掛服務(wù)實(shí)現(xiàn)數(shù)據(jù)先下發(fā)至分中心后發(fā)至數(shù)據(jù)中心，從而實(shí)現(xiàn)串行控制。外掛服務(wù)的接口由數(shù)據(jù)中心定義，外掛服務(wù)由分中心開(kāi)發(fā)實(shí)現(xiàn)。該外掛可配置，功能可選。（外掛服務(wù)數(shù)據(jù)中心提供demo程序）數(shù)據(jù)回執(zhí)是通過(guò)在安裝在分中心的交換平臺(tái)客戶端來(lái)接收。部署在第三方平臺(tái)上的“第三方平臺(tái)身份認(rèn)證服務(wù)”和“第三方平臺(tái)身份認(rèn)證代理服務(wù)”詳見(jiàn)第7章。環(huán)境準(zhǔn)備運(yùn)行環(huán)境要求單一窗口平臺(tái)服務(wù)端要求（一）預(yù)錄入組件采用ActiveX技術(shù)開(kāi)發(fā)，對(duì)單一窗口平臺(tái)系統(tǒng)服務(wù)端的開(kāi)發(fā)語(yǔ)言無(wú)特定要求。（二）第三方平臺(tái)服務(wù)端需要部署平臺(tái)身份認(rèn)證服務(wù)，該服務(wù)的程序和部署方式由中國(guó)電子口岸數(shù)據(jù)中心提供，部署詳見(jiàn)《第三方平臺(tái)部署文檔》。（三）第三方平臺(tái)服務(wù)端需要部署加密機(jī)，加密機(jī)的技術(shù)要求詳見(jiàn)《附件2、電子口岸單一窗口（海關(guān)）預(yù)錄入組件服務(wù)器密碼機(jī)技術(shù)要求》。第三方平臺(tái)應(yīng)根據(jù)系統(tǒng)服務(wù)的保障級(jí)別的需求，考慮加密機(jī)的冗余配置。部署詳見(jiàn)《第三方平臺(tái)部署文檔》（四）第三方平臺(tái)服務(wù)端需要封裝“平臺(tái)身份認(rèn)證服務(wù)”，具體說(shuō)明請(qǐng)見(jiàn)“平臺(tái)身份認(rèn)證服務(wù)封裝”章節(jié)?？蛻舳艘笥捎陬A(yù)錄入組件及相關(guān)附件采用.Net技術(shù)開(kāi)發(fā)，因此客戶端需要安裝.NetFramework2.0版本。需配合IE瀏覽器使用預(yù)錄入組件。預(yù)錄入組件的客戶端運(yùn)行環(huán)境：硬件環(huán)境要求：處理器：InterE8400+內(nèi)存：4G及以上硬盤容量：80G及以上網(wǎng)絡(luò)帶寬：互聯(lián)網(wǎng)4M及以上軟件環(huán)境要求：操作系統(tǒng)：WindowsXpSp3/Windows7(32位)瀏覽器:IE8(32位)/IE9(32位)網(wǎng)絡(luò)環(huán)境企業(yè)客戶端需要開(kāi)放Internet訪問(wèn)權(quán)限，至少要確保能夠訪問(wèn)中國(guó)電子口岸數(shù)據(jù)中心提供的相關(guān)服務(wù)地址。序號(hào)地址名稱URL使用說(shuō)明提供者1自動(dòng)更新服務(wù)地址/DownloaderPlatform/EportDll（聯(lián)調(diào)環(huán)境）/DownloaderPlatform/EportDll（運(yùn)行環(huán)境）預(yù)錄入組件自動(dòng)調(diào)用電子口岸數(shù)據(jù)中心2第三方平臺(tái)身份認(rèn)證代理服務(wù)地址根據(jù)服務(wù)部署情況確定預(yù)錄入組件自動(dòng)調(diào)用第三方平臺(tái)3第三方平臺(tái)身份認(rèn)證服務(wù)地址根據(jù)服務(wù)部署情況確定代理服務(wù)調(diào)用第三方平臺(tái)4分中心外掛服務(wù)地址http://***********預(yù)錄入組件自動(dòng)調(diào)用數(shù)據(jù)分中心特別說(shuō)明：1、自動(dòng)更新服務(wù)：用來(lái)獲取預(yù)錄入組件。聯(lián)調(diào)環(huán)境地址和運(yùn)行環(huán)境地址均提供，均可以通過(guò)互聯(lián)網(wǎng)訪問(wèn)。2、第三方平臺(tái)身份認(rèn)證代理服務(wù)：由第三方平臺(tái)根據(jù)接口定義開(kāi)發(fā)，由第三方平臺(tái)部署并提供地址。數(shù)據(jù)中心開(kāi)發(fā)了demo程序。3、第三方平臺(tái)身份認(rèn)證服務(wù)：該服務(wù)的作用是訪問(wèn)加密機(jī)，獲取平臺(tái)的簽名信息。該服務(wù)由數(shù)據(jù)中心提供，部署在第三方平臺(tái)上。地址由第三方平臺(tái)提供。4、分中心外掛服務(wù)：該服務(wù)的作用是實(shí)現(xiàn)數(shù)據(jù)在上行過(guò)程中將數(shù)據(jù)發(fā)送至分中心，實(shí)現(xiàn)串行的功能。該服務(wù)由數(shù)據(jù)分中心開(kāi)發(fā)、并部署，地址由數(shù)據(jù)分中心提供。安全組件說(shuō)明安全組件接口說(shuō)明安全組件用于檢查本地用戶環(huán)境，驗(yàn)證組件安裝情況，發(fā)現(xiàn)安全組件后由用戶下載并更新本地組件。組件信息組件名稱EportSwcAutoUpdater組件類型ActiveXclassid"clsid:E58B9A24-1F2D-4EE7-B18C-D2F151DF77F2"codebase"http://**************/Eport.PreInput.Setup.AutoUpdate.msi#version=1.0.0"方法說(shuō)明方法名說(shuō)明stringGetUpdateStatus()獲取安全組件更新?tīng)顟B(tài)stringLogin()讀取IKEY卡密碼進(jìn)行密碼驗(yàn)證stringGetUpdateStatus()獲取更新結(jié)果信息，返回JSON格式對(duì)象用于描述錯(cuò)誤信息，以便定位問(wèn)題原因。返回值類型說(shuō)明String返回接口調(diào)用結(jié)果返回結(jié)果采用JSON格式定義數(shù)據(jù)結(jié)構(gòu)如下{"ResultData":{"Result":bool,"Data":["Data信息"],"Error":["Error信息"]}}Rsault為true則調(diào)用成功，有返回值則存在于Data中，無(wú)返回值為nullRsault為false則調(diào)用失敗，錯(cuò)誤信息存在于Error中。stringLogin()讀取界面輸入的IKEY密碼，調(diào)用安全組件進(jìn)行電子口岸單點(diǎn)登陸驗(yàn)證。單點(diǎn)登錄校驗(yàn)成功后會(huì)返回一串驗(yàn)證過(guò)的JSON信息，該信息需要在業(yè)務(wù)表單提交時(shí)傳入到預(yù)錄入組件中。返回值類型說(shuō)明String返回接口調(diào)用結(jié)果返回結(jié)果采用JSON格式定義數(shù)據(jù)結(jié)構(gòu)如下{"ResultData":{"Result":bool,"Data":["Data信息"],"Error":["Error信息"]}}Rsault為true則調(diào)用成功，返回登陸安全碼存于Data中Rsault為false則調(diào)用失敗，錯(cuò)誤信息存在于Error中。安全組件使用說(shuō)明B/S使用步驟說(shuō)明下載并安裝安全組件。開(kāi)發(fā)人員在應(yīng)用程序入口的html或aspx的頁(yè)面中放置IKEY密碼輸入框及安全組件。開(kāi)發(fā)人員需要自己調(diào)用組件提供的交互接口，傳入IKEY密碼完成系統(tǒng)的登錄認(rèn)證保存認(rèn)證憑據(jù)，跳轉(zhuǎn)至業(yè)務(wù)申報(bào)界面具體代碼詳見(jiàn)7.1B/S結(jié)構(gòu)代碼示例。C/S使用步驟說(shuō)明下載并安裝安全組件。將安裝后的安全組件文件拷貝到應(yīng)用程序的主目錄中。在VS開(kāi)發(fā)工具IDE中引用安全組件引用Eport.PreInput.AutoUpdaterAutoUpdater.dll文件，并將其中的安全組件添加到VS的工具箱中。添加后如下圖所示：將安全組件拖入到登錄界面中，然后調(diào)用安全組件接口中公布的方法。具體代碼使用詳見(jiàn)7.2C/S結(jié)構(gòu)代碼示例。業(yè)務(wù)組件說(shuō)明業(yè)務(wù)組件是表單提交的主入口，通過(guò)傳入的表單及業(yè)務(wù)類型等基礎(chǔ)信息，會(huì)選擇性調(diào)用對(duì)應(yīng)的業(yè)務(wù)模塊。該組件由安全組件自動(dòng)下載并且注冊(cè)完成，無(wú)需手動(dòng)安裝，在進(jìn)入包含預(yù)錄入組件業(yè)務(wù)表單填制界面前，請(qǐng)確保程序先進(jìn)入包含安全組件的登錄界面，登陸成功（調(diào)用安全組件的登陸方法校驗(yàn)通過(guò)）后再跳轉(zhuǎn)到業(yè)務(wù)表單填制界面中，否則會(huì)導(dǎo)致后續(xù)流程無(wú)法正常進(jìn)行。預(yù)錄入組件接口說(shuō)明組件信息組件名稱EportSwc組件類型ActiveXclassid"clsid:B90439DC-03D4-45e9-89F7-991D4E9B16D2"方法說(shuō)明方法名說(shuō)明voidExecute()啟動(dòng)功能調(diào)用，相關(guān)信息參考屬性說(shuō)明stringGetCompanyInfo(stringpassword)對(duì)第三方平臺(tái)公布的方法,獲取企業(yè)相關(guān)信息*獲取信息前必須先登錄，并且不支持登錄后更換IC卡查詢企業(yè)信息入?yún)?password為卡密碼返回結(jié)果采用JSON格式定義數(shù)據(jù)結(jié)構(gòu)如下{"Result":true,"Data":["Data信息"],"Error":["Error信息"]}Result為true則調(diào)用成功，有返回值則存在于Data中，無(wú)返回Data為空Result為false則調(diào)用失敗，錯(cuò)誤信息存在于Error中。stringGetCodeList(stringcodeType)根據(jù)參數(shù)類型，獲取參數(shù)列表入?yún)ⅲ篶odeType為參數(shù)類型，隨后將具體根據(jù)應(yīng)用需求給出返回結(jié)果采用JSON格式定義數(shù)據(jù)結(jié)構(gòu)如下：{"Result":true,"Data":[{"Code1":”Value1”,……"CodeN":”ValueN”}],"Error":["Error信息"]}Result為true則調(diào)用成功，有返回值則存在于Data中，無(wú)返回Data為空Result為false則調(diào)用失敗，錯(cuò)誤信息存在于Error中。stringQueryClassifyByCode(stringcode)根據(jù)商品海關(guān)編碼，獲取商品信息（商品編碼、商品名稱、計(jì)量單位、法定單位等）入?yún)ⅲ篶ode為商品海關(guān)編碼返回結(jié)果采用JSON格式定義數(shù)據(jù)結(jié)構(gòu)如下：{"Result":true,"Data":[{"Code1":”Value1”,……"CodeN":”ValueN”}],"Error":["Error信息"]}Result為true則調(diào)用成功，有返回值則存在于Data中，無(wú)返回Data為空Result為false則調(diào)用失敗，錯(cuò)誤信息存在于Error中。stringQueryBrief(stringbriefCodeType,stringtradeCode)根據(jù)企業(yè)海關(guān)十位或者是組織機(jī)構(gòu)代碼返回企業(yè)名稱入?yún)ⅲ篵riefCodeType為企業(yè)編碼類型，tradeCode為企業(yè)編碼值企業(yè)編碼類型為B時(shí)，企業(yè)編碼值為海關(guān)十位；企業(yè)編碼類型為E時(shí)，企業(yè)編碼值為組織機(jī)構(gòu)代碼；企業(yè)編碼類型為S時(shí)，企業(yè)編碼值為統(tǒng)一社會(huì)信用代碼。返回結(jié)果采用JSON格式定義數(shù)據(jù)結(jié)構(gòu)如下：{"Result":true,"Data":["Data信息"],"Error":["Error信息"]}Result為true則調(diào)用成功，有返回值則存在于Data中，無(wú)返回Data為空Result為false則調(diào)用失敗，錯(cuò)誤信息存在于Error中。屬性說(shuō)明屬性名說(shuō)明stringBusinessType指定業(yè)務(wù)類型，業(yè)務(wù)類型參考業(yè)務(wù)模塊說(shuō)明stringOperateType指定操作類型，操作類型根據(jù)業(yè)務(wù)有所不同，具體參考相應(yīng)業(yè)務(wù)模塊說(shuō)明stringArgument單一窗口平臺(tái)調(diào)用Execute方法前傳入，Execute方法執(zhí)行時(shí)根據(jù)參數(shù)進(jìn)行相關(guān)業(yè)務(wù)處理Structure采用JSON格式定義數(shù)據(jù)結(jié)構(gòu)如下{"ArgumentData":{"ArgumentName1":"ArgumentValue","ArgumentName2":"ArgumentValue",}}stringResult返回接口調(diào)用結(jié)果返回結(jié)果采用JSON格式定義數(shù)據(jù)結(jié)構(gòu)如下{"ResultData":{"Result":true,"Data":["Data信息"],"Error":["Error信息"]}}Result為true則調(diào)用成功，有返回值則存在于Data中，無(wú)返回Data為空Result為false則調(diào)用失敗，錯(cuò)誤信息存在于Error中。stringBill傳入業(yè)務(wù)表單JSON實(shí)體對(duì)象，各業(yè)務(wù)JSON實(shí)體格式參考業(yè)務(wù)模塊介紹stringSenderID由分中心提供的分中心數(shù)據(jù)交換平臺(tái)用戶編號(hào)stringPlatfromID第三方平臺(tái)ID，數(shù)據(jù)中心提供stringPSignAddr第三方平臺(tái)身份認(rèn)證代理服務(wù)地址，第三方平臺(tái)提供stringPlatfromService第三方平臺(tái)用戶唯一標(biāo)識(shí)校驗(yàn)服務(wù)，第三方平臺(tái)提供stringUserId企業(yè)用戶臨時(shí)唯一編號(hào)stringLoginResult傳入登陸成功后的返回結(jié)果業(yè)務(wù)組件使用說(shuō)明B/S應(yīng)用使用步驟說(shuō)明開(kāi)發(fā)人員在業(yè)務(wù)表單提交的html或aspx的頁(yè)面中調(diào)用該組件。通過(guò)接口傳入認(rèn)證憑據(jù)通過(guò)接口傳入業(yè)務(wù)參數(shù)及表單數(shù)據(jù)調(diào)用業(yè)務(wù)組件功能方法完成業(yè)務(wù)數(shù)據(jù)申報(bào)C/S應(yīng)用使用步驟說(shuō)明為了不影響預(yù)錄入組件的自動(dòng)更新功能，業(yè)務(wù)組件需要采用Assembly.LoadFile方式加載，避免更新時(shí)文件被占用。由于采用通過(guò)動(dòng)態(tài)調(diào)用的方式調(diào)用預(yù)錄入組件，所以無(wú)需引用預(yù)錄入組件，調(diào)用方法參考使用7.附錄中的代碼。報(bào)關(guān)單業(yè)務(wù)模塊說(shuō)明具體參考以下文檔 《電子口岸單一窗口海關(guān)預(yù)錄入組件_開(kāi)發(fā)白皮書(shū)_報(bào)關(guān)單DEC》運(yùn)輸工具業(yè)務(wù)模塊說(shuō)明具體參考以下文檔 《電子口岸單一窗口海關(guān)預(yù)錄入組件_開(kāi)發(fā)白皮書(shū)_運(yùn)輸工具CDS》新艙單業(yè)務(wù)模塊說(shuō)明具體參考以下文檔 《電子口岸單一窗口海關(guān)預(yù)錄入組件_開(kāi)發(fā)白皮書(shū)_新艙單管理MFT》轉(zhuǎn)關(guān)單業(yè)務(wù)模塊說(shuō)明具體參考以下文檔 《電子口岸單一窗口海關(guān)預(yù)錄入組件_開(kāi)發(fā)白皮書(shū)_轉(zhuǎn)關(guān)單TRN》轉(zhuǎn)關(guān)運(yùn)抵報(bào)告業(yè)務(wù)模塊說(shuō)明具體參考以下文檔 《電子口岸單一窗口海關(guān)預(yù)錄入組件_開(kāi)發(fā)白皮書(shū)_轉(zhuǎn)關(guān)運(yùn)抵報(bào)告ETA》快件轉(zhuǎn)運(yùn)中心業(yè)務(wù)模塊說(shuō)明具體參考以下文檔 《電子口岸單一窗口海關(guān)預(yù)錄入組件_開(kāi)發(fā)白皮書(shū)_快件轉(zhuǎn)運(yùn)中心ete》新快件業(yè)務(wù)模塊說(shuō)明具體參考以下文檔 《電子口岸單一窗口海關(guān)預(yù)錄入組件_開(kāi)發(fā)白皮書(shū)_新快件NEXP》展覽品業(yè)務(wù)模塊說(shuō)明具體參考以下文檔 《電子口岸單一窗口海關(guān)預(yù)錄入組件_開(kāi)發(fā)白皮書(shū)_展覽品EXB》減免稅業(yè)務(wù)模塊說(shuō)明具體參考以下文檔 《電子口岸單一窗口海關(guān)預(yù)錄入組件_開(kāi)發(fā)白皮書(shū)_減免稅RED》公路運(yùn)輸工具業(yè)務(wù)模塊說(shuō)明具體參考以下文檔 《電子口岸單一窗口海關(guān)預(yù)錄入組件_開(kāi)發(fā)白皮書(shū)_公路運(yùn)輸工具RCDS9》公路艙單業(yè)務(wù)模塊說(shuō)明具體參考以下文檔 《電子口岸單一窗口海關(guān)預(yù)錄入組件_開(kāi)發(fā)白皮書(shū)_公路艙單RMFT9》稽查作業(yè)業(yè)務(wù)模塊說(shuō)明具體參考以下文檔 《電子口岸單一窗口海關(guān)預(yù)錄入組件_開(kāi)發(fā)白皮書(shū)_稽查作業(yè)JC2006》保稅貨物流轉(zhuǎn)業(yè)務(wù)模塊說(shuō)明具體參考以下文檔 《電子口岸單一窗口海關(guān)預(yù)錄入組件_開(kāi)發(fā)白皮書(shū)_保稅貨物流轉(zhuǎn)BHL》加工貿(mào)易電子手冊(cè)業(yè)務(wù)模塊說(shuō)明具體參考以下文檔 《電子口岸單一窗口海關(guān)預(yù)錄入組件_開(kāi)發(fā)白皮書(shū)_加工貿(mào)易PTS》新車輛證明書(shū)業(yè)務(wù)模塊說(shuō)明具體參考以下文檔 《電子口岸單一窗口海關(guān)預(yù)錄入組件_開(kāi)發(fā)白皮書(shū)_新車輛證明書(shū)NCIC》數(shù)據(jù)字段規(guī)范定義具體參考以下文檔《海關(guān)總署2014年70號(hào)公告附件3中華人民共和國(guó)海關(guān)進(jìn)出境航空器數(shù)據(jù)項(xiàng)填制規(guī)范》《海關(guān)總署2014年70號(hào)公告附件1中華人民共和國(guó)海關(guān)國(guó)際航行船舶數(shù)據(jù)項(xiàng)填制規(guī)范》平臺(tái)身份認(rèn)證服務(wù)封裝 第三方平臺(tái)的身份認(rèn)證說(shuō)明第三方平臺(tái)的身份認(rèn)證，數(shù)據(jù)中心會(huì)開(kāi)發(fā)一個(gè)“第三方平臺(tái)身份認(rèn)證服務(wù)”并部署在第三方平臺(tái)的安全服務(wù)器上。同時(shí)，第三方平臺(tái)要實(shí)現(xiàn)“第三方平臺(tái)身份認(rèn)證代理服務(wù)”模塊。第三方平臺(tái)身份認(rèn)證流程圖第三方平臺(tái)身份認(rèn)證流程說(shuō)明流程說(shuō)明：用戶登陸第三方平臺(tái)。（需第三方平臺(tái)實(shí)現(xiàn)）用戶登錄成功后，第三方平臺(tái)針對(duì)每個(gè)用戶生成并保存用戶臨時(shí)唯一編號(hào)（以下簡(jiǎn)稱該編號(hào)為UserID），將該UserID返回給客戶端。用戶登陸第三方平臺(tái)。（需第三方平臺(tái)實(shí)現(xiàn)）客戶端組件向第三方平臺(tái)身份認(rèn)證代理服務(wù)請(qǐng)求平臺(tái)身份認(rèn)證，并傳入U(xiǎn)serID作為參數(shù)。（需第三方平臺(tái)、預(yù)錄入組件實(shí)現(xiàn)）第三方平臺(tái)身份認(rèn)證代理服務(wù)向第三方平臺(tái)的應(yīng)用服務(wù)器驗(yàn)證UserID是否合法。用戶登陸第三方平臺(tái)。（需第三方平臺(tái)實(shí)現(xiàn)）第三方平臺(tái)身份認(rèn)證代理服務(wù)向第三方平臺(tái)身份認(rèn)證服務(wù)申請(qǐng)驗(yàn)證。用戶登陸第三方平臺(tái)。（需第三方平臺(tái)、預(yù)錄入組件實(shí)現(xiàn)）第三方平臺(tái)身份認(rèn)證服務(wù)向數(shù)據(jù)中心申請(qǐng)身份驗(yàn)證。（預(yù)錄入組件實(shí)現(xiàn)）將數(shù)據(jù)中心返回身份認(rèn)證結(jié)果返回給第三方平臺(tái)身份認(rèn)證服務(wù)。（預(yù)錄入組件實(shí)現(xiàn)）第三方平臺(tái)身份認(rèn)證服務(wù)將身份認(rèn)證結(jié)果返回給第三方平臺(tái)身份認(rèn)證代理服務(wù)。（需第三方平臺(tái)、預(yù)錄入組件實(shí)現(xiàn)）第三方平臺(tái)身份認(rèn)證代理服務(wù)將身份認(rèn)證結(jié)果返回給客戶端組件。（需第三方平臺(tái)、預(yù)錄入組件實(shí)現(xiàn)）平臺(tái)身份認(rèn)證服務(wù)程序包eport.SwcPlatSign-1.0-dev-版本號(hào).war服務(wù)功能第三方平臺(tái)身份認(rèn)證，獲得平臺(tái)簽名調(diào)用關(guān)系預(yù)錄入組件<>第三方平臺(tái)身份認(rèn)證代理服務(wù)<>第三方平臺(tái)身份認(rèn)證服務(wù)備注本程序由數(shù)據(jù)中心開(kāi)發(fā)，需要部署在第三方平臺(tái)上，部署詳情見(jiàn)《第三方平臺(tái)部署文檔》平臺(tái)身份認(rèn)證代理接口定義服務(wù)名swc.eport.PlatFormSignImpl服務(wù)功能第三方平臺(tái)身份認(rèn)證代理服務(wù)調(diào)用關(guān)系預(yù)錄入組件<>第三方平臺(tái)身份認(rèn)證代理服務(wù)<>第三方平臺(tái)身份認(rèn)證服務(wù)請(qǐng)求參數(shù)GetTicketRequest對(duì)應(yīng)XSDPlatForm.xsd響應(yīng)參數(shù)GetTicketResponse對(duì)應(yīng)XSDPlatForm.xsd備注該服務(wù)須由第三方平臺(tái)自行開(kāi)發(fā)數(shù)據(jù)中心提供了demo程序。具體配置請(qǐng)見(jiàn)《第三方平臺(tái)部署文檔》附錄B/S架構(gòu)代碼示例安全組件代碼示例需將以下代碼添加到單一窗口平臺(tái)入口頁(yè)面或登錄頁(yè)面，確保用戶進(jìn)入業(yè)務(wù)單據(jù)頁(yè)面之前訪問(wèn)本頁(yè)面進(jìn)行組件版本更新：<scripttype="text/javascript">//驗(yàn)證密碼，返回登陸結(jié)果functionLoginSys(){varr=document.getElementById("AutoUpdater").Login();document.getElementById("loginResult").value=r;alert(r);}//驗(yàn)證密碼，返回登陸結(jié)果functionLoginSysByPwd(){varr=document.getElementById("AutoUpdater").LoginByPwd("");document.getElementById("loginResult").value=r;alert(r);}//跳轉(zhuǎn)到業(yè)務(wù)表單填制界面functionGoToBusiness(){if(document.getElementById("loginResult").value.indexOf('"Result":true')>=0){window.navigate("Entry.aspx?LoginResult="+escape(document.getElementById("loginResult").value));}else{alert("登陸成功后再進(jìn)入");}}//獲得自動(dòng)更新?tīng)顟B(tài)functionGetUpdateStatus(){varr=document.getElementById("AutoUpdater").GetUpdateStatus();if(r!=null&&r!=""){ //輸出更新?tīng)顟B(tài)，實(shí)際應(yīng)用應(yīng)當(dāng)檢查更新?tīng)顟B(tài)，確保更新完成后再進(jìn)入其他頁(yè)面alert(r);}}</script><objectid="AutoUpdater"classid="clsid:E58B9A24-1F2D-4EE7-B18C-D2F151DF77F2"style="font-size:11px;width:300px;"height="25px"></object><!—以實(shí)際地址為準(zhǔn)，參考本文檔第3章--><ahref="/DownloaderPlatform/Eport.PreInput.Setup.AutoUpdate.msi">手動(dòng)安裝</a><inputtype="button"id="btnStatus"value="查看更新?tīng)顟B(tài)"onclick="GetUpdateStatus()"/><inputtype="button"id="btn1"value="驗(yàn)證密碼"onclick="LoginSys()"/> <inputtype="button"id="Button1"value="進(jìn)入報(bào)關(guān)單填制"onclick="GoToBusiness()"/> <inputtype="text"id="loginResult"style="display:none"/>代碼添加到頁(yè)面后IE瀏覽器打開(kāi)，如果更新組件未安裝會(huì)跳出提示，可以點(diǎn)擊“手動(dòng)安裝”下載進(jìn)行安裝，安裝步驟如下圖：1-1；1-2；1-3。安裝后刷新頁(yè)面將會(huì)在瀏覽器中看到IE自動(dòng)加載了自動(dòng)更新組件，同時(shí)自動(dòng)更新組件會(huì)檢查并更新。1-11-21-3報(bào)關(guān)單預(yù)錄入組件代碼示例將以下腳本代碼放置到報(bào)關(guān)單業(yè)務(wù)填制界面：<objectid="SWC"classid="clsid:B90439DC-03D4-45e9-89F7-991D4E9B16D2"style="font-size:11px;"></object>使用以下腳本對(duì)組件進(jìn)行控制操作：<scriptlanguage="javascript"type="text/javascript">functionSave(){ //獲取表單JSON數(shù)據(jù)varr=document.getElementById("SWC"); //指定業(yè)務(wù)類型 r.BusinessType="DEC"; //指定操作類型 r.OperateType="Save"; //指定操作類型 r.Argument='{"ArgumentData":{"CopMsgId":"12345678"}}'; //本例為空，實(shí)際使用時(shí)需要傳入JSON格式表單對(duì)象 r.Bill="";//傳入登陸界面返回的登陸信息 r.LoginResult="***************"; //發(fā)送方ID，填寫分中心申請(qǐng)的交換平臺(tái)ID r.SenderID="***************"; //第三方平臺(tái)ID，由數(shù)據(jù)中心分配，例如：SWC01000001 r.PlatfromID="***************"; //傳入用戶唯一標(biāo)識(shí),由企業(yè)應(yīng)用服務(wù)器生成，測(cè)試時(shí)可臨時(shí)賦值為任意值 r.UserID="***************"; //第三方平臺(tái)服務(wù)(用于驗(yàn)證用戶UserID，由第三方平臺(tái)部署和提供) r.PlatformService="http://***************/checkUserID?wsdl";//第三方平臺(tái)身份認(rèn)證代理服務(wù)r.PSignAddr="http://*********/PlatFormSign/getPlatTicket?wsdl"; //通知預(yù)錄入組件執(zhí)行操作r.Execute(); //輸出返回結(jié)果 alert(r.Result);}</script>頁(yè)面中增加以下腳本可以增加用戶操作互動(dòng)：<inputtype="button"id="btnDeclare"value="申報(bào)提交"onclick="Save()"/>空運(yùn)航線航空器備案申報(bào)代碼示例將以下腳本代碼放置到報(bào)關(guān)單業(yè)務(wù)填制界面：<objectid="SWC"classid="clsid:B90439DC-03D4-45e9-89F7-991D4E9B16D2"style="font-size:11px;"></object>使用以下腳本對(duì)組件進(jìn)行控制操作：<scriptlanguage="javascript"type="text/javascript">functionDeclare(){ //獲取表單JSON數(shù)據(jù)varr=document.getElementById("SWC"); //指定業(yè)務(wù)類型 r.BusinessType="CDS_CAM001"; //指定操作類型 r.OperateType="Declare"; //指定操作類型 r.Argument='{"ArgumentData":{"CopMsgId":"12345678"}}'; //本例為空，實(shí)際使用時(shí)需要傳入JSON格式表單對(duì)象 r.Bill="";//傳入登陸界面返回的登陸信息 r.LoginResult="***************"; //發(fā)送方ID，填寫分中心申請(qǐng)的交換平臺(tái)ID r.SenderID="***************"; //第三方平臺(tái)ID，由數(shù)據(jù)中心分配，例如：SWC01000001 r.PlatfromID="***************"; //傳入用戶唯一標(biāo)識(shí),由企業(yè)應(yīng)用服務(wù)器生成，測(cè)試時(shí)可臨時(shí)賦值為任意值 r.UserID="***************"; //第三方平臺(tái)服務(wù)(用于驗(yàn)證用戶UserID，由第三方平臺(tái)部署和提供) r.PlatformService="http://***************/checkUserID?wsdl";//第三方平臺(tái)身份認(rèn)證代理服務(wù)r.PSignAddr="http://*********/PlatFormSign/getPlatTicket?wsdl"; //通知預(yù)錄入組件執(zhí)行操作r.Execute(); //輸出返回結(jié)果 alert(r.Result);}</script>頁(yè)面中增加以下腳本可以增加用戶操作互動(dòng)：<inputtype="button"id="btnDeclare"value="申報(bào)提交"onclick="Declare()"/>C/S架構(gòu)代碼示例安全組件代碼示例組件內(nèi)部校驗(yàn)IC卡的調(diào)用方式頁(yè)面設(shè)計(jì)器Designer.cs代碼（autoUpdater1為安全組件控件名）：this.autoUpdater1=newEport.PreInput.AutoUpdater.AutoUpdater();this.autoUpdater1.AutoSize=true;this.autoUpdater1.Location=newSystem.Drawing.Point(18,25);this.autoUpdater1.Name="autoUpdater1";this.autoUpdater1.Size=newSystem.Drawing.Size(383,35);this.autoUpdater1.TabIndex=0;頁(yè)面后臺(tái).cs代碼///<summary>///驗(yàn)證密碼///</summary>///<paramname="sender"></param>///<paramname="e"></param>privatevoidbutton1_Click(objectsender,EventArgse){stringstrResult=autoUpdater1.Login();strCheckResult=strResult;MessageBox.Show(strResult);} 注:安全組件中所包含的方法說(shuō)明，請(qǐng)參考4.1安全組件接口說(shuō)明報(bào)關(guān)單預(yù)錄入組件代碼示例使用以下代碼對(duì)組件進(jìn)行動(dòng)態(tài)調(diào)用并控制操作，傳入的參數(shù)值參