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

1、跨境电子商务进口统一版信息化系统客户端软件使用手册附件2跨境电子商务进口统一版信息化系统客户端软件使用手册1 文档概述1.1 编写目的主要为跨境电商相关企业提供跨境电子商务进口统一版信息化系统客户端软件（以下简称客户端软件）正确的安装说明以及系统操作说明。 1.2 用户对象跨境电商相关企业用户，如电商平台、电商企业、物流企业、支付企业、仓储企业、报关企业等。1.3 系统概述客户端软件辅助跨境电商相关企业按照跨境电子商务进口统一版信息化系统企业对接报文规范（试行）与跨境电子商务进口统一版信息化系统进行数据传输，实现订单、运单、支付单、清单等单证信息自动化处理或通过EXCEL格式文件半自动化处理。

2、客户端可在企业授权的情况下进行报文的加签自动化处理。并提供数据发送和接收查询功能。1.4 术语定义序号缩略语名称术语全称定义说明1应用传输协议应用传输协议（Communications Protocol）是指计算机通信的共同语言。本文中泛指AS2（上行）+AS3（下行），IBMMQ，Toprow MQ(华盛信泰消息中间件)，RabbitMQ多种方式传输协议的统称。2数据传输报文数据传输报文数据传输是指在数据源和数据宿之间传输数据的过程，也称数据通信。数据是指能够由计算机处理的数字、字母和符号等，它是信息的一种载体，数据是信息传输的一种形式，主要指与计算机有关的信息传输。数据传输报文在本文是指用

3、于存放数据传输数据的载体文件的泛称。3数据格式数据格式本文指数据传输报文的文件类型，主要指XML、EXCEL等数据格式。4数据格式转换数据格式转换从一种数据格式转换成另外一种数据格式的过程。5节点节点在网络拓扑中，网络任何支路的终端或网络中两个或更多支中的互连公共点。2 运行环境类别最低配置推荐配置应用服务器CPU2.0GHZ*4核3.0GHZ *8核内存4G以上8G以上硬盘500G500G以上RAID其他百兆带宽百兆带宽以上软件操作系统Linux/Unix/Windows server2003及以上版本3 软件安装说明3.1 Windows下安装3.1.1 基础安装3.1.1.1 解压客户端

4、压缩包将跨境电子商务进口统一版信息化系统客户端软件安装压缩包：“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企业客户端授权申请，邮件正文录入格式如下

5、图所示：邮件内容审核通过后管理员将ASE_License.ase（授权文件）发送给跨境电商相关企业，跨境电商相关企业收到ASE_License.ase （授权文件）文件后，将该文件放置在Client所在根目录下，系统自动进行授权认证并完成程序启动。如下图所示：3.1.2 注册服务以管理员方式运行installService.bat文件。如下图所示：3.2 Linux下安装3.2.1 基础安装3.2.1.1 解压客户端压缩包将客户端软件安装压缩包“LINUX_IMPORTS_CLIENT_V1.0.0.zip”解压至用户自身home目录路径下，例如：#tar zxvf / LINUX_IMPOR

6、TS_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（授权文件） 文件后，将该文件放置在Cl

7、ient目录下，系统自动进行授权认证并完成程序启动。如下图所示：3.2.2 注册服务以管理员方式运行registInstall.sh文件，进行注册服务。4 企业接入准备企业传输编号（DXPID）向属地海关数据分中心申请传输协议配置信息企业根据自身业务量情况向属地海关数据分中心申请适合的接入配置（MQ或AS2/AS3相关配置信息）IC卡或Ukey申请向属地海关数据分中心申请5 系统登录指南一、 功能介绍用户在使用系统前需要先登录系统。二、 操作流程1、在浏览器(Chrome或Firefox)中输入系统地址http:/localhost:9091/console，输入正确密码（默认密码888888

8、88），点击登录进入系统登录页面6 系统操作指南6.1 系统监控一、 功能介绍跨境电商相关企业在系统监控查看到当前接收数据数量、发送数据数量、接收数据容量、发送数据容量、当前数据监控、流量监控以及系统监控。二、 操作流程1、用户在主菜单栏中选择系统监控即可进入系统监控界面，如下图所示：6.2 配置管理6.2.1 基本信息管理一、 功能介绍基本信息管理包括企业对接配置、连接协议配置、传输安全配置三个模块。为跨境电商相关企业提供录入对接配置基本信息、连接配置协议信息以及传输安全配置信息。二、 操作流程1、用户在主菜单栏中选择配置管理下的基本信息管理，即可进入基本信息管理界面，如下图所示： 6.2.

9、1.1 企业对接配置一、 功能介绍跨境电商相关企业能够进行对接配置基本信息录入，可进行高级选项录入包括传输接收编号、报文发送路径、报文接收路径、异常回执路径等内容。二、 操作流程1、用户在主菜单栏中选择配置管理下的基本信息管理，即可进入基本信息管理界面，在基本信息管理界面录入跨境电商相关企业对接配置信息，如下图所示：2、跨境电商相关企业录入完成跨境电商相关企业对接配置信息后，点击高级按钮进行信息录入,如下图所示：6.2.1.2 连接协议配置一、 功能介绍连接协议配置包括Rabbit MQ协议配置、IBM MQ或Toprow MQ协议配置和AS2/AS3等协议配置模块，企业用户根据需要自行选择要

