CMP2.0ERP接入开发手册5.0版-联东

更新时间:2023-04-27 16:28:01 阅读量: 实用文档 文档下载

说明:文章内容仅供预览,部分内容可能不全。下载后的文档,内容与下面显示的完全一致。下载之前请确认下面内容是否您想要的,是否完整无缺。

|

企业银行平台ERP接口开发手册

中国农业银行软件开发中心

文档管理信息

编号PP/CME/RD0004V3.0

项目企业银行平台

类别企业银行/项目文档

密级内部

路径企业银行/ERP

文档修订记录

目录

1前言14 1.1编写目的14 1.2背景14 1.3定义与缩略语14 1.4约定15

1.4.1关于通讯方式15

1.4.2关于XML约定15

1.4.3关于字段次序15

1.4.4关于字段类型15

1.4.5关于空字段16

1.4.6关于续查标志16

1.4.7关于多域串16

1.4.8关于定位串16

1.4.9关于文件16

1.4.10关于操作员密码16

1.4.11关于认证码、数字签名和加密16

1.4.12关于返回结果17

1.4.13关于批量数据下传方式17

1.4.14关于批量数据上传方式17

1.4.15关于企业银行子系统内部接口间查询类的返回接口17

1.4.16关于企业银行与CMF接口间查询类的返回接口18

1.4.17通讯区大小约定18

1.4.18Rcd表述18 2系统结构描述19

2.1系统框架结构19 2.2系统软件结构19 2.3ERP接入方式19 3交易机制描述20

3.1系统实现功能20

3.1.1操作员管理20

3.1.2系统维护类功能20

3.1.3资金交易类功能20

3.1.4集团资金管理类功能21

3.1.5查询类功能21 3.2消息机制22 3.3文件处理机制22 3.4系统安全机制22

3.4.1安全机制介绍22 3.5异常处理机制23 4数据字典定义23

I

4.1字典键值索引(0)24 4.2返回来源(1) 29 4.3农行他行标志(2) 30 4.4同城异地标志(3) 30 4.5汇兑类型(4) 30 4.6反向归集标志(5) 30 4.7利息再分配周期(6) 30 4.8利息再分配标志(7) 31 4.9法人间资金归集标志(8) 31 4.10资金归集方向(9) 31 4.11资金归集周期(10) 31 4.12资金归集类型(11) 31 4.13业务类型(12) 31 4.14申请/恢复额度标志(13) 31 4.15生效标志(14) 32 4.16额度转移标志(15) 32 4.17可使用上级额度标志(16) 32 4.18票据状态(17) 32 4.19电子对账单输出标志(18) 32 4.20账页输出标志(19) 32 4.21现转标志(20) 32 4.22发生额标志(21) 33 4.23交易类别(普通归集)(22) 33 4.24授信种类(23) 33 4.25票据种类(24) 33 4.26凭证种类(25) 33 4.27摘要(26) 35 4.28账户操作权限(27) 37 4.29账户类型(28) 37 4.30加急标志(29) 37 4.31到账通知标志(30) 37 4.32联系方式(31) 37 4.33通知消息类型(32) 38 4.34消息发送标志(33) 38 4.35归集帐户(34) 38 4.36流水状态(35) 38 4.37企业状态(36) 38 4.38证件类型(37) 38 4.39利率标志(38) 40 4.40使用状态(39) 41 4.41省市代码(40) 41 4.42货币码(41) 42 4.43交易设置(42) 42 4.44企业操作员类别(43) 47

II

