保证金存管银行接口说明金融证券期货_金融证券-财经资料.pdf

《保证金存管银行接口说明金融证券期货_金融证券-财经资料.pdf》由会员分享，可在线阅读，更多相关《保证金存管银行接口说明金融证券期货_金融证券-财经资料.pdf（10页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、 保证金存管银行接口 中国金融期货交易所 说明 China Financial Futures Exchange 2006年9月 目录 第 1 章 报文格式 .3 1.1 XML 约定.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.2.3 银行主动通知.8业凭证号关于行号数字签名和加密返回结果第章交易报文定义交易报文头定义请求报文头应答报文头交易报体定义期货交易所批量转账交易期货交易所帐户信息查询银行主动通知第章报文格式期货资金系统的标准报文结构为位报头报文长度为字节则报头应写报文约定交易报文为格式包括数据报和文件都不包含头部的声明即除非有特别的说明否则所有报文的最上层节点名都为格式为报头报体接口中字段名即对应了元素的标记名包含了相对于根的路径名在数据本文档中的字段次序描述对于多域串即以或作为每个字段结束符的字符串以下简称或格式化字符串字段次序必严格与本文档中的字段次序描述保持一致字段类型字段类型分为以下三类字段允

3、许为任何可见字符包括数字和中文在中表第 1 章报文格式 期货资金系统的标准报文结构为：7位报头+数据报;1位（标志 6位（报文长度，不包括7位报头 XMLB 文 位）长度）左对齐，右补空格 标志位说明：0-报文不加密；报文加密。举例说明：若XML交易报文长度为828字节，则报头应写：0828+XMI报文 1.1 XML 约定 交易报文为XML格式，XML（包括XML数据报和XML文件）都不包含头部的 XML声明（即v?xml version=1.0?）;除非有特别的说明，否则所有 XML报文 的最上层节点名都为,格式为：报头 v/head 报体 接口中字段名即对应了元素的标记名（包含了相对于根

4、的路径名）；在XML数据报中所有元素的数据都不采用属性，而一律用字符数据的文本块 来表示。1.2 字段次序 对于XML同一层的字段次序可以不参照本文档中的字段次序描述；对于多域串（即以|或作为每个字段结束符的字符串，以下简称MFS 或格式化字符串，字段次序必须严格与本文档中的字段次序描述保持一致。业凭证号关于行号数字签名和加密返回结果第章交易报文定义交易报文头定义请求报文头应答报文头交易报体定义期货交易所批量转账交易期货交易所帐户信息查询银行主动通知第章报文格式期货资金系统的标准报文结构为位报头报文长度为字节则报头应写报文约定交易报文为格式包括数据报和文件都不包含头部的声明即除非有特别的说明否

5、则所有报文的最上层节点名都为格式为报头报体接口中字段名即对应了元素的标记名包含了相对于根的路径名在数据本文档中的字段次序描述对于多域串即以或作为每个字段结束符的字符串以下简称或格式化字符串字段次序必严格与本文档中的字段次序描述保持一致字段类型字段类型分为以下三类字段允许为任何可见字符包括数字和中文在中表1.3 字段类型 字段类型分为以下三类：Cn：字段允许为任何可见字符（包括数字和中文），n在XML中表示 有效数据的最大总长度，如果有效数据长度不足 n 位，则取实际位 数；在格式化字符串中表示固定的长度，如果有效数据长度不足 n 位，则有效数据左对齐，右边用空格补足至 n 位；Nn：字段内容只

6、允许为0-9数字，n在XML中表示有效数据的最大总 长度；Nm.n：基本上与Nn类型类似，0-9数字和小数点，其中m表示小数 点前面数据的最大总长度，n表示小数位数，通常用来表示发生额、余额等金额类字段，如 N12.2 表示销售点前面有 12位数据，小数点 后保留 2 位的字段。说明：金额字段严格按带两位小数的格式，不带符号，如：14.23。1.4 多域串 多域串用于企业银行内部各子系统之间返回多条记录，简写为MFS，多域 串采用固定分隔符，对于本系统而言，分隔符一般采用|，通知消息接口中 的数据域一般采用/。1.5 发起方序号、企业凭证号 发起方序号：由企业方产生，包含在所有交易的报文中。企

7、业凭证号：由企业方产生，仅包含在金融转账交易的报文中，作 为企业方的金融交易流水号，银行方记录该凭证号并检验其唯一性。1.6 关于行号 报文中必须包含行号，用来识别不同商业银行 1.7 数字签名和加密 数字签名和加密均在前置中完成 1.8 返回结果 判断应答报中的成功标志,0：表示成功,其它表示失败；返回附加码（particular_code）和返回附加信息（particularnfo）是对返回 信息的详业凭证号关于行号数字签名和加密返回结果第章交易报文定义交易报文头定义请求报文头应答报文头交易报体定义期货交易所批量转账交易期货交易所帐户信息查询银行主动通知第章报文格式期货资金系统的标准报文结

