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

《中国联通IT系统 集成规范 第十三分册 省分合作伙伴管理系统和省分客户关系管理系统的接口V2.0》由会员分享，可在线阅读，更多相关《中国联通IT系统 集成规范 第十三分册 省分合作伙伴管理系统和省分客户关系管理系统的接口V2.0（22页珍藏版）》请在装配图网上搜索。

1、QB/CU XXX—2009 中国联通公司企业标准 中国联通IT系统集成规范 第十三分册 省分合作伙伴管理系统和省分客户关系管理系统的横向接口 China Unicom Interface Specification （V 2.0） （送审稿） 中国联通公司发布 2009-X-X实施 2009-X-X发布 中国联通IT系统集成规范 第十三分册 省分合作伙伴管理系统和省分客户关系管理系统的横向接口 目 次 前言 1 接口规范 2 1. 范围 2 2. 规范性引用文件 2

2、 3. 缩略语和术语定义 2 3.1. 缩略语 2 3.2. 术语 3 4. SP信息同步功能 3 4.1. 流程图 3 4.2. 包含接口列表 4 4.2.1. 合作伙伴信息同步接口 4 5. CP信息同步功能 6 5.1. 流程图 6 5.2. 包含接口列表 6 5.2.1. CP信息同步接口 6 6. 合作伙伴业务信息同步功能 8 6.1. 流程 8 6.2. 包含接口列表 9 6.2.1. 合作伙伴业务信息同步接口 9 7. 合作伙伴产品信息同步功能 12 7.1. 流程图 12 7.2. 包含接口列表 12 7.2.1. 合作伙伴产品信息同步接口

3、12 8. 合作伙伴产品状态变更同步功能 17 8.1. 流程图 17 8.2. 包含接口列表 17 8.2.1. 合作伙伴产品状态变更信息同步接口 18 8.2.2. 合作伙伴产品状态变更信息同步接口 19 9. 附录 修改历史 19 中国联通机密文件 第 1 页 共 22 页 前言 本标准是中国联通IT系统集成规范系列标准，本系列接口规范定义了接口的参数项及参数类型。 V2.0版本相比V1.0版本主要删除了合作伙伴信息同步功能， 新增SP信息同步功能

4、 、CP信息同步功能，修订合作伙伴业务信息同步、合作伙伴产品信息同步 功能，删除合作伙伴投诉处理功能、服务使用记录同步功能、业务之间关系同步功能、俱乐部礼品信息同步功能。 本规范自发布之日起，用于指导新系统建设以及原有系统改造，原有规范在老系统下线之后废止。 本标准由中国联通公司业务支撑系统部提出。 本标准由中国联通公司技术部归口。 本标准主要起草单位： 中国联通业务支撑系统部，中讯邮电咨询设计院有限公司。 本标准2.0主要修订人：刘诚明、李连祥、陈淑平、李闵一、王颖、孙艺博、叶剑、李净、梅斌、孙元涛、李长

5、连、马又良、程刚、聂振辉、王明君、张海超、王峰、杨光。 本标准的修改和解释权属中国联合网络通信有限公司。 中国联通IT系统集成规范 第十三分册 省分合作伙伴管理系统和省分客户关系管理系统的横向接口 接口规范 1. 范围 本标准规定了中国联通IT系统集成规范接口分册省分PRM与省分CRM的横向接口，适用于中国联通总部、省分公司和厂商进行BSS系统建设的研制、开发和实施，是中国联通BSS系统的建设依据之一。 2. 规范性引用文件 《中国联通IT系统数据架构规范 第一分册 数据分类和分布规范（V1.0）》 《中国联通IT系统数据架构规范 第二分册 企业数据模型规范（V1.

6、0）》 《中国联通IT系统 BSS系统域 合作伙伴管理系统 业务规范》 《中国联通IT系统 BSS系统域 合作伙伴管理系统 技术规范》 《中国联通IT系统 BSS系统域 合作伙伴管理系统 数据模型规范》 3. 缩略语和术语定义 3.1. 缩略语 本文档所涉及的缩略语解释请参见下表。 缩略语 英文全称 中文全称 BSS Business Support System 业务支撑系统 CP Content Provider 内容提供商 CRM Customer Relationship Management 客户关系管理 SP Service Provide

