澳新银行直联版部署文档(ANZ_DC）
名称标签：澳新部署、ANZAU_DC、ANZ_DC、ANZHK_DC、ANZNZ_DC、澳新新西兰、澳新澳洲、澳新香港
1. 背景
配置之前，先要和银行申请环境和资料，以下配置只涉及系统配置，对于公有云和私有云的环境配置，请单独咨询。
银行资料请参考：
（1）银行SFTP登录信息
（2）测试使用账套数据；
请仔细阅读文档。清晰步骤了再进行配置。
澳新银行直联版，不需要安装银行前置机软件，是使用金蝶代理程序与银行SFTP交互，完成付款交易、余额查询、交易明细查询，这时候需要生成一个SSH证书。
2. 实施流程
3. 搭建金蝶代理程序
3.1. 金蝶代理程序下载
(1) 根据金蝶社区知识分享提供的银行前置机代理程序安装包和使用手册进行下载启动。
(2) 解压后，直接启动代理程序服务脚本（window启动bat脚本，Linux启动sh脚本）
(3) 启动脚本成功后，打开浏览器（建议谷歌、火狐），默认代理程序端口是9999
(4) 登录代理程序，新的安装包第一次登录有默认用户名密码为kingdee/daily_123
初次登录默认密码需要进行修改，修改符合密码策略要求的密码后重新登录代理程序
(5) 通过左侧的银行参数配置找到澳新银行或直接通过右侧的代理程序服务点击澳新银行的银行版本，进入澳新银行的银行参数配置界面。
l 服务端口：需要对应配置到银企服务的银企连接通道配置对应的端口
l 字符集：默认即可
(6) 配置FTP信息，如下图。
l 定期从银行上传下载文件：默认是300秒，也就是5分钟一次。建议和银行确认后再修改，有的银行FTP可能不允许太过于频繁访问，最终以银行要求为准。
l 配置FTP服务用户名、密码等如下图（均为银行提供的信息）
l 配置FTP证书、证书密码
FTP连接超时配置默认即可。
FTP证书和证书密码需要通过winscp工具生成，步骤如下：
（1）、实施方下载WINSCP软件（版本太旧可能没有puttyGen工具，当前举例版本为5.13.4），点击工具，打开puttyGen工具
（2）、先点击Generate生成密钥对（如果生成比较慢，就移动下鼠标），再点击 Save public key保存公钥文件，把公钥文件发邮件或其他方式能给到对应银行人员部署，这一步很重要。
（3）、 输入密码后点击 Save private key保存私钥，这是一个ppk文件（存档即可，目前没用上）。点击Conversions，再点击Export OpenSSH key，对话框提示点击是，文件名保存叫ssh，这样就生成完毕了。
把生成好的证书保存好，存放的目录填入代理程序的FTP证书目录中，密码填入FTP证书密码（不设置密码则不填）。
（4）、和银行交换好证书后，代理程序也配置好之后，启动代理程序，看到“建立FTP连接成功”则代表配置成功
（5）、配置好之后，如果想通过winscp直接连接银行的sftp查看文件，需要在连接时配上私钥路径。如下图：
l 配置扫描参数
1、扫描的频率（秒）：代理程序定时扫描文件下载的临时保存目录如download目录，也会扫描MT940\MT942和XMLACK扫描存取目录。然后解析后会把解析的文件从MT940\MT942和XMLACK扫描存取目录中删除，然后备份到对应的备份目录中保存。
2、付款xml文件的前缀：付款文件生成文件名的前缀，如付款文件名为
KINGDEE_NZ_CBFT_Pain001_450db2d449442562.xml
3、MT942扫描存取目录： MT942对账单全称是日间对账单，银行白天每隔XX（以银行说的时间为准）主动推送到FTP，代理程序从sftp获取后默认存放到/mt942目录（也可能是先到中间目录download），接着在mt942目录中解析数据入库，解析完毕后会备份该文件到/mt942_bak目录。
4、MT940扫描存取目录：MT940对账单全称是日末对账单，是汇银行早上（以银行说的时间为准）主动推送到FTP，一天只推送一次，汇总了前一天MT942对账单的所有内容。代理程序从sftp获取后默认存放到/mt940目录，接着解析数据入库，解析完毕后会备份该文件到/mt940_bak目录。
5、XMLACK扫描存储目录：付款文件提交银行后，银行会推送XMLACK回盘文件，解析后更新付款状态，代理程序从sftp获取后默认存放到/xmlack目录，接着解析数据入库，解析完毕后会备份该文件到/xmlack_bak目录。
6、（注意，ACK回盘文件是不会更新交易成功状态的，交易成功的状态是根据解析的MT940和942文件中找到对应这笔付款单的交易流水时才确认状态为交易成功，ACK回盘文件正常解析后返回银行处理中状态）
7、金蝶保存付款请求文件目录：通过金蝶发起的付款，生成的付款文件会存储该目录
请注意：以上配置的目录都要真实存在（最新版本代理程序可以自动创建本地的目录，银行的不能创建），不要配置中文、特殊字符的目录。
l 白名单配置
访问IP地址白名单：设置允许访问代理程序的IP地址，比如银企服务、银行服务，务必注意分隔符是英文逗号,
l 是否自动启动：启动代理程序的时候需不需要启动该服务
l 全部配置完成后，启动代理程序服务
4. 安装部署银企云
4.1. 配置【查询与支付】参数
4.1.1. 配置银企连接通道配置参数
（1）登录金蝶云星瀚，进入银企云的应用【查询与支付】
（2）进入【银企连接通道配置】页面，选择澳新银行直联版（按需选择不同国家版本），然后点击新增
（3）进入前置机新增页面，对基础连接配置和网银登录配置参数进行配置
l 金蝶代理程序IP：代理程序所在服务器IP，如果是IP需要映射外网后才能访问，则录入映射后的IP；
l 金蝶代理程序的监听端口：代理程序上配启动服务配置的服务端口，如果是端口需要映射外网才能访问，则录入映射后的端口；
l 并发锁数量：按银行并发能力配置，例如银行支持10个并发，那么3个并发锁数量之和不能大于10，默认都是1；
（4）配置完成后，点击保存，然后点击测试连接；
注意：点击测试连接，代表银企到前置机安装的服务器端口通了；如果不通的话，请检查ip和端口的配置，如果是公有云环境，这里测试连接不通是正常的，需要通过网络代理连接配置中进行测试连接
4.1.2. 配置银企账户
澳新银行账户附加属性维护：
1）进入【银企账户】，修改银企账户
2）账户参数说明如下：
l 账户类别：普通类
l 付款银行BIC SWIFT CODE：外资银行账户付款需要上送付款银行的swiftcode
l 付款银行国家/地区（英文）：外资银行账户付款需要上送英文的国家地区（而且接口路由也需要通过这个英文判断，所以需要配置正确，比如新西兰的国家地区简码是NZ）
l 付款公司名称（英文）：外资银行账户付款需要上送英文付款公司名称
l 付款公司街道名称（英文）：外资银行账户付款需要上送英文的付款公司街道名称
以上几个付款参数后续会从资金账户管理同步过来，但是目前还需要手工在银企同步
用户 ID：澳洲地区ACH付款才使用
4.1.3. 银企联通测试
银企账户配置完成之后，可以尝试测试余额及明细的查询；
在【查询与支付】-银行账户查询内，查询余额，如果余额能够成功查询，代表与银行前置机的通讯是成功的；
注意：澳新银行是通过MT940和942文件推送解析得到交易明细和余额（余额是当天非实时的）
测试步骤分为：SFTP下银行推送了文件--à金蝶代理程序对应配置的目录下下载到该文件-à解析文件（解析完成后会把文件备份到对应的bak目录，然后这个文件就删了）à银企云查询余额、明细就可以查询到数据
请注意：需要有MT940文件解析后才有余额，澳新的MT942文件银行未推送余额。
4.1.4. 银行参数配置
银行参数配置本身有默认参数，如果没有特殊情况可以不用配置。以下对常用的参数进行说明：
4、付款文件包含的付款笔数上限：一批次笔数设置，默认100
6、付款状态超时时间：付款提交超过配置的时间未得到银行响应，将付款状态置为交易未确认。
配置大于0的数字，单位：小时。不设置则不修改交易状态。
4.1.5. 常见的问题
1、访问IP地址白名单要设置哪些
银行SFTP服务器的IP地址、银企云的IP地址，本机IP地址
2、澳新新西兰付款没有生成付款文件
因为付款账号还需要在银企账户的附加属性中添加
3、MT942文件的字段对应含义是什么？
以花旗美国为例，
20：交易参考号
21：相关引用参考号（注意里面的日期一致）
25：银行账号
28C：报表编号/排序号
34F：最低借贷金额（银企不关心金额，只取其中的币别，借贷金额以61中的为准）
61：前六位数字是年月日的日期，接着4位月日的日期，接着C或者D标识借还是贷的标识，如果是D标识这个明细是借款方的，那么金额应出现的交易明细的借方金额字段，如果是C则出现在贷方金额字段。金额则是第一个C或者D后面的数字，如果CD后还有其他字母，则会忽略字母只取数字。NMSC后面到/的位置是明细流水号，如果是通过银企付款单提交产生的流水，这里地方会带上付款的唯一流水号，可以关联到该笔付款单，反写付款单状态为交易成功。
86：是摘要字段，摘要带有6个属性，其中例子中这一笔是贷方的明细，/BN/标识对方户名，值的位置为/BN/后一个位置字段;/BI/是对方的账号，/AB/是对方银行。如果是借方明细，则有所不同，借方明细是按第一个字段是BO1（O是字母）区分，存在BO1的前提下，/BO/对方账号，/OB/是对方银行。假设没有返回BO1，那么会返回OB1，则规则又不一样，此时，/OB1/是对方银行，/OB/是对方账号，/BO/是对方户名
90D：有多少个61是D 的标识，这里的币别USD左边就是有几笔，币别USD右边则是金额之和
90C：有多少个61是C 的标识，这里的币别USD左边就是有几笔，币别USD右边则是金额之和
4、MT940字段含义
以花旗美国为例
20,21,25,28跟942含义一样
60F：币别前六位是日期，币别后则为期初余额（期初余额主要用于交易明细上的余额计算，用期初余额加发生额，比如期初余额100，发送一笔贷方D金额15，则该笔明细的余额为85，然后第二笔借方C金额是5,这笔的余额则变成90）
62F：当前余额
64：可用余额
澳新银行直联版部署文档(ANZ_DC）
本文2024-09-22 23:36:22发表“云星瀚知识”栏目。
本文链接：https://wenku.my7c.com/article/kingdee-xinghan-134102.html
