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

1、中国农业银行支付机构客户备付金存管监管平台银企直连接口设计说明书文档信息：版本：项目： 密级：状态：模板版本：V1.0.0修订记录：日期版本修订目的描述作者20140301V0.0.1新增靖飞20140526V1.0.0修改靖飞20140528V1.0.1修改靖飞20140528_1V1.0.2修改靖飞20140602V1.0.3修改靖飞20140603V1.0.4修改靖飞20140627V1.0.5修改靖飞20140707V1.0.6修改宋旭20140716V1.0.7修改宋旭20140717V1.0.8修改宋旭20140718V1.0.9修改宋旭20140721V1.0.10修改刘潇201

2、40815V1.0.11修改靖飞20140826V1.0.12修改靖飞20140903V1.0.13修改靖飞修订内容：版本修订内容V0.0.1生成文档；V1.0.0第一版初稿；V1.0.1特殊业务转账交易增加支付机构信息相关标签；V1.0.21-增加银行行号；2-修改C01，C03含义；V1.0.31. 增加交易码；2. 将公共报文归类；3. 修改某些报文字段长度；V1.0.41. 将省市代码和币种长度都改为3位；V1.0.51.修改表C和表O文件格式；V1.0.61.为文件接口O表合计行增加一空列，使其与明细行列数相同V1.0.71.修改CFRA33、CQLA34、CQLA35、CQLA36

3、、CFRA35接口，增加或统一报表日期接口，CFRA33、CQLA34、CQLA36增加客户上传文件列分隔符接口V1.0.81.删除B、N、AA报表接口银行代码域V1.0.91.表D接口增加D04(其它)列V1.0.101.CFRA33文件接口行尾添加分隔符V1.0.111. 完善收款方白名单设置和查询；2. 修改特殊业务转账转账类型的范围，将“本行其他”和“他行其他”去掉；3. 修改上传文件的文件名规则，必须按照规则上传；V1.0.121. 修改CQRT71接口；V1.0.131. 修改CQLA36接口 保密级别：内部目录1.引言11.1.目的11.2.背景与目标11.3.预期读者11.4.

4、术语表11.5.参考资料21.6.约定21.1.1关于通讯方式：21.1.2关于XML约定：21.1.3关于字段次序:31.1.4关于字段类型：31.1.5关于空字段：31.1.6关于续查标志：31.1.7关于多域串：31.1.8关于定位串：31.1.9关于文件：41.1.10关于操作员密码：41.1.11关于认证码、数字签名和加密：41.1.12关于返回结果：41.1.13关于批量数据下传方式：41.1.14关于批量数据上传方式：51.1.15关于企业银行子系统内部接口间查询类的返回接口：51.1.16关于企业银行与CMF接口间查询类的返回接口：51.1.17通讯区大小约定51.1.18Rc

5、d表述62.数据字典定义62.1.字典键值索引（0）62.2.返回来源（1）62.3.农行他行标志（2）62.4.同城异地标志（3）62.5.汇兑类型（4）72.6.反向归集标志（5）72.7.利息再分配周期（6）72.8.利息再分配标志（7）72.9.法人间资金归集标志（8）72.10.资金归集方向（9）72.11.资金归集周期（10）72.12.资金归集种类（11）82.13.特殊业务转账类型（）82.14.银行行号82.15.公式编号123.字段定义173.1.根段173.2.CHANNEL段184.交易公共接口184.1.本系统公共包头184.2.可能用到的报文定义204.2.1.IC

6、C2ICS请求报文公共字段214.2.2.ICS2ICC应答报文公共字段224.2.3.ICS2BSA请求报文公共字段224.2.4.BSA2ICS应答报文公共字段235.交易接口235.1.特殊业务转账（CFRA37）235.1.1.交易说明235.1.2.接口说明245.1.2.1.ERP/CC->银行 请求报文扩展字段265.1.2.2.银行->ERP/CC 应答报文扩展字段275.1.2.3.BEICS->BSA 请求报文扩展字段275.1.2.4.BSA->BEICS 应答报文扩展字段275.1.3.返回信息说明275.1.4.特殊说明275.2.查询转账处理

