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

登记过户系统与客户服务系统接口规范机密第1页共37页10/15/2019登记过户系统与客户服务系统接口规范文文档档修修改改记记录录编号日期说明编写者1、12002/5/24形成V1.0李骏2、2002.12.16接口修改，形成V2.0版。以后新修改部分用红色字体表示。主要修改：1、增加交易账号2、交易确认文件增加处理返回信息，不再利用错误代码3、确认文件增加本笔交易份额余额、单位净值4、份额明细增加份额注册日期字段5、修改文件名、文件名包含日期信息。增加全部数据导出，文件名区分6、一些字段增加了描述沈志伟3、2003-9-16形成V3.0版本1、份额明细：备注长度改为60沈志伟4、2003-10-22增加货币市场基金的未付收益相关内容，形成V3.1版本1、静态份额：增加“未付收益”、“冻结未付收益”字段2、确认数据：增加“兑付的未付收益”、“兑付的份额”、“未付收益”字段3、基金行情：增加“累计单位净值”、“基金收益”、“未分配收益”，“万份基金收益”，“收益率”字段沈志伟登记过户系统与客户服务系统接口规范机密第2页共37页10/15/20195、2003-12-25形成V3.5版本1、客户信息件增加：特殊代码、工作单位名称、工作单位电话、客服密码2、账户确认文件增加：特殊代码、工作单位名称、工作单位电话沈志伟6、2004-11-22形成V3.6版本1、基金静态份额数据，增加备注字段沈志伟7、2006-10-17形成V3.7版本1、申请表增加相关协议信息。徐昌荣8、2007-03-27对于份额明细数据，生成发生变动的份额余额对应的所有份额明细记录；9、2007-08-03行情文件中增加净值增长率，同时缩短备注字段许洪波10、20082008-02-19针对易方达增加份额对账文件许洪波11、2008-03-18确认文件中增加归注册机构费用、利息字段，备注字段加长（共100，剩19）许洪波12、2008-12-09账户信息（acco）、账户确认（accorequest）文件中增加“推荐人”字段许洪波13、2009-03-23账户信息acco文件中增加“操作网点”c_childnetno字段许洪波14、2009-04-08账户信息（acco）、账户确认（accorequest）文件中增加“推荐人类型”字段许洪波15、2009-06-22Confirm、confirmdetail的过户费，对专户产品表示业绩提成金额。Dividend文件中的印花税表示分红的业绩提成金额。许洪波16、2010-05-25Share文件备注字段增加“新增收益”(f_newincome)字段,同时缩短备注字段长度。许洪波登记过户系统与客户服务系统接口规范机密第3页共37页10/15/201917、2010-06-22TAINFO文件的fundinfo节，增加净值精度的字段，同时缩短备注字段长度。许洪波18、2010-9-21TAInfo中的changelimit节增加补充定义，可分销售机构导出转换限制数据。许洪波19、2011-08-10Request文件中协议号字段扩为20位。形成V3.73版本。许洪波20、2011-10-14为适应中央数据交换协议，形成V3.74版本。Acco、accorequest文件中的客户名称、通讯地址、经办人证件号码、学历、职业字段的长度；Request文件中的资金方式字段长度；BlackList文件的客户名称字段长度；Tainfo文件BlackList节里的客户名称字段长度；销售商代码扩为9位；许洪波21、2012-07-081、在TAInfo中，增加一个超短期理财方案设置的节点，节点名为CycleFinance，内容见接口文档2、TAInfo中的基金基本信息的具体内容，增加一个字段，是否超短期理财基金，用于表示是否短期理财基金0表示否1表示是3、基金份额明细的具体内容，增加到期日和未付收益两个字段程英杭22、2012-07-13修改交易申请信息和交易确认结果中对方销售人代码长度,由3位改成9位程英杭一、接口规范概述1．用途本接口规范仅描述登记过户系统给客户服务系统（包括CALLCENTER查询和网站查询）所提供数据的具体内容和形式。2．数据处理规则为：(a)以文本文件定长记录方式提供数据；约定：将来需要新增加的字段都增加在尾部，客服系统读记录时，不用校验记录的长度，以保持兼容。登记过户系统与客户服务系统接口规范机密第4页共37页10/15/2019(b)文件的第一行为数据的记录数(c)最后一行为’END’(d)文件数据体中，每行代表一条完整记录；(e)换行必须用回车（ODH）、换行（OAH）字符；(f)数据项类型，C:字符型；N:数字；A:字符型，填数字(g)数字如是负数，第一位用’-‘表示，占用一个整数位(h)数字左补零右对齐，字符右补空格左对齐；(i)带有小数点的数值型数据，传输时不传小数点；本接口中，没有特别说明的，都表示2位小数。(j)带下划线的字段为相应文件记录的主索引；3．包括内容本接口包含六个方面的数据：客户帐户信息、账户类确认数据、客户基金份额余额、客户交易流水（包括申请流水和确认流水）、基金分红信息和基金行情信息。4．内容更新规则为：(a)每日由登记过户系统向客户服务系统提供一次数据；(b)每日所提供的数据仅表示截至到当日做完登记过户操作后的客户信息和基金行情信息；(c)每次只提供变化（包括新增和更新）的数据；也可不定期提供全部数据（文件名区分）二、客户账户信息数据1．数据生成规则：(a)客户帐户信息包括客户基本信息和基金帐号的登记信息两个方面的内容，这两个方面的内容同步更新；(b)客户资料和客户的基金帐号资料合在一条记录里形成所谓“客户基本信息”；(c)客户基本信息既支持新增客户记录模式又支持新增基金帐号记录模式；(d)客户基本信息还支持修改已有记录模式，销户也算修改记录范畴；登记过户系统与客户服务系统接口规范机密第5页共37页10/15/2019(e)基金帐号登记信息：只要某基金帐号下的账户登记信息有变化（包括增加、修改和取消），则将与该基金帐号有关的所有基金帐号登记信息记录全部更新；2．客户基本信息的具体内容：变更数据文件名：Acco_yyyymmdd.txt，其中yyyymmdd为当天日期，以下同全部数据文件名：Acco_yyyymmdd_all.txt字段名称类型长度位置描述备注RecordFlagC11记录内容标志0-更改，1-新增账号对于全导出方式，都属于新增客户CustomerIDA122客户号对于销户后再开基金账号的，客户编号相同，基金账号不同。标志属于新增账号IndividualOrInstitutionC114个人/机构标志0-机构，1-个人CertificateTypeC115投资人证件类型个人证件类型0-身份证，1-护照，2-军官证，3-士兵证，4-港澳居民来往内地通行证，5-户口本，6-外国护照，7-其他，8-文职证，9-警官证，A-台胞证机构证件类型0-技术监督局代码，1-营业执照，2-行政机关，3-社会团体，4-军队，5-武警，6-下属机构（具有主管单位批文号），7-基金会CertificateNoC3016投资人证件号码TAAccountIDA1246投资人基金帐号TAAccountTypeC258基金帐号类型未分类时，填’A’，表示普通账户DistributorCodeC960销售公司代码RegionCodeC469开户地区编号具体编码GB13497-92BranchCodeC973开户网点号码是托管网点，若销售机构采用通买通卖的大集中方式，用销售人代码作为网点号码；否则给出二级机构编号。下同InvestorNameC12082投资人姓名全称AccountAbbrC12202投资人姓名简称NationalityC3214国籍参考国标InstReprNameC20217法人代表姓名(对机构是必须的)TransactorNameC20237经办人姓名(对机构是必须的)登记过户系统与客户服务系统接口规范机密第6页共37页10/15/2019TransactorCertTypeC1257经办人证件类型0-身份证，1-护照，2-军官证，3-士兵证，4-回乡证，5-户口本，6-外国护照TransactorCertNoC30258经办人证件号码AddressC120288通讯地址PostCodeC6408邮政编码TelNoC22414投资人电话号码FaxNoC24436投资人传真号码EmailAddressC40460投资人E-MAIL地址MobileTelNoC24500投资人手机号码BPNoC20524投资人呼机号码InvestorsBirthdayC8544投资人出生日期SexC1552投资人性别1-男；0-女EducationLevelC3553投资人学历“01”为初中及以下，“02”为高中/中专，“03”为大专/本科，“04”为硕士及以上FamilyScaleC2556家庭人口数VocationCodeC3558投资人职业代码“01”为政府部门，“02”为教科文，“03”为金融，“04”为商贸，“05”为房地产，“06”为制造业，“07”为自由职业，“08”为其它。对于机构就是行业AnnualIncomeC8561投资人年收入CallCenterC1569CallCenter交易0-取消，1-开通InternetC1570网上交易0-取消，1-开通SelfHelpC1571自助终端交易0-取消，1-开通DeliverTypeC1572对帐单寄送选择1-不寄送，2-按月，3-按季，4-半年，5-一年ConfirmMailTypeC1573交易确认书寄送选择1-不寄送，2-确认成功寄送，3-确认不成功也寄送实际填空（无此信息）FreezingDeadlineC8574冻结截止日期（冻结时用）FrozenCauseC1582冻结原因0-司法冻结，1-主动冻结，2-质押冻结登记过户系统与客户服务系统接口规范机密第7页共37页10/15/2019AcctNameOfInvestorInClearingAgencyC60583投资人收款银行账户户名AcctNoOfInvestorInClearingAgencyC28643投资人收款银行账户帐号ClearingAgencyCodeC9671投资人收款银行账户开户行A8680帐户开通日期有效日期A8688最后修改日期有效日期C2696帐户状态N：正常；F：冻结；T：注销；A8698首次投资日期有效日期N4706一年内基金转换次数整数C12710经纪人C48722备注第1-1：对账单寄送途径1-邮寄，2-Email，3-短信C22770工作单位电话C40792工作单位名称C20832特殊代码可保存多个特殊代码(3位)的值，之间用；格开。如：A01;B01;B03C3852活动代码C40855备注2C40895推荐人C9935操作网点C1944推荐人类型1:内部员工2:注册用户3:基金账户4:客户经理编号5:客户经理姓名0:其他A8945证件有效期C100953备注以后增加字段备用3．基金账号登记信息的具体内容：变更数据文件名：Acconet_yyyymmdd.txt全部数据文件名：Acconet_yyyymmdd_all.txt字段名称类型长度位置描述备注登记过户系统与客户服务系统接口规范机密第8页共37页10/15/2019TAAccountIDA121投资人基金帐号DistributorCodeC913销售公司代码BranchCodeC922网点号码指二级份额托管机构CustomerIDA1231客户号C1743交易账号为空表示已取消登记C160开户网点标志1：开户网点0：其它网点C161账户默认分红方式0：再投资；1：现金红利C6062投资人收款银行账户户名C28122投资人收款银行账户帐号C9150投资人收款银行账户开户行3位编码C100159备注以后增加字段备用三、客户基金份额余额数据1．数据生成规则：(a)基金静