SP 短信開發(fā)基礎(chǔ)知識篇(MISC系統(tǒng)短信SP接入培訓(xùn))

1、SP 短信開發(fā)-根底知識篇2(MISC系統(tǒng)短信SP接入培訓(xùn))導(dǎo)讀： MISC系統(tǒng)短信SP接入培訓(xùn) 第一章、接口改造分冊.4 一、MISC系統(tǒng)結(jié)構(gòu)和作用.4 1、SP接入MISC流程.4 2、SP接入MISC流程流程說明.5 3、接口改造總體說明.5 4、接口改造需具備條件.6 二、CMPP協(xié)議.6 1、CMPP2.0和CMPP3.0區(qū)別SP登錄.6 2、CMPP2.0和CMPP3.0區(qū)別協(xié)議包的變化.7 3、CMPP3.0協(xié)議包體說明CMPP_SUBMIT.7 4、CMPP3.0協(xié)議包體說明CMPP_SUBMIT_RESP.9 5、CMPP3.0協(xié)議包體說明CMPP_DELIVER.9 6、C

2、MPP3.0協(xié)議包體說明CMPP_DELIVER_RESP.11 7、CMPP3.0協(xié)議包體說明_網(wǎng)關(guān)返回狀態(tài)報告.11 8、CMPP3.0協(xié)議包體說明_返回狀態(tài)報告值.12 9、MISC常見錯誤代碼說明.12 三、PROVISION接口.13 1、正向同步PROVISION接口標(biāo)準(zhǔn)流程圖.13 2、正向同步PROVISION接口標(biāo)準(zhǔn)流程說明.13 3、正向同步PROVISION接口消息定義.14 4、正向同步接口應(yīng)答包消息定義.16 5、正向訂購、取消包例如.17 6、反向訂購接口標(biāo)準(zhǔn)流程圖.18 7、反向訂購接口標(biāo)準(zhǔn)流程說明.19 8、反向訂購接口消息定義.20 9、反向取消接口標(biāo)準(zhǔn)流程圖

3、.21 10、反向取消接口標(biāo)準(zhǔn)流程說明.21 11、反向取消接口消息定義.22 12、反向訂購、取消包例如.23 四、網(wǎng)站SSO接口.26 1、用戶在中央SSO的iframe頁面上登錄.26 2、用戶在SP網(wǎng)站上進(jìn)行登錄的處理流程.27 3、SSO登錄接口定義.28 4、查詢用戶信息接口.29 5、用戶訂購業(yè)務(wù)與點播下載業(yè)務(wù)的處理流程.30 6、SSO訂購、點播接口定義.31 7、效勞下發(fā)請求接口.33 第二章、業(yè)務(wù)改造分冊.34 一、業(yè)務(wù)改造.34 1、業(yè)務(wù)改造重要性說明.34 2、SP升級前后特性比照.34 3、業(yè)務(wù)類型分類說明.35 4、業(yè)務(wù)類型分類說明.36 二、MO指令規(guī)劃建議.37

4、 1、MO指令規(guī)劃.37 2、MO指令的匹配過程.37 3、MO匹配流程.38 4、指令匹配流程說明.38 5、MO正向訂購流程舉例.39 三、指令流程說明.39 1、訂購指令匹配處理流程.39 2、取消指令匹配處理流程.40 3、點播指令匹配處理流程.40 4、普通MO匹配處理流程.40 5、MO匹配實例.40 四、業(yè)務(wù)規(guī)劃.41 1、訂購業(yè)務(wù)種類規(guī)劃.41 2、定制、取消點播指令設(shè)置.41 3、反向訂購業(yè)務(wù)申請.41 4、統(tǒng)一反向取消接口開放.42 5、包月話單收取.42 五、業(yè)務(wù)組合模式說明.42 1、關(guān)聯(lián)業(yè)務(wù)組合.43 2、不同等級業(yè)務(wù)組合.43 3、套餐式業(yè)務(wù)組合.43 4、普通業(yè)務(wù)

5、組合.43 5、特殊業(yè)務(wù)設(shè)計舉例.44 6、包月定制類業(yè)務(wù)需要免費使用N個月.44 7、VIP用戶群免費使用業(yè)務(wù).44 8、游戲、聊天類業(yè)務(wù).45 9、 股票信息點播、定制.45 第三章、SPOA分冊.45 一、系統(tǒng)概述.46 1、移動夢網(wǎng)運營管理系統(tǒng)介紹.46 2、SP自效勞系統(tǒng)介紹.46 二、短信合作申請管理.47 1、注冊登錄賬號.47 2、本地新SP合作申請流程圖.48 3、SP合作申請資料填寫說明.49 4、本地升級為全網(wǎng)SP申請流程.51 5、全網(wǎng)SP本地接入合作申請.51 6、變更合作申請資料.52 二、短信業(yè)務(wù)管理.53 1、短信本地業(yè)務(wù)申請流程.54 2、短信業(yè)務(wù)申請資料填寫