7、状态（CQRT71，同1944）285.2.1.交易说明285.2.2.接口说明285.2.2.1.ERP/CC->银行 请求报文扩展字段295.2.2.2.银行->ERP/CC 应答报文扩展字段295.2.2.3.BEICS->BSA 请求报文扩展字段295.2.2.4.BSA->BEICS 应答报文扩展字段295.2.3.返回信息说明295.2.4.特殊说明305.3.支付机构上传人行监管报表（CFRA33）305.3.1.交易说明305.3.2.接口说明305.3.2.1.ERP/CC->银行 请求报文扩展字段385.3.2.2.银行->ERP/CC

8、应答报文扩展字段385.3.2.3.BEICS->BSA 请求报文扩展字段395.3.2.4.BSA->BEICS 应答报文扩展字段395.3.3.返回信息说明395.3.4.特殊说明395.4.按请求流水号查询已上传人行监管报表内容（CQLA34）395.4.1.交易说明395.4.2.接口说明395.4.2.1.ERP/CC->银行 请求报文扩展字段405.4.2.2.银行->ERP/CC 应答报文扩展字段405.4.2.3.BEICS->BSA 请求报文扩展字段405.4.2.4.BSA->BEICS 应答报文扩展字段405.4.3.返回信息说明405

9、.4.4.特殊说明415.5.按请求流水号查询人行监管报表处理状态（CQLA35）415.5.1.交易说明415.5.2.接口说明415.5.2.1.ERP/CC->银行 请求报文扩展字段425.5.2.2.银行->ERP/CC 应答报文扩展字段425.5.2.3.BEICS->BSA 请求报文扩展字段435.5.2.4.BSA->BEICS 应答报文扩展字段435.5.3.返回信息说明435.5.4.特殊说明435.6.按请求流水号查询人行监管报表稽核结果（CQLA36）435.6.1.交易说明43支付机构通过本交易查询某批次上传报表的勾稽结果；435.6.2.接口说

10、明435.6.2.1.ERP/CC->银行 请求报文扩展字段445.6.2.2.银行->ERP/CC 应答报文扩展字段445.6.2.3.BEICS->BSA 请求报文扩展字段445.6.2.4.BSA->BEICS 应答报文扩展字段445.6.3.返回信息说明445.6.4.特殊说明455.7.支付机构确认勾稽不符结果（CFRA35）455.7.1.交易说明455.7.1.1.ERP/CC->银行 请求报文扩展字段455.7.1.2.银行->ERP/CC 应答报文扩展字段455.7.1.3.BEICS->BSA 请求报文扩展字段465.7.1.4.B

11、SA->BEICS 应答报文扩展字段465.7.2.返回信息说明465.7.3.特殊说明465.8.维护支付机构收款方白名单（CFRA34）465.8.1.交易说明465.8.2.接口说明465.8.2.1.ERP/CC->银行 请求报文扩展字段475.8.2.2.银行->ERP/CC 应答报文扩展字段475.8.2.3.BEICS->BSA 请求报文扩展字段475.8.2.4.BSA->BEICS 应答报文扩展字段475.8.3.返回信息说明475.8.4.特殊说明485.9.查询支付机构收款方白名单（CQRB05）485.9.1.交易说明485.9.2.接口说

12、明485.9.2.1.ERP/CC->银行 请求报文扩展字段495.9.2.2.银行->ERP/CC 应答报文扩展字段495.9.2.3.BEICS->BSA 请求报文扩展字段495.9.2.4.BSA->BEICS 应答报文扩展字段495.9.3.返回信息说明495.9.4.特殊说明49接口设计说明书- V/5 - 软件开发中心 保密级别：内部1. 引言1.1. 目的1.2. 背景与目标【简要描述前期相关工作的情况】【简要描述相关系统的开发运行情况】【描述此项目的任务提出者、开发者、用户以及运行该系统的部门等】 【分别从技术和用户的角度阐述系统的目标】1.3. 预期读

