中国联通IT系统 集成规范 第十三分册 省分合作伙伴管理系统和省分客户关系管理系统的接口V2.0

QB/CU XXX2009中国联通公司企业标准中国联通IT系统集成规范第十三分册省分合作伙伴管理系统和省分客户关系管理系统的横向接口China Unicom Interface Specification（V 2.0）（送审稿）中国联通公司发布2009-X-X实施2009-X-X发布中国联通IT系统集成规范 第十三分册 省分合作伙伴管理系统和省分客户关系管理系统的横向接口目 次前言1接口规范21.范围22.规范性引用文件23.缩略语和术语定义23.1.缩略语23.2.术语34.SP信息同步功能34.1.流程图34.2.包含接口列表44.2.1.合作伙伴信息同步接口45.CP信息同步功能65.1.流程图65.2.包含接口列表65.2.1.CP信息同步接口66.合作伙伴业务信息同步功能86.1.流程86.2.包含接口列表96.2.1.合作伙伴业务信息同步接口97.合作伙伴产品信息同步功能127.1.流程图127.2.包含接口列表127.2.1.合作伙伴产品信息同步接口128.合作伙伴产品状态变更同步功能178.1.流程图178.2.包含接口列表178.2.1.合作伙伴产品状态变更信息同步接口188.2.2.合作伙伴产品状态变更信息同步接口199.附录 修改历史19中国联通机密文件 第 1 页 共 22 页前言本标准是中国联通IT系统集成规范系列标准，本系列接口规范定义了接口的参数项及参数类型。V2.0版本相比V1.0版本主要删除了合作伙伴信息同步功能，新增SP信息同步功能、CP信息同步功能，修订合作伙伴业务信息同步、合作伙伴产品信息同步功能，删除合作伙伴投诉处理功能、服务使用记录同步功能、业务之间关系同步功能、俱乐部礼品信息同步功能。本规范自发布之日起，用于指导新系统建设以及原有系统改造，原有规范在老系统下线之后废止。本标准由中国联通公司业务支撑系统部提出。本标准由中国联通公司技术部归口。本标准主要起草单位： 中国联通业务支撑系统部，中讯邮电咨询设计院有限公司。本标准2.0主要修订人：刘诚明、李连祥、陈淑平、李闵一、王颖、孙艺博、叶剑、李净、梅斌、孙元涛、李长连、马又良、程刚、聂振辉、王明君、张海超、王峰、杨光。本标准的修改和解释权属中国联合网络通信有限公司。中国联通IT系统集成规范 第十三分册 省分合作伙伴管理系统和省分客户关系管理系统的横向接口接口规范1. 范围本标准规定了中国联通IT系统集成规范接口分册省分PRM与省分CRM的横向接口，适用于中国联通总部、省分公司和厂商进行BSS系统建设的研制、开发和实施，是中国联通BSS系统的建设依据之一。2. 规范性引用文件中国联通IT系统数据架构规范 第一分册 数据分类和分布规范（V1.0）中国联通IT系统数据架构规范 第二分册 企业数据模型规范（V1.0）中国联通IT系统 BSS系统域 合作伙伴管理系统 业务规范中国联通IT系统 BSS系统域 合作伙伴管理系统 技术规范中国联通IT系统 BSS系统域 合作伙伴管理系统 数据模型规范3. 缩略语和术语定义3.1. 缩略语本文档所涉及的缩略语解释请参见下表。缩略语英文全称中文全称BSSBusiness Support System业务支撑系统CPContent Provider内容提供商CRMCustomer Relationship Management客户关系管理SP Service Provider服务提供商SSOSingle Sign On单点登录PRMPartner Relationship Management 合作伙伴关系管理3.2. 术语本文档所涉及的术语定义请参见下表。名词解释合作伙伴广义的合作伙伴是指和电信运营商存在伙伴关系的实体。本次规划中的合作伙伴管理系统主要是指对SP/CP、SI以及各种服务类合作伙伴的管理。合作伙伴产品合作伙伴产品是指中国联通运用营销手段，在合作伙伴业务或合作伙伴业务类的基础之上，叠加资费计划、配套资源等属性后的产物。客户客户是指可以成为中国联通及其合作伙伴所提供电信产品的所有者、支付者、使用者的人或组织。潜在客户也在客户管理范围之内。合作伙伴业务合作伙伴业务是指中国联通根据客户的通信需求，利用自身或第三方资源向客户提供的具有市场价值的通信服务内容。4. SP信息同步功能4.1. 流程图4.2. 包含接口列表序号接口编码接口名称源系统目标系统传送内容同步/异步是否批量1.A2-A1-01PRM-CRM合作伙伴信息同步省分PRM系统省分CRM系统合作伙伴信息同步否4.2.1. 合作伙伴信息同步接口4.2.1.1. 接口描述本接口实现将省分PRM系统中的合作伙伴信息同步给省分CRM系统，并将同步结果返回给省分PRM系统。4.2.1.2. 接口内容n 输入项序号参数名说明是否必填参数类型最大长度1SequenceID流水号RecordSequenceID，从1开始，排满9999999999后重新循环。是CHAR102UPDATEType更新类型1：增加 2：修改 3：删除是INTEGER13SPIDSP标识是CHAR84SPNameSP名称是CHAR1005SPPsedoFlag是否送SP伪码0:不给1:给是INTEGER16SPStatusSP状态，取值见附录是INTEGER17SPAreaIDSP归属地域代码取值见附录A是CHAR88SPCitySP服务的地市范围，地市代码固定3位，中间由“，”分隔，如此字段为空表示服务全省，取值见附录A否CHAR2569SPSrvPhoneSP投诉电话是CHAR4010isTrust是否是可信任SP,见附录A是INTEGER111SPOrderUrlSP订购关系通知URL，SP信息、业务信息中本字段优先级为从低到高顺序，当优先级高的字段有效时，忽略低优先级字段。否CHAR25612OrderKey定购关系共享密钥, 定购关系同步时,VAC用它组合其他属性给出加密串让SP验证定购关系的合法性,如果此串填空,VAC就不产生加密串；当SynOrderFunc=1:SGIP接口时，该串只能填空否CHAR4013SynOrderFunc定购关系同步方式(在信SP可保留现有方式,对于具备多种业务能力的SP，建议采用webservice接口)0:webservice接口1:SGIP接口是INTEGER114EffDate生效时间，格式为YYYYMMDDHHMMSS否CHAR1415ExpDate失效时间，格式为YYYYMMDDHHMMSS否CHAR1416PARTYWebSite合作伙伴网址是CHAR6017PARTYIPAddress合作伙伴 IP地址，如果合作伙伴有多个IP地址，每个IP地址之间用“,”分隔是CHAR8518PARTYCont合作伙伴联系人是CHAR4019PARTYContAddr合作伙伴联系地址否CHAR12820PARTYContPhone合作伙伴固定联系电话是CHAR2021PARTYContMobPhone合作伙伴移动联系电话否CHAR1522PARTYFaxNum合作伙伴传真号码否CHAR2023PARTYAddInfo合作伙伴附加信息描述是CHAR4024PARTYBank合作伙伴开户行是CHAR4025PARTYBankAccount合作伙伴开户行帐号是CHAR20n 输出项序号参数名说明是否必填参数类型最大长度1SequenceID流水号是RecordSequenceID，从1开始，排满9999999999后重新循环。CHAR102ResultCode返回结果 0成功 1失败是CHAR13CodeInfo失败原因否CHAR405. CP信息同步功能5.1. 流程图5.2. 包含接口列表序号接口编码接口名称源系统目标系统传送内容同步/异步是否批量1.A2-A1-11PRM-CRMCP信息同步省分PRM系统省分CRM系统CP信息同步否5.2.1. CP信息同步接口5.2.1.1. 接口描述本接口实现将省分PRM系统中的CP信息同步给省分CRM系统，并将同步结果返回给省分PRM系统。5.2.1.2. 接口内容n 输入项序号参数名说明是否必填参数类型最大长度1SequenceID流水号RecordSequenceID，从1开始，排满9999999999后重新循环。是CHAR102UPDATEType更新类型1：增加 2：修改 3：删除是INTEGER13CPIDCP标识是CHAR84CPNameCP名称是CHAR405CPStatusCP状态，取值见VAC与BSS接口规范附录A是INTEGER16CPAreaIDCP归属地域代码取值见VAC与BSS接口规范附录A是CHAR87CPCityCP服务的地市范围，地市代码固定3位，中间由“，”分隔，如此字段为空表示服务全省，取值见VAC与BSS接口规范附录A否CHAR2568CPSrvPhoneCP投诉电话是CHAR409isTrust是否是可信任CP,见附录A 是INTEGER110CP_PWCP在PRM上注册后生成该密码是CHAR1011CPIPAddressCP的IP地址，如果合作伙伴有多个IP地址，每个IP地址之间用“，”分隔否CHAR10012ContentType允许接入的内容类型：A视频（文件）；B视频（直播）；C音频（文件）；D音频（直播）；E图片；F文字；G程序；填写的时候按照内容类型顺序依次填写，若允许此类型接入，即填写1否则填写0。后面的字符预留是CHAR2013ServiceConstrain业务绑定限制的文本描述否CHAR10014EffDate生效时间否CHAR1415ExpDate失效时间否CHAR14n 输出项序号参数名说明是否必填参数类型最大长度4SequenceID流水号是RecordSequenceID，从1开始，排满9999999999后重新循环。CHAR105ResultCode返回结果 0成功 1失败是CHAR16CodeInfo失败原因否CHAR406. 合作伙伴业务信息同步功能6.1. 流程6.2. 包含接口列表序号接口编码接口名称源系统目标系统传送内容同步/异步是否批量1.A2-A1-02PRM-CRM合作伙伴业务信息同步省分PRM系统省分CRM系统业务信息同步否6.2.1. 合作伙伴业务信息同步接口6.2.1.1. 接口描述本接口实现将省分PRM系统中的业务信息同步给省分CRM系统，并将同步结果返回给省分PRM系统。6.2.1.2. 接口内容n 输入项序号参数名说明是否必填参数类型最大长度1SequenceID流水号RecordSequenceID，从1开始，排满9999999999后重新循环。是CHAR102UpdateType更新类型1：增加 2：修改 3：删除是INTEGER13SPIDSP标识是CHAR84SPNameSP名称是CHAR405ServiceType业务类型代码，取值见附录A。如果该业务是由多个业务能力组合而成，则每个业务能力之间用“,”分隔。最后一个业务能力作为该组合业务的计费点。是CHAR306GroupService业务打包标识0：打包业务，1：非打包业务是INTEGER17ServiceCompose如果该业务是由多个业务打包而成，该字段为打包业务所包含的ServiceID，可以由多个业务打包而成，每个ServiceID之间用“,”分隔否CHAR10248ServiceID业务代码是CHAR109ServiceName业务名称是CHAR4010ServiceCredit业务信任等级，保留，默认取值0是INTEGER111ServiceStatus业务状态取值见附录A是INTEGER212IntroURL业务介绍信息否CHAR60013wapintropicWap介绍图片否CHAR2014servicecolumn业务类别,编码方式见附件A是CHAR215Enterurl业务入口URL(wap)业务的入口URL，一般为业务首页面，供业务上线时链接使用否CHAR50016Confirmurl确认URL，多个确认url以“，”分隔。表示访问该URL时，如果用户未定制该URL对应的业务，则平台系统会弹出计计费提示信息和订购方式供用户查看和选择否CHAR50017Priceurl计费URL，多个确认url以“，”分隔。收费服务标识对应收费URL，如果用户访问此URL，平台系统结合用户对此业务的订购策略进行对应计费处理否CHAR50018freeurl免费URL否CHAR50019NeedConfmBack标识业务是否需要返回确认消息（wap）0：是1：不是否INTEGER120CheckType监控类型：(保留字段)0：不监控1：实时比对监控2：事后监控是INTEGER121EffDate生效时间，格式为YYYYMMDDHHMMSS否CHAR1422ExpDate失效时间，格式为YYYYMMDDHHMMSS否CHAR1423WAPServiceTypeWap业务类型:1：代理方式2：直通方式3：重定向4：自营新闻5：自营铃声6：自营音乐7：自营视频8：自营游戏9：自营图片否INTEGER224SPOrderUrlSP本类业务订购关系通知URL，SP信息、业务信息中本字段优先级为从低到高顺序，当优先级高的字段有效时，忽略低优先级字段。否CHAR25625SynOrderFunc定购关系同步方式，SP信息、业务信息中本字段优先级为从低到高顺序，当优先级高的字段有效时，忽略低优先级字段。0:webservice接口1:SGIP接口，仅对短信类业务有效否INTEGER126SPPsedoFlag是否送SP伪码，SP信息、业务信息中本字段优先级为从低到高顺序，当优先级高的字段有效时，忽略低优先级字段。0:不给1:给否INTEGER1n 输出项序号参数名说明是否必填参数类型最大长度1SequenceID流水号是RecordSequenceID，从1开始，排满9999999999后重新循环。CHAR102ResultCode返回结果 0成功 1失败是CHAR17. 合作伙伴产品信息同步功能7.1. 流程图7.2. 包含接口列表序号接口编码接口名称源系统目标系统传送内容同步/异步是否批量1.A2-A1-03PRM-CRM合作伙伴产品信息同步省分PRM系统省分CRM系统产品信息同步否7.2.1. 合作伙伴产品信息同步接口7.2.1.1. 接口描述本接口实现将省分PRM系统中的产品信息同步给省分CRM系统，并将同步结果返回给省分PRM系统。7.2.1.2. 接口内容n 输入项序号参数名说明参数类型最大长度是否必填1recordSequenceID流水号，格式为时间戳+序列号：YYYYMMDDHHMMSSxxxx，其中xxxx为序列号，从0001开始，排满9999后重新循环String18M2updateType更新类型1：增加 2：修改 3：删除integer1M3sp_ProductIDPRM产生的合作伙伴产品IDString12M4serviceID产品对应的业务标识，一个产品对应一个ServiceIDString10M5GroupService业务打包标识0：打包业务，1：非打包业务integer1M6ServiceCompose如果该业务是由多个业务打包而成，该字段为打包业务所包含的ServiceID，可以由多个业务打包而成，每个ServiceID之间用“,”分隔string1024O7sPIDSP标识String8M8sPNameSP名称String100M9productStatus产品状态取值见附录AInteger2M10Product_net适用2G/3G0：2G 1：3Ginteger2M11productType产品类型1 定购类2 有点播关系的点播类3 无点播关系的点播类Integer1M12productName产品名称String255O13confirm订购或者点播时是否要二次确认资费提示0：确认1：不确认integer1O14presenter是否可赠送0:不可赠送1:可赠送integer1M15confirmPrompt二次确认提示语String400O16successPrompt订购成功提示语String400O17cancelPrompt退定成功提示语String400O18popularizestart推广期开始时间String14O19popularizestop推广期结束时间String14O20freeUseFlag免费体验标识0：不支持免费体验1：按次免费体验2：按天免费体验integer1M21freeUseTime免费体验次数/时长，如果FreeFlag取值为：0 则该字段不填1 则标识免费体验次数2则标识免费体验天数integer2O22billDesc资费描述String400M23billCode资费模型代码CHAR20M24bill_Parameter_num资费参数个数integer2M25bill_Parameter_format资费参数格式（以分号为分隔符）：=string1;=string2详见：附录CString500M26needConfm是否需要checkPriceConfirm消息0：是1：不是integer1O27maxUseTimes最大使用次数(保留字段)integer2O28maxUseTime最大使用时长（秒）(保留字段)integer4O29sendnum点播MO对应最大MT条数(sms/mms)integer2O30ordercommand定制指令String20O31orderCmdmatch定制命令字匹配0模糊匹配1精确匹配integer1O32orderAcc定制业务接入码String20O33orderAccmatch定制接入号匹配0模糊匹配(左向最大匹配)1精确匹配integer1O34cancelcommand退订指令string20O35cancelCmdmatch退订命令字匹配0模糊匹配1精确匹配integer1O36cancelAcc退订业务接入码String20O37cancelAccmatch退订接入号匹配0模糊匹配1精确匹配Integer1O38requestcmd点播指令String20O39requestCmdmatch点播命令字匹配0模糊匹配1精确匹配Integer1O40requestAcc点播业务接入码String20O41requestAccmatch点播接入号匹配0模糊匹配1精确匹配integer1O42effDate生效时间String14O43expDate失效时间String14O44vACSub是否可以在VAC上单独定购(合作伙伴产品能否点播)0 不可以单独定购/退定1 可以单独定购/退定2 后付费(含OCS)用户不可以单独定购/退定3 后付费(含OCS)用户可以单独定购/退定4 SCP用户不可以单独定购/退定5 SCP用户可以单独定购/退定integer1M45notifyType定购/点播关系是否通知SP0：不通知1：通知SP前定购成功,如果SP失败，VAC不回滚2：收到SP成功定购后，VAC生成定购关系，如果SP返回失败，VAC不生成定购关系integer1M46productCity产品服务的省分范围，省分代码固定3位，中间由“，”分隔，如此字段为空表示服务全国，取值见附录Bstring256O47productPeriodGrade产品服务周期级别，取值为099.点播、直接使用产品级别默认填0string2O48productServiceGrade产品服务等级，取值为099.点播、直接使用产品级别默认填0，表示最低级别.string2O49productCredit产品信任等级:0:普通1:高信用度(无定购/点播关系，可使用，不收费；有定购/点播关系按产品收费)2:代收费产品：对订购关系/点播关系不鉴权，费用以AAA消息中的fee字段为准；本类业务不允许发起定购、点播请求，只能发起计费请求（operationType=0）；如果业务平台发起除计费请求之外的其他请求，VAC均返回2205失败码string1M50resv1保留字段（传递PRM产品描述信息）String40O51resv2保留字段传递PRM产品三项属性（逗号间隔）：Servicetype, 业务来源(合作1/自办2),业务性质(多媒体1/文本2)String40Mn 输出项序号参数名说明参数类型最大长度是否必填1RecordSequenceID流水号，格式为时间戳+序列号：YYYYMMDDHHMMSSxxxx，其中xxxx为序列号，从0001开始，排满9999后重新循环String10M2ResultCode结果标识0：正确1：错误integer4M8. 合作伙伴产品状态变更同步功能8.1. 流程图8.2. 包含接口列表序号接口编码接口名称源系统目标系统传送内容同步/异步是否批量1.A2-A1-04PRM-CRM合作伙伴产品状态变更信息同步省分PRM系统省分CRM系统产品状态变更信息同步否2A1-A2-05CRM-PRM合作伙伴产品状态变更信息同步省分CRM系统省分PRM系统产品状态变更信息同步否8.2.1. 合作伙伴产品状态变更信息同步接口8.2.1.1. 接口描述本接口实现当省分PRM系统对产品状态进行变更时通过此接口通知省分CRM系统产品状态变更信息的功能。8.2.1.2. 接口内容n 输入项序号参数名说明是否必填参数类型最大长度1SequenceID流水号是RecordSequenceID，从1开始，排满9999999999后重新循环。CHAR102PartyID合作伙伴标识是CHAR83ProductID产品代码是CHAR404ProductStatus产品状态是CHAR15UpdateType更新类型， 1：增加 2：修改 3：删除是CHAR1n 输出项序号参数名说明是否必填参数类型最大长度1SequenceID流水号是RecordSequenceID，从1开始，排满9999999999后重新循环。CHAR102ResultCode返回结果 0成功 1失败是CHAR13CodeInfo失败原因否CHAR408.2.2. 合作伙伴产品状态变更信息同步接口8.2.2.1. 接口描述本接口实现当省分CRM系统对产品状态进行变更时通过此接口通知省分PRM系统产品状态变更信息的功能。8.2.2.2. 接口内容n 输入项序号参数名说明是否必填参数类型最大长度1SequenceID流水号是RecordSequenceID，从1开始，排满9999999999后重新循环。CHAR102PartyID合作伙伴标识是CHAR83ProductID产品代码是CHAR404ProductStatus产品状态是CHAR15UpdateType更新类型， 1：增加 2：修改 3：删除是CHAR1n 输出项序号参数名说明是否必填参数类型最大长度1SequenceID流水号是RecordSequenceID，从1开始，排满9999999999后重新循环。CHAR102ResultCode返回结果 0成功 1失败是CHAR13CodeInfo失败原因否CHAR409. 附录 修改历史版本时间内容描述1.02007年3月版本建立2.02009年7月版本升级删除合作伙伴信息同步新增SP信息同步新增CP信息同步修订合作伙伴业务信息同步修订接口字段内容修订合作伙伴产品信息同步修订接口字段内容删除合作伙伴投诉处理删除服务使用记录同步删除业务之间关系同步删除俱乐部礼品信息同步中国联通机密文件 第 20 页 共 22 页