4.45企业操作员状态(44) 48 4.46收妥标志(45) 48 4.47汇票种类(46) 48 4.48本票种类(47) 48 4.49查询类型(48) 48 4.50预约标志(49) 48 4.51落地处理标志(50) 49 4.52修改内容(51) 49 4.53审计类型(52) 49 4.54对账标志(53) 49 4.55可否转汇标志(54) 49 4.56挂失方式(55) 49 4.57领取方式(56) 49 4.58版本控制文件类型(57) 50 4.59收费业务种类(58) 50 4.60操作员联机状态(59) 51 4.61授权账户状态(60) 51 4.62自身归集状态(61) 51 4.63上级归集状态(62) 52 4.64收费基数类型(63) 52 4.65支票种类(64) 52 4.66通知处理状态(65) 52 4.67归集关系修改标志类型(66) 52 4.68资金归集种类(67) 52 4.69负头寸处理方式(68) 53 4.70归还隔夜透支标志(69) 53 4.71可否超额支取标志(70) 53 4.72可否超额上划标志(71) 53 4.73预警类别(72) 53 4.74资金池子帐户支取方式(73) 53 4.75常用利率(74) 54 4.76常用货币码(75) 54 4.77票据种类(76) 55 4.78业务种类(77) 55 4.79票据状态(78) 55 4.80试算种类(79) 55 4.81利息种类(80) 55 4.82贷款状态(81) 55 4.83贷款形态(82) 56 4.84计息方式(83) 56 4.85交易种类(84) 56 4.86抹账标志(85) 56 4.87贴现/转贴现形态(86) 57 4.88利息类型(87) 57

III

4.89钞汇标志(88) 57 4.90凭证状态(89) 57 4.91凭证种类_1(90) 57 4.92交易类别(资金池)(91) 58 4.93批量交易代码(98) 58 4.94旧版本交易类型(明细)(99) 58 4.95复核交易(旧版)(100) 64 4.96校验农行账号(101) 65 4.97贷款种类(102) 65 4.98客户身份标识类型(103) 65 4.99试算标志(104) 65 4.100还款标志(105) 65 4.101超期利率浮动方式(106) 65 4.102复利标志(107) 66 4.103应收利息入账标志(108) 66 4.104定期结息周期标志(109) 66 4.105大额支付金额(110) 66 4.106支取方式(111) 66 4.107自助贷款额度状态(112) 66 4.108自助贷款循环使用标志(113) 66 4.109自助贷款可被占用标志(114) 67 4.110自助贷款合约状态(115) 67 4.111国税资金种类(116) 67 4.112地区编码(117) 67 4.113金融交易提示(118) 67 4.114集团客户标识(119) 68 4.115账户收支种类(120) 68 4.116电子对账输出标识(121) 68 4.117电子对账输出渠道(122) 68 4.118支取标志(123) 68 4.119法人间标志(124) 68 4.120批量归集类型(125) 69 4.121反向归集标志(126) 69 4.122开通二级实归账户冻结回拨(127) 69 4.123资金归集周期(128) 69 4.124资金归集方向(129) 69 4.125用上级资金归还隔夜透支标志(130) 69 4.126资金归集类型(131) 69 4.127内部交易码(132) 70 4.128流程配置码(133) 73 4.129账户种类(134) 76 4.130定期存期(135) 76 4.131通知存期(136) 77 4.132操作员级别(137) 77

IV

4.133联行行别(138) 77 4.134代收代付类型(139) 80 4.135中间业务处理状态(140) 80 4.136定活通类型(141) 80 4.137有无凭证(142) 80 4.138定期/通知存期(143) 80 4.139转存标志(144) 81 4.140转存标志_1(145) 81 4.141转让标志(146) 81 4.142有效期限(147) 82 4.143已建立通知状态(148) 82 4.144账户状态(149) 82 4.145交易处理类型(150) 82 4.146上划下拨标志(151) 82 4.147复核标志(152) 82 4.148转存方式(153) 83 4.149收入是否增加限额标志(154) 83 4.150定活通产品类型(155) 83 4.151到期转回标志(156) 83 4.152预约提现币种(157) 83 4.153正头寸处理方式(158) 83 4.154负头寸处理方式(159) 84 4.155委托贷款利息分配标志(160) 84 4.156委托贷款手续费收取方式(161) 84 4.157支付限额控制标志(账簿)(162) 84 4.158本票有效期限(163) 84 4.159渠道(164) 84 4.160摘要(165) 85 4.161产品类型(166) 86 4.162批量导入设置交易码(167) 86 4.163委托贷款标志(168) 87 4.164实时归集支控方式(169) 87 4.165批归归集方式(170) 87 4.166最高累计归集标志(171) 87 4.167复核控制标志(172) 87 4.168业务类别(173) 87 4.169复核交易(新版)(174) 88 4.170支付限额开关标志(175) 89 4.171账簿输出标志(176) 89 4.172动账通知书输出标志(177) 89 4.173账簿状态(178) 89 4.174计息方式(179) 89 4.175集团复核交易列表(180) 89 4.176支取方式(181) 90

