保证金存管银行接口说明.docx
- 文档编号:1360331
- 上传时间:2022-10-21
- 格式:DOCX
- 页数:12
- 大小:916.43KB
保证金存管银行接口说明.docx
《保证金存管银行接口说明.docx》由会员分享,可在线阅读,更多相关《保证金存管银行接口说明.docx(12页珍藏版)》请在冰豆网上搜索。
保证金存管银行接口说明
保证金存管银行接口说明
2006年9月
目录
第1章报文格式3
1.1XML约定3
1.2字段次序3
1.3字段类型4
1.4多域串4
1.5发起方序号、企业凭证号4
1.6关于行号4
1.7数字签名和加密4
1.8返回结果5
第2章交易报文定义5
2.1交易报文头定义5
2.1.1请求报文头5
2.1.2应答报文头5
2.2交易报体定义6
2.2.1期货交易所批量转账交易6
2.2.2期货交易所帐户信息查询7
2.2.3银行主动通知8
第1章报文格式
期货资金系统的标准报文结构为:
7位报头+数据报;
1位(标志位)
●6位(报文长度,不包括7位报头长度)
●左对齐,右补空格
XML报文
标志位说明:
1-报文不加密;报文加密。
举例说明:
若XML交易报文长度为828字节,则报头应写:
0828+XML报文
1.1XML约定
交易报文为XML格式,XML(包括XML数据报和XML文件)都不包含头部的XML声明(即
xmlversion="1.0"?
>);除非有特别的说明,否则所有XML报文的最上层节点名都为
报头
报体
接口中字段名即对应了元素的标记名(包含了相对于根的路径名);
在XML数据报中所有元素的数据都不采用属性,而一律用字符数据的文本块来表示。
1.2字段次序
对于XML,同一层的字段次序可以不参照本文档中的字段次序描述;
对于多域串(即以’|’或‘\’作为每个字段结束符的字符串,以下简称MFS)或格式化字符串,字段次序必须严格与本文档中的字段次序描述保持一致。
1.3字段类型
字段类型分为以下三类:
●Cn:
字段允许为任何可见字符(包括数字和中文),n在XML中表示有效数据的最大总长度,如果有效数据长度不足n位,则取实际位数;在格式化字符串中表示固定的长度,如果有效数据长度不足n位,则有效数据左对齐,右边用空格补足至n位;
●Nn:
字段内容只允许为0-9数字,n在XML中表示有效数据的最大总长度;
●Nm.n:
基本上与Nn类型类似,0-9数字和小数点,其中m表示小数点前面数据的最大总长度,n表示小数位数,通常用来表示发生额、余额等金额类字段,如N12.2表示销售点前面有12位数据,小数点后保留2位的字段。
说明:
金额字段严格按带两位小数的格式,不带符号,如:
14.23。
1.4多域串
多域串用于企业银行内部各子系统之间返回多条记录,简写为MFS,多域串采用固定分隔符,对于本系统而言,分隔符一般采用‘|’,通知消息接口中的数据域一般采用‘/’。
1.5发起方序号、企业凭证号
●发起方序号:
由企业方产生,包含在所有交易的报文中。
●企业凭证号:
由企业方产生,仅包含在金融转账交易的报文中,作为企业方的金融交易流水号,银行方记录该凭证号并检验其唯一性。
1.6关于行号
报文中必须包含行号,用来识别不同商业银行。
1.7数字签名和加密
数字签名和加密均在前置中完成。
1.8返回结果
判断应答报中的成功标志
表示成功,其它表示失败;
返回附加码(particular_code)和返回附加信息(particular_info)是对返回信息的详细说明。
第2章交易报文定义
银行发起和交易所发起的请求用不同的交易码区分。
2.1交易报文头定义
2.1.1请求报文头
请求公共报头
数据格式
XML
继承接口
请求公共报头
字段名(包括路径)
字段中文名
类型
取值范围
为空
说明
交易码
C6
N
企业代码
C13
N
由银行方提供
企业用户号
C4
N
由银行方提供
交易序号
N9
N
填零
发起方序号
C20
企业方产生
交易日期
N8
N
时间
N6
N
原子交易数
N8
N
填’1’
渠道标志
C1
N
填’1’
数字签名
C3072
上传文件名
C60
原交易序号
N9
为空
保留字段
C1024
2.1.2应答报文头
应答公共报头
数据格式
XML
继承接口
应答公共报头
字段名(包括路径)
字段中文名
类型
取值范围
为空
说明
交易码
C6
N
企业代码
C13
N
发起方序号
C20
原样返回
交易序号
N9
应答流水号
N9
下笔交易序号
N9
N
交易日期
N8
时间
N6
成功标志
C1
N
0-成功,其它失败
返回信息
C70
返回附加码
C4
4位返回码
返回附加详细信息
C70
原子交易数
N8
保留字段
C1024
保留字段
2.2交易报体定义
2.2.1期货交易所批量转账交易
期货交易所批量转账交易(910101)
数据格式
XML
继承接口
请求包
字段名(包括路径)
字段中文含义
类型
取值范围
为空
说明
数据区
N
字段顺序:
cert_no|pay_acno|pay_acname|pay_bank_no|Amt|
rcv_acno|rcv_acname|rcv_bank_no|cur_code|
Postscript|MemNo|remark|
中文意义:
凭证号|付款帐号|付款户名|付款行号|金额|收款帐号|收款户名|收款行号|币种|附言|会员|备注|
字段数
Int
N
记录数
Int
N
期货交易所批量转账交易(910101)
数据格式
xml
继承接口
应答包
字段名(包括路径)
字段中文名
类型
返回格式
为空
说明
凭证编号|成功标志|返回信息|扩展信息|
N
成功标志:
●0:
成功
●8:
交易结果未知
●其它失败
字段数
Int
N
记录数
Int
N
2.2.2期货交易所帐户信息查询
期货交易所帐户信息查询(910100)
数据格式
xml
继承接口
请求包
字段名(包括路径)
字段中文名
类型
取值范围
为空
说明
多帐号查询
帐号
C32
N
币种
c2
N
行号
C12
N
期货交易所帐户信息查询(910100)
数据格式
XML
继承接口
应答包
字段名(包括路径)
字段中文名
类型
返回格式
为空
说明
户名(C60)|帐号(C32)|币种(C2)|余额(N12.2)|可用余额(N12.2)|开户日期(C8)|帐户类型(C1)|开户行(C60)|冻结金额(N12.2)|存款金额(N12.2)|贷款金额(N12.2)|起息日(C8)|到期日(C8)|利率(N10)|错误信息(C60)|成功标志(C1)|
N
成功标志:
●0:
成功
●其它失败
字段数
Int
N
记录数
Int
N
文件标志
C1
N
●1-文件
●0-非文件
文件名
C20
2.2.3银行主动通知
银行主动通知(012102)
数据格式
XML
继承接口
请求包
字段名(包括路径)
字段中文名
类型
取值范围
为空
说明
接收消息IP端口
Ip|port|
交易序号
N9
通知类型
C4
N
4:
帐户变动
5:
交易结果
通知日期
C8
N
通知时间
C6
N
企业代码
C13
交易日期
C8
N
交易经办员
C4
交易流水号
C8
业务编号
C16
信用证号
C16
到单通知处理标志
C1
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 保证金 银行 接口 说明