厦门国际银行直联版,需要安装厦门国际银行前置机来完成余额查询、付款、下载交易明细等交易。
厦门国际银行直联版支持下载银行电子回单,需要通过XX获取PDF格式的电子回单,所以需要XXX
1.1. 下载途径
金蝶前置机代理程序下载地址(本银行版本部署文档参考本文档即可):https://vip.kingdee.com/article/95932679937684992
1.2. SFTP
介绍:SFTP是Secure File TransferProtocol(安全文件传送协议)的缩写,可以为文件传输提供一种安全的加密方法。SFTP服务程序可帮助用户通过网络传输文件。
作用:通俗来讲,SFTP服务,就是可以让服务器A访问到服务器B某个文件夹内的文件。(例如:在服务器A上搭建一个SFTP服务,指定A服务器上的一个文件夹作为根目录。服务器B登陆这个SFTP后,就可以通过此SFTP来访问服务器A中指定根目录下的所有内容。服务器A可以理解为银行推送回单文件的服务器,服务器B可以理解为回单程序服务器。)
2. 银行前置机安装、配置
2.1. 安装配置
需要联系银行提供前置机及相关测试材料
1. 安装厦门国际银行前置机,安装完成后,双击进入BiSafe;
2. 选择NC安全HTTP服务,点击上方设置,或者选中后,点击服务,选择配置服务,进入前置机配置页面;
3. 首先配置Server配置,根据银行提供的测试数据,调整监听的端口和后台服务器信息;
4. 然后配置SSL证书。使用方式,先选择硬方式配置安全模块库位置和令牌的名称;然后选择软方式,根据提供的测试材料,选择证书及密钥。
5. 配置完SSL之后,选择配置CRL和CA,将默认的证书文件删除,添加提供的测试资料中的NC-HTTP文件夹下证书链
6. 添加完成这些信息,点击确定,保存配置的参数。然后配置下个模块;选择NC数字信封服务
7. 点击配置后,首先进行Server配置,根据需要配置监听端口,默认为(4436)
8. 重复第四步的操作,配置数字信封内的证书配置,先配置硬签名,再配置软签名。
9. 配置完证书后,配置CRL和CA信息,将默认的证书删掉,仅配置提供的NC-SIGN文件夹下的证书链文件
10. 配置完数字信封内的参数,点击确定,保存参数。
2.2. 启动前置机
配置完上面内容后,分别启动NC安全HTTP服务和NC数字信封服务,启动时需要输入密码,为证书文件密码
3. 安装部署银企云
银企云基于苍穹平台开发,通过在MC系统部署银企云补丁进行环境更新。
3.1. 安装银企云环境
参考苍穹银企云补丁安装与部署进行补丁安装部署
3.2. 配置【查询与支付】参数
3.2.1. 配置银企连接通道配置
(1) 登录金蝶云星瀚,进入银企云的应用【查询与支付】
(2) 进入【银行启用管理】,启用“厦门国际银行直联版”
(3) 进行【银企连接通道配置】,新增或修改“厦门国际银行直联版”,参数配置说明如下:
基础连接配置:
序号1:前置机IP地址,即安装银行前置机的服务器ip;
序号2:端口号,NC安全HTTP服务监听端口;
序号3:签名服务端口号,NC签名服务的监听端口;
序号4:客户号,由银行提供,测试环境和正式环境的相关客户号
基础配置内的其他参数,如果没有特殊要求,可以不做调整,使用默认值即可。
3.2.2. 配置银企账户
一般情况下,银企账户需要在资金云【账户管理】中维护并同步到银企云,具体步骤需要参考资金的指导文档,本文档只针对在银企云中的参数说明。
1) 进入【基础管理】-【银企账户管理】,新增或者修改银企账户
2) 账户参数说明如下:
1 账户类别:一般都是普通类,这个取决于维护的银行账户所属类别,比如如果是虚拟现金池账户就维护成虚拟现金池。
3.2.3. 银行参数配置
银行参数配置本身有默认参数,如果没有特殊情况可以不用配置。以下对常用的参数进行说明:
可根据实际需要配置,如无特殊情况可以不用配置
3.3. 配置【电子回单】参数
【电子回单】应用依赖于【查询与支付】应用,需要先完成【查询与支付】配置后再进行,如客户未使用该银行的电子回单,则忽略本节配置。
3.3.1. 回单参数配置
1) 进行【电子回单】应用,回单参数配置,配置说明如下:
苍穹开放平台api地址:登录苍穹开放平台地址,比如登录地址https://feature.kingdee.com:1026/patchfi/login.html ,则对应的开发平台api地址为https://feature.kingdee.com:1026/patchfi
苍穹开放平台登录用户名:能登录到苍穹开放平台的用户名
开放平台认证系统编码和Access Token加密认证密钥:在苍穹开放平台中配置一个第三方应用,并把系统编码和密码对应填入即可。
数据中心ID:上传回单文件到苍穹文件服务,需要录入的是苍穹平台的数据中心ID,登录到苍穹租户详情界面获取
3.3.2. 回单前置机配置
回单获取方式配置:
如果银行提供了SFTP登录账户下载回单可选择远程SFTP获取,否则不管是银行定时主动推送到某个目录下还是通过先请求银行后推送到某个目录,都选择前置机代理获取的方式,通过部署金蝶前置机代理程序到银行前置机的安装服务器上,从回单文件目录上下载回单。
前置机代理程序IP和端口:分别为部署金蝶前置机代理程序的服务器IP和启动的电子回单文件服务端口,如下图:(详细部署操作请参考第4章安装前置机代理程序)
注意:访问IP地址白名单:需要设置访问代理程序的IP
文件保存路径:当前银行推送的回单文件的目录,假设银行约定好回单文件推送到农行前置机的安装目录下的download目录,如D:\nonghang\download,也就是前置机服务器上的这个目录下是有回单文件的,文件保存路径则配D:\nonghang\download即可,以此类推。
3.3.3. 银行参数配置
银行参数配置关于回单的参数本身有默认参数,如果没有特殊情况可以不用配置。以下对常用的参数进行说明:
中国农业银行公网版的银行参数配置中关于回单的参数有以下:
回单是否从总行推送:总行文件格式和分行不同:比如总行11123412300001234_20200101_CommonSingle_1.zip,分行20200101.zip。因此需要跟银行确认后配置
是否开启回单数完整度检查:默认开启,开启之后回单调度会检查回单数量和明细数量是否一致,如果回单数量小于明细数量会自动重新下载回单,建议不要关闭
是否开启失败自动重试下载电子回单:默认开启,开启之后回单任务失败后,判断是否存在交易流水,如果存在回单任务会自动重试, 3天内的会重新下载。
3.3.4. 回单结果列表
回单结果列表中可以查看当前已下载完成的回单文件,只有上传成功的文件才可以被业务系统下载。