中国建设银行外联版部署文档（CCB_DC）

搜索标签：建行外联版部署、建设银行外联版部署、建行前置机部署

1.      背景

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

银行资料请参考：

（1）前置机安装材料

（2）客户相关数据；

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

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

2.      实施流程

银企实施部署流程

3.      搭建建设银行银行前置机程序

3.1.  建设银行前置机环境配置

请注意：搭建银行前置机的操作指南银行一般都会提供，本步骤仅供参考。

l  获取银行前置机安装包

现场实施伙伴或客户方需向银行请求获取银行前置机安装包（如需U盾也需提前准备好）

 前置机安装部署的操作系统要求（最终以银行最新提供为准）：

windowsXP SP2/SP3 32位简体中文操作系统

windows server 2003 32位简体中文操作系统

windows 2000 server 32位简体中文操作系统

l  初始化建行外联版前置机环境

程序第一次运行系统前，需要运行文件夹bin下配置文件的设置.bat进行系统初始化。

然后在弹出的设置界面中录入参数。

参数填写说明：

Ø  客户号：企业用户为企业网银的客户识别号；商户用户为商户代码(ECTIP中显示为商户编号)；

Ø  操作员：企业用户为以”WLPT”开头的外联平台操作员，如“WLPT01”；商户用户为商户的操作员号；

Ø  密码：外联操作员的交易密码；

Ø  端口号：Socket通信的端口号，企业财务应用系统必须向这个端口请求和接收数据。端口号只能是1025至65535之间的值。

Ø  日志大小：log目录下每个wlpt.log日志文件的大小，以MB为单位，默认为20MB。单个文件大小最好不超过20MB。

Ø  日志个数：log目录下wlpt.log日志文件的备份个数，默认为50个。

Ø  代理： 默认不使用代理。

Ø  专线： 默认不使用专线，如需专线，银行也会提供专线的IP地址，端口用户名等。

l  然后需要运行文件夹bin下配置文件的启动服务.bat，如果弹出证书列表为空的提示，则应该先插入U盾或者是安装软证书，U盾还是文件证书都由银行提供的，文件证书安装时需双击证书文件，下一步直到安装完成。

l  接下来需要运行服务器。

若用户是U盾客户，运行之前必须插入U盾。

然后双击文件bin下启动服务.bat，会弹出选择证书然后输入证书密码的窗口，设置完成。

最后提示连接成功，系统正式运行即可完成配置。

若用户是文件证书客户，则无需插入U盾，直接双击文件bin下启动服务.bat，会弹出选择证书然后输入证书密码的窗口完成设置。

最后提示连接成功，系统正式运行即可完成配置。

4.      安装部署银企云

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

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

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

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

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

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

1、前置机IP地址：建设银行外联平台客户端服务所在的服务器IP地址；

2、端口号：与外联客户端设置上的“监听端口”保持一致；

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

4、金蝶代理服务器端口号：由于这个银行批量代发接口6w2102,6w0111

都是通过文件方式处理，需求部署代理程序，对应的是代理程序的“服务端口”，配置参考4.2.1的说明。

5,6,7、分别对应银行客户号、操作员号、操作员密码

8、银行测试服务器日期非当前日期时用上，目前只有电票测试的时候用上，具体配置日期咨询银行，正式环境务必保证为空。

9、渠道客户号目前是给新一代电票使用，银行提供

10、专属前置机

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

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

4.1.2.   配置银企账户

如何添加银企账户？

账户添加完成后，存在部分特殊的参数配置无法在业务端维护时，需要在银企账户附加属性中配置

由于代发接口需要签订代发相关协议，需要配置相关的编码。

建行代发useof_code：银行提供的用途摘要编码，比如00000008表示工资，以银行提供的来配置

建行批量代发文件格式：批量代发模板格式选择，这个一般按客户跟银行签约的模板来选，目前支持广东、上海、四川版本，尽量选择签约这几种，如果是新的模板还需要涉及开发。模板的说明参数：

建行批量代发文件格式)按省份地区划分
上海（首行空）：首行空，字段格式为金额(数值格式，保留两位小数)|付款方账号|收款方账号|收款方名称|收款方开户行名称|摘要
四川（首行不空）：首行不空，字段格式为序号|账号|户名|金额|摘要|备注
广东（首行空）：首行空，字段格式为序号（必填）|账号（必填）|户名（必填）|金额（必填）|跨行标识（建行填0, 他行填1）|行名|联行号（跨行不为空）|摘要|备注
广东（首行不空）：首行不空，字段格式为序号（必填）|账号（必填）|户名（必填）|金额（必填）|跨行标识（建行填0, 他行填1）|