平安银行推送电子回单的方式是发请求银行推送回单文件，在电子回单平台 - 配置项 - 银行配置页面，需要配置银行前置机、以及前置机上搭建的SFTP信息。

一、平安银行前置机【面向银行端配置】

    在银行前置机配置页面，【面向银行端配置】- ⑦号路径-SFTP服务端配置-在需要FTP传输文件场景配置银行法FTP的信息，这里需要配置上银行方提供的FTP信息（注意：需要提供前置机公网出口IP供银行开墙申请访问。详细请查看银行方提供的部署文档说明）

二、平安银行前置机【面向企业端配置】

    在【面向企业端配置】-FTP服务器配置-⑧号路径中，“企业服务器与前置系统间传文件是否使用FTP ”配置为“不使用”，下方会出现一个“本地默认目录”，这里你可以配置为前置机所在服务器本地绝对路径（例如你在D盘下创建了一个文件夹pingan，那这里可以配置为D:\pingan。注意，目录最好不要包含中文），调用FILE03接口时电子回单会下载到这个本地默认目录下。

    需要说明的是，如果“企业服务器与前置系统间传文件是否使用FTP”配置为“使用”，如下图这样配置：

    那么，在电子回单系统-银行配置页面回单获取方式要选择“远程sftp获取”，sftp的信息跟上面这个截图配置的一样即可：

三、搭建银行SFTP服务

    如果步骤二中，“企业服务器与前置系统间传文件是否使用FTP ”配置为“不使用”，且平安银行前置机和回单系统不在同一台服务器上，那还需要在平安银行前置机这台服务器上搭建一个SFTP服务，如何搭建SFTP服务？

    可以参考回单部署文档的第五章 附录操作。如果是Windows操作系统，可以安装sftp服务端工具 freesshd，下载路径在帖子中可以找到：https://vip.kingdee.com/article/165500974349008896?productLineId=8。安装freesshd之后，以管理员身份运行，将这个SFTP服务的根路径配置为步骤二中的本地默认目录。

四、回单代理程序 - 配置项 - 银行配置

1. 部分配置项请参考银企平台进行配置

    一般情况下，在配置回单之前，已经在银企平台测试了余额、交易明细、付款等业务，所以回单系统-银行配置页面的部分配置项可参考 银企平台 - 系统管理 - 前置机配置页面 - 平安银行直连版（PAB_DC）的配置，涉及到下面几个配置项：

• 银行前置机IP地址

• 银行前置机端口

• 直连码

• 操作员码

2. 配置回单获取方式

    如果步骤二中“企业服务器与前置系统间传文件是否使用FTP ”配置为“不使用”，且平安银行前置机和回单系统在同一台服务器上，回单获取方式可以选择“本机获取”，下图中“银行回单推送路径”配置文件步骤二中的本地默认目录。

    如果步骤二中“企业服务器与前置系统间传文件是否使用FTP ”配置为“不使用”，且平安银行前置机和回单系统不在同一台服务器上，回单获取方式要选择“远程sftp获取”，下图中的银行SFTP服务器IP地址、银行SFTP端口、登录SFTP服务器使用的用户名、登录SFTP服务器使用的密码等配置为步骤三搭建的SFTP服务相关的信息。

    如果“企业服务器与前置系统间传文件是否使用FTP”配置为“使用”，那么在电子回单系统-银行配置页面回单获取方式需要选择“远程sftp获取”，sftp的信息跟平安银行前置机【面向企业端配置】-FTP服务器配置-⑧号路径那里配置的SFTP信息一致即可。

    注意，如果“企业服务器与前置系统间传文件是否使用FTP”配置为“使用”，那银行推送的回单文件可能为.enc后缀的加密文件，回单平台解析不了，任务会失败；所以这种情况下，需要把“企业服务器与前置系统间传文件是否使用FTP”配置为“不使用”，从下面的前置机日志可以看出，文件会下载到本地目录下且进行解密。

3. 平安银行电子回单查询接口

    目前支持两个接口：

• F00101

    默认不提供，需要联系银行客户经理申请配置才可以提供。银行提供的是PDF结尾的整日汇总回单和一个压缩包。压缩包里面的回单文件名称的格式为：账号_日期_流水号_借贷_摘要_明细序号_回单类型.pdf。因为需要将交易明细跟电子回单进行匹配，所以金蝶电子回单代理程序只会获取压缩包内的回单，另外一个汇总的pdf回单不会作处理。

    该类型的回单下载流程：F00101查询T-1日的回单文件名及随机密码，然后调用FILE03进行文件下载。

