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

中国网通（集团）有限公司 发布QB/CNC-09-008-2006中国网通IPTV业务管理系统与支撑系统接口技术规范（V1.0）中国网通（集团）有限公司企业标准目 录1 范围12 规范性引用文件13 IPTV业务管理系统概述14 IPTV业务管理系统与支撑系统接口概述34.1 接口框图和参考点描述34.2 接口数据传递相关说明45 IPTV业务管理系统与97系统接口55.1 接口示意图55.2 同步IPTV产品列表消息接口55.2.1 接口描述55.2.2 接口参数65.3 添加IPTV产品接口75.3.1 接口描述75.3.2 接口参数85.4 修改IPTV产品状态接口95.4.1 接口描述95.4.2 接口参数95.5 同步IPTV产品计费策略接口105.5.1 接口描述105.5.2 接口参数105.6 添加IPTV产品计费策略接口135.6.1 接口描述135.6.2 接口参数145.7 修改IPTV产品计费策略状态接口145.7.1 接口描述145.7.2 接口参数145.8 同步IPTV产品优惠策略接口155.8.1 接口描述155.8.2 接口参数155.9 添加IPTV产品优惠策略接口165.9.1 接口描述165.9.2 接口参数165.10 修改IPTV产品优惠策略状态接口165.10.1 接口描述165.10.2 接口参数165.11 发送新开户用户资料接口165.11.1 接口描述165.11.2 接口参数165.12 修改用户电话号码接口185.12.1 接口描述185.12.2 接口参数185.13 修改用户姓名接口195.13.1 接口描述195.13.2 接口参数195.14 修改用户IPTV业务密码接口195.14.1 接口描述195.14.2 接口参数205.15 修改用户接入密码接口205.15.1 接口描述205.15.2 接口参数205.16 修改用户接入类型接口215.16.1 接口描述215.16.2 接口参数215.17 修改用户接入带宽接口215.17.1 接口描述215.17.2 接口参数215.18 修改用户接入区域代码接口225.18.1 接口描述225.18.2 接口参数225.19 修改用户付费类型接口235.19.1 接口描述235.19.2 接口参数235.20 修改用户状态接口235.20.1 接口描述235.20.2 接口参数245.21 修改用户扩展信息接口245.21.1 接口描述245.21.2 接口参数245.22 更新用户订购信息接口255.22.1 接口描述255.22.2 接口参数255.23 用户更换机顶盒数据接口265.23.1 接口描述265.23.2 接口参数265.24 发送用户消户消息接口275.24.1 接口描述275.24.2 接口参数275.25 用户业务欠费停机数据接口275.25.1 接口描述275.25.2 接口参数285.26 用户业务复机开通数据接口285.26.1 接口描述285.26.2 接口参数295.27 发送机顶盒首次开机激活认证服务器域名接口295.27.1 接口描述295.27.2 接口参数306 IPTV业务管理系统与IPTV接入认证系统接口306.1 接口示意图306.2 添加用户STB接入认证权限数据发送接口306.2.1 接口描述306.2.2 接口参数316.3 删除用户STB接入认证权限数据接口326.3.1 接口描述326.3.2 接口参数326.4 修改用户电话号码接口336.4.1 接口描述336.4.2 接口参数336.5 修改用户姓名接口336.5.1 接口描述336.5.2 接口参数336.6 修改用户接入密码接口346.6.1 接口描述346.6.2 接口参数346.7 修改用户接入类型接口346.7.1 接口描述346.7.2 接口参数356.8 修改用户接入带宽接口356.8.1 接口描述356.8.2 接口参数356.9 修改用户接入区域代码接口366.9.1 接口描述366.9.2 接口参数366.10 修改用户付费类型接口366.10.1 接口描述366.10.2 接口参数376.11 修改用户状态接口376.11.1 接口描述376.11.2 接口参数376.12 修改用户扩展信息接口386.12.1 接口描述386.12.2 接口参数387 IPTV业务管理系统与客服系统接口397.1 接口示意图397.2 查询用户信息数据接口397.2.1 接口描述397.2.2 接口参数397.3 查询用户业务使用详单数据接口417.3.1 接口描述417.3.2 接口参数417.4 发送用户投诉信息数据接口437.4.1 接口描述437.4.2 接口参数438 IPTV业务管理系统与综合帐务系统接口448.1 接口示意图448.2 上传用户业务使用帐单消息接口448.2.1 接口描述448.2.2 接口参数448.3 查询用户业务使用详单数据接口458.3.1 接口描述458.3.2 接口参数458.4 实时出帐消息接口478.4.1 接口描述478.4.2 接口参数479 IPTV业务管理系统与DSLAM网管系统接口4810 IPTV业务管理系统与BSSP接口4910.1 接口示意图4910.2 IPTV业务管理系统至BSSP用户数据同步接口4910.2.1 接口描述4910.2.2 接口参数4910.3 IPTV业务用户请求使用互联网业务重定向接口5010.3.1 接口描述5010.3.2 接口参数5010.4 BSSP至IPTV业务管理系统用户数据同步接口5010.4.1 接口描述5010.4.2 接口参数5110.5 互联网业务用户请求使用IPTV业务重定向接口5110.5.1 接口描述5110.5.2 接口参数5111 IPTV业务管理系统与预付费管理系统接口5211.1 接口示意图5211.2 预付费用户扣费请求接口5211.2.1 接口描述5211.2.2 接口参数5211.3 预付费用户余额查询接口5311.3.1 接口描述5311.3.2 接口参数5311.4 预付费用户扣费记录对帐接口5411.4.1 接口描述5411.4.2 接口参数5412 省级与区域中心IPTV业务管理系统接口5612.1 接口示意图5612.2 用户信息下发接口5712.2.1 接口描述5712.2.2 接口参数5712.3 用户激活消息接口5912.3.1 接口描述5912.3.2 接口参数5912.4 删除IPTV业务用户接口5912.4.1 接口描述5912.4.2 接口参数5912.5 修改用户姓名接口6012.5.1 接口描述6012.5.2 接口参数6012.6 修改用户IPTV业务密码接口6112.6.1 接口描述6112.6.2 接口参数6112.7 修改用户接入类型接口6112.7.1 接口描述6112.7.2 接口参数6112.8 修改用户接入带宽接口6212.8.1 接口描述6212.8.2 接口参数6212.9 修改用户接入区域代码接口6312.9.1 接口描述6312.9.2 接口参数6312.10 修改用户付费类型接口6312.10.1 接口描述6312.10.2 接口参数6312.11 修改用户状态接口6412.11.1 接口描述6412.11.2 接口参数6412.12 修改用户扩展信息接口6512.12.1 接口描述6512.12.2 接口参数6512.13 同步IPTV产品列表消息接口6512.13.1 接口描述6512.13.2 接口参数6612.14 添加IPTV产品接口6712.14.1 接口描述6712.14.2 接口参数6812.15 修改IPTV产品状态接口6912.15.1 接口描述6912.15.2 接口参数6912.16 更新用户订购信息接口6912.16.1 接口描述6912.16.2 接口参数6912.17 用户业务欠费停机数据接口7012.17.1 接口描述7012.17.2 接口参数7112.18 用户业务复机开通信息接口7112.18.1 接口描述7112.18.2 接口参数7212.19 统计信息上传接口7212.19.1 接口描述7212.19.2 接口参数7312.20 用户原始话单上传接口7312.20.1 接口描述7312.20.2 接口参数7312.21 预付费扣费请求接口7412.21.1 接口描述7412.21.2 接口参数7412.22 同步计费策略接口7512.22.1 接口描述7512.22.2 接口参数7512.23 添加IPTV产品计费策略接口7612.23.1 接口描述7612.23.2 接口参数7612.24 修改IPTV产品计费策略状态接口7712.24.1 接口描述7712.24.2 接口参数7712.25 同步用户机顶盒ID与用户帐号绑定关系接口7812.25.1 接口描述7812.25.2 接口参数7812.26 发送用户转向互联网业务主页面消息接口7912.26.1 接口描述7912.26.2 接口参数79v1 范围本规范规定了IPTV业务管理系统平台与运营支撑系统之间的接口模型，接口交互流程以及接口交互内容。本规范作为中国网通的企业应用标准，适用于IP网络环境下IPTV业务管理系统平台与运营支撑系统接口的开发。本规范只适用于中国网通内部。本规范的提出单位： 中国网通集团有限公司本规范的归口管理单位：中国网通（集团）有限公司技术部本规范的起草单位： 中国网通集团研究院中国网通（集团）有限公司技术部本标准主要起草人： 张伦泳、陶蒙华、厉盛义、姜鹏2 规范性引用文件中国网通集团IPTV应用服务系统技术规范中国网通集团IPTV业务管理系统技术规范机顶盒与IPTV业务平台接口规范CCSA组播业务系统控制逻辑接口规范（征求意见稿）3 IPTV业务管理系统概述IPTV业务系统以省为单位进行建设。每个省分为一个或多个区域，每个区域包含一个或多个地市。每个区域由一家系统提供商提供全套IPTV解决方案（包括软件系统和配套设备）。图3-1 IPTV业务管理系统建设方案IPTV业务管理系统包括用户管理，业务管理，机顶盒管理，DRM管理，统计分析，SP/CP管理，系统管理，门户管理以及计费帐务管理等功能。运营支撑系统包括97系统，IPTV接入认证系统，预付费管理系统，综合帐务系统，DSLAM网管系统，客服系统以及BSSP系统等。统计信息话单信息机顶盒激活信息订购信息产品信息用户信息区域中心IPTV业务管理系统功能认证授权系统管理话单生成统计分析省级IPTV业务管理系统功能用户管理业务管理SP/CP管理计费帐务统计分析系统管理门户管理DRM管理机顶盒管理图3-2 省级系统与区域中心系统功能框图图中蓝色部分表示省级IPTV业务管理系统功能模块，红色部分表示各区域中心IPTV业务管理系统功能模块。中间绿色和橙色部分表示省级IPTV业务管理系统与各区域中心IPTV业务管理系统之间进行同步的数据信息。4 IPTV业务管理系统与支撑系统接口概述4.1 接口框图和参考点描述省级IPTV业务管理系统运营支撑系统97系统IPTV接入认证系统客服系统综合帐务系统DSLAM网管系统BSSP预付费管理系统ABCDEFG图4-1 IPTV业务管理系统与支撑系统接口框图省级IPTV业务管理系统区域1IPTV业务管理系统区域2IPTV业务管理系统区域3IPTV业务管理系统HHH图4-2 省级IPTV业务管理系统与支撑系统接口框图参考点A：IPTV业务管理系统与97系统之间的接口。IPTV业务管理系统通过该参考点向97系统发送IPTV产品列表。用户开户在97系统内完成。用户开户时，97系统通过该参考点向IPTV业务管理系统发送新开户的用户信息，包括用户基本信息和开户时选择的产品订购信息。用户开户之后：如果用户到营业厅修改用户信息，97系统首先通过该参考点直接修改IPTV业务管理系统中用户相关信息，修改成功后再修改本地对应的用户信息；如果用户通过机顶盒修改用户信息，修改成功后由IPTV业务管理系统通过该参考点修改97系统中对应的用户信息。97系统从综合帐务系统接收用户欠费停机消息、用户业务复机消息，并通过该参考点转发给IPTV业务管理系统。IPTV业务管理系统通过该参考点发送用户激活消息给97系统。参考点B：IPTV业务管理系统与IPTV接入认证系统之间的接口。IPTV业务管理系统通过该参考点向IPTV接入认证系统发送用户接入设备（ADSL modem或STB）进行网络层接入认证时使用的相关权限信息。参考点C：IPTV业务管理系统与客服系统（如10060）之间的接口。客服系统通过该参考点向IPTV业务管理系统查询用户信息，包括用户产品订购信息、用户积分、用户IPTV业务详单等信；并通过该参考点向IPTV业务管理系统发送用户投诉信息。参考点D：IPTV业务管理系统与综合帐务系统之间的接口。IPTV业务管理系统通过该参考点向综合帐务系统发送用户业务使用帐单信息。综合帐务系统通过该参考点向IPTV业务管理系统查询用户业务使用详单信息等。参考点E：IPTV业务管理系统与DSLAM网管系统之间的接口。IPTV业务管理系统通过该参考点向DSLAM网管系统发送用户组播业务使用权限信息。参见CCSA组播业务系统控制逻辑接口规范（征求意见稿）（可能随时更新为正式行业标准）。参考点F：IPTV业务管理系统与BSSP系统之间的接口。IPTV业务管理系统通过该参考点向BSSP系统发送IPTV用户权限信息，并将IPTV用户使用宽带互联网业务的请求重定向到BSSP系统；BSSP系统通过该参考点向IPTV业务管理系统发送宽带互联网用户权限信息，并将宽带互联网用户使用IPTV业务的请求重定向到IPTV业务管理系统。参考点G：IPTV业务管理系统与预付费管理系统（如各类的卡系统）之间的接口。IPTV业务管理系统通过该参考点向预付费管理系统发起预付费用户扣费请求，查询预付费用户余额等操作；预付费管理系统定时将用户扣费情况以文本方式发送给IPTV业务管理系统完成对帐功能。参考点H：省级IPTV业务管理系统与各区域中心IPTV业务管理系统之间的接口。省级IPTV业务管理系统通过该参考点向各区域中心IPTV业务管理系统发送用户属性、产品属性、用户业务定购关系等数据。各区域中心IPTV业务管理系统通过该参考点向省级IPTV业务管理系统发送用户业务原始话单、用户业务使用情况统计等信息，以及预付费用户扣费请求。4.2 接口数据传递相关说明(1) IPTV接入认证系统可以是现有宽带（拨号）接入认证系统，也可以是为IPTV单独设置的接入认证系统。如果IPTV用户的接入权限由97系统发送到接入认证系统中，则本规范中规定的IPTV业务管理系统与IPTV接入认证系统之间的接口不是必须的，仅供参考。(2) 省级和区域中心IPTV业务管理系统中，以内容标识（contentID）做为唯一标识与内容管理、媒体交付等系统中的内容元数据建立对应关系。(3) 接口参数中的“内容”可以是单个的影片或频道，也可以是多个影片或频道的组合。(4) 接口上传递的用户密码、用户帐户余额等数据内容需经过加密后再进行传送，具体的加密/解密算法待定。(5) 省级IPTV业务管理系统向区域IPTV业务管理系统发送数据时，需根据具体数据内容选择对应的区域发送数据，或向所有下辖区域发送数据。(6) 本规范中规定的接口调用及接口参数取值是系统实现时必须支持的最小集，可根据需要进行必要扩充。(7) 本规范中规定的接口调用中，“实时调用”一般表示由其他系统动作自动触发接口调用过程；“定时调用”一般表示根据预先设定的时间点或周期由系统自动调用；“手工调用”一般表示由系统操作人员根据需要不定时进行调用。5 IPTV业务管理系统与97系统接口5.1 接口示意图97系统省级IPTV业务管理系统发送IPTV产品列表消息发送新开户的用户资料用户消户消息用户业务欠费停机信息用户业务复机开通信息发送机顶盒首次开机激活认证服务器域名发送IPTV产品优惠策略消息发送IPTV产品计费策略消息用户更换机顶盒数据修改用户信息图5-1 IPTV业务管理系统与97系统接口示意5.2 同步IPTV产品列表消息接口5.2.1 接口描述承载协议：SOAP/CORBA/XML，FTP接口方向：省级IPTV业务管理系统97系统调用接口：synProductListMessage接口功能：省级IPTV业务管理系统将IPTV产品列表发送到97系统中。备注说明：根据需要手工调用。用户开户时从产品列表中选择希望订购的产品，97系统中只保存IPTV产品列表，不保存用户产品订购关系。IPTV产品列表以数据文件形式发送给97系统。97系统成功接收该文件后，将对比本地保存的IPTV产品列表与数据文件中的产品列表。对于数据文件中包含的产品（以产品ID为唯一标识），若在本地不存在则在本地产品列表中添加对应产品，若本地已经存在则更新对应产品；对于本地产品列表中存在而数据文件中不存在的产品，保持本地产品属性不变。5.2.2 接口参数l 接口调用参数名称说明数据类型长度（字节）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：测试整型4autoContinueTag自动续订标志1：支持自动续订2：不支持自动续订整型4orderLimitation订购产品的限制条件1：18岁以下可订购2：18岁以上可订购整型4serviceID保留，暂不做规定，且在接口上传送时取值为“-1”。整型4serviceName保留，暂不做规定，且在接口上传送时取值为 “-”。字符串最大100contentList内容列表结构数组变长contentListNum内容列表元素个数，取值必须大于0整型4extInfo扩展信息。无扩展信息时取值为“-”。字符串最大1024内容列表元素定义：名称说明数据类型长度（字节）contentID内容标识整型4contentName内容名称字符串最大100independentRating独立计费标志：1：内容独立计费，不受所属产品费率限制。2：内容不独立计费。整型4billingPolicyID计费策略全局唯一标识，若内容不独立计费，此参数取值不做规定。整型4extInfo扩展信息。无扩展信息时取值为空串。字符串最大1024l 接口响应参数名称说明数据类型长度（字节）synPLMsgResponse接口调用返回状态：下载IPTV产品列表数据文件操作是否成功1：文件下载成功2：文件下载失败3：FTP服务器不可达4：FTP用户名或密码无效5：目标文件不存在整型45.3 添加IPTV产品接口5.3.1 接口描述承载协议：SOAP/CORBA/XML接口方向：省级IPTV业务管理系统97系统调用接口：addProduct接口功能：向97系统中添加单个新定义的IPTV产品。备注说明：根据需要手工调用。每个产品ID只能（productID）同时和唯一一个计费策略ID绑定（billingPolicyID）。如果对于需要同一产品如果同时定义多个资费策略，例如用户在订购某个产品时，可以选择包月或包月有限次两种订购方式，则在于IPTV业务管理系统中，需要针对该产品的两种不同的自费策略分配不同的产品ID，即在系统中按照两个不同的产品对待。这两个产品除字符策略不同外，其余内容全部相同。5.3.2 接口参数l 接口调用参数名称说明数据类型长度（字节）productID产品全局唯一标识整型4productName产品名称字符串最大100billingPolicyID计费策略全局唯一标识整型4PreferentialID优惠策略全局唯一标识，无优惠策略时取值为“-1”。整型4productTypeID保留，取值暂不做规定。整型4productType保留，取值暂不做规定。字符串最大16productStatus产品状态：1：正常4：测试整型4autoContinueTag自动续订标志1：支持自动续订2：不支持自动续订整型4orderLimitation订购产品的限制条件1：18岁以下可订购2：18岁以上可订购整型4serviceID保留，取值暂不做规定。整型4serviceName保留，取值暂不做规定。字符串最大100contentList内容列表结构数组变长contentListNum内容列表元素个数，取值必须大于0整型4extInfo扩展信息。无扩展信息时取值为空串。字符串最大1024内容列表元素定义：名称说明数据类型长度（字节）contentID内容标识整型4contentName内容名称字符串最大100independentRating独立计费标志：1：内容独立计费，不受所属产品费率限制。2：内容不独立计费。整型4billingPolicyID计费策略全局唯一标识。若内容不独立计费，此参数取值不做规定。整型4extInfo扩展信息。无扩展信息时取值为空串。字符串最大1024l 接口响应参数名称说明数据类型长度（字节）addProductResponse接口调用返回状态：添加IPTV产品操作是否成功1：添加成功2：添加失败3：目标产品已存在整型45.4 修改IPTV产品状态接口5.4.1 接口描述承载协议：SOAP/CORBA/XML接口方向：省级IPTV业务管理系统97系统调用接口：synProductStatus接口功能：修改97系统中IPTV产品状态。备注说明：根据需要手工调用。对被删除的产品的处理方法，IPTV业务管理系统和97系统可分别定义，不做统一规定。5.4.2 接口参数l 接口调用参数名称说明数据类型长度（字节）productIDList待删除的IPTV产品列表结构数组变长listNum数组元素个数，取值必须大于0整型4待删除的IPTV产品列表元素定义：名称说明数据类型长度（字节）productID产品全局唯一标识整型4productStatus产品状态：1：正常2：暂停3：注销4：删除5：测试整型4extInfo扩展信息。无扩展信息时取值为空串。字符串最大1024l 接口响应参数名称说明数据类型长度（字节）synProductStatusResponse接口调用返回状态：修改IPTV产品状态操作是否成功1：修改成功2：修改失败整型4execFailedProductList修改失败的目标产品列表若修改成功，则取值不做规定。结构数组变长listNum数组元素个数，取值大于或等于0若修改成功，则取值必须为0整型4修改失败的目标产品列表元素定义：名称说明数据类型长度（字节）productID产品全局唯一标识整型4failReason失败原因：1：目标产品ID不存在2：原状态与目标状态相同整型45.5 同步IPTV产品计费策略接口5.5.1 接口描述承载协议：SOAP/CORBA/XML，FTP接口方向：省级IPTV业务管理系统97系统调用接口：synProdBillingPolicy接口功能：省级IPTV业务管理系统将IPTV产品计费策略同步到97系统中。备注说明：根据需要手工调用。对于接口传递参数中包含的计费策略（以计费策略ID为唯一标识），若97系统中已经存在则进行更新，若97系统中不存在则添加相应的计费策略；对于97系统中已经存在但接口传递参数中不存在的计费策略，在97系统中保持不变。5.5.2 接口参数l 接口调用参数名称说明数据类型长度（字节）productBPListIPTV产品计费策略列表。结构数组变长listNum数组元素个数，取值必须大于0整型4计费策略参数定义：名称说明数据类型长度（字节）billingPolicyID计费策略全局唯一标识整型4billingPolicyName计费策略名称字符串最大100status计费策略状态：1：正常2：暂停3：注销4：删除5：测试整型4Rate基本单价，单位“分”。整型4rateUnit基本单价单位：1：包月，表示在一个自然月中无限制使用。2：包月有限次，表示在一个自然月中只能按基本单价累计使用限定的次数。3：包月限时长，表示在一个自然月中只能按基本单价累计使用限定的时长。4：包月限流量，表示在一个自然月中只能按基本单价累计使用限定的下载流量。5：包时段，表示从第一次使用业务时间点开始的一段时间内可以无限制的使用。超过包时段的时长后，重新计算包时段的起始时间点。6：包时段有限次，表示从第一次使用业务时间点开始的一段时间内只能按基本单价累计使用限定的次数。超过限定次数后，重新开始计算包时段起始时间点及限制次数。7：包时段限时长，表示从第一次使用业务时间点开始的一段时间内只能按基本单价累计使用限定的时长。例如24小时内通话180分钟。超过限定时长后，重新开始计算包时段起始时间点及限定时长。8：包时段限流量，表示从第一次使用业务时间点开始的一段时间内只能按基本单价累计使用限定的下载流量。超过限定的下载流量后，重新开始计算包时段起始时间点及限定的下载流量。9：按次，按使用次数计费。10：按时长，按使用时长计费。11：按流量，按使用下载流量计费。（若需按使用上载流量计费，可另行定义“rateUnit”取值。）12：免费，表示无限制免费使用。（若需规定免费使用周期，可另行定义“rateUnit”取值。）13：免费有限次，表示在累计使用次数未超过限定值之前可以免费使用。14：免费限时长，表示在累计使用时长未超过限定值之前可以免费使用。15：免费限流量，表示在累计使用下载流量未超过限定值之前可以免费使用。整型4rateUnitLimitParameter基本单价单位限制参数l 如果产品基本单价单位为包月有限次，取值为一个月以内按基本单价计费的限制次数，单位为“次”。l 如果产品基本单价单位为包月限时长，取值为一个月以内按基本单价计费的限制时长，单位为“秒”。l 如果产品基本单价单位为包月限流量，取值为一个月以内按基本单价计费的限制总流量，单位为“兆字节”。l 如果产品基本单价单位为包时段，取值为每次计费的使用时间段长度，在该时间段内不重复计费，单位“分钟”。如取值“720”表示12小时内可反复使用。l 如果产品基本单价单位为包时段有限次，包时段限时长，包时段限流量，取值为每次计费的使用时间段长度，在该时间段内不重复计费，单位“分钟”。具体限制参数参见“offLimitUnit”。l 如果产品基本单价单位为按次，取值为每次计费的使用次数，单位为“次”。例如，“3”表示每使用3次按基本单价计费一次。l 如果产品基本单价单位为按时长，取值每次计费的使用时长，单位为“秒”。例如，“60”表示每分钟按基本单价计费一次。l 如果产品基本单价单位为按流量，取值每次计费的下载流量，单位为“K字节”。例如，“2”表示每下载2K字节按基本单价计费一次。l 如果产品基本单价单位为免费有限次，取值为在收费之前可以免费累计使用的次数，单位为“次”。l 如果产品基本单价单位为免费限时长，取值为在收费之前可以免费累计使用的时长，单位为“分”。l 如果产品基本单价单位为免费限流量，取值为在收费之前可以免费累计使用的下载流量，单位为“M字节”。如果产品基本单价单位为其他类型，本参数无效，且对取值不做规定。整型4offLimitRate超限单价单位，即超过基本单价单位限制参数时的单价，单位“分”。若基本单价单位不是包月有限次、包月限时长、包月限流量中的任何一种，本参数无效。对取值不做规定。整型4offLimitUnit超限单价，即超过基本单价单位限制参数时的单价：l 若基本单价单位为包月有限次，取值为超过限定次数之后，每次计费的使用次数，单位为“次”。例如，“3”表示每使用3次按单价计费一次l 若基本单价单位为包月限时长，取值为超过限定时长之后，每次计费的使用时长，单位为“秒”。例如，“60”表示每分钟按单价计费一次。l 若基本单价单位为包月限流量，取值为超过限定流量之后，每次计费的下载流量，单位为“K字节”。例如，“2048”表示每下载2M字节按单价计费一次。l 若基本单价单位为包时段有限次，取值为限定时间段内的限制次数，单位“次”。l 若基本单价单位为包时段限时长，取值为限定时间段内的限制时长，单位“分”。l 若基本单价单位为包时段限流量，取值为限定时间段内的限制下载流量，单位“M字节”。若基本单价单位为其他，本参数无效。整型4extInfo扩展信息。无扩展信息时取值为空串。字符串最大1024l 接口响应参数名称说明数据类型长度（字节）synPBPResponse接口调用返回状态：同步IPTV产品计费策略信息操作是否成功1：同步成功2：同步失败整型45.6 添加IPTV产品计费策略接口5.6.1 接口描述承载协议：SOAP/CORBA/XML，FTP接口方向：省级IPTV业务管理系统97系统调用接口：addProdBillingPolicy接口功能：向97系统中添加单个新定义的IPTV产品计费策略。备注说明：根据需要手工调用。5.6.2 接口参数l 接口调用参数名称说明数据类型长度（字节）billingPolicyID计费策略全局唯一标识整型4billingPolicyName计费策略名称字符串最大100status计费策略状态：1：正常5：测试整型4Rate基本单价，单位“分”。整型4rateUnit基本单价单位，参见5.5。整型4rateUnitLimitParameter基本单价单位限制参数，参见5.5。整型4offLimitRate超限单价单位，参见5.5。整型4offLimitUnit超限单价，即超过基本单价单位限制参数时的单价，参见5.5。整型4extInfo扩展信息。无扩展信息时取值为空串。字符串最大1024l 接口响应参数名称说明数据类型长度（字节）addPBPResponse接口调用返回状态：添加计费策略信息操作是否成功1：添加成功2：添加失败3：目标计费策略ID已存在整型45.7 修改IPTV产品计费策略状态接口5.7.1 接口描述承载协议：SOAP/CORBA/XML，FTP接口方向：省级IPTV业务管理系统97系统调用接口：synPBPStatus接口功能：修改97系统中IPTV产品计费策略状态。备注说明：根据需要手工调用。对被删除的产品计费策略的处理方法，IPTV业务管理系统和97系统可分别定义，不做统一规定。5.7.2 接口参数l 接口调用参数名称说明数据类型长度（字节）productBPList计费策略列表结构数组变长listNum数组元素个数，取值必须大于0整型4计费策略参数定义：名称说明数据类型长度（字节）billingPolicyID计费策略全局唯一标识整型4status计费策略状态：1：正常2：暂停3：注销4：删除5：测试整型4extInfo扩展信息。无扩展信息时取值为空串。字符串最大1024l 接口响应参数名称说明数据类型长度（字节）synPBPStatusResponse接口调用返回状态：修改计费策略状态操作是否成功1：修改成功2：修改失败整型4execFailedPBPList修改失败的目标计费策略列表若修改成功，则取值不做规定。结构数组变长listNum数组元素个数，取值大于或等于0若修改成功，则取值必须为0整型4不存在的目标计费策略列表元素定义：名称说明数据类型长度（字节）billingPolicyID计费策略全局唯一标识整型4failReason失败原因：1：目标产品计费策略ID不存在2：原状态与目标状态相同整型45.8 同步IPTV产品优惠策略接口5.8.1 接口描述承载协议：SOAP/CORBA/XML，FTP接口方向：省级IPTV业务管理系统97系统调用接口：synProdPreferentialPolicy接口功能：省级IPTV业务管理系统将IPTV产品优惠策略同步到97系统中。备注说明：根据需要手工调用。对于接口传递参数中包含的优惠策略（以优惠策略ID为唯一标识），若97系统中已经存在则进行更新，若97系统中不存在则添加相应的优惠策略；对于97系统中已经存在但接口传递参数中不存在的优惠策略，在97系统中保持不变。5.8.2 接口参数待定5.9 添加IPTV产品优惠策略接口5.9.1 接口描述承载协议：SOAP/CORBA/XML，FTP接口方向：省级IPTV业务管理系统97系统调用接口：addProdPreferentialPolicy接口功能：向97系统中添加单个新定义的IPTV产品优惠策略。备注说明：根据需要手工调用。5.9.2 接口参数待定5.10 修改IPTV产品优惠策略状态接口5.10.1 接口描述承载协议：SOAP/CORBA/XML，FTP接口方向：省级IPTV业务管理系统97系统调用接口：synPPPStatus接口功能：修改97系统中IPTV产品优惠策略状态。备注说明：根据需要手工调用。对被删除的产品优惠策略的处理方法，IPTV业务管理系统和97系统可分别定义，不做统一规定。5.10.2 接口参数待定5.11 发送新开户用户资料接口5.11.1 接口描述承载协议：SOAP/CORBA/XML接口方向：97系统省级IPTV业务管理系统调用接口：newIPTVUsr接口功能：从97系统向IPTV业务管理系统发送新开户的用户资料。备注说明：实时调用。IPTV业务管理系统中不保存全部用户信息，只保存必要的用户信息。97系统中不保存用户密码（包括IPTV业务密码和IPTV接入密码）。5.11.2 接口参数l 接口调用参数名称说明数据类型长度（字节）usrPhoneNumxDSL接入用户绑定的电话号码；用户无电话号码时取值为“-1”。整型4usrPhoneServiceContractNumxDSL接入用户绑定的电话业务合同编号；用户无电话号码时取值为“-”。字符串20usrID用户全局唯一标识整型4usrIdentityCardNum当前开户用户的身份证号码对于15位身份证号码，最右边3位用字符“-”填充字符串18usrName用户姓名字符串最大20usrIPTVAccount用户IPTV业务帐号字符串16usrIPTVPass用户IPTV业务密码字符串最大30usrNAAccount用户网络层接入帐号字符串16usrNAPass用户网络层接入密码字符串最大30usrNAType接入类型1：ADSL2：ADSL 2/2+3：VDSL4：LAN5：其他整型4usrNABandwidth接入带宽（512K/1M/2M/4M等）字符串4usrOpenTime开户时间，数据格式为：yyyyMMddHHmmss字符串14 usrType用户类型1：普通用户2：酒店用户整型4usrAreaCode区域标识，即用户所属地区的编号字符串6usrPaymentType付费类型1：预付费2：后付费整型4usrStatus用户状态，固定取值“2”，表示“开户暂停状态”，即用户新开户，第一次开机接入之前的状态标识。用户激活之后修改用户状态为“1”，表示“用户正常使用业务”整型4InstallID机顶盒第一次开机时使用的安装ID（参见机顶盒与IPTV业务平台接口规范）字符串32InstallPIN机顶盒第一次开机时使用的安装PIN（参见机顶盒与IPTV业务平台接口规范）字符串32productList产品列表结构数