6、說明.54 3、短信全網(wǎng)業(yè)務(wù)申請流程.57 4、申請短信業(yè)務(wù)變更.57 三、通用信息.58 1、公共信息介紹.58 2、私有信息.58 四、投訴處理.59 1、用戶投訴.59 2、SP投訴.60 第一章、接口改造分冊 MISC系統(tǒng)結(jié)構(gòu)和作用 SP接入MISC流程 CMPP3.0接口開發(fā)說明 正反向訂購接口開發(fā)說明 網(wǎng)站改造SSO接口流程說明 一、MISC系統(tǒng)結(jié)構(gòu)和作用 1、SP接入MISC流程 組織SP培訓(xùn) SP程序開發(fā)及業(yè)務(wù)梳理 安排SP在試驗環(huán)境做接口測試 現(xiàn)網(wǎng)全業(yè)務(wù)申報 SP進(jìn)行全業(yè)務(wù)自行撥測及相關(guān)程序調(diào)整 SP提交全業(yè)務(wù)撥測報告供計費驗證 安排割接 N N 2、SP接入MISC流程流程

7、說明 1首先需要組織SP參與MISC升級改造培訓(xùn) 2培訓(xùn)結(jié)束后SP就應(yīng)該開始著手進(jìn)行業(yè)務(wù)梳理及接口程序開發(fā)，并在移動要求的時間內(nèi)完成這項工作 3SP具備接口測試條件以后，集中統(tǒng)一安排在測試環(huán)境做接口測試及典型業(yè)務(wù)申報 4接口測試通過以后根據(jù)現(xiàn)網(wǎng)MISC系統(tǒng)建設(shè)情況，安排接口測試通過的SP在現(xiàn)網(wǎng)做全業(yè)務(wù)申報和全業(yè)務(wù)撥測 5全業(yè)務(wù)撥測通過后提交撥測報告供計費做計費驗證 6驗證通過后根據(jù)網(wǎng)絡(luò)部的割接方案安排割接 3、接口改造總體說明 在整個升級改造過程中“接口改造占了一個非常重要的位置。SP需要根據(jù)CMPP3.0協(xié)議和DSMP標(biāo)準(zhǔn)對自己的接口進(jìn)行改造開發(fā)，才能接入MISC。 接口改造主要分為以下幾個

8、方面： 1CMPP3.0接口程序改造 2正反向訂購、取消接口開發(fā) 3網(wǎng)站改造SSO接口開發(fā) CMPP3.0接口改造說明 接口開發(fā)需具備條件 CMPP2.0和CMPP3.0區(qū)別 CMPP3.0協(xié)議包體說明 4、接口改造需具備條件 1、自己開發(fā)接口的SP，應(yīng)根據(jù)CMPP3.0協(xié)議對接口進(jìn)行修改；使用API的SP，應(yīng)向接入網(wǎng)關(guān)的省公司或網(wǎng)關(guān)廠家索取最新的CMPP3.0接口API以及使用說明等相關(guān)文檔 2、不管是自己開發(fā)接口的，還是使用接口API的SP，都應(yīng)該詳細(xì)了解CMPP2.0和CMPP3.0的區(qū)別 二、CMPP協(xié)議 1、CMPP2.0和CMPP3.0區(qū)別SP登錄 CMPP2.0和CMPP3.0區(qū)

9、別SP登錄 1、SP向所接入的ISMG發(fā)送登錄請求； 2、ISMG向MISC發(fā)送SP登陸鑒權(quán)信息查詢請求； 3、MISC向ISMG返回SP登陸鑒權(quán)結(jié)果； 4、ISMG根據(jù)此信息進(jìn)行SP登陸認(rèn)證，并向SP返回認(rèn)證結(jié)果； 2、CMPP2.0和CMPP3.0區(qū)別協(xié)議包的變化 1 包內(nèi)容的變化：CMPP_SUBMIT CMPP3.0中新增字段： Fee_terminal_type：被計費用戶的號碼類型，0：真實號碼；1：偽碼 Dest_terminal_type：接收短信的用戶號碼類型，0：真實號碼；1：偽碼 LinkID：20個字節(jié)，點播業(yè)務(wù)使用，非點播類業(yè)務(wù)的MT流程不使用該字段 CMPP3.0中

10、刪除字段： Reserve：保存字段。 CMPP3.0中變化字段： Fee_terminal_id：被計費用戶號碼。長度擴展為32個字節(jié)，數(shù)據(jù)類型從UnsignedInteger修改為OctetString Dest_terminal_id：接收短信的用戶號碼。長度擴展為32個字節(jié)，數(shù)據(jù)類型從UnsignedInteger修改為OctetString 2 包內(nèi)容的變化CMPP_DELIVER CMPP3.0中新增字段： Src_terminal_type：源終端號碼類型，0：真實號碼；1：偽碼 LinkID：20個字節(jié)，點播業(yè)務(wù)使用，非點播類業(yè)務(wù)的MT流程不使用字段 CMPP3.0中刪除字段：

11、 Reserve：保存字段 CMPP3.0中變化字段： Src_terminal_id：源終端號碼。長度擴展為32個字節(jié)，數(shù)據(jù)類型從UnsignedInteger修改為OctetString 字段說明： 偽碼：一個隨機字符串，對于一個SP，唯一標(biāo)識一個用戶 LinkID：20位字符串，該字段的值由MISC產(chǎn)生，編碼格式為4位MISCID+12位時間+4位序列號。用于點播類業(yè)務(wù)中MT與MO消息的匹配。 3、CMPP3.0協(xié)議包體說明CMPP_SUBMIT 字段名 字節(jié)數(shù) 屬性 描述 Msg_Id 8 UnsignedInteger 信息標(biāo)識 Pk_total 1 UnsignedInteger

