NG1-BASS2.0規(guī)范培訓(xùn)-外部接口分冊(cè)

中國(guó)移動(dòng)省級(jí)NG1-BASS技術(shù)規(guī)范外部接口分冊(cè)

04二月2023

目錄1、總體說(shuō)明3、互動(dòng)接口2、數(shù)據(jù)源接口4、功能接口接口規(guī)范目的123減少省級(jí)經(jīng)營(yíng)分析系統(tǒng)與源系統(tǒng)之間的相互影響，保障生產(chǎn)系統(tǒng)的穩(wěn)定安全降低省級(jí)經(jīng)營(yíng)分析系統(tǒng)和源系統(tǒng)間數(shù)據(jù)接口的建設(shè)風(fēng)險(xiǎn)和難度，保障數(shù)據(jù)接口的建設(shè)進(jìn)度統(tǒng)一規(guī)范省級(jí)經(jīng)營(yíng)分析系統(tǒng)和源系統(tǒng)之間的連接關(guān)系和接口特性，規(guī)范各數(shù)據(jù)單元的接口格式4采用數(shù)據(jù)封裝機(jī)制，統(tǒng)一規(guī)范省級(jí)經(jīng)營(yíng)分析系統(tǒng)向各外部系統(tǒng)提供信息服務(wù)的標(biāo)準(zhǔn)和接口內(nèi)容接口規(guī)范原則在滿足業(yè)務(wù)需求的前提下，使接口數(shù)據(jù)量最少，最大限度地減輕數(shù)據(jù)提供方壓力保證省級(jí)經(jīng)營(yíng)分析系統(tǒng)與外部系統(tǒng)數(shù)據(jù)一致性具有可靠完善的接口數(shù)據(jù)傳輸與錯(cuò)誤處理機(jī)制互動(dòng)接口應(yīng)符合開放系統(tǒng)的標(biāo)準(zhǔn)協(xié)議應(yīng)具備完整性、規(guī)范性、開放性和靈活性互動(dòng)接口應(yīng)能夠平滑地?cái)U(kuò)充互動(dòng)接口連接必須具有安全控制機(jī)制接口定義遵循易理解、易使用、易交流、易擴(kuò)展的原則擴(kuò)展原則：由數(shù)據(jù)源傳送方或數(shù)據(jù)源接收方發(fā)起的接口擴(kuò)展，都必須采用現(xiàn)有的傳輸協(xié)議與模式，并與現(xiàn)有接口編碼規(guī)則和命名規(guī)則保持一致編制原則：接口定位接口分類省級(jí)經(jīng)營(yíng)分析系統(tǒng)與外部系統(tǒng)的接口包括以下三類：數(shù)據(jù)源接口：是省級(jí)經(jīng)營(yíng)分析系統(tǒng)從外部系統(tǒng)獲取數(shù)據(jù)的接口互動(dòng)接口：是省級(jí)經(jīng)營(yíng)分析系統(tǒng)為外部系統(tǒng)提供數(shù)據(jù)信息的接口功能接口：主要包括省級(jí)經(jīng)營(yíng)分析系統(tǒng)與4A安全平臺(tái)接口、信息推送接口目錄1、總體說(shuō)明3、互動(dòng)接口2、數(shù)據(jù)源接口4、功能接口接口數(shù)據(jù)來(lái)源直接從省級(jí)業(yè)務(wù)支撐系統(tǒng)獲取相關(guān)數(shù)據(jù)，如省級(jí)NG1-BOSS、NG1-CRM；直接從省級(jí)外部數(shù)據(jù)源系統(tǒng)，如：網(wǎng)管系統(tǒng)、彩鈴平臺(tái)、DSMP平臺(tái)、OTA平臺(tái)、WAP網(wǎng)關(guān)、網(wǎng)絡(luò)信令采集子系統(tǒng)、VGOP平臺(tái)、ERP/MIS系統(tǒng)等獲取相關(guān)數(shù)據(jù)；間接通過(guò)省級(jí)VGOP系統(tǒng)獲取一類業(yè)務(wù)數(shù)據(jù)：中央音樂(lè)平臺(tái)/無(wú)線音樂(lè)平臺(tái)

