SP 短信开发基础知识篇(MISC系统短信SP接入培训)

1、SP 短信开发-根底知识篇2(MISC系统短信SP接入培训)导读： MISC系统短信SP接入培训 第一章、接口改造分册.4 一、MISC系统结构和作用.4 1、SP接入MISC流程.4 2、SP接入MISC流程流程说明.5 3、接口改造总体说明.5 4、接口改造需具备条件.6 二、CMPP协议.6 1、CMPP2.0和CMPP3.0区别SP登录.6 2、CMPP2.0和CMPP3.0区别协议包的变化.7 3、CMPP3.0协议包体说明CMPP_SUBMIT.7 4、CMPP3.0协议包体说明CMPP_SUBMIT_RESP.9 5、CMPP3.0协议包体说明CMPP_DELIVER.9 6、C

2、MPP3.0协议包体说明CMPP_DELIVER_RESP.11 7、CMPP3.0协议包体说明_网关返回状态报告.11 8、CMPP3.0协议包体说明_返回状态报告值.12 9、MISC常见错误代码说明.12 三、PROVISION接口.13 1、正向同步PROVISION接口标准流程图.13 2、正向同步PROVISION接口标准流程说明.13 3、正向同步PROVISION接口消息定义.14 4、正向同步接口应答包消息定义.16 5、正向订购、取消包例如.17 6、反向订购接口标准流程图.18 7、反向订购接口标准流程说明.19 8、反向订购接口消息定义.20 9、反向取消接口标准流程图

3、.21 10、反向取消接口标准流程说明.21 11、反向取消接口消息定义.22 12、反向订购、取消包例如.23 四、网站SSO接口.26 1、用户在中央SSO的iframe页面上登录.26 2、用户在SP网站上进行登录的处理流程.27 3、SSO登录接口定义.28 4、查询用户信息接口.29 5、用户订购业务与点播下载业务的处理流程.30 6、SSO订购、点播接口定义.31 7、效劳下发请求接口.33 第二章、业务改造分册.34 一、业务改造.34 1、业务改造重要性说明.34 2、SP升级前后特性比照.34 3、业务类型分类说明.35 4、业务类型分类说明.36 二、MO指令规划建议.37

4、 1、MO指令规划.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 四、业务规划.41 1、订购业务种类规划.41 2、定制、取消点播指令设置.41 3、反向订购业务申请.41 4、统一反向取消接口开放.42 5、包月话单收取.42 五、业务组合模式说明.42 1、关联业务组合.43 2、不同等级业务组合.43 3、套餐式业务组合.43 4、普通业务

5、组合.43 5、特殊业务设计举例.44 6、包月定制类业务需要免费使用N个月.44 7、VIP用户群免费使用业务.44 8、游戏、聊天类业务.45 9、 股票信息点播、定制.45 第三章、SPOA分册.45 一、系统概述.46 1、移动梦网运营管理系统介绍.46 2、SP自效劳系统介绍.46 二、短信合作申请管理.47 1、注册登录账号.47 2、本地新SP合作申请流程图.48 3、SP合作申请资料填写说明.49 4、本地升级为全网SP申请流程.51 5、全网SP本地接入合作申请.51 6、变更合作申请资料.52 二、短信业务管理.53 1、短信本地业务申请流程.54 2、短信业务申请资料填写

6、说明.54 3、短信全网业务申请流程.57 4、申请短信业务变更.57 三、通用信息.58 1、公共信息介绍.58 2、私有信息.58 四、投诉处理.59 1、用户投诉.59 2、SP投诉.60 第一章、接口改造分册 MISC系统结构和作用 SP接入MISC流程 CMPP3.0接口开发说明 正反向订购接口开发说明 网站改造SSO接口流程说明 一、MISC系统结构和作用 1、SP接入MISC流程 组织SP培训 SP程序开发及业务梳理 安排SP在试验环境做接口测试 现网全业务申报 SP进行全业务自行拨测及相关程序调整 SP提交全业务拨测报告供计费验证 安排割接 N N 2、SP接入MISC流程流程

