农行企业银行ERP接口开发参考资料
1.4.11 关于返回结果：
一笔交易的结果的返回用返回来源+返回码来标示，返回信息为返回码的具体中文含义，扩展信息中包含了详细的信息。
由于成功的返回结果有多种可能（如交易成功0000，交易落地0001，预约受理0002，等），约定这种情况下返回来源都为‘0’。 1.4.12 关于查询类的返回接口：
查询类交易分多笔查询和单笔查询，其中单笔查询包括：查询单帐户余额、下级查询上存支取余额等交易；多笔查询包括：查询帐户明细等。
单笔查询交易：应答报文不通过RespPrvData来返回，而是直接填写XML域。 多笔查询交易：多笔查询交易无论笔数是1还是多条，都需要首先判断是否通过文件返回，如果不是通过文件，则肯定是通过RespPrvData来返回的多笔记录。记录数（行数）通过Cme/RecordNum得到(值为N)，字段数（列数）通过Cme/FieldNum得到(值为M)。其中RespPrvData的构成方式如下：
字段1名|字段2名|??|字段M名|第一条记录字段1值|第一条记录字段2值|??|第一条记录字段M值|??|第N条记录字段1值|第N条记录字段2值|??|第N条记录字段n值|
如果是通过文件方式，则文件的记录格式也是采用多域串，但是有所差异，就是将每条记录分开成文件的每条记录，格式如下：
字段1名|字段2名|??|字段M名|
第一条记录字段1值|第一条记录字段2值|??|第一条记录字段M值| ??
第N条记录字段1值|第N条记录字段2值|??|第N条记录字段n值| 1.4.13 通讯区大小约定
由于企业银行CS与ERP肯定在局域网内部，因此约定ERP与企业银行系统之间的通讯区大小为100K，请求数据包不可能大于100K，而应答数据包如果超过100K，则通过文件返回。是否通过文件返回，在公共包头中有“是否文件返回的标识”，如果采用文件返回，则公共包头中可以通过“批量文件名”字段获得返回的文件名；如果采用非文件方式返回，则按照1.5.12的约定获取RespPrvData字段。
2 系统结构描述
2.1 CME系统框架结构 CME的系统框图如下：
企业银行平台
4 PP/CME/RD0004V1.0
企业端:IC卡读写器 农行企业银行ERP接口开发参考资料
银行端:企业财务系统ERP农行企业服务器CS安全验证服务器拨号IC卡读写器农行企业服务器CS农行企业客户端CC银行企业金融服务器ES专线CMFIC卡读写器农行企业服务器CS企业财务系统ERP农行企业通讯器CT
2.2
系统软件结构
农行企业银行平台是农业银行现金管理项目企业客户端和银行端企业接入系统的统称，主要负责客户管理、客户联机交易接入、客户批量交易的发起和接收等功能，简称CME。CME包括三部分，一是企业客户端（CMEC），二是银行对企业的接入端（CMES），三是银行对企业的监控和管理（CMEM）。
CMEC是农行企业银行平台直接展示给企业客户部分，这部分包含直接面对客户的CC、处理所有业务的应用服务器CS以及负责通讯的Hsclient底层库。在实现上采用组件技术，企业应用服务器就是一个组件服务器，可根据企业需求动态加载或卸载交易组件。
CMES是CMEC在银行的接入系统，是客户端能完成的主要功能的处理部分，此部分设计上采用平台化结构，具有很好的可拓展性。CMEM是为满足银行内部各级管理部门对企业监控和管理的需求而设计的，主要有系统维护及日终处理的功能实际上也是CMES的一个客户端系统。
CMF是现金管理项目中分行中心非ABIS的所有系统简称，包括AIPS上的现金管理应用、文件传输、到帐通知等功能；CME直接和CMF进行数据交换。 2.3
ERP接入方式
由上图可以看出，目前农行企业银行系统提供了两种接入方式：
第一种是ERP调用银行提供的底层动态库HSClient.dll来与CS进行通讯，无论发送交易包还是文件处理都可以通过调用底层库里面的API函数实现。
第二种农行提供企业通讯器CT，该通讯器是一个SOCKET服务进程，ERP只需将交易包发送给CT并接收CT应答即可，如果应答数据太大通过文件返回，则CT将文件保存在指定目录下，ERP系统根据应答包里面的文件名到指定目录去获取文件，反之，如果ERP需要上
企业银行平台
5
PP/CME/RD0004V1.0
农行企业银行ERP接口开发参考资料
传文件，也可以将文件存放到指定目录下，由CT将文件发送给CS。
3 交易机制描述
企业银行是为了提高企业客户的业务处理效率，将银行的服务延伸到企业内部的电子化业务提交渠道，并在银行系统与客户资源管理系统（ERP）间建立对接平台，使企业非常便捷的进行支付结算并能准确的了解银行帐务信息，最终实现企业内部资金的最优配置。
企业银行提供给客户的功能主要分为：操作员管理类功能、系统维护类功能、结算类功能、集团资金管理类功能和查询类功能。 3.1
系统实现功能
3.1.1 操作员管理
包括对操作员签到、操作员查询、操作员增加、操作员修改、操作员改密、修改IC卡密码。 3.1.2
系统维护类功能
包括资金归集参数维护。即提供修改上存利率、修改下拨利率、修改留存最低限额、留存最高限额四个功能。 3.1.3
结算类功能
企业客户能发起的结算功能包括： ? 汇兑
汇兑根据收、付款方的不同分为三种汇兑类型：普通的汇兑、上级发起的下级帐户之间的划款、上级发起的下级帐户的对外支付。
若收付款双方都在农行开户，则可以实现实时到帐。 若收款方在他行开户，需要在主办行落地做后续处理。 ? 签发银行汇票
系统将客户发起的签发银行汇票（银行本票）交易送主办银行做“落地”处理，柜员按照交易信息扣帐，打印出银行汇票（银行本票），然后由银行指定人员将银行汇票（银行本票）送到企业。企业人员将已办好的汇票申请书（本票申请书）和银行人员交换银行汇票（银行本票）。 ? 签发银行本票 同上。
? 预约提现
银行接到该指令后不做帐务处理，仅需在客户指定的时间内按要求的各种面值准备足够现金等待客户来提取。如果银行与企业签订了协议送款上门，则可以先处理帐务，送款
企业银行平台
6
PP/CME/RD0004V1.0
农行企业银行ERP接口开发参考资料
上门后再向客户收取现金支票。 ? 支票挂失
严格意义上该功能不属于结算类功能。企业从客户端发起对遗失的支票进行挂失，系统直接调用银行后台支票挂失交易，无须银行做落地处理，相当于口头挂失的功能。 ? 申购支票
企业从客户端发起申购支票交易，银行收到指令后做“落地”处理，即柜员凭打印出的“落地业务凭证”做企业购买支票交易，然后企业通过自取或银行送达的方式来领取支票。
? 代发工资
ERP提交代发工资可以采用两种途径：一是ERP通过提交一定格式的代发工资文件给系统的文件服务器，同时发一条代发工资指令。二是ERP先产生代发工资文件，利用系统提供的企业客户端（CC）的文件转换功能，转换成系统内部的代发工资文件格式，提交代发工资指令及代发工资文件，系统将文件发送到银行后台报表服务器上，并产生一条落地指令，等待柜员进行处理。 3.1.4
集团资金管理类功能
集团资金管理是系统为了满足集团日间资金调拨需求提供的功能，主要包括四个功能： ? 资金上划：上级企业将下级企业帐户的资金上划到自己的帐户。 ? 资金下拨：上级企业将自己企业帐户的资金下拨给下级企业。 ? 资金上存：下级企业将资金上存到上级企业帐户。
? 资金支取：下级企业从上级企业帐户支取资金到自己的帐户。 3.1.5
查询类功能
? 帐户信息查询
包括：查询单帐户余额、帐户明细查询提交、查询帐户明细、查询帐户授权关系、查询多帐户余额。 ? 票据信息查询
包括：查询票据买入余额、查询买入票据信息、查询退票信息 ? 集团资金信息查询 包括：查询上存资金余额、查询下拨资金余额、查询汇总上存余额、查询汇总下拨余额、查询上存支取明细、查询上划下拨明细 ? 额度信息查询
包括：查询授信额度使用情况、查询授信额度使用明细、查询转移/恢复授信额度明细 ? 收费明细查询
? 其他信息查询（如汇率、利率查询等） 3.1.6
到账通知
到帐通知是对电子支付业务的补充。即银行处理完由客户发起的支付业务后主动通知收款人，或银行处理完借记客户帐户的业务后主动通知付款人，或银行处理完贷记客户帐户的业务后主动通知收款人。通知的手段有电子邮件、手机短信、电话，或通过与企业之间的专
企业银行平台
7
PP/CME/RD0004V1.0
农行企业银行ERP接口开发参考资料
线等等。企业客户端是到帐通知的一种重要的实现方式。 3.2
消息机制
消息机制是本系统的一个特色，消息的类型通过通知类型字段描述。目前的消息类型有四类：
1、 到帐通知：由银行业务主机系统产生发给企业银行，例如汇兑，资金划拨等对帐户
产生借贷操作后通知企业；
2、 抹帐通知：如果帐户产生了抹帐，则产生一笔抹帐通知，将抹帐的交易明细返回给
客户，供ERP系统进行对帐处理。
3、 批量完成通知：系统异步查询完成的结果通知。
4、 更新通知：系统给企业客户端的一些消息如版本更新信息；
如果ERP需要接收消息，则ERP必须启动一个消息接收的服务SOCKET端口。消息的处理流程如下：
1. 消息源产生消息，系统接收到消息后记录此笔消息。 2. 消息定时器查询是否有新的消息。 3. 消息定时器将消息发送给指定企业。
4. 企业端系统消息服务器收到消息后将消息按照操作员权限进行记录。 5. 企业端系统消息定时器将各操作员的记录发送给在线企业操作员。
6. 定时器休眠后再循环操作。
3.3
帐户明细查询异步处理机制
系统提供帐户明细查询功能，考虑到帐户明细对银行主机的压力和数据量一般比较大的情况，系统采用异步处理机制。即ERP首先发起“提交帐户明细查询”交易，收到的应答并不是查询完成的数据，而仅仅是提交查询成功。企业银行系统会将提交的多帐户拆分成为单帐户从银行主机抓取明细数据，每抓取完成一个帐户，会产生一笔批量完成通知发送给企业。当企业接收到该通知后，再通过“查询交易明细”交易从企业的服务器本地获取帐户明细数据。处理流程如下：
1． ERP发起查询请求 2． CS转发请求
3． ES接收请求，返回成功。 4． CS将应答结果返回给ERP。
5． ES将多帐户查询的交易包拆分成单帐户查询，并向CMF发起取交易明细，接收应
答后记录明细，如果数据没有抓取完成，则不断向CMF重复查询该帐户直至明细数据下载完成为止。
6． 某帐户查询完毕后，ES从数据库中取出符合查询条件的明细生成查询结果文件。 7． ES生成一笔批量完成通知给CS。
8． CS接收通知后下载查询结果文件并记录到数据库中。 9． CS向ERP转发批量完成通知。 10． ERP再发起查询帐户明细交易请求，如CS返回成功则ERP根据返回包中的
BatchFileName字段指定的文件名获取查询结果文件。1）如果ERP采用调用动态库方式接入，则ERP通过HSClient.dll提供的文件下载指令下载查询结果文件；2）
企业银行平台
8
PP/CME/RD0004V1.0