【文章內容簡介】 16：MISC同步激活服務,但SP端不存在訂購關系 　　其它錯誤請參見《MISC系統(tǒng)短信SP接入指南－接口改造分冊》。 　　 　　正向訂購、取消包示例 　　 　　正向訂購請求包 　　 　　　　xmlns:SOAPENV= 　　xmlns:SOAPENC= 　　 　　xmlns:SOAPENC=　　xmlns:xsd= 　　xmlns:SOAPENV= 　　xmlns:SOAPENC= 　　 　　 　　 　　 　　 　　 　　 　　 　　 　　 　　 　　 　　。 　　接口協(xié)議 HTTP協(xié)議 　　接口方向 請求：SP中央SSO平臺 　　響應：中央SSO平臺SP 　　 　　查詢用戶信息接口請求的參數(shù)描述： 　　字段名稱 字段說明 　　ICPCode SP的企業(yè)代碼，長度為6位，格式是9XYnnn,XY表示SP接入地的短信網關編號，nnn表示序列號。 　　ICPPassword SP的密碼，該字段要求使用統(tǒng)一的DES算法加密，并用SP的密碼作為加密算法的密鑰。 　　SeqNo SP用于標識唯一一次認證請求的號碼 　　RandomSessionKey 用戶的臨時會話標識 　　 　　查詢用戶信息接口響應的參數(shù)描述： 　　響應中的BackURL上以[BackURL]?[參數(shù)名稱1]=[參數(shù)值1]amp。[參數(shù)名稱2]=[參數(shù)值2]的形式返回以下輸出參數(shù)： 　　字段名稱 字段說明 　　ResultID SSO平臺處理的結果，為0表示成功，其它表示失敗。失敗時將在ResultString字段將表示錯誤信息。 　　失敗時不返回PseudoCode和MSISDN字段。 　　ResultString ResultIDid為0時，內容為”O(jiān)K”。 　　失敗時將在本字段表示具體失敗原因。 　　SeqNo SP用于標識唯一一次認證請求的號碼。 　　PseudoCode 用戶偽碼 　　要求可以配置成：當響應包中有MSISDN字段時，填或不填該字段。即當不填MSISDN時，此字段為必填 　　項；當響應包中有MSISDN字段時，則根據(jù)配置決定響應包中是否需要該字段。 　　MSISDN 用戶手機號碼（要求能維護一個icp列表，對列表中有的icp才填該字段，否則，響應包中不包含該字段） 　　AreaID 用戶的歸屬地ID。 　　定義與用戶登錄接口響應信息中定義的AreaID一樣。 　　OtherInfoNumber 返回包中Other_Info的個數(shù)。 　　Other_Info是為了今后能夠靈活擴展接口中傳遞的信息而定義的數(shù)據(jù)類型。 　　本字段表明在該XML包中存在的Otner_Info的數(shù)目。 　　Other_Info[] 表示其他信息數(shù)據(jù)。 　　OtherInfoNumber等于多少，在該XML包中就有多少個Other_Info。 　　在Other_Info的結構中，包含兩個字段： 　　InfoCode：表示信息代碼 　　InfoValue：表示具體的信息值 　　 　　用戶訂購業(yè)務與點播下載業(yè)務的處理流程 　　? SP接入MISC平臺的實施說明 　　由于MISC平臺的建設有一個由點到面，逐步鋪開的過程，因此在實施訂購接口時需要考慮對于沒有接入MISC的服務如何與已接入MISC的服務區(qū)別對待的問題。 　　根據(jù)服務接入MISC的情況不同，會有以下幾種情況： 　　1）服務在MISC單點接入的情況 　　2）服務不在MISC接入的情況 　　3）服務多點接入時，主接入點和分接入點都接入MISC的情況 　　4）服務多點接入時，主接入點接入MISC，而分接入點沒有接入MISC的情況 　　 　　? 需要特別說明的是，在實現(xiàn)訂購功能時，SP需要根據(jù)服務接入地選擇SSO平臺，即訂購請求鏈接需要指向服務接入地的SSO平臺，對于多點接入業(yè)務，則指向服務主接入地的SSO平臺；如果服務接入地沒有建設SSO平臺，則指向中央SSO平臺。 　　 　　SSO訂購、點播接口定義 　　業(yè)務訂購與下載接口 　　接口名稱 業(yè)務訂購與下載 　　接口描述 SSO平臺向SP系統(tǒng)開放的用戶業(yè)務訂購和下載功能接口，本接口根據(jù)參數(shù)的不同，有兩種不同的用途： 　　1) 完成業(yè)務訂購、取消訂購、激活訂購和暫停訂購等操作 　　2) 完成下載類業(yè)務的臨時訂購，并返回臨時訂購關系ID 　　接口協(xié)議 HTTP協(xié)議 　　接口方向 請求：SP中央SSO平臺 　　響應：中央SSO平臺SP 　　 　　業(yè)務訂購與下載接口請求的參數(shù)描述： 　　字段名稱 字段說明 　　ICPCode SP的企業(yè)代碼，長度最長為6位，格式是9XYnnn,XY表示SP接入地的短信網關編號，nnn表示序列號。 　　ICPServID SP提供的短信業(yè)務的業(yè)務代碼，變長（小于等于10位）的字符串。 　　如果是批量訂購，則該字段可能包括多個業(yè)務代碼，多個業(yè)務代碼之間用逗號（“,”）分隔。 　　SeqNo SP用于標識唯一一次認證請求的號碼。 　　ItemID 用于標識SP的即時下發(fā)類業(yè)務（鈴聲、圖片等）唯一性的標識，長度及格式由SP自行約定，應只包含數(shù)字 　　和ASCII字符。 　　本字段只對下載業(yè)務有效，即只有當ActionID為10時才需要，ActionID為其他值時參數(shù)中不應包含本字段 　　。 　　例如，如果用戶訂購的是天氣預報、新聞等包月服務，則不需要帶此參數(shù)。 　　MSISDN 用戶在SP網站上輸入的手機號碼（此參數(shù)為可選參數(shù)） 　　ActionID 標識用戶的操作，如訂購、取消訂購、暫停、激活等，長度為2位的整數(shù)，取值區(qū)間： 　　1：訂購服務；2：取消服務； 　　3：激活服務；4：暫停服務； 　　10：點播下載服務。 　　BackURL 處理完成后要求SSO平臺重定向用戶到的目的URL。 　　DeliverURL SP的服務下發(fā)請求接口地址。 　　該參數(shù)為可選參數(shù)，當訂購完成后SP需要向用戶下發(fā)服務時填寫該參數(shù)（ActionID＝10時）。 　　當訂購完成后還需要向用戶下發(fā)服務時，SSO平臺將向該參數(shù)定義的地址發(fā)起一個HTTPGET請求，以通 　　知SP向用戶下發(fā)指定的服務，請求中攜帶的參數(shù)格式參見服務下發(fā)請求接口。 　　 　　 　　? SSO訂購、點播接口定義 　　? 業(yè)務訂購與下載接口響應的參數(shù)描述： 　　響應中的BackURL以[BackURL]?[參數(shù)名稱1]=[參數(shù)值1]amp。[參數(shù)名稱2]=[參數(shù)值2]的形式返回以下輸出參數(shù)： 　　字段名稱 字段說明 　　ActionID 標識用戶的操作，如訂購、取消訂購、暫停、激活等，長度為2位的整數(shù)，取值區(qū)間：參見上表。 　　ResultID SSO平臺處理的結果，0表示成功，其它表示失敗。 　　失敗時不返回ResultString字段。 　　如果是批量訂購，則該字段中包含多個返回碼，多個返回碼之間用逗號（“,”）分隔，分別對應批 　　量訂購中的每個服務。 　　例如，如果批量訂購3個業(yè)務，第1和第2個服務訂購成功，第3個服務由于服務代碼錯誤訂購失敗 　　，則該字段的值為0,0,4110。 　　ResultString ResultID為0時，內容為”O(jiān)K” 　　失敗時將在本字段表示具體失敗原因。 　　如果是批量訂購且部分成功時，則該字段為“部分成功” 　　SeqNo SP用于標識唯一一次認證請求的號碼。 　　RandomSessionKey 用戶登錄成功后的臨時會話標識。 　　ICPServID SP提供的業(yè)務代碼，變長（小于10位）的字符串。 　　TempAuthNo 由SSO平臺生成的本次訂購操作的臨時訂購關系ID，只對下載業(yè)務有效，即只有當ActionID為10或 　　5時才返回該字段，ActionID為其他值時不返回該字段。另外，只有在請求處理成功，即result為0 　　時才返回該字段。 　　ItemID 用于標識SP的即時下發(fā)類業(yè)務（鈴聲、圖片等）唯一性的標識，長度及格式由SP自行約定，建議只包含數(shù)字和ASC字符。其值將與請求中的ItemID的值相同。 　　本字段只對下載業(yè)務有效，即只有當ActionID為10時才返回本字段，ActionID為其他值時不返回本字段。 　　FeePseudoCode 計費用戶偽碼； 　　當響應包中沒有FeeMSISDN時，此字段為必填項；當響應包中有FeeMSISDN字段時，則該字段為可選字段。 　　FeeMSISDN 計費用戶的手機號碼； 　　要求能維護一個icp列表，對列表中有的icp才填該字段，否則，響應包中不包含該字段 　　DestPseudoCode 被贈送者的用戶偽碼；當用戶輸入了多個被贈送用戶手機號碼時，多個偽碼之間用逗號（“,”）分隔。 　　該字段僅當請求中的ActionID為5時有效，ActionID為其他值時不返回本字段； 　　當響應包中沒有DestMSISDN時，此字段為必填項；當響應包中有DestMSISDN字段時，則該字段為可選字段。 　　DestMSISDN 被贈送用戶的手機號碼；當用戶輸入了多個被贈送用戶手機號碼時，多個號碼之間用逗號（“,”）分隔。 　　該字段僅當請求中的ActionID為10時有效，ActionID為其他值時不返回本字段； 　　要求能維護一個icp列表，對列表中有的icp才填該字段，否則，響應包中不包含該字段 　　 　　服務下發(fā)請求接口 　　 　　接口名稱 服務下發(fā)請求接口 　　接口描述 SP系統(tǒng)向SSO平臺開放的服務下發(fā)請求接口用于完成向用戶下發(fā)服務的功能。 　　該接口主要用于處理SSO平臺在用戶完成服務訂購后需要向用戶下發(fā)服務時的情況。 　　接口協(xié)議 HTTP協(xié)議，使用GET請求 　　接口方向 請求：SSO平臺SP 　　響應：SPSSO平臺 　　 　　服務下發(fā)請求接口的參數(shù)描述： 　　ICPCode SP的企業(yè)代碼，長度最長為6位，格式是9XYnnn,XY表示SP接入地的短信網關編號，nnn表示序列號。 　　ICPServID SP提供的短信業(yè)務的業(yè)務代碼，變長（小于等于10位）的字符串。 　　SeqNo SP用于標識唯一一次認證請求的號碼，該號碼與SP在服務訂購請求中的傳入的SeqNo相同； 　　ItemID 用于標識SP的即時下發(fā)類業(yè)務（鈴聲、圖片等）唯一性的標識。 　　該字段為可選參數(shù)；該字段的值與SP在服務訂購請求中的傳入的ItemID相同。 　　FeePseudoCode 計費用戶偽碼； 　　當響應包中沒有FeeMSISDN時，此字段為必填項；當響應包中有FeeMSISDN字段時，則該字段為可 　　選字段。 　　FeeMSISDN 計費用戶的手機號碼； 　　要求能維護一個icp列表，對列表中有的icp才填該字段，否則，響應包中不包含該字段 　　DestPseudoCode 接收服務的用戶的偽碼；當需要向多個用戶下發(fā)服務時，多個偽碼之間用逗號（“,”）分隔。 　　當請求中沒有DestMSISDN時，此字段為必填項；當請求中有DestMSISDN字段時，則該字段為可選字 　　段。 　　DestMSISDN 接收服務的用戶的手機號碼；當需要向多個用戶下發(fā)服務時，多個號碼之間用逗號（“,”）分隔。 　　要求能維護一個icp列表，對列表中有的icp才填該字段，否則，響應包中不包含該字段 　　LinkID 臨時訂購關系的匹配碼，用來鑒權一次點播請求等事務性的業(yè)務。 　　 　　第二章、業(yè)務改造分冊 　　MISC系統(tǒng)結構和作用 　　SP接入MISC流程 　　SP升級前后特性對比 　　業(yè)務梳理及業(yè)務代碼改造 　　點播、訂購指令MO匹配 　　訂購、取消及包月收取 　　業(yè)務組合模式說明 　　特殊業(yè)務流程舉例 　　 　　一、業(yè)務改造 　　業(yè)務改造重要性說明 　　? 業(yè)務改造是否合理決定了SP的業(yè)務能否順利接入MISC，所以請各SP在培訓完后盡快派專人進行分析和梳理業(yè)務的工作。業(yè)務改造分為以下幾個步驟： 　　1）業(yè)務類型劃分 　　2）業(yè)務代碼整理 　　3）點播、定制指令設置 　　4）資費信息設置 　　5）反向訂購業(yè)務申請 　　 　　SP升級前后特性對比 　　項目說明 升級前狀態(tài) 升級后狀態(tài) 　　? 訂購關系保存 　　所有訂購關系由SP自行掌握 訂購關系同時保存在MISC系統(tǒng)和SP系統(tǒng)中，但是以MISC系統(tǒng)中的訂購關系為準 　　? 訂購、取消通知下發(fā) 　　SP自行組包生成訂購、取消通知消息下發(fā)給用戶 MISC平臺根據(jù)SP申報的短信提醒下發(fā)給用戶 　　? 0000、00000統(tǒng)一取消指令 　　SP收到0000時組包產生取消菜單下發(fā)給用戶，收到00000自行取消用戶訂購關系 MISC平臺攔截0000指令并自行組包產生菜單下發(fā)，攔截00000指令自動取消用戶訂購的所有業(yè)務 　　? 包月話單發(fā)起扣費 　　由SP自行發(fā)起SMC包月扣費請求 由MISC根據(jù)有效用戶訂購關系代SP發(fā)起SMC包月扣費請求 　　? 訂購、點播鑒權 　　不進行訂購、點播鑒權，所有消息全部由網關透傳給SP 所有的MO/MT消息都需要通過MISC的鑒權，實現(xiàn)有效攔截 　　? 訂購關系同步 　　訂購關系都保存在SP方，不存在訂購關系同步 訂購關系保存在MISC系統(tǒng)，所有的訂購請求都由MISC通過Provision接口與SP同步 　　? 網站訂購、點播處理 　　SP的網站點播和定制都由SP自身來控制，網關負責消息轉發(fā) SP的所有網站點播和定制業(yè)務都需要通過調用SSO接口來實現(xiàn) 　　 　　 　　 　　業(yè)務梳理及改造過程 　　項目說明 升級前狀態(tài) 升級后狀態(tài) 　　? 業(yè)