CDMA业务网络接口协议技术规范

年5月29日CDMA业务网络接口协议技术规范文档仅供参考保密等级:公开发放中国电信集团公司发布-09实施-09发布中国电信CDMA业务网络接口协议技术规范－管理接口协议协议规范支撑系统分册(征求意见稿0928)中国电信集团公司技术标准保密等级:公开发放中国电信集团公司发布-09实施-09发布中国电信CDMA业务网络接口协议技术规范－管理接口协议协议规范支撑系统分册(征求意见稿0928)中国电信集团公司技术标准目录目录 I前言 II中国电信CDMA业务网络接口协议规范 1-与支撑系统接口协议规范 11范围 12规范性引用文件 13缩略语 14ISMP与IT系统集成架构 15功能界定 26接口 36.1接口全视图 36.2ISMP与VSOP接口 36.3NMSC与VSOP接口 446.4ISMP与CRM关于政企EMA自动开通接口 466.5ISMP与计费系统接口 526.6ISMP与结算系统接口 607总体技术要求 677.1WebService消息类 677.2文件类 708附录 778.1规范性附录A业务能力编号及业务类型 778.2规范性附录B设备编码 788.3规范性附录C省份标识编码 808.4规范性附录D外系统编码 808.5规范性附录E场景描述 81

