网下IPO系统接口规格说明书

1、上海证券交易所二一五年十二月网下IPO系统接口规格说明书（1.8版） 技术文档修订记录为便于阅读，修订记录按照修订时间逆序排列。2015年11月11日，调整与中国结算的有效申购数据文件接口，修改成网下新股获配数据文件接口；新增与国结算的网下新股发行获配数据文件接口；新增与主承销商的网下新股发行获配数据文件接口。2014年4月2日，根据新一轮调整要求，将原来由承销商提供的网下申购配售对象数据文件转变为由协会提供，将原本已经不需要的网下申购询价对象数据文件重新放回接口说明书中，由协会提供。增加与交易系统的新接口账户市值文件。调整原网下新股发行配售结果数据文件中“发行价格”字段的格式，由原来的9位小

2、数，调整为2位小数。明确了协会数据的发送路径。2013年12月6日，将承销商相关接口“网下新股发行配售结果数据文件”的发送时间调整为T+2日发送，之前的T+3日有误。2013年11月13日，根据技术管理例会指示，明确发信息中心的接口沿用原网下IPO系统接口发送方式，只在业务时间点发送对应接口文件，其他时间不发送空文件，调整对应接口描述。明确与信息公司接口文件“网下申购用户全量数据文件”只包括询价机构和承销商的用户信息，不包括场务用户。2013年11月6日，调整对信息中心接口“网下新股申购账户关系数据”中申报编号、拟申购价格、拟申购数量的对齐方式，由原来的“左对齐、右补空格”调整为“右对齐，左补

3、空”，对接口文件“网下新股有效申购数据”中“申报编号”字段的对齐方式做明确规定“右对齐，左补空格”（原接口未做说明，但实际是右对齐，左补空格），调整对信息中心接口的发送时间，统一调整至17:00发送。2013年11月4日，对信息中心接口进行统一调整，包括文件命名、格式、发送时间以及存储网关路径等。2013年11月1日，对接口文档中中登上海分公司发往网下IPO系统的配售对象资金到账文件的格式和描述进行补充，新增承销商接口文件“网下新股发行配售结果数据文件”；新增信息中心接口文件“网下新股发行配售结果数据文件”；对发行上市部业务系统接口文件“新发行证券信息文件”和“新发行证券信息审核结果文件”中“

4、账户发送日期”字段的说明进行补充。2013年10月15日，在接口文档中新增中登上海分公司发往网下IPO系统的配售对象资金到账文件接口的描述。2013年9月12日，修正接口文档中描述不规范的地方，主要包括：与发行上市部业务系统接口：新发行证券信息文件，“报价时间段”字段内容调整为9:30 15:00；接口：新发行证券信息审核结果文件，“报价时间段”字段内容调整为9:30 15:00；“申购款代码”字段非空必填；与信息中心接口：配售对象全量账户数据文件，“银行帐号”字段调整为“右对齐，左补空格”（只是描述调整，实现原本就是右对齐左补空格）；网下申购数据文件中证券业协会登记账户列表数据，“银行帐号”

5、字段调整为“右对齐，左补空格”。2013年8月，根据新股发行改革网下IPO系统调整方案论证会纪要，适应网下IPO开户、初步询价/累计投标询价参数录入等业务流程变更，修订本文档。目录1简介41.1本文的目的41.2概要42格式约定53接口信息流63.1文件接口说明64承销商接口规格说明74.1基于文件的接口74.1.1访问模式74.1.2数据文件列表74.1.3文件结构74.1.4网下申购询价对象用户开通数据文件74.1.5网下申购询价对象用户开通结果数据文件94.1.6网下新股发行获配数据文件104.1.7网下新股发行配售结果数据文件115后记121 简介1.1 本文的目的本文是IPO网下申购

6、平台与承销商之间的接口的功能和技术规格文档。本文详细定义了：1、IPO网下申购平台和其它系统之间存在的接口2、IPO网下申购平台和其它系统之间接口所采用的技术和标准3、通过接口交换的数据4、接口交换数据的格式本文包括以下部分：第1部分：简介即本节，这部分说明本文目的、文档的结构并概括介绍IPO网下申购平台和承销商之间的接口。第2部分：格式约定这部分介绍IPO网下申购平台和承销商之间的接口的格式约定。第2部分：信息流这部分为IPO网下申购平台和其它系统之间接口的技术架构和在各接口上交换的数据的定义。第4部分：承销商接口功能规格说明这部分定义承销商接口的功能规格，包括基于文件的接口规格说明，详细说

7、明基于在每个接口上实现的功能和数据的详细结构。1.2 概要本文用于描述IPO网下申购平台与承销商基于文件的接口，用来批量地交换数据，其中主要是初步询价和累计投标询价的申报数据。2 格式约定接口文件中，如无特别说明遵循以下原则：1、 接口文件的缺省格式为UNIX的文本文件（以OA换行）。2、 文件中一行表示一条记录，每行各字段之间以“|”分割，第一个字段前和最后一个字段后不使用“|”。3、 每个字段均为字符串，分为两大类：（1）”C”代表该字符串为文本”CX”代表该字符串的长度，其中X为大于零的数字，例如”C5”代表长度为5的文本，”FCX”代表固定长度的字符串；（2）”N”代表该字符串为数字”