12、相同Msg_Id的信息總條數(shù)，從1開始。 Pk_number 1 UnsignedInteger 相同Msg_Id的信息序號，從1開始。 Registered_Delivery 1 UnsignedInteger 是否要求返回狀態(tài)確認(rèn)報告： 0：不需要； 1：需要。 Msg_level 1 UnsignedInteger 信息級別。 Service_Id 10 OctetString 業(yè)務(wù)標(biāo)識，是數(shù)字、字母和符號的組合。 Fee_UserType 1 UnsignedInteger 計費用戶類型字段： 0：對目的終端MSISDN計費； 1：對源終端MSISDN計費； 2：對SP計費； 3：表示

13、本字段無效，對誰計費參見Fee_terminal_Id字段。 Fee_terminal_Id 32 OctetString 被計費用戶的號碼，當(dāng)Fee_UserType為3時該值有效，當(dāng)Fee_UserType為0、1、2時該值無意義。 Fee_terminal_type 1 UnsignedInteger 被計費用戶的號碼類型，0：真實號碼；1：偽碼。 TP_pId 1 UnsignedInteger GSM協(xié)議類型。詳細(xì)是解釋請參考GSM03.40中的。 TP_udhi 1 UnsignedInteger GSM協(xié)議類型。詳細(xì)是解釋請參考GSM03.40中的僅使用1位，右對齊。 Msg_F

14、mt 1 UnsignedInteger 信息格式： 0：ASCII串； 3：短信寫卡操作； 4：二進(jìn)制信息； 8：UCS2編碼； 15：含GB漢字。 Msg_src 6 OctetString 信息內(nèi)容來源(SP_Id)。 FeeType 2 OctetString 資費類別： 01：對“計費用戶號碼免費； 02：對“計費用戶號碼按條計信息費； 03：對“計費用戶號碼按包月收取信息費。 FeeCode 6 OctetString 資費代碼以分為單位。 ValId_Time 17 OctetString 存活有效期，格式遵循SMPP3.3協(xié)議。 At_Time 17 OctetString 定

15、時發(fā)送時間，格式遵循SMPP3.3協(xié)議。 Src_Id 21 OctetString 源號碼。SP的效勞代碼或前綴為效勞代碼的長號碼,網(wǎng)關(guān)將該號 碼完整的填到SMPP協(xié)議Submit_SM消息相應(yīng)的source_addr字段， 該號碼最終在用戶 上顯示為短消息的主叫號碼。 DestUsr_tl 1 UnsignedInteger 接收信息的用戶數(shù)量(小于100個用戶)。 Dest_terminal_Id 32*DestUsr_tl OctetString 接收短信的MSISDN號碼。 Dest_terminal_type 1 UnsignedInteger 接收短信的用戶的號碼類型，0：真實號

16、碼；1：偽碼。 Msg_Length 1 UnsignedInteger 信息長度(Msg_Fmt值為0時：160個字節(jié)；其它=140個字節(jié))， 取值大于或等于0。 Msg_Content Msg_length OctetString 信息內(nèi)容。 LinkID 20 OctetString 點播業(yè)務(wù)使用的LinkID，非點播類業(yè)務(wù)的MT流程不使用該字段。 4、CMPP3.0協(xié)議包體說明CMPP_SUBMIT_RESP 字段名 字節(jié)數(shù) 屬性 描述 Msg_Id 8 UnsignedInteger 信息標(biāo)識，生成算法如下： 采用64位8字節(jié)的整數(shù)： 時間格式為MMDDHHMMSS，即月日時分秒：b

17、it64bit39，其中 bit64bit61：月份的二進(jìn)制表示； bit60bit56：日的二進(jìn)制表示； bit55bit51：小時的二進(jìn)制表示； bit50bit45：分的二進(jìn)制表示； bit44bit39：秒的二進(jìn)制表示； 短信網(wǎng)關(guān)代碼：bit38bit17，把短信網(wǎng)關(guān)的代碼轉(zhuǎn)換為整數(shù)填寫到該字段中； 序列號：bit16bit1，順序增加，步長為1，循環(huán)使用。 各局部如不能填滿，左補零，右對齊。 SP根據(jù)請求和應(yīng)答消息的Sequence_Id一致性就可得到CMPP_Submit消息的Msg_Id Result 4 UnsignedInteger 結(jié)果： 0：正確； 1：消息結(jié)構(gòu)錯； 2：

18、命令字錯； 3：消息序號重復(fù)； 4：消息長度錯； 5：資費代碼錯； 6：超過最大信息長； 7：業(yè)務(wù)代碼錯； 8：流量控制錯； 9：本網(wǎng)關(guān)不負(fù)責(zé)效勞此計費號碼； 10：Src_Id錯誤； 11：Msg_src錯誤； 12：Fee_terminal_Id錯誤； 13：Dest_terminal_Id錯誤； 5、CMPP3.0協(xié)議包體說明CMPP_DELIVER 字段名 字節(jié)數(shù) 屬性 描述 Msg_Id 8 UnsignedInteger 信息標(biāo)識。 生成算法如下： 采用64位8字節(jié)的整數(shù)： 時間格式為MMDDHHMMSS，即月日時分秒：bit64bit39，其中 bit64bit61：月份的二進(jìn)制