前言本标准是中国电信综合业务管理平台ISMP的系列标准之一,该系列标准的结构及名称预计如下:(1)中国电信CDMA业务网络设备技术规范(2)中国电信CDMA业务网络接口协议技术规范本标准主要依据中国电信集团公司的需求,结合中国电信企业技术标准的特点进行编写,随着中国电信企业技术标准管理系统的发展完善,还将制定后续的相关标准。本规范定义了中国电信综合业务管理平台ISMP(IntegratedServiceManagementPlatform)的接口规范,包括ISMP与VSOP、PPM、计费系统、结算系统之间的接口。本标准的附录A、B是规范性附录。本标准由中国电信集团公司提出并归口。本标准起草单位:中国电信股份有限公司上海研究院。本标准主要起草人:王铮,任华,方燕萍,杨迪,游玉蓉,桂思思、毕家瑜、章璋中国电信CDMA业务网络接口协议规范-与支撑系统接口协议规范范围本规范适用于中国电信综合业务管理平台(ISMP)与支撑系统集成的设计及研发,提供给为中国电信开发制造ISMP及相关业务支撑系统的设备供应商。规范性引用文件下列文件经过本文的参考而成为本规范的条款。凡是注日期的参考文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本文,凡是不注日期的参考文件,其最新版本适用于本文。<中国电信CDMA业务网络技术体制><中国电信CDMA业务网络设备技术规范>缩略语缩略语英文全名中文全名VSOP增值业务订购关系管理平台ISMPIntegratedServiceManagementPlatform综合业务管理平台销售品销售品是指针对细分目标客户群,对单个或多个产品进行包装、组合,叠加定价和差异化服务等设计后,以一个整体提供给客户的销售标的。简单地说产品叠加资费等营销属性后,即为销售品。ISMP与IT系统集成架构ISMP和VSOP系统按集团/省两级对等的架构进行集成。NMSC连接集团VSOP系统,ISMP连接省级VSOP系统,NMSC不与省级VSOP系统直接相连。VSOP建设完成后,VSOP作为IT域增值业务开通激活的唯一入口与业务平台对接,ISMP不再与CRM、网厅、掌厅等系统对接进行增值业务的开通激活。PPM未上线阶段:产品/销售品同步功能由VSOP与ISMP直联。完成产品/销售品同步功能。PPM上线阶段:产品/销售品同步功能由ISMP同步给PPM,PPM发布给VSOP.功能界定用户基本信息:IT系统负责用户基本信息的生成和管理,并同步给ISMP。CP/SP基本信息及其业务信息:ISMP负责CP/SP基本信息及其业务的生成和管理,并同步给IT系统。产品及订购关系信息:对纳入ISMP的产品,由ISMP负责产品发布、产品管理、订购关系生成,并将产品数据及其订购关系同步给相应的IT系统。批价:对纳入ISMP管理的产品,由ISMP负责仅包含原始价格信息的一次批价,并将一次批价后的话单同步给相应的IT系统,由IT系统负责优惠、合帐、减免等二次批价功能。统计:统计分析由相关的网管系统、经分系统完成,ISMP负责向上述系统提供统计分析所需的原始网络运营数据、经营分析数据。接口接口全视图ISMP与VSOP接口用户信息相关接口用户基本信息同步接口名称用户状态信息同步接口接口代码VSOPR8.6.1说明省级VSOP将在接收到用户开户基本信息后,实时将用户基本信息同步给ISMP。数据源系统省级VSOP数据方向省级VSOP->省级ISMP接口类型Webservice方式及周期实时非周期传送响应时间要求3s接口信息消息名消息类型消息方向UserInfoSyncToISMPReqRequestVSOPISMPUserInfoSyncToISMPRespResponseISMPVSOP请求消息体定义UserInfoSyncToISMPReq消息字段描述:参数名类型出现次数长度注释StreamingNoString160流水号TimeStampString114时间戳SystemIdString13交易发起系统标识具体编码请参考附录6.1.4:外系统编码SrcDeviceIDString162发端设备类型ID具体编码请参考附录6.1.2:设备编码UserIDString120用户号码UserNameString1254用户名称ProvinceIDString12用户归属省CityIDString14用户归属地市UserIDTypeInteger110:MSISDN1:PHS2:PSTN3:(保留)UserPayTypeString11用户付费类型:1:后付费用户2:准预付费用户3:预付费用户PrePaidSystemIDString0..1116如果是预付费用户类型,需要提供预付费系统标识具体编码请参考附录预付费系统标识UIMNoString10..125UIM卡号码响应消息体定义UserInfoSyncToISMPResp消息字段描述:参数名类型出现次数长度注释StreamingNoString160将调用的StreamingNo原样返回,保证调用／返回的同步ResultCodeInteger14响应代码0:成功非0:失败用户状态更新接口名称用户状态信息同步接口接口代码VSOPR8.6.2说明省级VSOP将在接收到用户状态修改信息后,实时将用户状态信息变动同步给ISMP。数据源系统省级VSOP数据方向省级VSOP->省级ISMP接口类型Webservice方式及周期实时非周期传送响应时间要求3s接口信息消息名消息类型消息方向UserStateSyncToISMPReqRequestVSOPISMPUserStateSyncToISMPRespResponseISMPVSOP请求消息体定义UserStateSyncToISMPReq消息字段描述:参数名类型出现次数长度注释StreamingNoString160流水号TimeStampString114时间戳SystemIdString13交易发起系统标识具体编码请参考附录6.1.4:外系统编码SrcDeviceIDString126发端设备ID类型具体编码请参考附录6.1.2:设备编码UserIDString120用户号码UserIDTypeInteger110:MSISDN1:PHS2:PSTN3:(保留)StateString11用户状态:0:正常2:注销3:单停4:双停响应消息体定义UserStateSyncToISMPResp消息字段描述:参数名类型出现次数长度注释StreamingNoString160将调用的StreamingNo原样返回,保证调用／返回的同步ResultCodeInteger14响应代码0:成功非0:失败用户付费类型更新接口名称用户付费类型同步接口接口代码VSOPR8.6.3说明省级VSOP将在接收到用户付费类型修改信息后,实时将用户付费类型信息变动同步给ISMP。数据源系统省级VSOP数据方向省级VSOP->省级ISMP接口类型Webservice方式及周期实时非周期传送响应时间要求3s接口信息消息名消息类型消息方向UserPayTypeSyncToISMPReqRequestVSOPISMPUserPayTypeSyncToISMPRespResponseISMPVSOP请求消息体定义UserPayTypeSyncToISMPReq消息字段描述:参数名类型出现次数长度注释StreamingNoString160流水号TimeStampString114时间戳SystemIdString13交易发起系统标识具体编码请参考附录6.1.4:外系统编码SrcDeviceIDString126发端设备ID类型具体编码请参考附录6.1.2:设备编码UserIDString120用户号码UserIDTypeInteger110:MSISDN1:PHS2:PSTN3:(保留)UserPayTypeString11用户付费类型:1:后付费用户2:准预付费用户3:预付费用户PrePaidSystemIDString0..1161如果是预付费用户类型,需要提供预付费系统标识具体编码请参考附录预付费系统标识EffectiveDateString114生效日期响应消息体定义UserPayTypeSyncToISMPResp消息字段描述:参数名类型出现次数长度注释StreamingNoString160将调用的StreamingNo原样返回,保证调用／返回的同步ResultCodeInteger14响应代码0:成功非0:失败用户改号/换卡信息同步接口名称用户改号/补换卡信息同步接口接口代码VSOPR8.6说明省级VSOP将在接收到用户改号/补换卡信息后,实时将用户改号/补换卡信息同步给ISMP平台。数据源系统省级VSOP数据方向省级VSOP->ISMP平台接口类型Webservice方式及周期实时非周期传送响应时间要求3s接口信息消息名消息类型消息方向UserNoInfoSyncToISMPReqRequestVSOPISMPUserNoInfoSyncToISMPRespResponseISMPVSOP请求消息体定义UserNoInfoSyncToISMPReq消息字段描述:参数名类型出现次数长度注释StreamingNoString160流水号TimeStampString114时间戳SystemIdString13交易发起系统标识具体编码请参考附录6.1.4:外系统编码SrcDeviceIDString162发端设备类型ID具体编码请参考附录6.1.2:设备编码UserIDString120用户号码UserIDTypeInteger110:MSISDN1:PHS2:PSTN3:(保留)ActionTypeString12操作:12:改号17:换卡OldUserIDString0..120用户旧号码;在操作为:”改号”时候有效UIMNoString125UIM卡号码OldUIMNoString0..125用户旧UIM卡号码;只有在操作为”换卡”时候有效响应消息体定义UserNoInfoSyncToISMPResp消息字段描述:参数名类型出现次数长度注释StreamingNoString160将调用的StreamingNo原样返回,保证调用／返回的同步ResultCodeInteger14响应代码0:成功非0:失败ResultDescString1512结果详细原因用户业务能力同步接口名称用户业务能力同步接口接口代码VSOPR8.6.4说明省级VSOP将在接收到用户业务能力变动信息后,实时将用户业务能力信息变动同步给ISMP。数据源系统省级VSOP数据方向省级VSOP->省级ISMP接口类型Webservice方式及周期实时非周期传送响应时间要求3s接口信息消息名消息类型消息方向ServiceCapbiltySyncToISMPReqRequestVSOPISMPServiceCapbiltySyncToISMPRespResponseISMPVSOP请求消息体定义ServiceCapbiltySyncToISMPReq消息字段描述:参数名类型出现次数长度注释StreamingNoString160流水号TimeStampString114时间戳SystemIdString13交易发起系统标识具体编码请参考附录6.1.4:外系统编码SrcDeviceIDString126发端设备类型ID具体编码请参考附录6.1.2:设备编码UserIDString120用户号码UserIDTypeInteger110:MSISDN1:PHS2:PSTN3:(保留)ServiceCapbiltyIDString13业务能力编码具体编码请参考附录6.1.1:业务能力编码UpdateTypeString11操作类型:1:开通2:关闭响应消息体定义ServiceCapbiltySyncToISMPResp消息字段描述:参数名类型出现次数长度注释StreamingNoString160将调用的StreamingNo原样返回,保证调用／返回的同步ResultCodeInteger14响应代码0:成功非0:失败SP信息相关接口SP/CP信息同步接口名称SP/CP信息同步接口代码VSOPR8.8.1说明ISMP将CP/SP信息同步到VSOP。数据源系统ISMP数据方向ISMP->省级VSOP协议XMLFile/FTP方式及周期定期接口名称SP/CP信息同步接口代码VSOPR8.8.1说明ISMP将CP/SP信息同步到VSOP。数据源系统ISMP数据方向ISMP->省级VSOP接口类型Webservice方式及周期实时非周期传送响应时间要求3s接口信息消息名消息类型消息方向SPInfoSyncFromISMPReqRequestISMP->VSOPSPInfoSyncFromISMPRespResponseVSOPISMP请求消息体定义SPInfoSyncFromISMPReq消息字段描述:OPFlag仅可为1:增加和2:修改,3:删除不可用参数名类型出现次数长度注释StreamingNoString160流水号TimeStampString114时间戳SystemIdString13交易发起系统标识具体编码请参考附录6.1.4:外系统编码OPFlagInteger11动作类型:1:增加2:修改3:删除SPInfoSPInfo1SP信息SPInfo定义参数名类型出现次数长度注释SPIDString110SP编号TypeInteger11CP/SP类型:0:CP+SP1:CP2:SPNameCNString164CP/SP中文名称NameENString164CP/SP英文名称DescriptionCNString1512公司中文描述DescriptionENString1512公司英文描述CustomerCareString120SP客服电话WebsiteURLString1512SP网站的链接地址ProvinceIDString12SP归属省IDRoamPropertyInteger130:不能够提供漫游地业务1:能够提供漫游地业务,也能够提供非漫游地业务CompanyAddressString1512SP公司地址LegalRepresentativeString1512SP法人代表PrincipalString1512总负责人姓名PrincipalTelString120总负责人电话PrincipalEmailString1512总负责人emailServiceManagerString1512业务联系人ServiceManagerTelString120业务联系人电话ServiceManagerEmailString1512业务联系人emailServiceManagerAddrString1512业务联系人通信地址ServiceManagerPCString1512业务联系人邮政编码ServiceManagerFaxString1512业务联系人传真LicenseString1512SP营业执照ContractExpireDateString114SP合同到期日期AccessNOString121接入号,能够为空SettlementCycleInteger11结算周期:0:按月1:按季度2:按年SettlementPayTypeInteger11结算付费方式:0:一次性付清1:分批付款SettlementPercentString110结算百分比CSWebsiteString1512客服网址StatusInteger11SP状态:0:正常1:申请2:预注销3:注销PlatFormString1..n3SP/CP接入的管理平台的列表:具体编码请参考5.1.4:外系统编码响应消息体定义SPInfoSyncFromISMPResp消息字段描述:参数名类型出现次数长度注释StreamingNoString160将调用的StreamingNo原样返回,保证调用／返回的同步ResultCodeInteger14响应代码0:成功非0:失败ResultDescString1128结果详细原因文件格式参数名类型出现次数长度注释streamingNoString160流水号TimeStampDateTime114时间戳OPFlagInteger111:增加2:修改3:删除SPInfoSPInfo1...nSPInfo数据:SPInfo定义参数名类型出现次数长度注释SPIDString18SP编号TypeInteger11CP/SP类型:0:CP+SP1:CP2:SPnameCNString150CP/SP中文名称nameENString150CP/SP英文名称descriptionCNString1512公司中文描述descriptionENString1512公司英文描述customerCareString120SP客服电话websiteURLString1512SP网站的链接地址provinceIDString12SP归属省IDroamPropertyInteger130:不能够提供漫游地业务1:能够提供漫游地业务,也能够提供非漫游地业务companyAddressString1512SP公司地址legalRepresentativeString1512SP法人代表principalString1512总负责人姓名principalTelString120总负责人电话principalEmailString1512总负责人emailserviceManagerString1512业务联系人serviceManagerTelString120业务联系人电话serviceManagerEmailString1512业务联系人emailserviceManagerAddrString1512业务联系人通信地址serviceManagerPCString1512业务联系人邮政编码serviceManagerFaxString1512业务联系人传真licenseString1512SP营业执照contractExpireDateDateTime114SP合同到期日期accessNOString121接入号,能够为空settlementCycleInteger11结算周期:0:按月1:按季度2:按年settlementPayTypeInteger11结算付费方式:0:一次性付清1:分批付款settlementPercentString11结算百分比CSWebsiteString0…1512客服网址StatusInteger11SP状态:0:正常1:申请2:预注销3:注销SP/CP业务能力签约信息同步接口名称SP/CP业务能力签约信息同步接口代码VSOPR8.8.2说明ISMP将CP/SP业务能力签约信息同步到VSOP。数据源系统ISMP数据方向ISMP->省级VSOP接口类型Webservice方式及周期实时非周期传送响应时间要求3s接口信息消息名消息类型消息方向SPSignInfoSyncFromISMPReqRequestISMP->VSOPSPSignInfoSyncFromISMPRespResponseVSOPISMP请求消息体定义SPSignInfoSyncFromISMPReq消息字段描述参数名类型出现次数长度注释streamingNoString160流水号TimeStampString114时间戳OPFlagInteger111:增加2:修改3:删除SPSignInfoSPInfo1...nSPSignInfo数据:SPSignInfo定义参数名类型出现次数长度备注SPSignIDString12CP/SP业务能力签约编号SPIDString18CP/SP编码ServiceCapabilityIDString13业务能力编码:参见附录6.1.1EffectiveTimeString114生效时间ExpiryTimeString114失效时间响应消息体定义SPSignInfoSyncFromISMPResp消息字段描述:参数名类型出现次数长度注释StreamingNoString160将调用的StreamingNo原样返回,保证调用／返回的同步ResultCodeInteger14响应代码0:成功非0:失败ResultDescString1128结果详细原因接口名称SP/CP业务能力签约信息同步接口代码VSOPR8.8.2说明ISMP将CP/SP业务能力签约信息同步到VSOP。数据源系统ISMP数据方向ISMP->省级VSOP协议XMLFile/FTP方式及周期定期文件格式参数名类型出现次数长度注释streamingNoString160流水号TimeStampDateTime114时间戳OPFlagInteger111:增加2:修改3:删除SPSignInfoSPInfo1...nSPSignInfo数据:SPSignInfo定义参数名类型出现次数长度备注SPSignIDString1CP/SP业务能力签约编号SPIDString18CP/SP编码serviceCapabilityIDString1业务能力编码:参见附录AeffectiveTimeDateTime114生效时间expiryTimeDateTime114失效时间计费信息相关接口接口名称计费策略信息同步接口代码VSOPR8.9说明ISMP将计费策略信息同步到VSOP。数据源系统ISMP数据方向ISMP->省级VSOP接口类型Webservice方式及周期实时非周期传送响应时间要求3s接口信息消息名消息类型消息方向ChargingPolicySyncFromISMPReqRequestISMP->VSOPChargingPolicySyncFromISMPRespResponseVSOPISMP请求消息体定义ChargingPolicySyncFromISMPReq消息字段描述:参数名类型出现次数长度注释StreamingNoString160同步信息的流水号,全部由数字组成不允许出现非数字符号,且唯一标识。OpFlagInt1操作码1、增加2、删除3、修改ChargingPolicyIDString121计费策略IDChargingExecutionIDChargingExecutionInfoType1计费信息IDChargingModeIDChargingModeInfoType1..n计费模式IDDOverDInt11是否需要折上折:0:否1:是DiscountInfoDiscountInfoType0..n折扣信息DiscountInfoTypeDiscountIDtypeDiscountIDType1折扣方式类型EffectiveTimeString114折扣生效时间:YYYYMMDDhhmmss,用于日常折扣、星期折扣、节假日折扣ExpireTimeString114折扣时效时间:YYYYMMDDHhmmss,用于日常折扣、星期折扣、节假日折扣ChangingExecutionInfoType:ChargingExecutionIDString121计费信息IDChargingPointInt11计费请求发起时机:0:MO计费1:MT计费2:其它ChargePartyInt11计费方:0:OA1:DA2:SP3:FASP业务能力签约时,选择对SP计费;智能化短信(MSP)的综合类业务时,对FA计费。SubOptionInt11是否需要定购:0:需要定购1:不需要定购PresentOptionInt11是否可赠送:0:不能够赠送1:能够赠送ChargingModeInfoType:ChargingModeIDString121计费模式IDUsageLimitedInt11是否限制使用量:0:限使用量1:不限使用量UsageStartValueString0..1512仅当”是否限制使用量”为”0”时有效UsageEndValueString0..1512仅当”是否限制使用量”为”0”时有效;为空时代表无限。UsageTypeInt0..11限制量单位:0:次1:条2:流量(K)3:时间(秒)仅当”是否限制使用量”为”0”时有效TimeLimitedInt11是否限制时间:0:限时间1:不限时间TimeStartValueString0..114使用时间的最低限制值,仅当”是否限制时间”为”0”时有效,TimeEndValueString0..114使用时间的最高限制值,仅当”是否限制时间”为”0”时有效,本字段格式能够为ss,mmss,HHmmss,DDHHmmss,MMDDHHmmss,为MoneyLimitedInt11是否限制金额:0:限金额1:不限金额MoneyStartValueString0..120金额的最低限制值,仅当”是否限制金额”为”0”时有效MoneyEndValueString0..120金额的最高限制值,仅当”是否限制金额”为”0”时有效ChargingCycleInt1计费周期:0:按月1:按天2:按年3:按时CanUseInt1封顶是否让用:0:是1:否SubscriptionExtendInt11定购关系是否自动续定:1:是,自动继续定购关系2:否,计费周期结束自动解除定购BaseFeeString120基本费用FeeTypeInt11计费类型:1:包月2:包天3:包年4:包流量5:按次6:按流量7:按时长8:包时长9:包次10:其它AmountInt110当feeType为1时,本字段有效,单位为月;当feeType为2时,本字段有效,单位为天;当feeType为3时,本字段有效,单位为年;以此类推FirstMonthString0…11仅当”计费类型”为”1:包月”时有效,且计费类型为包月时该字段也为可选字段,若不出现则表示首月全价。(本期天翼视讯、IPTV/VNET专用)1:首月按天计算包月费,资费精确到分,四舍五入2:首月分段:上半月(15日前,包括15日)全价,下半月半价3:首月分段:25日前全价,26日到月末免费4:首月全价DiscountIDTypeDiscountIDString121折扣方式IDDiscountTypeInt11折扣类型:0:指定时间折扣1:指定日期折扣2:指定星期折扣3:节假日折扣4:按使用量折扣5:特定用户折扣6:跨业务折扣PriorityInt11折扣优先级:1:一级2:二级3:三级4:四级5:五级…一级>二级>三级>四级>五级>…优先级可扩展StartTimeString0..114时间折扣开始时间,仅当”折扣类型”为”0”是有效EndTimeString0..114时间折扣结束时间,仅当”折扣类型”为”0”是有效DateString0..18年月日列表,用于日期折扣,仅当”折扣类型”为”1”是有效DayInt0..11星期一到星期日,用于星期折扣1:星期一2:星期二3:星期三4:星期四5;星期五6:星期六7:星期日仅当”折扣类型”为”2”HString0..114节假日日期列表,用于节假日折扣,仅当”折扣类型”为”3”是有效UsageTypeInt0..11使用量单位:0:次1:条2:流量(K)3:时间(秒)4:金额(分)仅当”折扣类型”为”4”是有效UsageString0..120使用量,用于按使用量折扣,仅当”折扣类型”为”4”是有效UserTypeString0..n3用户类型,用于特定用户类型折扣,仅当”折扣类型”为”5”是有效ServiceListSting0..n21业务ID列表,用于跨业务折扣,仅当”折扣类型”为”6”是有效TotalValueUnitInt0..11跨业务使用量单位:0:次1:条2:流量(K)3:时间(秒)4:金额(分)仅当”折扣类型”为”6”是有效TotalValueString0..120使用量,用于跨业务折扣,仅当”折扣类型”为”6”是有效RadixInt11折扣基数:0:原始值1:上一级值ProductIDString1..n21返还对象,返还类型中0-3,返还对应的产品(必须是定购类产品,而且用户已定购)ReturnTypeInt11返还类型:0:流量返还1:次数返还2:条数返还3:时长返还4:金额返还0-3,返还类型与返还的产品的计费策略一致;4,返还到使用者帐户ReturnValueString120当返还类型为4时,若按实际值返还时,本字段填返还值;若按百分比返还时,本字段填百分比,必须携带”%”AccumulativeInt11返还值是否记入下次折扣基数:0:否1:是ReturnPointInt11返还的时机:0:即时返还1:下帐期返还响应消息体定义ChargingPolicySyncFromISMPResp消息字段描述:参数名类型出现次数长度注释StreamingNoString160将调用的StreamingNo原样返回,保证调用／返回的同步ResultCodeInteger14响应代码0:成功非0:失败ResultDescString1128结果详细原因计费策略信息同步<过渡>接口名称计费策略信息同步接口代码VSOPR8.9说明ISMP将计费策略信息同步到VSOP。数据源系统ISMP数据方向ISMP->省级VSOP协议XMLFile/FTP方式及周期定期文件格式参数名类型出现次数长度注释streamingNoString160opFlagInteger11chargingPolicyIDString121计费策略IDchargingExecutionIDChargingExecutionInfoType1计费信息IDchargingModeIDChargingModeInfoType1计费模式IDdiscountIDDiscountInfoType1折扣方式IDDOverDInteger11是否需要折上折:0:否1:是effectiveTimeString114折扣生效时间:hhmmss,用于日常折扣、星期折扣、节假日折扣expireTimeString114折扣失效时间:Hhmmss,用于日常折扣、星期折扣、节假日折扣ChangingExecutionInfoType:参数名类型出现次数长度注释chargingExecutionIDString121计费信息IDchargingPointInteger11计费请求发起时机:0:MO计费1:MT计费2:其它chargePartyInteger11计费方:0:OA1:DA2:SP仅对于点对点业务,运营商能够选择对OA或DA计费;SP业务能力签约时,选择对SP计费subOptionInteger11是否需要定购:0:需要定购1:不需要定购presentOptionInteger11是否可赠送:0:不能够赠送1:能够赠送ChargingModeInfoType:参数名类型出现次数长度注释chargingModeIDString121计费模式IDusageLimitedInteger11是否限制使用量:0:限使用量1:不限使用量usageString1512使用量限制值,仅当”是否限制使用量”为”0”时有效usageTypeInteger11限制量单位:0:次1:条2:流量(K)3:时间(秒)仅当”是否限制使用量”为”0”时有效timeLimitedInteger11是否限制时间:0:限时间1:不限时间timeStartValueString1512使用时间的最低限制值,仅当”是否限制时间”为”0”时有效timeEndValueString1512使用时间的最高限制值,仅当”是否限制时间”为”0”时有效moneyLimitedInteger11是否限制金额:0:限金额1:不限金额moneyStartValueString1512金额的最低限制值,仅当”是否限制金额”为”0”时有效moneyEndValueString1512金额的最高限制值,仅当”是否限制金额”为”0”时有效chargingCycleInteger11计费周期:0:按月1:按天2:按年3:按时canUseInteger11封顶是否让用:0:是1:否subscriptionExtendInteger11定购关系是否自动续定:1:是,自动继续定购关系2:否,计费周期结束自动解除定购baseFeeString1512基本费用rateInfoRateInfoType0..1RateInfoType定义:RateInfoType定义参数名类型出现次数长度注释rateLevelNumberInteger11rateDetailRateDetailType1..RateLevelNumber基本费,即一次性收取的基本费用,包月费、包流量费、保底费用等均由此字段标识RateDetailType定义:RateDetailType定义参数名类型出现次数长度注释levelInteger11费率级别数rateValueString1512费率(分)thresholdTypeInteger11费率门限值类型:1:使用量,使用量类型与计量单位相同2:金额(分)thresholdString1512费率门限值,即分档时档位对应门限值DiscountInfoType参数名类型出现次数长度注释discountIDString121折扣方式IDdiscountTypeInteger11折扣类型:0:指定时间折扣1:指定日期折扣2:指定星期折扣3:节假日折扣4:按使用量折扣5:特定用户折扣6:跨业务折扣priorityInteger11折扣优先级:1:一级2:二级3:三级4:四级5:五级…一级>二级>三级>四级>五级>…优先级可扩展startTimeString114时间折扣开始时间,仅当”折扣类型”为”0”是有效endTimeString114时间折扣结束时间,仅当”折扣类型”为”0”是有效dateString18年月日列表,用于日期折扣,仅当”折扣类型”为”1”是有效dayInteger11星期一到星期日,用于星期折扣1:星期一2:星期二3:星期三4:星期四5;星期五6:星期六7:星期日仅当”折扣类型”为”2”是有效holidayString114节假日日期列表,用于节假日折扣,仅当”折扣类型”为”3”是有效usageTypeInteger11使用量单位:0:次1:条2:流量(K)3:时间(秒)4:金额(分)仅当”折扣类型”为”4”是有效usageString1512使用量,用于按使用量折扣,仅当”折扣类型”为”4”是有效userTypeString1..n512用户类型,用于特定用户类型折扣,仅当”折扣类型”为”5”是有效serviceListSting1..n21业务ID列表,用于跨业务折扣,仅当”折扣类型”为”6”是有效totalValueUnitInteger11跨业务使用量单位:0:次1:条2:流量(K)3:时间(秒)4:金额(分)仅当”折扣类型”为”6”是有效totalValueString1512使用量,用于跨业务折扣,仅当”折扣类型”为”6”是有效radixInteger11折扣基数:0:原始值1:上一级值productIDString1..n21返还对象,返还类型中0-3,返还对应的产品(必须是定购类产品,而且用户已定购)returnTypeInteger11返还类型:0:流量返还1:次数返还2:条数返还3:时长返还4:金额返还0-3,返还类型与返还的产品的计费策略一致;4,返还到使用者帐户returnValueString1512折扣返还的实际值accumulativeInteger11返还值是否记入下次折扣基数:0:否1:是returnPointInteger11返还的时机:0:即时返还1:下帐期返还产品及销售品同步接口增值产品同步<过渡>接口名称增值产品同步接口<过渡>接口代码VSOPR8.4说明过渡阶段使用ISMP实时将增值产品同步给VSOP系统。数据源系统ISMP数据方向ISMP->省级VSOP接口类型Webservice方式及周期实时非周期传送响应时间要求3s接口信息消息名消息类型消息方向ProductSyncFromISMPReqRequestPPMVSOPProductSyncFromISMPRespResponseVSOPPPM请求消息体定义ProductSyncFromISMPReq消息字段描述:OPFlag仅可为1:增加和2:修改,3:删除不可用参数名类型出现次数长度注释StreamingNoString160流水号TimeStampString114时间戳SystemIdString13交易发起系统标识具体编码请参考附录6.1.4:外系统编码SPIDString110SP编号OPFlagInteger11动作1:增加2:修改3:删除ProductIDString125增值产品ID修改说明:统一按照ISMP的概念,从ProductOfferID修改为ProductIDPnameCNString164Product中文名称PnameENString164Product英文名称PdescriptionCNString1512Product中文描述PdescriptionEnString1512Producte英文描述ServiceCapabilityIDString1..n3业务能力ID列表:参见附录5.1.1:业务能力编码StatusInteger11状态:0:正常1:申请2:暂停3:预注销4:注销ChargingPolicyCNString1512计费策略描述ChargingPolicyIDString125计费策略标识SubOptionInteger11定购选项:1:需要定购2:无需定购PresentInteger11是否可赠送:0:否1:是CorpOnlyInteger11是否集团专用:0:个人用户专用1:集团专用PackageOnlyInteger11是否产品组合专用:0:否1:是(不能单卖,只能放在产品组合中)ProductOPCodeProductOPCode0..n定购、退定、点播的操作码列表SettlementCycleInteger11结算周期:0:按月1:按季度2:按年SettlementPayTypeInteger11结算付费方式:0:一次性付清1:分批付款SettlementPercentString110分成比例(最长10位)ScopeInteger11业务适用范围:0:全网业务1:省级业务ProdRelationProdRelation0..n关联的增值产品列表说明:当动作为(3:删除)的时候,不需要填写该字段;SubEffectModeString0…11定购生效方式0:即时生效1:下一账期生效WithdrawEffectModeString0…11退定生效方式0:即时生效1:下一账期生效TrialTypeString0…11是否有试用期0:无试用期1:有,试用到月底;2:有,试用时长TrialTermString0…13试用时长:仅当trialType为2时有效,填写具体时长,精度到小时ProductOPCode定义参数名类型出现次数长度注释accessNoString121接入号accessNoMatchModeInteger11接入号匹配模式0:模糊匹配1:精确匹配accessNoTypeInteger1接入号类型接入号类型0:短信1:彩信默认为0featureStrString1140特征码featureStrTypeInteger11特征码类型0:定购特征码1:退定特征码2:点播特征码3:使用特征码featureStrMatchModeInteger11特征码匹配模式0:模糊匹配1:精确匹配匹配方式ProdRelation定义参数名类型出现次数长度注释OPTypeInteger110:增加1:删除RelationTypeString11关系类型:0:互斥关系1:依赖关系2:替换关系3:主附关系RProductIDString125关联的产品ID响应消息体定义ProductSyncFromISMPReq消息字段描述:参数名类型出现次数长度注释StreamingNoString160将调用的StreamingNo原样返回,保证调用／返回的同步ResultCodeInteger14响应代码0:成功非0:失败ResultDescString1128结果详细原因(纯增值)捆绑销售品同步<过渡>接口名称(纯增值)捆绑销售品同步接口<过渡>接口代码VSOPR8.5说明过渡阶段使用ISMP实时将(纯增值)捆绑销售品同步给VSOP系统。数据源系统ISMP数据方向ISMP->省级VSOP接口类型Webservice方式及周期实时非周期传送响应时间要求3s接口信息消息名消息类型消息方向PackageSyncFromISMPReqRequestPPMVSOPPackageSyncFromISMPRespResponseVSOPPPM请求消息体定义PackageSyncFromISMPReq消息字段描述:OPFlag仅可为1:增加和2:修改,3:删除不可用参数名类型出现次数长度注释StreamingNoString160流水号TimeStampString114时间戳SystemIdString13交易发起系统标识具体编码请参考附录6.1.4:外系统编码OPFlagInteger111:增加2:修改3:删除PackageIDString125增值业务捆绑销售品ID修改说明:统一使用ISMP概念,从PProductOfferID修改为PackageIDPNameCNString164中文产品组合名称PNameENString164英文产品组合名称PDesCNString1512产品组合中文描述PDesEnString1512产品组合英文描述StatusInteger110:正常1:申请2:暂停3:预注销4:注销ChargingPolicyCNString1512计费策略描述ChargingPolicyIDString125计费策略标识VSOP不关注,可空SubOptionInteger11定购选项:1:需要定购2:无需定购?产品组合肯定需要定购。PresentOptionInteger11是否可赠送:0:否1:是CorpOnlyInteger11是否集团专用:0:个人用户专用1:集团专用 2:集团和个人都用ProductIDProducID1...n25增值产品ID列表ScopeInteger11业务适用范围:0:全网业务1:省级业务ProdOfferRelationProdOfferRelation0..n关联的增值销售品列表说明:当动作为(3:删除)的时候,不需要填写该字段;SubEffectModeString0…11定购生效方式0:即时生效1:下一账期生效WithdrawEffectModeString0…11退定生效方式0:即时生效1:下一账期生效TrialTypeString0…11是否有试用期0:无试用期1:有,试用到月底;2:有,试用时长TrialTermString0…13试用时长:仅当trialType为2时有效,填写具体时长,精度到小时ProdOfferRelation定义参数名类型出现次数长度注释OPTypeInteger110:增加1:删除RelationTypeString11关系类型:0:互斥关系(双向)1:依赖关系(依赖于,单向)RProdOfferIDString125关联的增值销售品ID响应消息体定义PackageSyncFromISMPResp消息字段描述:参数名类型出现次数长度注释StreamingNoString160将调用的StreamingNo原样返回,保证调用／返回的同步ResultCodeInteger14响应代码0:成功非0:失败ResultDescString1128结果详细原因激活相关接口订购激活接口名称订购激活接口接口代码VSOPR8.1.1说明省级VSOP向ISMP发送订购服务激活,ISMP接收后返回接收是否成功。数据源系统省级VSOP数据方向VSOP->ISMP接口类型Webservice方式及周期实时非周期传送响应时间要求3s注:捆绑类套餐订购当月,ISMP中增值子产品即时生效(免费期无效),用户订购即可使用,不以增值产品属性判断生效时间。接口消息消息名消息类型消息方向SubActionToISMPReqRequestVSOPà业务平台SubActionToISMPRespResponse业务平台àVSOP请求消息体定义SubActionToISMPReq消息字段描述:参数名类型出现次数长度注释StreamingNoString160流水号,可用于调用／提供双方比较接口调用情况６０位,从０开始,用满归零SrcDeviceTypeString12发端设备类型参见<附录5.1.2:设备编码>SrcDeviceIDString16发端设备ID参见<附录5.1.2:设备编码>OAString120定购方用户号码OATypeInteger１10:MSISDN1:ＰＨＳ2:PSTN3:(保留)DAString120使用方用户号码,默认与定购方相同,用户赠送时为受赠方号码DATypeInteger110:MSISDN1:ＰＨＳ2:PSTN3:(保留)FAString120付费方用户号码,默认与定购方相同,用户赠送时为赠方号码FATypeInteger110:MSISDN1:ＰＨＳ2:PSTN3:(保留)PProductOfferIDString0..125CRM传统+增值业务的捆绑销售品ID跨ISMP和X平台的增值业务捆绑销售品ID说明:增值业务包括:ISMP增值业务、X平台增值业务PackageIDString0..125增值业务捆绑销售品ID列表说明:如果PProductOfferID不空的时候,这个字段不用,仅作保留ProductInfoProductInfo10..n增值业务产品信息列表:包括:产品ID产品动作(新订产品、加入已有产品、替换已有产品)原产品ID(仅仅在”替换已有产品”时候有效)PackageID不为空的时候,ProductInfo节点为0传统+增值捆绑类套餐时ProductInfo节点才可为n其它情况ProductInfo节点均为1约束:在当前这种模式下,对于传统+增值捆绑套餐内的增值子产品,只能经过CRM进行退订。如果需要支持,可能需要增加接口向VOSP询问。ProductInfo定义参数名类型出现次数长度注释ProductIDString125增值业务产品IDOperTypeInteger11动作类型:0:新订产品1:加入已有产品2:替换已有产品OProductIDString125原增值业务产品ID,仅仅在OperType=2时候有效响应消息体定义SubActionToISMPResp消息字段描述:参数名类型出现次数长度注释StreamingNoString160将调用的StreamingNo原样返回,保证调用／返回的同步ResultCodeInteger14响应代码0:成功非0:失败ResultDescString1128结果详细原因ResultInfoResultInfo1..n返回信息列表,包括:产品ID,处理结果,生效时间,失效时间只有当解析报文出错时,该节点不出现。ResultInfo定义参数名类型出现次数长度注释ProductIDString125增值业务产品ID当请求包的PackageID不为空时,返回PackageIDOPResultInteger13处理结果:0:处理成功1非0:处理失败OPDescString1512详细原因EffDateString0…114定购关系生效时间,不填表示立即生效ExpDateString0…114定购关系失效时间,自动续订的不填变更激活接口名称变更激活接口接口代码VSOPR8.1.2说明省级VSOP向ISMP发送变更服务激活,ISMP接收后返回接收是否成功。数据源系统省级VSOP数据方向VSOP->ISMP接口类型Webservice方式及周期实时非周期传送响应时间要求3s接口信息消息名消息类型消息方向ChgActionToISMPReqRequestVSOPà业务平台ChgActionToISMPRespResponse业务平台àVSOP注:在捆绑类套餐变更中VSOP将原有产品订购关系失效时间及新产品订购关系生效时间传给ISMP,ISMP以VSOP为准。若为退订产品:ISMP将订购关系设为待失效,失效时间点以VSOP失效时间点为准,向VSOP返回退订成功消息。失效时间到ISMP向SP发送订购关系通知,订购关系转为注销。若为新订产品:ISMP将订购关系设为待生效,生效时间点以VSOP生效时间点为准,向VSOP返回订购成功消息。生效时间点到ISMP向SP发送订购关系通知,若通知成功ISMP将订购关系设为正常,若通知失败ISMP将订购关系注销(短彩业务),并实时将订购关系同步给VSOP,在SubsInstSynFromISMPReq消息中的OPType字段增加枚举值7:SP通知失败订购关系注销。若通知失败ISMP将订购关系注销(非短彩业务),则ISMP不回退订购关系;若替换已有产品:ISMP将原产品订购关系设为待失效,新产品的订购关系设为待生效,时间点以VSOP时间点为准,向VSOP返回替换成功消息。时间点到ISMP向SP发送订购关系通知,若通知成功ISMP将新产品订购关系设为正常,原产品订购关系设为注销,若通知SP替换失败,ISMP将新产品订购关系注销(短彩业务),原产品订购关系设为正常(如果新产品和原产品至少其中一个为短彩业务),并实时将订购关系同步给VSOP(两条消息,新产品退订通知和原产品订购通知),在SubsInstSynFromISMPReq消息中的OPType字段增加枚举值7:SP通知失败订购关系注销,8:SP通知失败订购关系正常。若通知失败ISMP将订购关系注销(如果新产品和原产品都为非短彩业务),则ISMP不回退订购关系。请求消息体定义ChgActionToISMPReq消息字段描述:参数名类型出现次数长度注释StreamingNoString160流水号,可用于调用／提供双方比较接口调用情况６０位,从０开始,用满归零SrcDeviceTypeString12发端设备类型参见<附录编码5.1.2:设备编码>SrcDeviceIDString16发端设备ID参见<附录5.1.2:设备编码>OAString120定购方用户号码OATypeInteger１10:MSISDN1:ＰＨＳ2:PSTN3:(保留)DAString120使用方用户号码,默认与定购方相同,用户赠送时为受赠方号码DATypeInteger110:MSISDN1:ＰＨＳ2:PSTN3:(保留)FAString120付费方号码FATypeInteger110:MSISDN1:ＰＨＳ2:PSTN3:(保留)PProductOfferIDString0..125CRM传统+增值业务的捆绑销售品ID跨ISMP和X平台的增值业务捆绑销售品IDPackageIDString0..125增值业务捆绑销售品ID列表(注明:变更激活接口,PackageID字段仅作保留)(注明:如果PProductOfferID不空的时候,这个字段不用,仅作保留)ProductInfoObject1..n增值业务产品信息列表:包括:产品ID产品动作(新订产品、加入已有产品、替换已有产品、退订产品、产品退出套餐)被替换的产品ID(仅仅在”替换已有产品”时候有效)PackageID不为空的时候,ProductInfo节点为0传统+增值捆绑类套餐时ProductInfo节点才可为n其它情况ProductInfo节点均为1约束:在当前这种模式下,对于传统+增值捆绑套餐内的增值子产品,只能经过CRM进行退订。如果需要支持,可能需要增加接口向VOSP询问。ProductInfo定义参数名类型出现次数长度注释ProductIDString125增值业务产品IDEffDateString0…114ProductID订购关系生效时间,当OperType为0、2时出现OperTypeInteger11动作类型:0:新订产品1:加入已有产品2:替换已有产品3:退订产品4:产品退出套餐OProductIDString125原增值业务产品ID,仅仅在OperType=2时候有效ExpDateString0…114订购关系失效时间,当OperType为2、3时出现OperType为2时,为OProductID订购关系失效时间,且要求新产品生效时间点与原产品的失效时间点相同;OperType为3时,为ProductID订购关系失效时间响应消息体定义ChgActionToISMPResp消息字段描述:参数名类型出现次数长度注释StreamingNoString160将调用的StreamingNo原样返回,保证调用／返回的同步ResultCodeInteger14响应代码0:成功非0:失败ResultDescString1128结果详细原因ResultInfoResultInfo01..n返回信息列表,包括:产品ID,处理结果,生效时间,失效时间ResultInfo定义参数名类型出现次数长度注释ProductIDString125增值业务产品IDOPResultInteger143处理结果:0:处理成功1非0:处理失败OPDescString1512详细原因EffDateString0…114定购关系生效时间,不填表示立即生效ExpDateString0…114定购关系失效时间,自动续订的不填退订激活接口名称退订激活接口接口代码VSOPR8.1.3说明省级VSOP向ISMP发送退订服务激活,ISMP接收后返回接收是否成功。数据源系统省级VSOP数据方向VSOP->ISMP接口类型Webservice方式及周期实时非周期传送响应时间要求3s接口信息消息名消息类型消息方向UnSubActionToISMPReqRequestVSOPà业务平台UnSubActionToISMPRespResponse业务平台àVSOP请求消息体定义UnSubActionToISMPReq消息字段描述:参数名类型出现次数长度注释StreamingNoString160流水号,可用于调用／提供双方比较接口调用情况 ６０位,从０开始,用满归零SrcDeviceTypeString12发端设备类型参见<附录5.1.2:设备编码>SrcDeviceIDString16发端设备ID参见<附录5.1.2:设备编码:>UserIDString120用户号码UserIDTypeInteger110:MSISDN1:ＰＨＳ2:PSTN3:(保留)PProductOfferIDString0..125CRM传统+增值业务的捆绑销售品ID跨ISMP和X平台的增值业务捆绑销售品IDPackageIDString0..125增值业务捆绑销售品ID列表(注明:如果PProductOfferID不空的时候,这个字段不用,仅作保留)ProductInfoObject01..n增值业务产品信息列表:包括:产品ID产品动作(新订产品、加入已有产品、替换已有产品、退订产品、产品退出套餐)被替换的产品ID(仅仅在”替换已有产品”时候有效)PackageID不为空的时候,ProductInfo节点为0传统+增值捆绑类套餐时ProductInfo节点才可为n其它情况ProductInfo节点均为1约束:在当前这种模式下,对于传统+增值捆绑套餐内的增值子产品,只能经过CRM进行退订。如果需要支持,可能需要增加接口向VOSP询问。ProductInfo定义参数名类型出现次数长度注释ProductIDString125增值业务产品IDOperTypeInteger11动作类型:3:退订产品4:产品退出套餐OProductIDString125原增值业务产品ID,仅仅在OperType=2时候有效响应消息体定义UnSubActionToISMPResp消息字段描述:参数名类型出现次数长度注释StreamingNoString160将调用的StreamingNo原样返回,保证调用／返回的同步ResultCodeInteger14响应代码0:成功非0:失败ResultDescString1128结果详细原因ResultInfoResultInfo01..n返回信息列表,包括:产品ID,处理结果,生效时间、失效时间ResultInfo定义参数名类型出现次数长度注释ProductIDString16025增值业务产品IDOPResultInteger134处理结果:0:处理成功1非0:处理失败OPDescString1512详细原因EffDateString0…114定购关系生效时间,不填表示立即生效ExpDateString0…114定购关系失效时间,自动续订的不填订购关系相关接口订购关系文件同步接口名称订购关系文件同步接口接口代码VSOPR8.2说明ISMP将订购关系文件同步给VSOP,VSOP根据ISMP的订购关系文件,进行订购关系比对。数据源系统ISMP数据方向ISMP->VSOP接口类型FTP抽取方式及周期日增量/月全量传送订购关系文件名、目录定义及同步策略1)

