配置之前，先要和银行申请环境和资料，以下配置只涉及系统配置，对于公有云和私有云的环境配置，请单独咨询。

银行资料请参考：

（1） 前置机安装材料

（2） 客户相关数据；（前置机连接数据、回单下载连接数据）

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

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

兴业银行直联版，需要安装银行前置机来完成付款交易、余额查询、交易明细查询等。

2. 搭建兴业银行安全代理软件

2.1. 代理软件安装

(1) 双击兴业银行银企直联客户端代理软件-（V版本号）-32/64bit.exe—(兴业官网下载或是客户经理提供)安装包,以管理员身份运行

点击“下一步”

(2) 选择想要安装的目录，默认为C:\Program Files\DcfirmClient（若是版本升级，建议换成跟旧版本不一样的安装目录），然后点击“下一步”

(3) 点击“下一步”

(4) 选择“创建桌面图标”，点击“下一步”

点击“安装”

(5) 安装过程如下：

(6) 选择“启动兴业银行企业直联代理X64bit”，点击“完成”

(7) 出现如下界面：

(8) 安装完成后，在桌面有如下图标显示

2.2. 代理软件的配置

(1) 安装完代理软件后，点击开始监听；

开始监听：选择证书，点击确定（如果使用USBKey证书或预制证书，则需要输入网盾密码），启动监听服务。服务处于监听状态时，菜单“停止监听”项变亮，“开始监听”项置变灰。

注意：

联调测试会提供文件型证书，不配备USBKey或预制证书；该证书需要安装，双击按照步骤安装即可。

生产环境请使用在账户行申请的企业网银Key证书。

(2) 参数配置

打开左上角选项，可以对兴业银行代理软件的相关端口等进行配置；

其中监听端口为银企连接通道配置内需要填写的端口；文件端口为电子回单需要用到的接口；

3. 安装部署银企云

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

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

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

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

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

• 前置机IP地址：安装兴业银行代理软件的服务器IP；

• 端口号：代理软件开放的监听端口；

• 密码、网银客户号、操作员信息由银行提供测试数据；对应信息为如图：

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

注意：点击测试连接，代表银企到前置机安装的服务器端口通了；如果不通的话，请检查ip和端口的配置

注意：如果是公有云环境，配置完银企连接通道参数配置之后，还需要配置网络代理！！！网络代理测试连接通过了，就可以了。

3.1.2. 配置银企账户

一般情况下，银企账户需要在资金云【账户管理】中维护并同步到银企云，更为具体步骤需要参考资金的指导文档，本文档只针对在银企云中的参数说明。

1） 进入【基础管理】-【银企账户】，新增或者修改银企账户

2） 账户参数说明如下：

默认可以根据资金云同步过来的信息展示，如不确定则非必填的参数都先不要填写：

3.1.3. 银企联通测试

银企账户配置完成之后，可以尝试测试余额及明细的查询；

在【查询与支付】-银行账户查询内，查询余额，如果余额能够成功查询，代表与银行前置机的通讯是成功的；

3.1.4. 银行参数配置

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

银行参数，根据实际用途分类为以下分类，可以根据实际使用时进行编辑调整；

（1） 基础参数：

• 银行前置机公用开关：支持相同集群下不同的数据中心的前置机共用一个；

• 银票出票方式：电票参数；

（2） 安全防重参数：

• 银企支付通道开关：支持在业务调整或生产上线时不接受业务系统支付业务请求；避免前置机停机，导致支付业务堆积无法完成；

• 银行非支付通道开关：支持在业务调整或生产上线时不接受业务系统查询余额或明细业务请求；避免业务系统一直请求，前置机无法执行，任务堆积；

（3） 余额明细参数：

• 回单明细限制查询日志：主要用于新老系统切换时，不限制日期，导致业务系统里是交易明细及回单重复；如果不是切换系统的不需要管；

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

（4） 付款业务参数：

• 付款摘要特殊字符池：付款单据内的摘要信息，如果包含配置的特殊字符，则可以直接置为失败；

• 支付是否需要进行KD标记：银企对账码，如果开启了，会在付款上生成对账码，可以通过交易明细的对账码进行匹配对账；

• 划拨支付接口选择：划拨业务，使用专属划拨接口或通过转账汇款接口实现；

• 代发工资接口选择：当前代发接口只支持同行代发，新接口支持跨行代发；

（5） 代发业务参数：

• 代发业务参数展示，调整这里的参数不改变任何内容，只做展示

（6） 回单参数：对电子回单的完整度和任务执行情况的管理的配置

• 回单完整度检查开关：通过对比交易明细数量，检查回单是否下载完全，并一一对应；

• 回单任务失败自动重新下载开关：回单下载任务如果因为某些原因失败了，系统会自动执行重新下载；

• 回单获取方式：文件、报文；兴业银行支持两种方式的回单，根据实际需要进行选择配置；

3.2. 配置【电子回单参数】

注意：【电子回单】应用依赖于【查询与支付】应用，需要先完成【查询与支付】配置后再进行，如客户未使用该银行的电子回单，则忽略本节配置。

3.2.1. 回单参数配置

1）  进行【电子回单】应用，回单配置管理-回单参数配置，配置说明如下：

（1） 文件上传参数必须配置：回单文件需要从银行下载回来，上传到云端服务器给到业务系统访问；

（2） 可选择调用微服务，选择调用微服务，则不需要配置文件上传参数的其他参数；

（3） 如果微服务调用选择为否，则需要配置一些参数信息；

• 苍穹开放平台api地址：搜索开放平台，打开开放平台后，复制浏览器内的地址，即为；格式请参考：比如登录地址https://feature.kingdee.com:1026/patchfi/login.html ，则对应的开发平台api地址为https://feature.kingdee.com:1026/patchfi ；（私有云、公有云同样适用）

• 苍穹开放平台登录用户名:能登录到苍穹开放平台的用户名，可配置管理员账号；

• 开放平台认证系统编码和Access Token加密认证密钥：同样搜索开放平台应用，找到第三方应用，点击新增，录入系统编码和认证秘钥等信息，保存后填写到回单系统内；

• 数据中心ID：上传回单文件到苍穹文件服务，需要录入的是苍穹平台的数据中心ID，登录到苍穹租户详情界面获取；

3.2.2. 回单前置机配置

兴业银行电子回单支持历史回单，并且支持报文和PDF文件两种方式，具体那种方式根据3.1.4模块内查询与支付的银行参数配置进行选择；

• 推送文件服务器IP：即兴业代理软件的服务器IP；

• 推送文件端口：兴业代理软件内文件的推送端口；

• 文件接收路径：私有云需要在容器内自行配置路径，进行回单文件的留存；公有云配置为：/mservice/bin/receipt/cib/当前的租户号

3.2.3. 回单任务列表

回单测试连接成功后，系统会根据回单的调度，自动执行，下载回单；也可以选择手动触发调度任务；

回单调度执行后，会在回单任务列表内，展示回单任务信息，可以查看回单的下载、上传、匹配的情况；