北京农村商业银行银企直联系统接口规范

1、北京农村商业银行银企直联系统接口规范报文规范请求报文作为二进制流放到requestBody里，同时对请求报文进行签名，将签名结果转换为16进制字符串，服务器URL为https:/服务器Ip:port/B2E/B2E/Forward.do?CSIISignature=签名结果，http request content type为“application/xmlstream”，返回的content type为“text/xml; *.*”注：如果使用我行银企直联的代理，则不需要用https,而使用http协议报文分为报文头和报文体两部分，报文头是通用的，报文体则根据不同的交易不同文件交换规范n 文

2、件命名规范文件命名规范对文件名称进行统一的规划，以达到从文件名称上区分不同业务文件的目的。文件命名规范：transname_userid_yyyymmdd_sequence.txt，其中：transname交易名称。Userid登录的用户名yyyymmdd日期。sequence批次号。报文头请求报文由请求报文头和请求报文体组成，返回报文由返回报文头和返回报文体组成，在交易有错误的情况下（返回码不为AAAAAAA），返回报文只有报文头报文头的内容所有交易相同。l 企业发起的请求报文头字段说明长度缺省值备注transName交易名称30唯一标识一次交易language语言10zh-cnclient

3、Date请求日期8yyyyMMddclientTime请求时间6hhnnssoperatorID操作员ID30银企直连操作员IDclientSeqNo客户交易流水号12由客户保证唯一性l 返回企业的响应报文头字段说明长度缺省值备注transName交易名称30如果xml格式错误，则此域填写为ERRORlanguage语言10zh-cnrespondDate响应日期8yyyyMMddrespondTime响应时间6hhnnssoperatorID操作员ID30银企直连操作员IDclientSeqNo客户交易流水号12唯一标识一次交易respondCode返回码7返回码为AAAAAAA表示成功，其

4、他表示失败respondInfo返回消息50在返回码不为AAAAAAA的情况下，此域是错误说明，此时返回报文只有报文头，没有报文体活期账户余额查询（交易名称：b2eQueryBalance）l 企业发起请求报文：字段说明长度缺省值备注transID交易序号6acctNo账号19一次查询账号数量最多为10个。l 请求报文样例：<?xml version="1.0" encoding="gb2312"?><transaction><requestHeader></requestHeader><reques

5、tBody><transCount>2</transCount><requestRecord> <transID>交易序号1</transID><acctNo>账号1</acctNo></requestRecord><requestRecord><transID>交易序号2</transID><acctNo>账号2</acctNo></requestRecord></requestBody></trans

6、action>l 返回给企业的应答报文：字段说明长度缺省值备注transID交易序号6acctNo账号19acctName户名60balance余额15.2availablebalance可用余额15.2l 返回报文样例：<?xml version="1.0" encoding="gb2312"?><transaction> <respondHeader> </respondHeader> <respondBody><transCount>2</transCount>

7、; <respondRecord><transID>交易序号1</transID><acctNo>账号1</acctNo><acctName>户名</acctName><balance>余额</balance><availablebalance>可用余额</availablebalance> </respondRecord> <respondRecord><transID>交易序号2</transID><acc

8、tNo>账号2</acctNo><acctName>户名</acctName><balance>余额</balance><availablebalance>可用余额</availablebalance> </respondRecord> </respondBody></transaction>活期账户历史余额查询（交易名称：b2eQueryHisBalance）l 企业发起请求报文：字段说明长度缺省值备注queryDate查询日期8格式:YYYYMMDDacctNo账号

9、19注：查询日期最远只能在当前日期的半年前，如果此日期之前没有相应的交易明细，则报错l 请求报文样例：<?xml version="1.0" encoding="gb2312"?><transaction><requestHeader></requestHeader><requestBody><queryDate>20090301</queryDate><acctNo>账号1</acctNo></requestBody></tra

10、nsaction>l 返回给企业的应答报文：字段说明长度缺省值备注acctNo账号19acctName户名60balance余额15.2tranDate最后交易日期8l 返回报文样例：<?xml version="1.0" encoding="gb2312"?><transaction> <respondHeader> </respondHeader> <respondBody> <acctNo>账号1</acctNo> <balance>13550&l

11、t;/balance> <tranDate>20090201</tranDate> </respondBody></transaction>当日/历史明细查询（一次只能查询一个账户，交易名称：b2eQueryTransDetail）l 企业发起请求报文：字段说明长度缺省值备注transID交易序号6checkType查询类型11：当日(报文方式) 2：历史（报文方式）acctNo账号19beginDate起始日期8endDate终止日期8startIndex起始记录数8从1开始l 请求报文样例：<?xml version="

12、1.0" encoding="gb2312"?><transaction><requestHeader></requestHeader><requestBody><checkType>查询类型</checkType><acctNo>账号</acctNo><beginDate>开始日期</beginDate><endDate>终止日期</endDate> <startIndex>起始记录数</star

