【电子回单】厦门银行企业现金管理直连版（XMB_CMP）回单配置指南
厦门银行企业现金管理直连版（XMB_CMP），是发请求银行推送回单文件的方式。配置步骤如下：
第一步：在[配置项 - 系统配置]页面启用银行插件
登录回单系统，在[配置项 - 系统配置]页面启用银行插件列表中，勾选“厦门银行企业现金管理直连版（XMB_CMP）”，并保存。
第二步：在[配置项 - 银行配置]页面配置相关信息
一般情况下，在配置电子回单的时候，银企平台这边已经配置好了（也就是说已经可以正常查询交易明细、余额了），那我们可以参考银企平台 - 系统管理 - 前置机配置页面中“厦门银行现金管理平台(XMB_CMP)”的配置去配置回单平台中银行配置页面的信息：
银行前置机IP地址
银行前置机端口
此外，还需要配置这几项：
现金管理客户号
用户号
机构号
通讯方式：默认值(HTTP)
第三步：回单获取方式
如果回单平台和厦门银行企业现金管理直连版前置机软件安装在同一台机器，可以通过【本机获取】的方式获取回单。银行服务器会把回单推送到前置机安装目录下的Temp文件夹。那么配置为【本机获取】后，“银行回单推送路径”就配置为Temp文件夹的完整路径。
下图为前置机安装路径的Temp文件夹：
如果回单平台和前置机软件不在同一台机器，可以通过银行sftp获取，回单获取方式选择【远程sftp获取】。那么客户需要在银行前置机上搭建一个sftp服务，根目录配置为Temp文件夹的完整路径（注意，如果用freesshd搭建sftp服务，根路径不支持中文），并确保回单代理程序能访问该SFTP服务。
搭建好sftp服务之后，在下图所示位置配置sftp的ip、端口、用户名、密码等信息：
第四步：任务的[创建]->[预处理] ->[下载] ->[扫描]阶段
为了快速的看到效果，可以在[配置项 - 银行配置]页面，将“厦门银行企业现金管理直联版电子回单调度方式”修改为“测试使用”（测试调度仅需要大约4分钟就可以完成一次调度）。修改并保存后，在[模块管理]页面重启【回单模块】生效。
1、创建调度
自动创建所有回单账号的前一天的回单任务。
刚部署的情况下是没有任务的，可以手动添加一个任务进行测试。如下图所示，点【+添加任务】按钮进行添加。注意：不要添加今日的任务，因为这个银行插件不支持当日回单下载。
2、预处理调度
1）账户交易明细查询接口[01603020101A0007]
根据银行账号、币别、交易日期等，调用账户交易明细查询接口[01603020101A0007]获取到核心流水编号hostSerialNo、借贷标识drcrFlag、转账金额amt，拼接出下载文件名fileName，规则为：账号_000156_日期(8位)_流水号_借贷方向_金额(小数位0不保留)。
接口的请求和响应报文如下：
2024-07-04 16:30:00.023 INFO [XMB_CMP,,1734413407211225088] 18211 --- [pool-2-thread-67] c.k.bos.bank.xmb.cmp.utils.SSLUtil : 获取交易明细列表，请求信息：00<?xml version="1.0" encoding="UTF-8"?> <ap> <head> <tr_code>01603020101A0007</tr_code> <cms_corp_no>E2XXXXXXXXX0</cms_corp_no> <user_no>XXX</user_no> <org_code>XX</org_code> <serial_no></serial_no> <req_no>17200818000230</req_no> <tr_acdt>20240704</tr_acdt> <tr_time>163000</tr_time> <channel>5</channel> <sign>0</sign> <file_flag>0</file_flag> <reserved></reserved> </head> <body> <acctNo>8XXXXXXXXXXXX7</acctNo> <currency>01</currency> <startDate>20230307</startDate> <endDate>20230307</endDate> <pager>true</pager> <start>1</start> <size>50</size> </body> </ap> 2024-07-04 16:30:00.023 INFO [XMB_CMP,,1734413407211225088] 18211 --- [pool-2-thread-67] c.k.bos.bank.xmb.cmp.utils.SSLUtil : ----****----: 通讯方式：HTTP 2024-07-04 16:30:02.563 INFO [XMB_CMP,,1734413407211225088] 18211 --- [pool-2-thread-67] c.k.bos.bank.xmb.cmp.utils.SSLUtil : 获取交易明细列表，响应信息：00<ap> <head> <tr_code>01603020101A0007</tr_code> <org_code>11</org_code> <cms_corp_no>E20220401002010</cms_corp_no> <user_id></user_id> <user_no>001</user_no> <serial_no></serial_no> <req_no>17200818000230</req_no> <tr_acdt>20240704</tr_acdt> <tr_time>163000</tr_time> <channel>5</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>4</total> <start>1</start> <size>50</size> <array> <dto> <currency>01</currency> <acctNo>8XXXXXXXXXXXX7</acctNo> <acctName>UAT3企业现金管理系统联调客户</acctName> <trDate>20230307</trDate> <trTime>174805</trTime> <hostSerialNo>9901A2102799</hostSerialNo> <origSerialNo></origSerialNo> <trType></trType> <trFrom>111300</trFrom> <txFlag></txFlag> <cashFlag>1</cashFlag> <drcrFlag>D</drcrFlag> <amt>22.33</amt> <feeAmt></feeAmt> <balance>93940815.52</balance> <lastBal></lastBal> <voucherType></voucherType> <voucherNo></voucherNo> <batchNo></batchNo> <referNo></referNo> <oppAcctNo>81101100001197</oppAcctNo> <oppAcctName>UAT3企业现金管理系统联调客户</oppAcctName> <oppBankNo></oppBankNo> <oppBankName></oppBankName> <summary>同行测试</summary> <postscript></postscript> </dto> <dto> …………………… </dto> <dto> …………………… </dto> <dto> …………………… </dto> </array> </body> </ap>
2）回单下载接口[01603020101A0019]
再根据下载类型downType（1-按文件名）、下载文件名fileName，调用回单下载接口[01603020101A0019]，获取到返回的文件名file_name。账户交易明细查询接口返回几条交易明细，就会调用几次回单下载接口。
交易成功后，在前置机的Temp文件夹下就会生成pdf回单文件。
接口的请求和相应报文如下：
2024-07-04 16:30:02.566 INFO [XMB_CMP,,1734413407211225088] 18211 --- [pool-2-thread-67] c.k.bos.bank.xmb.cmp.utils.SSLUtil : 获取文件名，请求信息：00 <?xml version="1.0" encoding="UTF-8"?> <ap> <head> <tr_code>01603020101A0019</tr_code> <cms_corp_no>E2XXXXXXXXX0</cms_corp_no> <user_no>XXX</user_no> <org_code>XX</org_code> <serial_no></serial_no> <req_no>17200818025650</req_no> <tr_acdt>20240704</tr_acdt> <tr_time>163002</tr_time> <channel>5</channel> <sign>0</sign> <file_flag>0</file_flag> <reserved></reserved> </head> <body> <downType>1</downType> <fileName>8XXXXXXXXXXXX7_000156_20230307_9901A2102799_0_22.33</fileName> </body> </ap> 2024-07-04 16:30:02.566 INFO [XMB_CMP,,1734413407211225088] 18211 --- [pool-2-thread-67] c.k.bos.bank.xmb.cmp.utils.SSLUtil : ----****----: 通讯方式：HTTP 2024-07-04 16:30:02.775 INFO [XMB_CMP,,1734413407211225088] 18211 --- [pool-2-thread-67] c.k.bos.bank.xmb.cmp.utils.SSLUtil : 获取文件名，响应信息：00 <ap> <head> <tr_code>01603020101A0019</tr_code> <org_code>XX</org_code> <cms_corp_no>E2XXXXXXXXX0</cms_corp_no> <user_id></user_id> <user_no>XXX</user_no> <serial_
【电子回单】厦门银行企业现金管理直连版（XMB_CMP）回单配置指南
声明：除非特别标注，否则均为本站原创文章，转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益，可联系本站删除。
