中国网通iptv业务管理系统与支撑系统接口技术规范v1.0

中国网通（集团）有限公司企业标准中国网通中国网通中国网通IPTV业务管理系统与支撑系统接业务管理系统与支撑系统接业务管理系统与支撑系统接口技术规范口技术规范口技术规范（V10）QB/CNC090082006中国网通（集团）有限公司发布目录1范围12规范性引用文件13IPTV业务管理系统概述14IPTV业务管理系统与支撑系统接口概述341接口框图和参考点描述342接口数据传递相关说明45IPTV业务管理系统与97系统接口551接口示意图552同步IPTV产品列表消息接口5521接口描述5522接口参数653添加IPTV产品接口7531接口描述7532接口参数854修改IPTV产品状态接口9541接口描述9542接口参数955同步IPTV产品计费策略接口10551接口描述10552接口参数1056添加IPTV产品计费策略接口13561接口描述13562接口参数1457修改IPTV产品计费策略状态接口14571接口描述14572接口参数1458同步IPTV产品优惠策略接口15581接口描述15582接口参数1559添加IPTV产品优惠策略接口16591接口描述16592接口参数16510修改IPTV产品优惠策略状态接口165101接口描述165102接口参数16511发送新开户用户资料接口165111接口描述165112接口参数16512修改用户电话号码接口185121接口描述185122接口参数18513修改用户姓名接口195131接口描述195132接口参数19514修改用户IPTV业务密码接口195141接口描述195142接口参数20515修改用户接入密码接口205151接口描述205152接口参数20516修改用户接入类型接口215161接口描述215162接口参数21517修改用户接入带宽接口215171接口描述215172接口参数21518修改用户接入区域代码接口225181接口描述225182接口参数22519修改用户付费类型接口235191接口描述235192接口参数23520修改用户状态接口235201接口描述235202接口参数24521修改用户扩展信息接口245211接口描述245212接口参数24522更新用户订购信息接口255221接口描述255222接口参数25523用户更换机顶盒数据接口265231接口描述265232接口参数26524发送用户消户消息接口275241接口描述275242接口参数27525用户业务欠费停机数据接口275251接口描述275252接口参数28526用户业务复机开通数据接口285261接口描述285262接口参数29527发送机顶盒首次开机激活认证服务器域名接口295271接口描述295272接口参数306IPTV业务管理系统与IPTV接入认证系统接口3061接口示意图3062添加用户STB接入认证权限数据发送接口30621接口描述30622接口参数3163删除用户STB接入认证权限数据接口32631接口描述32632接口参数3264修改用户电话号码接口33641接口描述33642接口参数3365修改用户姓名接口33651接口描述33652接口参数3366修改用户接入密码接口34661接口描述34662接口参数3467修改用户接入类型接口34671接口描述34672接口参数3568修改用户接入带宽接口35681接口描述35682接口参数3569修改用户接入区域代码接口36691接口描述36692接口参数36610修改用户付费类型接口366101接口描述366102接口参数37611修改用户状态接口376111接口描述376112接口参数37612修改用户扩展信息接口386121接口描述386122接口参数387IPTV业务管理系统与客服系统接口3971接口示意图3972查询用户信息数据接口39721接口描述39722接口参数3973查询用户业务使用详单数据接口41731接口描述41732接口参数4174发送用户投诉信息数据接口43741接口描述43742接口参数438IPTV业务管理系统与综合帐务系统接口4481接口示意图4482上传用户业务使用帐单消息接口44821接口描述44822接口参数4483查询用户业务使用详单数据接口45831接口描述45832接口参数4584实时出帐消息接口47841接口描述47842接口参数479IPTV业务管理系统与DSLAM网管系统接口4810IPTV业务管理系统与BSSP接口49101接口示意图49102IPTV业务管理系统至BSSP用户数据同步接口491021接口描述491022接口参数49103IPTV业务用户请求使用互联网业务重定向接口501031接口描述501032接口参数50104BSSP至IPTV业务管理系统用户数据同步接口501041接口描述501042接口参数51105互联网业务用户请求使用IPTV业务重定向接口511051接口描述511052接口参数5111IPTV业务管理系统与预付费管理系统接口52111接口示意图52112预付费用户扣费请求接口521121接口描述521122接口参数52113预付费用户余额查询接口531131接口描述531132接口参数53114预付费用户扣费记录对帐接口541141接口描述541142接口参数5412省级与区域中心IPTV业务管理系统接口56121接口示意图56122用户信息下发接口571221接口描述571222接口参数57123用户激活消息接口591231接口描述591232接口参数59124删除IPTV业务用户接口591241接口描述591242接口参数59125修改用户姓名接口601251接口描述601252接口参数60126修改用户IPTV业务密码接口611261接口描述611262接口参数61127修改用户接入类型接口611271接口描述611272接口参数61128修改用户接入带宽接口621281接口描述621282接口参数62129修改用户接入区域代码接口631291接口描述631292接口参数631210修改用户付费类型接口6312101接口描述6312102接口参数631211修改用户状态接口6412111接口描述6412112接口参数641212修改用户扩展信息接口6512121接口描述6512122接口参数651213同步IPTV产品列表消息接口6512131接口描述6512132接口参数661214添加IPTV产品接口6712141接口描述6712142接口参数681215修改IPTV产品状态接口6912151接口描述6912152接口参数691216更新用户订购信息接口6912161接口描述6912162接口参数691217用户业务欠费停机数据接口7012171接口描述7012172接口参数711218用户业务复机开通信息接口7112181接口描述7112182接口参数721219统计信息上传接口7212191接口描述7212192接口参数731220用户原始话单上传接口7312201接口描述7312202接口参数731221预付费扣费请求接口7412211接口描述7412212接口参数741222同步计费策略接口7512221接口描述7512222接口参数751223添加IPTV产品计费策略接口7612231接口描述7612232接口参数761224修改IPTV产品计费策略状态接口7712241接口描述7712242接口参数771225同步用户机顶盒ID与用户帐号绑定关系接口7812251接口描述7812252接口参数781226发送用户转向互联网业务主页面消息接口7912261接口描述7912262接口参数791范围本规范规定了IPTV业务管理系统平台与运营支撑系统之间的接口模型，接口交互流程以及接口交互内容。本规范作为中国网通的企业应用标准，适用于IP网络环境下IPTV业务管理系统平台与运营支撑系统接口的开发。本规范只适用于中国网通内部。本规范的提出单位中国网通集团有限公司本规范的归口管理单位中国网通（集团）有限公司技术部本规范的起草单位中国网通集团研究院中国网通（集团）有限公司技术部本标准主要起草人张伦泳、陶蒙华、厉盛义、姜鹏2规范性引用文件中国网通集团IPTV应用服务系统技术规范中国网通集团IPTV业务管理系统技术规范机顶盒与IPTV业务平台接口规范CCSA组播业务系统控制逻辑接口规范（征求意见稿）3IPTV业务管理系统概述IPTV业务系统以省为单位进行建设。每个省分为一个或多个区域，每个区域包含一个或多个地市。每个区域由一家系统提供商提供全套IPTV解决方案（包括软件系统和配套设备）。图31IPTV业务管理系统建设方案IPTV业务管理系统包括用户管理，业务管理，机顶盒管理，DRM管理，统计分析，SP/CP管理，系统管理，门户管理以及计费帐务管理等功能。运营支撑系统包括97系统，IPTV接入认证系统，预付费管理系统，综合帐务系统，DSLAM网管系统，客服系统以及BSSP系统等。统计信息话单信息机顶盒激活信息订购信息产品信息用户信息区域中心IPTV业务管理系统功能认证授权系统管理话单生成统计分析省级IPTV业务管理系统功能用户管理业务管理SP/CP管理计费帐务统计分析系统管理门户管理DRM管理机顶盒管理图32省级系统与区域中心系统功能框图图中蓝色部分表示省级IPTV业务管理系统功能模块，红色部分表示各区域中心IPTV业务管理系统功能模块。中间绿色和橙色部分表示省级IPTV业务管理系统与各区域中心IPTV业务管理系统之间进行同步的数据信息。4IPTV业务管理系统与支撑系统接口概述41接口框图和参考点描述省级IPTV业务管理系统运营支撑系统97系统IPTV接入认证系统客服系统综合帐务系统DSLAM网管系统BSSP预付费管理系统ABCDEFG图41IPTV业务管理系统与支撑系统接口框图省级IPTV业务管理系统区域1IPTV业务管理系统区域2IPTV业务管理系统区域3IPTV业务管理系统HHH图42省级IPTV业务管理系统与支撑系统接口框图参考点AIPTV业务管理系统与97系统之间的接口。IPTV业务管理系统通过该参考点向97系统发送IPTV产品列表。用户开户在97系统内完成。用户开户时，97系统通过该参考点向IPTV业务管理系统发送新开户的用户信息，包括用户基本信息和开户时选择的产品订购信息。用户开户之后如果用户到营业厅修改用户信息，97系统首先通过该参考点直接修改IPTV业务管理系统中用户相关信息，修改成功后再修改本地对应的用户信息；如果用户通过机顶盒修改用户信息，修改成功后由IPTV业务管理系统通过该参考点修改97系统中对应的用户信息。97系统从综合帐务系统接收用户欠费停机消息、用户业务复机消息，并通过该参考点转发给IPTV业务管理系统。IPTV业务管理系统通过该参考点发送用户激活消息给97系统。参考点BIPTV业务管理系统与IPTV接入认证系统之间的接口。IPTV业务管理系统通过该参考点向IPTV接入认证系统发送用户接入设备（ADSLMODEM或STB）进行网络层接入认证时使用的相关权限信息。参考点CIPTV业务管理系统与客服系统（如10060）之间的接口。客服系统通过该参考点向IPTV业务管理系统查询用户信息，包括用户产品订购信息、用户积分、用户IPTV业务详单等信；并通过该参考点向IPTV业务管理系统发送用户投诉信息。参考点DIPTV业务管理系统与综合帐务系统之间的接口。IPTV业务管理系统通过该参考点向综合帐务系统发送用户业务使用帐单信息。综合帐务系统通过该参考点向IPTV业务管理系统查询用户业务使用详单信息等。参考点EIPTV业务管理系统与DSLAM网管系统之间的接口。IPTV业务管理系统通过该参考点向DSLAM网管系统发送用户组播业务使用权限信息。参见CCSA组播业务系统控制逻辑接口规范（征求意见稿）（可能随时更新为正式行业标准）。参考点FIPTV业务管理系统与BSSP系统之间的接口。IPTV业务管理系统通过该参考点向BSSP系统发送IPTV用户权限信息，并将IPTV用户使用宽带互联网业务的请求重定向到BSSP系统；BSSP系统通过该参考点向IPTV业务管理系统发送宽带互联网用户权限信息，并将宽带互联网用户使用IPTV业务的请求重定向到IPTV业务管理系统。参考点GIPTV业务管理系统与预付费管理系统（如各类的卡系统）之间的接口。IPTV业务管理系统通过该参考点向预付费管理系统发起预付费用户扣费请求，查询预付费用户余额等操作；预付费管理系统定时将用户扣费情况以文本方式发送给IPTV业务管理系统完成对帐功能。参考点H省级IPTV业务管理系统与各区域中心IPTV业务管理系统之间的接口。省级IPTV业务管理系统通过该参考点向各区域中心IPTV业务管理系统发送用户属性、产品属性、用户业务定购关系等数据。各区域中心IPTV业务管理系统通过该参考点向省级IPTV业务管理系统发送用户业务原始话单、用户业务使用情况统计等信息，以及预付费用户扣费请求。42接口数据传递相关说明1IPTV接入认证系统可以是现有宽带（拨号）接入认证系统，也可以是为IPTV单独设置的接入认证系统。如果IPTV用户的接入权限由97系统发送到接入认证系统中，则本规范中规定的IPTV业务管理系统与IPTV接入认证系统之间的接口不是必须的，仅供参考。2省级和区域中心IPTV业务管理系统中，以内容标识（CONTENTID）做为唯一标识与内容管理、媒体交付等系统中的内容元数据建立对应关系。3接口参数中的“内容”可以是单个的影片或频道，也可以是多个影片或频道的组合。4接口上传递的用户密码、用户帐户余额等数据内容需经过加密后再进行传送，具体的加密/解密算法待定。5省级IPTV业务管理系统向区域IPTV业务管理系统发送数据时，需根据具体数据内容选择对应的区域发送数据，或向所有下辖区域发送数据。6本规范中规定的接口调用及接口参数取值是系统实现时必须支持的最小集，可根据需要进行必要扩充。7本规范中规定的接口调用中，“实时调用”一般表示由其他系统动作自动触发接口调用过程；“定时调用”一般表示根据预先设定的时间点或周期由系统自动调用；“手工调用”一般表示由系统操作人员根据需要不定时进行调用。5IPTV业务管理系统与97系统接口51接口示意图97系统省级IPTV业务管理系统发送IPTV产品列表消息发送新开户的用户资料用户消户消息用户业务欠费停机信息用户业务复机开通信息发送机顶盒首次开机激活认证服务器域名发送IPTV产品优惠策略消息发送IPTV产品计费策略消息用户更换机顶盒数据修改用户信息图51IPTV业务管理系统与97系统接口示意52同步IPTV产品列表消息接口521接口描述承载协议SOAP/CORBA/XML，FTP接口方向省级IPTV业务管理系统97系统调用接口SYNPRODUCTLISTMESSAGE接口功能省级IPTV业务管理系统将IPTV产品列表发送到97系统中。备注说明根据需要手工调用。用户开户时从产品列表中选择希望订购的产品，97系统中只保存IPTV产品列表，不保存用户产品订购关系。IPTV产品列表以数据文件形式发送给97系统。97系统成功接收该文件后，将对比本地保存的IPTV产品列表与数据文件中的产品列表。对于数据文件中包含的产品（以产品ID为唯一标识），若在本地不存在则在本地产品列表中添加对应产品，若本地已经存在则更新对应产品；对于本地产品列表中存在而数据文件中不存在的产品，保持本地产品属性不变。522接口参数接口调用参数名称说明数据类型长度（字节）PRODUCTLISTFILENAMEIPTV产品列表文本文件全路径名。字符串最大1024PRODUCTLISTFILESRVADDR存放IPTV产品列表文本文件的FTP服务器IP地址。整型4PRODUCTLISTFILESRVACCOUNT存放IPTV产品列表文本文件的FTP服务器帐号，空串表示采用默认帐号。字符串最大20PRODUCTLISTFILESRVPASS存放IPTV产品列表文本文件的FTP服务器密码，空串表示采用默认密码字符串最大20IPTV产品列表文本文件每两行或多行表示一个产品。每行的每个参数之间用“/”分隔。如果一个产品只包含一个内容项，每两行表示一个产品，其中第一行为产品参数，第二行为内容参数。如果产品包含多个内容项，其中第一行为产品参数，第二行开始的连续若干行（行数与内容项数相等）为内容参数。若参数本身包含字符“/”，则用连续的两个字符“/”表示单个字符“/”。产品参数定义名称说明数据类型长度（字节）PRODUCTID产品全局唯一标识整型4PRODUCTNAME产品名称字符串最大100BILLINGPOLICYID计费策略全局唯一标识整型4PREFERENTIALID优惠策略全局唯一标识，无优惠策略时取值为“1”。整型4PRODUCTTYPEID保留，取值暂不做规定。整型4PRODUCTTYPE保留，取值暂不做规定。字符串最大16PRODUCTSTATUS产品状态1正常2暂停3注销4删除5测试整型4名称说明数据类型长度（字节）AUTOCONTINUETAG自动续订标志1支持自动续订2不支持自动续订整型4ORDERLIMITATION订购产品的限制条件118岁以下可订购218岁以上可订购整型4SERVICEID保留，暂不做规定，且在接口上传送时取值为“1”。整型4SERVICENAME保留，暂不做规定，且在接口上传送时取值为“”。字符串最大100CONTENTLIST内容列表结构数组变长CONTENTLISTNUM内容列表元素个数，取值必须大于0整型4EXTINFO扩展信息。无扩展信息时取值为“”。字符串最大1024内容列表元素定义名称说明数据类型长度（字节）CONTENTID内容标识整型4CONTENTNAME内容名称字符串最大100INDEPENDENTRATING独立计费标志1内容独立计费，不受所属产品费率限制。2内容不独立计费。整型4BILLINGPOLICYID计费策略全局唯一标识，若内容不独立计费，此参数取值不做规定。整型4EXTINFO扩展信息。无扩展信息时取值为空串。字符串最大1024接口响应参数53添加IPTV产品接口531接口描述承载协议SOAP/CORBA/XML接口方向省级IPTV业务管理系统97系统调用接口ADDPRODUCT名称说明数据类型长度（字节）SYNPLMSGRESPONSE接口调用返回状态下载IPTV产品列表数据文件操作是否成功1文件下载成功2文件下载失败3FTP服务器不可达4FTP用户名或密码无效5目标文件不存在整型4接口功能向97系统中添加单个新定义的IPTV产品。备注说明根据需要手工调用。每个产品ID只能（PRODUCTID）同时和唯一一个计费策略ID绑定（BILLINGPOLICYID）。如果对于需要同一产品如果同时定义多个资费策略，例如用户在订购某个产品时，可以选择包月或包月有限次两种订购方式，则在于IPTV业务管理系统中，需要针对该产品的两种不同的自费策略分配不同的产品ID，即在系统中按照两个不同的产品对待。这两个产品除字符策略不同外，其余内容全部相同。532接口参数接口调用参数名称说明数据类型长度（字节）PRODUCTID产品全局唯一标识整型4PRODUCTNAME产品名称字符串最大100BILLINGPOLICYID计费策略全局唯一标识整型4PREFERENTIALID优惠策略全局唯一标识，无优惠策略时取值为“1”。整型4PRODUCTTYPEID保留，取值暂不做规定。整型4PRODUCTTYPE保留，取值暂不做规定。字符串最大16PRODUCTSTATUS产品状态1正常4测试整型4AUTOCONTINUETAG自动续订标志1支持自动续订2不支持自动续订整型4ORDERLIMITATION订购产品的限制条件118岁以下可订购218岁以上可订购整型4SERVICEID保留，取值暂不做规定。整型4SERVICENAME保留，取值暂不做规定。字符串最大100CONTENTLIST内容列表结构数组变长CONTENTLISTNUM内容列表元素个数，取值必须大于0整型4EXTINFO扩展信息。无扩展信息时取值为空串。字符串最大1024内容列表元素定义名称说明数据类型长度（字节）CONTENTID内容标识整型4CONTENTNAME内容名称字符串最大100INDEPENDENTRATING独立计费标志1内容独立计费，不受所属产品费率限制。2内容不独立计费。整型4BILLINGPOLICYID计费策略全局唯一标识。若内容不独立计费，此参数取值不做规定。整型4EXTINFO扩展信息。无扩展信息时取值为空串。字符串最大1024接口响应参数54修改IPTV产品状态接口541接口描述承载协议SOAP/CORBA/XML接口方向省级IPTV业务管理系统97系统调用接口SYNPRODUCTSTATUS接口功能修改97系统中IPTV产品状态。备注说明根据需要手工调用。对被删除的产品的处理方法，IPTV业务管理系统和97系统可分别定义，不做统一规定。542接口参数接口调用参数名称说明数据类型长度（字节）PRODUCTIDLIST待删除的IPTV产品列表结构数组变长LISTNUM数组元素个数，取值必须大于0整型4待删除的IPTV产品列表元素定义名称说明数据类型长度（字节）PRODUCTID产品全局唯一标识整型4PRODUCTSTATUS产品状态1正常2暂停3注销4删除5测试整型4EXTINFO扩展信息。无扩展信息时取值为空串。字符串最大1024接口响应参数名称说明数据类型长度（字节）ADDPRODUCTRESPONSE接口调用返回状态添加IPTV产品操作是否成功1添加成功2添加失败3目标产品已存在整型4修改失败的目标产品列表元素定义名称说明数据类型长度（字节）PRODUCTID产品全局唯一标识整型4FAILREASON失败原因1目标产品ID不存在2原状态与目标状态相同整型455同步IPTV产品计费策略接口551接口描述承载协议SOAP/CORBA/XML，FTP接口方向省级IPTV业务管理系统97系统调用接口SYNPRODBILLINGPOLICY接口功能省级IPTV业务管理系统将IPTV产品计费策略同步到97系统中。备注说明根据需要手工调用。对于接口传递参数中包含的计费策略（以计费策略ID为唯一标识），若97系统中已经存在则进行更新，若97系统中不存在则添加相应的计费策略；对于97系统中已经存在但接口传递参数中不存在的计费策略，在97系统中保持不变。552接口参数接口调用参数名称说明数据类型长度（字节）PRODUCTBPLISTIPTV产品计费策略列表。结构数组变长LISTNUM数组元素个数，取值必须大于0整型4计费策略参数定义名称说明数据类型长度（字节）BILLINGPOLICYID计费策略全局唯一标识整型4BILLINGPOLICYNAME计费策略名称字符串最大100STATUS计费策略状态整型4名称说明数据类型长度（字节）SYNPRODUCTSTATUSRESPONSE接口调用返回状态修改IPTV产品状态操作是否成功1修改成功2修改失败整型4EXECFAILEDPRODUCTLIST修改失败的目标产品列表若修改成功，则取值不做规定。结构数组变长LISTNUM数组元素个数，取值大于或等于0若修改成功，则取值必须为0整型4名称说明数据类型长度（字节）1正常2暂停3注销4删除5测试RATE基本单价，单位“分”。整型4RATEUNIT基本单价单位1包月，表示在一个自然月中无限制使用。2包月有限次，表示在一个自然月中只能按基本单价累计使用限定的次数。3包月限时长，表示在一个自然月中只能按基本单价累计使用限定的时长。4包月限流量，表示在一个自然月中只能按基本单价累计使用限定的下载流量。5包时段，表示从第一次使用业务时间点开始的一段时间内可以无限制的使用。超过包时段的时长后，重新计算包时段的起始时间点。6包时段有限次，表示从第一次使用业务时间点开始的一段时间内只能按基本单价累计使用限定的次数。超过限定次数后，重新开始计算包时段起始时间点及限制次数。7包时段限时长，表示从第一次使用业务时间点开始的一段时间内只能按基本单价累计使用限定的时长。例如24小时内通话180分钟。超过限定时长后，重新开始计算包时段起始时间点及限定时长。8包时段限流量，表示从第一次使用业务时间点开始的一段时间内只能按基本单价累计使用限定的下载流量。超过限定的下载流量后，重新开始计算包时段起始时间点及限定的下载流量。9按次，按使用次数计费。10按时长，按使用时长计费。11按流量，按使用下载流量计费。（若需按使用上载流量计费，可另行定义“RATEUNIT”取值。）12免费，表示无限制免费使用。（若需规定免费使用周期，可另行定义“RATEUNIT”取值。）13免费有限次，表示在累计使用次数未超过限定值之前可以免费使用。14免费限时长，表示在累计使用时长未超过限定值之前可以免费使用。整型4名称说明数据类型长度（字节）15免费限流量，表示在累计使用下载流量未超过限定值之前可以免费使用。RATEUNITLIMITPARAMETER基本单价单位限制参数如果产品基本单价单位为包月有限次，取值为一个月以内按基本单价计费的限制次数，单位为“次”。如果产品基本单价单位为包月限时长，取值为一个月以内按基本单价计费的限制时长，单位为“秒”。如果产品基本单价单位为包月限流量，取值为一个月以内按基本单价计费的限制总流量，单位为“兆字节”。如果产品基本单价单位为包时段，取值为每次计费的使用时间段长度，在该时间段内不重复计费，单位“分钟”。如取值“720”表示12小时内可反复使用。如果产品基本单价单位为包时段有限次，包时段限时长，包时段限流量，取值为每次计费的使用时间段长度，在该时间段内不重复计费，单位“分钟”。具体限制参数参见“OFFLIMITUNIT”。如果产品基本单价单位为按次，取值为每次计费的使用次数，单位为“次”。例如，“3”表示每使用3次按基本单价计费一次。如果产品基本单价单位为按时长，取值每次计费的使用时长，单位为“秒”。例如，“60”表示每分钟按基本单价计费一次。如果产品基本单价单位为按流量，取值每次计费的下载流量，单位为“K字节”。例如，“2”表示每下载2K字节按基本单价计费一次。如果产品基本单价单位为免费有限次，取值为在收费之前可以免费累计使用的次数，单位为“次”。如果产品基本单价单位为免费限时长，取值为在收费之前可以免费累计使用的时长，单位为“分”。如果产品基本单价单位为免费限流量，取值为在收费之前可以免费累计使用的下载流量，单位为“M字节”。如果产品基本单价单位为其他类型，本参数无效，且对取值不做规定。整型4OFFLIMITRATE超限单价单位，即超过基本单价单位限制参数时的单价，单位“分”。整型4名称说明数据类型长度（字节）若基本单价单位不是包月有限次、包月限时长、包月限流量中的任何一种，本参数无效。对取值不做规定。OFFLIMITUNIT超限单价，即超过基本单价单位限制参数时的单价若基本单价单位为包月有限次，取值为超过限定次数之后，每次计费的使用次数，单位为“次”。例如，“3”表示每使用3次按单价计费一次若基本单价单位为包月限时长，取值为超过限定时长之后，每次计费的使用时长，单位为“秒”。例如，“60”表示每分钟按单价计费一次。若基本单价单位为包月限流量，取值为超过限定流量之后，每次计费的下载流量，单位为“K字节”。例如，“2048”表示每下载2M字节按单价计费一次。若基本单价单位为包时段有限次，取值为限定时间段内的限制次数，单位“次”。若基本单价单位为包时段限时长，取值为限定时间段内的限制时长，单位“分”。若基本单价单位为包时段限流量，取值为限定时间段内的限制下载流量，单位“M字节”。若基本单价单位为其他，本参数无效。整型4EXTINFO扩展信息。无扩展信息时取值为空串。字符串最大1024接口响应参数56添加IPTV产品计费策略接口561接口描述承载协议SOAP/CORBA/XML，FTP接口方向省级IPTV业务管理系统97系统调用接口ADDPRODBILLINGPOLICY接口功能向97系统中添加单个新定义的IPTV产品计费策略。名称说明数据类型长度（字节）SYNPBPRESPONSE接口调用返回状态同步IPTV产品计费策略信息操作是否成功1同步成功2同步失败整型4备注说明根据需要手工调用。562接口参数接口调用参数名称说明数据类型长度（字节）BILLINGPOLICYID计费策略全局唯一标识整型4BILLINGPOLICYNAME计费策略名称字符串最大100STATUS计费策略状态1正常5测试整型4RATE基本单价，单位“分”。整型4RATEUNIT基本单价单位，参见55。整型4RATEUNITLIMITPARAMETER基本单价单位限制参数，参见55。整型4OFFLIMITRATE超限单价单位，参见55。整型4OFFLIMITUNIT超限单价，即超过基本单价单位限制参数时的单价，参见55。整型4EXTINFO扩展信息。无扩展信息时取值为空串。字符串最大1024接口响应参数57修改IPTV产品计费策略状态接口571接口描述承载协议SOAP/CORBA/XML，FTP接口方向省级IPTV业务管理系统97系统调用接口SYNPBPSTATUS接口功能修改97系统中IPTV产品计费策略状态。备注说明根据需要手工调用。对被删除的产品计费策略的处理方法，IPTV业务管理系统和97系统可分别定义，不做统一规定。572接口参数接口调用参数名称说明数据类型长度（字节）PRODUCTBPLIST计费策略列表结构数组变长LISTNUM数组元素个数，取值必须大于0整型4名称说明数据类型长度（字节）ADDPBPRESPONSE接口调用返回状态添加计费策略信息操作是否成功1添加成功2添加失败3目标计费策略ID已存在整型4计费策略参数定义名称说明数据类型长度（字节）BILLINGPOLICYID计费策略全局唯一标识整型4STATUS计费策略状态1正常2暂停3注销4删除5测试整型4EXTINFO扩展信息。无扩展信息时取值为空串。字符串最大1024接口响应参数不存在的目标计费策略列表元素定义名称说明数据类型长度（字节）BILLINGPOLICYID计费策略全局唯一标识整型4FAILREASON失败原因1目标产品计费策略ID不存在2原状态与目标状态相同整型458同步IPTV产品优惠策略接口581接口描述承载协议SOAP/CORBA/XML，FTP接口方向省级IPTV业务管理系统97系统调用接口SYNPRODPREFERENTIALPOLICY接口功能省级IPTV业务管理系统将IPTV产品优惠策略同步到97系统中。备注说明根据需要手工调用。对于接口传递参数中包含的优惠策略（以优惠策略ID为唯一标识），若97系统中已经存在则进行更新，若97系统中不存在则添加相应的优惠策略；对于97系统中已经存在但接口传递参数中不存在的优惠策略，在97系统中保持不变。名称说明数据类型长度（字节）SYNPBPSTATUSRESPONSE接口调用返回状态修改计费策略状态操作是否成功1修改成功2修改失败整型4EXECFAILEDPBPLIST修改失败的目标计费策略列表若修改成功，则取值不做规定。结构数组变长LISTNUM数组元素个数，取值大于或等于0若修改成功，则取值必须为0整型4582接口参数待定59添加IPTV产品优惠策略接口591接口描述承载协议SOAP/CORBA/XML，FTP接口方向省级IPTV业务管理系统97系统调用接口ADDPRODPREFERENTIALPOLICY接口功能向97系统中添加单个新定义的IPTV产品优惠策略。备注说明根据需要手工调用。592接口参数待定510修改IPTV产品优惠策略状态接口5101接口描述承载协议SOAP/CORBA/XML，FTP接口方向省级IPTV业务管理系统97系统调用接口SYNPPPSTATUS接口功能修改97系统中IPTV产品优惠策略状态。备注说明根据需要手工调用。对被删除的产品优惠策略的处理方法，IPTV业务管理系统和97系统可分别定义，不做统一规定。5102接口参数待定511发送新开户用户资料接口5111接口描述承载协议SOAP/CORBA/XML接口方向97系统省级IPTV业务管理系统调用接口NEWIPTVUSR接口功能从97系统向IPTV业务管理系统发送新开户的用户资料。备注说明实时调用。IPTV业务管理系统中不保存全部用户信息，只保存必要的用户信息。97系统中不保存用户密码（包括IPTV业务密码和IPTV接入密码）。5112接口参数接口调用参数名称说明数据类型长度（字节）USRPHONENUMXDSL接入用户绑定的电话号码；用户无电话号码时取值为“1”。整型4USRPHONESERVICECONTRACTNUMXDSL接入用户绑定的电话业务合同编号；用户无电话号码时取值为“”。字符串20USRID用户全局唯一标识整型4USRIDENTITYCARDNUM当前开户用户的身份证号码对于15位身份证号码，最右边3位用字符“”填充字符串18USRNAME用户姓名字符串最大20USRIPTVACCOUNT用户IPTV业务帐号字符串16USRIPTVPASS用户IPTV业务密码字符串最大30USRNAACCOUNT用户网络层接入帐号字符串16USRNAPASS用户网络层接入密码字符串最大30USRNATYPE接入类型1ADSL2ADSL2/23VDSL4LAN5其他整型4USRNABANDWIDTH接入带宽（512K/1M/2M/4M等）字符串4USROPENTIME开户时间，数据格式为YYYYMMDDHHMMSS字符串14USRTYPE用户类型1普通用户2酒店用户整型4USRAREACODE区域标识，即用户所属地区的编号字符串6USRPAYMENTTYPE付费类型1预付费2后付费整型4USRSTATUS用户状态，固定取值“2”，表示“开户暂停状态”，即用户新开户，第一次开机接入之前的状态标识。用户激活之后修改用户状态为“1”，表示“用户正常使用业务”整型4INSTALLID机顶盒第一次开机时使用的安装ID（参见机顶盒与IPTV业务平台接口规范）字符串32INSTALLPIN机顶盒第一次开机时使用的安装PIN（参见机顶盒与IPTV业务平台接口规范）字符串32PRODUCTLIST产品列表结构数组变长PRODUCTLISTNUM产品列表元素个数，取值必须大于0整型4SERVICEID保留，取值暂不做规定整型4SERVICENAME保留，取值暂不做规定字符串最大100USREXTINFO扩展信息。无扩展信息时取值为空串。字符串最大100产品列表元素定义名称说明数据类型长度（字节）PRODUCTID产品全局唯一标识整型4BEGINTIME开始使用时间，数据格式为YYYYMMDDHHMMSS字符串14ENDTIME结束使用时间，数据格式为YYYYMMDDHHMMSS字符串14AUTOCONTINUETAG自动续订标志1自动续订2不自动续订若产品本身不支持自动续订，则此参数无效，取值不做规定。整型4AUTOCONTINUEDURATION若产品支持自动续订，则自动续订时间长度11周21个月33个月若产品不支持自动续订，则本参数无效。整型4EXTINFO扩展信息。无扩展信息时取值为空串。字符串最大100接口响应参数512修改用户电话号码接口5121接口描述承载协议SOAP/CORBA/XML接口方向97系统省级IPTV业务管理系统调用接口MODPHONENUMBER接口功能修改省级IPTV业务管理系统中指定用户的电话号码信息。备注说明实时调用。5122接口参数接口调用参数名称说明数据类型长度（字节）USRID用户全局唯一标识整型4NEWUSRPHONENUM更新的XDSL接入用户绑定的电话号码。整型4名称说明数据类型长度（字节）NEWIPTVUSRRESPONSE接口调用返回状态添加IPTV业务用户是否成功1添加成功2添加失败3目标用户ID已存在整型4接口响应参数513修改用户姓名接口5131接口描述承载协议SOAP/CORBA/XML接口方向97系统省级IPTV业务管理系统；省级IPTV业务管理系统97系统调用接口MODUSRNAME接口功能修改目标系统中指定用户的用户姓名信息。备注说明实时调用。接口可双向调用，调用关系参见41节中参考点A相关说明。5132接口参数接口调用参数名称说明数据类型长度（字节）USRID用户全局唯一标识整型4NEWUSRNAME更新的用户姓名字符串最大20接口响应参数514修改用户IPTV业务密码接口5141接口描述承载协议SOAP/CORBA/XML接口方向97系统省级IPTV业务管理系统；省级IPTV业务管理系统97系统调用接口MODUSRIPTVPASS名称说明数据类型长度（字节）MODUPNRESPONSE接口调用返回状态修改用户电话号码操作是否成功1修改成功2修改失败3目标帐号不存在4目标值与原值相同整型4名称说明数据类型长度（字节）MODUNRESPONSE接口调用返回状态修改用户姓名操作是否成功1修改成功2修改失败3目标帐号不存在4目标值与原值相同整型4接口功能修改目标系统中指定用户的IPTV业务密码信息。备注说明实时调用。接口可双向调用，调用关系参见41节中参考点A相关说明。5142接口参数接口调用参数名称说明数据类型长度（字节）USRID用户全局唯一标识整型4NEWUSRIPTVPASS更新的用户IPTV业务密码字符串最大30接口响应参数515修改用户接入密码接口5151接口描述承载协议SOAP/CORBA/XML接口方向97系统省级IPTV业务管理系统；省级IPTV业务管理系统97系统调用接口MODUSRNAPASS接口功能修改目标系统中指定用户的接入密码信息。备注说明实时调用。接口可双向调用，调用关系参见41节中参考点A相关说明。5152接口参数接口调用参数名称说明数据类型长度（字节）USRID用户全局唯一标识整型4NEWUSRNAPASS更新的用户网络层接入密码字符串最大30接口响应参数名称说明数据类型长度（字节）MODUIPTVPRESPONSE接口调用返回状态修改用户IPTV业务密码操作是否成功1修改成功2修改失败3目标帐号不存在4目标值与原值相同整型4516修改用户接入类型接口5161接口描述承载协议SOAP/CORBA/XML接口方向97系统省级IPTV业务管理系统调用接口MODUSRNATYPE接口功能修改省级IPTV业务管理系统中指定用户的接入类型信息。备注说明实时调用。5162接口参数接口调用参数名称说明数据类型长度（字节）USRID用户全局唯一标识整型4NEWUSRNATYPE更新的接入类型1ADSL2ADSL2/23VDSL4LAN5其他整型4接口响应参数517修改用户接入带宽接口5171接口描述承载协议SOAP/CORBA/XML名称说明数据类型长度（字节）MODUNAPRESPONSE接口调用返回状态修改用户接入密码操作是否成功1修改成功2修改失败3目标帐号不存在4目标值与原值相同整型4名称说明数据类型长度（字节）MODUNATRESPONSE接口调用返回状态修改用户接入类型操作是否成功1修改成功2修改失败3目标帐号不存在4目标值与原值相同整型4接口方向97系统省级IPTV业务管理系统调用接口MODUSRNABANDWIDTH接口功能修改省级IPTV业务管理系统中指定用户的接入带宽信息。备注说明实时调用。5172接口参数接口调用参数名称说明数据类型长度（字节）USRID用户全局唯一标识整型4NEWUSRNABANDWIDTH更新的接入带宽（512K/1M/2M/4M等）字符串4接口响应参数518修改用户接入区域代码接口5181接口描述承载协议SOAP/CORBA/XML接口方向97系统省级IPTV业务管理系统调用接口MODUSRAREACODE接口功能修改省级IPTV业务管理系统中指定用户的接入区域代码信息。备注说明此接口需在派送用户移机工单之前调用，定时调用。5182接口参数接口调用参数名称说明数据类型长度（字节）USRID用户全局唯一标识整型4NEWUSRAREACODE更新的区域标识，即用户所属地区的编号字符串6接口响应参数名称说明数据类型长度（字节）MODUNABRESPONSE接口调用返回状态修改用户接入带宽操作是否成功1修改成功2修改失败3目标帐号不存在4目标值与原值相同整型4519修改用户付费类型接口5191接口描述承载协议SOAP/CORBA/XML接口方向97系统省级IPTV业务管理系统；省级IPTV业务管理系统97系统调用接口MODUSRPAYMENTTYPE接口功能修改目标系统中指定用户的付费类型信息。备注说明实时调用。接口可双向调用，调用关系参见41节中参考点A相关说明。5192接口参数接口调用参数名称说明数据类型长度（字节）USRID用户全局唯一标识整型4NEWUSRPAYMENTTYPE更新的付费类型1预付费2后付费整型4接口响应参数520修改用户状态接口5201接口描述承载协议SOAP/CORBA/XML接口方向97系统省级IPTV业务管理系统；省级IPTV业务管理系统97系统调用接口MODUSRSTATUS接口功能修改省级IPTV业务管理系统中指定用户的状态信息。名称说明数据类型长度（字节）MODUACRESPONSE接口调用返回状态修改用户接入区域代码操作是否成功1修改成功2修改失败3目标帐号不存在4目标值与原值相同整型4名称说明数据类型长度（字节）MODUPTRESPONSE接口调用返回状态修改用户接入付费类型是否成功1修改成功2修改失败3目标帐号不存在4目标值与原值相同整型4备注说明实时调用。用户状态变为欠费停机或复机开通时，如不需要实时调用可以调用批量操作接口，参见525及526。用户状态由“开户暂停”或“调试”变为“正常”时，由IPTV业务管理系统通知97系统用户状态变化。用户状态由“正常”变为“主动暂停”、“欠费停机”、“预消户”、“消户”、“调试”时，由97系统通知IPTV业务管理系统用户状态变化。调用限制条件参见41节中参考点A相关说明。5202接口参数接口调用参数名称说明数据类型长度（字节）USRID用户全局唯一标识整型4NEWUSRSTATUS更新的用户状态1正常2开户暂停，用户新开户，第一次开机接入之前的状态标识3主动暂停，用户主动要求停机的状态标识4欠费停机5预消户，用户主动要求消户或因欠费而被消户，但尚未将终端设备收回或尚未交清欠款时的状态标识6消户，已经将用户帐户注销并收回终端设备且已交清欠款后的状态标识7调试状态，用户更换机顶盒、用户移机等情况下的状态标识整型4接口响应参数521修改用户扩展信息接口5211接口描述承载协议SOAP/CORBA/XML接口方向97系统省级IPTV业务管理系统；省级IPTV业务管理系统97系统调用接口MODUSREXTINFO接口功能修改目标系统中指定用户的扩展信息。备注说明实时调用。接口可双向调用，调用关系