、手機(jī)報(bào)平臺(tái)、飛信平臺(tái)、號(hào)薄

管家平臺(tái)、DM平臺(tái)、手機(jī)電視平臺(tái)、12580綜合信息平臺(tái)等的相關(guān)數(shù)據(jù)。間接通過(guò)省級(jí)VGOP系統(tǒng)獲取二類業(yè)務(wù)數(shù)據(jù)間接通過(guò)一級(jí)經(jīng)營(yíng)分析系統(tǒng)獲?。盒聵I(yè)務(wù)營(yíng)銷體驗(yàn)平臺(tái)、行業(yè)應(yīng)用終端監(jiān)控平臺(tái)的相關(guān)數(shù)據(jù)。接口編碼原則

接口單元類別名稱類別代碼字冠接口單元類別名稱類別代碼字冠客戶管理01財(cái)務(wù)92客戶服務(wù)02網(wǎng)絡(luò)信令接口94成員管理03OTA平臺(tái)接口95資源管理04中央業(yè)務(wù)類96計(jì)費(fèi)帳務(wù)05網(wǎng)管接口97結(jié)算06彩鈴98營(yíng)銷與市場(chǎng)調(diào)查07DSMP99參數(shù)配置與計(jì)算原則08

接口單元的編碼單元類別代碼二位數(shù)字序列號(hào)三位數(shù)值各接口單元的編碼規(guī)則是：

<單元類別代碼字冠>

<序列號(hào)>

96中央業(yè)務(wù)類接口單元增加了省級(jí)VGOP作為源系統(tǒng)的相關(guān)接口，例如飛信、手機(jī)報(bào)、號(hào)薄管家平臺(tái)、終端管理平臺(tái)、手機(jī)電視平臺(tái)、12580平臺(tái)、139郵箱平臺(tái)、無(wú)線音樂(lè)平臺(tái)的行為數(shù)據(jù)、維表數(shù)據(jù)和指標(biāo)數(shù)據(jù)都從省級(jí)VGOP獲?。坏嗁?gòu)關(guān)系類數(shù)據(jù)以NG1-BOSS2.0為準(zhǔn)，從NG1-BOSS2.0獲取訂購(gòu)關(guān)系數(shù)據(jù)。關(guān)于彩鈴平臺(tái)接口數(shù)據(jù)，在省級(jí)VGOP未投入使用前，仍然從彩鈴平臺(tái)獲?。辉谑〖?jí)VGOP投入使用后，彩鈴平臺(tái)的數(shù)據(jù)從省級(jí)VGOP獲取。關(guān)于新業(yè)務(wù)體驗(yàn)營(yíng)銷平臺(tái)和行業(yè)應(yīng)用終端平臺(tái)的接口數(shù)據(jù)還是從中央業(yè)務(wù)平臺(tái)獲取。停止了手機(jī)支付接口。92財(cái)務(wù)類接口單元本次規(guī)范新增財(cái)務(wù)類接口。具體包括：廣告成本、宣傳成本、通信網(wǎng)運(yùn)營(yíng)成本、營(yíng)銷機(jī)構(gòu)成本、銷售費(fèi)用、管理費(fèi)用六個(gè)接口。94網(wǎng)絡(luò)信令接口單元停止了94001——94008接口；對(duì)原有的94009A接口做了增加和修訂，同時(shí)新增了94010Gb信令接口。01客戶管理接口單元修改的接口有：01001、01002、01003、01007、01028等；新增接口：01035等；停止接口：01013、01015、01019、01034等。02客戶服務(wù)接口單元對(duì)數(shù)據(jù)源分類做了修改，部分接口單元的說(shuō)明和字段做了修訂，其中修改的接口有：02001、02002等；對(duì)“01002集團(tuán)客戶”接口主要根據(jù)《中國(guó)移動(dòng)省級(jí)NG1-BASS務(wù)規(guī)范集團(tuán)客戶分冊(cè)2.0.0》進(jìn)行了增加和修訂。新增客戶服務(wù)反饋類接口：02028、02029、02030等。03員工接口單元新增的接口：03030-03040等渠道類數(shù)據(jù)源接口04資源管理類接口單元主要對(duì)04014和01018根據(jù)TD內(nèi)容做了修改，并停止了中繼群、數(shù)據(jù)服務(wù)網(wǎng)關(guān)、短信中心、MISC、SSP、呼叫中心等17個(gè)接口。05計(jì)費(fèi)帳務(wù)接口單元新增05043、05044、05045、05046接口；修訂了05001、05002、05006、05009、05021、05022接口；修訂部分主要增加了對(duì)TD業(yè)務(wù)的支撐。06結(jié)算接口單元修訂了06005、06006、06007、06008、06009等接口，新增06024多媒體彩鈴結(jié)算清單、06025TD終端租機(jī)業(yè)務(wù)結(jié)算、06026跨省集團(tuán)短信結(jié)算、06027省際網(wǎng)間長(zhǎng)途結(jié)算接口。07-營(yíng)銷與市場(chǎng)調(diào)查接口單元停止了廣告類的接口；新增了營(yíng)銷反饋類接口。08-參數(shù)配置與計(jì)算原則接口單元停止了08113、08114接口；新增08115用戶關(guān)系類型、08116俱樂(lè)部類型、08117客戶與用戶關(guān)系類型接口。目錄1、總體說(shuō)明3、互動(dòng)接口2、數(shù)據(jù)源接口4、功能接口互動(dòng)接口總表服務(wù)名稱數(shù)據(jù)集接口單元說(shuō)明