7、说明 1首先需要组织SP参与MISC升级改造培训 2培训结束后SP就应该开始着手进行业务梳理及接口程序开发，并在移动要求的时间内完成这项工作 3SP具备接口测试条件以后，集中统一安排在测试环境做接口测试及典型业务申报 4接口测试通过以后根据现网MISC系统建设情况，安排接口测试通过的SP在现网做全业务申报和全业务拨测 5全业务拨测通过后提交拨测报告供计费做计费验证 6验证通过后根据网络部的割接方案安排割接 3、接口改造总体说明 在整个升级改造过程中“接口改造占了一个非常重要的位置。SP需要根据CMPP3.0协议和DSMP标准对自己的接口进行改造开发，才能接入MISC。 接口改造主要分为以下几个

8、方面： 1CMPP3.0接口程序改造 2正反向订购、取消接口开发 3网站改造SSO接口开发 CMPP3.0接口改造说明 接口开发需具备条件 CMPP2.0和CMPP3.0区别 CMPP3.0协议包体说明 4、接口改造需具备条件 1、自己开发接口的SP，应根据CMPP3.0协议对接口进行修改；使用API的SP，应向接入网关的省公司或网关厂家索取最新的CMPP3.0接口API以及使用说明等相关文档 2、不管是自己开发接口的，还是使用接口API的SP，都应该详细了解CMPP2.0和CMPP3.0的区别 二、CMPP协议 1、CMPP2.0和CMPP3.0区别SP登录 CMPP2.0和CMPP3.0区

9、别SP登录 1、SP向所接入的ISMG发送登录请求； 2、ISMG向MISC发送SP登陆鉴权信息查询请求； 3、MISC向ISMG返回SP登陆鉴权结果； 4、ISMG根据此信息进行SP登陆认证，并向SP返回认证结果； 2、CMPP2.0和CMPP3.0区别协议包的变化 1 包内容的变化：CMPP_SUBMIT CMPP3.0中新增字段： Fee_terminal_type：被计费用户的号码类型，0：真实号码；1：伪码 Dest_terminal_type：接收短信的用户号码类型，0：真实号码；1：伪码 LinkID：20个字节，点播业务使用，非点播类业务的MT流程不使用该字段 CMPP3.0中

10、删除字段： Reserve：保存字段。 CMPP3.0中变化字段： Fee_terminal_id：被计费用户号码。长度扩展为32个字节，数据类型从UnsignedInteger修改为OctetString Dest_terminal_id：接收短信的用户号码。长度扩展为32个字节，数据类型从UnsignedInteger修改为OctetString 2 包内容的变化CMPP_DELIVER CMPP3.0中新增字段： Src_terminal_type：源终端号码类型，0：真实号码；1：伪码 LinkID：20个字节，点播业务使用，非点播类业务的MT流程不使用字段 CMPP3.0中删除字段：

11、 Reserve：保存字段 CMPP3.0中变化字段： Src_terminal_id：源终端号码。长度扩展为32个字节，数据类型从UnsignedInteger修改为OctetString 字段说明： 伪码：一个随机字符串，对于一个SP，唯一标识一个用户 LinkID：20位字符串，该字段的值由MISC产生，编码格式为4位MISCID+12位时间+4位序列号。用于点播类业务中MT与MO消息的匹配。 3、CMPP3.0协议包体说明CMPP_SUBMIT 字段名 字节数 属性 描述 Msg_Id 8 UnsignedInteger 信息标识 Pk_total 1 UnsignedInteger