7、r 服务提供商 SSO Single Sign On 单点登录 PRM Partner Relationship Management 合作伙伴关系管理 3.2. 术语 本文档所涉及的术语定义请参见下表。 名词 解释 合作伙伴 广义的合作伙伴是指和电信运营商存在伙伴关系的实体。本次规划中的合作伙伴管理系统主要是指对SP/CP、SI以及各种服务类合作伙伴的管理。 合作伙伴产品 合作伙伴产品是指中国联通运用营销手段，在合作伙伴业务或合作伙伴业务类的基础之上，叠加资费计划、配套资源等属性后的产物。 客户 客户是指可以成为中国联通及其合作伙伴所提供电信产品的所

8、有者、支付者、使用者的人或组织。潜在客户也在客户管理范围之内。 合作伙伴业务 合作伙伴业务是指中国联通根据客户的通信需求，利用自身或第三方资源向客户提供的具有市场价值的通信服务内容。 4. SP信息同步功能 4.1. 流程图 4.2. 包含接口列表 序号 接口编码 接口名称 源系统 目标系统 传送内容 同步/异步 是否批量 1. A2-A1-01 [PRM-CRM]合作伙伴信息同步 省分PRM系统 省分CRM系统 合作伙伴信息 同步 否 4.2.1. 合作伙伴信息同步接口 4.2.1.1. 接口描述 本接口实现将省分PRM系统中的

9、合作伙伴信息同步给省分CRM系统，并将同步结果返回给省分PRM系统。 4.2.1.2. 接口内容 n 输入项 序号 参数名 说明 是否必填 参数类型 最大长度 1 SequenceID 流水号 RecordSequenceID，从1开始，排满9999999999后重新循环。 是 CHAR 10 2 UPDATEType 更新类型 1：增加 2：修改 3：删除 是 INTEGER 1 3 SPID SP标识 是 CHAR 8 4 SPName SP名称 是 CHAR 100 5 SPPsedoFlag 是否送SP伪码 0

10、:不给 1:给 是 INTEGER 1 6 SPStatus SP状态，取值见附录 是 INTEGER 1 7 SPAreaID SP归属地域代码 取值见附录A 是 CHAR 8 8 SPCity SP服务的地市范围，地市代码固定3位，中间由“，”分隔，如此字段为空表示服务全省，取值见附录A 否 CHAR 256 9 SPSrvPhone SP投诉电话 是 CHAR 40 10 isTrust 是否是可信任SP,见附录A 是 INTEGER 1 11 SPOrderUrl SP订购关系通知URL，SP信息、业务信息中本

11、字段优先级为从低到高顺序，当优先级高的字段有效时，忽略低优先级字段。 否 CHAR 256 12 OrderKey 定购关系共享密钥, 定购关系同步时,VAC用它组合其他属性给出加密串让SP验证定购关系的合法性,如果此串填空,VAC就不产生加密串；当SynOrderFunc=1:SGIP接口时，该串只能填空 否 CHAR 40 13 SynOrderFunc 定购关系同步方式(在信SP可保留现有方式,对于具备多种业务能力的SP，建议采用webservice接口) 0:webservice接口 1:SGIP接口 是 INTEGER 1 14 EffDate

12、 生效时间，格式为YYYYMMDDHHMMSS 否 CHAR 14 15 ExpDate 失效时间，格式为YYYYMMDDHHMMSS 否 CHAR 14 16 PARTYWebSite 合作伙伴网址 是 CHAR 60 17 PARTYIPAddress 合作伙伴 IP地址，如果合作伙伴有多个IP地址，每个IP地址之间用“,”分隔 是 CHAR 85 18 PARTYCont 合作伙伴联系人 是 CHAR 40 19 PARTYContAddr 合作伙伴联系地址 否 CHAR 128 20 PARTYContPhone

13、合作伙伴固定联系电话 是 CHAR 20 21 PARTYContMobPhone 合作伙伴移动联系电话 否 CHAR 15 22 PARTYFaxNum 合作伙伴传真号码 否 CHAR 20 23 PARTYAddInfo 合作伙伴附加信息描述 是 CHAR 40 24 PARTYBank 合作伙伴开户行 是 CHAR 40 25 PARTYBankAccount 合作伙伴开户行帐号 是 CHAR 20 n 输出项 序号 参数名 说明 是否必填 参数类型 最大长度 1 SequenceID 流水号 是