• ELC002

    用于下载单笔回单（一笔交易生成一个PDF），银行提供的是一个zip压缩包，解压开其中是每笔交易的PDF文件，文件名称示例：15000100714429_20200512_3240792005128700011002_D_EBK_000001_001.pdf。这个接口只能下载15天以内的回单。

    该类型回单下载流程：通过ELC002查询T-1日的回单文件名及随机密码，然后调用FILE03进行文件下载。

• ELC009

    可以下载三年内的回单，但是因为要一个一个回单请求下载，所以下载速度会很慢,一般用于补下ELC002超期的回单。若要对此笔交易生成PDF，需要再次调用ELC010接口，然后调用FILE03进行文件下载。使用此接口的详细调用过程为：

1）根据银行账号、交易日期，调用[4013接口]交易明细查询接口查询交易明细，获取到银行账号、交易日期、主机流水号、借贷标识、摘要；

2）根据银行账号、交易日期，调用[ELC009接口]回单查询接口，获取到回单的信息，如记录序号SeqNo、回单类型ReceiptType、记账日期AccountDate；

3）根据银行账号、交易日期（保持和ECL009的查询日期相同）、记录序号SeqNo、记账日期AccountDate、回单类型RecepitType（取ELC009接口应答的list. SeqNo、list.AccountDate、list. ReceiptType），调用[ELC010接口]回单生成回单文件名称FileName和随机密码RandomPwd；

4）根据ELC009接口应答的回单文件名称和随机密码，调用[FILE03接口]下载回单。

4. 是否获取当日回单

    如果选择"是"请对下方【[当日回单创建]任务调度配置】进行设置。

    获取当日回单，实现过程大概如下：

1）先调用查询账户当日历史交易明细[4013]接口获取到交易明细记录，主要是HostTrace（主机流水号，又叫核心流水号）；

2）然后，根据账号、核心流水号信息，调用当日PDF回单文件查询接口[ELC008]接口获取到文件名称，文件命名规则：核心流水号_帐号_日期_起始条数+显示条数.pdf；

    如果某条交易明细没有核心流水号，或者交易明细查询结果为空，回单日志会输出以下内容：

YQ9993:查询没有的对应流水的记录，请重新确认核心流水号，该交易为自动扣款，银行不提供回单，跳过该明细回单获取。

ES0200:查询结果为空，该交易交易对手账号为内部账号或者为空，银行不提供回单，跳过该明细回单获取。

3）再调用FILE03接口下载电子回单文件，并重命名回单文件的名称，文件命名规则：账号_日期_核心流水号_借贷_摘要.pdf

 说明：

1）旧版本中，【是否获取当日回单】选择【是】的时候，那即使查历史回单，也是调用当日回单的接口。那“平安银行电子回单查询接口”的配置就不会生效了。最新版本20230720做了优化，【是否获取当日回单】选择【是】的时候当日回单下载调用当日回单接口，历史回单下载调用历史回单接口。

2）如果是EAS客户，建议不要去获取当日回单。

原因如下：

当日回单银行返回的文件名信息较少，所以金蝶电子回单代理程序为pdf文件进行了重命名操作，按照【账号_日期_主机流水号_借贷_摘要】来命名；但历史回单，文件名是压缩包中的原始文件名，回单系统没做处理，跟当日回单的pdf的文件名不一样。

而EAS这边，下载回单结构化数据和下载pdf，是两个不同的动作（对应不同的按钮和不同的后台事务）。如果在当天下载了当日回单的结构化数据（同时会保存回单pdf文件的名称），但当天没有下载pdf文件，到了第二天或之后再去下载pdf文件的话，此时根据EAS电子回单表中的文件名去下载pdf，那么这个文件找不到了了，因为金蝶电子回单代理程序这边的回单的文件名发生了变化。

五、任务的[创建]->[预处理] ->[下载] ->[扫描]阶段

     可参考《电子回单程序部署说明V1.0.20230106.docx》文档的第三章“7.回单下载配置”操作，这里不再赘述。

六、常见问题

1、银企平台 - 业务管理 - 银行业务配置 - 平安银行电子回单格式

    平安银行支持两种格式的回单：报文、文件。如果客户要下载的是文件格式的回单，那在部署回单代理程序、配置并下载平安银行的回单之后，还要在银企平台 - 业务管理 - 银行业务配置页面，把“平安银行电子回单格式”设置为“文件”，重启银企服务生效。

