1、附件2跨境電子商務進口統一版信息化系統客戶端軟件使用手冊目錄1文檔概述41.1編寫目的41.2用戶對象41.3系統概述41.4術語定義42運行環境53軟件安裝說明53.1Windows下安裝53.1.1基礎安裝解壓客戶端壓縮包啟動客戶端63.1.2注冊服務73.2Linux下安裝83.2.1基礎安裝解壓客戶端壓縮包啟動客戶端83.2.2注冊服務104企業接入準備105系統登錄指南106系統操作指南116.1系統監控116.2配置管理126.2.1基本信息管理企業對接配置連接協議配置146.2.1

2、.3傳輸安全配置166.2.2對接配置管理186.2.3數據導入服務186.3運維管理206.3.1數據落地管理206.3.2報文異常管理216.3.3報文阻塞管理227運行與維護237.1日常維護237.2常見問題處理231 文檔概述1.1 編寫目的主要為跨境電商相關企業提供跨境電子商務進口統一版信息化系統客戶端軟件（以下簡稱客戶端軟件）正確的安裝說明以及系統操作說明。 1.2 用戶對象跨境電商相關企業用戶，如電商平臺、電商企業、物流企業、支付企業、倉儲企業、報關企業等。1.3 系統概述客戶端軟件輔助跨境電商相關企業按照跨境電子商務進口統一版信息化系統企業對接報文規范（試行）與跨境電子商務進

3、口統一版信息化系統進行數據傳輸，實現訂單、運單、支付單、清單等單證信息自動化處理或通過EXCEL格式文件半自動化處理。客戶端可在企業授權的情況下進行報文的加簽自動化處理。并提供數據發送和接收查詢功能。1.4 術語定義序號縮略語名稱術語全稱定義說明1應用傳輸協議應用傳輸協議（Communications Protocol）是指計算機通信的共同語言。本文中泛指AS2（上行）+AS3（下行），IBMMQ，Toprow MQ(華盛信泰消息中間件)，RabbitMQ多種方式傳輸協議的統稱。2數據傳輸報文數據傳輸報文數據傳輸是指在數據源和數據宿之間傳輸數據的過程，也稱數據通信。數據是指能夠由計算機處理的數

4、字、字母和符號等，它是信息的一種載體，數據是信息傳輸的一種形式，主要指與計算機有關的信息傳輸。數據傳輸報文在本文是指用于存放數據傳輸數據的載體文件的泛稱。3數據格式數據格式本文指數據傳輸報文的文件類型，主要指XML、EXCEL等數據格式。4數據格式轉換數據格式轉換從一種數據格式轉換成另外一種數據格式的過程。5節點節點在網絡拓撲中，網絡任何支路的終端或網絡中兩個或更多支中的互連公共點。2 運行環境類別最低配置推薦配置應用服務器CPU2.0GHZ*4核3.0GHZ *8核內存4G以上8G以上硬盤500G500G以上RAID其他百兆帶寬百兆帶寬以上軟件操作系統Linux/Unix/Windows s

5、erver2003及以上版本3 軟件安裝說明3.1 Windows下安裝3.1.1 基礎安裝 解壓客戶端壓縮包將跨境電子商務進口統一版信息化系統客戶端軟件安裝壓縮包：“WINDOWS_IMPORTS_CLIENT_V1.0.0.zip”解壓至跨境電商相關企業服務器的某硬盤路徑下，具體路徑跨境電商相關企業可自行定義，例如：C:Data。如下圖所示： 啟動客戶端1. 進入Client目錄，執行startup.bat文件，如下圖所示：2、系統自動在/Client/Config/ASEUser.xml文件中生成授權申請碼，授權碼位于ASEUser.xml文件<appl

6、yCode>節點中，如下圖所示：3、跨境電商相關企業將授權申請碼發送至 kj（郵箱地址），郵件主題為XXX企業客戶端授權申請，郵件正文錄入格式如下圖所示：郵件內容審核通過后管理員將ASE_License.ase（授權文件）發送給跨境電商相關企業，跨境電商相關企業收到ASE_License.ase （授權文件）文件后，將該文件放置在Client所在根目錄下，系統自動進行授權認證并完成程序啟動。如下圖所示：3.1.2 注冊服務以管理員方式運行installService.bat文件。如下圖所示：3.2 Linux下安裝3.2.1 基礎安裝 解壓客戶端壓縮包將客戶端軟件安裝壓縮包

