【电子回单】江苏银行现金管理平台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> <user_id>0ed2cf7ea56c496f9ec923d00078f398</user_id> <user_no></user_no> <serial_no>038202404030000056428</serial_no> <req_no>14341712120341855</req_no> <tr_acdt>20240403</tr_acdt> <tr_time>125902</tr_time> <channel>5</channel> <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> <total>10</total> <size>10</size> <start>1</start> <dtos> <dto> <acctNo>02xxxxxxxxxxxx80</acctNo> <transDate>20221017</transDate> <amt>20.95</amt> <bigAmt>贰拾元玖角伍分</bigAmt> <receiptType>9660</receiptType> <receiptName>对公活期结息</receiptName> <orgNo>3326</orgNo> <transUserNo></transUserNo> <currency>01</currency> <currencyName>人民币</currencyName> <payAcctNo>02xxxxxxxxxxxx80</payAcctNo> <payAcctName>*****************</payAcctName> <payAcctBankNo></payAcctBankNo> <oppAcctNo>02xxxxxxxxxxxx80</oppAcctNo> <oppAcctName>杭州市xxxxxxxxxx店</oppAcctName> <oppAcctBankNo>江苏银行xxxxxxxx支行</oppAcctBankNo> <trCode>9660</trCode> <loanSign>贷</loanSign> <extend1>246714518</extend1> <extend2>1</extend2> <extend3>4</extend3> <extend4>EB4BA245687381E1E053E2F800421801</extend4> <extend5>1</extend5> <extend6></extend6> <extend7></extend7> <extend8></extend8> <printline1>柜员流水: 附言: 结息账号:xxxxxxxxxxx</printline1> <printline2>xxxxxxxxxxx</printline2> <printline3></printline3> <printline4></printline4> <printline5></printline5> <printline6></printline6> <printline7></printline7> <printline8></printline8> <printline9></printline9> </dto> </dtos> </body> </ap>
金蝶电子回单代理程序判断当0000301T038A9025接口应答报文中的extend1值（即回单系统唯一标识ID），跟0000301T038A9032 下载并解压后的pdf文件名称中的流水号相等时，就对\tempPath\JSB_CMP下的PDF文件重命名，命名规则为：账号_对方账号_日期_金额_借贷标识_流水号.pdf（其中，金额和借贷标识取自0000301T038A9025接口应答报文中amt、loanSign）。重命名之后，原来的zip文件会删除掉。至此，预处理任务结束。
3、[下载]任务调度
在下载调度阶段，将临时目录\tempPath\JSB_CMP下的PDF文件移动到扫描目录\scanPath\JSB_CMP下。
4、[扫描]任务调度
对下载到scanPath\JSB_CMP下的文件进行扫描，解析出结构化数据保存到回单库中，同时将回单文件挪动到bakPath\JSB_CMP目录下。扫描调度结束后，可点击回单任务的【结果】查看回单的结构化数据。
【电子回单】江苏银行现金管理平台v2（JSB_CMP）回单配置指南
本文2024-09-22 20:17:30发表“eas cloud知识”栏目。
本文链接：https://wenku.my7c.com/article/kingdee-eas-112682.html
