【电子回单】杭州银行财资系统（HZYQ_DC）回单配置指南

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

杭州银行财资系统（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>
    </loopData>
</body>

2023-09-15 17:27:07.269  INFO [HZYQ_DC,,1702351498437984256] 4208 --- [pool-3-thread-50] c.k.b.b.hzyq.dc.job.HzyqDcFetchListJob  : 杭州银行银企正式回单单笔信息查询 响应：0000047301BY0010<?xml version="1.0" encoding="GBK"?>
<body>
    <head>
        <custNo>xxxxxxxxx</custNo>
        <tradeName>BY0010</tradeName>
        <retCode>0</retCode>
        <erpSysCode>xxxxxxxxx</erpSysCode>
        <retMsg>查询成功</retMsg>
    </head>
    <loopData>
        <row>
            <orderNo>1702614984535572481</orderNo>
            <orderSRR>[账号:1xxxxxxxxxxxxxxxxxx4受理成功！]</orderSRR>
            <orderSTT>0</orderSTT>
            <bankAcc>1xxxxxxxxxxxxxxxxxx4</bankAcc>
        </row>
    </loopData>
    <map>
        <recordTotal>本次查询1家银行回单信息,成功受理回单5个文件。</recordTotal>
    </map>
</body>

预处理调度结束后，任务变成“预处理完成”状态，此时点【详情】按钮可以看到获取到的文件名：

3. 下载调度

下载调度阶段，通过【远程sftp获取】或者【本机获取】的方式，把回单压缩包文件下载到\tempPath\HZYQ_DC\目录下，然后进行解压，并对回单文件重新命名后移动到\scanPath\HZYQ_DC目录下（重命名的文件名称命名规则为：银行账号_交易日期_交易序号.pdf）。

至此，下载任务结束，任务的状态会变成“下载完成”。但此时点击【结果】是空的，要等扫描调度结束才能看到结果。

4. 扫描调度

对下载到scanPath\HZYQ_DC\目录的文件进行扫描，解析出结构化数据保存到回单库的表中（主要是这两个表：t_receipt_detail、t_receipt_info ），同时将文件保存到bakPath\HZYQ_DC\目录下。扫描调度结束后，可点击回单任务的【结果】查看回单的结构化数据。

扫描调度结束，点任务的【结果】按钮可以看到回单的文件路径、回单匹配码等信息，如下图所示：

四、常见问题

在预处理调度阶段，调用接口BY0010发请求且返回“受理成功”后，银行方可能不会立刻推送文件到sftp服务上，所以回单调度方式不要配置为【测试使用】，否则在下载调度节点任务可能会失败。可以咨询下银行方，发请求后大概要个多久推送文件过来？或者也可以先观察下发请求后sftp根目录下多久会有回单压缩包文件生成？例如要隔15分钟，那么回单调度方式要么配置为【正式使用】，要配置为【自定义】的话，预处理和下载调度的调度周瑶至少要设置为15分钟。