NG1-BASS2.0规范培训-外部接口分册

中国移动省级NG1-BASS技术规范外部接口分册

04二月2023

目录1、总体说明3、互动接口2、数据源接口4、功能接口接口规范目的123减少省级经营分析系统与源系统之间的相互影响，保障生产系统的稳定安全降低省级经营分析系统和源系统间数据接口的建设风险和难度，保障数据接口的建设进度统一规范省级经营分析系统和源系统之间的连接关系和接口特性，规范各数据单元的接口格式4采用数据封装机制，统一规范省级经营分析系统向各外部系统提供信息服务的标准和接口内容接口规范原则在满足业务需求的前提下，使接口数据量最少，最大限度地减轻数据提供方压力保证省级经营分析系统与外部系统数据一致性具有可靠完善的接口数据传输与错误处理机制互动接口应符合开放系统的标准协议应具备完整性、规范性、开放性和灵活性互动接口应能够平滑地扩充互动接口连接必须具有安全控制机制接口定义遵循易理解、易使用、易交流、易扩展的原则扩展原则：由数据源传送方或数据源接收方发起的接口扩展，都必须采用现有的传输协议与模式，并与现有接口编码规则和命名规则保持一致编制原则：接口定位接口分类省级经营分析系统与外部系统的接口包括以下三类：数据源接口：是省级经营分析系统从外部系统获取数据的接口互动接口：是省级经营分析系统为外部系统提供数据信息的接口功能接口：主要包括省级经营分析系统与4A安全平台接口、信息推送接口目录1、总体说明3、互动接口2、数据源接口4、功能接口接口数据来源直接从省级业务支撑系统获取相关数据，如省级NG1-BOSS、NG1-CRM；直接从省级外部数据源系统，如：网管系统、彩铃平台、DSMP平台、OTA平台、WAP网关、网络信令采集子系统、VGOP平台、ERP/MIS系统等获取相关数据；间接通过省级VGOP系统获取一类业务数据：中央音乐平台/无线音乐平台

、手机报平台、飞信平台、号薄

管家平台、DM平台、手机电视平台、12580综合信息平台等的相关数据。间接通过省级VGOP系统获取二类业务数据间接通过一级经营分析系统获取：新业务营销体验平台、行业应用终端监控平台的相关数据。接口编码原则

接口单元类别名称类别代码字冠接口单元类别名称类别代码字冠客户管理01财务92客户服务02网络信令接口94成员管理03OTA平台接口95资源管理04中央业务类96计费帐务05网管接口97结算06彩铃98营销与市场调查07DSMP99参数配置与计算原则08

接口单元的编码单元类别代码二位数字序列号三位数值各接口单元的编码规则是：

<单元类别代码字冠>

<序列号>

