跨境电子商务进口统一版信息化系统客户端软件使用手册.docx
《跨境电子商务进口统一版信息化系统客户端软件使用手册.docx》由会员分享，可在线阅读，更多相关《跨境电子商务进口统一版信息化系统客户端软件使用手册.docx（19页珍藏版）》请在冰豆网上搜索。
跨境电子商务进口统一版信息化系统客户端软件使用手册
附件2
跨境电子商务进口统一版信息化系统
客户端软件使用手册
目录
1文档概述4
1.1编写目的4
1.2用户对象4
1.3系统概述4
1.4术语定义4
2运行环境5
3软件安装说明5
3.1Windows下安装5
3.1.1基础安装5
3.1.1.1解压客户端压缩包5
3.1.1.2启动客户端6
3.1.2注册服务7
3.2Linux下安装8
3.2.1基础安装8
3.2.1.1解压客户端压缩包8
3.2.1.2启动客户端8
3.2.2注册服务10
4企业接入准备10
5系统登录指南10
6系统操作指南11
6.1系统监控11
6.2配置管理12
6.2.1基本信息管理12
6.2.1.1企业对接配置13
6.2.1.2连接协议配置14
6.2.1.3传输安全配置16
6.2.2对接配置管理18
6.2.3数据导入服务18
6.3运维管理20
6.3.1数据落地管理20
6.3.2报文异常管理21
6.3.3报文阻塞管理22
7运行与维护23
7.1日常维护23
7.2常见问题处理23
1
文档概述
1.1编写目的
主要为跨境电商相关企业提供跨境电子商务进口统一版信息化系统客户端软件（以下简称客户端软件）正确的安装说明以及系统操作说明。
1.2用户对象
跨境电商相关企业用户，如电商平台、电商企业、物流企业、支付企业、仓储企业、报关企业等。
1.3系统概述
客户端软件辅助跨境电商相关企业按照《跨境电子商务进口统一版信息化系统企业对接报文规范（试行）》与跨境电子商务进口统一版信息化系统进行数据传输，实现订单、运单、支付单、清单等单证信息自动化处理或通过EXCEL格式文件半自动化处理。
客户端可在企业授权的情况下进行报文的加签自动化处理。
并提供数据发送和接收查询功能。
1.4术语定义
序号
缩略语名称
术语全称
定义说明
1
应用传输协议
应用传输协议（CommunicationsProtocol）
是指计算机通信的共同语言。
本文中泛指AS2（上行）+AS3（下行），IBMMQ，ToprowMQ（华盛信泰消息中间件），RabbitMQ多种方式传输协议的统称。
2
数据传输报文
数据传输报文
数据传输是指在数据源和数据宿之间传输数据的过程，也称数据通信。
数据是指能够由计算机处理的数字、字母和符号等，它是信息的一种载体，数据是信息传输的一种形式，主要指与计算机有关的信息传输。
数据传输报文在本文是指用于存放数据传输数据的载体文件的泛称。
3
数据格式
数据格式
本文指数据传输报文的文件类型，主要指XML、EXCEL等数据格式。
4
数据格式转换
数据格式转换
从一种数据格式转换成另外一种数据格式的过程。
5
节点
节点
在网络拓扑中，网络任何支路的终端或网络中两个或更多支中的互连公共点。
2运行环境
类别
最低配置
推荐配置
应用服务器
CPU
2.0GHZ*4核
3.0GHZ*8核
内存
4G以上
8G以上
硬盘
500G
500G以上RAID
其他
百兆带宽
百兆带宽以上
软件
操作系统
Linux/Unix/Windowsserver2003及以上版本
3软件安装说明
3.1Windows下安装
3.1.1基础安装
3.1.1.1解压客户端压缩包
将跨境电子商务进口统一版信息化系统客户端软件安装压缩包：
“WINDOWS_IMPORTS_CLIENT_V1.0.0.zip”
解压至跨境电商相关企业服务器的某硬盘路径下，具体路径跨境电商相关企业可自行定义，例如：
C:
\Data。
如下图所示：
3.1.1.2启动客户端
1.进入Client目录，执行startup.bat文件，如下图所示：
2、系统自动在~/Client/Config/ASEUser.xml文件中生成授权申请码，授权码位于ASEUser.xml文件节点中，如下图所示：
3、跨境电商相关企业将授权申请码发送至kj@（邮箱地址），邮件主题为XXX企业客户端授权申请，邮件正文录入格式如下图所示：
邮件内容审核通过后管理员将ASE_License.ase（授权文件）发送给跨境电商相关企业，跨境电商相关企业收到ASE_License.ase（授权文件）文件后，将该文件放置在Client所在根目录下，系统自动进行授权认证并完成程序启动。
如下图所示：
3.1.2注册服务
以管理员方式运行installService.bat文件。
如下图所示：
3.2Linux下安装
3.2.1基础安装
3.2.1.1解压客户端压缩包
将客户端软件安装压缩包“LINUX_IMPORTS_CLIENT_V1.0.0.zip”
解压至用户自身home目录路径下，例如：
#tarzxvf/LINUX_IMPORTS_CLIENT_V1.0.0.zip-C~/Data
3.2.1.2启动客户端
1.进入Client目录下，执行startup.sh文件，如下图所示：
2、系统自动在~/Client/Config/ASEUser.xml文件中生成授权申请码，授权码位于ASEUser.xml文件节点中，如下图所示：
3、跨境电商相关企业将授权申请码发送至kj@（邮箱地址），邮件主题为XXX企业客户端授权申请，邮件正文录入格式如下图所示：
审核通过后，管理员将ASE_License.ase（授权文件）发送给跨境电商相关企业，跨境电商相关企业收到ASE_License.ase（授权文件）文件后，将该文件放置在Client目录下，系统自动进行授权认证并完成程序启动。
如下图所示：
3.2.2注册服务
以管理员方式运行registInstall.sh文件，进行注册服务。
4企业接入准备
企业传输编号（DXPID）
向属地海关数据分中心申请
传输协议配置信息
企业根据自身业务量情况向属地海关数据分中心申请适合的接入配置（MQ或AS2/AS3相关配置信息）
IC卡或Ukey申请
向属地海关数据分中心申请
5系统登录指南
一、功能介绍
用户在使用系统前需要先登录系统。
二、操作流程
1、在浏览器（Chrome或Firefox）中输入系统地址http:
//localhost:
9091/console，输入正确密码（默认密码88888888），点击登录进入系统登录页面
6系统操作指南
6.1系统监控
一、功能介绍
跨境电商相关企业在系统监控查看到当前接收数据数量、发送数据数量、接收数据容量、发送数据容量、当前数据监控、流量监控以及系统监控。
二、操作流程
1、用户在主菜单栏中选择系统监控即可进入系统监控界面，如下图所示：
6.2配置管理
6.2.1基本信息管理
一、功能介绍
基本信息管理包括企业对接配置、连接协议配置、传输安全配置三个模块。
为跨境电商相关企业提供录入对接配置基本信息、连接配置协议信息以及传输安全配置信息。
二、操作流程
1、用户在主菜单栏中选择配置管理下的基本信息管理，即可进入基本信息管理界面，如下图所示：
6.2.1.1企业对接配置
一、功能介绍
跨境电商相关企业能够进行对接配置基本信息录入，可进行高级选项录入包括传输接收编号、报文发送路径、报文接收路径、异常回执路径等内容。
二、操作流程
1、用户在主菜单栏中选择配置管理下的基本信息管理，即可进入基本信息管理界面，在基本信息管理界面录入跨境电商相关企业对接配置信息，如下图所示：
2、跨境电商相关企业录入完成跨境电商相关企业对接配置信息后，点击高级按钮进行信息录入,如下图所示：
6.2.1.2连接协议配置
一、功能介绍
连接协议配置包括RabbitMQ协议配置、IBMMQ或ToprowMQ协议配置和AS2/AS3等协议配置模块，企业用户根据需要自行选择要使用的协议进行配置。
二、操作流程
1、用户在主菜单栏中选择配置管理下的基本信息管理，即可进入基本信息管理界面，在基本信息管理界面选择要使用的连接协议配置进行配置，如下图所示：
ØRabbitMQ协议配置（推荐量级：
>5000票/天；>100票/分；<4096KB/票）
ØIBMMQ或ToprowMQ协议配置（推荐量级：
>5000票/天；>100票/分；<4096KB/票）
ØAS2/AS3协议配置（推荐量级：
<5000票/天；<100票/分；<1024KB/票）
6.2.1.3传输安全配置
一、功能介绍
传输安全配置用于IC卡/USBKEY设备的配置，用户需同意并授权客户端使用安全设备服务后才可以进行加签操作。
二、操作流程
1、用户在主菜单栏中选择配置管理下的基本信息管理，即可进入基本信息管理界面，在基本信息管理界面选择要使用的安全配置进行配置，如下图所示：
ØIC卡/USBKey安全配置
1、用户在录入完UKEY密码后，在选择加签选项时（加业务签、加传输签），系统会提示用户是否同意授权客户端使用安全设备服务，用户点击同意按钮，客户端进行加签处理，用户点击取消按钮，客户端取消当前加签操作。
如下图所示。
2、跨境电商相关企业录入完成全部基本信息后，点击右下角保存按钮，系统将保存已填写好的基本信息。
6.2.2对接配置管理
一、功能介绍
用于跨境电商相关企业当前已配置资源查询并可启动或停止当前监听资源。
二、操作流程
1、用户在主菜单栏中选择配置管理下的对接配置管理，即可进入对接配置管理界面，系统根据查询条件显示监听资源配置信息，如下图所示：
2、用户能够选择具体资源配置信息，点击启动按钮，启动当前配置资源，或点击全部开始按钮，全部启动当前配置资源。
3、用户能够选择具体资源配置信息，点击停止按钮，停止当前配置资源，或点击全部停止按钮，全部停止当前配置资源
6.2.3数据导入服务
一、功能介绍
将跨境电商相关企业需发送的EXCLE文件转换成业务报文进行传输,同时提供EXCLE模板下载。
二、操作流程
1、用户在主菜单栏中选择配置管理下的数据导入服务，即可进入数据导入服务界面，如下图所示：
2、在数据导入服务界面选择下载EXCLE模板，将EXCLE模板下载至本地。
3、用户将EXCLE模板进行解压操作，如下图所示：
4、用户填写完成EXCLE文件，点击上传按钮，将填写完成的EXCLE文件上传至系统。
用户上传完成EXCLE文件，系统将跨境电商相关企业上传的EXCLE文件转换成XML文件进行传输。
如下图所示：
6.3运维管理
6.3.1数据落地管理
一、功能介绍
在数据落地查询模块下，能对落地数据进行查询操作。
企业可以根据发送时间，接收时间，报文编号，报文名称等条件，清晰查看到系统传输报文。
并能对正常或异常数据报文进行重发操作。
二、操作流程
1、用户在主菜单栏中选择运维管理下的数据落地管理，即可进入数据落地管理界面，如下图所示：
2、用户可选择正常或异常数据报文点击重发按钮进行重发操作
6.3.2报文异常管理
一、功能介绍
系统异常管理分为系统异常和阻塞异常，系统管理员可以根据异常时间范围，线程名称，和异常信息等条件进行检索查询，即可清晰了解到当前系统出现的问题的原因。
二、操作流程
1、用户在主菜单栏中选择运维管理下的报文异常管理，即可进入报文异常管理界面，如下图所示：
6.3.3报文阻塞管理
一、功能介绍
系统异常管理分为系统异常和阻塞异常，系统管理员可以根据异常时间范围，线程名称，和异常信息等条件进行检索查询，即可清晰了解到当前系统出现的问题的原因。
二、操作流程
1、用户在主菜单栏中选择运维管理下的报文阻塞管理，即可进入报文阻塞管理界面，如下图所示：
7运行与维护
7.1日常维护
工作范围：
1、网络维护
检查客户端软件的各个组成部分的网络状况，保证网络的连接正常，网卡的使用正常。
2、设备维护
硬件维护：
保证客户端软件使用的服务器的硬件环境运转正常。
软件维护：
保证操作系统，运行软件（IBMMQ或ToprowMQ）及其他附属软件的运行正常。
检查个服务器软件所需硬盘余量，监控磁盘空间，数据库空间，inode空间等。
3、客户端维护
确保跨境电子商务进口统一版信息化系统客户端软件正常运转。
7.2常见问题处理
针对常见问题列出了如下处理方式：
事件
预防措施
处理
客户端操作系统断电
安装UPS
接电后系统支持自动重新启动功能，如果未启动可以人工快速介入启动相关系统，并且系统拥有重发机制，可以重发由于断电等灾难引起的未处理报文。
系统日志中发现IC卡/USBKEY相关错误
保证IC卡/USBKEY正常无密码错误
重新插拔IC卡/USBKEY。
系统日志中发现加密机相关错误
按高可用方案部署加密机
恢复加密机运行正常即可。
系统日志中发现AS2上行协议连接失败
保证网络畅通，端口开放
检查本地网络是否正常。
系统日志中发现AS3下行协议连接失败
保证网络畅通，端口开放
检查本地网络是否正常。
系统日志中发现IBMMQ或ToprowMQ协议连接失败
保证网络畅通，端口开放
检查本地网络是否正常，IBMMQ服务是否正常。
系统日志中发现RabbitMQ协议连接失败
保证网络畅通，端口开放
检查本地网络是否正常。
升级会员 