【电子回单】中国邮政储蓄银行直联2.0系统（PSBC_SRDC）回单配置指南

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

中国邮政储蓄银行直联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>
            <Seq_no>2</Seq_no>
            <Trans_Date>20230703</Trans_Date>
            <Trans_Time>224906</Trans_Time>
            <Query_Account>9xxxxxxxxxxxxxxx3</Query_Account>
            <Acct_Name>xxxxxx股份有限公司</Acct_Name>
            <Account>5xxxxxxxxxxx6</Account>
            <Name>xxxxxxx收入</Name>
            <Bank_Id>43000237</Bank_Id>
            <Bank>中国邮政储蓄银行股份有限公司xxxxxx支行</Bank>
            <Flag>0</Flag>
            <Amount>16000</Amount>
            <Balance>77</Balance>
            <Bank_Serial>85751217</Bank_Serial>
            <EnterpriseID></EnterpriseID>
            <Remark></Remark>
            <Chnl_Code>45</Chnl_Code>
            <Usage></Usage>
            <Vchr_Type></Vchr_Type>
            <Vchr_No></Vchr_No>
            <Vchr_Id></Vchr_Id>
            <Reserved1>xxxx费</Reserved1>
            <Reserved2>0002179076202307038575121700100</Reserved2>
            <Reserved3>0</Reserved3>
            <Reserved4>1</Reserved4>
            <Reserved5>85751217</Reserved5>
            <Org_Tx_Date></Org_Tx_Date>
            <Org_Tx_Cerial></Org_Tx_Cerial>
        </RecordSet>
    </Param>
</root>

然后，根据账号、交易日期、流水号（对应请求报文中的Unique_serial）等信息下载回单文件，返回文件名，并将生成的回单文件存放在指定的sftp文件服务器上。下面报文是根据第一条交易明细的流水号下载的回单信息：

邮储银行新版本-5006接口请求报文-9xxxxxxxxxxxxxxx3-2023-07-03：
<?xml version="1.0" encoding="GBK"?>
<root>
    <Head>
        <OpName>5006</OpName>
        <Outsys_Code>9xxxxxxxxx0</Outsys_Code>
        <merch_id>4xxxxxxxxx5</merch_id>
        <OpDate>20230703</OpDate>
    </Head>
    <Param>
        <Account>9xxxxxxxxxxxxxxx3</Account>
        <Tx_Date>20230703</Tx_Date>
        <Unique_serial>0002179076202307031478288400100</Unique_serial>
        <Reserved1></Reserved1>
        <Reserved2></Reserved2>
        <Reserved3></Reserved3>
        <Reserved4></Reserved4>
    </Param>
</root>

邮储银行新版本-5006接口响应报文-9xxxxxxxxxxxxxxx3-2023-07-03：
<?xml version="1.0" encoding = "GBK"?>
<root>
    <Head>
        <OpName>5006</OpName>
        <OpRetCode>000000</OpRetCode>
        <OpRetMsg>文件上传成功</OpRetMsg>
    </Head>
    <Param>
        <RecordSet>
            <File_name>0002179076202307031478288400100_20230703.pdf</File_name>
            <list_no>29092731007800314782884</list_no>
            <Reserved1></Reserved1>
            <Reserved2></Reserved2>
            <Reserved3></Reserved3>
            <Reserved4></Reserved4>
        </RecordSet>
    </Param>
</root>

生成的回单文件如下图所示（C:/receipt为sftp服务的根目录）：

说明：生成的pdf 电子回单的默认文件名为：唯一标识_交易日期.pdf

回单文件生成之后，回单平台会对文件进行重命名，文件命名规则为：

银行账号_交易日期_唯一标识（流水号）_金额.pdf

如上图所示的第一个回单文件，回单系统命名后的文件名为：9xxxxxxxxxxxxxxx3_20230703_0002179076202307031478288400100_16000.pdf

另，回单码也是由重命名后的回单文件名称中的信息拼接而成，回单码拼接规则为：账号_日期_流水号_金额

预处理调度结束，任务状态变为“预处理完成”，此时点击任务的【详情】，可以看到文件名，如下图：

3. 下载调度

下载调度阶段，通过【远程sftp获取】或者【本机获取】的方式，把回单文件“唯一标识_交易日期.pdf”下载到\tempPath\PSBC_SRDC\目录下并将其重命名为“银行账号_交易日期_唯一标识（流水号）_金额.pdf”，然后又将其移动到扫描工作路径\scanPath\PSBC_SRDC\下。

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

4. 扫描调度

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

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