定购关系同步文件命名规则:

文件类接口命名中需要体现以下几个要素:文件类别代码、数据日期、接口编码、数据提供方系统标识、重传序号、序列号,使用”－”(减号)隔开。

”文件类别编码”:文件为每日增量文件时,<文件类别代码>为”A”、文件为每月全量文件时,<文件类别代码>为”I”;;

”数据日期”:日接口则为”YYYYMMDD”;若为月接口则为”YYYYMM”;

”接口编码”:定购关系文件同步接口编码为VSOPR8.2;

”数据提供方系统标识”:ISMP-M系统标识为204。

”重传序号”:两位编码,首次传送使用”00”,后续自动累加;

”序列号”:两位编码,从”01”开始,后续自动累加。

样例:每天增量订购关系文件(从ISMP->VSOP),文件名:A-0301-VSOPR8.2-204-00-01.AVL全量订购关系文件(从ISMP->VSOP),文件名:I-03-VSOPR8.2-204-00-01.AVL

在接口文件生成过程中,定义接口文件扩展名为.TMP,待接口文件生成成功后,再改为.AVL,以保证数据文件的完整性;

对于全量数据文件文件或大数据量的增量数据文件,文件大小以记录数来分割,如一个文件记录数超过10万,进行文件分割。分割文件内容以及文件名按规范定义,文件名序列号编码按顺序累加。2)

