保證金存管銀行接口說明

1、保證金存管銀行接口說明保證金存管銀行接口說明保證金存管銀行接口說明 保證金存管銀行接口說明2006年9月版權所有中國金融期貨交易所 第 PAGE II頁 目錄 TOC o 1-3 h z u HYPERLINK l _Toc161556780 第1章報文格式 PAGEREF _Toc161556780 h 3 HYPERLINK l _Toc161556781 1.1XML約定 PAGEREF _Toc161556781 h 3 HYPERLINK l _Toc161556782 1.2字段次序 PAGEREF _Toc161556782 h 3 HYPERLINK l _Toc1615567

2、83 1.3字段類型 PAGEREF _Toc161556783 h 4 HYPERLINK l _Toc161556784 1.4多域串 PAGEREF _Toc161556784 h 4 HYPERLINK l _Toc161556785 1.5發(fā)起方序號、企業(yè)憑證號 PAGEREF _Toc161556785 h 4 HYPERLINK l _Toc161556786 1.6關于行號 PAGEREF _Toc161556786 h 4 HYPERLINK l _Toc161556787 1.7數(shù)字簽名和加密 PAGEREF _Toc161556787 h 4 HYPERLINK l _T

3、oc161556788 1.8返回結果 PAGEREF _Toc161556788 h 5 HYPERLINK l _Toc161556789 第2章交易報文定義 PAGEREF _Toc161556789 h 5 HYPERLINK l _Toc161556790 2.1交易報文頭定義 PAGEREF _Toc161556790 h 5 HYPERLINK l _Toc161556791 2.1.1請求報文頭 PAGEREF _Toc161556791 h 5 HYPERLINK l _Toc161556792 2.1.2應答報文頭 PAGEREF _Toc161556792 h 5 HYP

4、ERLINK l _Toc161556793 2.2交易報體定義 PAGEREF _Toc161556793 h 6 HYPERLINK l _Toc161556794 2.2.1期貨交易所批量轉賬交易 PAGEREF _Toc161556794 h 6 HYPERLINK l _Toc161556795 2.2.2期貨交易所帳戶信息查詢 PAGEREF _Toc161556795 h 7 HYPERLINK l _Toc161556796 2.2.3銀行主動通知 PAGEREF _Toc161556796 h 8報文格式期貨資金系統(tǒng)的標準報文結構為：7位報頭+數(shù)據(jù)報；1位(標志位)6位（報文

5、長度，不包括7位報頭長度）左對齊，右補空格XML報文標志位說明：報文不加密；報文加密。舉例說明：若XML交易報文長度為828字節(jié)，則報頭應寫：0828+XML報文XML約定交易報文為XML格式，XML（包括XML數(shù)據(jù)報和XML文件）都不包含頭部的XML聲明（即）；除非有特別的說明，否則所有XML報文的最上層節(jié)點名都為,格式為： 報頭 報體 接口中字段名即對應了元素的標記名(包含了相對于根的路徑名)；在XML數(shù)據(jù)報中所有元素的數(shù)據(jù)都不采用屬性，而一律用字符數(shù)據(jù)的文本塊來表示。字段次序對于XML，同一層的字段次序可以不參照本文檔中的字段次序描述；對于多域串（即以|或作為每個字段結束符的字符串，以下

6、簡稱MFS）或格式化字符串，字段次序必須嚴格與本文檔中的字段次序描述保持一致。字段類型字段類型分為以下三類：Cn：字段允許為任何可見字符（包括數(shù)字和中文），n在XML中表示有效數(shù)據(jù)的最大總長度，如果有效數(shù)據(jù)長度不足n位，則取實際位數(shù)；在格式化字符串中表示固定的長度，如果有效數(shù)據(jù)長度不足n位，則有效數(shù)據(jù)左對齊，右邊用空格補足至n位；Nn：字段內(nèi)容只允許為0-9數(shù)字，n在XML中表示有效數(shù)據(jù)的最大總長度；Nm.n：基本上與Nn類型類似，0-9數(shù)字和小數(shù)點，其中m表示小數(shù)點前面數(shù)據(jù)的最大總長度，n表示小數(shù)位數(shù)，通常用來表示發(fā)生額、余額等金額類字段，如N12.2表示銷售點前面有12位數(shù)據(jù)，小數(shù)點后保留