96中央业务类接口单元增加了省级VGOP作为源系统的相关接口，例如飞信、手机报、号薄管家平台、终端管理平台、手机电视平台、12580平台、139邮箱平台、无线音乐平台的行为数据、维表数据和指标数据都从省级VGOP获取；但订购关系类数据以NG1-BOSS2.0为准，从NG1-BOSS2.0获取订购关系数据。关于彩铃平台接口数据，在省级VGOP未投入使用前，仍然从彩铃平台获取；在省级VGOP投入使用后，彩铃平台的数据从省级VGOP获取。关于新业务体验营销平台和行业应用终端平台的接口数据还是从中央业务平台获取。停止了手机支付接口。92财务类接口单元本次规范新增财务类接口。具体包括：广告成本、宣传成本、通信网运营成本、营销机构成本、销售费用、管理费用六个接口。94网络信令接口单元停止了94001——94008接口；对原有的94009A接口做了增加和修订，同时新增了94010Gb信令接口。01客户管理接口单元修改的接口有：01001、01002、01003、01007、01028等；新增接口：01035等；停止接口：01013、01015、01019、01034等。02客户服务接口单元对数据源分类做了修改，部分接口单元的说明和字段做了修订，其中修改的接口有：02001、02002等；对“01002集团客户”接口主要根据《中国移动省级NG1-BASS务规范集团客户分册2.0.0》进行了增加和修订。新增客户服务反馈类接口：02028、02029、02030等。03员工接口单元新增的接口：03030-03040等渠道类数据源接口04资源管理类接口单元主要对04014和01018根据TD内容做了修改，并停止了中继群、数据服务网关、短信中心、MISC、SSP、呼叫中心等17个接口。05计费帐务接口单元新增05043、05044、05045、05046接口；修订了05001、05002、05006、05009、05021、05022接口；修订部分主要增加了对TD业务的支撑。06结算接口单元修订了06005、06006、06007、06008、06009等接口，新增06024多媒体彩铃结算清单、06025TD终端租机业务结算、06026跨省集团短信结算、06027省际网间长途结算接口。07-营销与市场调查接口单元停止了广告类的接口；新增了营销反馈类接口。08-参数配置与计算原则接口单元停止了08113、08114接口；新增08115用户关系类型、08116俱乐部类型、08117客户与用户关系类型接口。目录1、总体说明3、互动接口2、数据源接口4、功能接口互动接口总表服务名称数据集接口单元说明

信息交互方式分类名称营销服务互动服务营销互动营销活动配置对一个具体的营销与服务活动进行概括描述的接口

。发布－订阅方式营销活动目标客户规则指营销活动中需要选择的目标客户群过滤的规则信息。发布－订阅方式营销活动目标客户指营销活动所选择的营销目标客户群的信息。发布－订阅方式活动触发规则用于全程精确营销信令实时匹配的各种参数规则接口

。发布－订阅方式活动执行区域指营销活动执行所覆盖的区域信息。发布－订阅方式资费产品推荐互动资费产品推荐通过客户细分、资费预演等专题分析，形成资费产品推荐信息。发布－订阅方式客户关怀互动客户挽留名单通过数据挖掘方法预测可能流失的客户，形成客户挽留名单信息。发布－订阅方式客户关怀信息通过客户细分模型等数据挖掘方法，对客户群体进行细分。发布－订阅方式策反互动策反方案信息通过分析潜在客户的消费行为、消费能力等轮廓信息生成策反方案。发布－订阅方式互动接口总表（续）分析结果查询服务分析结果查询业务历史数据分析结果数据集该接口用于经营分析系统向外部系统提供历史报表访问。在线请求—异步响应方式明细数据查询明细数据结果数据集该接口用于经营分析系统向外部系统提供详细数据访问。在线请求—异步响应方式客户统一视图服务客户统一视图获取个人客户基本属性信息该接口用于获取指定的个人客户的基础属性相关信息，包括基本属性、终端使用、终端功能属性等。在线请求—同步响应方式获取个人客户分析属性信息该接口用于获取指定的个人客户分析属性信息，包括客户行为属性、增值业务营销属性等。在线请求—同步响应方式获取客户标签属性信息该接口用于查询客户对应的客户标签信息。在线请求—同步响应方式获取客户数据及信息业务特征信息该接口用于获取客户使用数据及信息业务的行为特征信息。在线请求—同步响应方式营销服务互动服务营销服务互动服务的信息交换方式采用发布－订阅方式。营销服务互动服务中的注册服务由服务提供方提供，通知服务由服务请求方提供。支持营销服务互动服务数据集有营销互动、资费产品推荐互动、客户关怀互动、

和策反互动等。服务标识PublishSubscibeService服务描述注册服务由服务提供方提供。服务请求方调用注册服务，用于起订

或退订具体的服务。注册服务支持的数据集有营销互动、资费产品推荐互动、客户关怀互动、和策反互动等。

在注册服务的WSDL

