中信银行直联版部署文档（CITIC_DC）

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

1. 背景

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

银行资料请参考：

（1）前置机安装材料

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

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

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

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

电子回单支持PDF文件

2. 搭建中信银行前置机软件

2.1. 前置机软件下载

https://corp.bank.ecitic.com/cotb/toolDownload.html

2.2. 前置机安装

(1) 双击下载的前置机软件，进行安装

(2) 点击下一步，一直到最后安装完成，然后选择立即运行，进入银企直联软件配置页面

(3) 打开左上角系统，找到系统选项；

(4) 系统选项中本地端口为银企连接参数需要填写的参数信息；

(5) 通讯参数中，根据自己的申请的环境，进行选择。测试环境和生产环境的配置根据银行提供的银企直联安装配置手册进行配置；

2.3. 前置机配置：

2.3.1. 测试环境：

将DLSYCFG.XML替换到银企直联安装目录下，默认路径：C:\Program Files (x86)\CNCB\DLink\SysData，打开银企直联客户端，选择服务器环境。

检测办法：

在浏览器地址栏键入

https:// 测试环境地址/DLink/HOSTS.TXT

1. 正常情况：浏览器显示测试环境地址（例如：127.0.0.1:9081）

2. 如果浏览器报“Internet Explorer 无法显示该页面”，说明网络连接有问题

按照银行提供手册，配置网络访问配置；

3. 如果浏览器地址栏变红或显示“此网站的安全证书有问题”，说明证书有问题

去掉internet选项-高级标签页中的三个勾：

(1) 检查发行商的证书是否吊销（不勾）

(2) 检查服务器证书吊销（不勾）

(3) 对证书地址不匹配发出警告（不勾）

2.3.2. 生产环境

2.3.2.1. 公网及总营专线生产环境

请选择生产机(公网)

2. 检测办法

在浏览器地址栏键入

https://enterprise.bank.eciti c .com/DLink/ H OSTS . TXT

1. 正常情况：浏览器显示 enterprise.bank.ecitic.com:443

2. 如果浏览器报“Internet Explorer 无法显示该页面”，说明网络连接有问题

3. 如果浏览器地址栏变红或显示“此网站的安全证书有问题”，说明证书有问题

如果证书有问题，可以尝试去掉internet选项-高级标签页中的三个勾：

(1) 检查发行商的证书是否吊销（不勾）

(2) 检查服务器证书吊销（不勾）

(3) 对证书地址不匹配发出警告（不勾）

2.3.2.2. 分行专线生产环境

请选择生产机(专线)

检测办法

在浏览器地址栏键入

https:// ecenter.bank.ecitic.com /DLink/HOSTS.TXT

正常情况：浏览器显示 ecenter.bank.ecitic.com:443

如果浏览器报“Internet Explorer 无法显示该页面”，说明网络连接有问题

由于每个分行专线接入ip均不同，所以专线地址需要在操作系统作域名映射，让该域名能够找到对应的专线ip。

找银行配置相关信息后，再进行连接。

6. 如果浏览器地址栏变红或显示“此网站的安全证书有问题”，说明证书有问题

首先安装专线环境的两本证书：

解压zip后得到两个证书文件

依次导入每本证书，双击证书文件，点击“安装证书”，而后按照向导，需要特别注意证书存储位置：

CFCA_CS_CA.cer要导入到“受信任的根证书颁发机构”下；

CFCA_OCA1.cer要导入到“中级证书颁发机构”下。

然后，去掉internet选项-高级标签页中的三个勾：

(4) 检查发行商的证书是否吊销（不勾）

(5) 检查服务器证书吊销（不勾）

(6) 对证书地址不匹配发出警告（不勾）

3. 安装部署银企云

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

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

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

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

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

• 前置机IP地址：安装中信银行银企直联软件的服务器IP；

• HTTP端口号：银企直联软件的监听端口；

• 用户号信息由银行提供测试数据；

（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加密认证密钥：同样搜索开放平台应用，找到第三方应用，点击新增，录入系统编码和认证秘钥等信息，保存后填写到回单系统内；