V

4.177是否按已建通知支取(182) 90 4.178是否到期自动转回结算账户(183) 90 4.179法人证件类型(184) 91 4.180凭证类型(新版)(185) 92 4.181动账通知标志(186) 93 4.182透支种类(187) 93 4.183透支取现标志(188) 93 4.184归集更新支付限额标志(189) 93 4.185中间业务处理结果(190) 93 4.186中间业务失败原因(191) 93 4.187客户端对账交易类型(200) 94 4.188对账账户类型(201) 95 4.189对账标符标志(202) 95 4.190客户端对账复核结果(204) 95 4.191价格类型(205) 95 4.192理财产品状态(206) 95 4.193购买方式(207) 96 4.194可赎回标志(208) 96 4.195产品状态(指客户的持有协议书)(209) 96 4.196交易类型(210) 96 4.197产品生命状态(指理财产品)(211) 96 4.198省市代码(500) 97 4.199部门编号(501) 98 4.200产品类别(502) 98 4.201投资客户对象(503) 98 4.202收益分配频率(504) 98 4.203产品风险等级(505) 98 4.204开通标志(506) 99 4.205申购赎回标志(507) 99 4.206发行年份(508) 99 4.207派发方式(509) 99 4.208红蓝标志(510) 100 4.209收益派发状态(511) 100 4.210投资收益公私区分方式(512) 100 4.211试算标志(513) 100 4.212业务类型(514) 100 4.213状态(515) 100 4.214发售渠道(516) 101 4.215适应客户风险等级(517) 101 4.216查询方式(518) 101 4.217赎回方式(519) 101 4.218额度管理(520) 101 4.219赎回查询标志(521) 101 4.220产品控制掩码(522) 101

VI

4.221主管级别(523) 102 4.222柜员类型(524) 102 4.223产品生命状态(525) 102 4.224定价方式(526) 102 4.225收益计算方式(527) 103 4.226申购认购方式(528) 103 4.227收益分配状态(529) 103 4.228价格实施标志(530) 103 4.229派息方式(534) 103 4.230明细类型(535) 103 4.231占款户处理标志(536) 104 4.232贴现回购标志(537) 104 4.233融资票据状态(538) 104 4.234试算类型(539) 104 4.235国家(地区)代码表(541) 104 4.236支取方式(542) 110 4.237账户状态(543) 110 4.238还款标志(对公专用)(544) 110 4.239贷款用途(545) 110 4.240收费业务种类代码(546) 110 4.241收费种类代码(547) 114 4.242合约账户类型(548) 120 4.243合约账户状态(549) 124 4.244已读标志(550) 124 4.245到期处理标志(551) 124 4.246调拨方式(552) 124 4.247对账方式(553) 124 4.248其他非字典字段的属性解释124

4.248.1续查标志(ICS专用)124

4.248.2文件标识125

4.248.3渠道标识125

4.248.4联机状态125

4.248.5他企业标识125

4.248.6签到状态(ICS操作员签到的状态定义)125

4.248.7审计类型125 5字段定义125

5.1根段126 5.2CHANNEL段126 5.3ACC段127 5.4CORP段127 5.5CMP段129 5.6CME段130 5.7MENU段133 5.8FORM段134

VII

5.9UPDFILE段134 6交易接口135

6.1公共包头135

6.1.1ERP2ICT请求报文公共字段136

6.1.2ICT2ERP应答报文公共字段136

6.1.3ICT2ERP应答错误报文137 6.2查询账户余额(CQRA06交易)137

6.2.1ERP2ICT请求报文扩展字段137

