保证金存管银行接口
说明
2006 年 9 月
目录
第 1 章 报文格式............................................................................................................................3
XML 约定..........................................................................................................................3
字段次序............................................................................................................................3
字段类型............................................................................................................................4
多域串................................................................................................................................4
发起方序号、企业凭证号................................................................................................4
关于行号............................................................................................................................4
数字签名和加密................................................................................................................4
返回结果............................................................................................................................5
第 2 章 交易报文定义....................................................................................................................5
交易报文头定义................................................................................................................5
请求报文头................................................................................................................5
应答报文头................................................................................................................5
交易报体定义....................................................................................................................6
期货交易所批量转账交易........................................................................................6
期货交易所帐户信息查询........................................................................................7
银行主动通知............................................................................................................8
第1章 报文格式
期货资金系统的标准报文结构为：7 位报头+数据报；
1 位(标志位) 6 位（报文长度，不包括 7 位报头
长度）
左对齐，右补空格
XML 报文
标志位说明：
0- 报文不加密；报文加密。
举例说明：若 XML 交易报文长度为 828 字节，则报头应写：0828+XML 报
文
XML 约定
交易报文为 XML 格式，XML（包括 XML 数据报和 XML 文件）都不包含
头部的 XML 声明（即<?xml version=""?>）；除非有特别的说明，否则所有
XML 报文的最上层节点名都为<ap>,格式为：
<ap>
<head>
报头
</head>
<body>
报体
</body>
</ap>
接口中字段名即对应了元素的标记名(包含了相对于根的路径名)；
在 XML 数据报中所有元素的数据都不采用属性，而一律用字符数据的文本
块来表示。
字段次序
对于 XML，同一层的字段次序可以不参照本文档中的字段次序描述；
对于多域串（即以’|’或‘\’作为每个字段结束符的字符串，以下简称 MFS）或
格式化字符串，字段次序必须严格与本文档中的字段次序描述保持一致。
字段类型
字段类型分为以下三类：
Cn：字段允许为任何可见字符（包括数字和中文），n 在 XML 中表
示有效数据的最大总长度，如果有效数据长度不足 n 位，则取实际
位数；在格式化字符串中表示固定的长度，如果有效数据长度不足 n
位，则有效数据左对齐，右边用空格补足至 n 位；
Nn：字段内容只允许为 0-9 数字，n 在 XML 中表示有效数据的最大
总长度；
：基本上与 Nn 类型类似，0-9 数字和小数点，其中 m 表示小数
点前面数据的最大总长度，n 表示小数位数，通常用来表示发生额、
余额等金额类字段，如 表示销售点前面有 12 位数据，小数点
后保留 2 位的字段。
说明：金额字段严格按带两位小数的格式，不带符号，如：。
多域串
多域串用于企业银行内部各子系统之间返回多条记录，简写为 MFS，多域
串采用固定分隔符，对于本系统而言，分隔符一般采用‘|’，通知消息接口中的
数据域一般采用‘/’。
发起方序号、企业凭证号
发起方序号：由企业方产生，包含在所有交易的报文中。
企业凭证号：由企业方产生，仅包含在金融转账交易的报文中，作
为企业方的金融交易流水号，银行方记录该凭证号并检验其唯一性。
关于行号
报文中必须包含行号，用来识别不同商业银行。
数字签名和加密
数字签名和加密均在前置中完成。
返回结果
判断应答报中的成功标志<ans_code> ，0：表示成功, 其它表示失败；
返回附加码（particular_code）和返回附加信息（particular_info）是对返回
信息的详细说明。
第2章 交易报文定义
银行发起和交易所发起的请求用不同的交易码区分。
交易报文头定义
请求报文头
请求公共报头
数据格式 XML 继承接口 请求公共报头
字段名（包括路径） 字段中文名 类型 取值范围 为空 说明
<ap>/<head>/< tr_code> 交易码 C6 N
<ap>/<head>/<corp_no> 企业代码 C13 N 由银行方提供
<ap>/<head>/< user_no > 企业用户号 C4 N 由银行方提供
<ap>/<head>/<serial_no> 交易序号 N9 N 填零
<ap>/<head>/<req_no> 发起方序号 C20 企业方产生
<ap>/<head>/<tr_acdt> 交易日期 N8 N
<ap>/<head>/<tr_time> 时间 N6 N
<ap>/<head>/<atom_tr_count> 原子交易数 N8 N 填’1’
<ap>/<head>/<channel> 渠道标志 C1 N 填’1’
<ap>/<head>/<sign> 数字签名 C3072
<ap>/<head>/<filename> 上传文件名 C60
<ap>/<head>/<ogl_serial_no > 原交易序号 N9 为空
<ap>/<head>/<reserved> 保留字段 C1024
应答报文头
应答公共报头
数据格式 XML 继承接口 应答公共报头
字段名（包括路径） 字段中文名 类型 取值范围 为空 说明
<ap>/<head>/< tr_code > 交易码 C6 N
<ap>/<head>/< corp_no> 企业代码 C13 N
<ap>/<head>/<req_no> 发起方序号 C20 原样返回
<ap>/<head>/<serial_no > 交易序号 N9
<ap>/<head>/<ans_no > 应答流水号 N9
<ap>/<head>/<next_no > 下笔交易序号 N9 N
<ap>/<head>/<tr_acdt> 交易日期 N8
<ap>/<head>/<tr_time> 时间 N6
<ap>/<head>/<ans_code > 成功标志 C1 N 0-成功，其它失败
<ap>/<head>/<ans_info> 返回信息 C70
<ap>/<head>/<particular_code > 返回附加码 C4 4 位返回码
<ap>/<head>/<particular_info >
返回附加详细
信息
C70
<ap>/<head>/<atom_tr_count> 原子交易数 N8
<ap>/<head>/<reserved> 保留字段 C1024 保留字段
交易报体定义
期货交易所批量转账交易
期货交易所批量转账交易（910101）
数据格式 XML 继承接口 请求包
字段名（包括
路径）
字段中
文含义
类
型
取值
范围
为
空
说明
<ap>/<body>/
< RespPrvData>
数据区 N
字段顺序：
cert_no|pay_acno|pay_acname|pay_bank_no|Amt|
rcv_acno|rcv_acname|rcv_bank_no|cur_code|
Postscript|MemNo|remark|
中文意义：
凭证号|付款帐号|付款户名|付款行号|金额|收款帐号|收
款户名|收款行号|币种|附言|会员|备注|
<ap>/<body>/
<field_num>
字段数 Int N
<ap>/<body>/
<record_num >
记录数 Int N
期货交易所批量转账交易（910101）
数据格式 xml 继承接口 应答包
字段名（包括路径） 字段中文名 类型 返回格式 为空 说明
<ap>/<body>/< serial_record >
凭证编号|成功标志|
返回信息|扩展信息|
N
成功标志：
0：成功
8:交易结果未知
其它失败
<ap>/<body>/<field_num> 字段数 Int N
<ap>/<body>/<record_num > 记录数 Int N
期货交易所帐户信息查询
期货交易所帐户信息查询（910100）
数据格式 xml 继承接口 请求包
字段名（包括路径） 字段中文名 类型 取值范围 为空 说明
多帐号查询
<ap>/<body>/< acno> 帐号 C32 N
<ap>/<body>/<cur_code> 币种 c2 N
<ap>/<body>/<bank_no> 行号 C12 N
期货交易所帐户信息查询（910100）
数据格式 XML 继承接口 应答包
字段名（包括路径） 字段中文名 类型 返回格式 为空 说明
银行主动通知
银行主动通知（012102）
数据格式 XML 继承接口 请求包
字段名（包括路径） 字段中文名 类型
取值
范围
为空 说明
<ap>/<body>/< msg_des> 接收消息 IP 端口 Ip|port|
<ap>/<body>/<serial_no> 交易序号 N9
<ap>/<body>/<busi_phase> 通知类型 C4 N
4:帐户变动
5:交易结果
<ap>/<body>/<advice_date> 通知日期 C8 N
<ap>/<body>/<advice_time
>
通知时间 C6 N
<ap>/<body>/<corp_no> 企业代码 C13
<ap>/<body>/<org_date> 交易日期 C8 N
<ap>/<body>/< serial_record >
户 名 (C60)| 帐 号
(C32)|币种(C2)|余
额 ()|可用余
额 ()|开户日
期 (C8)| 帐 户 类 型
(C1)|开户行(C60)|
冻结金额 ()|
存款金额 ()|
贷款金额 ()|
起 息 日 (C8)| 到 期
日(C8)|利率(N10)|
错误信息(C60)| 成
功标志(C1)|
N
成功标志：
0：成功
其它失败
<ap>/<body>/<field_num> 字段数 Int N
<ap>/<body>/<record_num > 记录数 Int N
<ap>/<body>/<file_flag> 文件标志 C1 N
1-文件
0-非文件
<ap>/<body>/<filename> 文件名 C20
<ap>/<body>/<tel_no> 交易经办员 C4
<ap>/<body>/<seq_no> 交易流水号 C8
<ap>/<body>/<busi_no> 业务编号 C16
<ap>/<body>/<lc_no> 信用证号 C16
<ap>/<body>/<notice_flag> 到单通知处理标志 C1
<ap>/<body>/<extend_flag> 扩展标志 C1
<ap>/<body>/<notice_text> 通知正文 N
通知正文格式说明
帐户变动通知正文格式说明(/分隔):
状态(c1)/联行行号(c12)/会计日期(c8)/柜员号(c4)/流水号(c6)/流水序号(N9)
/余额()/ 交易时间(C6)/账号(c32)/户名(C60)/收支标志(C1)/币种(C2)
/金额()/可用余额()/业务名称(C20)/对方账号(C32)/ 对方户名(C60)/对方地址(C60)/对方行号(C12)/对
方行名(C60)/ 票据种类(C2)/票据号码(C8)/票据名称(C60)/ 票据签发日期(C8)/附言(C60)/
