发请求银行返回文件流介绍：

    电子回单程序向前置机发送回单下载的请求，银行收到请求后将回单文件的文件流通过前置机返回给回单程序，电子回单程序将回单文件的文件流转成文件存在本地。（不需进行PDF文件的传输，即不需要配置银行SFTP服务）

    接口调用详细过程为：

    电子回单模式为异步调用模式，需先调用生成电子回单的接口，由银行侧生成电子回单后（一般需10分钟处理时间），而后调用“同步电子回单”接口获取回单文件，最后调用银企直联提供的SDK或调用新版http方式进行回单文件下载。

    流程调用图：

    兴业银行接口文档：https://ec.cib.com.cn/#/docCenter?pageCode=yqzlmhsy&menuId=291

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

    在回单代理程序[配置项 - 系统配置]页面，启用银行插件列表中勾选"兴业银行直连版(CIB_DC)"后保存，然后切换到[银行配置]页签，选择这个插件之后开始进行配置。

1. 银行前置机IP、端口、企业客户号、登录用户号、登录密码

• 银行前置机IP地址

• 银行前置机端口

• 兴业银行银企直联的'企业客户号'

• 兴业银行银企直联的'登录用户号'

• 兴业银行银企直联的'登录密码'

    这些信息，可以参考银企平台的配置。具体如下：登录银企web，进入[系统管理 - 前置机配置]，选择“中国兴业银行直连版(CIB_DC)”，把这里配置的信息拷贝到回单系统的银行配置页面即可。

2. 兴业银行银企直联的'推送文件端口'

    兴业银行前置机配置的“文件端口”，默认端口是8008。需要开通文件服务，具体操作如下：

1）打开兴业银行银企直连客户端，点[选项 - 参数设置]（注意，旧版要先【中断监听】才能打开参数设置页面。如果是生产环境，中断监听操作要经客户同意才能操作），打开参数设置页面，如下图所示：

• 是否开通文件服务：必须要勾选

• 服务协议：SOCKET（下载回单的方式为SDK）或 HTTP（下载回单的方式为HTTP）

• 文件端口：默认是8008

• 发送源地址：默认是ALL；有些客户会把发送源地址配置为银企服务器的IP；这种情况下，如果回单代理程序跟银企服务器没有部署在同一台机器上，也要把回单服务器的IP配置到这里

    下图为兴业银行前置机升级对比：

    另外，注意要到回单服务器上用telnet命令测试一下是否能访问这个文件端口8008。

2）保存配置后，点【开始监听】

3. 兴业银行银企直联的'文件接收路径'

    此路径为回单服务器下的路径（注意：是回单服务器下的路径，不是兴业银行前置机电脑下的路径），回单原始文件将会下载到这里。需事先手动创建好文件夹，否则无法下载。

4. 下载兴业银行回单的方式

    支持SDK和HTTP两种方式，请根据跟银行签订的协议选择回单下载方式。默认值(SDK)

    说明：目前20230720版本上不支持HTTP下载的方式，下个版本支持。

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

• 创建调度

    创建兴业银行的回单任务。

• 预处理调度

    回单代理程序发送查询回单的请求给兴业银行前置机，前置机将请求转发给银行。具体如下：

调用请求ELECTRONICRECEIPTTRNRQ（响应ELECTRONICRECEIPTTRNRS）获取到批次号：

<CLT_REF_NO>1666022121463087105</CLT_REF_NO>

注意：请求是发送到兴业银行前置机的监听端口8007

• 下载调度

1） 调用请求ASYNRECEIPTINFOTRNRQ（响应ASYNRECEIPTINFOTRNRS）根据批次号<CLT_REF_NO>获取到文件名和文件ID(zip文件格式的文件名是随机的)，类似下面这样：

<CONTENT>

    <SEQ>1</SEQ>

    <FILE_ID>101-1YiQM_wtSVe</FILE_ID>

    <FILE_NAME>8dc05_129680100100942294_20230606_1.zip</FILE_NAME>

</CONTENT>

 注意：请求是发送到兴业银行前置机的监听端口8007

2）调用银企直联提供的SDK或调用新版http方式进行回单文件下载

    下载兴业银行回单的方式选择“SDK”时，回单代理程序会调用兴业银行的SDK包进行下载文件，连接的地址：兴业银行前置机IP:文件端口8008。

    下载兴业银行回单的方式选择“HTTP”时，采用HTTP下载回单，下载url为：

http://银行前置机IP地址:文件端口/download?fileId=FILE_ID&fileName=FILE_NAME，下载后的文件保存在文件接收路径下。

    银行收到请求后，将回单文件的base64字符串文件流返回给回单代理程序。回单代理程序解析并生成回单文件，放到回单代理程序服务器下的文件接收路径路径下。然后将文件下载到回单文件下载保存根目录下的tempPath目录，再转移到scanPath目录。

• 扫描调度

    回单代理程序将下载到scanPath目录的文件扫描，解析出结构化数据保存到数据库，同时将文件保存到bakPath目录下。

三、常见问题

1、兴业银行任务失败，提示：银行返回报文中没有包含FILE_NAME和FILE_ID的content

2、银企平台 - 业务管理 - 银行业务配置 - 兴业银行电子回单格式

    兴业银行支持两种格式的回单：报文、文件。如果客户要下载的是文件格式的回单，那在部署回单代理程序、配置并下载兴业银行的回单之后，还要在银企平台 - 业务管理 - 银行业务配置页面把“兴业银行电子回单格式”设置为“文件”，重启银企服务生效。

3、兴业银行前置机-参数设置页面的文件服务协议选择

    近期遇到2家客户，使用默认的SDK方式下载回单，兴业银行前置机-参数设置页面，文件服务协议选择了“HTTP”，在回单任务的下载阶段，获取到文件名后，开始调用兴业银行jar包进行下载文件，连接到兴业银行前置机文件端口192.xxx.xxx.xxx:8008成功后，触发了读超时事件，日志如下：

---------------------------------------

2023-07-13 10:31:00.349 ERROR [,,] 7936 --- [nioEventLoopGroup-40-1] n.f.handler.DefaultRequestFileHandler   : [通道id：75ec5d4b]，DcfirmException code=[dcfirmdemo-app_S001],error message=[读超时异常]

2023-07-13 10:31:00.351 ERROR [CIB_DC,,1679158674989252608] 7936 --- [pool-4-thread-39] c.k.b.b.c.d.job.CibDcReceiptDownloadJob : ERROR:下载文件错误，银行返回错误:DcfirmException code=[dcfirmdemo-app_C002],error message=[DcfirmException code=[dcfirmdemo-app_S001],error message=[读超时异常]]

2023-07-13 10:31:00.351 ERROR [CIB_DC,,1679158674989252608] 7936 --- [pool-4-thread-39] c.k.b.r.r.a.AbstractReceiptDownloadFlow : 回单下载发生异常。

com.kingdee.bos.receiptmanage.receipt.exception.ReceiptException: com.kingdee.bos.receiptmanage.receipt.exception.ReceiptException: 下载文件错误，银行返回错误:DcfirmException code=[dcfirmdemo-app_C002],error message=[DcfirmException code=[dcfirmdemo-app_S001],error message=[读超时异常]]

---------------------------------------

    然后将兴业银行前置机-参数设置页面的文件服务协议选择“SOCKET”后，再去重新下载任务，可以下载成功了。