6.2.2ICT2ERP应答报文扩展字段138 6.3查询账户明细(CQRA10交易)139

6.3.1ERP2ICT请求报文扩展字段139

6.3.2ICT2ERP应答报文扩展字段139 6.4集团内汇兑-单笔(CFRT01交易)140

6.4.1ERP2ICT请求报文扩展字段140

6.4.2ICT2ERP应答报文扩展字段140 6.5汇兑-单笔对公(CFRT02交易)141

6.5.1ERP2ICT请求报文扩展字段141

6.5.2ICT2ERP应答报文扩展字段142 6.6汇兑-单笔对私(CFRT21交易)143

6.6.1ERP2ICT请求报文扩展字段143

6.6.2ICT2ERP应答报文扩展字段143 6.7签发银行汇票(CFRT17交易)144

6.7.1ERP2ICT请求报文扩展字段144

6.7.2ICT2ERP应答报文扩展字段144 6.8预约提现(CFRT19交易)145

6.8.1ERP2ICT请求报文扩展字段145

6.8.2ICT2ERP应答报文扩展字段146 6.9申购支票(CFRT20交易)146

6.9.1ERP2ICT请求报文扩展字段146

6.9.2ICT2ERP应答报文扩展字段146 6.10自主归集(CFRT00交易)147

6.10.1ERP2ICT请求报文扩展字段147

6.10.2ICT2ERP应答报文扩展字段147 6.11查询资金池关系(CQLT16交易)148

6.11.1ERP2ICT请求报文扩展字段148

6.11.2ICT2ERP应答报文扩展字段148 6.12查询资金池上存金额(CQRA13交易)149

6.12.1ERP2ICT请求报文扩展字段149

6.12.2ICT2ERP应答报文扩展字段149 6.13查询资金池内账户(CQRA29交易)149

6.13.1ERP2ICT请求报文扩展字段149

6.13.2ICT2ERP应答报文扩展字段150 6.14下级查询上存支取明细(CQRA30交易)150

6.14.1ERP2ICT请求报文扩展字段150

VIII

6.14.2ICT2ERP应答报文扩展字段151 6.15查询账簿明细(CQRA14交易)152 6.15.1ERP2ICT请求报文扩展字段152 6.15.2ICT2ERP应答报文扩展字段152 6.16集中代理支付-对公(CFRT07交易)153 6.16.1ERP2ICT请求报文扩展字段153 6.16.2ICT2ERP应答报文扩展字段153 6.17调整账簿余额(CFRA01交易)154 6.1

7.1ERP2ICT请求报文扩展字段154 6.17.2ICT2ERP应答报文扩展字段155 6.18查询异常交易结果(CQRT04交易)155 6.1

8.1ERP2ICT请求报文扩展字段155 6.18.2ICS2ERP应答报文扩展字段155 6.18.3ICS2CMF请求报文扩展字段错误!未定义书签。

6.18.4CMF2ICS应答报文扩展字段错误!未定义书签。

6.19查询结算账户下的所有账簿(CQRA21交易)156 6.19.1ERP2ICT请求报文扩展字段156 6.19.2ICT2ERP应答报文扩展字段157 6.20查询联行行号(CQLT09交易)157 6.20.1ERP2ICT请求报文扩展字段157 6.20.2ICT2ERP应答报文扩展字段157 6.21设置不定期归集日期(CMRA01交易)158 6.21.1ERP2ICT请求报文扩展字段158 6.21.2ICT2ERP应答报文扩展字段158 6.22设置定时归集时间(CMRA02交易)159 6.22.1ERP2ICT请求报文扩展字段159 6.22.2ICT2ERP应答报文扩展字段159 6.23查询资金池账户属性(CQRA12交易)160 6.23.1ERP2ICT请求报文扩展字段160 6.23.2ICT2ERP应答报文扩展字段160 6.24查询虚拟资金池参数(CQRA19交易)161 6.24.1ERP2ICT请求报文扩展字段161 6.24.2ICT2ERP应答报文扩展字段161 6.25查询账簿余额(CQRA20交易)162 6.25.1ERP2ICT请求报文扩展字段162 6.25.2ICT2ERP应答报文扩展字段162 6.26查询账户归集参数(CQRA05交易)162 6.26.1ERP2ICT请求报文扩展字段162 6.26.2ICT2ERP应答报文扩展字段163 6.27查询账户支付限额(CQRA03交易)164 6.2

