【电子回单】杭州银行财资系统（HZYQ_DC）回单配置指南
杭州银行财资系统（HZYQ_DC），银行推送回单的方式是发请求银行推送回单文件。具体来讲，是回单平台调用电子回单批量申请（BY0010）接口，受理成功后，银行服务器推送回单文件到客户自己搭建的一台sftp服务上。
一、配置前的准备工作
可以在安装杭州银行财资系统前置机的这台机器上，或者回单服务器上，或者另外一台独立的机器上，搭建一个sftp服务。搭建sftp服务的过程可以参考《电子回单程序部署说明V1.0.20230106.docx》文档的“五、附录”操作（下载回单安装包并解压，\ebgProxy_20230106 目录下就有这个文件；注意，sftp的根目录不要有中文）。
搭建sftp服务之后，记录一下sftp服务的“IP”、“端口”、“账号”、“密码”信息，需要将这些信息发给银行方（如果是走公网，那还需要将ip和端口映射到外网ip和端口，再提供给银行方）。搭建sftp服务且银行方进行配置后，调用BY0010接口发请求且受理成功后，银行方就会把回单文件推送到这个sftp上。
注意，sftp服务的根目录，这个文件夹的权限要设置一下，参考下图（选中文件夹-右键-属性-安全-编辑，选中Users后设置其权限），类似这样：
发BY0010请求后，银行方推送的回单文件是一个压缩文件（压缩包有2种命名方式：1.交易日期_流水号.zip;2.请求日期_流水号.zip）。下图所示的压缩包的命名方式是“请求日期_流水号.zip”：
压缩包解压后内容如下：
二、回单代理程序 - 配置项 - 银行配置
1. 前置机配置信息和银行业务配置信息
以下配置项可以参考 银企平台 - 系统管理 - 前置机配置页面中，杭州银行财资系统(HZYQ_DC)的配置：
银行前置机IP地址
银行前置机端口
系统客户号
ERP标识
2. 回单获取方式
提供两种方式获取回单文件。
如果回单平台和SFTP服务器不在一台机器上，需要通过【远程sftp获取】。
如下图所示，回单获取方式选择“远程sftp获取”后，需要把你在“一、配置前的准备工作”这一步骤中搭建的sftp服务的“IP”、“端口”、“账号”、“密码”配置到下图所示的“银行SFTP服务器IP地址”、“银行SFTP端口”、“登录SFTP服务器使用的用户名”、“登录SFTP服务器使用的密码”文本框中。保存之后，点【测试连接】按钮测试是否可以连通sftp。
如果回单平台和邮储银行前置机软件在同一台机器，可以直接【本机获取】。
如下图所示，“银行回单推送路径”配置为sftp服务的根目录即可。
3. 银行推送的压缩包日期
杭州银行推送回单压缩包会有两种命名方式。1.交易日期_流水号.zip;2.请求日期_流水号.zip，请根据银行推送的压缩包方式选择。
如果一开始不知道银行推送的压缩放命名方式是哪种，那就先采用默认方式，待任务变成预处理完成后，到sftp根目录下观察下银行推送的回单压缩包名称中的日期是请求日期还是交易日期？然后再到回单平台-银行配置页面去配置。
三、任务的[创建]->[预处理] ->[下载] ->[扫描]阶段
1. 创建调度
创建杭州银行财资系统的回单任务。
2. 预处理调度
在预处理调度节点，回单平台根据银行账号、交易日期，调用电子回单批量申请接口（BY0010），报文如下：
2023-09-15 17:27:00.027 INFO [HZYQ_DC,,1702351498437984256] 4208 --- [pool-3-thread-50] c.k.b.b.hzyq.dc.job.HzyqDcFetchListJob : 杭州银行电子回单查询请求url： http://172.xxx.xxx.xxx:8099/BisOutWeb//payCenter/dealReq.srv 2023-09-15 17:27:00.027 INFO [HZYQ_DC,,1702351498437984256] 4208 --- [pool-3-thread-50] c.k.b.b.hzyq.dc.job.HzyqDcFetchListJob : 杭州银行银企正式回单单笔信息查询 请求：0000046301BY0010<?xml version="1.0" encoding="GBK"?> <body> <head> <erpSysCode>xxxxxxxxx</erpSysCode> <custNo>xxxxxxxxx</custNo> <tradeName>BY0010</tradeName> </head> <map> <compFlowNo>1702614984535572481</compFlowNo> <beginDate>2023-09-14</beginDate> <endDate>2023-09-14</endDate> </map> <loopData> <row> <bankAcc>1xxxxxxxxxxxxxxxxxx4</bankAcc> </row
【电子回单】杭州银行财资系统（HZYQ_DC）回单配置指南
声明：除非特别标注，否则均为本站原创文章，转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益，可联系本站删除。
