网下IPO系统接口规格说明书.docx
《网下IPO系统接口规格说明书.docx》由会员分享,可在线阅读,更多相关《网下IPO系统接口规格说明书.docx(14页珍藏版)》请在冰豆网上搜索。
网下IPO系统接口规格说明书
上海证券交易所
二○一五年十二月
网下IPO系统
接口规格说明书
(1.8版)
修订记录
为便于阅读,修订记录按照修订时间逆序排列。
2015年11月11日,调整与中国结算的有效申购数据文件接口,修改成网下新股获配数据文件接口;新增与国结算的网下新股发行获配数据文件接口;新增与主承销商的网下新股发行获配数据文件接口。
2014年4月2日,根据新一轮调整要求,将原来由承销商提供的网下申购配售对象数据文件转变为由协会提供,将原本已经不需要的网下申购询价对象数据文件重新放回接口说明书中,由协会提供。
增加与交易系统的新接口账户市值文件。
调整原网下新股发行配售结果数据文件中“发行价格”字段的格式,由原来的9位小数,调整为2位小数。
明确了协会数据的发送路径。
2013年12月6日,将承销商相关接口“网下新股发行配售结果数据文件”的发送时间调整为T+2日发送,之前的T+3日有误。
2013年11月13日,根据技术管理例会指示,明确发信息中心的接口沿用原网下IPO系统接口发送方式,只在业务时间点发送对应接口文件,其他时间不发送空文件,调整对应接口描述。
明确与信息公司接口文件“网下申购用户全量数据文件”只包括询价机构和承销商的用户信息,不包括场务用户。
2013年11月6日,调整对信息中心接口“网下新股申购账户关系数据”中申报编号、拟申购价格、拟申购数量的对齐方式,由原来的“左对齐、右补空格”调整为“右对齐,左补空”,对接口文件“网下新股有效申购数据”中“申报编号”字段的对齐方式做明确规定“右对齐,左补空格”(原接口未做说明,但实际是右对齐,左补空格),调整对信息中心接口的发送时间,统一调整至17:
00发送。
2013年11月4日,对信息中心接口进行统一调整,包括文件命名、格式、发送时间以及存储网关路径等。
2013年11月1日,对接口文档中中登上海分公司发往网下IPO系统的配售对象资金到账文件的格式和描述进行补充,新增承销商接口文件“网下新股发行配售结果数据文件”;新增信息中心接口文件“网下新股发行配售结果数据文件”;对发行上市部业务系统接口文件“新发行证券信息文件”和“新发行证券信息审核结果文件”中“账户发送日期”字段的说明进行补充。
2013年10月15日,在接口文档中新增中登上海分公司发往网下IPO系统的配售对象资金到账文件接口的描述。
2013年9月12日,修正接口文档中描述不规范的地方,主要包括:
与发行上市部业务系统接口:
新发行证券信息文件,“报价时间段”字段内容调整为9:
30–15:
00;接口:
新发行证券信息审核结果文件,“报价时间段”字段内容调整为9:
30–15:
00;“申购款代码”字段非空必填;与信息中心接口:
配售对象全量账户数据文件,“银行帐号”字段调整为“右对齐,左补空格”(只是描述调整,实现原本就是右对齐左补空格);网下申购数据文件中证券业协会登记账户列表数据,“银行帐号”字段调整为“右对齐,左补空格”。
2013年8月,根据《新股发行改革网下IPO系统调整方案论证会纪要》,适应网下IPO开户、初步询价/累计投标询价参数录入等业务流程变更,修订本文档。
1简介
1.1本文的目的
本文是IPO网下申购平台与承销商之间的接口的功能和技术规格文档。
本文详细定义了:
1、IPO网下申购平台和其它系统之间存在的接口
2、IPO网下申购平台和其它系统之间接口所采用的技术和标准
3、通过接口交换的数据
4、接口交换数据的格式
本文包括以下部分:
第1部分:
简介
即本节,这部分说明本文目的、文档的结构并概括介绍IPO网下申购平台和承销商之间的接口。
第2部分:
格式约定
这部分介绍IPO网下申购平台和承销商之间的接口的格式约定。
第2部分:
信息流
这部分为IPO网下申购平台和其它系统之间接口的技术架构和在各接口上交换的数据的定义。
第4部分:
承销商接口功能规格说明
这部分定义承销商接口的功能规格,包括基于文件的接口规格说明,详细说明基于在每个接口上实现的功能和数据的详细结构。
1.2概要
本文用于描述IPO网下申购平台与承销商基于文件的接口,用来批量地交换数据,其中主要是初步询价和累计投标询价的申报数据。
2格式约定
接口文件中,如无特别说明遵循以下原则:
1、接口文件的缺省格式为UNIX的文本文件(以OA换行)。
2、文件中一行表示一条记录,每行各字段之间以“|”分割,第一个字段前和最后一个字段后不使用“|”。
3、每个字段均为字符串,分为两大类:
(1)”C”代表该字符串为文本
”CX”代表该字符串的长度,其中X为大于零的数字,例如”C5”代表长度为5的文本,”FCX”代表固定长度的字符串;
(2)”N”代表该字符串为数字
”NX”代表该字符串为整数,X为该整数的最大长度,包括符号位,例如”N5”代表该字段为长度为5的整数,”FNX”代表固定长度的整数。
”NX(Y)”代表该字符串为小数,X代表该字符串的最大长度,包括符号位和小数点,Y代表小数点后位数(不包含小数点本身)。
”NX[Y]”代表该字符串为整数形式表示的小数,X代表该字符串的最大长度,包括符号位,不包括小数点,Y代表精度值(即小数点后位数)。
4、每个字段均为定长字段,原则上,文本型字符串左对齐,右补空格,字段默认值为“空格”;而数字型字符串均右对齐,左补空格,精度不足的需右补0,字段默认值为“0”。
5、每天传输的文件名后增加YYYYMMDD,YYYYMMDD为当前交易日期。
6、每个传输文件有对应的flg文件。
7、例外情况以实际说明为准。
3接口信息流
3.1文件接口说明
承销商通过IPO网下申购平台承销商端界面导入相关数据。
4承销商接口规格说明
本部分将详细描述IPO网下申购平台与承销商的数据接口。
4.1基于文件的接口
4.1.1访问模式
承销商通过交易客户端导入数据。
4.1.2数据文件列表
IPO网下申购平台和承销商间交换的数据包括如下内容:
数据内容
文件名
IPO网下申购平台->承销商
承销商->IPO网下申购平台
发送时间
发送周期
网下申购询价对象用户开通数据
objectuseryyyymmdd.txt
是
闭市前
有用户开通时
网下申购询价对象用户开通结果数据
objectuserjgyyyymmdd.txt
是
闭市前
有用户开通时
网下新股发行获配数据文件
wxxghpsjyyyymmdd.txt
是
15:
00前
发行结束后+1日(T+1日)
网下新股发行配售结果数据文件
wxxgpsjgyyyymmdd.txt;
是
14:
00前
发行结束后+3日(T+3日)
表6-1:
IPO网下申购平台和承销商之间的数据文件
4.1.3文件结构
∙行
各节段均由行组成。
每行为一个数据单元,由多个字段组成,各字段间以分隔符分隔。
每行描述一条申报信息或记录。
一行以回车换行符,即代码“0x0D0A”结束。
所有节段中的行都必须具有相同的字段定义。
∙字段分隔符
各行中的字段由分隔符分隔。
IPO网下申购平台与外部系统之间交换的所有文件均采用标准的分隔符“|”。
每行的开头和结束不包括分隔符。
∙字段
各字段均为一个遵循节段格式定义的定长字符串。
如果某一字段为空,则该字段应为定长的空格字符串,格式定义中所指明的长度为该字段的长度。
4.1.4网下申购询价对象用户开通数据文件
∙文件名
objectuseryyyymmdd.txt
∙功能描述
该文件包含由承销商发放CA证书的询价对象用户列表,只能增量新增。
∙数据格式
编号
字段名
长度
对齐方式
备注
1
询价对象用户唯一标识(登录系统用户名)
30
左对齐,右补空
个人:
身份证号;
合格境外机构投资者:
QF身份认证字号;
其他机构:
组织机构代码(组织机构代码由八位数字(或大写拉丁字母)本体代码和一位数字(或大写拉丁字母)校验码组成。
)
(非空必填)
2
询价对象名称(机构名称)
252
左对齐,右补空
(非空必填)
3
询价对象类型(机构类型)
2
BJ.保荐机构;
JJ.证券投资基金公司;
XT.信托投资公司;
CW.财务公司;
BX.保险机构投资者;
QF.合格境外机构投资者;
GR.个人投资者
QT.其他
(非空必填)
4
联系人姓名
50
左对齐,右补空
5
联系人电话
50
左对齐,右补空
6
联系人手机
11
7
联系人传真
50
左对齐,右补空
8
联系人电子邮箱
40
左对齐,右补空
9
CA证书ID
18
左对齐,右补空
(非空必填)
表6-2:
网下申购询价对象用户开通数据文件格式
4.1.5网下申购询价对象用户开通结果数据文件
∙文件名
objectuserjgyyyymmdd.txt
∙功能描述
该文件包含由承销商上传的发放CA证书的询价对象用户列表在网下IPO系统的最终用户开通结果。
∙数据格式
编号
字段名
长度
对齐方式
备注
1
询价对象用户唯一标识(登录系统用户名)
30
左对齐,右补空
个人:
身份证号;
合格境外机构投资者:
QF身份认证字号;
其他机构:
组织机构代码(组织机构代码由八位数字(或大写拉丁字母)本体代码和一位数字(或大写拉丁字母)校验码组成。
)
(非空必填)
2
询价对象名称(机构名称)
252
左对齐,右补空
(非空必填)
3
询价对象类型(机构类型)
2
BJ.保荐机构;
JJ.证券投资基金公司;
XT.信托投资公司;
CW.财务公司;
BX.保险机构投资者;
QF.合格境外机构投资者;
GR.个人投资者
QT.其他
(非空必填)
4
联系人姓名
50
左对齐,右补空
5
联系人电话
50
左对齐,右补空
6
联系人手机
11
7
联系人传真
50
左对齐,右补空
8
联系人电子邮箱
40
左对齐,右补空
9
CA证书ID
18
左对齐,右补空
(非空必填)
10
开通结果
1
左对齐,右补空
S:
开通成功
F:
开通失败
11
未开通原因
100
左对齐,右补空
未开通原因
表6-3:
网下申购询价对象用户开通结果数据文件格式
4.1.6网下新股发行获配数据文件
∙文件名
wxxghpsjyyyymmdd.txt
∙功能描述
该文件包含网下新股申购配售对象配售结果数据
∙数据格式
∙时间
T+1日15:
00前上传
编号
字段名
长度
对齐方式
备注
1
证券账户
C10
左对齐
配售对象报备证券账户
2
证券代码
C6
左对齐
网下新股申购证券的二级市场交易代码
3
获配价格
N(17,2)
右对齐左补空格,小数部分不足部分补0
发行价格,单位元,格式:
9999999.99,
4
获配数量
N12
右对齐左补空格
配售数量,单位为股,
5
获配金额
N(20,2)
右对齐左补空格,小数部分不足部分补0
配售金额,单位元,格式99999999999999999.99,
6
获配日期
C8
左对齐
配售日期,格式:
YYYYMMDD
表6-4:
网下新股发行获配数据文件
4.1.7网下新股发行配售结果数据文件
∙文件名
wxxgpsjgyyyymmdd.txt
∙功能描述
该文件包含网下新股申购配售对象配售结果数据
∙时间
T+3日14:
00前上传
∙数据格式
编号
字段名
长度
对齐方式
备注
1
证券账户
10
配售对象报备证券账户
2
证券代码
6
网下新股申购证券的二级市场交易代码
3
限售期限
4
右对齐左补空格
限售期限,大于或等于0的数字,
4
证券类别
2
当限售期等于0时,证券类别填写“PT”,当限售期大于0时,证券类别填写“XL”
5
发行价格
17
右对齐左补空格,小数部分不足部分补0
发行价格,格式:
9999999.99,
6
配售数量
12
右对齐左补空格
配售数量,单位为股,
7
配售金额
20
右对齐左补空格,小数部分不足部分补0
配售金额,格式99999999999999999.99,
8
退款金额
20
右对齐左补空格,小数部分不足部分补0
退款金额,格式99999999999999999.99,
9
配售日期
8
配售日期,格式:
YYYYMMDD
10
证件代码
40
配售对象报备证券账户开户时的证件代码,左对齐
表6-5:
网下新股发行配售结果数据文件
5后记
上海证券交易所对本文档享有知识产权,未经上海证券交易所书面许可,任何单位和个人不得将本文档用于其他商业目的。
古今名言
敏而好学,不耻下问——孔子
业精于勤,荒于嬉;行成于思,毁于随——韩愈
兴于《诗》,立于礼,成于乐——孔子
己所不欲,勿施于人——孔子
读书破万卷,下笔如有神——杜甫
读书有三到,谓心到,眼到,口到——朱熹
立身以立学为先,立学以读书为本——欧阳修
读万卷书,行万里路——刘彝
黑发不知勤学早,白首方悔读书迟——颜真卿
书卷多情似故人,晨昏忧乐每相亲——于谦
书犹药也,善读之可以医愚——刘向
莫等闲,白了少年头,空悲切——岳飞
发奋识遍天下字,立志读尽人间书——苏轼
鸟欲高飞先振翅,人求上进先读书——李苦禅
立志宜思真品格,读书须尽苦功夫——阮元
非淡泊无以明志,非宁静无以致远——诸葛亮
熟读唐诗三百首,不会作诗也会吟——孙洙《唐诗三百首序》
书到用时方恨少,事非经过不知难——陆游
问渠那得清如许,为有源头活水来——朱熹
旧书不厌百回读,熟读精思子自知——苏轼
书痴者文必工,艺痴者技必良——蒲松龄
声明
访问者可将本资料提供的内容用于个人学习、研究或欣赏,以及其他非商业性或非盈利性用途,但同时应遵守著作权法及其他相关法律的规定,不得侵犯本文档及相关权利人的合法权利。
谢谢合作!