6.4 查询多帐户余额(C502) ............................................................................................ 43 6.4.1 ERP2CS请求报文扩展字段 .................................................................................. 43 6.4.2 CS2ERP应答报文扩展字段 .................................................................................. 43 6.5 查询单账户明细(7505) ............................................................................................. 43 6.5.1 ERP2CS请求报文扩展字段 .................................................................................. 44 6.5.2 CS2ERP应答报文扩展字段 .................................................................................. 44 6.6 查询单帐户余额(7506) ............................................................................................. 45 6.6.1 ERP2CS请求报文扩展字段 .................................................................................. 45 6.6.2 CS2ERP应答报文扩展字段 .................................................................................. 45 6.7 汇兑(1908) ................................................................................................................. 46 6.7.1 ERP2CS请求报文扩展字段 .................................................................................. 47 6.7.2 CS2ERP应答报文扩展字段 .................................................................................. 48 6.8 资金上划、资金上存(2556、2559) ......................................................................... 48 6.8.1 ERP2CS请求报文扩展字段 .................................................................................. 49 6.8.2 CS2ERP应答报文扩展字段 .................................................................................. 49 6.9 资金下拨、资金支取(2557、2558) ......................................................................... 50 6.9.1 ERP2CS请求报文扩展字段 .................................................................................. 50 6.9.2 CS2ERP应答报文扩展字段 .................................................................................. 51 6.10 查询金融交易处理状态(1944) ............................................................................. 51 6.10.1 ERP2CS请求报文扩展字段 .................................................................................. 51 6.10.2 CS2ERP应答报文扩展字段 .................................................................................. 52 6.11 企业操作员签到(C100) ............................................................................................ 52 6.11.1 ERP2CS请求报文扩展字段 .................................................................................. 52 6.11.2 CS2ERP应答报文扩展字段 .................................................................................. 53 6.12 企业操作员签退(C101) ........................................................................................ 53 6.13 代发工资(1909) ..................................................................................................... 53 6.13.1 ERP2CS请求报文扩展字段 .................................................................................. 54 6.13.2 CS2ERP应当报文扩展字段 .................................................................................. 54 6.14 代发工资文件 ............................................................................................................. 54 6.15 发送企业通知(C400) ............................................................................................ 55 6.15.1 CS2ERP请求报文扩展字段 .................................................................................. 55 6.15.2 ERP2CS应答报文扩展字段 .................................................................................. 56 6.16 通知内容的结构 ......................................................................................................... 56 6.16.1 到账通知 ................................................................................................................. 56 6.16.2 抹账通知 ................................................................................................................. 57 6.16.3 更新通知 ................................................................................................................. 57 6.16.4 批量完成通知 ......................................................................................................... 57 7
总结性说明 ............................................................................................................................. 58 7.1 7.2 7.3 7.4 7.5 7.6
两种接入方式的比较 ..................................................................................................... 58 汇兑(1908)的附加说明 ............................................................................................. 58 汇兑(1908)与划拨交易(2556、2559、2557、2558)的区别 ............................. 59 查询多帐户余额(C502)与查询单帐户余额(7506) ............................................ 59 C500、C501与7505 ..................................................................................................... 59 查询金融交易处理状态(1944) ................................................................................. 60
IV
7.7 企业操作员签到(C100)和企业操作员签退(C101) ............................................ 60
V
农行企业银行ERP接口开发参考资料
1 前言
1.1 编写目的
本文档用于描述了农行企业银行的处理机制,定义了面向外部系统的接口,供企业财务系统ERP开发接口程序参考。 1.2 背景
现金管理服务平台瞄准的目标是目前国内银行业务占比超过80%的对银行生存和发展更具有决定意义的公司客户,采用国际上比较先进的金融服务理念、金融服务产品和服务方法而实现的公司业务产品。在产品的设计、开发中,我们始终贯彻“以客户为中心、以市场为导向”的经营理念,全面整合了我行现有公司业务功能,是对ABIS系统业务产品功能的进一步扩充和完善,属于一种多功能的“包裹式金融产品”。
企业银行平台是应现金管理项目而诞生的,目前主要作为现金管理平台的企业接入服务渠道。但是它的应用前景又不仅仅局限于现金管理产品,而应该将对公金融产品都可以在该平台上发布。
企业银行平台提供了两种方式供客户使用,一是与企业财务系统对接,二是提供操作界面给企业。其中与企业财务系统对接的模式有两种,一种是提供动态链接库给ERP调用,第二种是提供SOCKET服务进程。
本文档主要是将企业银行平台接口开放给客户,便于企业财务系统开发与农行企业银行平台的接口。 1.3 定义与缩略语
1 2
AIBS:农行综合业务系统的简称(又称新一代业务系统),是负责帐务处理和数据处理的核心业务系统。
AIPS:农行综合前置系统的简称,是连接各种交易渠道和各种交易后台的枢纽,负责接收来自交易渠道的的交易请求,根据交易要素决定交易处理的路径,最后向交易渠道返回交易处理的结果。
CM:ABIS中的现金管理子系统缩写,主要负责现金管理项目中的各种新需求的实现,是后台核心子系统。
CMF:现金管理项目中分行中心非ABIS的所有系统简称,包括AIPS上的现金管理应用、文件传输、到帐通知等功能。
CMC:现金管理项目的总行交换中心,是基于AISC(农行综合交换系统)进行开发,具有对公跨中心交易清算等功能,是跨中心批量处理的核心。
CME:即本文档描述的对象,是现金管理项目企业客户端和银行客户接入系统的统称,主要负责客户管理、客户联机交易接入、客户批量交易的发起和接收等功能。 CMES:CME的银行端接入服务器,简称ES。 CMEC:CME的企业端系统总称。
1
PP/CME/RD0004V1.0
3 4 5 6 7 8
企业银行平台
农行企业银行ERP接口开发参考资料
9 10 11 12
CMECC:CMEC的客户端,简称CC。 CMECS:CMEC的服务端,简称CS。
CMECT:CMEC的通讯器,提供SOCKET服务给ERP调用,简称CT。
ERP: 将企业与农行企业银行对接的财务系统简称为ERP,可能不是企业真正意义上的ERP系统。
1.4 约定
1.4.1 关于通讯方式:
ERP与CS之间:Socket方式中报文结构为“包头+数据包”。包头固定为7个字节长,第1字节为是否加密标志(0-不加密,1-加密)。后6个字节是数据包的长度,即将报文长度直接转为字符串存储,长度不足6位则右边用空格补足,比如:“1234 ”。比如汇兑的长度为1234字节的数据包,其包头为“11234 ”共7位;查询单账户余额的长度为1000字节的数据包,其包头为“01000 ”共7位。其中数据包长度包含加密包标志位。 1.4.2
关于XML约定:
XML(包括XML数据包和XML文件)都不包含头部的XML声明(即
在XML数据包中所有元素的数据都不采用属性,而一律用字符数据的文本块来表示。 1.4.3
关于字段次序:
对于XML,同一层的字段次序可以不参照本文档中的字段次序描述;
对于多域串(即以’|’作为每个字段结束符的字符串,以下简称MFS)或格式化字符串,字段次序必须严格与本文档中的字段次序描述保持一致。 1.4.4
关于字段类型:
字段类型分为以下三类:
Cn:字段允许为任何可见字符(包括数字和中文),n在XML中表示有效数据的最大总长度,如果有效数据长度不足n位按实际位数;在格式化字符串(定长字符串)中表示固定的长度,如果有效数据长度不足n位,则有效数据左对齐,右边用空格补足至n位;
Nn:字段内容只允许为0-9数字,n在XML中表示有效数据的最大总长度,如果有效数据长度不足n位按实际位数;在格式化字符串中表示固定的长度,如果有效数据长度不足n位,则有效数据右对齐,左边用空格补足至n位;
Nm.n:基本上与Nm类型类似,但字段内容可以允许为负号、0-9数字和小数点,其中m表示有效数据的最大总长度(对于格式化字符串中表示固定长度),n表示小数位数,通常用来表示发生额、余额等金额类字段,如N15.2表示15位,其中带两位小数位的字段。
企业银行平台
2 PP/CME/RD0004V1.0
农行企业银行ERP接口开发参考资料
1.4.5 关于空字段:
表示字段在某些条件下允许为空字段,空字段在XML中对应的字段值为空,在格式化字符串中则用全空格填充至规定的长度。 1.4.6
关于多域串:
多域串用于企业银行内部各子系统之间返回多条记录,简写为MFS,多域串采用固定分隔符,对于本系统而言,分隔符一般采用“|”,如果多域串内的字段值还是多域串(如通知查询交易),则字段值的多域串分隔符一般采用“/”,除非特殊说明。
本文档中对于多域串的情况给出了当前情况下字段排列顺序,实际上本接口文档中设计上相对灵活,由于第一条记录是字段名记录,如果采用灵活实现方式,则根据该字段名记录可以确定排列顺序,因而不必事先约定顺序。 1.4.7
关于定位串:
定位串用于返回多条记录的交易中,定位串的组成格式由服务方决定,定位串缩写为FFS。客户端在第一次请求时将定位串置成空,服务端在应答时对每条返回的记录填写定位串。
定位串必须给定字段排列顺序,本文档中设计定位串的地方主要都是与CMF通讯的接口里面,下面每个交易都是通过交易表中起始字段和终止字段来表述的,在这两个字段之间顺序排列即可。 1.4.8
关于文件:
由于部分交易中涉及的交易包过大,如果采用交易包返回,将造成较多的冗余,所以采用文件方式返回。文件的格式和交易包中的格式定义基本相同,唯一的区别可能就是将一条条记录拆成了文件的一条记录而已。文件的上传、下载可以通过调用我们提供的通讯底层来获取。 1.4.9
关于操作员密码:
企业操作员的密码都为最长8位的字母或数字。在传输过程中单独加密,加密后为16字节的可见字符串。
1.4.10 关于认证码、数字签名和加密:
企业操作员在签到时,ES会根据某种算法得出一个认证码,以后每次该操作员作交易时都要求送认证码供ES校验。认证码为32字节的可见字符串。
数字签名是为了防抵赖和防篡改的要求,具体哪些交易需要签名、哪些签名字段和签名顺序如何是通过ES的交易控制配置文件来确定。
CC-CS需要通讯加密。哪些交易需要加密也是通过ES的交易控制配置文件来确定。
企业银行平台
3
PP/CME/RD0004V1.0