7、2位的字段。說明：金額字段嚴格按帶兩位小數(shù)的格式，不帶符號，如：14.23。多域串多域串用于企業(yè)銀行內(nèi)部各子系統(tǒng)之間返回多條記錄，簡寫為MFS，多域串采用固定分隔符，對于本系統(tǒng)而言，分隔符一般采用|，通知消息接口中的數(shù)據(jù)域一般采用/。發(fā)起方序號、企業(yè)憑證號發(fā)起方序號：由企業(yè)方產(chǎn)生，包含在所有交易的報文中。企業(yè)憑證號：由企業(yè)方產(chǎn)生，僅包含在金融轉賬交易的報文中，作為企業(yè)方的金融交易流水號，銀行方記錄該憑證號并檢驗其唯一性。關于行號報文中必須包含行號，用來識別不同商業(yè)銀行。數(shù)字簽名和加密數(shù)字簽名和加密均在前置中完成。返回結果判斷應答報中的成功標志 ，0：表示成功, 其它表示失??；返回附加碼（par

8、ticular_code）和返回附加信息（particular_info）是對返回信息的詳細說明。交易報文定義銀行發(fā)起和交易所發(fā)起的請求用不同的交易碼區(qū)分。交易報文頭定義請求報文頭請求公共報頭數(shù)據(jù)格式XML繼承接口請求公共報頭字段名（包括路徑）字段中文名類型取值范圍為空說明/交易碼C6N/企業(yè)代碼C13N由銀行方提供/企業(yè)用戶號C4N由銀行方提供/交易序號N9N填零/發(fā)起方序號C20企業(yè)方產(chǎn)生/交易日期N8N/時間N6N/原子交易數(shù)N8N填1/渠道標志C1N填1/數(shù)字簽名C3072/上傳文件名C60/原交易序號N9為空/保留字段C1024應答報文頭應答公共報頭數(shù)據(jù)格式XML繼承接口應答公共報頭

9、字段名（包括路徑）字段中文名類型取值范圍為空說明/交易碼C6N/企業(yè)代碼C13N/發(fā)起方序號C20原樣返回/交易序號N9/應答流水號N9/下筆交易序號N9N/交易日期N8/時間N6/成功標志C1N0-成功，其它失敗/返回信息C70/返回附加碼C44位返回碼/返回附加詳細信息C70/原子交易數(shù)N8/保留字段C1024保留字段交易報體定義期貨交易所批量轉賬交易期貨交易所批量轉賬交易（910101）數(shù)據(jù)格式XML繼承接口請求包字段名（包括路徑）字段中文含義類型取值范圍為空說明/數(shù)據(jù)區(qū)N字段順序：cert_no|pay_acno|pay_acname|pay_bank_no|Amt|rcv_acno|

10、rcv_acname|rcv_bank_no|cur_code|Postscript|MemNo|remark|中文意義：憑證號|付款帳號|付款戶名|付款行號|金額|收款帳號|收款戶名|收款行號|幣種|附言|會員|備注|/字段數(shù)IntN/記錄數(shù)IntN期貨交易所批量轉賬交易（910101）數(shù)據(jù)格式xml繼承接口應答包字段名（包括路徑）字段中文名類型返回格式為空說明/憑證編號|成功標志|返回信息|擴展信息|N成功標志：0：成功8:交易結果未知其它失敗/字段數(shù)IntN/記錄數(shù)IntN期貨交易所帳戶信息查詢期貨交易所帳戶信息查詢（910100）數(shù)據(jù)格式xml繼承接口請求包字段名（包括路徑）字段中文名

11、類型取值范圍為空說明多帳號查詢/帳號C32N/幣種 c2N/行號C12N期貨交易所帳戶信息查詢（910100）數(shù)據(jù)格式XML繼承接口應答包字段名（包括路徑）字段中文名類型返回格式為空說明/戶名(C60)|帳號(C32)|幣種(C2)|余額(N12.2)|可用余額(N12.2)|開戶日期(C8)|帳戶類型(C1)|開戶行(C60)|凍結金額(N12.2)|存款金額(N12.2)|貸款金額(N12.2)|起息日(C8)|到期日(C8)|利率(N10)|錯誤信息(C60)| 成功標志(C1)|N成功標志：0：成功其它失敗/字段數(shù)IntN/記錄數(shù)IntN/文件標志C1N1-文件 0-非文件/文件名C20銀行主動通知銀行主動通知（012102）數(shù)據(jù)格式XML繼承接口請求包字段名（包括路徑）字段中文名類型取值范圍為空說明/接收消息IP端口Ip|port|/交易序號 N9/通知類型 C4N4:帳戶變動5:交易結果/通知日期 C8N/通知時間 C6N/企業(yè)代碼 C13/交易日期 C8N/交易經(jīng)辦員 C4/交易流水號C8/業(yè)務編號 C16/信用證號 C16/到單通知處理標志C1/擴展標志C1/通知正文N通知正文格式說明帳戶變動通知正文格式說明(/分隔):狀態(tài)(c1)/聯(lián)行行號(c12)/會計日期(c8)/柜員號(c4)/流水號(c6)/流水序號(