1. 背景

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

银行资料请参考：

（1）前置机安装材料

（2）客户相关数据；

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

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

2. 实施流程

实施部署流程

3. 搭建渤海银行银行前置机程序

3.1.  渤海银行前置机环境配置

请注意：搭建银行前置机的操作指南银行一般都会提供，更为详细的步骤直接参考银行的银企通配置文档。

1、获取银行UKEY以及驱动程序

UKEY以及驱动程序均由银行提供

2、安装前置程序包

2.1. 将安装包bhshchagent.zip拷贝到D盘根目录下，解开压缩。

注：如果只有C盘，更改\bhshchagent\sh64 目录下start.bat、createSN.bat盘符

3、编辑前置机配置文件

3.1. 打开D:\bhshchagent\bin\config\shchclient.properties（使用记事本打开）

3.2. 修改配置文件中cifno字段，修改成新key的客户号

4、修改前置机客户号配置文件

        4.1. 打开D:\bhshchagent\bin\客户号.sn文件

        4.2. 如果存在客户号.id的文件，请删除

        4.3. 修改配置文件中的客户标示号，配置成新开key的客户标识号

备注：配置完成3.3客户后会生成id文件，配置完成3.2盘符后会生成sn文件，

5、根据测试环境选择服务器地址

        5.1. 打开D:\bhshchagent\bin\config\shchclient.properties

        5.2. 找到server url

        5.3. 根据实际情况，选择正确的url，去掉真正使用的地址前面的#

6、配置key类型

        6.1. 打开D:\bhshchagent\bin\config\shchclient.properties

        6.2. 找到usbkey CSP_NAME

        6.3. 根据使用的key类型选择

      一代key值:cspName=FEITIA**************BANK V1.0

      二代key值:cspName=FEITIAN********************* V1.0

7、配置key类型

        7.1. 打开D:\bhshchagent\bin\config\shchclient.properties

        7.2. 找到GMkeyFlag字段

        7.3. 根据key类型对该字段进行配置

注：key为国密时，GMkeyFlag=1；非国密时，GMkeyFlag=0

4.      安装部署银企云

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

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

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

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

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

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

1、前置机IP地址：渤海银行服务器IP地址；

2、端口号：与渤海银行服务器的参数配置上的“交易端口”保持一致；

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

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

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

4.1.2.   配置银企账户

如何添加银企账户

4.1.3.   银企联通测试

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

4.1.4.   银行参数配置

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

1、支付/非支付通道开关说明

2、业务单据防重付款验证开关

3、回单明细限制查询日期：

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

5、付款摘要特殊字符池：

（二）电子回单配置：

渤海银行回单下载流程：

• 先通过电子回单流水查询EDSQ01接口查询交易明细，拿到打印流水号（PrintTaskId）字段

• 通过打印流水号调用EDSQ02接口获取到每条流水对应的文件获取路径

• 通过电子回单PDF文件查询EDSQ03接口获取到具体文件名

1、在银企云内，找到电子回单应用：

2、点击回单前置机配置，选择渤海银行版本：

回单业务配置：

是否支持当日回单：邮储支持下载实时回单，如客户对回单获取速度要求较高可开启；

回单获取方式：

回单获取，支持SFTP获取、银企前置机代理程序获取；

远程SFTP获取的话，需要自行搭建SFTP服务，并配置SFTP服务器相关信息；

银行SFTP服务器IP地址：可以访问到SFTP服务的IP地址（即搭建SFTP服务器的ip）

银行SFTP端口：请求获取回单文件的端口；

银行SFTP文件保存子路径：回单文件存储的路径；

登录SFTP服务器使用的用户名：请求SFTP需要授权登录，SFTP的登录用户名；

登录SFTP服务器使用的密码：请求SFTP需要授权登录，SFTP的登录用户名对应的登录密码；和本机证书二选一提供；

登录SFTP服务本机证书文件：请求SFTP需要授权登录，可以通过证书文件进行登录；和登录密码二选一提供；

银企前置机代理程序获取，需要在银行前置机服务器上安装前置机代理程序，并且开启电子回单的服务；

前置机代理程序IP：代理程序安装的服务器的IP地址；和银行前置机一般建议安装在同一个服务器上；

代理程序电子回单服务端口：代理程序内开启的电子回单文件服务端口；

文件保存路径：银行推送在前置机服务器本地的文件夹（不可以包含中文）如果没有推送到本地，则建议通过SFTP方式进行获取

3、配置完成后，在回单任务管理里建立回单任务，测试回单下载；

注：回单下载的任务，需要在账户管理里配置为回单账号才可以；