12、相同Msg_Id的信息总条数，从1开始。 Pk_number 1 UnsignedInteger 相同Msg_Id的信息序号，从1开始。 Registered_Delivery 1 UnsignedInteger 是否要求返回状态确认报告： 0：不需要； 1：需要。 Msg_level 1 UnsignedInteger 信息级别。 Service_Id 10 OctetString 业务标识，是数字、字母和符号的组合。 Fee_UserType 1 UnsignedInteger 计费用户类型字段： 0：对目的终端MSISDN计费； 1：对源终端MSISDN计费； 2：对SP计费； 3：表示

13、本字段无效，对谁计费参见Fee_terminal_Id字段。 Fee_terminal_Id 32 OctetString 被计费用户的号码，当Fee_UserType为3时该值有效，当Fee_UserType为0、1、2时该值无意义。 Fee_terminal_type 1 UnsignedInteger 被计费用户的号码类型，0：真实号码；1：伪码。 TP_pId 1 UnsignedInteger GSM协议类型。详细是解释请参考GSM03.40中的。 TP_udhi 1 UnsignedInteger GSM协议类型。详细是解释请参考GSM03.40中的仅使用1位，右对齐。 Msg_F

14、mt 1 UnsignedInteger 信息格式： 0：ASCII串； 3：短信写卡操作； 4：二进制信息； 8：UCS2编码； 15：含GB汉字。 Msg_src 6 OctetString 信息内容来源(SP_Id)。 FeeType 2 OctetString 资费类别： 01：对“计费用户号码免费； 02：对“计费用户号码按条计信息费； 03：对“计费用户号码按包月收取信息费。 FeeCode 6 OctetString 资费代码以分为单位。 ValId_Time 17 OctetString 存活有效期，格式遵循SMPP3.3协议。 At_Time 17 OctetString 定

15、时发送时间，格式遵循SMPP3.3协议。 Src_Id 21 OctetString 源号码。SP的效劳代码或前缀为效劳代码的长号码,网关将该号 码完整的填到SMPP协议Submit_SM消息相应的source_addr字段， 该号码最终在用户 上显示为短消息的主叫号码。 DestUsr_tl 1 UnsignedInteger 接收信息的用户数量(小于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个字节；其它=140个字节)， 取值大于或等于0。 Msg_Content Msg_length OctetString 信息内容。 LinkID 20 OctetString 点播业务使用的LinkID，非点播类业务的MT流程不使用该字段。 4、CMPP3.0协议包体说明CMPP_SUBMIT_RESP 字段名 字节数 属性 描述 Msg_Id 8 UnsignedInteger 信息标识，生成算法如下： 采用64位8字节的整数： 时间格式为MMDDHHMMSS，即月日时分秒：b

17、it64bit39，其中 bit64bit61：月份的二进制表示； bit60bit56：日的二进制表示； bit55bit51：小时的二进制表示； bit50bit45：分的二进制表示； bit44bit39：秒的二进制表示； 短信网关代码：bit38bit17，把短信网关的代码转换为整数填写到该字段中； 序列号：bit16bit1，顺序增加，步长为1，循环使用。 各局部如不能填满，左补零，右对齐。 SP根据请求和应答消息的Sequence_Id一致性就可得到CMPP_Submit消息的Msg_Id Result 4 UnsignedInteger 结果： 0：正确； 1：消息结构错； 2：

18、命令字错； 3：消息序号重复； 4：消息长度错； 5：资费代码错； 6：超过最大信息长； 7：业务代码错； 8：流量控制错； 9：本网关不负责效劳此计费号码； 10：Src_Id错误； 11：Msg_src错误； 12：Fee_terminal_Id错误； 13：Dest_terminal_Id错误； 5、CMPP3.0协议包体说明CMPP_DELIVER 字段名 字节数 属性 描述 Msg_Id 8 UnsignedInteger 信息标识。 生成算法如下： 采用64位8字节的整数： 时间格式为MMDDHHMMSS，即月日时分秒：bit64bit39，其中 bit64bit61：月份的二进制