信息交互方式分類名稱營(yíng)銷服務(wù)互動(dòng)服務(wù)營(yíng)銷互動(dòng)營(yíng)銷活動(dòng)配置對(duì)一個(gè)具體的營(yíng)銷與服務(wù)活動(dòng)進(jìn)行概括描述的接口

。發(fā)布－訂閱方式營(yíng)銷活動(dòng)目標(biāo)客戶規(guī)則指營(yíng)銷活動(dòng)中需要選擇的目標(biāo)客戶群過(guò)濾的規(guī)則信息。發(fā)布－訂閱方式營(yíng)銷活動(dòng)目標(biāo)客戶指營(yíng)銷活動(dòng)所選擇的營(yíng)銷目標(biāo)客戶群的信息。發(fā)布－訂閱方式活動(dòng)觸發(fā)規(guī)則用于全程精確營(yíng)銷信令實(shí)時(shí)匹配的各種參數(shù)規(guī)則接口

。發(fā)布－訂閱方式活動(dòng)執(zhí)行區(qū)域指營(yíng)銷活動(dòng)執(zhí)行所覆蓋的區(qū)域信息。發(fā)布－訂閱方式資費(fèi)產(chǎn)品推薦互動(dòng)資費(fèi)產(chǎn)品推薦通過(guò)客戶細(xì)分、資費(fèi)預(yù)演等專題分析，形成資費(fèi)產(chǎn)品推薦信息。發(fā)布－訂閱方式客戶關(guān)懷互動(dòng)客戶挽留名單通過(guò)數(shù)據(jù)挖掘方法預(yù)測(cè)可能流失的客戶，形成客戶挽留名單信息。發(fā)布－訂閱方式客戶關(guān)懷信息通過(guò)客戶細(xì)分模型等數(shù)據(jù)挖掘方法，對(duì)客戶群體進(jìn)行細(xì)分。發(fā)布－訂閱方式策反互動(dòng)策反方案信息通過(guò)分析潛在客戶的消費(fèi)行為、消費(fèi)能力等輪廓信息生成策反方案。發(fā)布－訂閱方式互動(dòng)接口總表（續(xù)）分析結(jié)果查詢服務(wù)分析結(jié)果查詢業(yè)務(wù)歷史數(shù)據(jù)分析結(jié)果數(shù)據(jù)集該接口用于經(jīng)營(yíng)分析系統(tǒng)向外部系統(tǒng)提供歷史報(bào)表訪問(wèn)。在線請(qǐng)求—異步響應(yīng)方式明細(xì)數(shù)據(jù)查詢明細(xì)數(shù)據(jù)結(jié)果數(shù)據(jù)集該接口用于經(jīng)營(yíng)分析系統(tǒng)向外部系統(tǒng)提供詳細(xì)數(shù)據(jù)訪問(wèn)。在線請(qǐng)求—異步響應(yīng)方式客戶統(tǒng)一視圖服務(wù)客戶統(tǒng)一視圖獲取個(gè)人客戶基本屬性信息該接口用于獲取指定的個(gè)人客戶的基礎(chǔ)屬性相關(guān)信息，包括基本屬性、終端使用、終端功能屬性等。在線請(qǐng)求—同步響應(yīng)方式獲取個(gè)人客戶分析屬性信息該接口用于獲取指定的個(gè)人客戶分析屬性信息，包括客戶行為屬性、增值業(yè)務(wù)營(yíng)銷屬性等。在線請(qǐng)求—同步響應(yīng)方式獲取客戶標(biāo)簽屬性信息該接口用于查詢客戶對(duì)應(yīng)的客戶標(biāo)簽信息。在線請(qǐng)求—同步響應(yīng)方式獲取客戶數(shù)據(jù)及信息業(yè)務(wù)特征信息該接口用于獲取客戶使用數(shù)據(jù)及信息業(yè)務(wù)的行為特征信息。在線請(qǐng)求—同步響應(yīng)方式營(yíng)銷服務(wù)互動(dòng)服務(wù)營(yíng)銷服務(wù)互動(dòng)服務(wù)的信息交換方式采用發(fā)布－訂閱方式。營(yíng)銷服務(wù)互動(dòng)服務(wù)中的注冊(cè)服務(wù)由服務(wù)提供方提供，通知服務(wù)由服務(wù)請(qǐng)求方提供。支持營(yíng)銷服務(wù)互動(dòng)服務(wù)數(shù)據(jù)集有營(yíng)銷互動(dòng)、資費(fèi)產(chǎn)品推薦互動(dòng)、客戶關(guān)懷互動(dòng)、