7.1ERP2ICT请求报文扩展字段164 6.27.2ICT2ERP应答报文扩展字段164 6.28费用报销(CFRT05交易)165 6.2

8.1ERP2ICT请求报文扩展字段165

IX

6.28.2ICT2ERP应答报文扩展字段166 6.29查询代发工资结果-农行账户(CQRT00交易)166 6.29.1ERP2ICT请求报文扩展字段166 6.29.2ICT2ERP应答报文扩展字段167 6.30代发工资-农行账户(CFRT03)168 6.30.1ERP2ICT请求报文扩展字段168 6.30.2ICT2ERP应答报文扩展字段169 6.31查询中间业务明细处理结果(CQLT19)169 6.31.1ERP2ICT请求报文扩展字段169 6.31.2ICT2ERP应答报文扩展字段169 6.32查询代发工资文件明细(CQLO07)170 6.32.1ERP2ICT请求报文扩展字段170 6.32.2ICT2ERP应答报文扩展字段170 6.33查询中间业务提交文件(CQLT15)170 6.33.1ERP2ICT请求报文扩展字段170 6.33.2ICT2ERP应答报文扩展字段171 6.34获取取票密码(CQLT17)171 6.34.1ERP2ICT请求报文扩展字段171 6.34.2ICT2ERP应答报文扩展字段171 6.35活期转定期(CFRT13)172 6.35.1ERP2ICT请求报文扩展字段172 6.35.2ICT2ERP应答报文扩展字段172 6.36查询不定期归集日期(CQRA00)172 6.36.1ERP2ICT请求报文扩展字段172 6.36.2ICT2ERP应答报文扩展字段173 6.37查询定期归集时间(CQRA01)173 6.3

7.1ERP2ICT请求报文扩展字段173 6.37.2ICT2ERP应答报文扩展字段174 6.38查询账薄支付限额(CQRA34)174 6.3

8.1ERP2ICT请求报文扩展字段174 6.38.2ICT2ERP应答报文扩展字段174 6.39维护账薄支付限额(CFRA02)175 6.3

9.1ERP2ICT请求报文扩展字段175 6.39.2ICT2ERP应答报文扩展字段175 6.40查询虚拟资金池账户余额组合(CQRAC3)176 6.40.1ERP2ICT请求报文扩展字段176 6.40.2ICT2ERP应答报文扩展字段176 6.41查询资金池余额组合(CQRAC1)177 6.41.1ERP2ICT请求报文扩展字段177 6.41.2ICT2ERP应答报文扩展字段177 6.42查询资金池账户信息(CQRAC2)178 6.42.1ERP2ICT请求报文扩展字段178 6.42.2ICT2ERP应答报文扩展字段178 6.43查询授信额度使用情况(CQRA32)179

X

6.43.1ERP2ICT请求报文扩展字段179 6.43.2ICT2ERP应答报文扩展字段179 6.44查询授信额度使用明细(CQRA33)180 6.44.1ERP2ICT请求报文扩展字段180 6.44.2ICT2ERP应答报文扩展字段180 6.45查询账户开通透支信息(CFRT35)181 6.45.1ERP2ICT请求报文扩展字段181 6.45.2ICT2ERP应答报文扩展字段181 6.46查询透支余额(CQRA39)182 6.46.1ERP2ICT请求报文扩展字段182 6.46.2ICT2ERP应答报文扩展字段182 6.47查询通知存款账户余额(CQRA07)183 6.4

7.1ERP2ICT请求报文扩展字段183 6.47.2ICT2ERP应答报文扩展字段184 6.48查询定期存款账户余额(CQRA08)184 6.4

