输入概括:对应的资金账号、托管账号、债券代码及需要买入的金额。 输出概括:返回客户信息、卡信息及债券信息,最重要的还有交易顺序号、净价、交易金额这些数据在买入确认、债券买入释放额度、确认卖出中都需要。 功能概括:买入查牌价。 接口调用后台系统BONDS
URL
http://openapi.boc.cn/bocop/nationaldebt/bond_buying_check_list
调用方法
POST
是否需要登录
是
接口使用注意点
系统名称 |
交易码 |
内部版本号 |
备注 |
请求参数
报文头上送字段
字段名 |
中文描述 |
类型 |
最大长度 |
备注 |
clentid |
第三方应用编号 |
|
18 |
|
userid |
第三方用户ID |
|
18 |
|
acton |
访问令牌 |
|
256 |
第三方应用注销传刷新令牌 |
chnflg |
渠道标识 |
|
1 |
1-移动终端 2-PC终端 |
trandt |
交易日期 |
|
8 |
yyyymmdd |
trantm |
交易时间 |
|
6 |
hhmmss |
接口上送字段
字段名 |
中文描述 |
字段 类型 |
数据格式 |
最大长度 |
是否必输 |
是否循环 |
备注 |
userid |
用户ID |
String |
|
50 |
Y |
N |
必输 |
accrem |
卡唯一标识 |
String |
|
16 |
Y |
N |
必输 |
chnnlno |
渠道标识 |
String |
|
1 |
N |
N |
0:柜台;I:网上银行个人服务(IBSS)、手机银行、家居银行、电话银行、自助终端 |
txncde |
后台交易码 |
String |
|
4 |
Y |
N |
填:2003 |
txntype |
交易类型 |
String |
|
1 |
Y |
N |
必输0:管理端交易1:对私联机交易2:对公联机交易 |
filler |
包头预留位 |
String |
|
59 |
Y |
N |
送空格即可 |
actno |
托管账号 |
String |
|
18 |
N |
N |
|
bdcode |
债券代码 |
String |
|
12 |
Y |
N |
必输项 |
faceamt |
交易面额 |
Integer |
|
15 |
Y |
N |
必输项 |
接口上送范例
{"userid":"?","accrem":"?","chnnlno":"?","txncde":"?","txntype":"?","filler":"?","actno":"?","bdcode":"?","faceamt":"?"}
返回字段说明
字段名 |
中文描述 |
字段 类型 |
数据格式 |
最大长度 |
是否必输 |
是否循环 |
备注 |
retmsg |
返回信息 |
String |
|
100 |
N |
N |
出错时填写 |
faceamt |
债券面额 |
Integer |
|
15 |
N |
N |
|
bondpricesum |
结算价格 |
Integer |
9(3)V9(10) |
13 |
N |
N |
|
txnamt |
交易金额 |
Integer |
9(15)V9(2) |
17 |
N |
N |
|
transeries |
交易顺序号 |
Integer |
|
8 |
Y |
N |
|
chnname |
户名 |
String |
|
60 |
Y |
N |
|
bdname |
债券简称 |
String |
|
16 |
Y |
N |
|
txncodes |
交易类别 |
String |
|
6 |
Y |
N |
|
txnface |
债券面额 |
Integer |
PIC ***,***,***,***,**9 |
19 |
Y |
N |
|
txnprice |
价格 |
Integer |
PIC ***.********** |
14 |
Y |
N |
|
pricebuy |
净价 |
Integer |
9(3)v9(2) |
5 |
Y |
N |
|
retcde |
返回码 |
String |
|
4 |
N |
N |
|
accuredint |
应计利息 |
Integer |
9(3)v9(10) |
13 |
Y |
N |
|
date |
当前日期 |
String |
|
8 |
Y |
N |
|
time |
时间 |
String |
|
6 |
Y |
N |
|
short |
债券简称 |
String |
|
16 |
Y |
N |
|
intrate |
债券利率 |
Integer |
*9.99999999 |
12 |
Y |
N |
|
duedate |
债券到期日 |
String |
|
8 |
Y |
N |
|
faceamtcap |
债券面额 |
String |
|
46 |
Y |
N |
|
datalen |
返回数据长度 |
Integer |
|
5 |
N |
N |
|
branchno |
BRANCH号 |
String |
|
5 |
N |
N |
取上送报头的值 |
txncde |
交易码 |
String |
|
4 |
N |
N |
取上送报头的值 |
A_TRAN_TELLER |
交易柜员 |
Integer |
|
7 |
N |
N |
取上送报头的值 |
actno |
托管帐户 |
String |
|
18 |
N |
N |
|
cardno |
资金账号 |
String |
|
22 |
N |
N |
|
bdcode |
债券代码 |
String |
|
12 |
N |
N |
|
接口返回范例
{"retmsg":"?","retcde":"?","datalen":"?","branchno":"?","txncde":"?","A_TRAN_TELLER":"?","actno":"?","cardno":"?","bdcode":"?","faceamt":"?","bondpricesum":"?","txnamt":"?","transeries":"?","chnname":"?","bdname":"?","txncodes":"?","txnface":"?","txnprice":"?","pricebuy":"?","accuredint":"?","date":"?","time":"?","short":"?","intrate":"?","duedate":"?","faceamtcap":"?"}