【电子回单】江苏银行现金管理平台v2(JSB_CMP)回单配置指南

金蝶电子回单代理程序向江苏银行前置机发送批量回单下载申请,交易成功时则在江苏银行前置机安装目录的Temp下生成回单文件,然后金蝶电子回单代理程序再通过事先安装在江苏银行前置机上的SFTP下载回单文件或本机获取的方式下载回单文件。
一、回单代理程序 - 配置项 - 银行配置
在回单平台 - 配置项 - 系统配置页面的银行插件列表中,勾选“江苏银行现金管理平台v2(JSB_CMP)”后点【保存】按钮,切换到银行配置页面,在“---请选择银行---”下拉列表中就可以选择到这个插件并进行配置了(前置机默认是JSB_CMP-1)。
1、配置项参考
可以参考银企平台 - 系统管理 - 前置机配置页面,选择“江苏银行现金管理平台v2(JSB_CMP)”的配置
银行前置机IP地址 和 银行前置机端口。
另,其他配置项:
使用环境 —— 回单下载使用环境,对接银行测试服务器的话,选择“测试环境”;如果是对接银行的正式服务器,请选择“生产环境”。
字符集 —— 报文字符集,默认GBK
请求银行前置机的方式 —— 方式1、方式2


2、回单获取方式
当江苏银行前置机和电子回单代理程序部署在同一台机器时,请选择“本机获取”,“银行回单推送路径”配置为江苏银行前置机安装路径的Temp目录。
当江苏银行前置机和电子回单代理程序部署不在同一台机器时,请选择“远程sftp获取”。在江苏银行前置机这台机器上搭建sftp服务,可以参考回单部署文档的第五章 附录操作。注意,SFTP服务的根路径要配置为江苏银行前置机安装路径的Temp目录(根目录不支持中文)。搭建SFTP服务后,把SFTP服务的IP、端口、用户名、密码,配置到这里:



二、任务的[创建]->[预处理] ->[下载] ->[扫描]阶段

1、[创建]任务调度
系统会自动创建所有电子回单账号的前一天的回单任务。
刚部署的情况下是没有任务的,可以手动添加一个任务进行测试。如下图所示,点【+添加任务】按钮进行添加。

2、[预处理]任务调度
在预处理任务调度阶段,会根据任务的账号和日期,获取到回单文件名。预处理任务完成后,可以点【详情】查看文件名,如下图所示:


具体来讲,是回单程序根据根据账号acctNo和查询日期queryDate,调用接口批量回单下载申请接口0000301T038A9032查询账号对应日期的回单系统zip文件。响应报文中的文件名称file_name是zip包,命名规则是:“账号_日期.zip”,zip包中的pdf文件的命名规则是:“江苏银行电子回单+流水号_日期_账号.pdf”(文件名不含+,此处仅区别前缀文字)。
0000301T038A9032的请求和响应报文如下:
2024-04-03 12:59:00.234 INFO [JSB_CMP,,1775366383090008064] 61512 --- [pool-3-thread-5] c.k.b.b.jsb.cmp.job.JsbCmpFetchListJob : 江苏银行现金管理平台v2[0000301T038A9032]接口批量回单下载申请: 000000041000<ap> <head> <tr_code>0000301T038A9032</tr_code> <cms_corp_no></cms_corp_no> <user_no></user_no> <org_code></org_code> <serial_no></serial_no> <req_no>3571712120340234</req_no> <tr_acdt>20240403</tr_acdt> <tr_time>125900</tr_time> <channel>5</channel> <sign>0</sign> <file_flag>0</file_flag> <reserved></reserved> </head> <body> <acctNo>02xxxxxxxxxxxx80</acctNo> <queryDate>20221017</queryDate> </body> </ap> 2024-04-03 12:59:01.717 INFO [JSB_CMP,,1775366383090008064] 61512 --- [pool-3-thread-5] c.k.b.b.jsb.cmp.job.JsbCmpFetchListJob : 江苏银行现金管理平台v2[0000301T038A9032]接口批量回单下载响应: <ap> <head> <tr_code>0000301T038A9032</tr_code> <org_code></org_code> <cms_corp_no></cms_corp_no> <user_id>0ed2cf7ea56c496f9ec923d00078f398</user_id> <user_no></user_no> <serial_no>038202404030000056427</serial_no> <req_no>3571712120340234</req_no> <tr_acdt>20240403</tr_acdt> <tr_time>125900</tr_time> <channel>5</channel> <reserved></reserved> <session_id></session_id> <local_ip></local_ip> <mac_addr></mac_addr> <internet_ip></internet_ip> <file_flag>1</file_flag> <succ_flag>0</succ_flag> <ret_code>0000</ret_code> <ret_info></ret_info> </head> <body> <file_name>02xxxxxxxxxxxx80_20221017.zip</file_name> </body> </ap>
0000301T038A9032接口调用成功后,在江苏银行前置机的Temp目录下就可以看到生成的zip文件了,此时回单系统会将这个文件“账号_日期.zip”先下载到\tempPath\JSB_CMP目录下,再解压zip文件。
然后再调用银企查询回单数据接口0000301T038A9025查询到回单的数据,请求和响应报文如下:
2024-04-03 12:59:01.856 INFO [JSB_CMP,,1775366383090008064] 61512 --- [pool-3-thread-5] c.k.b.b.jsb.cmp.job.JsbCmpFetchListJob : 江苏银行现金管理平台v2[0000301T038A9025]接口批量回单下载申请: 000000049600<ap> <head> <tr_code>0000301T038A9025</tr_code> <cms_corp_no></cms_corp_no> <user_no></user_no> <org_code></org_code> <serial_no></serial_no> <req_no>14341712120341855</req_no> <tr_acdt>20240403</tr_acdt> <tr_time>125901</tr_time> <channel>5</channel> <sign>0</sign> <file_flag>0</file_flag> <reserved></reserved> </head> <body> <acctNo>02xxxxxxxxxxxx80</acctNo> <currency>01</currency> <beginDate>20221017</beginDate> <endDate>20221017</endDate> <size>10</size> <start>1</start> </body> </ap> 2024-04-03 12:59:03.742 INFO [JSB_CMP,,1775366383090008064] 61512 --- [pool-3-thread-5] c.k.b.b.jsb.cmp.job.JsbCmpFetchListJob : 江苏银行现金管理平台v2[0000301T038A9025]接口批量回单下载响应: <ap> <head> <tr_code>0000301T038A9025</tr_code> <org_code></org_code> <cms_corp_no></cms_corp_no>
【电子回单】江苏银行现金管理平台v2(JSB_CMP)回单配置指南
声明:除非特别标注,否则均为本站原创文章,转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益,可联系本站删除。