8、NX”代表该字符串为整数，X为该整数的最大长度，包括符号位，例如”N5”代表该字段为长度为5的整数，”FNX”代表固定长度的整数。”NX(Y) ”代表该字符串为小数，X代表该字符串的最大长度，包括符号位和小数点，Y代表小数点后位数（不包含小数点本身）。”NXY ”代表该字符串为整数形式表示的小数，X代表该字符串的最大长度，包括符号位，不包括小数点，Y代表精度值（即小数点后位数）。4、 每个字段均为定长字段，原则上，文本型字符串左对齐，右补空格，字段默认值为“空格”；而数字型字符串均右对齐，左补空格，精度不足的需右补0，字段默认值为“0”。5、 每天传输的文件名后增加YYYYMMDD，YYYYM

9、MDD为当前交易日期。6、 每个传输文件有对应的flg文件。7、 例外情况以实际说明为准。3 接口信息流3.1 文件接口说明承销商通过IPO网下申购平台承销商端界面导入相关数据。4 承销商接口规格说明本部分将详细描述IPO网下申购平台与承销商的数据接口。4.1 基于文件的接口4.1.1 访问模式承销商通过交易客户端导入数据。4.1.2 数据文件列表IPO网下申购平台和承销商间交换的数据包括如下内容：数据内容文件名IPO网下申购平台->承销商承销商->IPO网下申购平台发送时间发送周期网下申购询价对象用户开通数据objectuseryyyymmdd.txt是闭市前有用户开通时网下申购

10、询价对象用户开通结果数据objectuserjgyyyymmdd.txt是闭市前有用户开通时网下新股发行获配数据文件wxxghpsjyyyymmdd.txt是15：00前发行结束后+1日（T+1日）网下新股发行配售结果数据文件wxxgpsjgyyyymmdd.txt；是714：00前发行结束后+23日（T+23日）表 6-1：IPO网下申购平台和承销商之间的数据文件4.1.3 文件结构· 行各节段均由行组成。每行为一个数据单元，由多个字段组成，各字段间以分隔符分隔。每行描述一条申报信息或记录。一行以回车换行符，即代码“0x0D0A”结束。所有节段中的行都必须具有相同的字段定义。

11、83; 字段分隔符各行中的字段由分隔符分隔。IPO网下申购平台与外部系统之间交换的所有文件均采用标准的分隔符“|”。每行的开头和结束不包括分隔符。· 字段各字段均为一个遵循节段格式定义的定长字符串。如果某一字段为空，则该字段应为定长的空格字符串，格式定义中所指明的长度为该字段的长度。4.1.4 网下申购询价对象用户开通数据文件· 文件名objectuseryyyymmdd.txt· 功能描述该文件包含由承销商发放CA证书的询价对象用户列表，只能增量新增。· 数据格式编号字段名长度对齐方式备注1询价对象用户唯一标识（登录系统用户名）30左对齐，右补空个人：

12、身份证号；合格境外机构投资者：QF身份认证字号；其他机构：组织机构代码（组织机构代码由八位数字（或大写拉丁字母）本体代码和一位数字（或大写拉丁字母）校验码组成。）（非空必填）2询价对象名称（机构名称）252左对齐，右补空（非空必填）3询价对象类型（机构类型）2BJ保荐机构；JJ证券投资基金公司；XT信托投资公司；CW财务公司；BX保险机构投资者；QF合格境外机构投资者；GR个人投资者QT其他（非空必填）4联系人姓名50左对齐，右补空5联系人电话50左对齐，右补空6联系人手机117联系人传真50左对齐，右补空8联系人电子邮箱40左对齐，右补空9CA证书ID18左对齐，右补空（非空必填）表 6-2

13、：网下申购询价对象用户开通数据文件格式4.1.5 网下申购询价对象用户开通结果数据文件· 文件名objectuserjgyyyymmdd.txt· 功能描述该文件包含由承销商上传的发放CA证书的询价对象用户列表在网下IPO系统的最终用户开通结果。· 数据格式编号字段名长度对齐方式备注1询价对象用户唯一标识（登录系统用户名）30左对齐，右补空个人：身份证号；合格境外机构投资者：QF身份认证字号；其他机构：组织机构代码（组织机构代码由八位数字（或大写拉丁字母）本体代码和一位数字（或大写拉丁字母）校验码组成。）（非空必填）2询价对象名称（机构名称）252左对齐，右补空（

14、非空必填）3询价对象类型（机构类型）2BJ保荐机构；JJ证券投资基金公司；XT信托投资公司；CW财务公司；BX保险机构投资者；QF合格境外机构投资者；GR个人投资者QT其他（非空必填）4联系人姓名50左对齐，右补空5联系人电话50左对齐，右补空6联系人手机117联系人传真50左对齐，右补空8联系人电子邮箱40左对齐，右补空9CA证书ID18左对齐，右补空（非空必填）10开通结果1左对齐，右补空S: 开通成功F: 开通失败11未开通原因100左对齐，右补空未开通原因表 6-3：网下申购询价对象用户开通结果数据文件格式4.1.6 网下新股发行获配数据文件· 文件名wxxghpsjyyyy

15、mmdd.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左对齐配售日期，格式：

16、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右