和策反互動(dòng)等。服務(wù)標(biāo)識(shí)PublishSubscibeService服務(wù)描述注冊(cè)服務(wù)由服務(wù)提供方提供。服務(wù)請(qǐng)求方調(diào)用注冊(cè)服務(wù)，用于起訂

或退訂具體的服務(wù)。注冊(cè)服務(wù)支持的數(shù)據(jù)集有營(yíng)銷互動(dòng)、資費(fèi)產(chǎn)品推薦互動(dòng)、客戶關(guān)懷互動(dòng)、和策反互動(dòng)等。

在注冊(cè)服務(wù)的WSDL

服務(wù)描述中需要列出可訂閱數(shù)據(jù)集信息。實(shí)現(xiàn)方式基于SOAP的Web服務(wù)。性能要求單次請(qǐng)求正常網(wǎng)絡(luò)通訊情況下，響應(yīng)時(shí)間必須在2秒之內(nèi)；同一時(shí)間內(nèi)支持的最大并發(fā)請(qǐng)求小于100。方法標(biāo)識(shí)RegisterRequest方法描述服務(wù)請(qǐng)求方調(diào)用注冊(cè)服務(wù)（PublishSubscibeService）的注冊(cè)方法（RegisterRequest），并發(fā)送請(qǐng)求消息給服務(wù)提供方。服務(wù)提供方訂閱操作完畢，并返回應(yīng)答消息給服務(wù)請(qǐng)求方。

