【电子回单】浙商银行直连版（ZSB_DC）回单配置指南

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

浙商银行直连版（ZSB_DC）的回单，是发请求银行推送回单文件的方式。配置步骤如下：

第一步：浙商银行直连版前置机上搭建sftp服务

如果浙商银行直连版前置机和电子回单服务器在同一台服务器上，则不需要搭建sftp服务，跳过此步骤；否则需要在浙商银行直连版前置机这台机器上搭建sftp服务。

银行服务器会把回单推送到浙商银行直连版前置机安装路径的Temp目录下，所以需要以此目录为根目录搭建好SFTP服务，并确保回单代理程序能访问该SFTP服务。

如果用freesshd搭建sftp服务，则sftp的根目录设置为前置机安装路径下的Temp目录。

如何搭建sftp服务？

1）可参考《电子回单程序部署说明V1.0.20230106.docx》文档的“五、附录”操作（下载回单安装包并解压，\ebgProxy_20230106 目录下就有这个文件）

2）搭建sftp服务的工具freesshd可以在帖子中找到下载链接：https://vip.kingdee.com/article/165500974349008896?productLineId=8 ）

搭建sftp服务之后，记录一下sftp服务的SFTP服务的“IP”、“端口”、“账号”、“密码”信息。

需要注意的是，用freesshd搭建的sftp服务，其根目录不支持中文（经验表明，根目录有中文的时候，测试连接不通，且还存在中文乱码问题），所以请将前置机安装在一个非中文路径下。

第二步：登录回单系统，在[配置项 - 银行配置]页面配置相关信息

登录进入电子回单系统后，在[系统配置]页面，“启用银行插件列表”中勾选“浙商银行银企直连版(ZSB_DC)”后保存，然后切换到[银行配置]页面就可以选到这个插件了。

1、银行前置机IP地址、银行前置机端口、客户号/企业自身核心客户号，可以参考银企平台-系统管理-前置机配置页面中，浙商银行直连版前置机IP和端口、客户号/企业自身核心客户号的配置：

2、配置回单获取方式

如果浙商银行直连版前置机和电子回单服务器在同一台服务器上，则回单获取方式选择“本地获取”，然后“银行回单推送路径”配置为浙商银行直连版前置机的Temp目录的全路径。

如果浙商银行直连版前置机和电子回单服务器不在同一台服务器上，则回单获取方式选择“远程sftp获取”，需要把第一步中搭建的sftp服务的“IP”、“端口”、“账号”、“密码”配置到下图所示的“银行SFTP服务器IP地址”、“银行SFTP端口”、“登录SFTP服务器使用的用户名”、“登录SFTP服务器使用的密码”文本框中。保存之后，点【测试连接】按钮，测试连接通过后，再去下载回单。

第三步：任务的[创建]->[预处理] ->[下载] ->[扫描]阶段

为了快速的看到效果，可以在[配置项 - 银行配置]页面，将“浙商银行电子回单调度方式”修改为“测试使用”（测试调度仅需要大约4分钟就可以完成一次调度）。修改并保存后，在[模块管理]页面重启【回单模块】生效。

1、创建调度

自动创建所有回单账号的前一天的回单任务。

刚部署的情况下是没有任务的，可以手动添加一个任务进行测试。如下图所示，点【+添加任务】按钮进行添加。注意：不要添加今日的任务，因为这个银行插件不支持当日回单下载。

2、预处理调度

1）根据任务的银行账号、回单日期，调用查询账户明细信息（200112交易）接口，交易成功后，获取到交易明细文件名，同时浙商银行前置机安装目录的Temp目录下也会生成这个交易明细文件。

2023-11-02 11:09:00.135  INFO [ZSB_DC,,1719383728142155777] 3256 --- [pool-2-thread-80] c.k.b.b.z.dc.job.ZsbDcFetchListImplFlow : 浙商银行查询账户明细信息（200112交易）-请求报文：page1
737       00<ap>
    <head>
        <tr_code>200112</tr_code>
        <cms_corp_no>5xxxxxxxx</cms_corp_no>
        <user_no></user_no>
        <org_code></org_code>
        <serial_no></serial_no>
        <req_no>1719914475718443008</req_no>
        <tr_acdt>20231102</tr_acdt>
        <tr_time>110900</tr_time>
        <channel>5</channel>
        <sign>0</sign>
        <file_flag>1</file_flag>
        <reserved></reserved>
    </head>
    <body>
        <acno>3xxxxxxxxxxxxxxxxxxxx7</acno>
        <cur_code>01</cur_code>
        <start_date>20231031</start_date>
        <end_date>20231031</end_date>
        <pageno>1</pageno>
        <isReceipt>1</isReceipt>
        <totalfilename></totalfilename>
    </body>