19、表示； bit60bit56：日的二进制表示； bit55bit51：小时的二进制表示； bit50bit45：分的二进制表示； bit44bit39：秒的二进制表示； 1.短信网关代码：bit38bit17，把短信网关的代码转换为整数填写到该字段中；序列号：bit16bit1，顺序增加，步长为1，循环使用。 各局部如不能填满，左补零，右对齐。 Dest_Id 21 OctetString 目的号码。 SP的效劳代码，一般4-6位，或者是前缀为效劳代码的 长号码；该号码是 用户短消息的被叫号码。 Service_Id 10 OctetString 业务标识，是数字、字母和符号的组合。 TP_p

20、id 1 UnsignedInteger GSM协议类型。详细解释请参考GSM03.40中的。 TP_udhi 1 UnsignedInteger GSM协议类型。详细解释请参考GSM03.40中的， 仅使用1位，右对齐。 Msg_Fmt 1 UnsignedInteger 信息格式： 0：ASCII串； 3：短信写卡操作； 4：二进制信息； 8：UCS2编码； 15：含GB汉字。 Src_terminal_Id 32 OctetString 源终端MSISDN号码状态报告时填为CMPP_SUBMIT 消息的目的终端号码。 Src_terminal_type 1 UnsignedInteger

21、 源终端号码类型，0：真实号码；1：伪码。 Registered_Delivery 1 UnsignedInteger 是否为状态报告： 0：非状态报告； 1：状态报告。 Msg_Length 1 UnsignedInteger 消息长度，取值大于或等于0。 Msg_Content Msg_length OctetString 消息内容。 LinkID 20 OctetString 点播业务使用的LinkID，非点播类业务的MT流程不使 用该字段。 6、CMPP3.0协议包体说明CMPP_DELIVER_RESP 字段名 字节数 属性 描述 Msg_Id 8 UnsignedInteger 信

22、息标识CMPP_DELIVER中的Msg_Id字段。 Result 4 UnsignedInteger 结果： 0：正确； 1：消息结构错； 2：命令字错； 3：消息序号重复； 4：消息长度错； 5：资费代码错； 6：超过最大信息长； 7：业务代码错； 8:流量控制错； 9：其他错误。 7、CMPP3.0协议包体说明_网关返回状态报告 字段名 字节数 属性 描述 Msg_Id 8 UnsignedInteger 信息标识。 SP提交短信CMPP_SUBMIT操作时，与SP相连 的ISMG产生的Msg_Id。 Stat 7 OctetString 发送短信的应答结果，含义详见表一。SP根据该字段

23、 确定CMPP_SUBMIT消息的处理状态。 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发送CMPP_SUBMIT消息 的目标终端)。 SMSC_sequence 4 UnsignedInteger 取自SMSC发送状态报告的消息体中的消息标识。 8、CMPP3.0协议包体说明_返回状态报告值

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不返回响应消息时的状态报告 MB:xxxx MB:xxxx SMSC返回错误响应消息时的状态报告 MC:xxxx MC:xxxx 没有从SMSC处接收到状态报告时的状态报告 CA:xxxx CA:xxxx SCP不返回响应消息时的状态报告 CB:xxxx CB:xxxx SCP返回错误响应消息时的状态报告 DA:xxxx DA:xxxx DSMP不返回响应消息时的状态报告 DB:xxxx DB:xxxx DSMP返回错误响应消息时的状态报告 SA:xxxx SA:xx

26、xx SP不返回响应消息时的状态报告 SB:xxxx SB:xxxx SP返回错误响应消息时的状态报告 IA:xxxx IA:xxxx 下一级ISMG不返回响应消息时的状态报告 IB:xxxx IB:xxxx 下一级ISMG返回错误响应消息时的状态报告 IC:xxxx IC:xxxx 没有从下一级ISMG处接收到状态报告时的状态报告 9、MISC常见错误代码说明 错误代码 错误描述 备注 101 号码错误 MT包中的计费号码或者接收号码不是梦网用户 102 用户停机 ?琰茞? 103 用户欠费 ?琰茞? 107 业务不存在 MT包中的Service_Id与SP在MISC中申报的业务代码不一致