校验文件命名规则:

<文件类别代码>为”HZ”;

针对每一个接口单位数据文件均要求生成接口校验反馈文件,文件命名规则为:

文件级错误:<接口文件名>.FER

记录级错误:<接口文件名>.EER3)

字段间分隔符为:ASCII码0X80(‘€’)。4)

定购关系及校验文件目录:无需遵照特殊规则,与VSOP侧达成一致即可。文件格式域名类型出现次数长度描述StreamingNoString160流水号,可用于调用／提供双方比较接口调用情况６０位,从０开始,用满归零SubscriptionIDString120定购关系编号OAString120定购方用户号码(比对必须字段)OATypeInteger11定购方用户号码类型(比对必须字段)0:MSISDN1:PHS2:PSTN3:(保留)3:PseudoCodeDAString120使用方用户号码DATypeInteger11使用方用户号码类型0:MSISDN1:PHS2:PSTN3:(保留)3:PseudoCodeFAString120付费方用户号码FATypeInteger11付费方用户号码类型0:MSISDN1:PHS2:PSTN3:(保留)3:PseudoCodeWithdrawerInteger0…11退定方0:定购方1:使用方2:运营商3:CP/SP4:集团WithdrawReasonString0…1512定购关系取消原因(仅在ISMP操作时可能会有,接口中暂无此字段)SuspendReasonString0…1512定购关系暂停