13、者 【明确该文档针对的读者群】1.4. 术语表1 AIBS：农行综合业务系统的简称（又称新一代业务系统），是负责帐务处理和数据处理的核心业务系统。2 AIPS：农行综合前置系统的简称，是连接各种交易渠道和各种交易后台的枢纽，负责接收来自交易渠道的的交易请求，根据交易要素决定交易处理的路径，最后向交易渠道返回交易处理的结果。3 CM：ABIS中的现金管理子系统缩写，是基于广东省行开发的FB子系统进行开发，主要负责现金管理项目中的各种新需求的实现，是后台核心子系统。4 CMF：现金管理项目中分行中心非ABIS的所有系统简称，包括AIPS上的现金管理应用、文件传输、到帐通知等功能。5 CMC：现金管

14、理项目的总行交换中心，是基于AISC（农行综合交换系统）进行开发，具有对公跨中心交易清算等功能，是跨中心批量处理的核心。6 CME：即本文档描述的对象，是现金管理项目企业客户端和银行客户接入系统的统称，主要负责客户管理、客户联机交易接入、客户批量交易的发起和接收等功能。7 CMES：CME的银行端接入服务器，简称ES。8 CMEC：CME的企业端系统总称。9 CMECC：CMEC的客户端，简称CC。10 CMECS：CMEC的服务端，简称CS。1.5. 参考资料【本项目的经核准的计划任务书或合同，上级机关的批文】【属于本项目的其他已发表文件】【本文件中各处引用的文件、资料，包括所要用到的软件开

15、发标准。列出这些文件的标题、文件编号、发表日期和出版单位，说明能够得到这些文件资料的来源】1.6. 约定1.1.1 关于通讯方式：CMECC与CMECS、CMECS与CMES、CMEM与CMES之间的交易数据包都采用TCP/IP协议的Socket同步短连接方式。CMES与CMF之间通过CICS中间件方式通讯。CMECC与CMECS：Socket方式中报文结构为：包头+数据包，报头为1个字节的是否为加密包标志加上6个字节的字符表示数据包的长度，如果长度不足6位则右边用空格补足，比如：“1234 ”。比如汇兑的长度为1234字节的数据包，其包头为“11234 ”共7位；查询单账户余额的长度为100

16、0字节的数据包，其包头为“01000 ”共7位。其中数据包长度包含加密包标志位。CMECS与CMES：socket方式中报文结构为：包头+数据包，报头为1个字节的是否为加密包标志加上6个字节的字符表示数据包的长度，如果长度不足6位则右边用空格补足，比如：“1234 ”。比如汇兑的长度为1234字节的数据包，其包头为“11234 ”共7位；查询单账户余额的长度为1000字节的数据包，其包头为“01000 ”共7位。其中数据包长度包含加密包标志位。1.1.2 关于XML约定：XML（包括XML数据包和XML文件）都不包含头部的XML声明（即<?xml version="1.0&qu

17、ot;?>）；除非有特别的说明，否则所有XML的根元素的标记名都为<ap>；接口中字段名即对应了元素的标记名(包含了相对于根的路径名)；在XML数据包中所有元素的数据都不采用属性，而一律用字符数据的文本块来表示。1.1.3 关于字段次序:对于XML，同一层的字段次序可以不参照本文档中的字段次序描述；对于多域串（即以|作为每个字段结束符的字符串，以下简称MFS）或格式化字符串，字段次序必须严格与本文档中的字段次序描述保持一致。1.1.4 关于字段类型：字段类型分为以下三类：Cn：字段允许为任何可见字符（包括数字和中文），n在XML中表示有效数据的最大总长度，如果有效数据长度不足

18、n位按实际位数；在格式化字符串中表示固定的长度，如果有效数据长度不足n位，则有效数据左对齐，右边用空格补足至n位；Nn：字段内容只允许为0-9数字，n在XML中表示有效数据的最大总长度，如果有效数据长度不足n位按实际位数；在格式化字符串中表示固定的长度，如果有效数据长度不足n位，则有效数据左对齐，右边用空格补足至n位；Nm.n：基本上与Nm类型类似，但字段内容可以允许为负号、0-9数字和小数点，其中m表示有效数据的最大总长度（对于格式化字符串中表示固定长度），n表示小数位数，通常用来表示发生额、余额等金额类字段，如N15.2表示15位，其中带两位小数位的字段。1.1.5 关于空字段：表示字段在