14、 RecordSequenceID，从1开始，排满9999999999后重新循环。 CHAR 10 2 ResultCode 返回结果 0成功 1失败 是 CHAR 1 3 CodeInfo 失败原因 否 CHAR 40 5. CP信息同步功能 5.1. 流程图 5.2. 包含接口列表 序号 接口编码 接口名称 源系统 目标系统 传送内容 同步/异步 是否批量 1. A2-A1-11 [PRM-CRM]CP信息同步 省分PRM系统 省分CRM系统 CP信息 同步 否 5.2.1. CP信息同步接

15、口 5.2.1.1. 接口描述 本接口实现将省分PRM系统中的CP信息同步给省分CRM系统，并将同步结果返回给省分PRM系统。 5.2.1.2. 接口内容 n 输入项 序号 参数名 说明 是否必填 参数类型 最大长度 1 SequenceID 流水号 RecordSequenceID，从1开始，排满9999999999后重新循环。 是 CHAR 10 2 UPDATEType 更新类型 1：增加 2：修改 3：删除 是 INTEGER 1 3 CPID CP标识 是 CHAR 8 4 CPName CP名称 是 CHAR

16、40 5 CPStatus CP状态，取值见VAC与BSS接口规范附录A 是 INTEGER 1 6 CPAreaID CP归属地域代码 取值见VAC与BSS接口规范附录A 是 CHAR 8 7 CPCity CP服务的地市范围，地市代码固定3位，中间由“，”分隔，如此字段为空表示服务全省，取值见VAC与BSS接口规范附录A 否 CHAR 256 8 CPSrvPhone CP投诉电话 是 CHAR 40 9 isTrust 是否是可信任CP,见附录A 是 INTEGER 1 10 CP_PW CP在PRM上注册后生成该密码

17、 是 CHAR 10 11 CPIPAddress CP的IP地址，如果合作伙伴有多个IP地址，每个IP地址之间用“，”分隔 否 CHAR 100 12 ContentType 允许接入的内容类型： A视频（文件）； B视频（直播）； C音频（文件）； D音频（直播）； E图片； F文字； G程序； 填写的时候按照内容类型顺序依次填写，若允许此类型接入，即填写1否则填写0。后面的字符预留 是 CHAR 20 13 ServiceConstrain 业务绑定限制的文本描述 否 CHAR 100 14 EffDate 生效时间 否

18、 CHAR 14 15 ExpDate 失效时间 否 CHAR 14 n 输出项 序号 参数名 说明 是否必填 参数类型 最大长度 4 SequenceID 流水号 是 RecordSequenceID，从1开始，排满9999999999后重新循环。 CHAR 10 5 ResultCode 返回结果 0成功 1失败 是 CHAR 1 6 CodeInfo 失败原因 否 CHAR 40 6. 合作伙伴业务信息同步功能 6.1. 流程 6.2. 包含接口列表 序号 接口编码 接口名称 源

19、系统 目标系统 传送内容 同步/异步 是否批量 1. A2-A1-02 [PRM-CRM]合作伙伴业务信息同步 省分PRM系统 省分CRM系统 业务信息 同步 否 6.2.1. 合作伙伴业务信息同步接口 6.2.1.1. 接口描述 本接口实现将省分PRM系统中的业务信息同步给省分CRM系统，并将同步结果返回给省分PRM系统。 6.2.1.2. 接口内容 n 输入项 序号 参数名 说明 是否必填 参数类型 最大长度 1 SequenceID 流水号 RecordSequenceID，从1开始，排满9999999999后重新循环。 是

20、 CHAR 10 2 UpdateType 更新类型 1：增加 2：修改 3：删除 是 INTEGER 1 3 SPID SP标识 是 CHAR 8 4 SPName SP名称 是 CHAR 40 5 ServiceType 业务类型代码，取值见附录A。如果该业务是由多个业务能力组合而成，则每个业务能力之间用“,”分隔。最后一个业务能力作为该组合业务的计费点。 是 CHAR 30 6 GroupService 业务打包标识 0：打包业务，1：非打包业务 是 INTEGER 1 7 ServiceCompose 如果该业务

