配置之前,先要和银行申请环境和资料,以下配置只涉及系统配置,对于公有云和私有云的环境配置,请单独咨询。
银行资料请参考:
(1) 前置机安装材料
(2) 客户相关数据;(前置机连接数据、回单下载连接数据)
(3) 测试使用账套数据;
请仔细阅读文档。清晰步骤了再进行配置。
河北银行直联版,需要安装银行前置机来完成付款交易、余额查询、交易明细查询等。
电子回单支持PDF文件;支持通过金蝶代理程序或SFTP获取回单文件;
2. 搭建河北银行前置机软件
2.1. 前置代理软件配置
(1) 解压银行提供的代理软件;
(2) 解压后,执行代理软件内的B2EProxy;
(3) 点击点击帮助下许可信息按钮,进行注册
(4) 将注册信息发给银行对接人员,让银行对接人员生成生产专用license
(5) 替换license文件,拿到生产的license文件后,将图中的文件替换掉,换成生产license文件,右下角关闭代理软件,并重新启动、登陆。
(6) 点击设置下选项按钮设置主机域名以及端口,并将客户端IP和MAC地址截图发给行方对接人员,同时发送企业的账号信息(企业名称和账号)。并且记录监听端口号,配置在银企查询与支付的银企连接通道配置内;
(7) 点击设置下修改通讯密码按钮,新密码对应将来的通信密码
(8) 点击设置下面的地址限定,设置允许访问的ERP/财务软件服务器地址,输入通讯密码,点击确定
2.2. 证书安装
(1) 服务器证书安装:
服务器证书(证书链)所在目录
双击证书进行安装
点击安装证书
根证书需要做上图操作,将根证书存储到受信任的根证书颁发机构,然后点击确定。然后默认到安装完成。
(2) 客户证书安装:
双击客户证书进行安装(安装时全部默认选项),并完成安装。
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) 付款业务参数:
• 付款摘要特殊字符池:付款单据内的摘要信息,如果包含配置的特殊字符,则可以直接置为失败;
(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. 回单前置机配置
河北银行电子回单支持获取历史回单;需要对前置机参数进行配置;回单的推送需要咨询银行,是推送到前置机还是连接SFTP获取,确认好之后,根据实际情况进行配置;
回单支持两种获取方式:
(1) 前置机代理获取:该方式需要安装银企代理前置机,下载地址:https://vip.kingdee.com/knowledge/specialDetail/325350427288158208?category=330013679976556800&id=338705172308159232&productLineId=8 ;
• 代理程序IP:安装代理程序的服务器IP;
• 代理程序电子回单文件服务端口:代理程序内的电子回单的端口,如下图:一定要配置正确的端口
• 银行将回单文件推送到了前置机的哪个文件夹或者是本地的哪个文件夹,代理程序需要从该文件夹获取回单文件;咨询银行;
(2) SFTP服务获取:
• SFTP获取回单需要自行搭建SFTP的服务;然后和银行的SFTP
• 访问银行SFTP的相关信息:IP地址、端口、文件保存路径、SFTP登录的用户名和密码;银行还会提供一个证书文件,需要上传到系统内;
3.2.3. 回单任务列表
回单测试连接成功后,系统会根据回单的调度,自动执行,下载回单;也可以选择手动触发调度任务;
回单调度执行后,会在回单任务列表内,展示回单任务信息,可以查看回单的下载、上传、匹配的情况;