19、表示； bit60bit56：日的二進(jìn)制表示； bit55bit51：小時的二進(jìn)制表示； bit50bit45：分的二進(jìn)制表示； bit44bit39：秒的二進(jìn)制表示； 1.短信網(wǎng)關(guān)代碼：bit38bit17，把短信網(wǎng)關(guān)的代碼轉(zhuǎn)換為整數(shù)填寫到該字段中；序列號：bit16bit1，順序增加，步長為1，循環(huán)使用。 各局部如不能填滿，左補零，右對齊。 Dest_Id 21 OctetString 目的號碼。 SP的效勞代碼，一般4-6位，或者是前綴為效勞代碼的 長號碼；該號碼是 用戶短消息的被叫號碼。 Service_Id 10 OctetString 業(yè)務(wù)標(biāo)識，是數(shù)字、字母和符號的組合。 TP_p

20、id 1 UnsignedInteger GSM協(xié)議類型。詳細(xì)解釋請參考GSM03.40中的。 TP_udhi 1 UnsignedInteger GSM協(xié)議類型。詳細(xì)解釋請參考GSM03.40中的， 僅使用1位，右對齊。 Msg_Fmt 1 UnsignedInteger 信息格式： 0：ASCII串； 3：短信寫卡操作； 4：二進(jìn)制信息； 8：UCS2編碼； 15：含GB漢字。 Src_terminal_Id 32 OctetString 源終端MSISDN號碼狀態(tài)報告時填為CMPP_SUBMIT 消息的目的終端號碼。 Src_terminal_type 1 UnsignedInteger

21、 源終端號碼類型，0：真實號碼；1：偽碼。 Registered_Delivery 1 UnsignedInteger 是否為狀態(tài)報告： 0：非狀態(tài)報告； 1：狀態(tài)報告。 Msg_Length 1 UnsignedInteger 消息長度，取值大于或等于0。 Msg_Content Msg_length OctetString 消息內(nèi)容。 LinkID 20 OctetString 點播業(yè)務(wù)使用的LinkID，非點播類業(yè)務(wù)的MT流程不使 用該字段。 6、CMPP3.0協(xié)議包體說明CMPP_DELIVER_RESP 字段名 字節(jié)數(shù) 屬性 描述 Msg_Id 8 UnsignedInteger 信

22、息標(biāo)識CMPP_DELIVER中的Msg_Id字段。 Result 4 UnsignedInteger 結(jié)果： 0：正確； 1：消息結(jié)構(gòu)錯； 2：命令字錯； 3：消息序號重復(fù)； 4：消息長度錯； 5：資費代碼錯； 6：超過最大信息長； 7：業(yè)務(wù)代碼錯； 8:流量控制錯； 9：其他錯誤。 7、CMPP3.0協(xié)議包體說明_網(wǎng)關(guān)返回狀態(tài)報告 字段名 字節(jié)數(shù) 屬性 描述 Msg_Id 8 UnsignedInteger 信息標(biāo)識。 SP提交短信CMPP_SUBMIT操作時，與SP相連 的ISMG產(chǎn)生的Msg_Id。 Stat 7 OctetString 發(fā)送短信的應(yīng)答結(jié)果，含義詳見表一。SP根據(jù)該字段

23、 確定CMPP_SUBMIT消息的處理狀態(tài)。 Submit_time 10 OctetString YYMMDDHHMMYY為年的后兩位00-99，MM： 01-12，DD：01-31，HH：00-23，MM：00-59。 Done_time 10 OctetString YYMMDDHHMM。 Dest_terminal_Id 32 OctetString 目的終端MSISDN號碼(SP發(fā)送CMPP_SUBMIT消息 的目標(biāo)終端)。 SMSC_sequence 4 UnsignedInteger 取自SMSC發(fā)送狀態(tài)報告的消息體中的消息標(biāo)識。 8、CMPP3.0協(xié)議包體說明_返回狀態(tài)報告值

24、MessageState FinalMessageStates Description DELIVERED DELIVRD Messageisdeliveredtodestination EXPIRED EXPIRED Messagevalidityperiodhas expired DELETED DELETED Messagehasbeendeleted. UNDELIVERABLE UNDELIV Messageisundeliverable ofthesubscriberbycustomerservice) UNKNOWN UNKNOWN Messageisininvalidstate

25、 REJECTED REJECTD Messageisinarejectedstate MA:xxxx MA:xxxx SMSC不返回響應(yīng)消息時的狀態(tài)報告 MB:xxxx MB:xxxx SMSC返回錯誤響應(yīng)消息時的狀態(tài)報告 MC:xxxx MC:xxxx 沒有從SMSC處接收到狀態(tài)報告時的狀態(tài)報告 CA:xxxx CA:xxxx SCP不返回響應(yīng)消息時的狀態(tài)報告 CB:xxxx CB:xxxx SCP返回錯誤響應(yīng)消息時的狀態(tài)報告 DA:xxxx DA:xxxx DSMP不返回響應(yīng)消息時的狀態(tài)報告 DB:xxxx DB:xxxx DSMP返回錯誤響應(yīng)消息時的狀態(tài)報告 SA:xxxx SA:xx

