平安银行电子回单推送需配置银行前置机SFTP信息,包括前置机与企业端间FTP设置。前置机与回单系统可不在同机,需搭建SFTP服务。回单系统根据服务器配置选择本机或远程SFTP获取回单。任务失败后咨询得知需开通查回单权限,权限生效有延迟。首次回单含近一月数据,之后仅当日。
平安银行推送电子回单的方式是发请求银行推送回单文件,在电子回单平台 - 配置项 - 银行配置页面,需要配置银行前置机、以及前置机上搭建的SFTP信息。
一、首先,在银行前置机配置页面,【面向银行端配置】- ⑦号路径-SFTP服务端配置-在需要FTP传输文件场景配置银行法FTP的信息,这里需要配置上银行方提供的FTP信息(注意:需要提供前置机公网出口IP供银行开墙申请访问。)
二、然后,在【面向企业端配置】-FTP服务器配置-⑧号路径中,“企业服务器与前置系统间传文件是否使用FTP ”配置为“不使用”,下方会出现一个“本地默认目录”,这里你可以配置为前置机所在服务器本地绝对路径(注意目录最好不要用中文命名),调用FILE03接口时回单会下载到默认目录下。
三、如果平安银行前置机和回单系统不在同一台服务器上,那还需要在前置机这台服务器上搭建一个SFTP服务,如何搭建SFTP服务?
一般可以参考回单部署文档的第五章附录,如果是Windows操作系统,可以安装sftp服务端工具 freesshd,下载路径在帖子中可以找到:https://vip.kingdee.com/article/165500974349008896?productLineId=8
安装freesshd之后,以管理员身份运行,将这个SFTP服务的根路径配置为步骤二中的本地默认目录。
四、在回单系统-配置项-银行配置这里,配置SFTP的信息。
如果平安银行前置机和回单系统在同一台服务器上,回单获取方式选择“本机获取”,“银行回单推送路径”配置文件步骤二中的本地默认目录
如果平安银行前置机和回单系统不在同一台服务器上,回单获取方式选择“远程sftp获取”,下方的银行SFTP服务器IP地址、银行SFTP端口、登录SFTP服务器使用的用户名、登录SFTP服务器使用的密码等配置为步骤三搭建的SFTP服务相关的信息。
前置机和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)
咨询银行人员,反馈需要开通一下账号查回单的权限,提交申请之后第二天才会生效(今天维护后有交易次日生成回单)。
ps:首次产生的回单压缩包里解压后会有近一个月的回单,之后的日期只有一天的回单。
如下图:
推荐阅读