【电子回单】长沙银行现金管理版（BCS_CMP）回单配置指南
金蝶电子回单代理程序向长沙银行前置机发送电子回单查询请求，交易成功时再根据获取到的唯一码信息，发送电子回单下载请求，回单打印成功时则在长沙银行前置机安装路径的Temp目录下生成回单文件，最后再通过事先安装在长沙银行前置机电脑上的SFTP下载回单文件或通过本机获取的方式下载回单文件。
一、回单代理程序 - 配置项 - 银行配置
在回单平台 - 配置项 - 系统配置 页面的银行插件列表中，勾选“长沙银行现金管理版(BCS_CMP)”后点【保存】按钮，切换到银行配置页面，在“---请选择银行---”下拉列表中就可以选择到这个插件并进行配置了（前置机默认是BCS_CMP-1）。
1、配置项参考
可以参考银企平台 - 系统管理 - 前置机配置页面“长沙银行现金管理版(BCS_CMP)”的配置，配置这两项：
银行前置机IP地址
银行前置机端口
2、回单获取方式
当长沙银行前置机和电子回单代理程序部署在同一台机器时，请选择“本机获取”，“银行回单推送路径”配置为长沙银行前置机安装路径的Temp目录。
当长沙银行前置机和电子回单代理程序部署不在同一台机器时，请选择“远程sftp获取”。在长沙银行前置机这台机器上搭建sftp服务，可以参考回单部署文档的第五章 附录操作。注意，SFTP服务的根路径要配置为长沙银行前置机安装路径的Temp目录（根目录不支持中文）。搭建SFTP服务后，把SFTP服务的IP、端口、用户名、密码，配置到这里：
3、字符编码
回单程序与银行交互报文的字符编码，请根据银行字符编码方式选择。默认值(UTF-8)
4、测试日期
因金蝶电子回单代理程序不支持创建未来日期的任务，所以如果需要测试未来日期的回单，那需要配置测试日期，例如配置为 20251112
二、任务的[创建]->[预处理] ->[下载] ->[扫描]阶段
1、[创建]任务调度
系统会自动创建所有电子回单账号的前一天的回单任务。
刚部署的情况下是没有任务的，可以手动添加一个任务进行测试。如下图所示，点【+添加任务】按钮进行添加。
2、[预处理]任务调度
在预处理任务调度阶段，会根据任务的账号和日期，获取到回单文件名。预处理任务完成后，可以点【详情】查看文件名，如下图所示：
下面详述预处理获取文件名称的过程：
1）根据账户交易明细查询接口获取到核心流水编号
调用账户交易明细查询接口[00003020101A0007]，根据账户、币种及回单日期分页查询交易明细数据，获取到核心流水编号hostSerialNo 和明细序号mxixuhao，报文如下：
2024-04-08 11:32:00.342 INFO [BCS_CMP,,1777003398759972864] 12284 --- [pool-3-thread-1] c.k.bos.bank.bcs.cmp.utils.SSLUtil : 获取交易明细的请求信息：000000046800 <ap> <head> <tr_code>00003020101A0007</tr_code> <cms_corp_no></cms_corp_no> <user_no></user_no> <org_code></org_code> <serial_no></serial_no> <req_no>17125471203270169</req_no> <tr_acdt>20240408</tr_acdt> <tr_time>113200</tr_time> <channel>5</channel> <sign>0</sign> <file_flag>0</file_flag> </head> <body> <acctNo>8xxxxxxxxxxxxxxxxxx0</acctNo> <currency>01</currency> <startDate>20240407</startDate> <endDate>20240407</endDate> <pager></pager> <start>1</start> <size>50</size> </body> </ap> 2024-04-08 11:32:00.796 INFO [BCS_CMP,,1777003398759972864] 12284 --- [pool-3-thread-1] c.k.bos.bank.bcs.cmp.utils.SSLUtil : 获取交易明细的响应信息：000001245700 <ap> <head> <tr_code>00003020101A0007</tr_code> <org_code></org_code> <cms_corp_no></cms_corp_no> <user_id>6395401341754521af309897b5225bc3</user_id> <user_no></user_no> <serial_no>012202404080000533892</serial_no> <req_no>17125471203270169</req_no> <tr_acdt>20240408</tr_acdt> <tr_time>113213</tr_time> <channel>22</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>15</TotRcrdCnt> <BegRcrdCnt>1</BegRcrdCnt> <IngRcrdCnt>50</IngRcrdCnt> <array> <dto> <currency>01</currency> <acctNo>8xxxxxxxxxxxxxxxxxx0</acctNo> <acctName>XXXXXX有限公司</acctName> <trDate>20240407</trDate> <trTime>142840</trTime> <hostSerialNo>99018150915741817060</hostSerialNo> <origSerialNo></origSerialNo> <trType>01</trType> <trFrom>102</trFrom> <txFlag></txFlag> <cashFlag></cashFlag> <drcrFlag>D</drcrFlag> <amt>400000.00</amt> <feeAmt>0.00</feeAmt> <balance>6699371.60</balance> <lastBal></lastBal> <voucherType></voucherType> <voucherNo></voucherNo> <batchNo></batchNo> <referNo></referNo> <oppAcctNo>3xxxxxxxxxxxxxxxxxxx5</oppAcctNo> <oppAcctName>XXXXXXXXXXXXXXXXXXXX分公司</oppAcctName> <oppBankNo>302100011000</oppBankNo> <oppBankName>XX银行XXXXX</oppBankName> <summary>转账</summary> <postscript>XXXXXX</postscript> <mxixuhao>17060</mxixuhao> </dto> <dto> ……………… </dto> </array> </body> </ap>
2）根据电子回单查询接口获取到唯一码
调用电子回单查询接口[0000304T012A0044]，根据账户及回单日期查询电子回单信息，获取到唯一码innerNo和流水号lsh等信息，报文如下：
2024-04-08 11:32:00.817 INFO [BCS_CMP,,1777003398759972864] 12284 --- [pool-3-thread-1] c.k.bos.bank.bcs.cmp.utils.SSLUtil : 获取回单明细的请求信息：000000048000 <ap> <head> <tr_code>0000304T012A0044</tr_code> <cms_corp_no></cms_corp_no> <user_no></user_no> <org_code></org_code> <serial_no></serial_no> <req_no>17125471208170600</req_no> <tr_acdt>20240408</tr_acdt> <tr_time>113200</tr_time> <channel>5</channel> <sign>0</sign> <file_flag>0</file_flag> </head> <body> <rAcctNno>8xxxxxxxxxxxxxxxxxx0</rAcctNno> <rStartDate>20240407</rStartDate> <rEndDate>20240407</rEndDate> <pageNumber>1</pageNumber> <pageSize>50</pageSize> <todayFlag>0</todayFlag> </body> </ap> 2024-04-08 11:32:01.277 INFO [BCS_CMP,,1777003398759972864] 12284 --- [pool-3-thread-1] c.k.bos.bank.bcs.cmp.utils.SSLUtil : 获取回单明细的响应信息：000000868700 <ap> <head> <tr_code>0000304T012A0044</tr_code> <org_code></org_code> <cms_corp_no></cms_corp_no> <user_id>17125471208170600</user_id> <user_no></user_no> <serial_no>012202404080000534538</serial_no> <req_no>17125471208170600</req_no> <tr_acdt>20240408</tr_acdt> <tr_time>113214</tr_time> <channel>22</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> <total>15</total> <array> <dto> <billSQ>00017060</billSQ> <bj>0</bj> <crcycd>01</crcycd> <jygy>9901815</jygy> <jyrq>20240407</jyrq> <lsh>990181509157418</lsh> <txAmt>400000</txAmt> <zh>8xxxxxxxxxxxxxxxxxx0</zh> <dycs>1</dycs> <amntcd>D</amntcd> <fkrdz></fkrdz> <fkrkhhP>XX支行</fkrkhhP> <fkrqc>XXXXXX有限公司</fkrqc> <fkrzh>8xxxxxxxxxxxxxxxxxx0</fkrzh> <skrdz></skrdz> <skrkhhP>中信银行股份有限公司</skrkhhP> <skrqc>XXXXXXXXXXXXXXXXX分公司</skrqc> <skrzh>3xxxxxxxxxxxxxxxxxxx5</skrzh> <innerNo>6ef27ba70bcdbbab07d53f2802599c11</innerNo> <hdlx>pc_lwhd</hdlx> <endycs>0</endycs> </dto> <dto> …………………… </dto> </array> </body> </ap>
3）根据电子回单下载接口获取到回单文件名
调用电子回单下载接口[0000304T012D0009]，根据唯一码innerNo和回单时间sj，获取到回单文件名称file_name。电子回单查询接口[0000304T012A0044]返回多少条回单，就会每条回单信息的唯一码innerNo去调用多少次电子回单下载接口[0000304T012D0009]。报文如下：
2024-04-08 11:32:01.282 INFO [BCS_CMP,,1777003398759972864] 12284 --- [pool-3-thread-1] c.k.bos.bank.bcs.cmp.utils.SSLUtil : 获取回单名称的请求信息：000000046500 <ap> <head> <tr_code>0000304T012D0009</tr_code> <cms_corp_no></cms_corp_no> <user_no></user_no> <org_code></org_code> <serial_no></serial_no> <req_no>17125471212820954</req_no> <tr_acdt>20240408</tr_acdt> <tr_time>113201</tr_time> <channel>5</channel> <sign>0</sign> <file_flag>0</file_flag> </head> <body> <paperPageSize>1</paperPageSize> <localePaper>zh</localePaper> <infoList> <innerNo>6ef27ba70bcdbbab07d53f2802599c11</innerNo> <sj>20240407-20240407</sj> </infoList> </body> </ap> 2024-04-08 11:32:02.119 INFO [BCS_CMP,,1777003398759972864] 12284 --- [pool-3-thread-1] c.k.bos.bank.bcs.cmp.utils.SSLUtil : 获取回单名称的响应信息：000000073200 <ap> <head> <tr_code>0000304T012D0009</tr_code> <cms_corp_no></cms_corp_no> <user_no></user_no> <org_code></org_code> <serial_no>0121081000006893917125471212820954</serial_no> <req_no></req_no> <tr_acdt>20240408</tr_acdt> <tr_time>113214</tr_time> <succ_flag>0</succ_flag> <ret_code>0000</ret_code> <ret_info>回单打印成功</ret_info> <ext_info></ext_info> <file_flag>1</file_flag> <reserved></reserved> </head> <body> <total>1</total> <file_name>ZGNUfGYTZT6ACyz3AABz8gRI7Ew477.pdf</file_name> <array> <dto> <lsh>990181509157418</lsh> <jyrq>20240407</jyrq> <brgrno>05340102</brgrno> <hm>XXXXXX有限公司</hm> <jyjg>XXXXXXX部</jyjg> <jygy>9901815</jygy> <jjh></jjh> <hdlx>pc_lwhd</hdlx> <zh>8xxxxxxxxxxxxxxxxxx0</zh> <dycs>2</dycs> </dto> </array> </body> </ap>
接口返回“回单打印成功”后，就会在长沙银行前置机安装路径的Temp目录下生成pdf回单文件，如下图所示：
另，长沙银行现金管理版本BCS_CMP 还有一种前置机叫“jar前置机”，这种前置机，其回单是生成在前置机目录下的temp/Y当天日期/ 目录下的（如果没有temp目录，请手工创建一个temp目录），如下图所示。
4）形成回单的文件名
最后，回单系统根据以上信息，形成回单的文件名称，命名规则为：账号_回单日期_和核心流水编号(hostSerialNo)_文件名称(file_name).pdf
3、[下载]任务调度
在下载调度阶段，将长沙银行前置机安装路径的Temp目录下的pdf回单文件下载到回单服务器的tempPath\BCS_CMP下，并重命名为“账号_回单日期_和核心流水编号(hostSerialNo)_文件名称(file_name).pdf”，然后再移动到scanPath\BCS_CMP目录下。
至此，下载调度结束。
4、[扫描]任务调度
对下载到scanPath\BCS_CMP下的文件进行扫描，解析出结构化数据保存到回单库中，同时将回单文件挪动到bakPath\BCS_CMP目录下。扫描调度结束后，可点击回单任务的【结果】查看回单的结构化数据。
【电子回单】长沙银行现金管理版（BCS_CMP）回单配置指南
本文2024-09-22 20:17:25发表“eas cloud知识”栏目。
本文链接：https://wenku.my7c.com/article/kingdee-eas-112671.html