13、tIndex></requestBody></transaction>l 报文方式下返回给企业的应答报文：字段说明长度缺省值备注acctNo账号19currency币种2transCount笔数6历史明细查询时返回的是符合条件的总笔数，当日明细查询返回的是本次返回的笔数，最大值是10startIndex起始记录6以下为循环域transDate交易日期8transTime交易时间6voucherNo凭证号码12txamount发生额15.2tranFlag借贷标志1借贷标志0-借 1-贷acctbalance余额15.2note摘要编码3每次返回10条记录l 返回报

14、文样例：<?xml version="1.0" encoding="gb2312"?><transaction> <respondHeader> </respondHeader> <respondBody><acctNo>账号</acctNo><currency>币种</currency><transCount>2</transCount> <startIndex>起始记录数</startIndex>

15、< respondRecord ><transDate>交易日期</transDate><transTime>交易时间</transTime><voucherNo>凭证号码</voucherNo><txamount>发生额</txamount><tranFlag>借贷标志</tranFlag><acctbalance>余额</acctbalance><note>摘要编码</note></respondRecor

16、d><respondRecord><transDate>交易日期</transDate><transTime>交易时间</transTime><voucherKind>凭证种类</voucherKind><txamount>发生额</txamount><tranFlag>借贷标志</tranFlag><acctbalance>余额</acctbalance><note>摘要编码</note></respo

17、ndRecord ></respondBody> </transaction>说明：如何判断是否还有下一页，历史明细查询可以根据返回的“笔数”域的值来判断；当日明细如果返回码为AAAAAAA，而报文体的transCount小于10，则说明没有下一页，如果等于10，则有可能有，也可能没有下一页，需要再查一次。n 文件方式下返回的文件格式文件格式采用CSV（Comma-Separated Variable）标准。每一行包含以下各项： 中文名称格式备注交易日期YYYYMMDD交易时间HHMinSS凭证号码发生额借贷标志余额摘要编码例：20080901,153325,23

18、2323001049,11.83,0,2093.88,TRS20080905,101229,83787898,8236.98,1,300018.51,020行内转账交易（交易名称：b2eInnerBankTransfer）l 企业发起请求报文（不允许一次转多笔）：字段说明长度缺省值备注acctNo转出账号19payeeAcctNo转入账号19payeeAcctName转入账户名称62amount交易金额15.2note用途60必填l 请求报文样例：<?xml version="1.0" encoding="gb2312"?><trans

19、action><requestHeader></requestHeader><requestBody><acctNo>付款账号</acctNo><payeeAcctNo>收款账号</payeeAcctNo><payeeAcctName>收款账户名称</payeeAcctName><amount>金额</amount><note>用途</note></requestBody></transaction>l 返回给

20、企业的应答报文：字段说明长度缺省值备注ebankSeqNo网银流水号8hostJournalNo主机流水号9acctNo转出账号19balance转出账号余额15.2payeeAcctName收款账户名称62l 返回报文样例：<?xml version="1.0" encoding="gb2312"?><transaction> <respondHeader> </respondHeader> <respondBody><ebankSeqNo>网银流水号</ebankSeqNo

21、><hostJournalNo>主机流水号</hostJournalNo><acctNo>付款账号</acctNo><balance>转出账号余额</balance><payeeAcctName>收款账户名称</payeeAcctName> </respondBody></transaction>转账结果查询（交易名称：b2eQueryTransferResult）l 企业发起请求报文（不允许一次查多笔）：字段说明长度缺省值备注oriClientSeqNo客户交易流水号

22、12发送时的客户交易流水号oriClientDate请求日期8原请求日期l 请求报文样例：<?xml version="1.0" encoding="gb2312"?><transaction><requestHeader></requestHeader><requestBody> <oriClientSeqNo>流水号</oriClientSeqNo><oriClientDate>请求日期</oriClientDate></requestB

23、ody></transaction>l 返回给企业的应答报文：字段说明长度缺省值备注ebankDate网银交易日期8格式YYYYMMDDebankSeqNo网银流水号8status转账结果1在返回码为AAAAAAA的情况下才有用0 成功1 失败2 待处理3 已退回4 已退汇5 处理中6 不存在此笔交易message失败原因100l 返回报文样例：<?xml version="1.0" encoding="gb2312"?><transaction> <respondHeader> </respo

24、ndHeader> <respondBody><ebankSeqNo>网银流水号</ebankSeqNo><ebankDate>网银交易日期</ebankDate><clientSeqNo>客户端流水号</clientSeqNo><status>转账结果</status><message>失败原因</message> </respondBody></transaction>行外转账交易（交易名称：b2eOutBankTransfer）