26、xx SP不返回響應(yīng)消息時的狀態(tài)報告 SB:xxxx SB:xxxx SP返回錯誤響應(yīng)消息時的狀態(tài)報告 IA:xxxx IA:xxxx 下一級ISMG不返回響應(yīng)消息時的狀態(tài)報告 IB:xxxx IB:xxxx 下一級ISMG返回錯誤響應(yīng)消息時的狀態(tài)報告 IC:xxxx IC:xxxx 沒有從下一級ISMG處接收到狀態(tài)報告時的狀態(tài)報告 9、MISC常見錯誤代碼說明 錯誤代碼 錯誤描述 備注 101 號碼錯誤 MT包中的計費號碼或者接收號碼不是夢網(wǎng)用戶 102 用戶停機 ?琰茞? 103 用戶欠費 ?琰茞? 107 業(yè)務(wù)不存在 MT包中的Service_Id與SP在MISC中申報的業(yè)務(wù)代碼不一致

27、108 業(yè)務(wù)暫停 MT包中所填的業(yè)務(wù)在MISC中已被暫停 115 用戶沒有訂購此業(yè)務(wù) SP向未訂購該業(yè)務(wù)的用戶下發(fā)MT消息 116 用戶暫停此業(yè)務(wù) SP向已暫停該業(yè)務(wù)的用戶下發(fā)MT消息 140 用戶沒有點播該業(yè)務(wù) 點播類業(yè)務(wù)對應(yīng)的MT中，業(yè)務(wù)代碼、LINKID和MO中的不匹配 三、PROVISION接口 正、反向接口開發(fā)說明 正向同步PROVISION接口標(biāo)準(zhǔn) 正向同步PROVISION接口消息定義 正向訂購、取消包例如 反向接口標(biāo)準(zhǔn) 反向訂購接口消息定義 反向取消接口消息定義 反向訂購、取消包例如 1、正向同步PROVISION接口標(biāo)準(zhǔn)流程圖 2、正向同步PROVISION接口標(biāo)準(zhǔn)流程說明

28、用戶通過 發(fā)送定制或取消指令到相應(yīng)的SP特服號，網(wǎng)關(guān)收到MO消息后向MISC發(fā)起MO鑒權(quán)批價請求，MISC收到MO鑒權(quán)批價請求后進(jìn)行訂購、取消點播指令匹配；如果判斷指令是定制或取消指令，那么MISC會向SP發(fā)送訂購關(guān)系同步請求包SyncOrderRelationReq 用戶通過WWW網(wǎng)站發(fā)起訂購或取消請求，MISC在收到WWW網(wǎng)站的請求之后，會向SP發(fā)送訂購關(guān)系同步請求包SyncOrderRelationReq SP收到同步請求包后，對訂購請求做相應(yīng)的訂購關(guān)系處理，并返回訂購關(guān)系同步應(yīng)答SyncOrderRelationResp MISC收到應(yīng)答包后，根據(jù)返回結(jié)果是否正確，在系統(tǒng)中生成正式的訂

29、購關(guān)系或者取消訂購關(guān)系，并由1862系統(tǒng)給用戶下發(fā)訂購成功或取消成功的提醒消息 3、正向同步PROVISION接口消息定義 功能描述 此接口在MISC因為某種情況更新了用戶訂購關(guān)系包括訂購、取消、暫停、激活的時候，通過此接口發(fā)起和SP的更新訂購關(guān)系的交互。 消息名 消息類型 消息方向 SyncOrderRelationReq Request MISCSP SyncOrderRelationResp Response SPMISC 接口內(nèi)容描述 SyncOrderRelationReq消息字段描述： 返回定義 重要性 類型 說明 MsgType 必須 string 消息類型 Transactio

30、nID 必須 string 該消息編號 Version 必須 string 該接口消息的版本號，本次所有的接口消息的版本都 為Send_Address 必須 address_info_schema 發(fā)送方的地址 Dest_Address 必須 address_info_schema 接收方的地址 FeeUser_ID 必須 user_id_schema 計費用戶標(biāo)識 DestUser_ID 必須 user_id_schema 使用用戶標(biāo)識 LinkID 可選 string 臨時訂購關(guān)系的事務(wù)ID ActionID 必須 integer 效勞狀態(tài)管理動作代碼，具體值如下： 1：開通效勞； 2：停

31、止效勞； 3：激活效勞； 4：暫停效勞； ActionReasonID 必須 integer 產(chǎn)生效勞狀態(tài)管理動作原因的代碼，具體值如下： 1：用戶發(fā)起行為 2：Admin&1860發(fā)起行為 3：Boss停機 4：Boss開機 5：Boss過戶 6：Boss銷戶 7：Boss改號 8：扣費失敗導(dǎo)致的效勞取消 9：其他 SPID 可選 string SP的企業(yè)代碼 SPServiceID 必須 string SP中該效勞的效勞代碼 AccessMode 可選 Integer 效勞的訪問方式 1：WEB 2：WAP 3：SMS FeatureStr 可選 binary 效勞訂購參數(shù)base64加密

