【电子回单】湖南银行金融管理平台版（HRXJB_CMP）回单配置指南

栏目：eas cloud知识作者：金蝶来源：金蝶云社区发布：2024-09-22浏览：1

金蝶电子回单代理程序向湖南银行前置机发送电子回单打印查询请求，交易成功时在湖南银行前置机安装路径的Temp目录下生成回单文件，最后再通过事先安装在湖南银行前置机电脑上的SFTP下载回单文件或通过本机获取的方式下载回单文件。

一、回单代理程序 - 配置项 - 银行配置

在回单平台 - 配置项 - 系统配置页面的银行插件列表中，勾选“湖南银行金融管理平台版(HRXJB_CMP)”后点【保存】按钮，切换到银行配置页面，在“---请选择银行---”下拉列表中就可以选择到这个插件并进行配置了（前置机默认是HRXJB_CMP-1，注意这里的前置机编号要跟银企平台的前置机编号保持一致）。

1、配置项参考

可以参考银企平台 - 系统管理 - 前置机配置页面“华融湘江金融管理平台版(HRXJB_CMP)”的配置，配置这两项：

银行前置机IP地址
银行前置机端口

银企平台该插件的配置：

2、回单获取方式

当湖南银行前置机和电子回单代理程序部署在同一台机器时，请选择“本机获取”，“银行回单推送路径”配置为湖南银行前置机安装路径的Temp目录。

当湖南银行前置机和电子回单代理程序部署不在同一台机器时，请选择“远程SFTP获取”。在湖南银行前置机这台机器上搭建sftp服务，可以参考回单部署文档的第五章附录操作。注意，SFTP服务的根路径要配置为湖南银行前置机安装路径的Temp目录（根目录不支持中文）。搭建SFTP服务后，把SFTP服务的IP、端口、用户名、密码，配置到这里：

3、通讯协议

通讯协议支持TCP、HTTP两种方式，默认选择TCP。

二、任务的[创建]->[预处理] ->[下载] ->[扫描]阶段

1、[创建]任务调度

系统会自动创建所有电子回单账号的前一天的回单任务。

刚部署的情况下是没有任务的，可以手动添加一个任务进行测试。如下图所示，点【+添加任务】按钮进行添加。

2、[预处理]任务调度

在预处理任务调度阶段，会根据任务的账号和日期，获取到回单文件名。预处理任务完成后，可以点【详情】查看文件名，如下图所示：

下面详述预处理获取文件名称的过程：

1）根据查询账户明细接口(200110)获取到主机流水号

调用查询账户明细接口200110，根据账户、币种及回单日期获取到交易明细记录数以及交易明细文件名file_name（一般是 “交易时间.query”），交易成功后就会在湖南银行前置机安装目录的Temp目录下生成这个交易明细文件。

请求和响应报文如下：

2024-05-29 11:43:00.369  INFO [HRXJB_CMP,,1795269241012748288] 7208 --- [pool-3-thread-1] c.k.bos.bank.hrxjb.cmp.utils.SSLUtil    : ----****----：获取交易明细清单文件名称--请求信息：000000041400<ap>
    <head>
        <tr_code>200110</tr_code>
        <cms_corp_no></cms_corp_no>
        <user_no></user_no>
        <org_code></org_code>
        <serial_no></serial_no>
        <req_no></req_no>
        <tr_acdt>20240529</tr_acdt>
        <tr_time>114300</tr_time>
        <channel>5</channel>
        <sign></sign>
        <file_flag>1</file_flag>
        <reserved></reserved>
    </head>
    <body>
        <acno>8xxxxxxxxxxxxxxx6</acno>
        <cur_code>01</cur_code>
        <start_date>20240321</start_date>
        <end_date>20240321</end_date>
    </body>