27、108 业务暂停 MT包中所填的业务在MISC中已被暂停 115 用户没有订购此业务 SP向未订购该业务的用户下发MT消息 116 用户暂停此业务 SP向已暂停该业务的用户下发MT消息 140 用户没有点播该业务 点播类业务对应的MT中，业务代码、LINKID和MO中的不匹配 三、PROVISION接口 正、反向接口开发说明 正向同步PROVISION接口标准 正向同步PROVISION接口消息定义 正向订购、取消包例如 反向接口标准 反向订购接口消息定义 反向取消接口消息定义 反向订购、取消包例如 1、正向同步PROVISION接口标准流程图 2、正向同步PROVISION接口标准流程说明

28、用户通过 发送定制或取消指令到相应的SP特服号，网关收到MO消息后向MISC发起MO鉴权批价请求，MISC收到MO鉴权批价请求后进行订购、取消点播指令匹配；如果判断指令是定制或取消指令，那么MISC会向SP发送订购关系同步请求包SyncOrderRelationReq 用户通过WWW网站发起订购或取消请求，MISC在收到WWW网站的请求之后，会向SP发送订购关系同步请求包SyncOrderRelationReq SP收到同步请求包后，对订购请求做相应的订购关系处理，并返回订购关系同步应答SyncOrderRelationResp MISC收到应答包后，根据返回结果是否正确，在系统中生成正式的订

29、购关系或者取消订购关系，并由1862系统给用户下发订购成功或取消成功的提醒消息 3、正向同步PROVISION接口消息定义 功能描述 此接口在MISC因为某种情况更新了用户订购关系包括订购、取消、暂停、激活的时候，通过此接口发起和SP的更新订购关系的交互。 消息名 消息类型 消息方向 SyncOrderRelationReq Request MISCSP SyncOrderRelationResp Response SPMISC 接口内容描述 SyncOrderRelationReq消息字段描述： 返回定义 重要性 类型 说明 MsgType 必须 string 消息类型 Transactio

30、nID 必须 string 该消息编号 Version 必须 string 该接口消息的版本号，本次所有的接口消息的版本都 为Send_Address 必须 address_info_schema 发送方的地址 Dest_Address 必须 address_info_schema 接收方的地址 FeeUser_ID 必须 user_id_schema 计费用户标识 DestUser_ID 必须 user_id_schema 使用用户标识 LinkID 可选 string 临时订购关系的事务ID ActionID 必须 integer 效劳状态管理动作代码，具体值如下： 1：开通效劳； 2：停

31、止效劳； 3：激活效劳； 4：暂停效劳； ActionReasonID 必须 integer 产生效劳状态管理动作原因的代码，具体值如下： 1：用户发起行为 2：Admin&1860发起行为 3：Boss停机 4：Boss开机 5：Boss过户 6：Boss销户 7：Boss改号 8：扣费失败导致的效劳取消 9：其他 SPID 可选 string SP的企业代码 SPServiceID 必须 string SP中该效劳的效劳代码 AccessMode 可选 Integer 效劳的访问方式 1：WEB 2：WAP 3：SMS FeatureStr 可选 binary 效劳订购参数base64加密

32、，内容是长号码空格用户发送内容 address_info_schema(地址信息)描述 字段名称 字段类型 字段描述 DeviceType integer 设备类型 0：MISC 100：ISMG 101：WAP SP PROXY 1XX：其他业务网关 200：WAP PORTAL 201：WWW PORTAL 202：VOICE PORTAL 203：PDA PORTAL 2XX：其他门户 300：MMSC 301：KJAVA SERVER 302：LSP 3XX：其它应用平台 400：SP DeviceID string 设备编号，设备编号采用各设备的入网编号，例如短信网关使用网关ID、对