32、，內(nèi)容是長號碼空格用戶發(fā)送內(nèi)容 address_info_schema(地址信息)描述 字段名稱 字段類型 字段描述 DeviceType integer 設(shè)備類型 0：MISC 100：ISMG 101：WAP SP PROXY 1XX：其他業(yè)務(wù)網(wǎng)關(guān) 200：WAP PORTAL 201：WWW PORTAL 202：VOICE PORTAL 203：PDA PORTAL 2XX：其他門戶 300：MMSC 301：KJAVA SERVER 302：LSP 3XX：其它應(yīng)用平臺 400：SP DeviceID string 設(shè)備編號，設(shè)備編號采用各設(shè)備的入網(wǎng)編號，例如短信網(wǎng)關(guān)使用網(wǎng)關(guān)ID、對

33、SP使用其企業(yè)代碼，該設(shè)備編號由MISC分配，并且在同一設(shè)備類型中該編號唯一 user_id_schema(用戶標(biāo)識)描述 字段名稱 字段類型 字段描述 UserIDType integer 用戶標(biāo)識類型 1：用 號標(biāo)識 2：用偽碼標(biāo)識 3：兩者同時標(biāo)識 MSISDN string 用戶 號 PseudoCode binary 用戶偽碼 4、正向同步接口應(yīng)答包消息定義 SyncOrderRelationResp消息字段描述： 字段名 重要性 類型 說明 MsgType 必須 string 消息類型 TransactionID 必須 string 該消息編號 Version 必須 string

34、該接口消息的版本號，本次所有的接口消息的版本都 為hRet 必須 integer 返回值，主要錯誤如下： 0：成功 4007：MISC同步開通效勞,但SP端已存在訂購關(guān)系,且狀態(tài)為開通 4008：MISC同步開通效勞,且SP端不存在訂購關(guān)系,但開通效勞失敗 4010：MISC同步停止效勞,且SP端存在訂購關(guān)系,但取消效勞失敗 4011：MISC同步停止效勞,但SP端不存在訂購關(guān)系 4012：MISC同步暫停效勞,且SP端存在訂購關(guān)系,但暫停效勞失敗 4013：MISC同步暫停效勞,但SP端不存在訂購關(guān)系 4015：MISC同步激活效勞,但SP端已存在訂購關(guān)系,且狀態(tài)為開通 4016：MISC同

35、步激活效勞,但SP端不存在訂購關(guān)系 其它錯誤請參見?MISC系統(tǒng)短信SP接入指南接口改造分冊?。 5、正向訂購、取消包例如 正向訂購請求包 。 接口協(xié)議 協(xié)議 接口方向 請求：SP中央SSO平臺 響應(yīng)：中央SSO平臺SP 查詢用戶信息接口請求的參數(shù)描述： 字段名稱 字段說明 ICPCode SP的企業(yè)代碼，長度為6位，格式是9XYnnn,XY表示SP接入地的短信網(wǎng)關(guān)編號，nnn表示序列號。 ICPPassword SP的密碼，該字段要求使用統(tǒng)一的DES算法加密，并用SP的密碼作為加密算法的密鑰。 SeqNo SP用于標(biāo)識唯一一次認(rèn)證請求的號碼 RandomSessionKey 用戶的臨時會話標(biāo)

36、識 查詢用戶信息接口響應(yīng)的參數(shù)描述： 響應(yīng)中的BackURL上以BackURL?參數(shù)名稱1=參數(shù)值1&參數(shù)名稱2=參數(shù)值2的形式返回以下輸出參數(shù)： 字段名稱 字段說明 ResultID SSO平臺處理的結(jié)果，為0表示成功，其它表示失敗。失敗時將在ResultString字段將表示錯誤信息。 失敗時不返回PseudoCode和MSISDN字段。 ResultString ResultIDid為0時，內(nèi)容為OK。 失敗時將在本字段表示具體失敗原因。 SeqNo SP用于標(biāo)識唯一一次認(rèn)證請求的號碼。 PseudoCode 用戶偽碼 要求可以配置成：當(dāng)響應(yīng)包中有MSISDN字段時，填或不填該字段。即當(dāng)

37、不填MSISDN時，此字段為必填 項；當(dāng)響應(yīng)包中有MSISDN字段時，那么根據(jù)配置決定響應(yīng)包中是否需要該字段。 MSISDN 用戶 號碼要求能維護(hù)一個icp列表，對列表中有的icp才填該字段，否那么，響應(yīng)包中不包含該字段 AreaID 用戶的歸屬地ID。 定義與用戶登錄接口響應(yīng)信息中定義的AreaID一樣。 OtherInfoNumber 返回包中Other_Info的個數(shù)。 Other_Info是為了今后能夠靈活擴展接口中傳遞的信息而定義的數(shù)據(jù)類型。 本字段說明在該XML包中存在的Otner_Info的數(shù)目。 Other_Info 表示其他信息數(shù)據(jù)。 OtherInfoNumber等于多少，

38、在該XML包中就有多少個Other_Info。 在Other_Info的結(jié)構(gòu)中，包含兩個字段： InfoCode：表示信息代碼 InfoValue：表示具體的信息值 5、用戶訂購業(yè)務(wù)與點播下載業(yè)務(wù)的處理流程 SP接入MISC平臺的實施說明 由于MISC平臺的建設(shè)有一個由點到面，逐步鋪開的過程，因此在實施訂購接口時需要考慮對于沒有接入MISC的效勞如何與已接入MISC的效勞區(qū)別對待的問題。 根據(jù)效勞接入MISC的情況不同，會有以下幾種情況： 1效勞在MISC單點接入的情況 2效勞不在MISC接入的情況 3效勞多點接入時，主接入點和分接入點都接入MISC的情況 4效勞多點接入時，主接入點接入MIS