25、说明：行外转账的渠道有大额，小额两个系统，大额是实时到账，小额是非实时到账（一般在3天以内能到），大小额系统的收费不一样，如果选择加急或转账金额大于20000元，走大额系统，否则走小额系统。对于公司账户，小额系统至少收费5.5元，个人账户是2元l 企业发起请求报文（不允许一次转多笔）：字段说明长度缺省值备注acctNo转出账号19payeeAcctNo转入账号62payeeAcctName转入账户名称62amount交易金额15.2currency币种201人民币joinNo收款账户联行号12expressFlag加急标志10 不加急1 加急note用途60必填l 请求报文样例：<?xm

26、l version=”1.0” encoding=”gb2312”?><transaction><requestHeader></requestHeader><requestBody><acctNo>0801000103000000783</acctNo><payeeAcctNo>232255112233</payeeAcctNo><payeeAcctName>艺丰科贸公司</payeeAcctName><amount>100000.65</amoun

27、t> <joinNo>103795342569</joinNo> <expressFlag>1</expressFlag><note>用途</note></requestBody></transaction>l 返回给企业的应答报文：字段说明长度缺省值备注ebankSeqNo网银流水号8hostJournalNo主机流水号9acctNo转出账号19balance转出账号余额15.2payeeAcctName收款账户名称62fee手续费15.2PaymentSN支付系统流水号9字符Payment

28、Date支付系统日期8字符l 返回报文样例：<?xml version="1.0" encoding="gb2312"?><transaction> <respondHeader> </respondHeader> <respondBody><ebankSeqNo>网银流水号</ebankSeqNo><hostJournalNo>主机流水号</hostJournalNo><acctNo>付款账号</acctNo><ba

29、lance>转出账号余额</balance><payeeAcctName>收款账户名称</payeeAcctName> <fee>7.5</fee> </respondBody></transaction>转账交易手续费查询（交易名称：b2eQueryTransferFee）说明：用来查询会扣收的手续费l 企业发起请求报文（不允许一次转多笔）：字段说明长度缺省值备注amount交易金额15.2transferType转账类型10 行内1 行外joinNo收款账户联行号12expressFlag加急标志10

30、 不加急1 加急acctNo转出账号19payeeAcctNo转入账号62l 请求报文样例：<?xml version=”1.0” encoding=”gb2312”?><transaction><requestHeader></requestHeader><requestBody> <amount>100000.65</amount> <transferType>1</transferType><joinNo>103795342569</joinNo> <

31、expressFlag>1</expressFlag><note>用途</note></requestBody></transaction>l 返回给企业的应答报文：字段说明长度缺省值备注fee手续费15.2l 返回报文样例：<?xml version="1.0" encoding="gb2312"?><transaction> <respondHeader> </respondHeader> <respondBody><f

32、ee>7.5</fee> </respondBody></transaction>当日/历史交易列表查询（一次只能查询一个账户，交易名称：b2eQueryTransList）l 企业发起请求报文：字段说明长度缺省值备注transID交易序号6checkType查询类型11：当日(报文方式) 2：历史（报文方式）acctNo账号19beginDate起始日期8endDate终止日期8startIndex起始记录数8从1开始l 请求报文样例：<?xml version="1.0" encoding="gb2312&quo

33、t;?><transaction><requestHeader></requestHeader><requestBody><checkType>查询类型</checkType><acctNo>账号</acctNo><beginDate>开始日期</beginDate><endDate>终止日期</endDate> <startIndex>起始记录数</startIndex></requestBody></

34、transaction>l 报文方式下返回给企业的应答报文：字段说明长度缺省值备注acctNo账号19currency币种2transCount笔数6历史明细查询时返回的是符合条件的总笔数，当日明细查询返回的是本次返回的笔数，最大值是10startIndex起始记录6以下为循环域transDate交易日期8transTime交易时间6hostJnlNo流水号9voucherNo凭证号码12recieveAmount收入金额15.2payAmount支出金额15.2acctbalance余额15.2parterAcNo对方账号parterAcName对方户名note交易摘要（中文）50每次

35、返回10条记录l 返回报文样例：<?xml version="1.0" encoding="gb2312"?><transaction> <respondHeader> </respondHeader> <respondBody><acctNo>账号</acctNo><currency>币种</currency><transCount>2</transCount> <startIndex>起始记录数</st

36、artIndex><respondRecord><transDate>交易日期</transDate><transTime>交易时间</transTime><hostJnlNo>流水号</hostJnlNo><voucherNo>凭证种类</voucherNo><recieveAmount>收入金额</recieveAmount><payAmount>支出金额</payAmount><acctbalance>余额</acctbalance><parterAcNo>对方账号</parterAcNo><parterAcName>对方名称</parterAcName><note>摘要信息</note></respondRecord ><respondRecord><transDate>交易日期</transDate><transTime>交易时间</transTime> <