2、前置机和SFTP信息配置之后，并测试通过之后，就可以新建任务尝试下载回单了，任务失败了，提示：获取回单列表失败……

    如下图所示：

日志如下：

2022-12-16 11:34:00.275  INFO [PAB_DC,,1603419611519254529] 3060 --- [pool-2-thread-16] c.k.b.b.p.dc.job.PABDCFetchListImplFlow : 平安银行[ELC002接口]回单查询请求: 

A0010101010010440012209132069E0000000117ELC0022000901202212161134001603594262899851265                                                                                                           000001RSA-SHA1    00000000000<?xml version="1.0" encoding="GBK"?><Result><QueryDate>20221215</QueryDate><Account>15000102342115</Account></Result>

2022-12-16 11:34:00.409  INFO [PAB_DC,,1603419611519254529] 3060 --- [pool-2-thread-16] c.k.b.b.p.dc.job.PABDCFetchListImplFlow : 平安银行[ELC002接口]回单查询响应：A0010101010010440012209132069E0000000000ELC0022000902202212161134001603594262899851265 MA0103:没有满足条件记录                                                                                   000001RSA-SHA1    00000000000

2022-12-16 11:34:00.409  INFO [PAB_DC,,1603419611519254529] 3060 --- [pool-2-thread-16] c.k.b.bank.pab.dc.utils.ResponseParser  : 返回码 : MA0103 ,返回描述:没有满足条件记录

2022-12-16 11:34:00.409  INFO [PAB_DC,,1603419611519254529] 3060 --- [pool-2-thread-16] c.k.b.b.p.dc.job.PABDCFetchListImplFlow : 平安银行[ELC002接口]回单查询响应报文体: 

2022-12-16 11:34:00.409  INFO [PAB_DC,,1603419611519254529] 3060 --- [pool-2-thread-16] c.k.b.r.r.atom.AbstractReceiptListFlow  : 执行获取列表过程发生异常。

com.kingdee.bos.receiptmanage.receipt.exception.ReceiptException: 获取回单列表失败

at com.kingdee.bos.bank.pab.dc.job.PABDCFetchListImplFlow.doJob(PABDCFetchListImplFlow.java:104)

at com.kingdee.bos.receiptmanage.receipt.atom.AbstractReceiptListFlow.doTask(AbstractReceiptListFlow.java:137)

at com.kingdee.bos.receiptmanage.receipt.atom.AbstractReceiptListFlow.access$000(AbstractReceiptListFlow.java:29)

at com.kingdee.bos.receiptmanage.receipt.atom.AbstractReceiptListFlow$MyTask.run(AbstractReceiptListFlow.java:337)

at java.util.concurrent.Executors$RunnableAdapter.call(Unknown Source)

at java.util.concurrent.FutureTask.run(Unknown Source)

at java.util.concurrent.ThreadPoolExecutor.runWorker(Unknown Source)

at java.util.concurrent.ThreadPoolExecutor$Worker.run(Unknown Source)

at java.lang.Thread.run(Unknown Source)

Caused by: com.kingdee.bos.receiptmanage.receipt.exception.ReceiptException: 银行返回无记录。报文：

at com.kingdee.bos.bank.pab.dc.utils.ResponseParser.responseXMLParser(ResponseParser.java:109)

at com.kingdee.bos.bank.pab.dc.job.PABDCFetchListImplFlow.doJob(PABDCFetchListImplFlow.java:74)

    咨询银行人员，答复需要开通一下账号查回单的权限，且提交申请之后第二天才会生效（今天维护后有交易次日生成回单）。

    说明：首次产生的回单压缩包里解压后会有近一个月的回单，之后的日期只有一天的回单。

如下图：

3、回单任务失败，回单日志显示：下载文件RECPDF_xxxxxxxxxxxx_20230720.zip失败

    连接银行SFTP服务，查看回单文件是否为以.enc结尾。如果是，在前置机配置页面“企业服务器与前置系统间传文件是否使用FTP”配置为改为“不使用”，会出现一个本地路径，在前置机的服务器上重新搭建一个SFTP服务，这个SFTP的路径设置为前置机8号路径中你设置的那个本地路径，然后回单平台-银行配置页面选择【远程SFTP获取】连接你搭建的这个SFTP服务。