跨境电子商务进口统一版信息化系统客户端软件使用手册.docx

《跨境电子商务进口统一版信息化系统客户端软件使用手册.docx》由会员分享，可在线阅读，更多相关《跨境电子商务进口统一版信息化系统客户端软件使用手册.docx（25页珍藏版）》请在三一文库上搜索。

1、附件 2跨境电子商务进口统一版信息化系统客户端软件使用手册目录1 文档概述 41.1 编写目的 41.2 用户对象 41.3 系统概述 41.4 术语定义 42 运行环境 53 软件安装说明 53.1 Windows 下安装 53.1.1 基础安装 53.1.1.1 解压客户端压缩包 53.1.1.2 启动客户端 63.1.2 注册服务 73.2 Linux下安装 83.2.1 基础安装 83.2.1.1 解压客户端压缩包 83.2.1.2 启动客户端 83.2.2 注册服务 104 企业接入准备 105 系统登录指南 106 系统操作指南 116.1 系统监控 116.2 配置管理 126.

2、2.1 基本信息管理 126.2.1.1 企业对接配置 136.2.1.2 连接协议配置 146.2.1.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 用户对象跨境电商相关企业用户，如电商平台、电商企业、物流企业、支付企业、仓

3、 储企业、报关企业等。1.3 系统概述客户端软件辅助跨境电商相关企业按照 跨境电子商务进口统一版信息化系 统企业对接报文规范（试行）与跨境电子商务进口统一版信息化系统进行数据 传输，实现订单、运单、支付单、清单等单证信息自动化处理或通过EXCE旅式文件半自动化处理。客户端可在企业授权的情况下进行报文的加签自动化处理。 并提供数据发送和接收查询功能。1.4 术语定义序号缩略语名称术语全称定义说明1应用传输协议应用传输协议(CommunicationsProtocol )是指计算机通信的共同语言。本文中泛指AS2（上行）+AS3（下行），IBMMQ Toprow MQ华盛信泰消息中间件），Rabb

4、itMQ多种 方式传输协议的统称。2数据传输报文数据传输报文数据传输是指在数据源和数据宿之间传输数据的过程，也称数据通信。数据是指 能够由计算机处理的数字、字母和符号等，它是信息的一种载体，数据是信息传输的一种形式，主要指与计算机有关的信 息传输。数据传输报文在本文是指用于存放数据传输数据的载体文件的泛称。3数据格式数据格式本文指数据传输报文的文件类型，主要指XML EXCE牌数据格式。4数据格式转换数据格式转换从一种数据格式转换成另外一种数据格 式的过程。5节点节点在网络拓扑中，网络任何支路的终端或网 络中两个或更多支中的互连公共点。2运行环境类别最低配置推荐配置CPU2.0GHZ*4 核3

5、.0GHZ *8 核应用内存4G以上8G以上服务器硬盘500G500G以上 RAID其他百兆带宽百兆带宽以上软件操作系统Linux/Unix/Windows server2003及以上版本3软件安装说明3.1 Windows 下安装3.1.1 基础安装3.1.1.1 解压客户端压缩包将跨境电子商务进口统一版信息化系统客户端软件安装压缩包:“WINDOWS_IMPORTS_CLIENT_V1.0.0:zip解压至跨境电商相关企业服务器的某硬盘路径下，具体路径跨境电商相关企业可自行定义，例如：C:Data 。如下图所示：第OientJzrra：号卓志三蟆iE匚塾书彳导工踏碧户瞄I嚓更于5艇映港大小

6、2016/5/30 9:11S43?2016/9/30 9:12为4妥2016/13,10:37 Miimsoft 趾 rd., 2,735 KB3.1.1.2 启动客户端1 .进入Client目录，执行startup.bat 文件，如下图所示:ine：；：7：Detected. FspanseBoA-ivii向自 10n in jsowA：ivi;.f.CPboot INFO 201S-0&-15 17:55:55 jmItii o, s. w, ah. AbstractlfrlHandlerlapping. regiawrHindier (line：341) ： Rapped URL pa