通知服務(wù)服務(wù)標(biāo)識(shí)通知服務(wù)標(biāo)識(shí)是由服務(wù)請(qǐng)求方在填寫注冊(cè)服務(wù)的請(qǐng)求信息中定義的。它是由注冊(cè)服務(wù)（PublishSubscibeService）的注冊(cè)方法（RegisterRequest）的請(qǐng)求消息中定義的通知服務(wù)標(biāo)識(shí)（ServiceID）指定的。服務(wù)描述通知服務(wù)由服務(wù)請(qǐng)求方提供。服務(wù)提供方準(zhǔn)備完數(shù)據(jù)，通過(guò)調(diào)用通知服務(wù)，告訴

服務(wù)請(qǐng)求方數(shù)據(jù)準(zhǔn)備完畢。通知服務(wù)支持的數(shù)據(jù)集有營(yíng)銷互動(dòng)、資費(fèi)產(chǎn)品推薦互動(dòng)、客戶關(guān)懷互動(dòng)、和策反互動(dòng)等。

實(shí)現(xiàn)方式基于SOAP的Web服務(wù)。性能要求單次請(qǐng)求正常網(wǎng)絡(luò)通訊情況下，響應(yīng)時(shí)間必須在2秒之內(nèi)；同一時(shí)間內(nèi)支持的最大并發(fā)請(qǐng)求小于100。方法標(biāo)識(shí)通知服務(wù)方法標(biāo)識(shí)是由服務(wù)請(qǐng)求方在填寫注冊(cè)服務(wù)的請(qǐng)求信息中定義的。。

它是由注冊(cè)服務(wù)（PublishSubscibeService）的注冊(cè)方法（RegisterRequest）的請(qǐng)求消息中定義的通知服務(wù)方法標(biāo)識(shí)（FunctionID）指定的。方法描述服務(wù)提供方數(shù)據(jù)準(zhǔn)備完畢后，調(diào)用服務(wù)請(qǐng)求方提供的通知服務(wù)方法并傳遞請(qǐng)求消息。服務(wù)請(qǐng)求方接收到通知，返回應(yīng)答消息給服務(wù)提供方。

