【电子回单】厦门银行企业现金管理直连版（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_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>1</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> <file_name>8XXXXXXXXXXXX7_000156_20230307_9901A2102799_0_22.33_A_xmadmin_44014.pdf</file_name> </body> </ap>
预处理调度结束后，可以通过点击任务的【详情】查看获取到的文件名：
3、下载调度
在下载调度阶段，回单平台通过远程sftp或者本机获取的方式将回单PDF文件从银行前置机Temp文件夹，下载到回单服务器的\tempPath\XMB_CMP\目录下并将其重命名，命名规则为：银行账号-交易日期-主机流水号-交易金额.pdf；然后又将其移动到scanPath\XMB_CMP\目录下。例如，回单获取方式为“远程SFTP获取”时，日志如下：
2024-07-04 16:31:00.014 INFO [XMB_CMP,,1734413407211225088] 18211 --- [pool-3-thread-8] c.k.b.b.x.c.j.XmbCmpReceiptDownloadJob : ------------*********-------------：要下载的文件名：8XXXXXXXXXXXX7_000156_20230307_9901A2105842_0_22.33_A_xmadmin_44013.pdf 2024-07-04 16:31:00.015 INFO [XMB_CMP,,1734413407211225088] 18211 --- [pool-3-thread-8] c.k.b.b.x.c.j.XmbCmpReceiptDownloadJob : -------------*********----------:回单获取方式为sftp 2024-07-04 16:31:00.016 INFO [XMB_CMP,,1734413407211225088] 18211 --- [pool-3-thread-8] c.k.bos.receiptmanage.util.SFTPUtils : getftp()里的ip = xxx.xxx.xxx.xxx，端口 = xx,bankLoginId = XMB_CMP-1 2024-07-04 16:31:00.016 INFO [XMB_CMP,,1734413407211225088] 18211 --- [pool-3-thread-8] c.k.bos.receiptmanage.util.SFTPUtils : 准备建立SFTP连接。 2024-07-04 16:31:00.121 INFO [XMB_CMP,,1734413407211225088] 18211 --- [pool-3-thread-8] c.k.bos.receiptmanage.util.SFTPUtils : 建立SFTP连接成功。 2024-07-04 16:31:00.121 DEBUG [XMB_CMP,,1734413407211225088] 18211 --- [pool-3-thread-8] c.k.bos.receiptmanage.util.SFTPUtils : 切换到ftp目录：/ 2024-07-04 16:31:00.223 INFO [XMB_CMP,,1734413407211225088] 18211 --- [pool-3-thread-8] c.k.bos.receiptmanage.util.SFTPUtils : 下载文件8XXXXXXXXXXXX7_000156_20230307_9901A2105842_0_22.33_A_xmadmin_44013.pdf到/XXXXX/tempPath/XMB_CMP/成功 2024-07-04 16:31:00.223 INFO [XMB_CMP,,1734413407211225088] 18211 --- [pool-3-thread-8] c.k.bos.receiptmanage.util.SFTPUtils : 下载文件成功 2024-07-04 16:31:00.223 INFO [XMB_CMP,,1734413407211225088] 18211 --- [pool-3-thread-8] c.k.b.b.x.c.j.XmbCmpReceiptDownloadJob : 文件名：8XXXXXXXXXXXX7_20230307_22.33_D_9901A2105842.pdf,下载成功。 2024-07-04 16:31:00.224 DEBUG [XMB_CMP,,1734413407211225088] 18211 --- [pool-3-thread-8] c.k.b.r.r.a.AbstractReceiptDownloadFlow : 移动文件：/u01/huidan/tempPath/XMB_CMP/8XXXXXXXXXXXX7_20230307_22.33_D_9901A2105842.pdf到扫描工作路径。/XXXXX/scanPath/XMB_CMP成功。
下载完成后，任务的状态会变成【下载完成】。
4、扫描调度
对下载到\tempPath\XMB_CMP\目录的文件进行扫描，解析出结构化数据保存到回单库的表中，同时将文件保存到\bakPath\XMB_CMP\目录下。扫描调度结束后，可点击回单任务的【结果】查看回单的结构化数据。
参考日志：
2024-07-04 16:32:00.023 INFO [XMB_CMP,scan,] 18211 --- [QuartzScheduler_Worker-5] c.k.b.r.r.f.process.FileScanDBProcess : 查询是否存在该日期的回单[XMB_CMP : 2023-03-07,查询结果：0] 2024-07-04 16:32:00.023 INFO [XMB_CMP,scan,] 18211 --- [QuartzScheduler_Worker-5] c.k.b.r.r.f.process.FileScanDBProcess : 将电子回单信息保存到数据库... 2024-07-04 16:32:00.044 INFO [XMB_CMP,scan,] 18211 --- [QuartzScheduler_Worker-5] c.k.b.r.r.f.process.FileScanDBProcess : 数据库当前没有记录，新增4条记录。 2024-07-04 16:32:00.055 DEBUG [XMB_CMP,scan,] 18211 --- [QuartzScheduler_Worker-5] c.k.b.r.r.f.job.AbstractFileScanJob : 将文件信息更新到数据库成功。 2024-07-04 16:32:00.022 INFO [XMB_CMP,scan,] 18211 --- [QuartzScheduler_Worker-5] c.k.b.r.r.f.process.FileScanProcess : 移动到备份目录成功:/XXXXX/bakPath/XMB_CMP/20230307/8XXXXXXXXXXXX7_20230307_22.33_D_9901A2102799.pdf 2024-07-04 16:32:00.022 INFO [XMB_CMP,scan,] 18211 --- [QuartzScheduler_Worker-5] c.k.b.r.r.f.process.FileScanProcess : 对文件根据日期进行分类 2024-07-04 16:32:00.022 INFO [XMB_CMP,scan,] 18211 --- [QuartzScheduler_Worker-5] c.k.b.r.r.f.process.FileScanProcess : key = /XXXXX/bakPath/XMB_CMP/20230307/8XXXXXXXXXXXX7_20230307_22.33_D_9901A2102799.pdf
【电子回单】厦门银行企业现金管理直连版（XMB_CMP）回单配置指南
厦门银行企业现金管理直连版（XMB_CMP），是发请求银行推送回单文件的方式。配置步骤如下：第一步：在[配置项 - 系统配置]页面启用银...
点击下载文档
本文2024-09-22 20:17:25发表“eas cloud知识”栏目。
本文链接：https://wenku.my7c.com/article/kingdee-eas-112672.html
您需要登录后才可以发表评论， 登录登录 或者 注册
最新文档
热门文章
