【电子回单】长沙银行现金管理版（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></inter
【电子回单】长沙银行现金管理版（BCS_CMP）回单配置指南
声明：除非特别标注，否则均为本站原创文章，转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益，可联系本站删除。
