【电子回单】深圳农村商业银行推广版（SZSRCB_CMP）回单配置指南
深圳农村商业银行推广版（SZSRCB_CMP），是发请求银行推送回单文件的方式。配置步骤如下：
第一步：在[配置项 - 系统配置]页面启用银行插件
登录回单系统，在[配置项 - 系统配置]页面启用银行插件列表中，勾选“深圳农村商业银行推广版（SZSRCB_CMP）”后点【保存】。
第二步：在[配置项 - 银行配置]页面配置相关信息
一般情况下，在配置电子回单的时候，银企平台这边已经配置好了（也就是说已经可以正常查询交易明细、余额了），那我们可以参考银企平台 - 系统管理 - 前置机配置页面中“深圳农村商业银行推广版(SZSRCB_CMP)”的配置去配置回单平台中银行配置页面的信息：
银行前置机IP地址
银行前置机端口
此外，还需要配置这几项：
现金管理客户号
用户号
机构号
压缩文件下载次数：压缩文件下载次数至少要大于2次，默认6次
第三步：回单获取方式
如果回单平台和深圳农村商业银行推广版前置机软件安装在同一台机器，可以通过【本机获取】的方式获取回单。银企下载回单ZIP文件[0301T038A9032]接口调用成功后，银行服务器会上传回单到前置机安装目录的TEMP目录。那么配置为【本机获取】后，“银行回单推送路径”就配置为Temp文件夹的完整路径。
如果回单平台和前置机软件不在同一台机器，可以通过银行sftp获取，回单获取方式选择【远程sftp获取】。那么客户需要在银行前置机上搭建一个sftp服务，根目录配置为Temp文件夹的完整路径（注意，如果用freesshd搭建sftp服务，根路径不支持中文），并确保回单代理程序能访问该SFTP服务。
搭建好sftp服务之后，在下图所示位置配置sftp的ip、端口、用户名、密码等信息：
第四步：任务的[创建]->[预处理] ->[下载] ->[扫描]阶段
为了快速的看到效果，可以在[配置项 - 银行配置]页面，将“厦门银行企业现金管理直联版电子回单调度方式”修改为“测试使用”（测试调度仅需要大约4分钟就可以完成一次调度）。修改并保存后，在[模块管理]页面重启【回单模块】生效。
1、创建调度
自动创建所有回单账号的前一天的回单任务。
刚部署的情况下是没有任务的，可以手动添加一个任务进行测试。如下图所示，点【+添加任务】按钮进行添加。注意：不要添加今日的任务，因为这个银行插件不支持当日回单下载。
2、预处理调度
根据银行账号、币别、交易日期等，调用账户交易明细查询接口[03020101A0007]获取到渠道流水号orgiSerialNo（与单个回单文件文件名的最后一个值对应），拼接出下回单的pdf文件名称，规则为：账号_日期(8位)_渠道流水号orgiSerialNo.pdf。
接口的请求和响应报文如下：
2024-06-27 07:38:02.398 INFO [SZSRCB_CMP,,1804194132504084480] 30771 --- [pool-2-thread-6] c.k.bos.bank.szrcb.cmp.utils.SSLUtil : ----****----：获取交易明细的请求信息： 000000049100 <ap> <head> <tr_code>03020101A0007</tr_code> <cms_corp_no>0XXXXXXXXXXXXX8</cms_corp_no> <user_no>XXXXXXXXX</user_no> <org_code>XXXXX</org_code> <serial_no></serial_no> <req_no>17194450823970947</req_no> <tr_acdt>20240627</tr_acdt> <tr_time>073802</tr_time> <channel>5</channel> <sign>0</sign> <file_flag>0</file_flag> </head> <body> <acctNo>0XXXXXXXXXX4</acctNo> <currency>01</currency> <startDate>20240621</startDate> <endDate>20240621</endDate> <pager></pager> <start>1</start> <size>50</size> </body> </ap> 2024-06-27 07:38:02.782 INFO [SZSRCB_CMP,,1804194132504084480] 30771 --- [pool-2-thread-6] c.k.bos.bank.szrcb.cmp.utils.SSLUtil : ----****----：获取交易明细的响应信息： 000000366000 <ap> <head> <tr_code>03020101A0007</tr_code> <org_code>XXXXX</org_code> <cms_corp_no>0XXXXXXXXXXXXX8</cms_corp_no> <user_id>4fa3733fccf3452381233fbf00d0ffcb</user_id> <user_no>XXXXXXXXX</user_no> <serial_no>041202406270000009892</serial_no> <req_no>17194450823970947</req_no> <tr_acdt>20240627</tr_acdt> <tr_time>073802</tr_time> <channel>18</channel> <sign>0</sign> <file_flag>0</file_flag> <reserved></reserved> <session_id></session_id> <local_ip></local_ip> <mac_addr></mac_addr> <internet_ip></internet_ip> <succ_flag>0</succ_flag> <ret_code>0000</ret_code> <ret_info>交易成功</ret_info> </head> <body> <TotRcrdCnt>3</TotRcrdCnt> <BegRcrdCnt>1</BegRcrdCnt> <IngRcrdCnt>50</IngRcrdCnt> <array> <dto> <currency>01</currency> <acctNo>0XXXXXXXXXX4</acctNo> <acctName>XXXXXXX有限公司</acctName> <trDate>20240621</trDate> <trTime>041415</trTime> <hostSerialNo>202406210XXXXXXXXXX42</hostSerialNo> <origSerialNo>00906977500904C</origSerialNo> <trType></trType> <trFrom></trFrom> <txFlag></txFlag> <cashFlag></cashFlag> <drcrFlag>C</drcrFlag> <amt>****.**</amt> <feeAmt></feeAmt> <balance>*******.**</balance> <lastBal></lastBal> <voucherType></voucherType> <voucherNo></voucherNo> <batchNo></batchNo> <referNo></referNo> <oppAcctNo>243300133</oppAcctNo> <oppAcctName>XXXXXXX有限公司</oppAcctName> <oppBankNo>9xxxxxxxxxx4</oppBankNo> <oppBankName></oppBankName> <summary>XXXXX清算</summary> <postscript>240621062137100621_1511912611</postscript> </dto> <dto> ……………… </dto> <dto> ……………… </dto> </array> </body> </ap>
预处理调度结束后，可以通过点击任务的【详情】查看获取到的文件名：
3、下载调度
再调用批量回单下载申请接口[0301T038A9032]，查询账号对应日期的回单系统ZIP文件。注意：至少需调用两次此接口，第一次生成回单，第二次上传回单到前置机安装目录的TEMP目录下，直到返回报文的file_name字段有值，即可在TEMP目录获取回单压缩文件。T+1日可查询T日或之前的回单，不可查询当日回单。请尽量避免在9点到18点之间使用此接口。
接口的请求和相应报文如下：
2024-06-27 07:42:00.293 INFO [SZSRCB_CMP,,1804194132504084480] 30771 --- [pool-3-thread-31] c.k.bos.bank.szrcb.cmp.utils.SSLUtil : ----****----：获取压缩文件名的请求信息： 000000039500 <ap> <head> <tr_code>0301T041A9032</tr_code> <cms_corp_no>0XXXXXXXXXXXXX8</cms_corp_no> <user_no>XXXXXXXXX</user_no> <org_code>XXXXX</org_code> <serial_no></serial_no> <req_no>17194453202930608</req_no> <tr_acdt>20240627</tr_acdt> <tr_time>074200</tr_time> <channel>5</channel> <sign>0</sign> <file_flag>0</file_flag> </head> <body> <acctNo>0XXXXXXXXXX4</acctNo> <queryDate>20240621</queryDate> </body> </ap> 2024-06-27 07:42:02.301 INFO [SZSRCB_CMP,,1804194132504084480] 30771 --- [pool-3-thread-31] c.k.bos.bank.szrcb.cmp.utils.SSLUtil : ----****----：获取压缩文件名的响应信息： 000000064900 <ap> <head> <tr_code>0301T041A9032</tr_code> <org_code>XXXXX</org_code> <cms_corp_no>0XXXXXXXXXXXXX8</cms_corp_no> <user_id>4fa3733fccf3452381233fbf00d0ffcb</user_id> <user_no>XXXXXXXXX</user_no> <serial_no>041202406270000010097</serial_no> <req_no>17194453202930608</req_no> <tr_acdt>20240627</tr_acdt> <tr_time>074200</tr_time> <channel>18</channel> <sign>0</sign> <file_flag>1</file_flag> <reserved></reserved> <session_id></session_id> <local_ip></local_ip> <mac_addr></mac_addr> <internet_ip></internet_ip> <succ_flag>0</succ_flag> <ret_code>0000</ret_code> <ret_i
【电子回单】深圳农村商业银行推广版（SZSRCB_CMP）回单配置指南
声明：除非特别标注，否则均为本站原创文章，转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益，可联系本站删除。