39、C，而分接入點沒有接入MISC的情況 需要特別說明的是，在實現(xiàn)訂購功能時，SP需要根據(jù)效勞接入地選擇SSO平臺，即訂購請求鏈接需要指向效勞接入地的SSO平臺，對于多點接入業(yè)務(wù)，那么指向效勞主接入地的SSO平臺；如果效勞接入地沒有建設(shè)SSO平臺，那么指向中央SSO平臺。 6、SSO訂購、點播接口定義 業(yè)務(wù)訂購與下載接口 接口名稱 業(yè)務(wù)訂購與下載 接口描述 SSO平臺向SP系統(tǒng)開放的用戶業(yè)務(wù)訂購和下載功能接口，本接口根據(jù)參數(shù)的不同，有兩種不同的用途： 1) 完成業(yè)務(wù)訂購、取消訂購、激活訂購和暫停訂購等操作 2) 完成下載類業(yè)務(wù)的臨時訂購，并返回臨時訂購關(guān)系ID 接口協(xié)議 協(xié)議 接口方向 請求：SP

40、中央SSO平臺 響應(yīng)：中央SSO平臺SP 業(yè)務(wù)訂購與下載接口請求的參數(shù)描述： 字段名稱 字段說明 ICPCode SP的企業(yè)代碼，長度最長為6位，格式是9XYnnn,XY表示SP接入地的短信網(wǎng)關(guān)編號，nnn表示序列號。 ICPServID SP提供的短信業(yè)務(wù)的業(yè)務(wù)代碼，變長小于等于10位的字符串。 如果是批量訂購，那么該字段可能包括多個業(yè)務(wù)代碼，多個業(yè)務(wù)代碼之間用逗號“,分隔。 SeqNo SP用于標(biāo)識唯一一次認(rèn)證請求的號碼。 ItemID 用于標(biāo)識SP的即時下發(fā)類業(yè)務(wù)鈴聲、圖片等唯一性的標(biāo)識，長度及格式由SP自行約定，應(yīng)只包含數(shù)字 和ASCII字符。 本字段只對下載業(yè)務(wù)有效，即只有當(dāng)Acti

41、onID為10時才需要，ActionID為其他值時參數(shù)中不應(yīng)包含本字段 。 例如，如果用戶訂購的是天氣預(yù)報、新聞等包月效勞，那么不需要帶此參數(shù)。 MSISDN 用戶在SP網(wǎng)站上輸入的 號碼此參數(shù)為可選參數(shù) ActionID 標(biāo)識用戶的操作，如訂購、取消訂購、暫停、激活等，長度為2位的整數(shù)，取值區(qū)間： 1：訂購效勞；2：取消效勞； 3：激活效勞；4：暫停效勞； 10：點播下載效勞。 BackURL 處理完成后要求SSO平臺重定向用戶到的目的URL。 DeliverURL SP的效勞下發(fā)請求接口地址。 該參數(shù)為可選參數(shù)，當(dāng)訂購?fù)瓿珊骃P需要向用戶下發(fā)效勞時填寫該參數(shù)ActionID10時。 當(dāng)訂購

42、完成后還需要向用戶下發(fā)效勞時，SSO平臺將向該參數(shù)定義的地址發(fā)起一個 GET請求，以通 知SP向用戶下發(fā)指定的效勞，請求中攜帶的參數(shù)格式參見效勞下發(fā)請求接口。 SSO訂購、點播接口定義 業(yè)務(wù)訂購與下載接口響應(yīng)的參數(shù)描述： 響應(yīng)中的BackURL以BackURL?參數(shù)名稱1=參數(shù)值1&參數(shù)名稱2=參數(shù)值2的形式返回以下輸出參數(shù)： 字段名稱 字段說明 ActionID 標(biāo)識用戶的操作，如訂購、取消訂購、暫停、激活等，長度為2位的整數(shù)，取值區(qū)間：參見上表。 ResultID SSO平臺處理的結(jié)果，0表示成功，其它表示失敗。 失敗時不返回ResultString字段。 如果是批量訂購，那么該字段中包含

43、多個返回碼，多個返回碼之間用逗號“,分隔，分別對應(yīng)批 量訂購中的每個效勞。 例如，如果批量訂購3個業(yè)務(wù)，第1和第2個效勞訂購成功，第3個效勞由于效勞代碼錯誤訂購失敗 ，那么該字段的值為0,0,4110。 ResultString ResultID為0時，內(nèi)容為OK 失敗時將在本字段表示具體失敗原因。 如果是批量訂購且局部成功時，那么該字段為“局部成功 SeqNo SP用于標(biāo)識唯一一次認(rèn)證請求的號碼。 RandomSessionKey 用戶登錄成功后的臨時會話標(biāo)識。 ICPServID SP提供的業(yè)務(wù)代碼，變長小于10位的字符串。 TempAuthNo 由SSO平臺生成的本次訂購操作的臨時訂購關(guān)