7、“LINUX_IMPORTS_CLIENT_V1.0.0.zip”解壓至用戶自身home目錄路徑下，例如：#tar zxvf / LINUX_IMPORTS_CLIENT_V1.0.0.zip -C /Data     啟動客戶端1. 進入Client目錄下，執行startup.sh文件，如下圖所示：2、系統自動在/Client/Config/ASEUser.xml文件中生成授權申請碼，授權碼位于ASEUser.xml文件<applyCode>節點中，如下圖所示：3、跨境電商相關企業將授權申請碼發送至 kj（郵箱地址），郵件主題為XXX企業客戶端授

8、權申請，郵件正文錄入格式如下圖所示：審核通過后，管理員將ASE_License.ase（授權文件）發送給跨境電商相關企業，跨境電商相關企業收到ASE_License.ase（授權文件） 文件后，將該文件放置在Client目錄下，系統自動進行授權認證并完成程序啟動。如下圖所示：3.2.2 注冊服務以管理員方式運行registInstall.sh文件，進行注冊服務。4 企業接入準備企業傳輸編號（DXPID）向屬地海關數據分中心申請傳輸協議配置信息企業根據自身業務量情況向屬地海關數據分中心申請適合的接入配置（MQ或AS2/AS3相關配置信息）IC卡或Ukey申請向屬地海關數據分中心申請5 系統登錄指

9、南一、 功能介紹用戶在使用系統前需要先登錄系統。二、 操作流程1、在瀏覽器(Chrome或Firefox)中輸入系統地址http:/localhost:9091/console，輸入正確密碼（默認密碼88888888），點擊登錄進入系統登錄頁面6 系統操作指南6.1 系統監控一、 功能介紹跨境電商相關企業在系統監控查看到當前接收數據數量、發送數據數量、接收數據容量、發送數據容量、當前數據監控、流量監控以及系統監控。二、 操作流程1、用戶在主菜單欄中選擇系統監控即可進入系統監控界面，如下圖所示：6.2 配置管理6.2.1 基本信息管理一、 功能介紹基本信息管理包括企業對接配置、連接協議配置、傳輸

10、安全配置三個模塊。為跨境電商相關企業提供錄入對接配置基本信息、連接配置協議信息以及傳輸安全配置信息。二、 操作流程1、用戶在主菜單欄中選擇配置管理下的基本信息管理，即可進入基本信息管理界面，如下圖所示： 企業對接配置一、 功能介紹跨境電商相關企業能夠進行對接配置基本信息錄入，可進行高級選項錄入包括傳輸接收編號、報文發送路徑、報文接收路徑、異?；貓搪窂降葍热?。二、 操作流程1、用戶在主菜單欄中選擇配置管理下的基本信息管理，即可進入基本信息管理界面，在基本信息管理界面錄入跨境電商相關企業對接配置信息，如下圖所示：2、跨境電商相關企業錄入完成跨境電商相關企業對接配置信息后，點擊高級按

11、鈕進行信息錄入,如下圖所示： 連接協議配置一、 功能介紹連接協議配置包括Rabbit MQ協議配置、IBM MQ或Toprow MQ協議配置和AS2/AS3等協議配置模塊，企業用戶根據需要自行選擇要使用的協議進行配置。二、 操作流程1、用戶在主菜單欄中選擇配置管理下的基本信息管理，即可進入基本信息管理界面，在基本信息管理界面選擇要使用的連接協議配置進行配置，如下圖所示：Ø Rabbit MQ協議配置（推薦量級：>5000票/天；>100票/分；<4096KB/票）Ø IBM MQ或Toprow MQ協議配置（推薦量級：>5000票/天；

12、>100票/分；<4096KB/票）Ø AS2/AS3協議配置（推薦量級：<5000票/天；<100票/分；<1024KB/票） 傳輸安全配置一、 功能介紹傳輸安全配置用于IC卡/USBKEY設備的配置，用戶需同意并授權客戶端使用安全設備服務后才可以進行加簽操作。二、 操作流程1、用戶在主菜單欄中選擇配置管理下的基本信息管理，即可進入基本信息管理界面，在基本信息管理界面選擇要使用的安全配置進行配置，如下圖所示：Ø IC卡/USBKey安全配置1、用戶在錄入完UKEY密碼后，在選擇加簽選項時（加業務簽、加傳輸簽），系統會提示用戶是否

