客户备付金存管系统接口设计说明书(3)

2020-03-27 02:25

保密级别:内部

1.1.3 关于字段次序:

对于XML,同一层的字段次序可以不参照本文档中的字段次序描述;

对于多域串(即以’|’作为每个字段结束符的字符串,以下简称MFS)或格式化字符串,字段次序必须严格与本文档中的字段次序描述保持一致。

1.1.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位,其中带两位小数位的字段。

1.1.5 关于空字段:

表示字段在某些条件下允许为空字段,空字段在XML中对应的是空元素,在格式化字符串中则用全空格填充至规定的长度。

1.1.6 关于续查标志:

对于CMF返回CMES的数据包,由于有每次数据包不超过2K大小的限制,所以当可能有多条数据返回,需要在数据包中设置一个续查标志字段,如果续查标志为“1”时,表示本次数据还没有全部传输完成,CMES需要再次接收,直到续查标志等于“0”为止。

1.1.7 关于多域串:

多域串用于企业银行内部各子系统之间返回多条记录,简写为MFS,多域串采用固定分隔符,对于本系统而言,分隔符一般采用“|”,除非有特殊说明。

本文档中对于多域串的情况并没有明确给出每个字段的排列顺序,而是将每条记录的内容用XML方式表达在段里面。真正在实现时,首先第一条记录是字段名记录,如果采用理想实现方式,则根据该字段名记录可以确定排列顺序,因而不必事先约定顺序。

1.1.8 关于定位串:

定位串用于返回多条记录的交易中,定位串的组成格式由服务方决定,定位串缩写为FFS。客户端在第一次请求时将定位串置成空,服务端在应答时对每条返回的记录填写定位

[单击键入项目名称] 接口设计说明书

- 3/49 -

软件开发中心

保密级别:内部

串。

定位串必须给定字段排列顺序,本文档中设计定位串的地方主要都是与CMF通讯的接口里面,下面每个交易都是通过交易表中起始字段和终止字段来表述的,在这两个字段之间顺序排列即可。

1.1.9 关于文件:

对于CS和ES之间的多笔下交易,如果ES可能返回多条记录时,一律用文件来传输数据。但如果交易本身失败或返回记录数为0时,则不产生文件。文件格式为多行MFS的文本文件。

1.1.10关于操作员密码:

企业操作员和银行操作员的密码都为最长8位的字母或数字。在传输过程中单独加密,加密后为16字节的可见字符串。

1.1.11关于认证码、数字签名和加密:

企业操作员在签到时,ES会根据某种算法得出一个认证码,以后每次该操作员作交易时都要求送认证码供ES校验。认证码为32字节的可见字符串。

数字签名是为了防抵赖和防篡改的要求,具体哪些交易需要签名、哪些签名字段和签名顺序如何是通过ES的交易控制配置文件来确定。

CC-CS需要通讯加密。哪些交易需要加密也是通过ES的交易控制配置文件来确定。

1.1.12关于返回结果:

一笔交易的结果的返回结果用返回来源+返回码来标示,返回信息为返回码的具体中文含义,扩展信息中包含了详细的信息。

由于成功的返回结果有多种可能(如交易成功,预约受理,交易落地等),特约定这种情况下返回来源都为‘0’。

1.1.13关于批量数据下传方式:

数据内容 集团企业关系 账户授权关系 账户基本信息 收费明细 交易控制文件 文件格式转换定义文件 数据字典 CMF => CMES 多行格式化串文件 多行格式化串文件 多行格式化串文件 多行格式化串文件 / / ∕ CMES => CMECS 多行MFS文件 多行MFS文件 ∕ 多行MFS文件 配置文件 配置文件 多行MFS文件 - 4/49 -

CMECS => CMECC 多行MFS文件 多行MFS文件 ∕ XML数据包(C303交易) 配置文件 配置文件 多行MFS文件 软件开发中心

[单击键入项目名称] 接口设计说明书

保密级别:内部