44、系ID，只對下載業(yè)務(wù)有效，即只有當(dāng)ActionID為10或 5時才返回該字段，ActionID為其他值時不返回該字段。另外，只有在請求處理成功，即result為0 時才返回該字段。 ItemID 用于標(biāo)識SP的即時下發(fā)類業(yè)務(wù)鈴聲、圖片等唯一性的標(biāo)識，長度及格式由SP自行約定，建議只包含數(shù)字和ASC字符。其值將與請求中的ItemID的值相同。 本字段只對下載業(yè)務(wù)有效，即只有當(dāng)ActionID為10時才返回本字段，ActionID為其他值時不返回本字段。 FeePseudoCode 計費用戶偽碼； 當(dāng)響應(yīng)包中沒有FeeMSISDN時，此字段為必填項；當(dāng)響應(yīng)包中有FeeMSISDN字段時，那么該字段

45、為可選字段。 FeeMSISDN 計費用戶的 號碼； 要求能維護(hù)一個icp列表，對列表中有的icp才填該字段，否那么，響應(yīng)包中不包含該字段 DestPseudoCode 被贈送者的用戶偽碼；當(dāng)用戶輸入了多個被贈送用戶 號碼時，多個偽碼之間用逗號“,分隔。 該字段僅當(dāng)請求中的ActionID為5時有效，ActionID為其他值時不返回本字段； 當(dāng)響應(yīng)包中沒有DestMSISDN時，此字段為必填項；當(dāng)響應(yīng)包中有DestMSISDN字段時，那么該字段為可選字段。 DestMSISDN 被贈送用戶的 號碼；當(dāng)用戶輸入了多個被贈送用戶 號碼時，多個號碼之間用逗號“,分隔。 該字段僅當(dāng)請求中的Action

46、ID為10時有效，ActionID為其他值時不返回本字段； 要求能維護(hù)一個icp列表，對列表中有的icp才填該字段，否那么，響應(yīng)包中不包含該字段 7、效勞下發(fā)請求接口 接口名稱 效勞下發(fā)請求接口 接口描述 SP系統(tǒng)向SSO平臺開放的效勞下發(fā)請求接口用于完成向用戶下發(fā)效勞的功能。 該接口主要用于處理SSO平臺在用戶完成效勞訂購后需要向用戶下發(fā)效勞時的情況。 接口協(xié)議 協(xié)議，使用GET請求 接口方向 請求：SSO平臺SP 響應(yīng)：SPSSO平臺 效勞下發(fā)請求接口的參數(shù)描述： ICPCode SP的企業(yè)代碼，長度最長為6位，格式是9XYnnn,XY表示SP接入地的短信網(wǎng)關(guān)編號，nnn表示序列號。 IC

47、PServID SP提供的短信業(yè)務(wù)的業(yè)務(wù)代碼，變長小于等于10位的字符串。 SeqNo SP用于標(biāo)識唯一一次認(rèn)證請求的號碼，該號碼與SP在效勞訂購請求中的傳入的SeqNo相同； ItemID 用于標(biāo)識SP的即時下發(fā)類業(yè)務(wù)鈴聲、圖片等唯一性的標(biāo)識。 該字段為可選參數(shù)；該字段的值與SP在效勞訂購請求中的傳入的ItemID相同。 FeePseudoCode 計費用戶偽碼； 當(dāng)響應(yīng)包中沒有FeeMSISDN時，此字段為必填項；當(dāng)響應(yīng)包中有FeeMSISDN字段時，那么該字段為可 選字段。 FeeMSISDN 計費用戶的 號碼； 要求能維護(hù)一個icp列表，對列表中有的icp才填該字段，否那么，響應(yīng)包中不

48、包含該字段 DestPseudoCode 接收效勞的用戶的偽碼；當(dāng)需要向多個用戶下發(fā)效勞時，多個偽碼之間用逗號“,分隔。 當(dāng)請求中沒有DestMSISDN時，此字段為必填項；當(dāng)請求中有DestMSISDN字段時，那么該字段為可選字 段。 DestMSISDN 接收效勞的用戶的 號碼；當(dāng)需要向多個用戶下發(fā)效勞時，多個號碼之間用逗號“,分隔。 要求能維護(hù)一個icp列表，對列表中有的icp才填該字段，否那么，響應(yīng)包中不包含該字段 LinkID 臨時訂購關(guān)系的匹配碼，用來鑒權(quán)一次點播請求等事務(wù)性的業(yè)務(wù)。 第二章、業(yè)務(wù)改造分冊 MISC系統(tǒng)結(jié)構(gòu)和作用 SP接入MISC流程 SP升級前后特性比照 業(yè)務(wù)梳理及業(yè)務(wù)代碼改造 點播、訂購指令MO匹配 訂購、取消及包月收取 業(yè)務(wù)組合模式說明 特殊業(yè)務(wù)流程舉例 一、業(yè)務(wù)改造 1、業(yè)務(wù)改造重要性說明 業(yè)務(wù)改造是否合理決定了SP的業(yè)務(wù)能否順利接入MISC，所以請各SP在培訓(xùn)完后盡快派專人進(jìn)行分析和梳理業(yè)務(wù)的工作。業(yè)務(wù)改造分為以下幾個步驟： 1業(yè)務(wù)類型劃分 2業(yè)務(wù)代碼整理 3點播、定制指令設(shè)置 4資費信息設(shè)置 5反向訂購業(yè)務(wù)申請 2、SP升級前后特性比照 工程說明