19、某些条件下允许为空字段，空字段在XML中对应的是空元素，在格式化字符串中则用全空格填充至规定的长度。1.1.6 关于续查标志：对于CMF返回CMES的数据包，由于有每次数据包不超过2K大小的限制，所以当可能有多条数据返回，需要在数据包中设置一个续查标志字段，如果续查标志为“1”时，表示本次数据还没有全部传输完成，CMES需要再次接收，直到续查标志等于“0”为止。1.1.7 关于多域串：多域串用于企业银行内部各子系统之间返回多条记录，简写为MFS，多域串采用固定分隔符，对于本系统而言，分隔符一般采用“|”，除非有特殊说明。本文档中对于多域串的情况并没有明确给出每个字段的排列顺序，而是将每条记录的

20、内容用XML方式表达在<Rcd>段里面。真正在实现时，首先第一条记录是字段名记录，如果采用理想实现方式，则根据该字段名记录可以确定排列顺序，因而不必事先约定顺序。1.1.8 关于定位串：定位串用于返回多条记录的交易中，定位串的组成格式由服务方决定，定位串缩写为FFS。客户端在第一次请求时将定位串置成空，服务端在应答时对每条返回的记录填写定位串。定位串必须给定字段排列顺序，本文档中设计定位串的地方主要都是与CMF通讯的接口里面，下面每个交易都是通过交易表中起始字段和终止字段来表述的，在这两个字段之间顺序排列即可。1.1.9 关于文件：对于CS和ES之间的多笔下交易，如果ES可能返回多

21、条记录时，一律用文件来传输数据。但如果交易本身失败或返回记录数为0时，则不产生文件。文件格式为多行MFS的文本文件。1.1.10 关于操作员密码：企业操作员和银行操作员的密码都为最长8位的字母或数字。在传输过程中单独加密，加密后为16字节的可见字符串。1.1.11 关于认证码、数字签名和加密：企业操作员在签到时，ES会根据某种算法得出一个认证码，以后每次该操作员作交易时都要求送认证码供ES校验。认证码为32字节的可见字符串。数字签名是为了防抵赖和防篡改的要求，具体哪些交易需要签名、哪些签名字段和签名顺序如何是通过ES的交易控制配置文件来确定。CC-CS需要通讯加密。哪些交易需要加密也是通过ES

22、的交易控制配置文件来确定。1.1.12 关于返回结果：一笔交易的结果的返回结果用返回来源+返回码来标示，返回信息为返回码的具体中文含义，扩展信息中包含了详细的信息。由于成功的返回结果有多种可能（如交易成功，预约受理，交易落地等），特约定这种情况下返回来源都为0。1.1.13 关于批量数据下传方式：数据内容CMF => CMESCMES => CMECSCMECS => CMECC集团企业关系多行格式化串文件多行MFS文件多行MFS文件账户授权关系多行格式化串文件多行MFS文件多行MFS文件账户基本信息多行格式化串文件收费明细多行格式化串文件多行MFS文件XML数据包(C303

23、交易)交易控制文件/配置文件配置文件文件格式转换定义文件/配置文件配置文件数据字典多行MFS文件多行MFS文件版本信息配置文件配置文件对账单多行格式化串文件/CMECC界面定制XML文件企业操作员权限XML数据包(C111交易)操作员可操作账户XML数据包(C109交易)1.1.14 关于批量数据上传方式：数据内容CMECC=>CMECSCMECS=>CMESCMES=>AFTS代发工资多行定位串文件多行定位串文件多行定位串文件1.1.15 关于企业银行子系统内部接口间查询类的返回接口：查询类交易分多笔查询和单笔查询，其中单笔查询包括：查询单帐户余额、下级查询上存支取余额等交

24、易；多笔查询包括：查询帐户明细等。单笔查询交易：应答报文不通过RespPrvData来返回，而是直接填写XML域。多笔查询交易：多笔查询交易无论笔数是1还是多条，都需要首先判断是否通过文件返回，如果不是通过文件，则肯定是通过RespPrvData来返回的多笔记录。记录数（行数）通过Cme/RecordNum得到(值为N)，字段数（列数）通过Cme/FieldNum得到(值为M)。其中RespPrvData的构成方式如下：字段1名|字段2名|字段M名|第一条记录字段1值|第一条记录字段2值|第一条记录字段M值|第N条记录字段1值|第N条记录字段2值|第N条记录字段n值|如果是通过文件方式，则文件