8.1ERP2ICT请求报文扩展字段184 6.48.2ICT2ERP应答报文扩展字段185 6.49利息试算(CQRA17)185 6.4

9.1ERP2ICT请求报文扩展字段185 6.49.2ICT2ERP应答报文扩展字段186 6.50CMP账户合约查询(CQRA59)186 6.50.1ERP2ICT请求报文扩展字段186 6.50.2ICT2ERP应答报文扩展字段186 6.51查询落地处理情况(CQRA61)187 6.51.1ERP2ICT请求报文扩展字段187 6.51.2ICT2ERP应答报文扩展字段187 6.52查询通知消息(CQLC01)188 6.52.1ERP2ICT请求报文扩展字段188 6.52.2ICT2ERP应答报文扩展字段188 6.53查询异常交易(CQLT06)189 6.53.1ERP2ICT请求报文扩展字段189 6.53.2ICT2ERP应答报文扩展字段189 6.54查询账户开通透支信息(CQRA36)190 6.54.1ERP2ICT请求报文扩展字段190 6.54.2ICT2ERP应答报文扩展字段190 6.55建立通知(CFRT09)191 6.55.1ERP2ICT请求报文扩展字段191 6.55.2ICT2ERP应答报文扩展字段191 6.56根据结算账户查询定活通子账户/查询定活通余额(CQRA15)191 6.56.1ERP2ICT请求报文扩展字段191 6.56.2ICT2ERP应答报文扩展字段192 6.57活期转通知(CFRT08)193 6.57.1ERP2ICT请求报文扩展字段193 6.57.2ICT2ERP应答报文扩展字段193

XI

6.58取消通知(CFRT10)194 6.58.1ERP2ICT请求报文扩展字段194 6.58.2ICT2ERP应答报文扩展字段194 6.59通知转活期(CFRT11)195 6.59.1ERP2ICT请求报文扩展字段195 6.59.2ICT2ERP应答报文扩展字段195 6.60定期转活期(CFRT14)196 6.60.1ERP2ICT请求报文扩展字段196 6.60.2ICT2ERP应答报文扩展字段197 6.61通知子账户部提(CFRT15)197 6.61.1ERP2ICT请求报文扩展字段197 6.61.2ICT2ERP应答报文扩展字段198 6.62查询结算账户下通知存款余额(CQRA25)199 6.62.1ERP2ICT请求报文扩展字段199 6.62.2ICT2ERP应答报文扩展字段199 6.63查询结算账户下定期存款余额(CQRA26)200 6.63.1ERP2ICT请求报文扩展字段200 6.63.2ICT2ERP应答报文扩展字段200 6.64查询已建立的通知(CQRA28)201 6.64.1ERP2ICT请求报文扩展字段201 6.64.2ICT2ERP应答报文扩展字段202 6.65定期子账户部提(CFRT38)202 6.65.1ERP2ICT请求报文扩展字段202 6.65.2ICT2ERP应答报文扩展字段203 6.66校验卡号、户名一致性(CQRA22交易)204 6.66.1ERP2ICT请求报文扩展字段204 6.66.2ICT2ERP应答报文扩展字段204 6.67签发银行本票(CFRT18交易)205 6.6

7.1ERP2ICT请求报文扩展字段205 6.67.2ICT2ERP应答报文扩展字段205 6.68查询收费明细(CQRA11交易)206 6.6

8.1ERP2ICT请求报文扩展字段206 6.68.2ICT2ERP应答报文扩展字段206 6.69查询资金池余额(CQRA24交易)207 6.6

9.1ERP2ICT请求报文扩展字段207 6.69.2ICT2ERP应答报文扩展字段207 6.70设置账户归集参数(CMRA04交易)208 6.70.1ERP2ICT请求报文扩展字段208 6.70.2ICT2ERP应答报文扩展字段208 6.71修改资金池存款、借款利率(CMRA05交易)208 6.71.1ERP2ICT请求报文扩展字段208 6.71.2ICT2ERP应答报文扩展字段209 6.72设置账户支付限额(CMRA00交易)209 6.72.1ERP2ICT请求报文扩展字段209

