【电子回单】中国邮政储蓄银行直联2.0系统（PSBC_SRDC）回单配置指南
中国邮政储蓄银行直联2.0系统（PSBC_SRDC），银行推送回单的方式是发请求银行推送回单文件。具体来讲，是根据明细查询接口1026返回的日期和流水号，通过5006接口实时下载回单文件，文件存放在客户的指定的ftp文件服务器。
一、配置前的准备工作
邮储的前置机程序是由银行技术人员部署的，或者实施顾问在银行技术人员的指导下参考《互联网企业前置部署手册V1.6.2.docx》部署的。跟回单相关的配置包括：
1、需要搭建一个sftp服务
一般是在邮储前置机这台机器上搭建一个sftp服务。搭建sftp服务的过程可以参考《电子回单程序部署说明V1.0.20230106.docx》文档的“五、附录”操作（下载回单安装包并解压，\ebgProxy_20230106 目录下就有这个文件）。
搭建sftp服务之后，记录一下sftp服务的SFTP服务的“IP”、“端口”、“账号”、“密码”信息。注意，sftp服务的根目录这个文件夹的权限要设置一下，参考下图（选中文件夹-右键-属性-安全-编辑，选中Users后设置其权限），类似这样：
2、邮储前置机配置文件config.properties中“#FTP相关”部分
一般是在邮储前置机这台机器上搭建ftp/sftp服务器，通过5006接口下载回单后，回单文件会上传到ftp/sftp服务器的目录下。
在config.properties配置文件中，按对应配置项正确配置ftp信息：SFTP类型、地址、端口、用户名、密码、上传目录等信息。如ftp信息配置错误，会导致无法连接ftp服务器，上传下载文件失败。
注意，“CUSTOMER_FTP_PATH”是相对于sftp根目录的路径，这里配置为/ 就表示回单文件要上传到sftp的根目录下。
--------------------------------
#FTP相关
#文件类交易是否对文件处理：0-不处理，直接转发，1-处理（上传委托方FTP）
FILE_PROCESS=1
#如果涉及到电子回单类或者推送类交易，则需要配置，具体配置为委托方的FTP或SFTP服务器
#0不使用SFTP;1使用SFTP
SFTP_EANBLE=1
CUSTOMER_FTP_IP=1xxx.xxx.xxx.xx2
CUSTOMER_FTP_PORT=2x
CUSTOMER_FTP_USERNAME=kxxxxxx2
CUSTOMER_FTP_PASSWORD=xxxxxxxx
CUSTOMER_FTP_PATH=/
#下列两项通常不填=/app/cpef/qzm/yuyan/
CUSTOMER_SFTP_PRIVATE_KEY=
CUSTOMER_SFTP_PASS_PHRASE=
#文件临时存放路径
FILE_TMP_PATH=C:\\tmp\\
--------------------------------
3、config.properties配置文件中回单配置信息部分
因为要用到5006接口，所以下面config.properties配置文件中下面这里要注意一下：
--------------------------------
#5006压缩包命名配置:分隔符+域名（用,隔开）
5006_ZIP_NAME=_Trans_Time,Query_Account
#5006单个pdf命名配置：分隔符+域名（用,隔开）
5006_PDF_NAME=_Reserved2,Trans_Date
#5006交易是否需要压缩后推送FTP/SFTP：1-压缩，0-不压缩
5006_ZIP=0
##############批量电子回单##############
#批量电子回单存放路径
PDF_FILE_PATH=C:\\3020\\
#批量pdf文件名(标签名拼接,标签名之间用","隔开 例：Opname,Message)
BATCH_PDF_NAME=_1,11,10
BATCH_PDF_CODE=3020
ZIP_NAME=File_Name
--------------------------------
“5006交易是否需要压缩后推送FTP/SFTP”配置为“0-不压缩”，那么上传到sftp目录下的回单文件是PDF文件，而不是压缩包，如下图所示：
另外，上面的配置文件中，压缩包的命名方式为：
#5006压缩包命名配置:分隔符+域名（用,隔开）
5006_ZIP_NAME=_Trans_Time,Query_Account
如果回单很多，可能文件名会重复、覆盖，所以文件名可以增加Seq_no，如下图所示（重启邮储前置机服务生效）：
二、回单代理程序 - 配置项 - 银行配置
1. 前置机配置信息和银行业务配置信息
以下配置项可以参考 银企平台 - 系统管理 - 前置机配置页面中，中国邮政储蓄银行直联2.0系统(PSBC_SRDC)的配置：
银行前置机IP地址
银行前置机端口
集团客户号
外系统代码
前置机访问地址
通讯协议
2. 回单获取方式
提供两种方式获取回单文件：
如果回单平台和邮储银行前置机软件不在同一台机器，可以通过【远程sftp获取】。
如下图所示，回单获取方式选择“远程sftp获取”后，需要把你在“一、配置前的准备工作 1、需要搭建一个sftp服务”这一步骤中搭建的sftp服务的“IP”、“端口”、“账号”、“密码”配置到下图所示的“银行SFTP服务器IP地址”、“银行SFTP端口”、“登录SFTP服务器使用的用户名”、“登录SFTP服务器使用的密码”文本框中。保存之后，点【测试连接】按钮测试是否可以连通sftp。
如果回单平台和邮储银行前置机软件在同一台机器，可以直接【本机获取】。
回单获取方式选择“本地获取”后，“银行回单推送路径”配置为你搭建的sftp服务的根目录（如果config.properties配置文件“CUSTOMER_FTP_PATH”配置为/ 的话）即可。
三、任务的[创建]->[预处理] ->[下载] ->[扫描]阶段
1. 创建调度
创建广发银行的回单任务。
2. 预处理调度
首先，根据银行账号、交易日期，调用账户明细查询接口1026，获取到流水号（Reserved2），报文如下：
邮储银行新版本-1026接口请求报文-9xxxxxxxxxxxxxxx3-2023-07-03： <?xml version="1.0" encoding="GBK"?> <root> <Head> <OpName>1026</OpName> <Outsys_Code>9xxxxxxxxx0</Outsys_Code> <merch_id>4xxxxxxxxx5</merch_id> <OpDate>20230703</OpDate> </Head> <Param> <Query_Account>9xxxxxxxxxxxxxxx3</Query_Account> <Begin_Date>20230703</Begin_Date> <End_Date>20230703</End_Date> <PageNo>0</PageNo> <PageNum>30</PageNum> <Return_Flag>0</Return_Flag> <Reserved1></Reserved1> <Reserved2></Reserved2> <Reserved3></Reserved3> <Reserved4></Reserved4> </Param> </root> 邮储银行新版本-1026接口响应报文-9xxxxxxxxxxxxxxx3-2023-07-03： <?xml version="1.0" encoding="GBK"?> <root> <Head> <OpName>1026</OpName> <OpRetCode>000000</OpRetCode> <OpRetMsg>交易成功:44787841-PS040141</OpRetMsg> </Head> <Param> <NextPage>-1</NextPage> <PageNum>2</PageNum> <RecordSet> <Seq_no>1</Seq_no> <Trans_Date>20230703</Trans_Date> <Trans_Time>143643</Trans_Time> <Query_Account>9xxxxxxxxxxxxxxx3</Query_Account> <Acct_Name>xxxxxx股份有限公司</Acct_Name> <Account>4xxxxxxxxxxxxxxxxx5</Account> <Name>xxxxxx股份有限公司</Name> <Bank_Id>105551003186</Bank_Id> <Bank>中国建设银行股份有限公司xxxxx支行</Bank> <Flag>1</Flag> <Amount>16000</Amount> <Balance>16077</Balance> <Bank_Serial>14782884</Bank_Serial> <EnterpriseID></EnterpriseID> <Remark>xx款</Remark> <Chnl_Code>30</Chnl_Code> <Usage></Usage> <Vchr_Type></Vchr_Type> <Vchr_No></Vchr_No> <Vchr_Id></Vchr_Id> <Reserved1>xxxxxx入账</Reserved1> <Reserved2>0002179076202307031478288400100</Reserved2> <Reserved3>0</Reserved3> <Reserved4>1</Reserved4> <Reserved5>14782884</Reserved5> <Org_Tx_Date></Org_Tx_Date> <Org_Tx_Cerial></Org_Tx_Cerial> </RecordSet> <RecordSet>
【电子回单】中国邮政储蓄银行直联2.0系统（PSBC_SRDC）回单配置指南
声明：除非特别标注，否则均为本站原创文章，转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益，可联系本站删除。