25、的记录格式也是采用多域串，但是有所差异，就是将每条记录分开成文件的每条记录，格式如下：字段1名|字段2名|字段M名|第一条记录字段1值|第一条记录字段2值|第一条记录字段M值|第N条记录字段1值|第N条记录字段2值|第N条记录字段n值|1.1.16 关于企业银行与CMF接口间查询类的返回接口：单笔查询交易仍然不通过RespPrvData来返回。多笔查询返回RespPrvData（应答私有区）、Item（条目计数）和ContFlag（续查标志），其中Item表示返回的应答私有区中有多少条记录，而ContFlag表示是否需要继续查询，RespPrvData采用的是定位串（FFS）方式实现的，具体字

26、段位置由参考相关交易接口。1.1.17 通讯区大小约定由于企业银行CS与ERP肯定在局域网内部，因此约定ERP与企业银行系统之间的通讯区大小为100K，请求数据包不可能大于100K，而应答数据包如果超过100K，则通过文件返回。是否通过文件返回，在公共包头中有“是否文件返回的标识”，如果采用文件返回，则公共包头中可以通过“批量文件名”字段获得返回的文件名；如果采用非文件方式返回，则按照1.5.11的约定获取RespPrvData字段。而CS与ES通讯是通过专线或者拨号，因此约定其通讯区大小为10K。而多笔明细返回一般会超过10K，因此ES目前返回多笔明细一般均采用文件返回。1.1.18 Rcd

27、表述为了标识清楚多笔返回的RespPrvData中所包含的内容，我们用<Rcd>来表示循环记录，其中用XML的字段表述了每条记录所包含的字段。但是这并不代表RespPrvData中的记录是采用这个格式返回的，而是按照多域串返回。2. 数据字典定义数据字典是本系统的业务基础，基本涵盖了所有的字段及其属性信息。数据字典的用途可以非常广泛，目前数据字典的功用还有待开发。2.1. 字典键值索引（0）2.2. 返回来源（1）0成功返回1CMECC返回2CMECS返回3CMES返回4CMF返回5 ABIS返回6CM返回7 CMC返回2.3. 农行他行标志（2）0农行1他行2.4. 同城异地标志

28、（3）0异地1同城2.5. 汇兑类型（4）0普通汇兑1上级发起的下级账户之间的划款2上级发起的下级账户的对外支付2.6. 反向归集标志（5）0不做1做2.7. 利息再分配周期（6）1每月月底2每月20日3每季季底4每季20日2.8. 利息再分配标志（7）0不自动分配1自动分配2.9. 法人间资金归集标志（8）0非法人间资金归集1法人间资金归集2.10. 资金归集方向（9）1向上2双向2.11. 资金归集周期（10）1每天2每月3不定期2.12. 资金归集种类（11）1实时归集2批量归集3 资金池管理4 加权平均5虚归资金池6巴斯夫归集方式处理2.13. 特殊业务转账类型（）A（本行）划转支付业

29、务手续费B（本行）划转现金赎回相关资金C（本行）划转风险准备金D（本行）划转除风险准备金外的利息收入E（本行）备付金调拨F（本行）其他a（他行）备付金银行间头寸调拨b （他行）利息收入划拨存管银行c（他行）其他2.14. 银行行号313496000014安阳银行股份有限公司313521006000湖北银行股份有限公司402651020006四川省农村信用社联合社313163000004阳泉市商业银行股份有限公司314641000014海口联合农村商业银行股份有限公司402581090008广东省农村信用社联合社313338009688金华银行股份有限公司313454000016枣庄银行股份有限

30、公司102100099996中国工商银行103100000026中国农业银行股份有限公司104100000004中国银行总行105100000017中国建设银行股份有限公司总行301290000007交通银行302100011000中信银行股份有限公司303100000006中国光大银行304100040000华夏银行股份有限公司总行305100000013中国民生银行总行306581000003广发银行股份有限公司307584007998平安银行308584000013招商银行股份有限公司309391000011兴业银行总行310290000013上海浦东发展银行313100000013北京

