恒生公司ta与客服系统接口规范范本.docx

资源描述

登记过户系统与客户服务系统接口规范文档修改记录编号日期说明编写者 1、形成李骏 2、接口修改，形成版。以后新修改部分用红色字体表示。主要修改： 1、增加交易账号 2、交易确认文件增加处理返回信息，不再利用错误代码 3、确认文件增加本笔交易份额余额、单位净值 4、份额明细增加份额注册日期字段 5、修改文件名、文件名包含日期信息。增加全部数据导出，文件名区分 6、一些字段增加了描述沈志伟 3、形成版本、份额明细：备注长度改为沈志伟 4、增加货币市场基金的未付收益相关内容，形成版本 1、静态份额：增加“未付收益”、“冻结未付收益”字段 2、确认数据：增加“兑付的未付收益”、“兑付的份额”、“未付收益”字段 3、基金行情：增加“累计单位净值”、“基金收益”、“未分配收益”，“万份基金收益”，“收益率”字段沈志伟 5、形成版本 1、客户信息件增加：特殊代码、工作单位名称、工作单位电话、客服密码 2、账户确认文件增加：特殊代码、工作单位名称、工作单位电话沈志伟 6、形成版本 1、基金静态份额数据，增加备注字段沈志伟 7、形成版本、申请表增加相关协议信息。徐昌荣 8、对于份额明细数据，生成发生变动的份额余额对应的所有份额明细记录； 9、行情文件中增加净值增长率，同时缩短备注字段许洪波 10、针对易方达增加份额对账文件许洪波 11、确认文件中增加归注册机构费用、利息字段，备注字段加长（共，剩）许洪波 12、账户信息（）、账户确认（）文件中增加“推荐人”字段许洪波 13、账户信息文件中增加“操作网点”字段许洪波 14、账户信息（）、账户确认（）文件中增加“推荐人类型”字段许洪波 15、、的过户费，对专户产品表示业绩提成金额。文件中的印花税表示分红的业绩提成金额。许洪波 16、文件备注字段增加“新增收益”()字段,同时缩短备注字段长度。许洪波 17、文件的节，增加净值精度的字段，同时缩短备注字段长度。许洪波 18、中的节增加补充定义，可分销售机构导出转换限制数据。许洪波 19、文件中协议号字段扩为位。形成版本。许洪波 20、为适应中央数据交换协议，形成版本。、文件中的客户名称、通讯地址、经办人证件号码、学历、职业字段的长度；文件中的资金方式字段长度；文件的客户名称字段长度；文件节里的客户名称字段长度；销售商代码扩为位；许洪波 21、 1、在中，增加一个超短期理财方案设置的节点，节点名为，内容见接口文档 2、中的基金基本信息的具体内容，增加一个字段，是否超短期理财基金，用于表示是否短期理财基金表示否表示是 3、基金份额明细的具体内容，增加到期日和未付收益两个字段程英杭 22、修改交易申请信息和交易确认结果中对方销售人代码长度,由位改成位程英杭一、接口规范概述 1．用途本接口规范仅描述登记过户系统给客户服务系统（包括查询和网站查询）所提供数据的具体内容和形式。 2．数据处理规则为： (a) 以文本文件定长记录方式提供数据；约定：将来需要新增加的字段都增加在尾部，客服系统读记录时，不用校验记录的长度，以保持兼容。 (b) 文件的第一行为数据的记录数 (c) 最后一行为’’ (d) 文件数据体中，每行代表一条完整记录； (e) 换行必须用回车（）、换行（）字符； (f) 数据项类型，:字符型；:数字；:字符型，填数字 (g) 数字如是负数，第一位用’‘表示，占用一个整数位 (h) 数字左补零右对齐，字符右补空格左对齐； (i) 带有小数点的数值型数据，传输时不传小数点；本接口中，没有特别说明的，都表示位小数。 (j) 带下划线的字段为相应文件记录的主索引； 3．包括内容本接口包含六个方面的数据：客户帐户信息、账户类确认数据、客户基金份额余额、客户交易流水（包括申请流水和确认流水）、基金分红信息和基金行情信息。 4．内容更新规则为： (a) 每日由登记过户系统向客户服务系统提供一次数据； (b) 每日所提供的数据仅表示截至到当日做完登记过户操作后的客户信息和基金行情信息； (c) 每次只提供变化（包括新增和更新）的数据；也可不定期提供全部数据（文件名区分）二、客户账户信息数据 1．数据生成规则： (a) 客户帐户信息包括客户基本信息和基金帐号的登记信息两个方面的内容，这两个方面的内容同步更新； (b) 客户资料和客户的基金帐号资料合在一条记录里形成所谓“客户基本信息”； (c) 客户基本信息既支持新增客户记录模式又支持新增基金帐号记录模式； (d) 客户基本信息还支持修改已有记录模式，销户也算修改记录范畴； (e) 基金帐号登记信息：只要某基金帐号下的账户登记信息有变化（包括增加、修改和取消），则将与该基金帐号有关的所有基金帐号登记信息记录全部更新； 2．客户基本信息的具体内容：变更数据文件名：，其中为当天日期，以下同全部数据文件名：字段名称类型长度位置描述备注记录内容标志更改，新增账号对于全导出方式，都属于新增客户客户号对于销户后再开基金账号的，客户编号相同，基金账号不同。标志属于新增账号个人机构标志机构，个人投资人证件类型个人证件类型身份证，护照，军官证，士兵证，港澳居民来往内地通行证，户口本，外国护照，其他，文职证，警官证，台胞证机构证件类型技术监督局代码，营业执照，行政机关，社会团体，军队，武警，下属机构（具有主管单位批文号），基金会投资人证件号码投资人基金帐号基金帐号类型未分类时，填’’，表示普通账户销售公司代码开户地区编号具体编码开户网点号码是托管网点，若销售机构采用通买通卖的大集中方式，用销售人代码作为网点号码；否则给出二级机构编号。下同投资人姓名全称投资人姓名简称国籍参考国标法人代表姓名 (对机构是必须的) 经办人姓名 (对机构是必须的) 经办人证件类型身份证，护照，军官证，士兵证，回乡证，户口本，外国护照经办人证件号码通讯地址邮政编码投资人电话号码投资人传真号码投资人地址投资人手机号码投资人呼机号码投资人出生日期投资人性别男；女投资人学历 “”为初中及以下，“”为高中中专，“”为大专本科，“”为硕士及以上家庭人口数投资人职业代码 “”为政府部门，“”为教科文，“”为金融，“”为商贸，“”为房地产，“”为制造业，“”为自由职业，“”为其它。对于机构就是行业投资人年收入交易取消，开通网上交易取消，开通自助终端交易取消，开通对帐单寄送选择不寄送，按月，按季，半年，一年交易确认书寄送选择不寄送，确认成功寄送，确认不成功也寄送实际填空（无此信息）冻结截止日期（冻结时用）冻结原因司法冻结，主动冻结，质押冻结投资人收款银行账户户名投资人收款银行账户帐号投资人收款银行账户开户行帐户开通日期有效日期最后修改日期有效日期帐户状态：正常；：冻结；：注销；首次投资日期有效日期一年内基金转换次数整数经纪人备注第：对账单寄送途径邮寄，，短信工作单位电话工作单位名称特殊代码可保存多个特殊代码(位)的值，之间用；格开。如：活动代码备注推荐人操作网点推荐人类型 :内部员工 :注册用户 :基金账户 :客户经理编号 :客户经理姓名 :其他证件有效期备注以后增加字段备用 3．基金账号登记信息的具体内容：变更数据文件名：全部数据文件名：字段名称类型长度位置描述备注投资人基金帐号销售公司代码网点号码指二级份额托管机构客户号交易账号为空表示已取消登记开户网点标志：开户网点：其它网点账户默认分红方式：再投资；：现金红利投资人收款银行账户户名投资人收款银行账户帐号投资人收款银行账户开户行位编码备注以后增加字段备用三、客户基金份额余额数据 1．数据生成规则： (a) 基金静态份额余额和份额明细同步更新； (b) 对于静态份额数据，只生成当天发生过变化的记录(包括修改和新增)，如份额余额变为，也会生成对应数据；对于份额明细数据，对六要素（基金帐号、销售商、托管网点、交易账号、基金代码、份额类别）的份额余额有变化（包括修改和新增加），则生成对应六要素的份额明细记录。 (c) 基金份额全部用小数点后位小数表达； 2．基金静态份额的具体内容：变更数据文件名：全部数据文件名：字段名称类型长度位置描述备注客户号投资人基金帐号基金代码份额类型无分类时填‘’ ‘’：前收费 ‘’：后收费其它，根据基金公司约定销售人代码网点号码指基金份额的二级托管机构当前基金份额冻结基金份额成本价（单位净值）精确到小数点后位小数。 (不提供，只份额明细提供) 分红方式红利再投资，现金分红交易账号未付收益位小数冻结未付收益位小数份额级别、、等份额最后变化日期份额最后变化日期备注 3．基金份额明细的具体内容：变更数据文件名：全部数据文件名：字段名称类型长度位置描述备注客户号投资人基金帐号基金代码份额类型无分类时填‘’ ‘’：前收费 ‘’：后收费其它，根据基金公司约定销售人代码网点号码申请确认日期有效日期确认编号份额来源认购所得，申购所得，分红所得，转换所得，过户所得，转托管所得本笔剩余份额单位成本价（单位净值）精确到小数点后位小数。交易账号份额注册日期符合规则折扣精确到小数点后位小数原申请折扣精确到小数点后位小数浮动盈亏(已考虑手续费) 精确到小数点后位小数原确认金额精确到小数点后位小数原确认份额精确到小数点后位小数备注到期日只有短期理财基金才需要填值到期日指申请日未付收益只有短期理财基金才需要填值 4．基金总份额的具体内容：变更数据文件名：全部数据文件名：字段名称类型长度位置描述备注基金代码基金总份额份额保有日期备注（以前位）四、客户交易流水 1．数据生成规则： (a) 流水数据全部采用新增记录模式，发生日期字段里的日期代表申请； (b) 基金份额、申请金额、红利金额、税收和相关费用全部用小数点后位小数表达； 2．账户确认信息的具体内容变更数据文件名：全部数据文件名：字段名类型长度位置描述备注字段名类型长度描述备注业务代码　确认代码交易发生日期　申请日期交易发生时间　申请单编号同一销售商不能重复（包括不同日期）销售商代码　交易所在地区编号具体编码托管网点号码 (若销售商采用通买通卖的大集中方式，则用销售商代码作为网点号码；否则给出二级机构编号。下同) 投资人基金帐号开户时为空，做其他交易时是必须项。对于基金账号预分配，也为必须项投资人户名　投资人户名简称　个人机构标志机构，个人个人证件类型及机构证件型个人证件类型：身份证，护照，军官证，士兵证，港澳居民来往内地通行证，户口本，外国护照其它警官文职台胞证机构证件类型：技术监督局代码，营业执照，行政机关，社会团体，军队，武警，下属机构（具有主管单位批文号），基金会其它机构投资人证件号码　法人代表姓名　经办人姓名 (对机构是必须的) 经办人证件类型同字段的个人证件类型(对机构是必须的) 经办人证件号码 (对机构是必须的) 通讯地址对开户必须投资人邮政编码对开户必须投资人电话号码　投资人传真号码　投资人地址　投资人手机号码　投资人出生日期　投资人性别女，男投资人学历 “”为初中及以下，“”为高中中专，“”为大专本科，“”为硕士及以上投资人职业代码 “”为政府部门，“”为教科文，“”为金融，“”为商贸，“”为房地产，“”为制造业，“”为自由职业，“”为其它。对于机构就是行业投资人年收入　投资人基金交易帐号投资人在销售商内开设的用于交易的帐号密函编号上交所证券帐号　深交所证券帐号　交易取消，开通交易取消，开通自助终端取消，开通对帐单寄送选择不寄送，按月，按季，半年，一年冻结截止日期冻结时用冻结原因司法冻结，主动冻结，质押冻结对于解冻，要填对应冻结的冻结原因原申请单编号对解冻必须,用于指定原冻结申请单编号投资人收款银行账户户名用于直销投资人收款银行账户帐号用于直销投资人收款银行账户开户行用于直销投资者国籍中国为‘’ 账户分红方式(原账户类型) 对于托管网点，账户默认的分红方式(:分现；：再投资)，用于户开户和登记。如销售商没有此功能，就填空，按基金的默认分红方式操作网点编号实际发生交易的网点交易确认日期　确认编号　解冻红利金额位小数位帐户冻结期间产生的红利冻结，解冻时一并解冻。交易处理返回代码出错详细信息确认失败的原因经纪人工作单位电话工作单位名称特殊代码可保存多个特殊代码(位)的值，之间用；格开。如：内部业务代码推荐人推荐人类型 :内部员工 :注册用户 :基金账户 :客户经理编号 :客户经理姓名 :其他证件有效期备注位表示对方交易账号（用于修改交易账号业务）备注字段缩短为位 3．交易申请信息的具体内容：变更数据文件名：全部数据文件名：字段名类型长度位置描述备注申请发生日期申请日期申请发生时间申请编号业务代码客户号投资人基金帐号基金代码份额类型无分类时填‘’ ‘’：前收费 ‘’：后收费其它，根据基金公司约定销售公司代码托管网点号码交易网点号码指实际的营业网点申请基金份数申请交易金额对定期定额协议，就是协议约定的金额结算币种参照国标目标基金代码用于基金转换用目标份额类型无分类时填‘’ ‘’：前收费 ‘’：后收费其它，根据基金公司约定对方基金帐号用于非交易过户对方销售人代码用于转托管用对方托管网点号码用于转托管、非交易过户巨额赎回处理标志取消，顺延销售佣金折扣率小数点后位小数分红方式 0- 红利转投，现金分红（只在分红方式变更时用）原申请单编号用于解冻时指定原冻结申请单编号或撤单时指定原申请编号冻结原因司法冻结，主动冻结，质押冻结冻结截止日期 (冻结解冻时用) 交易账号经纪人促销活动代码受理方式柜台，电话，网上，传真，其它内部业务代码内部辅助业务代码处理状态：未处理：处理成功：处理失败：已撤单：巨额赎回顺延失败原因累计已确认份额累计已确认金额协议号协议截止期限定期定额期限定期定额的指定日期资金方式民生银基通普通方式兴业银基通银联通工行网银好易联银联虚拟帐户工行银基通好易联托收银行代扣款农行网银建行网银交行网银北京银行银行编码通用银行编码（销售商编码）备注备用 4．交易确认结果的具体内容：变更数据文件名：全部数据文件名：字段名类型长度位置描述备注确认日期确认时间确认编号业务代码客户号投资人基金帐号基金代码份额类型无分类时填‘’ ‘’：前收费 ‘’：后收费其它，根据基金公司约定交易申请日期申请单编号销售人代码托管网点号码指份额的二级托管机构交易网点号码指实际的营业网点结算币种人民币为交易确认份额交易确认金额对于认购申购，指向投资者扣划的金额，含费用；对于赎回、发行不成功退款、基金终止等业务，指须划入投资者资金帐户的金额，已扣除费用；交易费过户费对专户产品，为业绩报酬印花税后收费用基金转换补差费其他费用目标基金代码用于基金转换用目标份额类型无分类时填‘’ ‘’：前收费 ‘’：后收费其它，根据基金公司约定对方基金帐号用于非交易过户对方销售人代码用于转托管用对方托管网点号码用于转托管、非交易过户交易处理返回代码的原确认流水号无用，填空分红方式红利再投资，现金分红冻结原因司法冻结，主动冻结，质押冻结冻结截止日期（冻结解冻时用）原申请单编号解冻时指定的原冻结申请单号取消协议时指定的原协议设定申请单号（代销机构可能填的是无效值）交易账号成交价位小数。就是单位净值份额余额交易处理返回信息一般为交易失败的原因兑付的未付收益位小数用于交易确认时，需要兑付未付收益兑付的份额兑付的未付收益折算的份额未付收益位小数用于非交易过户、转托管时，连带未付收益一起过户或转托管内部业务代码内部辅助业务代码备注份额级别归基金资产费用位小数归销售商费用位小数归注册机构费用位小数利息位小数备注备用 5．交易确认明细的具体内容：变更数据文件名：全部数据文件名：赎回、转托管出入、非交易过户出入、基金转换出入、份额调减，有明细字段名类型长度位置描述备注确认日期确认编号与总的确认号相同原始确认日期对于份额减少的业务，如赎回、基金转换出、非交易过户除、转托管出等业务，一笔确认，对应多笔份额明细。原确认日期、原确认编号指具体减少的那笔份额原始确认流水号本笔确认份额本笔确认金额交易费过户费对专户产品，为业绩报酬印花税后收费用其他费用交易账号明细确认编号备注 6．业绩提成流水的具体内容：变更数据文件名：全部数据文件名：字段名类型长度位置描述备注业务标志赎回分红统一确认日期确认号总确认号基金账号基金代码销售商编号网点编号交易账号份额类别申请日期申请序号份额原确认日期份额原确认编号份额注册日期确认金额位小数确认份额位小数交易费位小数过户费位小数印花税位小数后收手续费位小数其他费用位小数起初资产位小数期末资产位小数单位净值位小数累计净值位小数当前收益率位小数年化收益率位小数抵扣管理费位小数已退手续费位小数应提成金额位小数实际提成金额位小数实际提成份额位小数分红总金额位小数提成保底标志 0- 保底 1- 提成期初日期持有天数期初净值位小数期初累计净值位小数五、基金分红明细变更数据文件名：全部数据文件名：字段名类型长度位置描述备注投资人基金帐号基金代码份额类型无分类时填‘’ ‘’：前收费 ‘’：后收费其它，根据基金公司约定销售人代码网点号码分红的份额基数权益登记日持有的基金份数红利红股标志红股，红利红股份数实发红利金额不会同时存在红利总金额＝份额基数×单位分红手续费印花税对专户产品，为业绩报酬实发红利金额不包含冻结金额结算币种人民币权益登记日期分红发放日再投资发放日交易账号冻结份额冻结金额再投资单位净值位小数确认编号每单位基金分红金额位小数再投资金额位小数备注六、基金行情信息 1．基本行情信息变更数据文件名：全部数据文件名：字段名类型长度位置描述备注基金代码基金名称基金单位净值小数点后位小数基金总份额小数点后位小数申购总份额小数点后位小数。包括基金转换入赎回总份额小数点后位小数。包括基金转换出基金状态正常开放，发行，发行成功，发行失败，基金停止交易，停止申购，停止赎回，权益登记，红利发放，基金封闭，基金终止基金净值日期份额类别目前暂不用。填’’，一个基金每天只有一条行情数据。累计单位净值小数点后位小数昨日基金收益位小数万份基金收益位小数收益率位小数。一般指天年平均收益率. 用表示巨额赎回标志：表示发生巨额赎回：没有发生巨额赎回比例位小数转出确认比例位小数巨额赎回，基金转换转出确认比例超额申购标志：表示发生超额申购：没有发生超额申购比例位小数基金总净值小数点后位小数，净值日期当天的基金总净值销售服务费小数点后位小数，净值日期当天在估值系统计提的销售服务费，用于货币市场基金净值增长率位小数备注其中第位：定投状态第位：转换状态第位：转托管状态第位：合并分拆状态备注缩短为位长七、信息参数类文件名：。该文件在数据导出时由操作人员控制是否生成。包含基金信息、分红方案、销售商、网点、地区代码等多种信息，按节划分，在每节增加一行头和行尾。每次都是以全导出方式生成数据。 (a) 每节的第一行为节标题（位）和记录数（位）。没有整个文件的文件头。 (b) 每节的最后一行为’’ (c) 每一节的正文中，每行代表一条完整记录； 1．基金基本信息的具体内容：节标题为：，不足位，右边用空格补齐记录数紧跟节标题，不足位左边用补齐。字段代码字段名称类型长度位置备注基金代码基金名称币种编号 :人民币:港币:美元基金面值发行价格发行日期成立日期管理人名称托管人编号托管人名称最高募集金额位小数最低募集金额位小数份额过低期限基金认购期限基金封闭期限最低开户数量客户过少期限超额申购比例巨额赎回比例基金特征基金最新状态认购模式：金额认购；：份额认购；存续期限以月为单位份额分类例：表示分和两类基金发行方式：末日比例配售；：全程比例配售基金实际募集金额位小数基金成立确认比例位小数募集失败日期费率计算方式：费率按有效申请额计算：费率按原申请额计算费率合并方式：单笔计算：当天合并计算(分类别) ：当天合并计算(分基金) ：当天合并计算(所有) ：与已有份额合并计算(分类别) ：与已有份额合并计算(分基金) ：与已有份额合并计算(所有基金) 费用计算方式：不分段：分段累退计费，（与按原申请金额确定费率冲突）超额申购部分确认 :是；：不是默认分红方式：红利再投资：现金红利认购利息处理方式：归基金资产：转份额赎回费归基金资产比例位小数转换费归基金资产比例位小数管理费计提比例位小数基金性质普通基金保本基金货币市场基金短债类基金债券基金指数基金基金累计单位分红位小数保本到期日是否参与转换优惠基金全称产品分类公募基金；专户产品净值小数精度合同结束日期备注备用是否短期理财基金否是 2．基金交易限制的具体内容：节标题为：，不足位，右边用空格补齐记录数紧跟节标题，不足位左边用补齐。字段代码字段名称类型长度位置备注基金代码客户类型 :机构:个人首次投资最低金额小数点后位小数最少追加金额小数点后位小数最高认购限额小数点后位小数最高持有比例小数点后位小数最高持有金额小数点后位小数赎回最低份额小数点后位小数最低帐面份额小数点后位小数最低转换份额小数点后位小数定期定额最低金额小数点后位小数备注 3．分红方案的具体内容：节标题为：，不足位，右边用空格补齐记录数紧跟节标题，不足位左边用补齐。字段代码字段名称类型长度位置备注基金代码登记日红利发放日再投资日期每单位分红长度为位，其中位小数所得税率长度为位，其中位小数方案描述分红处理标志：未处理：已处理备注 4．销售商信息的具体内容：节标题为：，不足位，右边用空格补齐记录数紧跟节标题，不足位左边用补齐。字段名称类型长度位置备注销售商代码销售商名称销售商全称总部地址邮政编码销售商联系人销售商x 销售商传真号码销售商销售商银行代码销售商银行帐号银行户名销售商类型：代销；：直销销售商登记日期是否支持份额明细：无；：有明细是否支持份额类别：不支持；：支持认购申购最大折扣长度为位，其中位小数赎回

展开阅读全文