【电子回单】浦发银行（SPDB_DC）回单配置指南
浦发银行的新客户仅支持WJ01或DY47+WJ12的接口获取方式，这种方式是发请求银行返回文件流的方式。在电子回单代理程序 - 银行配置页面，浦发银行推送文件的方式要选择“WJ01”或者“DY47+WJ12”，如下图所示：
一、回单代理程序 - 配置项 - 银行配置
在电子回单代理程序 - 银行配置页面，选择“上海浦东发展银行直联版”之后，需要对以下配置项进行配置。
1、浦发银行推送文件的方式
要选择“WJ01”或者“DY47+WJ12”，如下图所示：
WJ01
WJ01交易，用来下载T+1的账单文件。若客户已在柜面通过4498签约了银企直联DZZD功能，则可以通过该交易定期进行后续账单文件下载。
在预处理调度，根据银行账号、下载文件业务类型、下载文件参数等参数下载回单。交易失败时，报文体失败报错（无文件字节流返回）。交易成功时，报文体成功返回+文件字节流，回单平台根据报文体中的fileLength文件大小、fileFormat文件格式、fileName读取返回报文后的文件字节流内容，并在本地tempPath目录下输出zip压缩包，解压后重命名文件并将其移动到scanPath目录下。
参数说明：
下载文件业务类型fileBusinessType：1-账单文件）
下载文件参数fileDownloadPar：下载文件业务类型字段为1-账单文件时，则需要输入：账单类型|账单日期
其中，账单类型：1-银企余额账单，2-批量回单，3-单笔回单，4-对公明细账单。金蝶电子回单代理程序下载的回单类型为3。
其中，账单日期格式：YYYYMMDD。如果在银行配置页面维护了测试日期，账单日期就取测试日期。
DY47+WJ12
在预处理阶段，先调用DY47发起前置交易，交易成功后等到下载阶段再发起WJ12交易获取结果文件。
DY47交易接口主要用来满足客户T+0电子回单下载需求。通过该交易可以发起账务流水的T+0电子回单生成申请，然后根据接口返回的回单文件编号，通过银企直联WJ12交易获取相应的回单文件。一条流水对应一个回单文件，一次最多支持10条流水的回单文件。
2. 下面这些配置项可以参考银企平台的前置机配置页面以及浦发前置机bisafe进行配置
银行前置机IP地址 —— 浦发前置机这台机器的IP
银行前置机端口 —— 浦发前置机的NC安全HTTP服务的监听端口
企业客户号 —— 银企平台前置机配置页面的企业客户号
bisafe签名服务地址 —— 浦发前置机这台机器的IP
bisafe签名服务端口 —— 浦发前置机的NC签名服务的监听端口
bisafe服务IP地址 —— 浦发前置机这台机器的IP
bisafe文件传输服务监听端口 —— 浦发前置机的文件传输HTTP服务的监听端口
另， 新版浦发银行前置机界面如下。注意，测试回单的话，银行服务端口要用7002/7004。
3、测试日期
浦发银行推送文件的方式选择“DY47+WJ12”时，这个测试日期填了也不生效，默认为空即可。
浦发银行推送文件的方式选择“WJ01”，这个测试日期可以填回单的交易日期，格式为yyyymmdd，正式环境不填。
4、是否获取当日回单
获取当日回单功能，能够下载当天的回单文件，如果选择"是"请对下方【[当日回单创建]任务调度配置】进行设置。
注意：浦发银行推送文件的方式选择“DY47+WJ12”，才支持获取当日回单。
二、任务的[创建]->[预处理] ->[下载] ->[扫描]阶段
1. 创建调度
创建浦发银行的回单任务。
2. 预处理调度
在预处理阶段，先调用DY47发起前置交易获取到回单文件名，交易成功后等到下载阶段再发起WJ12交易获取结果文件。
调用DY47接口发起前置请求，请求报文和响应报文如下：
DY47Impl 签名请求报文: <body> <billDownloadChanel>1</billDownloadChanel> <acctNo>952A9997220008092</acctNo> <singleOrBatchFlag>1</singleOrBatchFlag> <beginNumber>1</beginNumber> <queryNumber>10</queryNumber> <beginDate>20461231</beginDate> <endDate>20461231</endDate> </body> 验签响应报文体: <body> <totalNumber>2</totalNumber> <reserve1></reserve1> <reserve2></reserve2> <reserve3></reserve3> <lists name="LoopResult"> <list> <acceptNo>20230712100001026263</acceptNo> <result>0</result> <resultMsg></resultMsg> <oppositeAcctNo></oppositeAcctNo> <oppositeBankNo></oppositeBankNo> <debitFlag>1</debitFlag> <businessCode>9935</businessCode> <backhostGyno>995209880014</backhostGyno> <subpoenaSeqNo>2</subpoenaSeqNo> <transDate>20461231</transDate> <transAmount>36.11</transAmount> <reserve1>20230614</reserve1> <reserve2></reserve2> <reserve3></reserve3> </list> <list> <acceptNo>20230712100001026262</acceptNo> <result>0</result> <resultMsg></resultMsg> <oppositeAcctNo></oppositeAcctNo> <oppositeBankNo></oppositeBankNo> <debitFlag>1</debitFlag> <businessCode>9935</businessCode> <backhostGyno>995209880014</backhostGyno> <subpoenaSeqNo>4</subpoenaSeqNo> <transDate>20461231</transDate> <transAmount>36.11</transAmount> <reserve1>20230614</reserve1> <reserve2></reserve2> <reserve3></reserve3> </list> <list> ………… </list> </lists> </body>
如上所示，DY47接口返回符合条件的总笔数totalNumber=6，结果为[995209880014_36.11_1_20230712100001026263, 995209880014_36.11_1_20230712100001026262, …………]
。其中，响应报文中的acceptNo为回单文件编号，当账单下载渠道billDownloadChanel为1时，可用此编号发起WJ12交易下载回单文件。
3. 下载调度
DY47接口返回了几条数据，那么在下载调度阶段，就一条一条的去下载，一直到下载任务结束。
WJ接口的请求和响应报文如下：
WJ12Impl-buildSign 签名请求报文: <body> <acctNo>952A9997220008092</acctNo> <fileDownloadFlag>1</fileDownloadFlag> <fileDownloadPar>20230712100001026263</fileDownloadPar> </body> 验签响应报文体: <body> <fileLength>211399</fileLength> <fileName>20230712100001026263.pdf</fileName> <remark1></remark1> <remark2></remark2> <remark3></remark3> <remark4></remark4> <remark5></remark5> <remark6></remark6> </body>
其中，fileDownloadFlag为文件下载模式。若该字段为1，则需要先发起前置交易（DY47）完成T+0回单文件申请。fileDownloadPar为文件下载参数，其值为DY47返回的回单文件编号，每笔WJ12文件下载交易只能输入一个回单文件编号。
响应报
【电子回单】浦发银行（SPDB_DC）回单配置指南
声明：除非特别标注，否则均为本站原创文章，转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益，可联系本站删除。
