保证金存管银行接口说明.doc

保证金存管银行接口保证金存管银行接口 说明说明 2006 年年 9 月月 目录目录 第第 1 1 章章报文格式报文格式 3 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 2 章章交易报文定义交易报文定义 5 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 报文 标志位说明 0 报文不加密 报文加密 举例说明 若 XML 交易报文长度为 828 字节 则报头应写 0828 XML 报文 1 1 XML 约定约定 交易报文为 XML 格式 XML 包括 XML 数据报和 XML 文件 都不包含头部的 XML 声明 即 除非有特别的说明 否则所有 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 返回结果返回结果 判断应答报中的成功标志 0 表示成功 其它表示失败 返回附加码 particular code 和返回附加信息 particular info 是对返 回信息的详细说明 第第 2 章章 交易报文定义交易报文定义 银行发起和交易所发起的请求用不同的交易码区分 2 1 交易报文头定义交易报文头定义 2 1 1 请求报文头请求报文头 请求公共报头请求公共报头 数据格式数据格式XML继承接口继承接口请求公共报头请求公共报头 字段名 包括路径 字段名 包括路径 字段中文名字段中文名类型类型取值范围取值范围为空为空说明说明 交易码 C6N 企业代码 C13N 由银行方提供 企业用户号 C4N 由银行方提供 交易序号 N9N 填零 发起方序号 C20 企业方产生 交易日期 N8N 时间 N6N 原子交易数 N8N 填 1 渠道标志 C1N 填 1 数字签名 C3072 上传文件名 C60 原交易序号 N9 为空 保留字段 C1024 2 1 2 应答报文头应答报文头 应答公共报头应答公共报头 数据格式数据格式XML继承接口继承接口应答公共报头应答公共报头 字段名 包括路径 字段名 包括路径 字段中文名字段中文名类型类型取值范围取值范围为空为空说明说明 交易码 C6N 企业代码 C13N 发起方序号 C20 原样返回 交易序号 N9 应答流水号 N9 下笔交易序号 N9N 交易日期 N8 时间 N6 成功标志 C1N 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 中文意义 凭证号 付款帐号 付款户名 付款行号 金额 收款帐号 收款户名 收款行号 币种 附言 会员 备注 字段数 IntN 记录数 IntN 期货交易所批量转账交易 期货交易所批量转账交易 910101 数据格式数据格式xml继承接口继承接口应答包应答包 字段名 包括路径 字段名 包括路径 字段中文名字段中文名类型类型返回格式返回格式为空为空说明说明 凭证编号 成功标志 返回信息 扩展信息 N 成功标志 0 成功 8 交易结果未知 其它失败 字段数 IntN 记录数 IntN 2 2 2 期货交易所帐户信息查询期货交易所帐户信息查询 期货交易所帐户信息查询 期货交易所帐户信息查询 910100 数据格式数据格式xml继承接口继承接口请求包请求包 字段名 包括路径 字段名 包括路径 字段中文名字段中文名类型类型取值范围取值范围为空为空说明说明 多帐号查询 帐号 C32N 币种 c2 N 行号 C12N 期货交易所帐户信息查询 期货交易所帐户信息查询 910100 数据格式数据格式XML继承接口继承接口 应答包应答包 字段名 包括路径 字段名 包括路径 字段中文名字段中文名类型类型返回格式返回格式为空为空 说明说明 2 2 3 银行主动通知银行主动通知 银行主动通知 银行主动通知 012102 数据格式数据格式XML继承接口继承接口请求包请求包 字段名 包括路径 字段名 包括路径 字段中文名字段中文名类型类型 取值取值 范围范围 为空为空说明说明 接收消息 IP 端口 Ip port 交易序号 N9 通知类型 C4N 4 帐户变动 5 交易结果 通知日期 C8N 通知时间 C6N 企业代码 C13 交易日期 C8N 户名 C60 帐号 C32 币种 C2 余 额 N12 2 可用余 额 N12 2 开户日 期 C8 帐户类型 C1 开户行 C60 冻结金额 N12 2 存款金额 N12 2 贷款金额 N12 2 起息日 C8 到期 日 C8 利率 N10 错误信息 C60 成功标志 C1 N 成功标志 0 成功 其它失败 字段数 IntN 记录数 IntN 文件标志 C1N 1 文件 0 非文件 文件名 C20 交易经办员 C4 交易流水号 C8 业务编号 C16 信用证号 C16 到单通知处理标志 C1 扩展标志 C1 通知正文 N 通知正文格式说明通知正文格式说明 帐户变动通知正文格式说明帐户变动通知正文格式说明 分隔分隔 状态 c1 联行行号 c12 会计日期 c8 柜员号 c