</ap>
2024-05-29 11:43:00.370  INFO [HRXJB_CMP,,1795269241012748288] 7208 --- [pool-3-thread-1] c.k.bos.bank.hrxjb.cmp.utils.SSLUtil    : ----****----：获取交易明细清单文件名称--请求方式为tcp
2024-05-29 11:43:01.129  INFO [HRXJB_CMP,,1795269241012748288] 7208 --- [pool-3-thread-1] c.k.bos.bank.hrxjb.cmp.utils.SSLUtil    : ----****----：获取交易明细清单文件名称--响应信息：000000050100<ap>
<head>
    <tr_code>200110</tr_code>
    <cms_corp_no></cms_corp_no>
    <user_no></user_no>
    <req_no></req_no>
    <serial_no>39330359</serial_no>
    <tr_acdt>20240529</tr_acdt>
    <tr_time>114301</tr_time>
    <succ_flag>0</succ_flag>
    <ret_info>交易成功</ret_info>
    <ret_code>0000</ret_code>
    <ext_info></ext_info>
    <reserved></reserved>
    <file_flag>1</file_flag>
    <org_code></org_code>
    <total>1</total>
</head>
<body>
    <file_name>2024052939330359.query</file_name>
    <total>1</total>
    <record_num>1</record_num>
    <field_num>48</field_num>
</body>undefined</ap>

2）回单平台通过远程SFTP或者本机获取的方式，从Temp目录下读取到交易明细文件并下载到\tempPath\HRXJB_CMP路径下，然后进行解析，目的是获取到主机流水号host_serial_no的信息。

3）根据电子回单打印查询接口(200219)获取回单文件名并生成回单文件

调用电子回单打印查询接口200219，根据账户、币别、回单日期以及主机流水号host_serial_no，交易成功后返回回单的文件名称file_name。

请求和响应报文如下：

2024-05-29 11:43:01.295  INFO [HRXJB_CMP,,1795269241012748288] 7208 --- [pool-3-thread-1] c.k.bos.bank.hrxjb.cmp.utils.SSLUtil    : ----****----：获取回单文件名称--请求信息：000000042000<ap>
    <head>
        <tr_code>200219</tr_code>
        <cms_corp_no></cms_corp_no>
        <user_no></user_no>
        <org_code></org_code>
        <serial_no></serial_no>
        <req_no></req_no>
        <tr_acdt>20240529</tr_acdt>
        <tr_time>114301</tr_time>
        <channel>5</channel>
        <sign></sign>
        <file_flag>0</file_flag>
        <reserved></reserved>
    </head>
    <body>
        <acno>8xxxxxxxxxxxxxxx6</acno>
        <cur_code>01</cur_code>
        <tr_acdt>20240321</tr_acdt>
        <host_serial_no>14939217</host_serial_no>
    </body>
</ap>
2024-05-29 11:43:01.295  INFO [HRXJB_CMP,,1795269241012748288] 7208 --- [pool-3-thread-1] c.k.bos.bank.hrxjb.cmp.utils.SSLUtil    : ----****----：获取交易明细清单文件名称--请求方式为tcp
2024-05-29 11:43:02.049  INFO [HRXJB_CMP,,1795269241012748288] 7208 --- [pool-3-thread-1] c.k.bos.bank.hrxjb.cmp.utils.SSLUtil    : ----****----：获取回单文件名称--响应信息：000000043300<ap>
    <head>
        <tr_code>200219</tr_code>
        <cms_corp_no></cms_corp_no>
        <user_no></user_no>
        <req_no></req_no>
        <serial_no>39330372</serial_no>
        <tr_acdt>20240529</tr_acdt>
        <tr_time>114302</tr_time>
        <succ_flag>0</succ_flag>
        <ret_info>交易成功</ret_info>
        <ret_code>0000</ret_code>
        <ext_info></ext_info>
        <reserved></reserved>
        <file_flag>1</file_flag>
        <org_code></org_code>
    </head>
    <body>
        <file_name>QP20240529_39308362_00000000_seal.pdf</file_name>
    </body>
</ap>

如下图所示，调用查询账户明细接口200110 和电子回单打印查询接口200219后，交易成功则会在湖南银行前置机安装路径的Temp目录下生成交易明细文件和回单文件。