北京农村商业银行银企直联系统接口规范.docx
- 文档编号:27229767
- 上传时间:2023-06-28
- 格式:DOCX
- 页数:30
- 大小:24.74KB
北京农村商业银行银企直联系统接口规范.docx
《北京农村商业银行银企直联系统接口规范.docx》由会员分享,可在线阅读,更多相关《北京农村商业银行银企直联系统接口规范.docx(30页珍藏版)》请在冰豆网上搜索。
北京农村商业银行银企直联系统接口规范
报文规范
请求报文作为二进制流放到requestBody里,同时对请求报文进行签名,将签名结果转换为16进制字符串,服务器URL为https:
//服务器Ip:
port/B2E/B2E/Forward.do?
CSIISignature=签名结果,httprequestcontenttype为“application/xmlstream,返”回的contenttype为“text/xml;*.*”注:
如果使用我行银企直联的代理,则不需要用https,而使用http协议报文分为报文头和报文体两部分,报文头是通用的,报文体则根据不同的交易不同文件交换规范
文件命名规范文件命名规范对文件名称进行统一的规划,以达到从文件名称上区分不同业务文件的目的。
文件命名规范:
transname_userid__yyyymmdd_sequence.txt,其中:
transname——交易名称。
Userid——登录的用户名yyyymmdd——日期。
sequence——批次号。
报文头
请求报文由请求报文头和请求报文体组成,返回报文由返回报文头和返回报文体组成,在交易有错误的情况下(返回码不为AAAAAAA),返回报文只有报文头
报文头的内容所有交易相同。
企业发起的请求报文头
字段
说明
长度
缺省值
备注
transName
交易名称
30
唯一标识一次交
易
language
语言
10
zh-cn
clientDate
请求日期
8
yyyyMMdd
clientTime
请求时间
6
hhnnss
operatorID
操作员ID
30
银企直连操作员
ID
clientSeqNo
客户交易流水号
12
由客户保证唯一性
返回企业的响应报文头
字段
说明
长度
缺省值
备注
transName
交易名称
30
如果xml格式错误,则此域填写为ERROR
language
语言
10
zh-cn
respondDate
响应日期
8
yyyyMMdd
respondTime
响应时间
6
hhnnss
operatorID
操作员ID
30
银企直连操作员
ID
clientSeqNo
客户交易
流水号
12
唯一标识一次交
易
respondCode
返回码
7
返回码为AAAAAAA表示成功,其他表示失败
respondInfo
返回消息
50
在返回码不为AAAAAAA的情况下,此域是错误说明,此时返回报文只有报文头,没有报文体
活期账户余额查询(交易名称:
b2eQueryBalance)
企业发起请求报文:
字段
说明
长度
缺省值
备注
transID
交易序号
6
acctNo
账号
19
一次查询账号数量最多为10个
请求报文样例:
xmlversion="1.0"encoding="gb2312"?
>
返回给企业的应答报文:
字段
说明
长度
缺省值
备注
transID
交易序号
6
acctNo
账号
19
acctName
户名
60
balance
余额
15.2
availablebalance
可用余额
15.2
返回报文样例:
xmlversion="1.0"encoding="gb2312"?
>
活期账户历史余额查询(交易名称:
b2eQueryHisBalance)
企业发起请求报文:
字段
说明
长度
缺省值
备注
queryDate
查询日期
8
格式:
YYYYMMDD
acctNo
账号
19
注:
查询日期最远只能在当前日期的半年前,如果此日期之前没有相应的
交易明细,则报错
请求报文样例:
xmlversion="1.0"encoding="gb2312"?
>
返回给企业的应答报文:
字段
说明
长度
缺省值
备注
acctNo
账号
19
acctName
户名
60
balance
余额
15.2
tranDate
最后交易日
期
8
返回报文样例:
xmlversion="1.0"encoding="gb2312"?
>
当日/历史明细查询(一次只能查询一个账户,交易名称:
b2eQueryTransDetail)
企业发起请求报文:
字段
说明
长度
缺省值
备注
transID
交易序号
6
checkType
查询类型
1
1:
当日(报文方式)
2:
历史(报文方
式)
acctNo
账号
19
beginDate
起始日期
8
endDate
终止日期
8
startIndex
起始记录数
8
从1开始
请求报文样例:
xmlversion="1.0"encoding="gb2312"?
>
报文方式下返回给企业的应答报文:
字段
说明
长度
缺省值
备注
acctNo
账号
19
currency
币种
2
transCount
笔数
6
历史明细查询时
返回的是符合条件的总笔数,当日明细查询返回的是本次返回的笔数,最大值是10
startIndex
起始记录
6
以下为循环域
transDate
交易日期
8
transTime
交易时间
6
voucherNo
凭证号码
12
txamount
发生额
15.2
tranFlag
借贷标志
1
借贷标志
0--借
1--贷
acctbalance
余额
15.2
note
摘要编码
3
每次返回10条记录返回报文样例:
xmlversion="1.0"encoding="gb2312"?
>
说明:
如何判断是否还有下一页,历史明细查询可以根据返回的“笔数”域的值来判断;当日明细如果返回码为AAAAAA,A而报文体的transCount小于10,则说明没有下一页,如果等于10,则有可能有,也可能没有下一页,需要再查一次。
文件方式下返回的文件格式
文件格式采用CSV(Comma-SeparatedVariable)标准。
每一行包含以下各项:
中文名称
格式
备注
交易日期
YYYYMMDD
交易时间
HHMinSS
凭证号码
发生额
借贷标志
余额
摘要编码
例:
20080901,153325,232323001049,11.83,0,2093.88,TRS
20080905,101229,83787898,8236.98,1,300018.51,020
行内转账交易(交易名称:
b2eInnerBankTransfer)
企业发起请求报文(不允许一次转多笔)
字段
说明
长度
缺省值
备注
acctNo
转出账号
19
payeeAcctNo
转入账号
19
payeeAcctName
转入账户名称
62
amount
交易金额
15.2
note
用途
60
必填
请求报文样例:
xmlversion="1.0"encoding="gb2312"?
>
返回给企业的应答报文:
字段
说明
长度
缺省值
备注
ebankSeqNo
网银流水号
8
hostJournalNo
主机流水号
9
acctNo
转出账号
19
balance
转出账号余额
15.2
payeeAcctName
收款账户名称
62
encoding="gb2312"?
>
返回报文样例:
xmlversion="1.0"
转账结果查询(交易名称:
b2eQueryTransferResult)
企业发起请求报文(不允许一次查多笔)
字段
说明
长度
缺省值
备注
oriClientSeqNo
客户交易流水号
12
发送时的客户交易流水号
oriClientDate
请求日期
8
原请求日期
请求报文样例:
xmlversion="1.0"encoding="gb2312"?
>
返回给企业的应答报文:
字段
说明
长度
缺省值
备注
ebankDate
网银交易日期
8
格式
YYYYMMDD
ebankSeqNo
网银流水号
8
status
转账结果
1
在返回码为AAAAAAA的情况下才有用0—成功1—失败2—待处理3—已退回4—已退汇5—处理中6—不存在此笔交易
message
失败原因
100
encoding="gb2312"?
>
返回报文样例:
xmlversion="1.0"
行外转账交易(交易名称:
b2eOutBankTransfer)说明:
行外转账的渠道有大额,小额两个系统,大额是实时到账,小额是非实时到账(一般在3天以内能到),大小额系统的收费不一样,如果选择加急或转账金额大于20000元,走大额系统,否则走小额系统。
对于公司账户,小额系统至少收费5.5元,个人账户是2
元
企业发起请求报文(不允许一次转多笔)
字段
说明
长度
缺省值
备注
acctNo
转出账号
19
payeeAcctNo
转入账号
62
payeeAcctName
转入账户名称
62
amount
交易金额
15.2
currency
币种
2
01人民币
joinNo
收款账户联行号
12
expressFlag
加急标志
1
0—不加急
1—加急
note
用途
60
必填
请求报文样例:
xmlversion=”1.0”encoding=”gb2312”?
>
返回给企业的应答报文:
字段
说明
长度
缺省值
备注
ebankSeqNo
网银流水号
8
hostJournalNo
主机流水号
9
acctNo
转出账号
19
balance
转出账号余额
15.2
payeeAcctName
收款账户名称
62
fee
手续费
15.2
PaymentSN
支付系统流水号
9
字符
PaymentDate
支付系统日期
8
字符
encoding="gb2312"?
>
返回报文样例:
xmlversion="1.0"
转账交易手续费查询(交易名称:
b2eQueryTransferFee)说明:
用来查询会扣收的手续费
企业发起请求报文(不允许一次转多笔)
字段
说明
长度
缺省值
备注
amount
交易金额
15.2
transferType
转账类型
1
0—行内
1—行外
joinNo
收款账户联行号
12
expressFlag
加急标志
1
0—不加急
1—加急
acctNo
转出账号
19
payeeAcctNo
转入账号
62
请求报文样例:
xmlversion=”1.0”encoding=”gb2312”?
>
返回给企业的应答报文:
字段
说明
长度
缺省值
备注
fee
手续费
15.2
encoding="gb2312"?
>
返回报文样例:
xmlversion="1.0"
当日/历史交易列表查询(一次只能查询一个账户,交易名称:
b2eQueryTransList)
企业发起请求报文:
字段
说明
长度
缺省值
备注
transID
交易序号
6
checkType
查询类型
1
1:
当日(报文方式)
2:
历史(报文方
式)
acctNo
账号
19
beginDate
起始日期
8
endDate
终止日期
8
startIndex
起始记录数
8
从1开始
请求报文样例:
xmlversion="1.0"encoding="gb2312"?
>
报文方式下返回给企业的应答报文:
字段
说明
长度
缺省值
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 北京 农村 商业银行 银企直 联系 接口 规范
![提示](https://static.bdocx.com/images/bang_tan.gif)