版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
1、精选优质文档-倾情为你奉上精选优质文档-倾情为你奉上专心-专注-专业专心-专注-专业精选优质文档-倾情为你奉上专心-专注-专业BOCNET银企对接标准版前置机接口规范文档编号:BOCNET_V03.00_B2EC当前版本:V1.1制作人:孙永、樊莉审核人:卢波制作单位:BOCNET项目组日期:2009年6月修订历史记录日期文档版本号说明作者2009-6-6V1.0新建。根据BOCNET3.0一期标准版前置机功能制定。BOCNET2.0提供的接口内容在BOCNET3.0中不变。樊莉2009-6-8V1.0增加全球企业服务接口定义马骊2009-10-29V1.1修改b2e0035接口,将返回数据项
2、的摘要拆分成附言和用途两个字段樊莉2009-11-6增加b2e0015代收委托,b2e0043CNAPS、中行联行号下载,b2e0044历史交易整合查询接口马骊2009-11-6修改b2e0032交易说明及接口,支持代收代发查询马骊2009-12-1修改b2e0035交易说明及接口,增加费用信息及新核心转账交易网银流水号的解析规则马骊2009-12-8B2e0015增加扣款合同号字段马骊2010-2-2增加B2e0045期货出金待授权交易查询、B2e0046期货出金授权高勇2010-2-2B2E0042响应结果增加字段长度说明马骊2010-3-4增加现金管理相关交易(b2e0050-b2e00
3、54),详见接口规则马骊2010-3-4增加针对历史交易查询相关接口的说明。新客户推广时,历史交易查询功能建议使用“历史交易整合查询(b2e0044)”接口马骊2010-3-10修改历史汇款信息查询(b2e0023)接口中,字段的说明。马骊2010-4-6历史交易查询(b2e0011)返回结果增加对方账户户名马骊2010-4-16新增跨境主动调拨(b2e0048)交易接口。修改跨境网银交易查询(b2e0042)查询条件。马骊2010-4-30新增b2e0047当日交易明细查询高勇2010-5-30新增b2e0060(企业征信留痕背书)支付背书和放款备案通知交易高勇2010-7-1更新附件一中的
4、返回码定义,内容出自版本3合1的开发流马骊2010-7-12补充b2e0035返回项中费用账户的说明马骊2010-9-10增加b2e0061公对私转账汇款高勇2010-9-10增加b2e0062境内外币汇划高勇2010-9-13修改b2e0052请求笔数,只允许单账户设置高勇2010-10-19错误码补充境内外币交易相关部分马骊2010-10-21增加b2e0055现金内部计价利率设置钱峰2010-10-21增加b2e0056现金内部计价利率查询钱峰2010-12-29闽浙涌改造,b2e0047交易返回项增加翻页用的顺序号;调整b2e0035附言字段的说明;马骊2010-12-31根据MCIS
5、接口中针对b2e0044返回的业务类型更新取值说明马骊目 录 TOC o 1-4 h z 1前言随着集团企业信息化水平的提高和经营理念的转变,大量集团企业客户纷纷提出资金集中管理、提高资金使用效率、降低经营成本、简单高效的银行服务的财务管理需求。企业集团迫切需要将运行在企业内部的计算机信息系统与商业银行的业务系统进行数据交换,双方系统进行无缝对接。为了与企业的ERP系统、财务系统、销售系统等顺利的对接,我们拟定了本接口规范,提供中国银行各分行、相关企业、ERP系统提供商、财务系统提供商等。以实现企业与银行业务系统进行数据交换。2.请求/响应模式BOCNET银企对接标准版前置机(以下简称前置机)
6、,在请求/响应模式的客户机/服务器体系下向企业客户提供服务。采用HTTP 1.0/1.1或socket/TCPIP作为企业系统与银行系统之间的通信协议,传输文件格式符合XML 1.0规范。我们把这套数据交换规格,命名为BOC Bank TO Enterpris,以下简称为BOCB2E。3.交换数据的结构企业通过HTTP POST向银行的前置机发送请求命令,前置机接收企业的请求并转发至BOCNET对接平台(以下简称对接平台),对接平台处理后将响应结果发给前置机,前置机再把响应结果转发给企业。请求与响应的报文结构包括:HTTP headersMIME type(Content type) appl
7、ication/xmlXML declarationBOCB2E declarationBOCB2E XML block以上1-2遵照HTTP协议规范(),3-5部分为请求或响应文件内容,依照HTTP协议这两部分内容之间通过一个空行(CR LF)分隔。BOCB2E的内容类型为application/xml,防止代理服务器(proxy)对xml文件转码(transcoding)。3.1请求/响应示例请求:响应:3.2 BOCB2E文件格式BOCB2E文件格式包括xml声明,必须在最开始,xml声明如下所示:(建议encoding使用UTF-8)接下来是BOCB2E协议的XML顶层块三个属性可以不
8、填。其中:version为BOCB2E协议的版本号,BOCNET为3.0版,表示为“120”,但是兼容以往的版本。所有交易的货币码将采用国际标准,如果想使用数字型的货币码,version值用“100”。security为采用的安全模式,需要在BOCB2E协议层上实现数字签名和用户证书信息,数据的加密解密依赖安全代理(HTTPS代理)来实现,保证客户端与服务器之间的通信安全。因此目前应选择“true”。locale表示客户端所处的区域,语言类型,主要用于服务器响应信息的语言类型,对于客户提交的信息,服务器不进行语言的转换。HTTP相应代码对应的信息按照HTTP 1.1或HTTP1.0的定义,lo
9、cale的内容遵循国际标准写法,例如“zh_CN”、“en_US”。3.3 XML块结构BOCB2E XML块采用层次化结构XML数据块作为请求与响应的数据文件内容,层次结构如下:XML块顶层 XML消息集与版本 消息头 消息体交易包装 , BOCB2E的标记以及列举数据值全部采用小写英文字符。其中交易可以由0到多笔组成。3.4顶层(Top Level)BOCB2E的请求和响应内容包括以下的顶层内容:标记(Tag)说明开始BOCB2E XML块数据头数据头结束交易数据块bocb2e交易内容交易的请求/响应消息trans XML结束BOCB2E XML结束一个HTTP请求或响应只能并且必须包括一
10、个BOCB2E XML块。即只能有一个顶层。3.5消息(Message)BOCB2E消息包含消息头(head)和消息体(trans)。消息头包含前端信息、企业ID、企业操作员等信息标记(Tag)说明格式检查开始BOCB2E XML块数据头代表一台企业前置机E开头+前置机IP地址(各段补零,无小数点12位)检查终端号是否维护客户端产生的报文编号字母数字串 0-12位企业在中行网银系统的客户编码数码1-10位企业操作员代码字母数字标点串 1-20位检查操作员是否存在交易代码b2e开头加4位数字检查交易是否存在,与报文体是否一致交易验证标识,签到时生成、签退时注销Base64字符串0-64位检查令牌
11、是否正确数据头结束交易数据块trans XML结束BOCB2E XML结束.消息体是BOCB2E的工作单元,消息包括请求与响应,以及与响应消息对应的状态码。消息由交易包装,交易的命名规则为trn-xxx-rq或trn-xxx-rs,trn-xxx-rq包括划账交易的数字签名以及相应的请求消息(xxx-rq),trn-xxx-rs包括status以及相应的响应消息(xxx.rs)。status包括rspcod、rspmsg,其中rspcod为交易返回码, B001表示处理成功, rspmsg表示解释信息,如下例:(完整交易返回码见附二)rspcodRspmsg(中文)B001OKB999交易失败
12、B998数据格式有误例如,若定义一个名为action的交易消息,则action的请求数据格式为:标记说明action交易请求的开始消息的开始(0.n)请求内容消息的结束交易的结束响应数据格式为:标记说明action交易响应的开始报文响应状态标记开始报文响应状态标记结束消息的开始(0.n)交易响应状态标记开始交易响应状态标记结束响应内容消息的结束交易的结束3.6交易的超时及防重处理对于银行数据交换,交易的超时及防重控制主要是在企业端发出支付/转账指令请求时使用。考虑下面的情况:企业端发出转账请求,服务器端也成功处理,并发出了表示转账成功的响应消息,由于通信故障等原因,企业端未能正确收到响应。如果
13、是仅仅是查询,由于可以执行多次,企业端在故障排除后重新发出请求获得结果即可,但对于不可重复执行的转账/支付请求,可以发起交易状态查询交易,以转账指令ID来银行查询该笔交易的付款状态,也可以发起到账查询交易,以转账指令ID来银行查询该笔交易的到账情况。防止企业在不明情况下,对同一笔交易重复发起扣账,客户端在生成指令的时候要生成一个唯一的指令ID,银行服务器端保留此ID及执行结果,当客户端再次以同一指令ID发出转账请求时,服务器端收到请求后首先做ID判断,如果ID曾收到过,则根据银行后台返回的结果,返回此ID指令的结果或再次提交后台主机(如:付款账号余额不足时),如未收到过,则执行并返回结果。3.
14、7字符集检查请求报文格式中允许的字符在具体交易定义中有具体说明,但格式标明为字符串的在此详述如下:标记说明字符集密码允许英文字母、数字、空格、标点符号、汉字(及其它多字节文字符号) 禁止控制字符(如回车、换行、制表符等)新密码允许英文字母、数字、标点符号禁止控制字符(如回车、换行、制表符等)、空格、汉字(及其它多字节文字符号)转账指令ID允许英文字母、数字、*、/、_、禁止空格、!、”、#、$、%、&、(、)、+、,、-、.、:、;、?、|、控制字符、汉字(及其它多字节文字符号)账号(非中行)允许字母、数字、*、/、_、-禁止空格、!、”、#、$、%、&、(、)、+、,、.、:、;、?、|、控
15、制字符、汉字(及其它多字节文字符号)收款人名称允许空格、字母、数字、汉字(及其它多字节文字符号)、单引号、小括号(、)禁止!、”、#、$、%、&、*、+、,、-、.、/、:、;、?、_、|、控制字符(web系统允许空格,.-/()禁止全角,。空格)收款人地址允许空格、字母、数字、汉字(及其它多字节文字符号)、单引号、小括号(、)禁止!、”、#、$、%、&、*、+、,、-、.、/、:、;、?、_、|、控制字符(web系统允许空格,.-/())收款人开户行名称允许空格、字母、数字、汉字(及其它多字节文字符号)、单引号、小括号(、)禁止!、”、#、$、%、&、*、+、,、-、.、/、:、;、?、_、
16、|、控制字符(web系统允许空格,.)付款人名称允许空格、字母、数字、汉字(及其它多字节文字符号)、单引号、小括号(、)禁止!、”、#、$、%、&、*、+、,、-、.、/、:、;、?、_、|、控制字符(web系统允许空格,.-/()禁止全角,。空格)收款人代码允许字母、数字、汉字(及其它多字节文字符号)、单引号、小括号(、)禁止空格、!、”、#、$、%、&、*、+、,、-、.、/、:、;、?、_、|、控制字符(web系统只允许数字)用途允许字母、数字、汉字(及其它多字节文字符号)、空格、单引号、双引号”、减号-、小数点.、斜线/、小括号(、)禁止!、#、$、%、&、*、+、,、:、;、?、_、
17、|、控制字符禁止 大小写的英文O o I i 和半角字符: % 注:1、汉字作为1个字符处理。 2、furinfo用途一项在向核心系统传送时最多为17个字节,多出的部分会被BOCNET产品层截断。4.交易定义 4.1签到交易(b2e0001)签到交易用于控制对服务访问的控制,以及客户服务器之间进行通信的会话管理。每个BOCB2E请求必须并仅能包含一个b2e0001-rq,每个BOCB2E响应必须并仅能包含一个b2e0001-rs。前置机收到企业的签到报文后会自动添加用户签名信息(、 Base64格式)再发送给对接平台。请求标记说明前置机检查点对接平台检查点登录请求消息 用户签名信息,该标签由前
18、置机自动添加,企业无须上送检查用户证书签名客户端日期时间,YYYYMMDDHH24MISS日期格式YYMMDDhhmmss日期格式YYMMDDhhmmss登录密码字符串1-20位检查登录密码,当日输错5次锁定;累计输错15次锁定。响应标记说明登录响应消息包括rspcod、rspmsg等服务端日期时间,YYYYMMDDHH24MISS交易验证标识,签到时返回4.2签退交易(b2e0002)请求标记说明前置机检查点对接平台检查点登录请求消息客户端日期时间日期格式YYMMDDhhmmss客户已签到响应标记说明登录响应消息包括rspcod、rspmsg等服务端日期时间,YYYYMMDDHH24MISS
19、4.3 主动收款交易(b2e0003)做此转账交易的前提是,付款账号和收款账号所属单位与银行有三方协议,并把转账关系维护到银行系统中,企业端程序向银行系统发起此类划账时银行程序校验转账关系。转账交易名称为b2e0003。相应的标记名称如下:请求标记说明前置机检查点对接平台检查点 转账交易请求数字签名,该标签由前置机自动添加,企业无须上送汇划类型*,该标签仅神龙使用,其他企业不上送此标签00转账请求内容,1-1000条记录不超过1000笔指令ID,一条转账指令在客户端的唯一标识,建议企业按时间顺序生成且不超过12位非空字符串 长度1-321、非空字符串 长度1-32; 2、防重检查:操作员所属客
20、户号下不能重复付款人账户联行号非空数码5位1、非空数码5位 2、联行号有对应的省行联行号付款账号非空数码1-35位1、非空数码12-18位2、账户已在网银维护,判断操作员是否有权限付款人名称字符串0-70位收款人账户信息收款行联行号非空数码5位1、非空数码5位 2、联行号有对应的省行联行号收款账号非空数码1-35位1、非空数码12-18位2、检查操作员有无转账权限, 判断账户是否存在收款人名称非空字符串 1-70位收款人地址字符串 0-70位收款人开户行名称字符串0-70位转账金额非空正数 22.2位,最多两位小数1、非空正数 15.2位,最多两位小数2、根据交易币种的辅币位数检查金额的格式;
21、不超过转账限额转账货币非空3位大写字母、数字只支持001和CNY报文发送优先级 非空字母数字1-2位非空枚举,0-普通;1-加急用途字符串 0-80位要求的转账日期 格式YYYYMMDD系统当前日期(含当日)之后的一个月内手续费账号数码0或者1-35位 1、如果不为空则数码12-18位 2、账户已在网银维护;操作员有权限;如果为空则使用付款账户代替3、与付款账号同省* trftype只有神龙前置机使用,其它版本前置机无此项响应标记说明对应请求的响应报文处理状态每条转账指令响应内容(0.1000),每条划账指令处理状态指令ID,请求时给出的ID每条划账指令的网银划账流水号4.4当日交易查询(b2
22、e0004)当日交易查询用于企业端程序向银行系统发起按照约定的条件查询指定账户的当日交易明细,考虑到交易明细数据量较大,不支持多账号的查询,交易代码b2e0004,相应的标记名称如下: 请求标记说明前置机检查点对接平台检查点 只支持单账号查询不超过1笔联行号非空数码5位1、非空数码5位 2、联行号有对应的省行联行号账号非空数码长度1-351、非空数码12-18位2、操作员有权限报文编号,多包返回时用(暂不用)在BOCNET前置机无此标签可空,如果不为空最长10位字符串查询的记录类型非空字母数字字符串1-2位非空枚举,0-全部;D-借方(支出记录);C-贷方(收入记录)响应标记说明报文处理状态查
23、询响应内容(0.n)交易处理状态账户 联行号账号名称(可选)借贷标记:D-借 C-贷入账日期 YYYYMMDD起息日期 YYYYMMDD凭证号或传票号金额摘要 用途冲账标识* 我方业务引用号入账时间 HH24MISS 货币码有效余额(BANCS新增、可空)对方账号(BANCS新增、可空)对方账号名称(BANCS新增、可空)交易名称(BANCS新增、可空)交易类型(BANCS新增、可空)用途代码(BANCS新增、可空)交易机构号(BANCS新增、可空)(Bocnet里是用开户机构代替实际的交易号)4.5当日余额查询(b2e0005)当日余额查询用于企业端程序向银行系统发起查询给定账户的当前余额。
24、交易代码为b2e0005,相应的标记名称如下:请求标记说明前置机检查点对接平台检查点查询请求内容(1.100)不超过100笔账号 联行号非空数码5位1、非空数码5位 2、联行号有对应的省行联行号账号非空数码1-35位1、非空数码12-18位 2、操作员有权限 响应标记说明报文处理状态查询响应内容(0.n)交易处理状态账户联行号账号货币码当前余额账面余额有效余额圈存金额(BANCS新增、可空)透支限额日期(YYYYMMDD)4.6 到账查询(b2e0006)到账查询用于企业端程序向银行系统发起查询指定交易的到账情况。交易代码为b2e0006,相应的标记名称如下: 请求标记说明前置机检查点对接平台
25、检查点查询请求内容(1.100)不超过100笔转账指令ID字符串 长度0-32优先按照网银交易流水号查询,当网银交易流水号不存在时按照转账指令ID查询,两者都不存在提示出错信息网银交易流水号数码 0-30位最长10位,且不超过响应标记说明报文处理状态查询响应内容(0.100)交易处理状态转账指令ID网银交易流水号到账时间 YYYYMMDDHH24MISS4.7 交易状态查询(b2e0007)交易状态查询用于企业端程序向银行系统发起查询指定交易的执行情况,主要是付款行的交易执行情况。交易代码为b2e0007,相应的标记名称如下: 请求标记说明前置机检查点对接平台检查点查询请求内容(1.100)不
26、超过100笔转账指令ID字符串 长度0-32优先按照网银交易流水号查询,当网银交易流水号不存在时按照转账指令ID查询,二者都空提示出错信息。只查询对接渠道的交易。网银交易流水号数码 0-30位最长10位,且不超过响应标记说明报文处理状态查询响应内容(0.100)交易处理状态转账指令ID网银交易流水号4.8 测试通讯线路的交易(b2e0008)用于企业端程序向银行对接平台发起查询指网络联通情况。交易代码为b2e0008,相应的标记名称如下: 请求标记说明前置机检查点对接平台检查点查询请求内容客户端日期时间,YYYYMMDDHH24MISS日期格式YYMMDDhhmmss响应标记说明查询响应内容交
27、易处理状态服务端日期时间,YYYYMMDDHH24MISS4.9转账汇款(b2e0009)付款账号所属单位与银行有协议,并把付款账号维护到银行系统中,企业端程序向银行系统发起此类划账时银行只检查付款账号,不校验收款账号。转账交易名称为b2e0009。相应的标记名称如下: 请求标记说明前置机检查点对接平台检查点 转账交易请求 数字签名,该标签由前置机自动添加,企业无须上送转账请求内容(1.1000)不超过1000笔指令ID,一条转账指令在客户端的唯一标识,建议企业按时间顺序生成且不超过12位非空字符串 长度1-321、非空字符串 长度1-32; 2、防重检查:操作员所属客户号下不能重复付款人账户
28、联行号非空数码5位1、非空数码5位 2、联行号有对应的省行联行号付款账号非空数码1-35位1、非空数码12-18位 2、账户已在网银维护,操作员有权限付款人名称 字符串 长度0-70收款人账户信息收款行联行号数码 长度0-121、可空 2、5位或12位数字,5位且能查到省行联行号认为是中行联行号,12位是CNAPS号.。3、如果是中行的账户,且能查到cnaps对应的省行联行号则在交易表里同时记录省行联行号和cnaps号。收款账号非空字符串 长度1-35收款人名称非空字符串 长度1-70收款人地址字符串 长度0-70收款人开户行名称字符串 长度0-70该项可以为空,系统根据联行号或12位cnap
29、s号取得收款行名去补全 。当收款行联行号为空时,此项为必填。转账金额非空正数字 长度(22,2)1、非空正数 15.2位,最多两位小数 2、根据交易币种的辅币位数检查金额的格式;不超过转账限额转账货币非空3位大写字母、数字只支持001或者CNY报文发送优先级(0-普通;1-加急)非空字母数字字符串1-2位非空枚举(0-普通;1-加急)用途字符串 长度0-80要求的转账日期 YYYYMMDD日期YYYYMMDD系统当前日期(含当日)之后的一个月内手续费账号数码0或1-35位1、如果不为空则数码12-18位 2、账户已在网银维护,操作员有权限;如果为空则使用付款账户代替。付款账号和付费账号必须:都
30、是BANCS账号或者都不是BANCS账号。3、与付款账号同省响应标记说明对应请求的响应报文处理状态每条转账指令响应内容(0.1000)每条划账指令处理状态指令ID,请求时给出的ID每条划账指令的网银划账流水号4.10定向账户支付(b2e0010)付款账号所属单位与银行有协议,并把付款账号维护到银行系统中,企业须事先通过网银定向支付收款人、定向关系维护对收款账户信息进行维护,企业端程序向银行系统发起此类划账时银行检查付款账号,同时校验收款人编号。转账交易名称为b2e0010。相应的标记名称如下: 请求标记说明前置机检查点对接平台检查点 转账交易请求数字签名,该标签由前置机自动添加,企业无须上送转
31、账请求内容(1.100)不超过100笔指令ID,一条转账指令在客户端的唯一标识,建议企业按时间顺序生成且不超过12位非空字符串 长度1-321、非空字符串 长度1-32; 2、防重检查:操作员所属客户号下不能重复付款人账户检查操作员有无转账权限, 判断账户是否存在,转账金额是否超出该账户操作的最高限额,联行号非空数码5位, 1、非空数码5位 2、联行号有对应的省行联行号付款账号非空数码1-35位1、非空数码12-18位2、操作员有权限付款人名称(可选) 字符串0-70位收款人编号非空字符串 长度1-1001、非空字符串 长度1-10 2、“收款人编号”与“收款人账户信息”只能填一项,不能同时为
32、空,也不能同时存在。 3、检查付款人与收款人的定向关系是否存在收款人账户信息收款行联行号数码 长度0-121、非空 2、5位或12位数字,5位且能查到省行联行号认为是中行联行号,12位是CNAPS号.。收款账号非空字符串 长度1-35收款人开户行名称字符串 长度0-70该项信息以网银保存的收款人记录信息为准转账金额非空正数字 长度(22,2)1、非空正数 15.2位,最多两位小数 2、根据交易币种的辅币位数检查金额的格式;不超过转账限额转账货币非空3位大写字母、数字只支持001或者CNY报文发送优先级 非空字母数字字符串1-2位非空枚举(0-普通;1-加急)用途字符串0-80位要求的转账日期非
33、空8位YYYYMMDD系统当前日期(含当日)之后的一个月内手续费账号数码0或1-35位1、如果不为空则数码12-18位 2、账户已在网银维护,操作员有权限;如果为空则使用付款账户代替。付款账号和付费账号必须:都是BANCS账号或者都不是BANCS账号。3、与付款账号同省响应标记说明对应请求的响应报文处理状态每条转账指令响应内容(0.100)每条划账指令处理状态指令ID,请求时给出的ID每条划账指令的网银划账流水号4.11历史交易查询(b2e0011)建议使用“历史交易整合查询(b2e0044)”接口。历史交易查询用于企业端程序向银行系统发起按照约定的条件查询指定账户的历史交易明细,考虑到交易明
34、细数据量较大,不支持多账号的查询,且一次返回的笔数不超过3000笔,交易代码b2e0011,相应的标记名称如下: 请求标记说明前置机检查点对接平台检查点只支持单账号查询不超过1笔联行号非空数码5位1、非空数码5位 2、联行号有对应的省行联行号账号非空数码长度 1-351、非空数码12-18位2、操作员有权限日期范围跨度为3个月跨度为一个自然月开始日期(含)非空YYYYMMDD在当前日期之前的一年内截止日期(含)非空YYYYMMDD在当前日期之前的一年内报文编号,多包返回时用(暂不用)在BOCNET前置机无此标签可空,如果不为空最长10位字符串 查询的记录类型非空字母数字字符串1-2位非空枚举0
35、-全部;D-借方(支出记录);C-贷方(收入记录)响应标记说明报文处理状态B001,查询成功;B002,查询成功,未完成;查询响应内容(0.n)交易处理状态账户 联行号账号名称(可选)借贷标记:D-借 C-贷入账日期 YYYYMMDD起息日期 YYYYMMDD凭证号或传票号金额摘要用途冲账标识(用*标识)我方业务引用号交易机构号入账时间 HH24MISS 货币账户余额(BANCS新增、可空)对方账号(BANCS新增、可空)对方账号户名4.12历史余额查询 (b2e0012)余额查询用于企业端程序向银行系统发起查询给定账户(集)的当前余额。交易代码为b2e0012,相应的标记名称如下: 请求标记
36、说明前置机检查点对接平台检查点查询请求内容(1.100)不超过100笔单位账号 联行号非空数码5位1、非空数码5位 2、联行号有对应的省行联行号账号非空数码长度 1-351、非空数码12-18位2、操作员有权限日期范围跨度为3个月 开始日期(含)YYYYMMDD 在当前日期之前的一年内 截止日期(含)YYYYMMDD 在当前日期之前的一年内响应标记说明报文处理状态查询响应内容(0.n)交易处理状态账户联行号账号货币码当前余额本日期初余额本日期末余额日期4.13 定向支付收款人查询(b2e0013)(新网银不支持)定向支付收款人查询用于企业端程序向银行系统在发起查询已维护的企业全部定向支付收款人
37、信息。交易代码为b2e0013,相应的标记名称如下:请求响应请求标记说明 交易请求内容(1) 响应标记说明 报文处理状态 查询响应内容(0.n) 交易处理状态 收款人代码 收款人流水号 收款账户 收款联行号 收款行名 收款账号 收款人名称 收款人地址 收款人EMAIL 收款人传真 收款人手机 4.13 代发业务(b2e0014)代发业务用于企业端程序向银行系统发起代发工资或其他代发交易。交易代码为b2e0014,相应的标记名称如下: 请求标记说明前置机检查点对接平台检查点数字签名,该标签由前置机自动添加,企业无须上送交易请求内容(1)不超过1笔指令ID,一条转账指令在客户端的唯一标识,建议企业
38、按时间顺序生成且不超过12位非空字符串 长度1-321、非空字符串 长度1-32; 2、防重检查:操作员所属客户号下不能重复付款人账户联行号非空数码5位1、非空数码5位 2、联行号有对应的省行联行号付款账号非空数码1-35位1、非空数码12-18位2、账户已在网银维护,操作员有权限付款人名称 字符串 长度0-70货币非空3位大写字母、数字只支持001或者CNY批总金额非空正数字 长度(22,2)1、非空正数 15.2位,最多两位小数 2、不超过转账限额,批总金额与笔金额总数一致批总笔数非空数码1-4位批总笔数必须为自然数且与笔明细总笔数一致 代发工资的取值范围是1,1000,他行卡最多500笔
39、,其他代发的取值范围是1,200代发卡类型非空字母数字1-2位1:借记卡或存折4:信用卡(qcc,cc)5:公务卡6:他行卡(最多500笔)摘要非空字母数字字符串1-2位非空枚举(0-代发工资 1-其他代发)用途字符串 长度0-80要求的付款日期 日期YYYYMMDD系统当前日期(含当日)之后的一个月内手续费账号数码0或1-35位1、如果不为空则数码12-18位 2、账户已在网银维护,操作员有权限;如果为空则使用付款账户代替3、与付款账号同省笔明细内容(1.n)与批总笔数一致收款联行号可空数码长度0-121、非空 2、5位数字,且能查到省行联行号收款行名字符串 长度0-70收款账号字符串 长度
40、1-35货币非空大写字母3位、数字001或CNY笔金额非空正数字 长度(22,2)1、非空正数 13.2位,最多两位小数 收款人名称非空字符串 长度1-20收款人身份证号身份证号 长度0、15或18用途字符串 长度0-80如果是其他代发该项不能为空响应标记说明报文处理状态查询响应内容(0.1)交易处理状态转账指令ID网银交易流水号4.14代收业务(b2e0015)代收业务用于企业端程序向银行系统发起代收交易。交易代码为b2e0015,相应的标记名称如下: 请求标记说明前置机检查点对接平台检查点数字签名,该标签由前置机自动添加,企业无须上送交易请求内容(1)不超过1笔指令ID,一条转账指令在客户
41、端的唯一标识,建议企业按时间顺序生成且不超过16位(客户业务编号)客户应用系统自己产生的业务编号,或客户自己填写的号。非必填,如果不为空判断是否在企业内不能重复。1、非空字符串 长度1-16; 2、防重检查:操作员所属客户号下不能重复(根据软件需求规约(C23代收代付).doc中需求定义长度)收款人账户收款行联行号必填,5位数字 必填,5位数字,且4打头收款人账号必填,最长35位必填,最长35位,必须为数字收款人名称 字符串 长度0-70。不能含有oOiI不能超过76个字符货币名称必填,3位数字或字母必填,3位CNY或者001,必须为人民币,并校验与付款账户的货币名称一致批总金额必填,非空正数
42、字 长度(22,2)1、必填,最长14位,含小数点及2位小数。整数部分最长为11位,小数部分最长为2位2、批总金额与笔金额总数一致批总笔数必填,4位数字1、必填,最长6位2、批总笔数必须为自然数且与笔明细总笔数一致 代收卡类型必填,1位1、必填,1位2、选择项:1:借记卡或存折6:它行卡用途必填,1-2位1、必填,1位2、0 代收类手续费账号非必填,最长35位1、非必填,校验长度不超过35位2、只能为0-9,a-z,A-Z要求的收款日期 日期YYYYMMDD必须为未来一个月附言非必填,字符串长度0-80校验不能超过80位非必填笔明细内容1、与批总笔数一致2、最长不超过1000笔付款联行号必填,
43、最长1-12位1、必填,最长12位2、代收卡类型为中行卡时,必填5位联行行号,且4打头3、代收卡类型为他行卡时,必填12位CNAPS号付款行名必填,最长90位1、必填,最长90位2、不校验名称和编号是否一致货币名称非必填,3位,必须为人民币1、非必填,3位CNY或者001,必须为人民币2、如果填写,必须和收款货币名称一致笔金额必填,非空正数字 长度(22,2)1、必填,最长14位,含小数点及2位小数。既整数部分最长为11位,小数部分最长为2位2、必须大于0付款人账号必填,最长35位,不能含有oOiI1、必填,最长35位2、如果代收卡类型卡类型为1,付款人账号有19位借记卡和最长22位存折账号,
44、12-22位3、如果代收卡类型为6,付款人帐号,检验长度为1-35,不能有半个汉字、非法字符($_|:% )、非法字母(小写 O 和 I)付款人姓名必填,最长30位,不能含有oOiI1、必填,最长30位2、不能有半个汉字、非法字符($_|:% )、非法字母(小写 O 和 I)付款人证件类型非必填,0-2位非必填,最长2位,同BANCS证件类型付款人证件号非必填,0-30位1、必填,最长30位 2、只能为0-9,a-z,A-Z附言非必填,0-80位不能含有oOiI1、非必填,最长80位2、不能有半个汉字、非法字符($_|:% )、非法字母(小写 O 和 I)扣款合同编号字符串 长度0-60代收卡
45、类型为他行卡时,此项必填响应标记说明报文处理状态查询响应内容(0.1)交易处理状态转账指令ID网银交易流水号4.15资金主动调拨(b2e0019)对账户的检验规则与网银内部资金主动调拨功能相同。转账交易名称为b2e0019。相应的标记名称如下:请求标记说明前置机检查点对接平台检查点 转账交易请求数字签名,该标签由前置机自动添加,企业无须上送转账请求内容(1.100)不超过100笔支付标识非空数码1-2位非空枚举(00-下拨 01-上划)指令ID,一条转账指令在客户端的唯一标识,建议企业按时间顺序生成且不超过12位非空字符串 长度1-321、非空字符串 长度1-32; 2、防重检查:操作员所属客
46、户号下不能重复集团号非空数码,长度1-101、非空数码,长度1-10 2、检查集团号是否在网银维护,并结合支付标识检查该集团号,付款账户,收款账户的集团关系是否正确付款人账户联行号非空数码,长度5 1、非空数码5位 2、联行号有对应的省行联行号付款账号非空数码, 长度1-351、非空数码12-18位2、账户已在网银维护,操作员有权限付款人名称字符串, 长度0-70收款人账户信息收款行联行号非空数码,长度5 1、非空数码5位 2、联行号有对应的省行联行号收款账号非空数码, 长度1-351、非空数码12-18位2、账户已在网银维护,操作员有权限收款人名称字符串 长度0-70收款人地址字符串 长度0
47、-70收款人开户行名称字符串 长度0-70转账金额非空正数字 长度(22,2)1、非空正数 15.2位,最多两位小数 2、根据交易币种的辅币位数检查金额的格式转账货币非空3位大写字母、数字货币码与收付款账户货币属性一致,兼容货币码和货币名称报文发送优先级 非空字母数字字符串1-2位非空枚举(0-普通;1-加急)用途字符串 长度0-80手续费账号数码,0或1-35位使用付款账户指定的收费账户进行收费,,如果付费账户为空则默认为使用付款账户进行收费。目前,外币交易的费用,只能以人民币收取。响应标记说明对应请求的响应每条转账指令响应内容(0.100)每条划账指令处理状态指令ID,请求时给出的转账指令
48、ID每条划账指令的网银划账流水号4.16统一对外支付(b2e0020)集团公司可以直接利用总部集中账户对外支付结算或通过集团内部分/子公司账户对外支付结算以及集团内各分子公司内部结算。付款账户必须事先申请和维护到管理系统中,收款账户不做限制。转账交易名称为b2e0020。相应的标记名称如下:请求标记说明前置机检查点对接平台检查点 转账交易请求数字签名,该标签由前置机自动添加,企业无须上送转账请求内容(1)不超过1笔指令ID,一条转账指令在客户端的唯一标识,建议企业按时间顺序生成且不超过12位客户业务编号非空字符串 长度1-321、非空字符串 长度1-32; 2、防重检查:操作员所属客户号下不能
49、重复集团号非空数码,长度1-101、非空数码,长度1-10 2、检查集团号是否在网银维护,并结合支付标识检查该集团号,付款账户,收款账户的集团关系是否正确资金池账户联行号数码,长度为0或5位数1、非空数码5位 2、联行号有对应的省行联行号资金池账号数码,0或1-35非空数码12-18位资金池账号名称 字符串 长度0-70名义付款人账户名义付款人账户联行号非空数码,长度5 1、非空数码5位 2、联行号有对应的省行联行号名义付款人账号非空数码, 长度1-351、非空数码12-18位 2、结合名义付款人账户联行号检查名义付款账户信息是否在网银维护。检查名义付款账户统一对外支付属性,检查其是否暂停,其
50、余额是否超过本周期内剩余额度名义付款人账户名称字符串 长度0-70收款人账户信息收款行联行号数码0-12位1、可空 2、5位或12位数字,5位且能查到省行联行号认为是中行联行号,12位是CNAPS号.。3、如果是中行的账户,且能查到cnaps对应的省行联行号则在交易表里同时记录省行联行号和cnaps号。收款账号非空字符串,长度1-35收款人名称非空字符串 长度1-70收款人地址字符串 长度0-70 收款人开户行名称字符串 长度0-70该项可以为空,系统根据联行号或12位cnaps号取得收款行名去补全。收款行联行号为空时,此项为必填。转账金额非空正数字 长度(22,2)1、非空正数 15.2位,
51、最多两位小数 2、根据交易币种的辅币位数检查金额的格式;不超过转账限额转账货币非空3位大写字母、数字只支持001或者CNY报文发送优先级 非空字母数字字符串1-2位非空枚举(0-普通;1-加急)用途,客户附言字符串 长度0-80要求的转账日期 YYYYMMDD系统当前日期(含当日)之后的一个月内手续费账号数码,长度0或1-35位1、如果不为空则数码12-18位 2、间接支付的第一笔手续费账号为资金池账号,第二笔手续费账号为此手续费账号,如果此手续费账号为空,则取名义付款账号为手续费账号,如果不为空检查操作员权限,要求手续费账号和名义付款账号同机构。直接支付的,如果手续费账号为空,手续费账号为资
52、金池账号。如果不为空检查操作员权限,要求手续费账号和资金池账号同机构。3、与名义付款账号同省响应标记说明对应请求的响应报文处理状态每条转账指令响应内容(1)每条划账指令处理状态指令ID,请求时给出的转账指令ID每条划账指令的网银划账流水号4.17修改密码交易(b2e0021)修改密码交易用于修改银企对接操作员密码。请求标记说明前置机检查点对接平台检查点修改密码请求消息原密码字符串1-20位不做限制新密码字母数字标点符号串8-20位新旧口令不能相同,区分大小写,至少有一个字母和一个数字响应标记说明修改密码响应消息包括rspcod、rspmsg等服务端日期时间,YYYYMMDDHH24MISS4.
53、18网银交易信息查询(b2e0022)网银汇款信息查询用于企业端程序向银行系统发起查询指定账户在对公网上银行系统发生的交易信息,包含汇入和汇出。交易代码为b2e0022,相应的标记名称如下: 请求标记说明前置机检查点对接平台检查点 查询请求内容(1.100)不超过100笔查询账户的联行号非空数码5位1、非空数码5位 2、联行号有对应的省行联行号查询账户的账号非空数码1-35位1、非空数码12-18位2、账户已在网银维护,操作员有权限日期范围跨度为1个月开始日期(含)YYYYMMDD在当前日期之前的一年内截止日期(含)YYYYMMDD在当前日期之前的一年内汇款类型非空字母数字字符串1-2位非空枚
54、举(0:全部 1:汇入 2:汇出)产品类型 非空字母数字字符串1-2位非空枚举(0: 全部;1:转账汇款;6:期货;7:定向;8:主动扣款;9: 对外支付;G:主动调拨;A:自动归集)渠道类型 非空字母数字字符串1-2位非空枚举(0:全部 1:B/S模式 2:银企对接)响应标记说明报文处理状态查询响应内容(0.n)交易处理状态转账指令ID, 客户业务编号(税费单流水号)网银交易流水号付款账户付款联行号付款账号付款人名称收款账户收款联行号收款账号收款人名称收款人地址收款行名称金额货币指定付款日期实际付款日期交易成功日期相关业务系统编号交易状态用途入账时间 HH24MISS ,对应交易成功日期备注
55、,可记录名义付款账号信息。格式:名义付款账号|账户名称|联行号4.19历史汇款信息查询 (b2e0023)建议使用“历史交易整合查询(b2e0044)”接口。历史汇款信息查询(T+1)用于企业端程序向银行系统发起查询指定账户在银行系统发生的汇款交易信息,包含汇入和汇出。交易代码为b2e0023,相应的标记名称如下: 请求标记说明前置机检查点对接平台检查点查询请求内容(1)查询账户的联行号(必填项)非空数码5位查询账户的账号(必填项)非空数码12-18位账户已在网银维护,操作员有权限日期范围检查起始截止日期是否为3个月以内。如:系统当天日期为:,则检查起始/截止日期是否在日期范围 到 之间开始日
56、期(含)(非必填项) YYYYMMDD为空时,系统默认为当天三个月前的这一天,如:系统当天日期为: 则为空默认为 如果三个月前的这一天对应日期为2月份没有的日期(如0229,0230,0231),则都设定为该年2月份的最后一天(如:0228,润年为0229)截止日期(含)(非必填项)为空时,系统默认为昨日,如:系统当天日期为: 则为空默认为 查询金额范围正整数数字, 长度(15,2)检查金额上限是否大于金额下限 下限(含)非必填项,为空时,系统默认为0上限(含)大于金额下限(非必填项,为空时,系统默认为数据库最大金额 ,即 99.99)汇款类型(必填项)(1:汇入 2:汇出)非空枚举(1:汇入
57、 2:汇出)本次查询的交易起始位置数码最长6位如果该项为空,则默认为1本次查询的交易数数码最长3位该项不为空,则必须是50的倍数;如果为空则返回begnum之后的所有交易,最大100响应* 各输出项的说明一栏中,()表示该项在汇出查询或汇入查询中为空,()表示该输出项不为空,其他没有表明的表示该输出项可为空。格式一栏中,长度以0开头的项可为空。标记说明格式报文处理状态查询响应内容(0.100)交易处理状态汇款类型(1:汇入 2:汇出)非空枚举,为字符“1”或者“2” 付款联行号汇出查询不为空汇入查询可为空字符串,长度0,5,或12位VARCHAR2(12)付款账号汇出查询不为空汇入查询可为空字
58、符串,长度0-35付款人名称字符串,长度0-100付款开户行字符串,长度0-80汇款行业务编号字符串,长度0-32收款联行号:汇出查询可为空字符串,长度0,5,或12收款账号:汇出查询可为空字符串,长度0-35收款人名称:汇出查询不为空汇入查询可为空字符串,长度0-100收款行名称字符串,长度0-50收款行业务编号字符串,长度0-32发报行名称字符串,长度0-80发报行行号字符串,长度0,5,或12位收报行名称字符串,长度0-80收报行行号字符串,长度0,5,或12位汇出查询的明细不同于汇入查询的部分:如果remtyp=”2” (汇出查询时显示该部分信息) 汇款货币()字符串,长度3了哦汇款金
59、额()数字,长度(15,2)费用货币为空,或者为长度3的字符串费用金额为空,或者长度(15,2)费用账号字符串,长度0-35汇款种类或业务类型()TN=国内异地中行CO=辖内客户类转账TW=跨行汇划TT=国外起息日可为空;或者为8位的日期表示如下:YYYYMMDD凭证编号()字符串,长度1-10客户业务编号字符串,长度0-30网银编号(TRCNUM)字符串,长度0-30汇款用途字符串,长度0-140汇款附言, 备注字符串,长度0-140提交日期()字符串,8位的日期表示如下:YYYYMMDD发报日期 字符串,可为空,或者为8位的如下日期表示:YYYYMMDD发报时间6位字符串,如下日期表示:H
60、H24MISS汇入查询的明细不同于汇出查询的部分:如果remtyp=”1” (汇入查询时显示该部分信息)汇入货币()为长度3的字符串汇入金额()数字,长度(15,2)解付账号 字符串,长度1-35汇率为空。或者整数位数不大于5位,小数位数为四位数的数字。NUMBER(9,4)入账货币可为空,或者长度为3的字符串入账金额数字,长度(15,2),可为空。汇款种类或业务类型()TN=国内异地中行CO=辖内客户类转账TW=跨行汇划TT=国外起息日期()字符串,为8位的如下日期表示:YYYYMMDD凭证编号()字符串,长度1-10客户业务编号字符串,长度0-30网银编号(TRCNUM)字符串,长度0-3
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 2026交流干部面试题及答案
- ESG评级提升策略与企业社会责任报告模板
- 掘金下沉市场万亿蓝海:儿童滑梯秋千行业核心壁垒与县域商业闭环
- 2026经典小组面试题目及答案
- 供应链管理与采购成本控制优化策略
- 新能源汽车电池回收供应链体系构建与运营
- 智能地毯干洗机+量子计算优化算法:极致能效与耗材管理革命
- 智能座舱融合+双碳目标:绿色材料应用与碳足迹追踪
- 智能壁灯赋能智慧零售:重构门店光影体验与客流转化率
- 书法高效课堂:偏旁部首写法教学实录与反思
- 边坡安全管理措施
- 企业廉政培训课件
- 四年级语文上册快乐读书吧《中国神话传说》
- 村级应急物资管理制度
- 2025年公路水运工程重大事故隐患判定标准深度解析
- 电力电气设备安装工(试行) -国家职业标准(2024年版)
- 教学课件道德与法治部编版(2024版)七年级初一上册4.2让家更美好课件01
- 2024年可行性研究报告投资估算及财务分析全套计算表格(含附表-带只更改标红部分-操作简单)
- 电动汽车充电桩安装检修赛项考试题库500题(含答案)
- 临床营养学(重点)
- Weiss′s 功能性缺陷程度(父母问卷)
评论
0/150
提交评论