中国农业银行公网版部署文档（ABC_DC）
1. 背景
配置之前，先要和银行申请环境和资料，找IT管理员配好网络。
银行资料请参考：
（1）前置机安装材料
（2）客户相关数据；
（3）测试使用账套数据；
请仔细阅读文档。清晰步骤了再进行配置。
补充说明：
中国农业银行公网版本，由于银行返回的交易明细、批量付款是文件格式，需要通过搭建前置机代理程序服务传输文件和获取文件，同时，银行电子回单文件可以推送到前置机目录下，因此回单文件下载可以通过代理程序的电子回单文件服务获取，电子回单部署流程参考。金蝶前置机代理程序下载
2. 实施流程
3. 搭建农业银行前置机程序
3.1. 中国农业银行银企通或银企通讯平台
安装前置机软件
银行方提供安装包、部署文档，按银行部署文档装好银企通，尽量保证银企通的安装目录下不存在中文，安装完成目录参考如下图：
农行银企通主要的两个目录：
data:是用于存放需要上传银行的付款文件，对应配置在金蝶前置机代理程序上
detail:是用于存放下载的付款结果文件、交易明细文件、历史余额文件，对应配在金蝶前置机代理程序上。
启动银企通
启动银企通服务，进行系统配置（按银行提供的部署文档操作，以下仅供参考）
本地服务器地址、交易端口、文件端口都在银行提供的测试数据中，然后点击服务器连接测试验证是否连通，请务必确保安装银企通的服务器与银行环境直接的连通性，注意杀毒软件及防火墙的限制。
通讯协议选择“TCP协议”
系统配置完成后，登录银企通。
到此银企通配置完成，接下来部署银企云。
3、 安装部署银企云
银企云基于苍穹平台开发，通过在MC系统部署银企云补丁进行环境更新。
4.1 安装银企云环境
1） 下载银企云的补丁包
2） 参考苍穹银企云补丁安装与部署手册进行补丁安装部署
4. 安装部署银企云
4.1. 配置【查询与支付】参数
4.1.1. 配置银企连接通道配置参数
1）登录金蝶云星瀚，进入银企云的应用【查询与支付】
2） 进入【银行启用管理】，启用“中国农业银行公网版”
3） 进行【银企连接通道配置】，新增或修改“中国农业银行公网版”，参数配置说明如下：
基础连接配置：
1） 前置机IP地址：安装农行前置机所在服务器IP，如果客户做过IP映射，应填入映射后的IP，目的是要能保证银企云能正常与银行前置机进行交互。
2） 端口号：银企云通过前置机IP地址和端口号访问银行前置机，这个端口号是指前置机软件的ERP接入的接入端口（如果银行前置机软件的版本不同可能对应的端口界面不一样，按实际录入）
网银登录配置（银行提供的配置）
3） 企业机构编号、操作员编号：银行提供录入
4） 银行测试系统日期：银行提供，生产环境请务必置空，置空，这个参数的作用是由于银行测试服务器的日期可能不是当前系统日期，做农行电票测试时，银行要求票据日期必选与银行某个日期保持一致，因此测试环境通过该参数配置银行要求的日期进行测试验证，格式为yyyy-mm-dd比如2022-01-01这种格式，但是生产环境一定不能填写，否则会导致业务出现问题。
金蝶前置代理配置（与银行前置机程序安装在一台服务器上，详细部署操作请参考第4章安装前置机代理程序）
5） 金蝶代理服务器端口号：对应金蝶前置代理程序上启动的中国农业银行公网版的服务端口，务必两边保持端口一致性。
其他配置：
6） 是否显示为17位：交易明细下载时，如果对方帐号属于农行，选择false则不对付款账号加工处理；选择true则付款账号显示为17位。按需选择。
配置完成后，点击保存，然后点击测试连接；
注意：点击测试连接，代表银企到前置机安装的服务器端口通了；如果不通的话，请检查ip和端口的配置，如果是公有云环境，这里测试连接不通是正常的，需要通过网络代理连接配置中进行测试连接
4.1.2. 配置银企账户
1） 进入【银企账户】，新增或者修改银企账户
2） 账户参数说明如下：
账户类别：一般都是普通类，这个取决于维护的银行账户所属类别，比如如果是虚拟现金池账户就维护成虚拟现金池。
电子回单账号：该银行账号如果需要做电子回单，则需要维护成是，一般情况下如果是账户管理中维护为电子回单功能，同步到银企则显示为是。
地区码：农行的账户需要维护地区码，城市对应的地区码可以参考
http://web20.kingdee.com/eb_cloud_cnaps/abc
代发工资单位编号：如果使用代发工资，并且与银行签订了代发工资的接口协议，银行会提供这个单位编号，需要录入，否则忽略
其他参数目前还未有作用，默认为空即可。
4.1.3. 银企联通测试
银企账户配置完成之后，可以在在【查询与支付】-银行账户查询内，查询该账户余额，如果余额能够成功查询，代表与银行前置机的通讯配置是成功的，可以进行实际的交易测试；
4.1.4. 银行参数配置
银行参数配置本身有默认参数，如果没有特殊情况可以不用配置。以下对常用的参数进行说明：
支付是否需要进行KD标记：选是时用于智能对账和识别金蝶的付款，影响:电子回单摘要会附带KD标记，付款摘要长度增加，比如摘要显示为KD@1e2e3f5g费用报销
回单明细限制查询日期：为空不限制查询回单和回单的日期，当设置为日期T时，不允许查询T-1及之前日期的交易明细和T-2及之前日期的电子回单。
上划下拨参数：划拨业务可以通过该参数控制接口选择路由。
联动支付参数：联动支付业务可以通过该参数控制接口选择路由
代发业务参数：控制是否允许业务系统通过银企云做代发工资业务，不影响报销代发业务。
具体付款接口参数可以参照银行付款路由图中的接口路由走向，这里不做详细说明
交易明细摘要取值：银行交易明细的摘要附言字段有多个时，可以通过该参数选择返回给业务系统的摘要，可以是单个字段，也可以是多个拼接起来返回。
4.2. 配置【金蝶代理程序】参数
4.2.1. 配置中国农业银行公网版参数
l 下载金蝶前置机代理程序安装包，解压后启动
l 进入“中国农业银行公网版”页面进行配置
服务端口：设置未被占用的端口，并且需要开放给银企云访问
1）配置参数
修改银行参数配置，按下图序号对应修改即可，其他参考无特殊要求不修改。
序号1：服务端口：代发工资、批量付款、历史余额、交易明细业务使用接口，需保持端口开放，如无特殊需求，在2302端口不被其他程序占用前提下，使用默认的2302即可，该配置的端口号需要在【查询与支付】-【银企连接通道配置】金蝶代理服务器端口号保持一致；
序号2：农行公网付款文件上传目录：农行前置机与代理程序通过文件目录交互，需配置真实的银企通或通讯平台的安装目录下，一般是对应安装目录下的data目录；
序号3：农行公网付款结果文件下载目录：农行前置机与代理程序通过文件目录交互，需配置真实的银企通或通讯平台的安装目录下，一般是对应安装目录下的data目录；
序号4：农行公网版交易明细文件下载目录：农行前置机与代理程序通过文件目录交互，需配置真实的银企通或通讯平台的安装目录下，一般银企通的安装目录下存在detail目录，则填到安装目录下的detial目录，通讯平台安装目录下不存在detail目录，则填写对应安装目录下的data目录；
序号5：农行公网版历史余额文件下载目录：农行前置机与代理程序通过文件目录交互，需配置真实的银企通或通讯平台的安装目录下，一般银企通的安装目录下存在detail目录，则填到安装目录下的detial目录，通讯平台安装目录下不存在detail目录，则填写对应安装目录下的data目录；
序号6：访问IP地址白名单：除了本机IP以外，任何需要访问代理程序的服务IP都需要配置，包含银企云服务器IP、银行前置机服务器IP，如果是公有云一般是通过网络代理程序访问，则对应配置网络代理程序的IP
注意：如果服务上有杀毒软件，请务必保证杀毒软件已经设置了访问IP的白名单。确保银企云与金蝶代理程序和银行前置机之间，银行前置机与银行端的网络通畅，自行检测方式为：服务器上telnet代理程序服务端口号,比如代理程序IP端口提供的是172.20.10.10 ，端口2302 ,那么我们需要确保我们服务器能正常访问，
telnet 172.20.10.10 2302 正常联通，以此类推
2）启动服务
代理程序参数配置完成后，点击【启动】按钮
中国农业银行公网版部署文档（ABC_DC）
本文2024-09-22 23:36:07发表“云星瀚知识”栏目。
本文链接：https://wenku.my7c.com/article/kingdee-xinghan-134072.html
