变更记录

1.背景

配置之前，先要和银行申请环境和资料，找IT管理员配好网络。

银行资料请参考：

（1）前置机安装材料

（2）客户相关数据；

（3）测试使用账套数据；

请仔细阅读文档。清晰步骤了再进行配置。

2.实施流程

实例部署流程

3.搭建晋商银行前置机程序

3.1 晋商银行前置机环境配置

•  获取银行前置机安装包

• 前置机程序安装部署

注意事项：银行前置机的安装部署手册银行方会更新提供，本文档仅供参考。

a. 双击运行JSHB.CMS.Transmitter.exe进行安装，需要注意，尽量不安装在C盘，如果安装C盘，后续需要以管理员权限启动，安装完成后，进入到安装目录。

b. 点击下一步，然后点“是”

c. 直到最后一步安装完成。

• 通讯平台配置方法

3.1.1.测试环境配置方法如下：

注：若是专线配置法一样，地址更改即可。

点安装图标属性，右击 打开文件所在位置

 打开上图的配置文件HsConfigTools.exe如下，企业代码配置根据测试企业号进行更改

测试环境不使用ukey，安全认证不用勾选启用安全认证

3.1.2.生产环境配置方法如下：

注：若是专线，服务器地址配置到行内对外的 IP 地址，端口一般配置 16010，64086

若是公网，服务器 公网接入域名 以银行提供的部署文档中说明为准 

3.1.3. 通讯平台使用方法

• 双击打开通讯软件

• 输入正确的用户名 和 密码，然后登录

• 登录成功后，可能会有个授权到期预警提示。

  
  

  
  

注意 未授权之前 试用日期为一个月 点击 确定 继续使用，点击确定之后 进入 系统

• 然后进行参数配置，通讯协议目前支持TCP，交易端口分别需要与银企云上配置的端口号一致，文件端口，目前银企云还未用上。

  
  

  
  

  
  

  
  

• 配置完成后，点击开启服务即可完成银行前置机的配置。

  请注意，需要开通端口访问权限，否则银企云无法连到前置机服务，同时需要银行给客户开通前置机访问银行服务的权限，联系银行处理即可。
  

  
  

4.安装部署银企云

4.1.配置【查询与支付】参数

前提：需要更新银企云最新补丁

4.1.1.配置银企连接通道配置参数

（1）登录金蝶云星瀚，进入银企云的应用【查询与支付】

（2）进入【银企连接通道配置】页面，选择晋商银行直联版，然后点击新增

（3）进入前置机新增页面，对基础连接配置和网银登录配置参数进行配置

1、前置机IP地址：兰州银行银企通讯平台所在的服务器IP地址；

2、端口号：与晋商银行通讯平台的参数配置上的“交易端口”保持一致；

3、通讯协议：固定TCP，因此，银企通讯平台上的通讯协议也必须配置成TCP。

4、并发锁数量：同时提交银行前置机的并发锁设置，默认1，如果银行支持多并发则可以设置，但是并发锁数量之和不能大于银行前置机的最大并发，否则会导致交易出现问题。

5、金蝶代理服务器端口号：由于这个银行交易明细、代发工资文件是文件格式，需部署代理程序，对应的是代理程序的“服务端口”，配置参考4.2.1的说明。

6、客户号：客户号，银行提供，一般与前置机软件上的企业代码一样。

7、银行测试系统日期：测试环境需要，银行测试服务器日期不是当前日期，配置日期需要咨询银行后填入，但是生产环境一定不能配置任何日期。

配置完成后，点击保存，然后点击测试连接；

   注意：点击测试连接，代表银企到前置机安装的服务器端口通了；如果不通的话，请检查ip和端口的配置，如果是公有云环境，这里测试连接不通是正常的，需要通过网络代理连接配置中进行测试连接

 4.1.2.配置银企账户

如何添加银企账户？

本银行无其他属性需要在银企账户属性中维护，默认即可。

4.1.3.银企联通测试

银企账户配置完成之后，可以在在【查询与支付】-银行账户查询内，查询该账户余额，如果余额能够成功查询，代表与银行前置机的通讯配置是成功的，可以进行实际的交易测试；

4.1.4.银行参数配置

银行参数配置本身有默认参数，如果没有特殊情况可以不用配置。以下只对本银行的关键参数进行说明：

 回单明细限制查询日期：

 交易明细唯一主键组成规则：与银行约定协商的保障交易明细唯一性的规则；

 付款摘要特殊字符池：

支付是否需要进行KD标识：付款摘要中加入KD标记,区分付款是否由银企发起，可以自动把付款单和付款交易明细匹配关联起来，由于是摘要中添加标识，会导致电子回单摘要会附带KD标识，例如客户真实摘要是费用报销100元，加入KD后摘要变成类似kd@ke1k2k2k费用报销100元，因此能接受的用户再去开启。不开启的情况下，付款单和交易明细的匹配可以用银企互联的规则设置。

代发业务参数：

是否启用代发工资业务：默认否， 为否时，当业务端发起工资代发单（非报销代发单）时，不允许提交银行，如果客户需要通过该银行做代发工资，则需要改成是

4.2. 配置【金蝶代理程序】参数

4.2.1 配置晋商银行参数

前提说明：建行外联版批量付款接口才需要用到代理程序上传和下载文件，普通单笔接口不需要代理程序，按需配置接口。

l  下载金蝶前置机代理程序安装包，解压后启动

 进入“中国农业银行公网版”页面进行配置（后续会增加晋商银行直联版的配置界面，增加后再更新文档，目前暂时可用农行的界面配置，因此农行和晋商的前置机不能在一个服务器上）

服务端口：设置未被占用的端口，并且需要开放给银企云访问

农行公网版交易明细文件下载目录：与银行确认交易明细文件会在晋商银行哪个目录下生成，然后配置

是否自动启动：设置成true则下次启动代理程序的时候会自动启动服务

访问IP地址白名单：这个非常重要，关系到是否能正常访问代理程序，需要配置本机IP地址、银企云的IP地址，银行服务地址,通过英文逗号,分隔，注意不要多余空格

其他参数默认与农行公网默认的一致就可以了。

保存后，启动代理程序服务即可。