中国金融期货交易所技术文档保证金存管银行接口说明保证金存管银行接口说明“中国金融期货交易所户 China Financial Futures Exchange2006年9月目录第1章报文格式 31.1XML约定31.2字段次序 . 31.3字段类型 . 41.4多域串 . 41.5发起方序号、企业凭证号 . . 41.6关于行号 . 41.7数字签名和加密 . 51.8返回结果 . 5第2章交易报文定义 52.1交易报文头定义 . 52.1/-J -J |xS-丿丿、Z 7 i /.1 请求报文头 . 52.1.2 应答报文头 . 62.2交易报体定义 . 62.2.12.2.22.2.3期货交易所批量转账交易 期货交易所帐户信息查询 银行主动通知 . 版权所有?中国金融期货交易所第 II 页第1章报文格式期货资金系统的标准报文结构为：7位报头+数据报;1位（标志6位（报文长度，不包括7位报头xmlB 文位）长度）左对齐，右补空格标志位说明:0-报文不加密；报文加密。举例说明：若XML交易报文长度为828字节，则报头应写：0828+XMILB文1.1 XML约定交易报文为XML格式，XML（包括XML数据报和XML文件）都不包含头部的XML声明（即v?xml version= 1.0?）;除非有特别的说明，否则所有 XMLK文 的最上层节点名都为vap,格式为：vap报头报体v/body v/ap接口中字段名即对应了元素的标记名（包含了相对于根的路径名）；在XML数据报中所有元素的数据都不采用属性， 而一律用字符数据的文本块 来表示。1.2字段次序对于XML同一层的字段次序可以不参照本文档中的字段次序描述;对于多域串（即以I或作为每个字段结束符的字符串，以下简称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。简写为MFS，多域 通知消息接口中1.4多域串多域串用于企业银行内部各子系统之间返回多条记录, 串米用固定分隔符，对于本系统而言，分隔符一般米用 的数据域一般采用 /1.5发起方序号、企业凭证号发起方序号：由企业方产生，包含在所有交易的报文中。企业凭证号：由企业方产生，仅包含在金融转账交易的报文中，作 为企业方的金融交易流水号，银行方记录该凭证号并检验其唯一性。1.6关于行号报文中必须包含行号，用来识别不同商业银行。号,1.7数字签名和加密数字签名和加密均在前置中完成。1.8返回结果判断应答报中的成功标志vans_code，0:表示成功,其它表示失败;返回附加码（Particular_code）和返回附加信息（particularnfo）是对返回 信息的详细说明。第2章交易报文定义银行发起和交易所发起的请求用不同的交易码区分。2.1交易报文头定义2.1.1请求报文头请求公共报头数据格式XML继承接口请求公共报头字段名（包括路径）字段中文名类型取值范围为空说明/交易码C6N/企业代码C13N由银行方提供/企业用户号C4N由银行方提供/交易序号N9N填零/发起方序号C20企业方产生/交易日期N8N/时间N6N/原子交易数N8N填，1/渠道标志C1N填，1/数字签名C3072/file name上传文件名C60/原交易序号N9为空/保留字段C10242.1.2应答报文头应答公共报头数据格式XML继承接口应答公共报头字段名（包括路径）字段中文名类型取值范围为空说明vap/vhead/v tr_code 交易码C6Nvap/vhead/v corp_no企业代码C13Nvap/vhead/v req_no发起方序号C20原样返回vap/vhead/v serial_no 交易序号N9vap/vhead/vans_no 应答流水号N9vap/vhead/vnext_no 下笔交易序号N9Nvap/vhead/v tr_acdt交易日期N8vap/vhead/v tr_time时间N6vap/vhead/vans_code 成功标志C1N0-成功，其它失败vap/vhead/vans_info返回信息C70vap/vhead/vp articular_code 返回附加码C44位返回码vap/vhead/vp articular_info 返回附加详细信息C70vap/vhead/vatom_tr_count原子交易数N8vap/vhead/v reserved保留字段C1024保留字段2.2交易报体定义2.2.1期货交易所批量转账交易期货交易所批量转账交易（910101）数据格式XML继承接口请求包字段名（包括 路径）字段中 文含义类 型取值 范围为空说明vap /vbody/v Res pP rvData数据区N字段顺序：cert_ no|p ay_acn o|p ay_acname |p ay_bank_no|Amt| rcv_acno|rcv_acname|rcv_bank_no|cur_code|Po stscri pt|MemNo|remark|中文意义：凭证号|付款帐号|付款户名|付款行号|金额|收款帐号| 收款户名|收款行号|币种|附言|会员|备注|vap /vbody/ vfield_num字段数IntNvap /vbody/记录数IntNvrecord_num 期货交易所批量转账交易（910101）数据格式xml继承接口应答包字段名（包括路径）字段中文名类型返回格式为空说明vap/vbody/v senal_record 凭证编号1成功标志1 返回信息|扩展信息1N成功标志：0:成功8:交易结果未知其它失败vap /vbody/vfield_num字段数IntNvap /vbody/vrecord_num 记录数IntN2.2.2期货交易所帐户信息查询期货交易所帐户信息查询（910100）数据格式xml继承接口请求包字段名（包括路径）字段中文名类型取值范围为空说明多帐号查询vap/vbody/v acno帐号C32Nvap /vbody/vcur_code币种c2Nvap /vbody/vbank_no行号C12N期货交易所帐户信息查询（910100）数据格式XML继承接口应答包字段名（包括路径）字段中文名类型返回格式为空1说明/接收消息IP端口lp|port|vap/交易序号N9vap/通知类型C4N4:帐户变动5:交易结果vap/通知日期C8Nvap/advi