33、SP使用其企业代码，该设备编号由MISC分配，并且在同一设备类型中该编号唯一 user_id_schema(用户标识)描述 字段名称 字段类型 字段描述 UserIDType integer 用户标识类型 1：用 号标识 2：用伪码标识 3：两者同时标识 MSISDN string 用户 号 PseudoCode binary 用户伪码 4、正向同步接口应答包消息定义 SyncOrderRelationResp消息字段描述： 字段名 重要性 类型 说明 MsgType 必须 string 消息类型 TransactionID 必须 string 该消息编号 Version 必须 string

34、该接口消息的版本号，本次所有的接口消息的版本都 为hRet 必须 integer 返回值，主要错误如下： 0：成功 4007：MISC同步开通效劳,但SP端已存在订购关系,且状态为开通 4008：MISC同步开通效劳,且SP端不存在订购关系,但开通效劳失败 4010：MISC同步停止效劳,且SP端存在订购关系,但取消效劳失败 4011：MISC同步停止效劳,但SP端不存在订购关系 4012：MISC同步暂停效劳,且SP端存在订购关系,但暂停效劳失败 4013：MISC同步暂停效劳,但SP端不存在订购关系 4015：MISC同步激活效劳,但SP端已存在订购关系,且状态为开通 4016：MISC同

35、步激活效劳,但SP端不存在订购关系 其它错误请参见?MISC系统短信SP接入指南接口改造分册?。 5、正向订购、取消包例如 正向订购请求包 。 接口协议 协议 接口方向 请求：SP中央SSO平台 响应：中央SSO平台SP 查询用户信息接口请求的参数描述： 字段名称 字段说明 ICPCode SP的企业代码，长度为6位，格式是9XYnnn,XY表示SP接入地的短信网关编号，nnn表示序列号。 ICPPassword SP的密码，该字段要求使用统一的DES算法加密，并用SP的密码作为加密算法的密钥。 SeqNo SP用于标识唯一一次认证请求的号码 RandomSessionKey 用户的临时会话标

36、识 查询用户信息接口响应的参数描述： 响应中的BackURL上以BackURL?参数名称1=参数值1&参数名称2=参数值2的形式返回以下输出参数： 字段名称 字段说明 ResultID SSO平台处理的结果，为0表示成功，其它表示失败。失败时将在ResultString字段将表示错误信息。 失败时不返回PseudoCode和MSISDN字段。 ResultString ResultIDid为0时，内容为OK。 失败时将在本字段表示具体失败原因。 SeqNo SP用于标识唯一一次认证请求的号码。 PseudoCode 用户伪码 要求可以配置成：当响应包中有MSISDN字段时，填或不填该字段。即当

37、不填MSISDN时，此字段为必填 项；当响应包中有MSISDN字段时，那么根据配置决定响应包中是否需要该字段。 MSISDN 用户 号码要求能维护一个icp列表，对列表中有的icp才填该字段，否那么，响应包中不包含该字段 AreaID 用户的归属地ID。 定义与用户登录接口响应信息中定义的AreaID一样。 OtherInfoNumber 返回包中Other_Info的个数。 Other_Info是为了今后能够灵活扩展接口中传递的信息而定义的数据类型。 本字段说明在该XML包中存在的Otner_Info的数目。 Other_Info 表示其他信息数据。 OtherInfoNumber等于多少，

38、在该XML包中就有多少个Other_Info。 在Other_Info的结构中，包含两个字段： InfoCode：表示信息代码 InfoValue：表示具体的信息值 5、用户订购业务与点播下载业务的处理流程 SP接入MISC平台的实施说明 由于MISC平台的建设有一个由点到面，逐步铺开的过程，因此在实施订购接口时需要考虑对于没有接入MISC的效劳如何与已接入MISC的效劳区别对待的问题。 根据效劳接入MISC的情况不同，会有以下几种情况： 1效劳在MISC单点接入的情况 2效劳不在MISC接入的情况 3效劳多点接入时，主接入点和分接入点都接入MISC的情况 4效劳多点接入时，主接入点接入MIS