13、同意授權客戶端使用安全設備服務，用戶點擊同意按鈕，客戶端進行加簽處理，用戶點擊取消按鈕，客戶端取消當前加簽操作。如下圖所示。2、跨境電商相關企業錄入完成全部基本信息后，點擊右下角保存按鈕，系統將保存已填寫好的基本信息。6.2.2 對接配置管理一、 功能介紹用于跨境電商相關企業當前已配置資源查詢并可啟動或停止當前監聽資源。二、 操作流程1、用戶在主菜單欄中選擇配置管理下的對接配置管理，即可進入對接配置管理界面，系統根據查詢條件顯示監聽資源配置信息，如下圖所示：2、用戶能夠選擇具體資源配置信息，點擊啟動按鈕，啟動當前配置資源，或點擊全部開始按鈕，全部啟動當前配置資源。3、用戶能夠選擇具體資源配置信

14、息，點擊停止按鈕，停止當前配置資源，或點擊全部停止按鈕，全部停止當前配置資源6.2.3 數據導入服務一、 功能介紹將跨境電商相關企業需發送的EXCLE文件轉換成業務報文進行傳輸,同時提供EXCLE模板下載。二、 操作流程1、用戶在主菜單欄中選擇配置管理下的數據導入服務，即可進入數據導入服務界面，如下圖所示：2、在數據導入服務界面選擇下載EXCLE模板，將EXCLE模板下載至本地。3、 用戶將EXCLE模板進行解壓操作，如下圖所示：4、用戶填寫完成EXCLE文件，點擊上傳按鈕，將填寫完成的EXCLE文件上傳至系統。用戶上傳完成EXCLE文件，系統將跨境電商相關企業上傳的EXCLE文件轉換成XML

15、文件進行傳輸。如下圖所示：6.3 運維管理6.3.1 數據落地管理一、 功能介紹在數據落地查詢模塊下，能對落地數據進行查詢操作。企業可以根據發送時間，接收時間，報文編號，報文名稱等條件，清晰查看到系統傳輸報文。并能對正常或異常數據報文進行重發操作。二、 操作流程1、用戶在主菜單欄中選擇運維管理下的數據落地管理，即可進入數據落地管理界面，如下圖所示：2、用戶可選擇正?；虍惓祿笪狞c擊重發按鈕進行重發操作6.3.2 報文異常管理一、 功能介紹系統異常管理分為系統異常和阻塞異常，系統管理員可以根據異常時間范圍，線程名稱，和異常信息等條件進行檢索查詢，即可清晰了解到當前系統出現的問題的原因。二、 操

16、作流程1、用戶在主菜單欄中選擇運維管理下的報文異常管理，即可進入報文異常管理界面，如下圖所示：6.3.3 報文阻塞管理一、 功能介紹系統異常管理分為系統異常和阻塞異常，系統管理員可以根據異常時間范圍，線程名稱，和異常信息等條件進行檢索查詢，即可清晰了解到當前系統出現的問題的原因。二、 操作流程1、用戶在主菜單欄中選擇運維管理下的報文阻塞管理，即可進入報文阻塞管理界面，如下圖所示：7 運行與維護7.1 日常維護工作范圍：1、網絡維護檢查客戶端軟件的各個組成部分的網絡狀況，保證網絡的連接正常，網卡的使用正常。2、設備維護硬件維護：保證客戶端軟件使用的服務器的硬件環境運轉正常。軟件維護：保證操作系統，運行軟件（IBM MQ或Toprow MQ）及其他附屬軟件的運行正常。檢查個服務器軟件所需硬盤余量，監控磁盤空間，數據庫空間，inode空間等。3、客戶端維護確?？缇畴娮由虅者M口統一版信息化系統客戶端軟件正常運轉。7.2 常見問題處理針對常見問題列出了如下處理方式：事件預防措施處理客戶端操作系統斷電安裝UPS接電后系統支持自動重新啟動功能，如果未啟動可以人工快速介入啟動相關系統，并且系統擁有重發機制，可以重發由于斷電等災難引起的未處理報文。系統日志中發現IC卡/USB