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

栏目：云星瀚知识作者：金蝶来源：金蝶云社区发布：2024-09-22浏览：1

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

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）|行名|联行号（跨行不为空）|摘要|备注
旧版（首行不空）：首行不空，字段格式为付款账号（必填）,金额（必填）,收款账号（必填），收款户名（必填），行别（深圳建行）,摘要（必填）

建行“全国代发代扣BillCode”：一般是银行提供的那个代发业务编号

建行“跨行代发代扣BillCode”：如果跨行的BillCode不一样，需要单独配置

建行现金池主账号：如果该账号是现金池账号，主账号可以配到这个地方

4.1.3. 银企联通测试

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

4.1.4. 银行参数配置

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

1、是否展示集团联动交易：默认情况下，财资类账户不返回集团联动交易的明细，如果需要这种明细，参数设置为是，重新联机查询。

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

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

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

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

6、交易明细摘要取值：

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

8，9,10,三个付款参数可能路由会有组合，因此更详细的付款路由走向需要部署银企云后，在银企云的付款路由图中查看。

8、对私转对公接口付款：对私接口需要跟银行签约代发协议，部分客户对私交易量不大的情况下，跟银行沟通后，允许通过对公的接口去做对私交易时，就可以改这个参数为是来生效。

9、对私批量代发：对私付款接口6W1303是否转批量代发接口6W1301设置

10、付款是否需要网银审批：付款提交银行时是否需要登录银行的网银去审批

11、同行付款是否校验账号户名：建行同行付款之前是否需要调用银行接口6W1101去做账号户名是否匹配的校验，因此接口需要权限，需要校验的客户需要开通接口权限。如果不匹配则不允许付款。

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

13、代发业务参数：

是否启用代发工资业务：默认否，为否时，当业务端发起工资代发单（非报销代发单）时，不允许提交银行，如果客户需要通过该银行做代发工资，则需要改成是，参数改成是后，会显示出代发工资关联参数的属性说明，关联参数仅是说明作用，不影响付款路由选择。