7、tl/*/f4vicGTL ico onto huidlBT of cl&ss 口上占 isprir蜡tEMmrark. mb后囱rvl.t七0犀口1疝 Rsscur七也巨1中强甘伸与曲融地rboot INFO2016-OS-1517:65:55 ioftiii iQ.f.c. ul 1. s. SLf 4jLog.info (line： 44) ：Flyway 3.2.1 by Boxfuseboat INFO12016-08-1517：55：55 miij a.f.c. L ul 1. s. Slf ijiLoig.infc(linB： 44)J ：Da.tabaafi： jdbc：h2：

8、filB：. /a h2/asedb(H2:boot INFO2016-08-1517:55:55 nin c.f.c. i.u 1. s. SLfijLaf；.info(lino：44) ：Validated 2 idgratiionrK (eKocutim tins(:00.016s)lact INFO2016-G8-1517155:55 Lnnain o-f-c. i.il 1. s, SlfiJLog.infatline：44)J ：Creating lEtadata table： FUBOC二匚heibeet INFO2016-03-1517:55:551 Liwin o.f.e,

9、1. s. Slf4jLog.info (lime: 44) ：Currsnt ?eTtion of schenm FUELIClIgty Seh&ma bct Itffo 2016-06-15- 17： 55： 55郁瓜f. 0 Ln 1.龈 Slf4JLDS ihfoClijMi：44) ： y芹cheitH PUBLIC* to iart 1 -R2 INIT 20KQ401bwtl INFO 2C16-08-15 17：55：S5jMiinl c. f. c. Lu. 1. s. SL4jLoc. info (line： 44)1 ： ligiBtinc schna TUBLIC- t

10、s version 1.：-匿 INIT 30160621ibj Successfuliy applied 2 cnifrati ons to sc； eiKi PUBLIC (executian time CKJ：flQt ISOs).iwot I1F0 2016-G3-15 17:55:56(sfiini q. LDdxsctJDKLog. lQ&(lins：30) :? Initialising PcvtocalHandlfiT http-nio-W 的口bMt INFO 2016-G8-15 17:55:56 DmIh o. t. j. l.DlreclJnlLos- 1os(11m:

11、180) :? StsrtLnf ProtocnlHinrlLar ”“印位上醺的:cxit INFO 2016-08-15 17:55:56 (nnxnl j-1 l Direct JDKLog. iDdirue ： 1SD) ： LTsiixg a sharad sei actor for s an? let writ92 adboat IWO 2C16-GS-15 17;55：56 min o. s. b.c.ai t. TatmcatEflbgdd&dServletCDntiinar. start(liiw： 162) ： Tamcit started cmpftrr(s) j 909

12、9 (hlip)L&oo tJ EllffOl 2016_00-15- 17:55:58Ina ina l+ * 生4 &- En5sowar Eetvi ce,oConf i gKM (Hiw ： 140) 1 -、认证 ,已生成援枳申请错，请授根！2、系统自动在/Client/Config/ASEUser.xml文件中生成授权申请码，授权码位于ASEUser.xml文件applyCode节点中，如下图所示：2016-0B-29 17：27:ll3、跨境电商相关企业将授权申请码发送至（邮箱地址），邮件主题为XXX企业客户端授权申请，邮件正文录入格式如下图所示:口*科0:企业名称：逢鱼裳度人含

13、际：企也联惠人电话：接校装脸色即州:泣J邮件内容审核通过后管理员将ASE_License.ase （授权文件）发送给跨境电 商相关企业，跨境电商相关企业收到 ASE_License.ase （授权文件）文件后， 将该文件放置在Client所在根目录下，系统自动进行授权认证并完成程序启动。 如下图所示：Wrows jtva. Itns. Excoptionboot IMFOH2016-08-15 17:56： 37 nain d- a w- s. h. Ab5trattlfrlHandlerlap)：4rL(. r&gitErHarLdler(ine:341) : Napped URL path

14、C/TObjara/* anta hmdltr of typa (class ore. springframswurk. wb. sirrvl9t., rtsDurcBi RuourcsHttplteciutstHMiidlftrboot (INFO 12016-08*15 17:56；37lniain d- S-W- s. K AJr-straetllrlHandlerl.appisir. retisterHandler(line：34J) lipped URL path(/* onto handler of type class arg. springfrawcirk, web, serv

15、let.,ResourcBHtlpfUitiuestHwdlerjboot IMP01 20160815 17*56*381 ctain .见诩与小他 a. Excp tichHandlicptionRsolver. ini.tEjrc即七i onHandlerAdvi匚4line：21)： Detected ResponseBodyAdvice i嚅lementti匚m in jsonpAdvieeAopbaqt INFO 2O1&-0815 17;56z38 MitdlQ.乱 w m h* AbtractlhlHandlTHippin(, r&sisterHaindler(1 091341

16、) : ) lapp$d URL patl/*/faviGC(n. ico onto handler of type class org. sprinsiTMOBwark. veb. swvletBnsoiirc&.RaouTCflBttReqRjestHaridlerboot JMFO 2016-08-15 17 ： S6 ： 3SJ rrain cl f. C- i- Ui L % Slf4jLcg. info (1 in&： 44) ： Flyway & 3 1 by flozfuseboot INPO 2016-08-15 17:56:2 mih o. f. c. i. ll 1. s

17、. SlfijLcc. info(lii：44) : Database： jdbc：h2：fi 1 e:. h2/asdb (H2 1 b4)bootINFO2016-08-15 D :00.018s)bootIMFO2016-08-15boatINFO2016-08-15kan necessary.EbaatINFO2016-08-15 桃boatIMFO2016-08-1517:56： 42 nainHo. f. e. i. u, 1. s. Sif4jLci, info (line-： 44) ： Validated 2 migrations (eiecution tire C17:56

18、:42 bkainJCo. f. c. i. u, 1. s. Slf4jLcign info (Lin#： 44) ： Currant v-arsion of scheona PUBLIC： L 2175642)nain a- f- c. i- ll L e- Slf4jLag. info(l ihe ： 44) ： Schaum PUBLIC is 呼 to date. No migra*1756： 43 nain a- i- j-1- DirectJDKLag- lag (line： 130) ： Initializing FtotdcolHandler http-nia-0C17J 5

19、6 ： 43 riiain oa a- ja L Dire Starting Frotd:olHandler http-niO-9099boot INFO 2018-08-15 171.56i43minj ck tu j. 1. DirectJDKLa log(lins-: ISO) : Using a har&d SBlector lor servlet wri radbootINFO 2O10Q815 17：5&：43 LminHoT-瓦匕 d t. ToeK/tEfityBddSrvlatContain自工一耳Ste (lima： 162) ： Tot started g port(s)

20、: 9099 (http)bQQt I INFO 2016-Q8-15 17 ! 5647 naih c- b- a- - S a- Erap wrSrv i i i ent Author ize d (1 ine - 62)- 认证授权.成功bDDt INFO(2016-08-15 17:56 ； 47 CouinJ c. b. a. a. s. . EnpcmrSfirvic*. i ivntAuthori.ztd(1 im:63)： 噩权日期2016-08-11 16:31:12P 到期日期:2019-08-27 16:31:12bootMlNFOl 20)6-08-15 17:56t4

21、7 MinJCo. e. b. StartypInfoLoMer. lcc.Stutttd(lin&:57) ： Started Allain in 15. 575 sscondi3.1.2 注册服务以管理员方式运行installService.bat 文件。如下图所示:isetongService朋务已经启动成功.请按任意植被领一.3.2 Linux下安装3.2.1 基础安装3.2.1.1 解压客户端压缩包将客户端软件安装压缩包 LINUX_IMPORTS_CLIENT_V1O0.zip解压至用户自身home目录路径下，例如：#tar zxvf / LINUX_IMPORTS_CLIENT_

22、V1.0.0.zip -C /Data3.2.1.2 启动客户端1 .进入Client目录下，执行startup.sh 文件，如下图所示：1 Lne：271)l ： Detected；e irapieinerjt.iT.ion in Jsr-r Ad-iplnre(isrerHandLr(.1 lus:341) : lapped URL pat) ico on.to hnndler of typs cIibb BpringfTawvcrk vebb MTrle+ncsuurcB. KsBQumHttpRflquflsiHaridlBTboat IlfO 2016-08-15 17：5S：55

23、nin o. t. e. i.il Slf4jLog. inf a (Lina： 44) ： Klyway 3. 2. 1 by Be if use?bcat INFOJ 2016-08- L5 17:55:55 zai nJ ot i. c L i L u, 1. s. S1 f 4j Log. inf oil ine ： 44) ： Database： ：dbc ：h2： f il d ： / hC/asedb (H2 , .4)boot UFO 2015-08-L5 17;55;55 iaina. f. c. l.u. Ls. SliljLo. iniG(lin&;44) ; Valid

