保证金存管银行接口说明

保证金存管银行接口说明2006年9月中国金融期货交易所技术文档保证金存管银行接口说明版权所有©中国金融期货交易所第II页目录第1章报文格式...........................................................31.1XML约定.............................................................31.2字段次序.............................................................31.3字段类型.............................................................41.4多域串...............................................................41.5发起方序号、企业凭证号...............................................41.6关于行号.............................................................41.7数字签名和加密.......................................................41.8返回结果.............................................................5第2章交易报文定义.......................................................52.1交易报文头定义.......................................................52.1.1请求报文头.......................................................52.1.2应答报文头.......................................................52.2交易报体定义.........................................................62.2.1期货交易所批量转账交易...........................................62.2.2期货交易所帐户信息查询...........................................72.2.3银行主动通知.....................................................8中国金融期货交易所技术文档保证金存管银行接口说明第1章报文格式期货资金系统的标准报文结构为：7位报头+数据报；1位(标志位)6位（报文长度，不包括7位报头长度）左对齐，右补空格XML报文标志位说明：0-报文不加密；报文加密。举例说明：若XML交易报文长度为828字节，则报头应写：0828+XML报文1.1XML约定交易报文为XML格式，XML（包括XML数据报和XML文件）都不包含头部的XML声明（即?xmlversion=1.0?）；除非有特别的说明，否则所有XML报文的最上层节点名都为ap,格式为：aphead报头/headbody报体/body/ap接口中字段名即对应了元素的标记名(包含了相对于根的路径名)；在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返回结果判断应答报中的成功标志ans_code，0：表示成功,其它表示失败；返回附加码（particular_code）和返回附加信息（particular_info）是对返回信息的详细说明。第2章交易报文定义银行发起和交易所发起的请求用不同的交易码区分。2.1交易报文头定义2.1.1请求报文头请求公共报头数据格式XML继承接口请求公共报头字段名（包括路径）字段中文名类型取值范围为空说明ap/head/tr_code交易码C6Nap/head/corp_no企业代码C13N由银行方提供ap/head/user_no企业用户号C4N由银行方提供ap/head/serial_no交易序号N9N填零ap/head/req_no发起方序号C20企业方产生ap/head/tr_acdt交易日期N8Nap/head/tr_time时间N6Nap/head/atom_tr_count原子交易数N8N填’1’ap/head/channel渠道标志C1N填’1’ap/head/sign数字签名C3072ap/head/filename上传文件名C60ap/head/ogl_serial_no原交易序号N9为空ap/head/reserved保留字段C10242.1.2应答报文头应答公共报头数据格式XML继承接口应答公共报头字段名（包括路径）字段中文名类型取值范围为空说明中国金融期货交易所技术文档保证金存管银行接口说明ap/head/tr_code交易码C6Nap/head/corp_no企业代码C13Nap/head/req_no发起方序号C20原样返回ap/head/serial_no交易序号N9ap/head/ans_no应答流水号N9ap/head/next_no下笔交易序号N9Nap/head/tr_acdt交易日期N8ap/head/tr_time时间N6ap/head/ans_code成功标志C1N0-成功，其它失败ap/head/ans_info返回信息C70ap/head/particular_code返回附加码C44位返回码ap/head/particular_info返回附加详细信息C70ap/head/atom_tr_count原子交易数N8ap/head/reserved保留字段C1024保留字段2.2交易报体定义2.2.1期货交易所批量转账交易期货交易所批量转账交易（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字段数IntNap/body/record_num记录数IntN期货交易所批量转账交易（910101）数据格式xml继承接口应答包中国金融期货交易所技术文档保证金存管银行接口说明字段名（包括路径）字段中文名类型返回格式为空说明ap/body/serial_record凭证编号|成功标志|返回信息|扩展信息|N成功标志：0：成功8:交易结果未知其它失败ap/body/field_num字段数IntNap/body/record_num记录数IntN2.2.2期货交易所帐户信息查询期货交易所帐户信息查询（910100）数据格式xml继承接口请求包字段名（包括路径）字段中文名类型取值范围为空说明多帐号查询ap/body/acno帐号C32Nap/body/cur_code币种c2Nap/body/bank_no行号C12N期货交易所帐户信息查询（910100）数据格式XML继承接口应答包字段名（包括路径）字段中文名类型返回格式为空说明中国金融期货交易所技术文档保证金存管银行接口说明2.2.3银行主动通知银行主动通知（012102）数据格式XML继承接口请求包字段名（包括路径）字段中文名类型取值范围为空说明ap/body/msg_des接收消息IP端口Ip|port|ap/body/serial_no交易序号N9ap/body/busi_phase通知类型C4N4:帐户变动5:交易结果ap/body/advice_date通知日期C8Nap/body/advice_time通知时间C6Nap/body/corp_no企业代码C13ap/body/org_date交易日期C8Nap/body/serial_record户名(C60)|帐号(C32)|币种(C2)|余额(N12.2)|可用余额(N12.2)|开户日期(C8)|帐户类型(C1)|开户行(C60)|冻结金额(N12.2)|存款金额(N12.2)|贷款金额(N12.2)|起息日(C8)|到期日(C8)|利率(N10)|错误信息(C60)|成功标志(C1)|N成功标志：0：成功其它失败ap/body/field_num字段数IntNap/body/record_num记录数IntNap/body/file_flag文件标志C1N1-文件0-非文件ap/body/filename文件名C20中国金融期货交易所技术文档保证金存管银行接口说明ap/body/tel_no交易经办员C4ap/body/seq_no交易流水号C8ap/body/busi_no业务编号C16ap/body/lc_no信用证号C16ap/body/notice_flag到单通知处理标志C1ap/body/extend_flag扩展标志C1ap