1 简介

1.1 功能介绍

介绍第一次实施电子回单测试，如何进行配置和测试。

1.2 应用场景

需要获取银行提供的电子回单

1.3 系统路径

【银企云】→【电子回单】

2 主要操作

2.1 电子回单-回单参数配置

前提条件

（1）和银行沟通过，需要使用银行的电子回单业务；

（2）【银企云】-【查询与支付】已经测试通过；

操作步骤

（1）确认是否进入过【电子回单】应用，如果第一次进入，则需要根据你要使用的银行进行前置机配置；

（2）进入【电子回单应用】后，首先需要配置回单基础参数：这里的参数配置，是与业务系统交互的关键信息；

文件上传参数：向业务系统上传回单文件的参数配置，可以选择为是，直接调用微服务，则不需要相关参数；

手机号：对后续回单缺失预警、回单下载通道异常的预警人，建议填写回单管理员；

（3）配置完改参数后，确认需要下载哪个银行的回单？并且联系银行确认，需要什么方式下载银行传过来的回单文件？另外要确认是需要电子回单应用进行请求才会返回回单还是银行主动推送到指定地点？下图以中行为例子：

注：现在获取电子回单的方式支持：①银行前置机下载、②银行提供SFTP获取、③通过接口获取回单；其中通过接口获取回单是不需要配置回单前置机的，其他两个是需要的，并且必须在【查询与支付】应用内，配置过银企连接通道才可以；

（4）大部分银行是支持①、②两种方式的，其中银行前置机下载，需要使用到金蝶提供的代理软件来进行文件的解析：代理软件下载连接：金蝶代理软件

• 代理软件安装的服务器IP

• 代理软件内电子回单服务的端口；

• 银行前置机放置电子回单文件的文件夹（需要咨询银行）（注意该文件夹不可以有中文）
  

（5）用SFTP下载回单的，需要搭建SFTP服务，可以和银行沟通搭建；填写相关SFTP 的信息；

2.2 电子回单-回单任务检查

前提条件

检查回单调度，是否正确启动；进入【电子回单】-【回单配置管理】-【回单调度计划】，搜索电子回单，查看调度的状态；如果调度状态都是禁用，需要启用，如果不启用是无法自动执行回单任务得。

操作步骤

（1）检查完调度计划，可以等待调度计划执行，或从业务系统发起回单查询；

（2）回单查询请求到达电子回单，电子回单应用会开始执行回单下载任务；可以在【电子回单】-【回单任务管理】里查看回单任务得执行状态；

（3）可以观察回单的流程状态；本步骤如果出现异常；请检查一下几项内容：

• 下载失败：查看后面的回单缺失类型和详细原因；根据提示检查前置机等连接是否正常；特别是银行主动推送文件类型的任务，需要先确认银行已经推送了文件，不然是下载不到的；

• 上传失败：检查回单参数配置里是否正确配置上传参数；没有问题的话检查一下前提条件内的上传调度；

• 是否有交易明细：如果本身没有发生交易，没有产生过明细，那么必然也是没有回单文件的，除非银行单独给你推送；这个需要和银行协商好。这类没有明细的回单，只能做测试检查回单通道，不能用来匹配；

2.3 电子回单-正确下载回单

（1）当所有任务都可以正确支持的时候，可以在回单任务列表查看回单下载结果，查看详细回单下载情况；

（2）也可以通过回单结果列表，查看详细下载的回单，以及和明细的匹配情况；

2.4 电子回单-回单日志查看

（1）当通过任务列表内的缺失情况和详情无法确认相关问题时，可以通过获取日志，进行问题分析；

（2）日志获取途径【查询与支付】-银企云日志列表；根据业务类型进行日志查看；回单（即电子回单下载的日志）、回单查询（业务系统向电子回单应用获取回单的日志）；

（3）通常回单下载失败，先查看业务类型为回单的日志；

（4）选择刚才执行的回单任务，点击查看日志按钮；选择银行日志，然后查看详细报错信息；

（5）如果无法判断是否有问题，可以将该日志复制出来提供给管理员进行查看；