1.基础环境准备

1.1.硬件准备

1.2.软件安装

由于接口机需要在jdk环境下运行，因此需要安装jdk文件，安装时一直点击“下一步”直到安装完成即可

软件SVN地址：https://svn.ztccloud.com.cn:18080/svn/springcloud_product/trunk/doc/产品经营中心/03-原型产品研发过程资料/接口机/jdk-8u181-windows-x64.exe

1.3.网络调试

1.3.1.司库和前置机网络

需要保证司库服务器的网络和前置机的网络打通，建议前置机和司库的服务器最好放到同一机房，若没有放在一起则需要客户的信息部门协助打通一下网络。

测试网络是否联通的方式，linux命令：ping 192.168.234.1，此处IP地址换成前置机ip地址即可

1.3.2.前置机内网和外网

需要前置机的内网和外网IP建立了映射关系（由客户信息部门完成）

2.光大银行

2.1.nacos配置

<BANK_INFO BANK_CODE="303" GROUP_CODE="01" NAME="光大银行" INTERFACE_IP="http://192.168.243.10:8000">

<INTERFACE_INFO INTERFACE_NAME="查询当日余额_新" INTERFACE_CODE="dayAccountBlance" INTERFACE_URL="ceb/queryTodayAccountBalanceNew"/>

<INTERFACE_INFO INTERFACE_NAME="查询历史余额" INTERFACE_CODE="hisAccountBlance" INTERFACE_URL="ceb/queryHistoryAccountBalance"/>

<INTERFACE_INFO INTERFACE_NAME="查询当日交易详细信息" INTERFACE_CODE="dayTransDetail" INTERFACE_URL="ceb/queryTodayTransHisDetails"/>

<INTERFACE_INFO INTERFACE_NAME="查询历史交易详细信息" INTERFACE_CODE="hisTransDetail" INTERFACE_URL="ceb/queryBankTransHisDetails"/>

<INTERFACE_INFO INTERFACE_NAME="公对公转账" INTERFACE_CODE="corporateTrans" INTERFACE_URL="ceb/corporateToCorporateTrans"/>

<INTERFACE_INFO INTERFACE_NAME="公对私转账" INTERFACE_CODE="privateTrans" INTERFACE_URL="ceb/corporateToPrivateTrans"/>

<INTERFACE_INFO INTERFACE_NAME="交易状态查询" INTERFACE_CODE="transStatusQuery" INTERFACE_URL="ceb/transStatusQuery"/>

<INTERFACE_INFO INTERFACE_NAME="电子回单查询" INTERFACE_CODE="elecReceiptQuery" INTERFACE_URL="ceb/elecReceiptQuery"/>

<INTERFACE_INFO INTERFACE_NAME="电子回单下载" INTERFACE_CODE="elecReceiptDownload" INTERFACE_URL="ceb/elecReceiptDownload"/>

</BANK_INFO>

复制上面的内容到nacos，并修改GROUP_CODE以及INTERFACE_IP即可

1）BANK_CODE对应银行的大行编码，无需修改

2）GROUP_CODE对应集团编码，可以到“配置平台-基础数据-组织数据-公司部门”查看，一级节点集团名称后面对应的编码即集团编码

3）NAME对应银行的名称，无需修改

4）INTERFACE_IP为前置机的IP地址和端口，此处的端口需要和接口机application文件中的port一致。若是同一台前置机，不同的银行配置的端口不可以相同

2.2.接口机配置

2.2.1.端口选择及测试

通过linux命令查看端口是否被占用：netstat -ano可以查看所有被占用的端口，选择任意一个没有被占用的端口

2.2.2.Application文件配置

1）端口（port）配置：填写没有被占用的端口，保证和nacos的端口一致

2）接口查询url：http://127.0.0.1:8000，这里127.0.0.1为本地ip地址，无需修改，后面的端口8000改为银行的监听端口（和银行保持一致）

3）客户号、操作员号、操作员密码根据银行提供的测试环境资料配置即可

4）文件地址：这里的文件地址为光大银行推送存储PDF电子回单的文件夹，在光大银行安装文件的File文件夹下，具体路径根据安装地址选择。光大银行将文件放到此文件夹之后，在司库系统“资金管理-账户管理-电子回单”点击同步附件按钮，会根据这里配置的文件路径以及回单编号去查找对应的文件并解析到司库系统

2.2.3.接口机jar包

光大银行接口机jar包SVN地址：

https://svn.ztccloud.com.cn:18080/svn/springcloud_product/trunk/doc/产品经营中心/03-原型产品研发过程资料/接口机/ceb/zfs-bank-server.jar

2.2.4.接口机启动

将配置好的application文件放到光大银行接口机jar包对应的目录下，然后把光大银行的接口机jar包和接口机启动程序放到前置机任一同一文件夹下，然后双击接口机启动程序启动接口机，启动成功后会出现运行成功的提示，直接最小化即可，不要关闭掉

同时该目录下回出现“run”和“logs”这两个文件，其中“logs”可以查看接口机的相关日志，若没有出现这两个文件，则检查jdk文件是否有安装成功。

接口机启动程序SVN地址：

https://svn.ztccloud.com.cn:18080/svn/springcloud_product/trunk/doc/产品经营中心/03-原型产品研发过程资料/接口机/接口机一键启动.bat

2.3.Nacos和接口机网络联通测试

测试网络是否联通的方式，linux命令：telnet 192.168.234.1 8000，此处IP地址换成前置机ip地址，端口换成对应的端口即可

2.4.银行前置机配置

根据银行提供的配置手册配置前置机即可

注意：

1）若软件版本是2.0.0.8往上的版本，则可以跳过这一步，不需要安装这两个证书

2）安装时若根据银行的配置手册证书类型选择的是国密证书，并且登录是要求选择证书，则可以将证书类型切换成RSA证书，再次登录

2.5.银行接口清单

业务名称	交易码
当日余额查询	b2e004031
交易明细查询	b2e004002
电子回单查询	b2e005003
转账交易（对公）	b2e004001
转账结果查询	b2e004003

2.6.资金测试入口说明

1）光大银行无历史余额接口，系统取每日的最后一笔当日余额转为历史余额（最新版本已更新历史余额接口）

2）光大银行当日交易明细和历史交易明细为同一个接口，根据日期来区分

3）电子回单点击接口查询按钮，则调用银行的电子回单查询接口，查询到电子回单结构化数据，同时银行将PDF电子回单推送到指定的文件夹（详细见application文件配置），然后点击同步附件，资金到前置机对应的文件夹下根据回单编号等信息获取对应的文件。

银企直联部署手册（光大）

银企直联部署手册（光大）

关于作者

目录