31、银行313110000017天津银行股份有限公司313121006888河北银行股份有限公司313127000013邯郸市商业银行股份有限公司313131000016邢台银行股份有限公司313138000019张家口市商业银行股份有限公司313141052422承德银行股份有限公司313143005157沧州银行313161000017晋商银行股份有限公司313168000003晋城银行股份有限公司313191000011内蒙古银行313192000013包商银行股份有限公司313205057830鄂尔多斯银行股份有限公司313222080002大连银行313223007007鞍山市商业银行3

32州银行313227600018葫芦岛银行股份有限公司313228000276营口银行股份有限公司资金清算中心313229000008阜新银行结算中心313241066661吉林银行313261000018哈尔滨银行结算中心313261099913龙江银行股份有限公司313290000017上海银行313301008887南京银行股份有限公司313301099999江苏银行股份有限公司313305066661苏州银行股份有限公司313331000014杭州银行股份有限公司313332082914宁波银行股份有限公司313333007331温州银行股份有限公司3133360

33、71575湖州银行股份有限公司313337009004绍兴银行股份有限公司营业部313338707013浙江稠州商业银行313345001665台州银行股份有限公司313345010019浙江泰隆商业银行313345400010浙江民泰商业银行313391080007福建海峡银行股份有限公司313393080005厦门银行股份有限公司313421087506南昌银行313428076517赣州银行股份有限公司313433076801上饶银行313452060150青岛银行313453001017齐商银行313455000018东营市商业银行313456000108烟台银行股份有限公司31345

34、8000013潍坊银行313461000012济宁银行股份有限公司313463000993泰安市商业银行313463400019莱商银行313465000010威海市商业银行313468000015德州银行股份有限公司313473070018临商银行股份有限公司313473200011日照银行股份有限公司313491000232郑州银行313492070005开封市商业银行313493080539洛阳银行313504000010漯河市商业银行313506082510商丘市商业银行股份有限公司313513080408南阳市商业银行313521000011汉口银行资金清算中心31355108888

35、6长沙银行股份有限公司313581003284广州银行313585000990珠海华润银行股份有限公司清算中心313591001001广东南粤银行股份有限公司313602088017东莞银行股份有限公司313611001018广西北部湾银行313614000012柳州银行股份有限公司清算中心313653000013重庆银行313656000019攀枝花市商业银行313658000014德阳银行股份有限公司313659000016绵阳市商业银行313701098010贵阳市商业银行313731010015富滇银行股份有限公司运营管理部313791030003长安银行股份有限公司313821001

36、016兰州银行股份有限公司313851000018青海银行股份有限公司营业部313871000007宁夏银行总行清算中心313881000002乌鲁木齐市商业银行清算中心313882000012昆仑银行股份有限公司314305206650昆山农村商业银行314305400015吴江农村商业银行清算中心314305506621江苏常熟农村商业银行股份有限公司清算中心314305670002张家港农村商业银行314581000011广州农村商业银行股份有限公司314588000016广东顺德农村商业银行股份有限公司(测试)314653000011重庆农村商业银行股份有限公司315456000105

37、恒丰银行316331000018浙商银行317110010019天津农村合作银行318110000014渤海银行股份有限公司319361000013徽商银行股份有限公司322290000011上海农村商业银行402100000018北京农村商业银行股份有限公司402241000015吉林省农村信用社联合社（不办理转汇业务）402301099998江苏省农村信用社联合社信息结算中心402332010004宁波鄞州农村合作银行402361018886安徽省农村信用联社资金清算中心402391000068福建省农村信用社联合社402451000010山东省农村信用社联合社(不对外办理业务)40252

38、1000032湖北省农村信用社联合社结算中心402584009991深圳农村商业银行402602000018东莞农村商业银行股份有限公司402611099974广西壮族自治区农村信用社联合社402641000014海南省农村信用社联合社资金清算中心402731057238云南省农村信用社联合社402871099996宁夏黄河农村商业银行股份有限公司403100000004中国邮政储蓄银行有限责任公司591110000016外换银行（中国）有限公司593100000020友利银行(中国)有限公司595100000007新韩银行（中国）有限公司596110000013企业银行（中国）有限公司597100000014韩亚银行（中国）有限公司313397075189泉州银行股份有限公司(不对外营业)313148053964衡水市商业银行股份有限公司904290099992城市商业银行资金清算中心402791000010陕西省农村信用社联合社资金清算中