上交所上海证券交易所综合业务平台市场参与者+接口规格说明书港股交易预发布稿0714.docx
《上交所上海证券交易所综合业务平台市场参与者+接口规格说明书港股交易预发布稿0714.docx》由会员分享，可在线阅读，更多相关《上交所上海证券交易所综合业务平台市场参与者+接口规格说明书港股交易预发布稿0714.docx（43页珍藏版）》请在冰豆网上搜索。
上交所上海证券交易所综合业务平台市场参与者+接口规格说明书港股交易预发布稿0714
上海证券交易所技术文档
综合业务平台
市场参与者接口规格说明书
（预发布稿）
（港股交易）
（20140714版）
上海证券交易所
二○一四年七月
发布说明
本文档为市场参与者通过EzSTEP接入上交所综合业务平台的接口规格。
本文档定义了上交所港股交易业务市场参与者EzSTEP接口。
本文档由上海证券交易所起草，并负责进行解释。
文档变更20131014：
1、初稿。
文档变更20140318：
1、删除修改单，增加港股基础信息接口。
文档变更20140324：
1、修改港股基础信息接口结构。
文档变更20140326：
1、修改港股基础信息，增加可交易标识。
文档变更20140405：
1、增加转发的最小价差文件格式。
文档变更20140425：
1、增加实时行情。
文档变更20140425：
1、增加额度信息，增加实时行情接口规格。
增加自动撤单。
文档变更20140519：
1、修订实时行情接口。
文档变更20140523
1、补充reff04文件接口说明。
2、删除reff04中汇率。
3、补充转发独立的汇率文件。
4、补充说明申报的证券代码在5位代码基础上补位为6位。
5、补充说明申报结算代码用于预留。
文档变更20140618
1、删除公共数据表额度发布，增加实时交易盘状态文件，其中包含实时额度和港股通证券交易实时状态。
补充关于港股行情的说明。
文档变更20140618
1、增加盘后成交单据文件。
2、交易盘实时状态增加港股通交易日状态。
3、交易盘实时状态增加区分整手、零股订单可买卖状态。
文档变更20140714
1、修改港股基础信息文件reff040中产品状态信息，删除可买卖标识，具体标的可买卖标识参考港股通交易盘实时状态trdses04.txt接口。
2、港股执行报告接口中成交编号字段不止10位，修改描述。
3、补充说明港股通不支持FOK订单。
服务电话：
021-4009003600
通信地址：
上海市浦东南路528号上海证券交易所技术规划与服务部
网站地址：
→新交易系统专区
目录
1数据格式、STEP消息约定及通用数据库接口规范5
2港股交易业务消息规范6
2.1港股交易业务STEP消息流程图6
2.2申报消息6
2.3申报撤单消息8
2.4申报响应消息/申报撤单成功响应消息9
2.5申报撤单失败响应消息10
2.6执行报告消息11
3过户数据接口hghXXXXX.dbf13
4港股通成交单据文件tjss04XXXXX.txt15
5港股实时行情mktdt04.txt16
5.1结构描述17
5.2格式定义18
附表：
市场状态取值说明21
6港股通交易盘实时状态trdses04.txt22
6.1格式定义22
7港股基础信息reff04MMDD.txt25
8港股通参考汇率文件exra04MMDD.txt28
9最小价差文件zxjcMMDD.txt（转发）29
10后记31
1数据格式、STEP消息约定及通用数据库接口规范
数据格式约定参见《上海证券交易所市场参与者EzSTEP通用数据库接口规格说明书》文档STEP消息约定参见《上海证券交易所市场参与者EzSTEP通用数据库接口规格说明书》文档。
通用数据库接口参见《上海证券交易所市场参与者EzSTEP通用数据库接口规格说明书》文档。
撮合业务支持以下请求业务类型编号（reqid），取值：
HKN港股订单申报（HongKongNewentry），即港股整手订单
HKO港股零股订单申报（HongKongOddlot），零股订单也称可为碎股订单。
本业务产品集编号（setid）为：
107
数据广播类型（bcasttype），本业务取值：
成交回报和自动撤单回报:
19
消息类型（MsgType），本业务取值：
8=申报响应或执行报告（ExecutionReport）
9=申报撤消失败（OrderCancelReject）
D=申报（NewOrderSingle）
F=申报撤单（OrderCancelRequest）
W=港股额度行情（MktDataFull）
本业务有以下约定：
目前综合业务平台STEP撤单订单，均不分配交易所订单编号，因此撤单成功或失败响应中，交易所订单编号为空。
数据库中证券代码为港股代码，在基础信息文件5位港股代码基础上左补空格补齐6位。
2港股交易业务消息规范
2.1港股交易业务STEP消息流程图
根据业务规则，市场投资者可以进行买卖申报和撤单申报，交易所实时反馈申报确认，并反馈成交回报（即执行报告）
下图描述了消息通信流程。
2.2申报消息
NewOrderSingle（reqtext）
申报消息
描述：
请求及响应接口表中的reqtext字段数据。
市场参与者使用NewOrderSingle消息进行撮合买卖申报。
支持以下请求业务申报：
HKN（港股订单申报）
HKO（港股零股订单申报）。
注意其中订单价格、数量必须为非负数。
标签
字段名
字段描述
类型
消息头
MsgType取值为：
D=申报
11
ClOrdID
会员内部编号，指申报会员内部编号。
C10
48
SecurityID
证券代码，港股代码，在基础信息文件5位代码基础上，左补空格补齐6位
C6
44
Price
价格，单位港元。
N11（3）
38
OrderQty
订单数量
N10
54
Side
买卖方向，取值有：
1表示买
2表示卖
C1
40
OrdType
订单类型，取值：
2=限价（Limit）
本字段对于零股无意义，可取空格。
C1
1090
MaxPriceLevels
最大价格等级，取值：
1表示竞价限价盘
0为缺省值，表示增强限价盘
本字段对于零股无意义，可缺省取零。
N2
59
TimeInForce
订单有效时间类型，取值：
0＝当日有效（GFD），即正常情况，允许部分成交
4＝即时全部成交否则撤销（FOK），即不允许部分成交，目前港股通订单暂不支持。
C1
453
NoPartyIDs
参与方个数，后接重复组，依次包含发起方的投资者账户、申报交易单元号、营业部代码、结算代码,取值为4。
N2
投资者账户
448
PartyID
投资者帐户
C10
452
PartyRole
取5，表示当前PartyID的取值为投资者帐户
N4
申报交易单元号
448
PartyID
业务PBU代码，填写5位交易单元号。
C5
452
PartyRole
取1，表示当前PartyID的取值为PBU
N4
营业部代码
448
PartyID
营业部代码
C5
452
PartyRole
取4001，表示当前PartyID的取值为营业部代码
N4
结算代码
448
PartyID
结算代码，预留，可取实际会员结算代码或默认值。
C5
452
PartyRole
取4，表示当前PartyID的取值为结算代码
N4
58
Text
备注
C50
2.3申报撤单消息
OrderCancelRequest（reqtext）
申报撤单消息
描述：
请求及响应接口表中的reqtext字段数据。
市场参与者使用OrderCancelRequest消息进行申报撤单
需要注意的是，为简化会员公司备份切换动作，综合业务平台采用原始申报的会员内部编号和业务交易单元号作为撤单索引字段。
标签
字段名
字段描述
类型
消息头
MsgType取值为：
F=申报撤单
11
ClOrdID
会员内部编号，指申报会员内部编号。
C10
41
OrigClOrdID
原始交易客户方（券商）订单编号，指示被撤消订单的ClOrdID
C10
48
SecurityID
证券代码
C6
38
OrderQty
订单数量，本业务不做校验
N10
54
Side
买卖方向，取值有：
1表示买
2表示卖
C1
453
NoPartyIDs
参与方个数，后接重复组，依次包含投资者账户、申报交易单元号，取值为2。
N2
发起方投资者帐户
448
PartyID
投资者帐户
C10
452
PartyRole
取5，表示当前PartyID的取值为投资者帐户
N4
发起方申报交易单元号
448
PartyID
业务PBU代码，填写5位交易单元号，对于撤单，应为原始成交申报的业务PBU代码。
C5
452
PartyRole
取1，表示当前PartyID的取值为PBU
N4
58
Text
备注
C50
2.4申报响应消息/申报撤单成功响应消息
ExecutionReport（resptext）
申报响应消息
描述：
请求及响应接口表中的resptext字段数据。
每一个申报记录或申报撤单记录都分别有一个对应的响应消息。
市场参与者系统可以获得上交所处理申报后返回的确认信息。
150和39组合取值含义：
申报成功响应：
150=0,39=0
申报拒绝响应：
150=8,39=8
申报撤单成功响应：
150=6,39=6
申报撤单失败响应：
参见OrderCancelReject
标签
字段名
字段描述
类型
消息头
MsgType取值为：
8=申报响应
37
OrderID
交易所订单编号
C16
150
ExecType
当前订单执行类型，取值有：
0=成功响应
8=拒绝响应
6=撤单成功
E=修改单成功
C1
39
OrdStatus
当前订单状态，取值有：
0=成功响应
8=拒绝响应
6=撤单成功
E=修改单成功
C1
48
SecurityID
证券代码
C6
11
ClOrdID
会员内部编号。
C10
60
TransactTime
接受请求时间，格式为YYYYMMDD-HH:
MM:
SS.000
C21
41
OrigClOrdID
对于申报撤单成功响应，为原始交易客户方（券商）订单编号，指示被撤消/修改订单的ClOrdID，对于申报响应，取值为空。
C10
103
OrdRejReason
对于申报响应，为申报错误信息，供柜台系统读取错误信息，进行错误处理。
申报成功时，该字段取值为空。
申报失败时，表示拒绝的理由，取值同Remark字段。
对于申报撤单成功响应，该字段取值为空。
C5
32
LastQty
对于申报撤单成功响应，为该撤单成功的数量。
其他无意义取0
N12
58
Text
备注
C50
2.5申报撤单失败响应消息
OrderCancelReject（resptext）
申报撤单失败响应消息
描述：
请求及响应接口表中的resptext字段数据。
标签
字段名
字段描述
类型
标准消息头
MsgType取值为：
9=申报撤消失败响应。
37
OrderID
交易所订单编号
C16
39
OrdStatus
当前订单状态，取值有：
8=拒绝响应
C1
11
ClOrdID
会员内部编号。
C10
41
OrigClOrdID
原始交易客户方（券商）订单编号，指示被撤消订单的ClOrdID
C10
60
TransactTime
接受请求时间，格式为YYYYMMDD-HH:
MM:
SS.000
C21
102
CxlRejReason
撤消失败时，撤单请求拒绝的理由，取值同Remark字段。
具体参见错误代码总表港股部分。
C5
434
CxlRejResponseTo
撤单响应类型，取值：
1=撤单响应
C1
2.6执行报告消息
ExecutionReport（execreporttext）
实时执行报告消息
描述：
执行报告表中的execreporttext字段数据。
对于香港交易所自动撤单，通过执行报告反馈撤单数据，成交数量为撤单数量，成交编号和成交金额取0，订单执行状态、订单状态取值4。
序号
字段名
字段描述
类型
标准消息头
MsgType取值为：
8=成交回报
11
ClOrdID
会员内部编号，
C10
37
OrderID
交易所订单编号
C16
17
ExecID
成交编号
C16
1180
ApplID
消息应用标识，取值同数据库中请求业务类型reqid
C3
48
SecurityID
证券代码
C6
31
LastPx
价格
N11（3）
32
LastQty
该笔成交数量。
N12
8504
TotalValueTraded
成交金额
N16（3）
151
LeavesQty
本次剩余余额，暂为0
N12
54
Side
买卖方向，取值有：
1表示买
2表示卖
C1
60
TransactTime
订单执行时间，格式为YYYYMMDD-HH:
MM:
SS.000
C21
42
OrigTime
原有订单请求接收的时间,式为YYYYMMDD-HH:
MM:
SS.000
C21
150
ExecType
当前订单执行状态，取值：
F=成交
4=港股自动撤单（Canceled）
C1
39
OrdStatus
当前订单状态，取值：
1=部分成交，2=已成交，4=已撤单
C1
453
NoPartyIDs
参与方个数，后接重复组，依次包含发起方的投资者账户、申报交易单元号，取值为2。
N2
投资者帐户
448
PartyID
投资者帐户
C10
452
PartyRole
取5，表示当前PartyID的取值为投资者帐户
N4
申报交易单元号
448
PartyID
业务PBU代码，填写5位交易单元号
C5
452
PartyRole
取1，表示当前PartyID的取值为申报交易单元号
N4
58
Text
备注
C50
3过户数据接口hghXXXXX.dbf
bghXXXXX.dbf
过户数据接口
描述：
文件名中XXXXX表示业务交易单元号。
闭市后发送。
未申明特别填写方式和单位的字段，均填写或参照对应订单输入时的原始信息，无意义字段不填。
过户数据接口hghXXXXX.dbf压缩为hghXXXXX.zip文件中供券商用RptGet下载。
过户数据同实时成交回报。
序号
字段名
字段描述
类型
1
gddm
证券账户
C10
2
bcrq
成交日期，格式为YYYYMMDD
C8
3
cjbh
成交编号
C16
4
gsdm
业务PBU
C5
5
cjsl
成交数量
N12
6
zqdm
证券代码
C6
7
sbsj
申报时间，格式为HHMMSS
C6
8
cjsj
成交时间，格式为HHMMSS
C6
9
cjjg
成交价格
N11（3）
10
cjje
成交金额
N16
（2）
11
sqbh
会员内部订单号，同申报接口中的reff（会员内部订单号）
C10
12
cjbz
成交业务类型标志
HKN港股订单申报（HongKongNewentry）
HKO港股零股订单申报（HongKongOddlot）
C3
13
bs
买卖方
B：
买
S：
卖
C1
14
text
备注，保留字段，暂不填
C30
4港股通成交单据文件tjss04XXXXX.txt
tjss04XXXXX.txt
港股通成交单据接口
描述：
文件名中XXXXX表示业务交易单元号。
闭市后发送。
由登记公司发成交单据原始数据给上交所，根据要求，上交所向市场转发留存。
文件压缩为tjss04XXXXX.zip文件中供券商用RptGet下载。
序号
字段名
长度类型
字段说明
1
会员名称
C40
2
证券代码
C6
3
公司名称
C40
指证券名称
4
买卖方向
C1
B：
买，S：
卖
5
成交数量
N18（3）
6
成交价格
N10（3）
单位为港元
7
成交金额
N19
（2）
单位为港元
8
印花税
N19
（2）
单位为港元
9
成交编号
N16
10
成交日期
C8
YYYYMMDD格式
11
制单日期
C8
YYYYMMDD格式
12
交收日期
C8
YYYYMMDD格式
13
说明1
C40
在此单据印上的印花税款额，已经或将会透过香港联合交易所有限公司缴付
14
说明2
C20
成交单据由上交所子公司发出及执行
15
说明3
C30
有关交易由上交所子公司以代理人身份为内地权商执行
5港股实时行情mktdt04.txt
Mktdt04.txt
港股行情文件接口
描述：
本文件为行情文件接口。
对于港股行情，行情文件名为mktdt04.txt，当日开市前至交易结束期间，通过上证通信公司行情通道实时发送。
本文件由港交所生成，表示港交所交易日产品行情，注意其中市场状态和证券交易状态代表港交所交易状态，并非港股通产品交易状态（参见交易盘实时状态接口文件），本文件由上证通信公司直接转发。
行情文件为文本txt文件，格式约定如下：
（一）竖线（'|'）为字段间分隔符，字段数据内容不应含有分隔符；
（二）竖线（'|'）不应用在每条记录的开头和结尾；
（三）各字段均为一个遵循格式定义的字符串，字段间有严格前后顺序；
（四）字段定长，字段格式定义约定了长度和精度；字符型字段以CX格式表示，其中X代表字符串长度，不足部分左对齐，右补空格；整数数字型字段以NX格式表示，其中X代表数字型字符串长度，不足部分右对齐，左补空格；浮点数字型字段以NX（Y）格式表示，其中X代表数字型字符串总长度，Y代表小数位数，X包括一位小数点，整数部分最多不超过X-Y-1位，小数部分最多不超过Y位，不足部分右对齐，左补空格；
（五）每行以十六进制0x0A结束，最后一行也以0x0A结束。
文件描述：
（一）行情文件包含文件头、文件体、文件尾三个部分；
（二）注意行情文件可扩展性，文件记录尾部可能随时增加扩展字段，接收处理方应能向下兼容处理，即增加扩展字段后，对新增字段无需识别处理的用户，不需要升级系统；
（三）文件体中，对于不同的行情数据类型，分别定义记录格式，接收处理方应能根据行情数据类型识别处理；
（四）文件体记录按行情数据类型递增，同一行情数据类型按证券代码递增；
（五）对于暂停上市的股票，文件中不包含该股票的记录。
对于未开始上市交易的证券，文件中不包含该证券的记录。
对于摘牌后的证券，文件中不包含该证券的记录。
（六）如文件中数值字段取值超过约定格式最大值，取最大值，如N10取9999999999；
（七）前收盘价格，在开市之前即行发布。
在盘中休市期间同样揭示各档买卖价格数量等全部信息；
（八）对于价格、金额数据，单位为港元。
对于数量数据，单位为股（share）；
（九）在集合竞价时段内，当前买入价和当前卖出价同时为虚拟开盘参考价格，即根据集合竞价算法计算得出的虚拟撮合价格。
同时申买量一和申卖量一为行情发布时刻的虚拟匹配量；
（十）字段无行情数据时，字符填空格，数值填0；
（十一）字段无意义时，字符或数值均填空格；
在收盘后（市场状态为0），按盘价为收盘价格;
（十三）收盘价格一般于收盘后約1分钟前后发布;
（十四）在开市之前，除前收盘价格外，所有价格、金额、数量等行情数据均为0;
（十五）港交所具体证券代码，参见相关通知，并参考以上处理。
5.1结构描述
结构图如下：
文件结构描述参考：
BeginString|Version|BodyLength|TotNumTradeReports|MDReportID|SenderCompID|MDTime|MDUpdateType|MktStatus
MDStreamID|SecurityID|Symbol|SymbolEn|TradeVolume|TotalValueTraded|PreClosePx|NominalPrice|HighPrice|LowPrice|TradePrice|BuyPrice1|BuyVolume1|SellPrice1|SellVolume1|SecTradingStatus|Timestamp
……
……
……
EndString|CheckSum
5.2格式定义
文件头定义，第一行特殊记录：
序号
域名
字段名
字段类型
描述
1
BeginString
起始标识符
C6
HEADER
2
Version
版本
C8
ITP1.00
3
BodyLength
数据长度
N10
计算出的长度字段分隔符后面的字节数（不包含本字段后面的分隔符），包含其他字段后面的分隔符、换行符。
（暂不填写，填空格）
4
TotNumTradeReports
文件体记录数
N5
文件体记录数
5
MDReportID
行情序号
N8
行情文件序号（预留，暂不填，填空格）
6
SenderCompID
发送方
C6
发送方标示符，取
XHKG01
7
MDTime
行情时间
C21
行情时间，格式为YYYYMMDD-HH:
MM:
SS.000
[为每次文件更新的时间，不论是否盘中均要更新]
8
MDUpdateType
发送方式
N1
0=快照Fullrefresh
1=增量Incremental（暂不支持）
9
MktStatus
市场状态
C8
0=全日收市
1=输入买卖盘
2=对盘
3=持续交易
7=暂停
100=未开市
101=对盘前
102=ExchangeIntervention
103=收市
104=取消买卖盘
注：
请参阅附表有关各个市场状态的详细解释
扩展区域
不定
系统应能支持记录尾部扩展新的字段。
文件体定义，多条行情记录，行情数据类型取值标识字母MD加类型编号。
当取值为MD401时，文件体记录格式如下：
序号
域名
字段名
字段类型
描述
1
MDStreamID
行情数据类型
C5
行情数据类型标识符，取值
MD401表示行情数据格式类型，目前该类型包含港股行情
2
SecurityID
证券代码
C5
证券代码,不足五位左补零。
例：
00012
3
Symbol
中文证券简称
C32
升级会员 