服务描述中需要列出可订阅数据集信息。实现方式基于SOAP的Web服务。性能要求单次请求正常网络通讯情况下，响应时间必须在2秒之内；同一时间内支持的最大并发请求小于100。方法标识RegisterRequest方法描述服务请求方调用注册服务（PublishSubscibeService）的注册方法（RegisterRequest），并发送请求消息给服务提供方。服务提供方订阅操作完毕，并返回应答消息给服务请求方。

通知服务服务标识通知服务标识是由服务请求方在填写注册服务的请求信息中定义的。它是由注册服务（PublishSubscibeService）的注册方法（RegisterRequest）的请求消息中定义的通知服务标识（ServiceID）指定的。服务描述通知服务由服务请求方提供。服务提供方准备完数据，通过调用通知服务，告诉

服务请求方数据准备完毕。通知服务支持的数据集有营销互动、资费产品推荐互动、客户关怀互动、和策反互动等。

实现方式基于SOAP的Web服务。性能要求单次请求正常网络通讯情况下，响应时间必须在2秒之内；同一时间内支持的最大并发请求小于100。方法标识通知服务方法标识是由服务请求方在填写注册服务的请求信息中定义的。。

它是由注册服务（PublishSubscibeService）的注册方法（RegisterRequest）的请求消息中定义的通知服务方法标识（FunctionID）指定的。方法描述服务提供方数据准备完毕后，调用服务请求方提供的通知服务方法并传递请求消息。服务请求方接收到通知，返回应答消息给服务提供方。

目录1、总体说明3、互动接口2、数据源接口4、功能接口功能接口类别表类别代码接口单元一级类别名称说明01省级经营分析系统与安全平台接口主要实现省级经营分析系统与安全平台对接的接口，如：从帐号登录、从帐号查询、角色查询、从帐号变更、角色变更、从帐号权限查询等接口02信息推送接口省级经营分析系统通过短信推送接口，彩信推送接口和邮件推送接口功能模块并通过外部网关及服务器发送给用户的信息推送类接口。如：短信推送、彩信推送、邮件推送接口。省级经营分析系统与4A安全平台接口从帐号登录：通过改造经营分析系统的认证管理模块、数据安全管理模块来实现4A管理平台与经营分析系统之间的单点登录（SSO）、集中认证，接收请求并返回认证结果；从帐号查询：通过改造经营分析系统的用户管理模块、数据安全管理模块来实现4A管理平台对经营分析系统中从帐号及属性的查询；角色查询：通过改造经营分析系统的用户管理模块、数据安全管理模块来实现4A管理平台对经营分析系统中角色及属性的查询；从帐号变更：通过改造经营分析系统的用户管理模块、数据安全管理模块来实现4A管理平台对经营分析系统中从帐号及属性的变更、同步；角色变更：通过改造经营分析系统的用户管理模块、数据安全管理模块来实现4A管理平台对经营分析系统中角色及属性的变更、同步；从帐号权限查询：通过改造经营分析系统的权限管理模块、数据安全管理模块来实现4A管理平台对经营分析系统中从帐号角色关系、从帐号细粒度权限的查询；角色权限查询：通过改造经营分析系统的权限管理模块、数据安全管理模块来实现4A管理平台对经营分析系统中角色的权限的查询；从帐号角色变更：通过改造经营分析系统的权限管理模块、数据安全管理模块来实现4A管理平台对经营分析系统中从帐号的角色关系变更、同步；从帐号权限变更：改造经营分析系统的权限管理模块、数据安全管理模块，实现通过4A管理平台对经营分析系统中从帐号细粒度权限变更；审计日志传送：通过改造经营分析系统的审计日志记录和数据安全管理模块来实现4A管理平台对经营分析系统中登录记录和关键操作记录的过滤、格式化和发送。信息推送接口短信推送接口功能

短信推送接口功能模块负责通过CMPP协议与短信网关交互，使经营分析门户的信息以短信方式发送给用户。短信通知接口支持短信的群发与定时发送，传输的内容包括发送流水