【电子回单】上饶银行(SRB_CMP)回单配置指南
上饶银行(SRB_CMP)是发请求银行推送回单文件的方式。配置步骤如下:
第一步:在[配置项 - 系统配置]页面启用银行插件
登录回单系统,在[配置项 - 系统配置]页面启用银行插件列表中,勾选“上饶银行(SRB_CMP)”后点【保存】。
第二步:在[配置项 - 银行配置]页面配置相关信息
1、银行前置机IP地址、端口
一般情况下,在配置电子回单的时候,银企平台这边已经配置好了(也就是说已经可以正常查询交易明细、余额了),那我们可以参考银企平台 - 系统管理 - 前置机配置页面中“上饶银行现金管理平台(SZSRCB_CMP)”的配置去配置回单平台中银行配置页面的“银企前置机IP地址”、“银行前置机端口”信息:
2、回单获取方式
20240701版本中,上饶银行还不支持“本机获取”的方式,只能选择“远程SFTP获取”的方式。
首先,需要在上饶银行前置机所在的机器上, 以上饶银行前置机安装目录的Temp为根目录搭建sftp服务,然后将sftp服务的IP、端口、用户名、密码配置到下图所示的区域中,点【测试连接】测试回单服务器是否可以连通sftp。
3、币种
目前只支持人民币-01。
第三步:任务的[创建]->[预处理] ->[下载] ->[扫描]阶段
为了快速的看到效果,可以在[配置项 - 银行配置]页面,将“上饶银行电子回单调度方式”修改为“测试使用”(测试调度仅需要大约4分钟就可以完成一次调度)。修改并保存后,在[模块管理]页面重启【回单模块】生效。
1、创建调度
自动创建所有回单账号的前一天的回单任务。
刚部署的情况下是没有任务的,可以手动添加一个任务进行测试。如下图所示,点【+添加任务】按钮进行添加。注意:不要添加今日的任务,因为这个银行插件不支持当日回单下载。
2、预处理调度
1)首先,根据银行账号、交易日期、币种等,调用查询账户明细接口200110获取到流水文件名称。
请求和响应报文如下:
2024-07-23 09:47:00.089 INFO [SRB_CMP,,1815564155046854656] 892 --- [pool-3-thread-77] c.k.b.b.srb.cmp.job.SrbCmpFetchListJob : 上饶银行明细查询报文[000000045200 <ap> <head> <tr_code>200110</tr_code> <cms_corp_no></cms_corp_no> <user_no></user_no> <org_code></org_code> <serial_no></serial_no> <req_no>0947000881711715</req_no> <tr_acdt>20240723</tr_acdt> <tr_time>094700</tr_time> <channel>5</channel> <sign></sign> <file_flag>0</file_flag> <reserved></reserved> </head> <body> <acno>20xxxxxxxxxxxxxxxx76</acno> <cur_code>01</cur_code> <start_date>20240620</start_date> <end_date>20240620</end_date> </body> </ap>] 2024-07-23 09:47:01.732 INFO [SRB_CMP,,1815564155046854656] 892 --- [pool-3-thread-77] c.k.b.b.srb.cmp.job.SrbCmpFetchListJob : 上饶银行明细响应报文[000000054100 <ap> <head> <tr_code>200110</tr_code> <cms_corp_no></cms_corp_no> <user_no></user_no> <req_no>0947000881711715</req_no> <serial_no>043202406280000013519</serial_no> <tr_acdt>20240628</tr_acdt> <tr_time>094421</tr_time> <succ_flag>0</succ_flag> <ret_code>0000</ret_code> <ret_info>交易成功</ret_info> <ext_info></ext_info> <reserved></reserved> <file_flag>1</file_flag> <org_code></org_code> </head> <body> <serial_record></serial_record> <record_num>1</record_num> <field_num>12</field_num> <file_name>CkWB82afCvaAOBA2AAAAyka9qb02.query</file_name> </body> </ap>]
200110接口调用成功后,在上饶银行前置机安装目录的Temp目录下会生成后缀名为 .query的流水文件。
2、回单平台访问上饶银行前置机上搭建的SFTP,将流水文件下载到回单平台sftp根目录的\tempPath\SRB_CMP\目录下,并读取流水文件内容中的主机流水号、交易日期、请求号等信息。读取之后会删除这个流水文件。
3、根据平台流水号、交易日期、请求号(分别为查询明细200110接口应答报文中的主机流水号、交易日期、请求号),调用电子回单打印查询接口200218获取回单文件名称ReportFileName。
(注意:如果需要通讯机生成带印章的电子回单,需要在通讯机主界面“参数配置”按钮中选择安装目录下Plugin文件夹中的HsVoucherPrint.bpl插件,配置完成之后,重启前置机服务。)
请求和响应报文如下:
2024-07-23 09:47:01.804 INFO [SRB_CMP,,1815564155046854656] 892 --- [pool-3-thread-77] c.k.b.b.srb.cmp.job.SrbCmpFetchListJob : 上饶银行回单下载请求:000000040800 <ap> <head> <tr_code>200218</tr_code> <cms_corp_no></cms_corp_no> <user_no></user_no> <org_code></org_code> <serial_no></serial_no> <req_no>0947018036954786</req_no> <tr_acdt>20240723</tr_acdt> <tr_time>094701</tr_time> <channel>5</channel> <sign></sign> <file_flag>0</file_flag> <reserved></reserved> </head> <body> <tr_acdt>20240620</tr_acdt> <serial_no>30096120xxxxxxxxxxxxxxxx76</serial_no> </body> </ap> 2024-07-23 09:47:03.104 INFO [SRB_CMP,,1815564155046854656] 892 --- [pool-3-thread-77] c.k.b.b.srb.cmp.job.SrbCmpFetchListJob : 上饶银行回单下载响应:000000092900 <ap> <head> <tr_code>200218</tr_code> <cms_corp_no></cms_corp_no> <user_no></user_no> <req_no>0947018036954786</req_no> <serial_no>043202406280000013521</serial_no> <tr_acdt>20240628</tr_acdt> <tr_time>094423</tr_time> <succ_flag>0</succ_flag> <ret_code>0000</ret_code> <ret_info>交易成功</ret_info> <ext_info></ext_info> <reserved></reserved> <file_flag>0</file_flag> <org_code></org_code> </head> <body> <serial_record>tr_acdt|tr_time|host_serial_no|req_no|crdr_flag|amt|balance|opp_acname|opp_acno|opp_bankno|opp_bankName|remark|acno|cur_code|acname|20240620|230547|30096120xxxxxxxxxxxxxxxx76|30096120xxxxxxxxxxxxxxxx76|C|7.89|4959.82|||||利息|20xxxxxxxxxxxxxxxx76|01|江西*****有限公司|</serial_record> <record_num>1</record_num> <field_num>15</field_num> <total>1</total> <ReportFileFlag>1</ReportFileFlag> <ReportFileName>20240620_30096120xxxxxxxxxxxxxxxx76_30096120xxxxxxxxxxxxxxxx76_20xxxxxxxxxxxxxxxx76_7.89.pdf</ReportFileName> </body> </ap>
对于获取到的文件名ReportFileName,回单平台按照“ 账号-交易日期-流水号.pdf"的规则对其进行重命名。
200218接口调用成后,在上饶银行前置机安装目录的Temp目录下会生成.PDF 的流水文件。
预处理调度结束后,任务的状态变成【预处理完成】,此时点详情按钮可以看到获取到的文件名称:
3、下载调度
首先,回单平台访问上饶银行前置机上搭建的SFTP,将回单文件下载到\tempPath\SRB_CMP\目录下,并按预处理调度阶段获取到的文件名对其进行重命名。然后再将其移动到扫描工作路径\bakPath\SRB_CMP\下。
至此,下载任务结束,任务显示为【下载完成】。
4、扫描调度
对下载到\tempPath\SRB_CMP\目录的文件进行扫描,解析出结构化数据保存到回单库的表中,同时将文件保存到\bakPath\SRB_CMP\目录下。扫描调度结束后,可点击回单任务的【结果】查看回单的结构化数据。
【电子回单】上饶银行(SRB_CMP)回单配置指南
本文2024-09-22 20:17:22发表“eas cloud知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-eas-112666.html