24、ated 2 EdtrdtiortB (eiBcution tlm ( l:00h 016s(bwt IWO 2016-DS-15 17:55:55 nirja. f. c. i.u.lrs; SlfliLog. infa(lin：44) Crsating Istadata table： TUBUC.昭第 s_verslnnboat llfOJ L2016-08-15 17：55：55J nin Fak I. c. Lu.l.s.SlfljLoc. into (line： 44) J ： Currant wiion of schHM *FWLIC： Impty Schema (boot IW

25、2016-08-15 17:55:! mainJtor fr o. Lu. .s.Slf4jLDg, infQ(Hn?:44) : ligratinfi 9cIkah “PUBLIC* tn version L：-H2 IHIT 20160401(boot IliFO 2016-03-15 1?：55：55 Mini o- cL Lux Ls. Slf4jLo(. inf(line：44)1limtinc schema *PUBLIC* to Kiion L；-H2 INIT 20160621,bboot IHFOJ 2016-OS- L5 17:55:55 min o. . c. i, u,

26、 1, s. Slf4jLoj. info line；4i) ： Su Initialising PratocDl Handl er http-niu-9； mTboot ilFO 2015-03-15 17：55：56j nain lo. . j. 1. DiictJDftLog. lag(liiH： ISO) ： Starting PtqIocq Handl sr http-ni q-9099：boot llffO 2016-0E-15 17：55：56 iuirj f. a. j. 1L Dite Using a Ehared eeIactor for serrlet write rea

27、d.1 - jd - lliU j. 2010 .Z l 17： 55 ： 5j f;.ii j n u. s. h. . t. l. Tun. .itLr:l11 7u：.l dit.i-r. ；, ：u J (.1 i：n- z 1G2 1 T i. :.i d l ,一1七.Djjort(s): 9099 (http):卜 “f I ,於 T： L：J：八 |；”产，17；E $ mirlHj t.-1. ；，-，4. ?研.； fk-loi r.fL-X：i i i At? ： 1-fl)：殍抬,：寸 / :口 ：已生成授权申请码，清覆板！2、系统自动在/Client/Config/A

28、SEUser.xml文件中生成授权申请码，授权码位于ASEUser.xml文件节点中，如下图所示： authlnfot:5 994 6 f 1 f e Dd f a a 3 ab2 93c 92 la2 9 4 7 a5 j：; appl Kc de 2016-08-?3 17： 27 tll3、跨境电商相关企业将授权申请码发送至(邮箱地址)，邮件主题为XXX企业客户端授权申请，邮件正文录入格式如下图所示：3fpm位翌名称；企业粽案乂合甑；企业联系人电话：审核通过后，管理员将ASE_License.ase （授权文件）发送给跨境电商相关 企业，跨境电商相关企业收到 ASE_License.as

29、e （授权文件） 文件后，将该文 件放置在Client目录下，系统自动进行授权认证并完成程序启动。 如下图所示:(boot I IWO 2016-08-15 17: S6:37 nain,1 oB 6,明5.h. Afas tr ac tUr 1 Hindi erl3|)：4 n(. r &g i st e rHandl Er(linei：341):URL pathC/TObjara/* antci Ihumdlvr of typa class org. g;pinfrBmg：rk,固eb,自&Evletrrfifour.R#RourcBHt5RqM.tHaiidlilfbaot INFO 2

30、0608，15 17:56:37 lnain o- S-W- e- K AJtstractlfrlHandlerl.appisir. rB(,isteTHandle-r(line:34J) ： Happed URL path /* caito handler of type class erg- spring framework, web, servlet, r&soikt l.h, Ret-jiix ceHtlpRaqu>JIandlerlJ卜 H ： NH 11 !1 l：k i ： ； ：!. 1 ： , 1 : ； n-t i r. 一三.：.-m. n. .- -r- + ip-

31、rHr , i i r.? h：- ver. j.nitfcppti DTiHandlFrAdvi cliche flline：2?U：) Detecl&d ResponseBodyAdvice im&lenentAtioTL in jscmpAdviceAopbootINFO(2016-08-1B /favicon, icc ontoboatIMPO2016-03-15boatINFO2016-08-1&baatINFO2016-08-15MOE DLSs)17： 56 :38 Ifnin fa- 三h_ AtjEtrictUrlHandlerBipy i herefi sterHandl

32、er(1 ine .J41) ： I!apped URL pathhandler of type class ore. spring framework, web. servlets re 3ourceP R&3ourceHttpRe 17:56：( Iminjio. f. c. L ll 1, s. Slf4jLog. info kline; 44)17:56:42 nainJIo. f. e. i. il 1. s. Slf4jLo info (line： 44):bootINFO2016-08-15bootINFO2016-0S-1517:56:42 jxai n o- f- a i.

33、a 1. s. Slf4jLo. info (line： 44)：17： 56： 42 gin cl f. j L ill L 曰 Slf4jLag. info(l ine： 44)： QLOTi necessary.boot INFE3 2016-03-1517 56 ：4,3 niain i. Ju L DirectJDKLogu log (line： 130)：boatINFO2016-08-1517156 ： 43 niain o. a. ja L DireFlyway X 2P 1 by BgxfussDatabase： jdbc：h2：file：./.h2/asedb (H2 1V

34、alidated 2 migrations (eiecution tire LCurrent version of scheira PUBLIC“： 1. 2Echeg PUBLIC is 呼 to date. Nom .弓 ra iInitialLziDE PrntdcoiHamdler http*nia-9CSt art ing Fra tDCDlHandl er ,http-ni d-9099 bODr. INFO 2016 LC ,15 17： 56：4Z cuiirJ 1g. a. j. 1, DiractJDKLof. 1 .g (line： 180 ： . Us1* j :正工匕

35、，=1 匕二tDr for servlet zriteMot INFO 2Q10-Q8-15 17z6l43j Inai nJ la. b. c. e. t. TataucatEnt-BddsdSarVl etCDotaih&Tu VI 12) 1 Tdbtt farted dn tori (s); 9099 Chtfp)INFOIT; 56;4? mini匚 b. a. 5-君-a. E即口wr鸵tviwe. Kli即SuEhotiNedtli便:似):认证授权成功baatlINFO(2D 16-03-15 17:56:47inin(c.b. . EtnHrSirvic*. i.BClian

36、tAuthDrtxtd(linv：63)j :2016-08-LI 1a：31:12.判期Ei 朗：2019 8-27 16131:12(Koat HffOl 2016-08-15 17:56:47 ntinjo. s.b. StirtupInfoLor. IncStirtAddin*:?) Startsd Appliin in 15. 575 sscondi3.2.2 注册服务以管理员方式运行registInstall.sh 文件，进行注册服务4企业接入准备企业传输编号（DXPID）向属地海关数据分中心申请传输协议配置信息企业根据自身业务量情况向属地海关数据分中心申请 适合的接入配置（MQQ

37、 AS2/AS3相关配置信息）IC卡或Ukey申请向属地海关数据分中心申请5系统登录指南一、 功能介绍用户在使用系统前需要先登录系统二、操作流程1、在浏览器（ChromedFirefox）中输入系统地址 http:/localhost:9091/con sole ,输入正确密码（默认密码88888888）,点击登录进入系统登录页面露靖电子那省道口组一国KHIH集誓/AH蝌管理控制台6系统操作指南6.1 系统监控1、 功能介绍跨境电商相关企业在系统监控查看到当前接收数据数量、发送数据数量、接收数据容量、发送数据容量、当前数据监控、流量监控以及系统监控。2、 操作流程1、用户在主菜单栏中选择汽统监

38、控即时进入系时监控界加,如下图所示：a累敏控白曲跖孙-送“力SHIN M三囱富6.2 配置管理6.2.1 基本信息管理1、 功能介绍基本信息管理包括企业对接配置、连接协议配置、传输安全配置三个模块。为跨境电商相关企业提供录入对接配置基本信息、连接配置协议信息以及传输安全配置信息。2、 操作流程1、用户在主菜单栏中选择眦置管理K的基卡信息管理，W可进入基本小 息管理出面,如下图所示：6.2.1.1 企业对接配置1、 功能介绍跨境电商相关企业能够进行对接配置基本信息录入， 可进行高级选项录入包 括传输接收编号、报文发送路径、报文接收路径、异常回执路径等内容。2、 操作流程1、用户在主菜单栏中选择配

39、置管理下的基本信息管理，即可进入基本信息管理界面，在基本信息管理界面录入跨境电商相关企业对接配置信息，如下图所示：企业对接配置DXRXOODD1连接协议配置HM MQE Tcfpw MQ QeCKLSRF 走r .二 IW3 号，2、跨境电商相关企业录入完成跨境电商相关企业对接配置信息后，点击高级按钮进行信息录入，如下图所示:a荔翔在控叵堆管理OXPEDCCE&OCO0DO2匚:/dn 间 xnd北kS3寻,c:/daTa/reccrkffEdaLq/recEipt日工钓石灯1用.占.维6.2.1.2连接协议配置功能介绍连接协议配置包括Rabbit MQ协议配置、旧M MQ Toprow MQ

40、协议配置和AS2/AS彝协议配置模块，企业用户根据需要自行选择要使用的协议进行配置。操作流程1、用户在主菜单栏中选择配置管理下的基本信息管理，即可进入基本信息色吁面,在基本信息管理界面选择要使用的连接协议配置进行配置,如下图所示：Rabbit MQ协议配置（推荐量级：500腺/天；100M/分；4096KB/票）IBM MQ Toprow MO议配置（推荐量级:票）5000M/天；100g/分；4096KB/AS2/AS新议配置 什t荐量级：5000票/天；100M/分；1024KB/g）更接协议配亘lM 瓜：先11口41嗓IQ) RlilMOlHA Q BUMCRTqMmMO 通) .见33

41、喊LD0OUOOOD幡整. hhp jgpKZdninapcrljQojancKOEKVktunQiIMKIXKIXlJWI1 xpjsS.E阳JiTfl a ASJffiR传输应至配置6.2.1.3传输安全配置一、功能介绍传输安全配置用于IC卡/USBKEYS备的配置，用户需同意并授权客户端使 用安全设备服务后才可以进行加签操作。操作流程1、用户在主菜单栏中选择酉附溶小的基内信息管理可进入基本G意 亘卜面，在基本信息管理界面选择要使用的安全配置进行配置，如下图所示：传输安全配亘O K=+UKEVfti印协高IC卡/USBKey安全配置1、用户在录入完UKE希码后，在选择加签选项时（加业务签、加传输签），系统会提示用户是否同意授权客户端使用安全设备服务，用户点击I司看旅钮，客户端进行加签处