39、C，而分接入点没有接入MISC的情况 需要特别说明的是，在实现订购功能时，SP需要根据效劳接入地选择SSO平台，即订购请求链接需要指向效劳接入地的SSO平台，对于多点接入业务，那么指向效劳主接入地的SSO平台；如果效劳接入地没有建设SSO平台，那么指向中央SSO平台。 6、SSO订购、点播接口定义 业务订购与下载接口 接口名称 业务订购与下载 接口描述 SSO平台向SP系统开放的用户业务订购和下载功能接口，本接口根据参数的不同，有两种不同的用途： 1) 完成业务订购、取消订购、激活订购和暂停订购等操作 2) 完成下载类业务的临时订购，并返回临时订购关系ID 接口协议 协议 接口方向 请求：SP

40、中央SSO平台 响应：中央SSO平台SP 业务订购与下载接口请求的参数描述： 字段名称 字段说明 ICPCode SP的企业代码，长度最长为6位，格式是9XYnnn,XY表示SP接入地的短信网关编号，nnn表示序列号。 ICPServID SP提供的短信业务的业务代码，变长小于等于10位的字符串。 如果是批量订购，那么该字段可能包括多个业务代码，多个业务代码之间用逗号“,分隔。 SeqNo SP用于标识唯一一次认证请求的号码。 ItemID 用于标识SP的即时下发类业务铃声、图片等唯一性的标识，长度及格式由SP自行约定，应只包含数字 和ASCII字符。 本字段只对下载业务有效，即只有当Acti

41、onID为10时才需要，ActionID为其他值时参数中不应包含本字段 。 例如，如果用户订购的是天气预报、新闻等包月效劳，那么不需要带此参数。 MSISDN 用户在SP网站上输入的 号码此参数为可选参数 ActionID 标识用户的操作，如订购、取消订购、暂停、激活等，长度为2位的整数，取值区间： 1：订购效劳；2：取消效劳； 3：激活效劳；4：暂停效劳； 10：点播下载效劳。 BackURL 处理完成后要求SSO平台重定向用户到的目的URL。 DeliverURL SP的效劳下发请求接口地址。 该参数为可选参数，当订购完成后SP需要向用户下发效劳时填写该参数ActionID10时。 当订购

42、完成后还需要向用户下发效劳时，SSO平台将向该参数定义的地址发起一个 GET请求，以通 知SP向用户下发指定的效劳，请求中携带的参数格式参见效劳下发请求接口。 SSO订购、点播接口定义 业务订购与下载接口响应的参数描述： 响应中的BackURL以BackURL?参数名称1=参数值1&参数名称2=参数值2的形式返回以下输出参数： 字段名称 字段说明 ActionID 标识用户的操作，如订购、取消订购、暂停、激活等，长度为2位的整数，取值区间：参见上表。 ResultID SSO平台处理的结果，0表示成功，其它表示失败。 失败时不返回ResultString字段。 如果是批量订购，那么该字段中包含

43、多个返回码，多个返回码之间用逗号“,分隔，分别对应批 量订购中的每个效劳。 例如，如果批量订购3个业务，第1和第2个效劳订购成功，第3个效劳由于效劳代码错误订购失败 ，那么该字段的值为0,0,4110。 ResultString ResultID为0时，内容为OK 失败时将在本字段表示具体失败原因。 如果是批量订购且局部成功时，那么该字段为“局部成功 SeqNo SP用于标识唯一一次认证请求的号码。 RandomSessionKey 用户登录成功后的临时会话标识。 ICPServID SP提供的业务代码，变长小于10位的字符串。 TempAuthNo 由SSO平台生成的本次订购操作的临时订购关