目錄1、總體說(shuō)明3、互動(dòng)接口2、數(shù)據(jù)源接口4、功能接口功能接口類別表類別代碼接口單元一級(jí)類別名稱說(shuō)明01省級(jí)經(jīng)營(yíng)分析系統(tǒng)與安全平臺(tái)接口主要實(shí)現(xiàn)省級(jí)經(jīng)營(yíng)分析系統(tǒng)與安全平臺(tái)對(duì)接的接口，如：從帳號(hào)登錄、從帳號(hào)查詢、角色查詢、從帳號(hào)變更、角色變更、從帳號(hào)權(quán)限查詢等接口02信息推送接口省級(jí)經(jīng)營(yíng)分析系統(tǒng)通過(guò)短信推送接口，彩信推送接口和郵件推送接口功能模塊并通過(guò)外部網(wǎng)關(guān)及服務(wù)器發(fā)送給用戶的信息推送類接口。如：短信推送、彩信推送、郵件推送接口。省級(jí)經(jīng)營(yíng)分析系統(tǒng)與4A安全平臺(tái)接口從帳號(hào)登錄：通過(guò)改造經(jīng)營(yíng)分析系統(tǒng)的認(rèn)證管理模塊、數(shù)據(jù)安全管理模塊來(lái)實(shí)現(xiàn)4A管理平臺(tái)與經(jīng)營(yíng)分析系統(tǒng)之間的單點(diǎn)登錄（SSO）、集中認(rèn)證，接收請(qǐng)求并返回認(rèn)證結(jié)果；從帳號(hào)查詢：通過(guò)改造經(jīng)營(yíng)分析系統(tǒng)的用戶管理模塊、數(shù)據(jù)安全管理模塊來(lái)實(shí)現(xiàn)4A管理平臺(tái)對(duì)經(jīng)營(yíng)分析系統(tǒng)中從帳號(hào)及屬性的查詢；角色查詢：通過(guò)改造經(jīng)營(yíng)分析系統(tǒng)的用戶管理模塊、數(shù)據(jù)安全管理模塊來(lái)實(shí)現(xiàn)4A管理平臺(tái)對(duì)經(jīng)營(yíng)分析系統(tǒng)中角色及屬性的查詢；從帳號(hào)變更：通過(guò)改造經(jīng)營(yíng)分析系統(tǒng)的用戶管理模塊、數(shù)據(jù)安全管理模塊來(lái)實(shí)現(xiàn)4A管理平臺(tái)對(duì)經(jīng)營(yíng)分析系統(tǒng)中從帳號(hào)及屬性的變更、同步；角色變更：通過(guò)改造經(jīng)營(yíng)分析系統(tǒng)的用戶管理模塊、數(shù)據(jù)安全管理模塊來(lái)實(shí)現(xiàn)4A管理平臺(tái)對(duì)經(jīng)營(yíng)分析系統(tǒng)中角色及屬性的變更、同步；從帳號(hào)權(quán)限查詢：通過(guò)改造經(jīng)營(yíng)分析系統(tǒng)的權(quán)限管理模塊、數(shù)據(jù)安全管理模塊來(lái)實(shí)現(xiàn)4A管理平臺(tái)對(duì)經(jīng)營(yíng)分析系統(tǒng)中從帳號(hào)角色關(guān)系、從帳號(hào)細(xì)粒度權(quán)限的查詢；角色權(quán)限查詢：通過(guò)改造經(jīng)營(yíng)分析系統(tǒng)的權(quán)限管理模塊、數(shù)據(jù)安全管理模塊來(lái)實(shí)現(xiàn)4A管理平臺(tái)對(duì)經(jīng)營(yíng)分析系統(tǒng)中角色的權(quán)限的查詢；從帳號(hào)角色變更：通過(guò)改造經(jīng)營(yíng)分析系統(tǒng)的權(quán)限管理模塊、數(shù)據(jù)安全管理模塊來(lái)實(shí)現(xiàn)4A管理平臺(tái)對(duì)經(jīng)營(yíng)分析系統(tǒng)中從帳號(hào)的角色關(guān)系變更、同步；從帳號(hào)權(quán)限變更：改造經(jīng)營(yíng)分析系統(tǒng)的權(quán)限管理模塊、數(shù)據(jù)安全管理模塊，實(shí)現(xiàn)通過(guò)4A管理平臺(tái)對(duì)經(jīng)營(yíng)分析系統(tǒng)中從帳號(hào)細(xì)粒度權(quán)限變更；審計(jì)日志傳送：通過(guò)改造經(jīng)營(yíng)分析系統(tǒng)的審計(jì)日志記錄和數(shù)據(jù)安全管理模塊來(lái)實(shí)現(xiàn)4A管理平臺(tái)對(duì)經(jīng)營(yíng)分析系統(tǒng)中登錄記錄和關(guān)鍵操作記錄的過(guò)濾、格式化和發(fā)送。信息推送接口短信推送接口功能

短信推送接口功能模塊負(fù)責(zé)通過(guò)CMPP協(xié)議與短信網(wǎng)關(guān)交互，使經(jīng)營(yíng)分析門戶的信息以短信方式發(fā)送給用戶。短信通知接口支持短信的群發(fā)與定時(shí)發(fā)送，傳輸?shù)膬?nèi)容包括發(fā)送流水