21、是由多个业务打包而成，该字段为打包业务所包含的ServiceID，可以由多个业务打包而成，每个ServiceID之间用“,”分隔 否 CHAR 1024 8 ServiceID 业务代码 是 CHAR 10 9 ServiceName 业务名称 是 CHAR 40 10 ServiceCredit 业务信任等级，保留，默认取值0 是 INTEGER 1 11 ServiceStatus 业务状态 取值见附录A 是 INTEGER 2 12 IntroURL 业务介绍信息 否 CHAR 600 13 wapintropic

22、 Wap介绍图片 否 CHAR 20 14 servicecolumn 业务类别,编码方式见附件A 是 CHAR 2 15 Enterurl 业务入口URL(wap) 业务的入口URL，一般为业务首页面，供业务上线时链接使用 否 CHAR 500 16 Confirmurl 确认URL，多个确认url以“，”分隔。 表示访问该URL时，如果用户未定制该URL对应的业务，则平台系统会弹出计计费提示信息和订购方式供用户查看和选择 否 CHAR 500 17 Priceurl 计费URL，多个确认url以“，”分隔。 收费服务标识对应收费URL，

23、如果用户访问此URL，平台系统结合用户对此业务的订购策略进行对应计费处理 否 CHAR 500 18 freeurl 免费URL 否 CHAR 500 19 NeedConfmBack 标识业务是否需要返回确认消息（wap） 0：是 1：不是 否 INTEGER 1 20 CheckType 监控类型：(保留字段) 0：不监控 1：实时比对监控 2：事后监控 是 INTEGER 1 21 EffDate 生效时间，格式为YYYYMMDDHHMMSS 否 CHAR 14 22 ExpDate 失效时间，格式为YYYYMMDDH

24、HMMSS 否 CHAR 14 23 WAPServiceType Wap业务类型: 1：代理方式 2：直通方式 3：重定向 4：自营新闻 5：自营铃声 6：自营音乐 7：自营视频 8：自营游戏 9：自营图片 否 INTEGER 2 24 SPOrderUrl SP本类业务订购关系通知URL，SP信息、业务信息中本字段优先级为从低到高顺序，当优先级高的字段有效时，忽略低优先级字段。 否 CHAR 256 25 SynOrderFunc 定购关系同步方式，SP信息、业务信息中本字段优先级为从低到高顺序，当优先级高的字段有效时，忽略低优先级字段

25、。 0:webservice接口 1:SGIP接口，仅对短信类业务有效 否 INTEGER 1 26 SPPsedoFlag 是否送SP伪码，SP信息、业务信息中本字段优先级为从低到高顺序，当优先级高的字段有效时，忽略低优先级字段。 0:不给 1:给 否 INTEGER 1 n 输出项 序号 参数名 说明 是否必填 参数类型 最大长度 1 SequenceID 流水号 是 RecordSequenceID，从1开始，排满9999999999后重新循环。 CHAR 10 2 ResultCode 返回结果 0成功

26、1失败 是 CHAR 1 7. 合作伙伴产品信息同步功能 7.1. 流程图 7.2. 包含接口列表 序号 接口编码 接口名称 源系统 目标系统 传送内容 同步/异步 是否批量 1. A2-A1-03 [PRM-CRM]合作伙伴产品信息同步 省分PRM系统 省分CRM系统 产品信息 同步 否 7.2.1. 合作伙伴产品信息同步接口 7.2.1.1. 接口描述 本接口实现将省分PRM系统中的产品信息同步给省分CRM系统，并将同步结果返回给省分PRM系统。 7.2.1.2. 接口内容 n 输入项 序号 参数名 说明 参数类型

27、 最大长度 是否必填 1 recordSequenceID 流水号，格式为时间戳+序列号：YYYYMMDDHHMMSSxxxx，其中xxxx为序列号，从0001开始，排满9999后重新循环 String 18 M 2 updateType 更新类型 1：增加 2：修改 3：删除 integer 1 M 3 sp_ProductID PRM产生的合作伙伴产品ID String 12 M 4 serviceID 产品对应的业务标识，一个产品对应一个ServiceID String 10 M 5 GroupService 业务打包标识 0：