XII

6.72.2ICT2ERP应答报文扩展字段210 6.73查询资金归集关系(CQLA00交易)210 6.73.1ERP2ICT请求报文扩展字段210 6.73.2ICT2ERP应答报文扩展字段210 6.74查询交易处理流程(CQLT14交易)错误!未定义书签。

6.74.1ERP2ICT请求报文扩展字段错误!未定义书签。

6.74.2ICT2ERP应答报文扩展字段错误!未定义书签。

XIII

企业银行平台接口设计 企业银行平台

14 PP/CME/RD0004V1.0 1 前言

1.1 编写目的

本文档用于描述了农行企业银行的业务处理机制,定义了面向外部系统的接口,供企业财务系统ERP 开发接口程序参考。

1.2 背景

企业银行平台是应现金管理项目而诞生的,目前主要实现了现金管理项目的需求,但是它的应用前景又不仅仅局限于现金管理产品,而应该将对公金融产品都可以在该平台上发布。为了便于二次开发的便捷性和规范行,有必要对企业银行平台进行优化,使之真正达到平台化的目标。

由于广大用户对公网接入的迫切需求,目前开发完成基于公网接入的现金管理系统客户端。因此,整理出本篇适用于公网接入方式下的ERP 与现金管理系统对接所适用的接口规范。

1.3 定义与缩略语

1

AIBS :农行综合业务系统的简称(又称新一代业务系统),是负责账务处理和数据处理的核心业务系统。 2 AIPS :农行综合前置系统的简称,是连接各种交易渠道和各种交易后台的枢纽,

负责接收来自交易渠道的的交易请求,根据交易要素决定交易处理的路径,最后向交易渠道返回交易处理的结果。

3 CM : ABIS 中的现金管理子系统缩写,是基于广东省行开发的FB 子系统进行开发,主要负责现金管理项目中的各种新需求的实现,是后台核心子系统。

4 CMF :现金管理项目中分行中心非ABIS 的所有系统简称,包括AIPS 上的现金管理应用、文件传输、到账通知等功能。

5 CMC :现金管理项目的总行交换中心,是基于AISC (农行综合交换系统)进行开发,具有对公跨中心交易清算等功能,是跨中心批量处理的核心。

6 CME :即本文档描述的对象,是现金管理项目企业客户端和银行客户接入系统的统称,主要负责客户管理、客户联机交易接入、客户批量交易的发起和接收等功能。

7 CMEICS :CME 的银行端接入服务器,简称ICS 。

8

CMEICC :CME 的企业端系统总称,简称ICC 。

企业银行平台接口设计 企业银行平台

15 PP/CME/RD0004V1.0 1.4 约定

1.4.1关于通讯方式

CMEICC 与CMEICS 、CMEM 与CMEICS 之间的交易数据包都采用TCP/IP 协议的Socket 同步短连接方式。

CMEICS 与CMF 之间通过CICS 中间件方式通讯。

CMEICC 与CMEICS :Socket 方式报文结构为:包头+数据包,报头为1个字节的是否为加密包标志,加上6个字节的字符表示数据包的长度,如果长度不足6位则右边用空格补足,比如:“1234 ”。比如汇兑的长度为1234字节的数据包,其包头为“11234 ”共7位;查询单账户余额的长度为1000字节的数据包,其包头为“01000 ”共7位。其中数据包长度包含加密包标志位。

1.4.2关于XML 约定

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

企业银行平台接口设计 企业银行平台

16 PP/CME/RD0004V1.0 1.4.5关于空字段

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

1.4.6关于续查标志

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

1.4.7关于多域串

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

1.4.8关于定位串

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

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

1.4.9关于文件

对于ICC 和ICS 之间的多记录返回交易,如果ICS 可能返回多条记录时,一律用文件来传输数据。但如果交易本身失败或返回记录数为0时,则不产生文件(对于部分交易来说,可能是返回0字节文件,由客户端自行处理)。文件为多行MFS 的文本文件。

1.4.10 关于操作员密码

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

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