44、系ID，只对下载业务有效，即只有当ActionID为10或 5时才返回该字段，ActionID为其他值时不返回该字段。另外，只有在请求处理成功，即result为0 时才返回该字段。 ItemID 用于标识SP的即时下发类业务铃声、图片等唯一性的标识，长度及格式由SP自行约定，建议只包含数字和ASC字符。其值将与请求中的ItemID的值相同。 本字段只对下载业务有效，即只有当ActionID为10时才返回本字段，ActionID为其他值时不返回本字段。 FeePseudoCode 计费用户伪码； 当响应包中没有FeeMSISDN时，此字段为必填项；当响应包中有FeeMSISDN字段时，那么该字段

45、为可选字段。 FeeMSISDN 计费用户的 号码； 要求能维护一个icp列表，对列表中有的icp才填该字段，否那么，响应包中不包含该字段 DestPseudoCode 被赠送者的用户伪码；当用户输入了多个被赠送用户 号码时，多个伪码之间用逗号“,分隔。 该字段仅当请求中的ActionID为5时有效，ActionID为其他值时不返回本字段； 当响应包中没有DestMSISDN时，此字段为必填项；当响应包中有DestMSISDN字段时，那么该字段为可选字段。 DestMSISDN 被赠送用户的 号码；当用户输入了多个被赠送用户 号码时，多个号码之间用逗号“,分隔。 该字段仅当请求中的Action

46、ID为10时有效，ActionID为其他值时不返回本字段； 要求能维护一个icp列表，对列表中有的icp才填该字段，否那么，响应包中不包含该字段 7、效劳下发请求接口 接口名称 效劳下发请求接口 接口描述 SP系统向SSO平台开放的效劳下发请求接口用于完成向用户下发效劳的功能。 该接口主要用于处理SSO平台在用户完成效劳订购后需要向用户下发效劳时的情况。 接口协议 协议，使用GET请求 接口方向 请求：SSO平台SP 响应：SPSSO平台 效劳下发请求接口的参数描述： ICPCode SP的企业代码，长度最长为6位，格式是9XYnnn,XY表示SP接入地的短信网关编号，nnn表示序列号。 IC

47、PServID SP提供的短信业务的业务代码，变长小于等于10位的字符串。 SeqNo SP用于标识唯一一次认证请求的号码，该号码与SP在效劳订购请求中的传入的SeqNo相同； ItemID 用于标识SP的即时下发类业务铃声、图片等唯一性的标识。 该字段为可选参数；该字段的值与SP在效劳订购请求中的传入的ItemID相同。 FeePseudoCode 计费用户伪码； 当响应包中没有FeeMSISDN时，此字段为必填项；当响应包中有FeeMSISDN字段时，那么该字段为可 选字段。 FeeMSISDN 计费用户的 号码； 要求能维护一个icp列表，对列表中有的icp才填该字段，否那么，响应包中不

48、包含该字段 DestPseudoCode 接收效劳的用户的伪码；当需要向多个用户下发效劳时，多个伪码之间用逗号“,分隔。 当请求中没有DestMSISDN时，此字段为必填项；当请求中有DestMSISDN字段时，那么该字段为可选字 段。 DestMSISDN 接收效劳的用户的 号码；当需要向多个用户下发效劳时，多个号码之间用逗号“,分隔。 要求能维护一个icp列表，对列表中有的icp才填该字段，否那么，响应包中不包含该字段 LinkID 临时订购关系的匹配码，用来鉴权一次点播请求等事务性的业务。 第二章、业务改造分册 MISC系统结构和作用 SP接入MISC流程 SP升级前后特性比照 业务梳理及业务代码改造 点播、订购指令MO匹配 订购、取消及包月收取 业务组合模式说明 特殊业务流程举例 一、业务改造 1、业务改造重要性说明 业务改造是否合理决定了SP的业务能否顺利接入MISC，所以请各SP在培训完后尽快派专人进行分析和梳理业务的工作。业务改造分为以下几个步骤： 1业务类型划分 2业务代码整理 3点播、定制指令设置 4资费信息设置 5反向订购业务申请 2、SP升级前后特性比照 工程说明