【电子回单】中国农业发展银行直联版(ADBC_DC)回单配置指南

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

中国农业发展银行回单文件获取方式，是回单程序发起请求后，银行返回文件到银行前置机路径，然后金蝶回单程序再去下载。若回单程序与银行前置机在同一个路径就可以本地获取，不在就需要在前置机搭建ftp服务，以便回单程序通过ftp获取到前置机回单文件。

一般情况下，客户是在银企平台上能够查询农业发展银行账户余额、交易明细之后，并到[业务管理 - 账号管理]列表页面把账号设置为电子回单账号，然后再去电子回单代理程序中配置回单。

农业发展银行回单配置大概包含以下几个步骤：

第一步：农业发展银行前置机服务器上搭建sftp服务

如果农业发展银行前置机和电子回单服务器在同一台服务器上，则不需要搭建sftp服务了，跳过这个步骤。

银行服务器会把回单推送到农业发展银行前置机安装路径下，所以需要以此回单所在目录为根目录搭建好SFTP服务，并确保回单代理程序能访问该SFTP服务。

如何搭建sftp服务？

1）可参考《电子回单程序部署说明V1.0.20230106.docx》文档的“五、附录”操作（下载回单安装包并解压，\ebgProxy_20230106 目录下就有这个文件）

2）搭建sftp服务的工具freesshd可以在帖子中找到下载链接：https://vip.kingdee.com/article/165500974349008896?productLineId=8 ）

搭建sftp服务之后，记录一下sftp服务的SFTP服务的“IP”、“端口”、“账号”、“密码”信息。

需要注意的是，用freesshd搭建的sftp服务，其根目录不支持中文（经验表明，根目录有中文的时候，测试连接不通，且还存在中文乱码问题），所以请将其安装在一个非中文路径下。

第二步：登录进入回单系统，在[配置项 - 银行配置]页面配置相关信息

登录进入电子回单系统后，在[回单 - 配置项 - 系统配置]页面，“启用银行插件列表”中勾选“中国农业发展银行(ADBC_DC)”后保存，然后切换到[银行配置]页面就可以选到这个插件了。

配置前置机的ip和端口信息

可以参考银企平台-系统管理-前置机配置页面中，农业发展银行前置机IP和端口的配置：

集团号和子账号序号需找银行获取后维护保存。

配置回单获取方式

如果农发行前置机和电子回单服务器在同一台服务器上，则回单获取方式选择“本地获取”，然后“银行回单推送路径”配置为农发行前置机回单文件存放的全路径。

如果农发行前置机和电子回单服务器不在同一台服务器上，则回单获取方式选择“远程sftp获取”，需要把前置机中搭建的sftp服务的“IP”、“端口”、“账号”、“密码”配置到下图所示的“银行SFTP服务器IP地址”、“银行SFTP端口”、“登录SFTP服务器使用的用户名”、“登录SFTP服务器使用的密码”文本框中，“银行SFTP文件保存子路径”如果sftp工具配置的是回单文件存放路径则配置/，如果是在配置路径的download文件下则配置/download。保存之后，点【测试连接】按钮，测试连接通过后，再去下载回单。

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

为了快速的看到效果，可以在[配置项 - 银行配置]页面，将“中国农业发展银行电子回单调度方式”修改为“测试使用”（测试调度仅需要大约4分钟就可以完成一次调度）。修改并保存后，在[模块管理]页面重启【回单模块】生效。

1、创建调度

自动创建所有回单账号的前一天的回单任务。

刚部署的情况下是没有任务的，可以手动添加一个任务进行测试。如下图所示，点【+添加任务】按钮进行添加。注意：不要添加今日的任务，回单有可能缺失。

2、预处理调度

通过账户汇划明细查询报文（eb.qry.023.1）接口查询明细，然后账户汇划明细信息查询响应报文（eb.qry.024.1）接口会返回明细信息。

根据上一步返回的查询账号、查询日期、银行流水号、借贷标志调用电子回单下载请求报文（eb.qry.035.1）接口获取回单文件存放路径。

3、下载调度

回单代理程序从农发行前置机服务器上搭建的SFTP服务上（或农发行前置机服务器的回单目录下。具体从哪里获取，要看“回单获取方式”是“远程sftp获取”还是“本机获取”）将回单文件下载到电子回单代理程序服务器的“ [回单 - 配置项 - 系统配置]里配置【回单文件下载保存根目录】”的tempPath\ADBC_DC\目录下，并将其重命名；然后转移到scanPath\ADBC_DC目录下，如下是对应日志。