28、打包业务，1：非打包业务 integer 1 M 6 ServiceCompose 如果该业务是由多个业务打包而成，该字段为打包业务所包含的ServiceID，可以由多个业务打包而成，每个ServiceID之间用“,”分隔 string 1024 O 7 sPID SP标识 String 8 M 8 sPName SP名称 String 100 M 9 productStatus 产品状态 取值见附录A Integer 2 M 10 Product_net 适用2G/3G 0：2G 1：3G integer

29、 2 M 11 productType 产品类型 1 定购类 2 有点播关系的点播类 3 无点播关系的点播类 Integer 1 M 12 productName 产品名称 String 255 O 13 confirm 订购或者点播时是否要二次确认资费提示 0：确认 1：不确认 integer 1 O 14 presenter 是否可赠送 0:不可赠送 1:可赠送 integer 1 M 15 confirmPrompt 二次确认提示语 String 400 O 16 successPrompt 订购成功提示语

30、 String 400 O 17 cancelPrompt 退定成功提示语 String 400 O 18 popularizestart 推广期开始时间 String 14 O 19 popularizestop 推广期结束时间 String 14 O 20 freeUseFlag 免费体验标识 0：不支持免费体验 1：按次免费体验 2：按天免费体验 integer 1 M 21 freeUseTime 免费体验次数/时长，如果FreeFlag取值为： 0 则该字段不填 1 则标识免费体验次数 2则标识免费体验天数 i

31、nteger 2 O 22 billDesc 资费描述 String 400 M 23 billCode 资费模型代码 CHAR 20 M 24 bill_Parameter_num 资费参数个数 integer 2 M 25 bill_Parameter_format 资费参数格式（以分号为分隔符）： <参数1代码>=string1;<参数2代码>=string2…… 详见：附录C String 500 M 26 needConfm 是否需要checkPriceConfirm消息 0：是 1：不是 integer 1 O

32、 27 maxUseTimes 最大使用次数(保留字段) integer 2 O 28 maxUseTime 最大使用时长（秒）(保留字段) integer 4 O 29 sendnum 点播MO对应最大MT条数(sms/mms) integer 2 O 30 ordercommand 定制指令 String 20 O 31 orderCmdmatch 定制命令字匹配 0模糊匹配 1精确匹配 integer 1 O 32 orderAcc 定制业务接入码 String 20 O 33 orderAccmatch

33、定制接入号匹配 0模糊匹配(左向最大匹配) 1精确匹配 integer 1 O 34 cancelcommand 退订指令 string 20 O 35 cancelCmdmatch 退订命令字匹配 0模糊匹配 1精确匹配 integer 1 O 36 cancelAcc 退订业务接入码 String 20 O 37 cancelAccmatch 退订接入号匹配 0模糊匹配 1精确匹配 Integer 1 O 38 requestcmd 点播指令 String 20 O 39 requestCmdmatch 点

34、播命令字匹配 0模糊匹配 1精确匹配 Integer 1 O 40 requestAcc 点播业务接入码 String 20 O 41 requestAccmatch 点播接入号匹配 0模糊匹配 1精确匹配 integer 1 O 42 effDate 生效时间 String 14 O 43 expDate 失效时间 String 14 O 44 vACSub 是否可以在VAC上单独定购(合作伙伴产品能否点播) 0 不可以单独定购/退定 1 可以单独定购/退定 2 后付费(含OCS)用户不可以单独定购/退定 3 后付费

35、(含OCS)用户可以单独定购/退定 4 SCP用户不可以单独定购/退定 5 SCP用户可以单独定购/退定 integer 1 M 45 notifyType 定购/点播关系是否通知SP 0：不通知 1：通知SP前定购成功,如果SP失败，VAC不回滚 2：收到SP成功定购后，VAC生成定购关系，如果SP返回失败，VAC不生成定购关系 integer 1 M 46 productCity 产品服务的省分范围，省分代码固定3位，中间由“，”分隔，如此字段为空表示服务全国，取值见附录B string 256 O 47 productPeriodGrade