版本信息 对账单 CMECC界面定制 企业操作员权限 操作员可操作账户 ∕ 多行格式化串文件 ∕ ∕ ∕ 配置文件 / ∕ ∕ ∕ 配置文件 / XML文件 XML数据包(C111交易) XML数据包(C109交易) 1.1.14关于批量数据上传方式:

数据内容 代发工资 CMECC=>CMECS 多行定位串文件 CMECS=>CMES 多行定位串文件 CMES=>AFTS 多行定位串文件 1.1.15关于企业银行子系统内部接口间查询类的返回接口:

查询类交易分多笔查询和单笔查询,其中单笔查询包括:查询单帐户余额、下级查询上存支取余额等交易;多笔查询包括:查询帐户明细等。

单笔查询交易:应答报文不通过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.1.16关于企业银行与CMF接口间查询类的返回接口:

单笔查询交易仍然不通过RespPrvData来返回。 多笔查询返回RespPrvData(应答私有区)、Item(条目计数)和ContFlag(续查标志),其中Item表示返回的应答私有区中有多少条记录,而ContFlag表示是否需要继续查询,RespPrvData采用的是定位串(FFS)方式实现的,具体字段位置由参考相关交易接口。

1.1.17通讯区大小约定

由于企业银行CS与ERP肯定在局域网内部,因此约定ERP与企业银行系统之间的通讯区大小为100K,请求数据包不可能大于100K,而应答数据包如果超过100K,则通过文件返回。是否通过文件返回,在公共包头中有“是否文件返回的标识”,如果采用文件返回,则

[单击键入项目名称] 接口设计说明书 - 5/49 - 软件开发中心

保密级别:内部

公共包头中可以通过“批量文件名”字段获得返回的文件名;如果采用非文件方式返回,则按照1.5.11的约定获取RespPrvData字段。

而CS与ES通讯是通过专线或者拨号,因此约定其通讯区大小为10K。而多笔明细返回一般会超过10K,因此ES目前返回多笔明细一般均采用文件返回。

1.1.18 Rcd表述

为了标识清楚多笔返回的RespPrvData中所包含的内容,我们用来表示循环记录,其中用XML的字段表述了每条记录所包含的字段。但是这并不代表RespPrvData中的记录是采用这个格式返回的,而是按照多域串返回。

2. 数据字典定义

数据字典是本系统的业务基础,基本涵盖了所有的字段及其属性信息。数据字典的用途可以非常广泛,目前数据字典的功用还有待开发。

2.1. 字典键值索引(0) 2.2. 返回来源(1)

0 成功返回 1 CMECC返回 2 CMECS返回 3 CMES返回 4 CMF返回 5 ABIS返回 6 CM返回 7 CMC返回

2.3. 农行他行标志(2)

0 1

农行 他行

2.4. 同城异地标志(3)

0 1

异地 同城

[单击键入项目名称] 接口设计说明书 - 6/49 - 软件开发中心

保密级别:内部

2.5. 汇兑类型(4)

0 1 2

普通汇兑

上级发起的下级账户之间的划款 上级发起的下级账户的对外支付

2.6. 反向归集标志(5)

0 1

不做 做

2.7. 利息再分配周期(6)

1 2 3 4

每月月底 每月20日 每季季底 每季20日

2.8. 利息再分配标志(7)

0 1

不自动分配 自动分配

2.9. 法人间资金归集标志(8)

0 1

非法人间资金归集 法人间资金归集

2.10. 资金归集方向(9)

1 2

向上 双向

2.11. 资金归集周期(10)

1 2 3

每天 每月 不定期

[单击键入项目名称] 接口设计说明书 - 7/49 - 软件开发中心


客户备付金存管系统接口设计说明书(3).doc 将本文的Word文档下载到电脑 下载失败或者文档不完整,请联系客服人员解决!

下一篇:街道社区党支部书记述职报告范本

相关阅读
本类排行
× 注册会员免费下载(下载后可以自由复制和排版)

马上注册会员

注:下载文档有可能“只有目录或者内容不全”等情况,请下载之前注意辨别,如果您已付费且无法下载或内容有问题,请联系我们协助你处理。
微信: QQ: