项目实施流程：

1、 背景

中国建设银行现金管理直联CCIP版本，该版本由于不存在银行前置机的安装，需要银行拉专线处理。因此前置机软件安装部署这一个环节不存在，需要通过金蝶提供的前置机代理程序安装部署，取代银行前置机软件的作用，通过代理程序完成查询余额、下载交易明细、下载电子回单、付款等全部交易，同时，由于该银行电子回单为PDF文件格式，还可以通过该前置机代理程序的电子回单服务获取。

1.1 下载途径

金蝶前置机代理程序下载地址（本银行版本部署文档参考本文档即可）：https://vip.kingdee.com/article/95932679937684992

2、 安装前置机代理程序

2.1 启动代理程序

下载前置机代理程序压缩包，解压后启动代理程序服务，目录结构参考如下：

需要关注的几个文件夹：logs，存放代理程序日志，分析问题时必须要的东西。

lib，存放代理程序所有jar包，部署时一般替换里面的文件。config，存放数据库和登录用户的配置，以及各个银行的配置配置说明，存放本文档。

系统默认使用9999端口，请确保端口不被占用后启动服务。

Windows启动： start.bat          

Windows后台启动：  start_in_background.bat

Window关闭：stop.bat

Linux 启动：start.sh  

Linux关闭：stop.sh

Window系统脚本启停，通过双击脚本即可，若当前用户不是管理员，则系统右键点击脚本，以管理员身份运行。

Linux系统脚本启停,通过Linux窗口用脚本命令启停，参考如：sh start.sh

注：代理程序只支持64位的系统。

2.2 配置代理程序参数

1) 登录金蝶前置机代理程序服务

首先，启动代理程序服务后，在浏览器输入IP:9999，如ip地址为192.168.123.123，就输入http://192.168.123.123:9999 即可访问代理程序服务

建议使用谷歌浏览器，暂时不支持IE

然后输入用户名密码登录系统，初始账号默认kingdee，默认密码是daili_123

需要先修改初始密码，并记得保存后登录密码。登录后找到对应的银行版本“中国建设银行现金管理版本CCB_CCIP”

2）配置参数

修改银行参数配置，按下图序号对应修改即可，其他参考无特殊要求不修改。

序号1：服务端口：全部业务的使用端口，需保持端口开放，如无特殊需求，使用默认的2333即可，该配置的端口号需要与【查询与支付】-【银企连接通道配置】上服务端口号保持一致；

序号2：文件业务服务端口：指定文件的业务端口，默认7777，该配置的端口号需要与【查询与支付】-【银企连接通道配置】上文件业务服务端口号保持一致，需保持端口开放；

序号3：银行服务地址：访问银行服务的地址，申请开通环境后由银行提供；

序号4：金蝶公钥更新程序开放端口：提供给银行下载公钥的端口，服务器IP+本端口组合成提供给银行下载公钥URL地址，例如本机服务器IP地址是192.168.1.1，端口配置为8813，那么提供给银行的客户公钥下载URL为http:// 192.168.1.1 :8813 ，如果银行要求提供后缀，则可提供银行公钥交换url

序号5：电子银行合约编号：客户与银行签订的合约编号（渠道号），由银行提供；

序号6：前置机公钥白名单：获取前置机公钥的IP名单，一般是配置银行IP，银行需要下载公钥，多个IP用英文逗号,分隔开，除了银行IP以外，还需要把本机IP配上。

序号7：访问IP地址白名单：除了本机IP以外，任何需要访问代理程序的服务IP都需要配置，包含银企云服务器IP、银行服务器IP

1、 注意：如果服务上有杀毒软件，请务必保证杀毒软件已经设置了访问IP的白名单。确保金蝶代理程序和银行的网络通畅，自行检测方式为：代理程序服务器开启cmd,通过telnet命令测试银行服务端口，比如银行服务端口提供的是http:172.20.10.10:8812 ,那么我们需要确保我们服务器能正常访问，

telnet 172.20.10.10 8812 正常联通，并且需要保证银行能正常访问我们的代理程序端口（白名单+防火墙开放端口）

3）启动中国建设银行现金管理直联的代理程序服务，如果出现以下提示，则需要等银行获取公钥后（间隔半个小时以上），退出代理程序，重新通过脚本启动代理程序，中国建设银行现金管理直联的代理程序服务，然后再次启动即可。

2、 安装部署银企云

银企云基于苍穹平台开发，通过在MC系统部署银企云补丁进行环境更新。

4.1 安装银企云环境

1） 下载银企云的补丁包

2） 参考苍穹银企云补丁安装与部署手册进行补丁安装部署

4.2 配置【查询与支付】参数

3.1.2.1 配置银企连接通道配置

1） 登录进入银企云的应用【查询与支付】

2） 进入【银行启用管理】，启用对应银行

3） 进行【银企连接通道配置】，新增或修改“中国建设银行企业现金管理直联版”，参数配置说明如下：

金蝶前置代理配置：

1） 代理服务器IP地址：一般是安装金蝶前置代理程序的服务器IP，如果是做了映射跳转，则录入映射后的IP。

2） 服务端口号：代理程序上的服务端口

3） 文件业务服务端口号：代理程序上的文件业务服务端口

网银登录配置（银行提供的配置）

按需录入，参数均为银行提供，如不提供可以不用配置，电子银行合约号为以下提供的渠道号。

3.1.2.2 配置银企账户

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

1） 进入【银企账户】，新增或者修改银企账户

2） 账户参数说明如下：

账户类别：一般都是普通类，这个取决于维护的银行账户所属类别，比如如果是虚拟现金池账户就维护成虚拟现金池。

电子回单账号：该银行账号如果需要做电子回单，则需要维护成是，一般情况下如果是账户管理中维护为电子回单功能，同步到银企则显示为是。

地区码：建行无需配置

委托项目编号：代发可能用到，银行提供就录入，不提供忽略

3.1.2.3 银行参数配置

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

回单明细限制查询日期：为空不限制查询回单和回单的日期，当设置为日期T时，不允许查询T-1及之前日期的交易明细和T-2及之前日期的电子回单。

是否开启回单完整度检查、是否开启失败自动重下载回单：与回单相关的参数，默认即可，是回单的自动补全机制。

普通付款是否选择二次审核支付：普通对公对私（pay）是选择直接付款还是需要再银行网银端再进行一次审核操作再付款。

代发转普通转账接口付款：业务做代发付款（pay_for_salary）,通过该参数可以控制代发时也通过普通转账接口付款。

联动支付是否需要走普通支付：业务做联动支付（pay_for_linkpay），可以选择通过金蝶分两步做联动，还是与银行签订协议后，由银行主动下拨后做付款。

如果后续还有新增其他参数，可能会改变以上付款选择路由。

4.3 配置【电子回单】参数

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

3.1.3.1 回单参数配置

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

苍穹开放平台api地址：登录苍穹开放平台地址，比如登录地址https://feature.kingdee.com:1026/patchfi/login.html ，则对应的开发平台api地址为https://feature.kingdee.com:1026/patchf i

苍穹开放平台登录用户名:能登录到苍穹开放平台的用户名

开放平台认证系统编码和Access Token加密认证密钥：在苍穹开放平台中配置一个第三方应用，并把系统编码和密码对应填入即可。

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

3.1.3.2 回单前置机配置

参数说明如下：

回单下载接口选择：客户与银行签订回单接口协议已经确认了接口，按实际签约接口选择即可。如果签约的是新接口P1CCMW006，对应需要在该银行的【查询与支付】-【银行参数配置】中设置“回单下载是否使用P1CCMW001接口”=是。

是否银行主动推送回单：与银行确认，默认为否，一般情况下该银行都是非主动推送模式。

回单获取方式应选择前置机代理获取。

前置机代理程序IP和端口：分别为部署金蝶前置机代理程序的服务器IP和启动的电子回单文件服务端口，如下图：（详细部署操作请参考第2章安装前置机代理程序）

注意：访问IP地址白名单：需要设置访问代理程序的IP

文件保存路径：当前银行推送的回单文件的目录，假设下载回单的银行回单文件是在代理程序目录下，如D:\daili\huidan，也就是前置机服务器上的这个目录下是有回单文件的，文件保存路径则配D:\daili\huidan即可.

3.1.3.3 银行参数配置

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

关于回单的参数有以下：

回单下载是否使用P1CCMW001接口:按实际跟银行签约的接口选择即可。

是否开启回单数完整度检查：默认开启,开启之后回单调度会检查回单数量和明细数量是否一致，如果回单数量小于明细数量会自动重新下载回单，建议不要关闭

是否开启失败自动重试下载电子回单：默认开启,开启之后回单任务失败后，判断是否存在交易流水，如果存在回单任务会自动重试， 3天内的会重新下载。

3.1.3.4 回单结果列表

回单结果列表中可以查看当前已下载完成的回单文件，只有上传成功的文件才可以被业务系统下载。