10、使用的协议进行配置。二、 操作流程1、用户在主菜单栏中选择配置管理下的基本信息管理，即可进入基本信息管理界面，在基本信息管理界面选择要使用的连接协议配置进行配置，如下图所示： Rabbit MQ协议配置（推荐量级：5000票/天；100票/分；5000票/天；100票/分；4096KB/票） AS2/AS3协议配置（推荐量级：5000票/天；100票/分；1024KB/票）6.2.1.3 传输安全配置一、 功能介绍传输安全配置用于IC卡/USBKEY设备的配置，用户需同意并授权客户端使用安全设备服务后才可以进行加签操作。二、 操作流程1、用户在主菜单栏中选择配置管理下的基本信息管理，即可进入基

11、本信息管理界面，在基本信息管理界面选择要使用的安全配置进行配置，如下图所示： IC卡/USBKey安全配置1、用户在录入完UKEY密码后，在选择加签选项时（加业务签、加传输签），系统会提示用户是否同意授权客户端使用安全设备服务，用户点击同意按钮，客户端进行加签处理，用户点击取消按钮，客户端取消当前加签操作。如下图所示。2、跨境电商相关企业录入完成全部基本信息后，点击右下角保存按钮，系统将保存已填写好的基本信息。6.2.2 对接配置管理一、 功能介绍用于跨境电商相关企业当前已配置资源查询并可启动或停止当前监听资源。二、 操作流程1、用户在主菜单栏中选择配置管理下的对接配置管理，即可进入对接配置管

12、理界面，系统根据查询条件显示监听资源配置信息，如下图所示：2、用户能够选择具体资源配置信息，点击启动按钮，启动当前配置资源，或点击全部开始按钮，全部启动当前配置资源。3、用户能够选择具体资源配置信息，点击停止按钮，停止当前配置资源，或点击全部停止按钮，全部停止当前配置资源6.2.3 数据导入服务一、 功能介绍将跨境电商相关企业需发送的EXCLE文件转换成业务报文进行传输,同时提供EXCLE模板下载。二、 操作流程1、用户在主菜单栏中选择配置管理下的数据导入服务，即可进入数据导入服务界面，如下图所示：2、在数据导入服务界面选择下载EXCLE模板，将EXCLE模板下载至本地。3、 用户将EXCLE

13、模板进行解压操作，如下图所示：4、用户填写完成EXCLE文件，点击上传按钮，将填写完成的EXCLE文件上传至系统。用户上传完成EXCLE文件，系统将跨境电商相关企业上传的EXCLE文件转换成XML文件进行传输。如下图所示：6.3 运维管理6.3.1 数据落地管理一、 功能介绍在数据落地查询模块下，能对落地数据进行查询操作。企业可以根据发送时间，接收时间，报文编号，报文名称等条件，清晰查看到系统传输报文。并能对正常或异常数据报文进行重发操作。二、 操作流程1、用户在主菜单栏中选择运维管理下的数据落地管理，即可进入数据落地管理界面，如下图所示：2、用户可选择正常或异常数据报文点击重发按钮进行重发操

14、作6.3.2 报文异常管理一、 功能介绍系统异常管理分为系统异常和阻塞异常，系统管理员可以根据异常时间范围，线程名称，和异常信息等条件进行检索查询，即可清晰了解到当前系统出现的问题的原因。二、 操作流程1、用户在主菜单栏中选择运维管理下的报文异常管理，即可进入报文异常管理界面，如下图所示：6.3.3 报文阻塞管理一、 功能介绍系统异常管理分为系统异常和阻塞异常，系统管理员可以根据异常时间范围，线程名称，和异常信息等条件进行检索查询，即可清晰了解到当前系统出现的问题的原因。二、 操作流程1、用户在主菜单栏中选择运维管理下的报文阻塞管理，即可进入报文阻塞管理界面，如下图所示：7 运行与维护7.1

15、日常维护工作范围：1、网络维护检查客户端软件的各个组成部分的网络状况，保证网络的连接正常，网卡的使用正常。2、设备维护硬件维护：保证客户端软件使用的服务器的硬件环境运转正常。软件维护：保证操作系统，运行软件（IBM MQ或Toprow MQ）及其他附属软件的运行正常。检查个服务器软件所需硬盘余量，监控磁盘空间，数据库空间，inode空间等。3、客户端维护确保跨境电子商务进口统一版信息化系统客户端软件正常运转。7.2 常见问题处理针对常见问题列出了如下处理方式：事件预防措施处理客户端操作系统断电安装UPS接电后系统支持自动重新启动功能，如果未启动可以人工快速介入启动相关系统，并且系统拥有重发机制

16、，可以重发由于断电等灾难引起的未处理报文。系统日志中发现IC卡/USBKEY相关错误保证IC卡/USBKEY正常无密码错误重新插拔IC卡/USBKEY。系统日志中发现加密机相关错误按高可用方案部署加密机恢复加密机运行正常即可。系统日志中发现AS2上行协议连接失败保证网络畅通，端口开放检查本地网络是否正常。系统日志中发现AS3下行协议连接失败保证网络畅通，端口开放检查本地网络是否正常。系统日志中发现IBM MQ或Toprow MQ协议连接失败保证网络畅通，端口开放检查本地网络是否正常，IBMMQ服务是否正常。系统日志中发现Rabbit MQ协议连接失败保证网络畅通，端口开放检查本地网络是否正常。