8、构为位报头报文长度为字节则报头应写报文约定交易报文为格式包括数据报和文件都不包含头部的声明即除非有特别的说明否则所有报文的最上层节点名都为格式为报头报体接口中字段名即对应了元素的标记名包含了相对于根的路径名在数据本文档中的字段次序描述对于多域串即以或作为每个字段结束符的字符串以下简称或格式化字符串字段次序必严格与本文档中的字段次序描述保持一致字段类型字段类型分为以下三类字段允许为任何可见字符包括数字和中文在中表细说明。第 2 章交易报文定义 银行发起和交易所发起的请求用不同的交易码区分。2.1 交易报文头定义 2.1.1 请求报文头 请求公共报头 数据格式 XML 继承接口 请求公共报头 字段

9、名（包括路径）字段中文名 类型 取值范围 为空 说明/交易码 C6 N /企业代码 C13 N 由银行方提供/企业用户号 C4 N 由银行方提供/交易序号 N9 N 填零/发起方序号 C20 企业方产生/交易日期 N8 N /时间 N6 N /原子交易数 N8 N 填，1 /渠道标志 C1 N 填，1 /数字签名 C3072 /file name 上传文件名 C60 /原交易序号 N9 为空/保留字段 C1024 2.1.2 应答报文头 应答公共报头 数据格式 XML 继承接口 应答公共报头 字段名（包括路径）字段中文名 类型 取值范围 为空 说明 业凭证号关于行号数字签名和加密返回结果第章交

10、易报文定义交易报文头定义请求报文头应答报文头交易报体定义期货交易所批量转账交易期货交易所帐户信息查询银行主动通知第章报文格式期货资金系统的标准报文结构为位报头报文长度为字节则报头应写报文约定交易报文为格式包括数据报和文件都不包含头部的声明即除非有特别的说明否则所有报文的最上层节点名都为格式为报头报体接口中字段名即对应了元素的标记名包含了相对于根的路径名在数据本文档中的字段次序描述对于多域串即以或作为每个字段结束符的字符串以下简称或格式化字符串字段次序必严格与本文档中的字段次序描述保持一致字段类型字段类型分为以下三类字段允许为任何可见字符包括数字和中文在中表/v tr_code 交易码 C6 N

11、 /v corp_no 企业代码 C13 N /发起方序号 C20 原样返回/交易序号 N9 /应答流水号 N9 /下笔交易序号 N9 N /交易日期 N8 /时间 N6 /成功标志 C1 N 0-成功，其它失败/返回信息 C70 /vparticular_code 返回附加码 C4 4 位返回码/vparticular_info 返回附加详细 信息 C70 /原子交易数 N8 /保留字段 C1024 保留字段 2.2 交易报体定义 221 期货交易所批量转账交易 期货交易所批量转账交易（910101）数据格式 XML 继承接口 请求包 字段名（包括 路径）字段中 文含义 类 型 取值 范围

12、为 空 说明 vap/数据区 N 字段顺序：cert_no|pay_acno|pay_acname|pay_bank_no|Amt|rcv_acno|rcv_acname|rcv_bank_no|cur_code|Postscript|MemNo|remark|中文意义：凭证号|付款帐号|付款户名|付款行号|金额|收款帐号|收款户名|收款行号|币种|附言|会员|备注|vap/vbody/vfield_num 字段数 Int N vap/vbody/vrecord_num 记录数 Int N 期货交易所批量转账交易（910101）数据格式 xml 继承接口 应答包 业凭证号关于行号数字签名和加密

13、返回结果第章交易报文定义交易报文头定义请求报文头应答报文头交易报体定义期货交易所批量转账交易期货交易所帐户信息查询银行主动通知第章报文格式期货资金系统的标准报文结构为位报头报文长度为字节则报头应写报文约定交易报文为格式包括数据报和文件都不包含头部的声明即除非有特别的说明否则所有报文的最上层节点名都为格式为报头报体接口中字段名即对应了元素的标记名包含了相对于根的路径名在数据本文档中的字段次序描述对于多域串即以或作为每个字段结束符的字符串以下简称或格式化字符串字段次序必严格与本文档中的字段次序描述保持一致字段类型字段类型分为以下三类字段允许为任何可见字符包括数字和中文在中表字段名（包括路径）字段中

14、文名 类型 返回格式 为空 说明/v serial_record 凭证编号|成功标志|返回信息|扩展信息|N 成功标志：0:成功 8:交易结果未知 其它失败/vfield_num 字段数 Int N vap/vrecord_num 记录数 Int N 222 期货交易所帐户信息查询 期货交易所帐户信息查询（910100）数据格式 xml 继承接口 请求包 字段名（包括路径）字段中文名 类型 取值范围 为空 说明 多帐号查询/帐号 C32 N /币种 c2 N /行号 C12 N 期货交易所帐户信息查询（910100）数据格式 XML 继承接口 应答包 字段名（包括路径）字段中文名 类型 返回格