36、 产品服务周期级别，取值为0~99. 点播、直接使用产品级别默认填0 string 2 O 48 productServiceGrade 产品服务等级，取值为0~99. 点播、直接使用产品级别默认填0，表示最低级别. string 2 O 49 productCredit 产品信任等级: 0:普通 1:高信用度(无定购/点播关系，可使用，不收费；有定购/点播关系按产品收费) 2:代收费产品：对订购关系/点播关系不鉴权，费用以AAA消息中的fee字段为准；本类业务不允许发起定购、点播请求，只能发起计费请求（operationType=0）；如果业务平台发起除计

37、费请求之外的其他请求，VAC均返回2205失败码 string 1 M 50 resv1 保留字段（传递PRM产品描述信息） String 40 O 51 resv2 保留字段 传递PRM产品三项属性（逗号间隔）： Servicetype, 业务来源(合作1/自办2),业务性质(多媒体1/文本2) String 40 M n 输出项 序号 参数名 说明 参数类型 最大长度 是否必填 1 RecordSequenceID 流水号，格式为时间戳+序列号：YYYYMMDDHHMMSSxxxx，其中xxxx为序列号，从0001开始，排满99

38、99后重新循环 String 10 M 2 ResultCode 结果标识 0：正确 1：错误 integer 4 M 8. 合作伙伴产品状态变更同步功能 8.1. 流程图 8.2. 包含接口列表 序号 接口编码 接口名称 源系统 目标系统 传送内容 同步/异步 是否批量 1. A2-A1-04 [PRM-CRM]合作伙伴产品状态变更信息同步 省分PRM系统 省分CRM系统 产品状态变更信息 同步 否 2 A1-A2-05 [CRM-PRM]合作伙伴产品状态变更信息同步 省分CRM系统 省分PRM系统 产品状态变更信息

39、 同步 否 8.2.1. 合作伙伴产品状态变更信息同步接口 8.2.1.1. 接口描述 本接口实现当省分PRM系统对产品状态进行变更时通过此接口通知省分CRM系统产品状态变更信息的功能。 8.2.1.2. 接口内容 n 输入项 序号 参数名 说明 是否必填 参数类型 最大长度 1 SequenceID 流水号 是 RecordSequenceID，从1开始，排满9999999999后重新循环。 CHAR 10 2 PartyID 合作伙伴标识 是 CHAR 8 3 ProductID 产品代码 是 CHAR 40 4 Pr

40、oductStatus 产品状态 是 CHAR 1 5 UpdateType 更新类型， 1：增加 2：修改 3：删除 是 CHAR 1 n 输出项 序号 参数名 说明 是否必填 参数类型 最大长度 1 SequenceID 流水号 是 RecordSequenceID，从1开始，排满9999999999后重新循环。 CHAR 10 2 ResultCode 返回结果 0成功 1失败 是 CHAR 1 3 CodeInfo 失败原因 否 CHAR 40 8.2.2. 合作伙伴产品状态变更信息同

41、步接口 8.2.2.1. 接口描述 本接口实现当省分CRM系统对产品状态进行变更时通过此接口通知省分PRM系统产品状态变更信息的功能。 8.2.2.2. 接口内容 n 输入项 序号 参数名 说明 是否必填 参数类型 最大长度 1 SequenceID 流水号 是 RecordSequenceID，从1开始，排满9999999999后重新循环。 CHAR 10 2 PartyID 合作伙伴标识 是 CHAR 8 3 ProductID 产品代码 是 CHAR 40 4 ProductStatus 产品状态 是 CHAR 1

42、5 UpdateType 更新类型， 1：增加 2：修改 3：删除 是 CHAR 1 n 输出项 序号 参数名 说明 是否必填 参数类型 最大长度 1 SequenceID 流水号 是 RecordSequenceID，从1开始，排满9999999999后重新循环。 CHAR 10 2 ResultCode 返回结果 0成功 1失败 是 CHAR 1 3 CodeInfo 失败原因 否 CHAR 40 9. 附录 修改历史 版本 时间 内容描述 1.0 2007年3月 版本建立 2.0 2009年7月 版本升级 删除 合作伙伴信息同步 新增 SP信息同步 新增 CP信息同步 修订 合作伙伴业务信息同步 修订接口字段内容 修订 合作伙伴产品信息同步 修订接口字段内容 删除 合作伙伴投诉处理 删除 服务使用记录同步 删除 业务之间关系同步 删除 俱乐部礼品信息同步 中国联通机密文件 第 20 页 共 22 页