企业操作员在签到时,ICS 会根据某种算法得出一个认证码,以后每次该操作员作交易

企业银行平台接口设计 企业银行平台

17 PP/CME/RD0004V1.0 时都要求送认证码供ICS 校验。认证码为32字节的可见字符串。

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

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

1.4.12 关于返回结果

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

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

1.4.13 关于批量数据下传方式

1.4.14 关于批量数据上传方式

1.4.15 关于企业银行子系统内部接口间查询类的返回接口

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

单笔查询交易:应答报文不通过RespPrvData 来返回,而是直接填写XML 域。

多笔查询交易:多笔查询交易无论笔数是1还是多条,都需要首先判断是否通过文件返回,如果不是通过文件,则肯定是通过RespPrvData 来返回的多笔记录。记录数(行数)通过Cme/RecordNum 得到(值为N),字段数(列数)通过Cme/FieldNum 得到(值为M)。其中RespPrvData 的构成方式如下:

第一条记录字段1值|第一条记录字段2值|……|第一条记录字段M 值|……|第N 条记录字段1值|第N 条记录字段2值|……|第N 条记录字段n 值|

如果是通过文件方式,则文件的记录格式也是采用多域串,但是有所差异,就是将每条记录分开成文件的每条记录,格式如下:

第一条记录字段1值|第一条记录字段2值|……|第一条记录字段M 值|

第二条记录字段1值|第二条记录字段2值|……|第二条记录字段M 值|

企业银行平台接口设计 企业银行平台

18 PP/CME/RD0004V1.0 ……

第N 条记录字段1值|第N 条记录字段2值|……|第N 条记录字段n 值|

1.4.16 关于企业银行与CMF 接口间查询类的返回接口

单笔查询交易仍然不通过RespPrvData 来返回。

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

1.4.17 通讯区大小约定

由于企业银行转发平台ICT 与ERP 肯定在局域网内部,因此约定ERP 与企业银行系统之间的通讯区大小为100K ,请求数据包不可能大于100K ,而应答数据包如果超过100K ,则通过文件返回。是否通过文件返回,在公共包头中有“是否文件返回的标识”,如果采用文件返回,则公共包头中可以通过“批量文件名”字段获得返回的文件名;如果采用非文件方式返回,则按照1.5.11的约定获取RespPrvData 字段。

而ICC 、ICT 与ICS 的通讯是通过广域网传输,因此约定其通讯区大小为10K 。而多笔明细返回一般会超过10K ,因此ICS 目前返回多笔明细一般均采用文件方式返回。

1.4.18 Rcd 表述

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

企业银行平台接口设计 企业银行平台

19 PP/CME/RD0004V1.0 2 系统结构描述

2.1 系统框架结构

2.2 系统软件结构

农行企业银行平台是农业银行现金管理项目企业客户端和银行端企业接入系统的统称,主要负责客户管理、客户联机交易接入、客户批量交易的发起和接收等功能,简称CME 。CME 包括三部分,一是企业客户端(CMEC ),二是银行对企业的接入端(CMES ),三是银行对企业的监控和管理(CMEM )。

CMEC 是农行企业银行平台直接展示给企业客户部分,这部分包含直接面对客户ICC 以及负责通讯的Hsclient 底层库。

CMES 是CMEC 在银行的接入系统,是客户端能完成的主要功能的处理部分,此部分设计上采用平台化结构,具有很好的可拓展性。CMEM 是为满足银行内部各级管理部门对企业监控和管理的需求而设计的,主要有系统维护及日终处理的功能实际上也是CMES 的一个客户端系统。

CMF 是现金管理项目中分行中心非ABIS 的所有系统简称,包括AIPS 上的现金管理应用、文件传输、到帐通知等功能;CME 直接和CMF 进行数据交换。

2.3 ERP 接入方式

由上图可以看出,农行提供企业通讯器ICT ,该通讯器是一个SOCKET 服务进程,ERP 只需将交易包发送给ICT 并接收ICT 应答即可,如果应答数据太大通过文件返回,则ERP

本文来源:https://www.bwwdw.com/article/rapq.html

Top