15、式 为空 说明 业凭证号关于行号数字签名和加密返回结果第章交易报文定义交易报文头定义请求报文头应答报文头交易报体定义期货交易所批量转账交易期货交易所帐户信息查询银行主动通知第章报文格式期货资金系统的标准报文结构为位报头报文长度为字节则报头应写报文约定交易报文为格式包括数据报和文件都不包含头部的声明即除非有特别的说明否则所有报文的最上层节点名都为格式为报头报体接口中字段名即对应了元素的标记名包含了相对于根的路径名在数据本文档中的字段次序描述对于多域串即以或作为每个字段结束符的字符串以下简称或格式化字符串字段次序必严格与本文档中的字段次序描述保持一致字段类型字段类型分为以下三类字段允许为任何可见字

16、符包括数字和中文在中表/户名(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-非文件/file name 文件名 C20 223 银行主动通知 银行主动通知(012102)数据格式 XML 继承接口 请求包 字段名(包括路径)字段中

17、文名 类型 取值 范围 为空 说明/接收消息 IP 端口 lp|port|/交易序号 N9 /通知类型 C4 N 4:帐户变动 5:交易结果/通知日期 C8 N /通知时间 C6 N /企业代码 C13 业凭证号关于行号数字签名和加密返回结果第章交易报文定义交易报文头定义请求报文头应答报文头交易报体定义期货交易所批量转账交易期货交易所帐户信息查询银行主动通知第章报文格式期货资金系统的标准报文结构为位报头报文长度为字节则报头应写报文约定交易报文为格式包括数据报和文件都不包含头部的声明即除非有特别的说明否则所有报文的最上层节点名都为格式为报头报体接口中字段名即对应了元素的标记名包含了相对于根的路径

18、名在数据本文档中的字段次序描述对于多域串即以或作为每个字段结束符的字符串以下简称或格式化字符串字段次序必严格与本文档中的字段次序描述保持一致字段类型字段类型分为以下三类字段允许为任何可见字符包括数字和中文在中表/交易日期 C8 N 业凭证号关于行号数字签名和加密返回结果第章交易报文定义交易报文头定义请求报文头应答报文头交易报体定义期货交易所批量转账交易期货交易所帐户信息查询银行主动通知第章报文格式期货资金系统的标准报文结构为位报头报文长度为字节则报头应写报文约定交易报文为格式包括数据报和文件都不包含头部的声明即除非有特别的说明否则所有报文的最上层节点名都为格式为报头报体接口中字段名即对应了元素

19、的标记名包含了相对于根的路径名在数据本文档中的字段次序描述对于多域串即以或作为每个字段结束符的字符串以下简称或格式化字符串字段次序必严格与本文档中的字段次序描述保持一致字段类型字段类型分为以下三类字段允许为任何可见字符包括数字和中文在中表/vtel_no 交易经办员 C4 /vseq_no 交易流水号 C8 vap/vbusi_no 业务编号 C16 vap/vlc_no 信用证号 C16 vap/vnotice_fla g 到单通知处理标志 C1 vap/vbody/vextend_fla g 扩展标志 C1 vap/vbody/vnotice_tex t 通知正文 N 通知正文格式说明 帐

20、户变动通知正文格式说明(/分隔):状态(cl)/联行行号(C12)/会计日期(c8)/柜员号(c4)/流水号(c6)/流水序号(N9)/余额(N12.2)/交易时间(C6)/账号(C32)/户名(C60)/收支标志(C1)/币种(C2)/金额(N14.2)/可用余额(N14.2)/业务名称(C20)/对方账号(C32)/对方户名(C60)/对方地址(C60)/对方行号(C12)/对方行名(C60)/票据种类(C2)/票据号码(C8)/票据名称(C60)/票据签发日期(C8)/附言(C60)/业凭证号关于行号数字签名和加密返回结果第章交易报文定义交易报文头定义请求报文头应答报文头交易报体定义期货交易所批量转账交易期货交易所帐户信息查询银行主动通知第章报文格式期货资金系统的标准报文结构为位报头报文长度为字节则报头应写报文约定交易报文为格式包括数据报和文件都不包含头部的声明即除非有特别的说明否则所有报文的最上层节点名都为格式为报头报体接口中字段名即对应了元素的标记名包含了相对于根的路径名在数据本文档中的字段次序描述对于多域串即以或作为每个字段结束符的字符串以下简称或格式化字符串字段次序必严格与本文档中的字段次序描述保持一致字段类型字段类型分为以下三类字段允许为任何可见字符包括数字和中文在中表