</ap>
2023-11-02 11:09:01.720  INFO [ZSB_DC,,1719383728142155777] 3256 --- [pool-2-thread-80] c.k.b.b.z.dc.job.ZsbDcFetchListImplFlow : 浙商银行查询账户明细信息（200112交易）-响应报文：page1
000000058500
<ap>
    <head>
        <tr_code>200112</tr_code>
        <cms_corp_no>5xxxxxxxx</cms_corp_no>
        <user_no></user_no>
        <req_no>1719914475718443008</req_no>
        <serial_no>11336211</serial_no>
        <tr_acdt>20231102</tr_acdt>
        <tr_time>110900</tr_time>
        <succ_flag>0</succ_flag>
        <ret_info>交易成功</ret_info>
        <ret_code>0000</ret_code>
        <ext_info></ext_info>
        <reserved>1</reserved>
        <file_flag>1</file_flag>
        <org_code></org_code>
    </head>
    <body>
        <totalfilename>TSYQ2023110211336211_tmp</totalfilename>
        <record_num>7</record_num>
        <total_record_num>7</total_record_num>
        <field_num>23</field_num>
        <file_name>2023110211336209</file_name>
    </body>
</ap>
2023-11-02 11:09:01.722  INFO [ZSB_DC,,1719383728142155777] 3256 --- [pool-2-thread-80] c.k.b.b.z.dc.job.ZsbDcFetchListImplFlow : 交易明细文件名：[2023110211336209]

2）访问浙商银行前置机上的sftp服务，下载这个交易明细文件 “2023110211336209”，获取到银行流水号serial_no

3）根据账号、交易日期、银行流水号（查询方式为1时必传；200112返回明细文件中的serial_no银行流水号字段），调用单笔交易回单文件下载（200120 交易）接口，获取到回单文件名（查询方式为1时文件名为银行流水号）。有几条交易明细，就要调用几次这个200120接口。交易成功之后，浙商银行前置机安装目录的Temp目录下就生成了回单文件。

2023-11-02 11:10:02.061  INFO [ZSB_DC,,1719383728142155777] 3256 --- [pool-2-thread-80] c.k.b.b.z.dc.job.ZsbDcFetchListImplFlow : 浙商银行单笔交易回单查询（200120）-请求报文：
641       00<ap>
    <head>
        <tr_code>200120</tr_code>
        <cms_corp_no>5xxxxxxxx</cms_corp_no>
        <user_no></user_no>
        <org_code></org_code>
        <serial_no></serial_no>
        <req_no>1719914735454912512</req_no>
        <tr_acdt>20231102</tr_acdt>
        <tr_time>111002</tr_time>
        <channel>5</channel>
        <sign>0</sign>
        <file_flag>0</file_flag>
        <reserved></reserved>
    </head>
    <body>
        <accno>3xxxxxxxxxxxxxxxxxxxx7</accno>
        <date>20231031</date>
        <query_type>1</query_type>
        <serial_no>31031026099482000001</serial_no>
    </body>
</ap>
2023-11-02 11:10:05.845  INFO [ZSB_DC,,1719383728142155777] 3256 --- [pool-2-thread-80] c.k.b.b.z.dc.job.ZsbDcFetchListImplFlow : 浙商银行单笔交易回单查询（200120）-响应报文：
000000044900
<ap>
    <head>
        <tr_code>200120</tr_code>
        <cms_corp_no>5xxxxxxxx</cms_corp_no>
        <user_no></user_no>
        <req_no>1719914735454912512</req_no>
        <serial_no>29248721</serial_no>
        <tr_acdt>20231102</tr_acdt>
        <tr_time>111004</tr_time>
        <succ_flag>0</succ_flag>
        <ret_info>交易成功</ret_info>
        <ret_code>0000</ret_code>
        <ext_info></ext_info>
        <reserved>1</reserved>
        <file_flag>1</file_flag>
        <org_code></org_code>
    </head>
    <body>
        <file_name>31031026099482000001.pdf</file_name>
    </body>
</ap>