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

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、CMPP3.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、反向取消接口规范流程图.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 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、普通业务组合.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、短信业务申请资料填写说明.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流程流程说明 1）首先需要组织SP参与MISC升级改造培训 2）培训结束后SP就应该开始着手进行业务梳理及接口程序开发，并在移动要求的时间内完成这项工作 3）SP具备接口测试条件以后，集中统一安排在测试环境做接口测试及典型业务申报 4）接口测试通过以后根据现网MISC系统建设情况，安排接口测试通过的SP在现网做全业务申报和全业务拨测 5）全业务拨测通过后提交拨测报告供计费做计费验证 6）验证通过后根据网络部的割接计划安排割接 3、接口改造总体说明 在整个升级改造过程中“接口改造”占了一个非常重要的位置。SP需要根据CMPP3.0协议和DSMP规范对自己的接口进行改造开发，才能接入MISC。 接口改造主要分为以下几个方面： 1）CMPP3.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区别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中删除字段： 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中删除字段： 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 相同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：表示本字段无效，对谁计费参见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中的3,仅使用1位，右对齐。 Msg_Fmt 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 定时发送时间，格式遵循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：真实号码；1：伪码。 Msg_Length 1 UnsignedInteger 信息长度(Msg_Fmt值为0时：160个字节；其它 xmlns:SOAP-ENC=/soap/encoding/xmlns:xsd=/2001/XMLSchema xmlns:SOAP-ENV=/soap/envelope/ xmlns:SOAP-ENC=/soap/encoding/ 。 接口协议 HTTP协议 接口方向 请求：SP中央SSO平台 响应：中央SSO平台SP 查询用户信息接口请求的参数描述： 字段名称 字段说明 ICPCode SP的企业代码，长度为6位，格式是9XYnnn,XY表示SP接入地的短信网关编号，nnn表示序列号。 ICPPassword SP的密码，该字段要求使用统一的DES算法加密，并用SP的密码作为加密算法的密钥。 SeqNo SP用于标识唯一一次认证请求的号码 RandomSessionKey 用户的临时会话标识 查询用户信息接口响应的参数描述： 响应中的BackURL上以BackURL?参数名称1=参数值1&参数名称2=参数值2的形式返回以下输出参数： 字段名称 字段说明 ResultID SSO平台处理的结果，为0表示成功，其它表示失败。失败时将在ResultString字段将表示错误信息。 失败时不返回PseudoCode和MSISDN字段。 ResultString ResultIDid为0时，内容为”OK”。 失败时将在本字段表示具体失败原因。 SeqNo SP用于标识唯一一次认证请求的号码。 PseudoCode 用户伪码 要求可以配置成：当响应包中有MSISDN字段时，填或不填该字段。即当不填MSISDN时，此字段为必填 项；当响应包中有MSISDN字段时，则根据配置决定响应包中是否需要该字段。 MSISDN 用户手机号码（要求能维护一个icp列表，对列表中有的icp才填该字段，否则，响应包中不包含该字段） AreaID 用户的归属地ID。 定义与用户登录接口响应信息中定义的AreaID一样。 OtherInfoNumber 返回包中Other_Info的个数。 Other_Info是为了今后能够灵活扩展接口中传递的信息而定义的数据类型。 本字段表明在该XML包中存在的Otner_Info的数目。 Other_Info 表示其他信息数据。 OtherInfoNumber等于多少，在该XML包中就有多少个Other_Info。 在Other_Info的结构中，包含两个字段： InfoCode：表示信息代码 InfoValue：表示具体的信息值 5、用户订购业务与点播下载业务的处理流程 SP接入MISC平台的实施说明 由于MISC平台的建设有一个由点到面，逐步铺开的过程，因此在实施订购接口时需要考虑对于没有接入MISC的服务如何与已接入MISC的服务区别对待的问题。 根据服务接入MISC的情况不同，会有以下几种情况： 1）服务在MISC单点接入的情况 2）服务不在MISC接入的情况 3）服务多点接入时，主接入点和分接入点都接入MISC的情况 4）服务多点接入时，主接入点接入MISC，而分接入点没有接入MISC的情况 需要特别说明的是，在实现订购功能时，SP需要根据服务接入地选择SSO平台，即订购请求链接需要指向服务接入地的SSO平台，对于多点接入业务，则指向服务主接入地的SSO平台；如果服务接入地没有建设SSO平台，则指向中央SSO平台。 6、SSO订购、点播接口定义 业务订购与下载接口 接口名称 业务订购与下载 接口描述 SSO平台向SP系统开放的用户业务订购和下载功能接口，本接口根据参数的不同，有两种不同的用途： 1) 完成业务订购、取消订购、激活订购和暂停订购等操作 2) 完成下载类业务的临时订购，并返回临时订购关系ID 接口协议 HTTP协议 接口方向 请求：SP中央SSO平台 响应：中央SSO平台SP 业务订购与下载接口请求的参数描述： 字段名称 字段说明 ICPCode SP的企业代码，长度最长为6位，格式是9XYnnn,XY表示SP接入地的短信网关编号，nnn表示序列号。 ICPServID SP提供的短信业务的业务代码，变长（小于等于10位）的字符串。 如果是批量订购，则该字段可能包括多个业务代码，多个业务代码之间用逗号（“,”）分隔。 SeqNo SP用于标识唯一一次认证请求的号码。 ItemID 用于标识SP的即时下发类业务（铃声、图片等）唯一性的标识，长度及格式由SP自行约定，应只包含数字 和ASCII字符。 本字段只对下载业务有效，即只有当ActionID为10时才需要，ActionID为其他值时参数中不应包含本字段 。 例如，如果用户订购的是天气预报、新闻等包月服务，则不需要带此参数。 MSISDN 用户在SP网站上输入的手机号码（此参数为可选参数） ActionID 标识用户的操作，如订购、取消订购、暂停、激活等，长度为2位的整数，取值区间： 1：订购服务；2：取消服务； 3：激活服务；4：暂停服务； 10：点播下载服务。 BackURL 处理完成后要求SSO平台重定向用户到的目的URL。 DeliverURL SP的服务下发请求接口地址。 该参数为可选参数，当订购完成后SP需要向用户下发服务时填写该参数（ActionID10时）。 当订购完成后还需要向用户下发服务时，SSO平台将向该参数定义的地址发起一个HTTPGET请求，以通 知SP向用户下发指定的服务，请求中携带的参数格式参见服务下发请求接口。 SSO订购、点播接口定义 业务订购与下载接口响应的参数描述： 响应中的BackURL以BackURL?参数名称1=参数值1&参数名称2=参数值2的形式返回以下输出参数： 字段名称 字段说明 ActionID 标识用户的操作，如订购、取消订购、暂停、激活等，长度为2位的整数，取值区间：参见上表。 ResultID SSO平台处理的结果，0表示成功，其它表示失败。 失败时不返回ResultString字段。 如果是批量订购，则该字段中包含多个返回码，多个返回码之间用逗号（“,”）分隔，分别对应批 量订购中的每个服务。 例如，如果批量订购3个业务，第1和第2个服务订购成功，第3个服务由于服务代码错误订购失败 ，则该字段的值为0,0,4110。 ResultString ResultID为0时，内容为”OK” 失败时将在本字段表示具体失败原因。 如果是批量订购且部分成功时，则该字段为“部分成功” SeqNo SP用于标识唯一一次认证请求的号码。 RandomSessionKey 用户登录成功后的临时会话标识。 ICPServID SP提供的业务代码，变长（小于10位）的字符串。 TempAuthNo 由SSO平台生成的本次订购操作的临时订购关系ID，只对下载业务有效，即只有当ActionID为10或 5时才返回该字段，ActionID为其他值时不返回该字段。另外，只有在请求处理成功，即result为0 时才返回该字段。 ItemID 用于标识SP的即时下发类业务（铃声、图片等）唯一性的标识，长度及格式由SP自行约定，建议只包含数字和ASC字符。其值将与请求中的ItemID的值相同。 本字段只对下载业务有效，即只有当ActionID为10时才返回本字段，ActionID为其他值时不返回本字段。 FeePseudoCode 计费用户伪码； 当响应包中没有FeeMSISDN时，此字段为必填项；当响应包中有FeeMSISDN字段时，则该字段为可选字段。 FeeMSISDN 计费用户的手机号码； 要求能维护一个icp列表，对列表中有的icp才填该字段，否则，响应包中不包含该字段 DestPseudoCode 被赠送者的用户伪码；当用户输入了多个被赠送用户手机号码时，多个伪码之间用逗号（“,”）分隔。 该字段仅当请求中的ActionID为5时有效，ActionID为其他值时不返回本字段； 当响应包中没有DestMSISDN时，此字段为必填项；当响应包中有DestMSISDN字段时，则该字段为可选字段。 DestMSISDN 被赠送用户的手机号码；当用户输入了多个被赠送用户手机号码时，多个号码之间用逗号（“,”）分隔。 该字段仅当请求中的ActionID为10时有效，ActionID为其他值时不返回本字段； 要求能维护一个icp列表，对列表中有的icp才填该字段，否则，响应包中不包含该字段 7、服务下发请求接口 接口名称 服务下发请求接口 接口描述 SP系统向SSO平台开放的服务下发请求接口用于完成向用户下发服务的功能。 该接口主要用于处理SSO平台在用户完成服务订购后需要向用户下发服务时的情况。 接口协议 HTTP协议，使用GET请求 接口方向 请求：SSO平台SP 响应：SPSSO平台 服务下发请求接口的参数描述： ICPCode SP的企业代码，长度最长为6位，格式是9XYnnn,XY表示SP接入地的短信网关编号，nnn表示序列号。 ICPServID SP提供的短信业务的业务代码，变长（小于等于10位）的字符串。 SeqNo SP用于标识唯一一次认证请求的号码，该号码与SP在服务订购请求中的传入的SeqNo相同； ItemID 用于标识SP的即时下发类业务（铃声、图片等）唯一性的标识。 该字段为可选参数；该字段的值与SP在服务订购请求中的传入的ItemID相同。 FeePseudoCode 计费用户伪码； 当响应包中没有FeeMSISDN时，此字段为必填项；当响应包中有FeeMSISDN字段时，则该字段为可 选字段。 FeeMSISDN 计费用户的手机号码； 要求能维护一个icp列表，对列表中有的icp才填该字段，否则，响应包中不包含该字段 DestPseudoCode 接收服务的用户的伪码；当需要向多个用户下发服务时，多个伪码之间用逗号（“,”）分隔。 当请求中没有DestMSISDN时，此字段为必填项；当请求中有DestMSISDN字段时，则该字段为可选字 段。 DestMSISDN 接收服务的用户的手机号码；当需要向多个用户下发服务时，多个号码之间用逗号（“,”）分隔。 要求能维护一个icp列表，对列表中有的icp才填该字段，否则，响应包中不包含该字段 LinkID 临时订购关系的匹配码，用来鉴权一次点播请求等事务性的业务。 第二章、业务改造分册 MISC系统结构和作用 SP接入MISC流程 SP升级前后特性对比 业务梳理及业务代码改造 点播、订购指令MO匹配 订购、取消及包月收取 业务组合模式说明 特殊业务流程举例 一、业务改造 1、业务改造重要性说明 业务改造是否合理决定了SP的业务能否顺利接入MISC，所以请各SP在培训完后尽快派专人进行分析和梳理业务的工作。业务改造分为以下几个步骤： 1）业务类型划分 2）业务代码整理 3）点播、定制指令设置 4）资费信息设置 5）反向订购业务申请 2、SP升级前后特性对比 项目说明 升级前状态 升级后状态 订购关系保存 所有订购关系由SP自行掌握 订购关系同时保存在MISC系统和SP系统中，但是以MISC系统中的订购关系为准 订购、取消通知下发 SP自行组包生成订购、取消通知消息下发给用户 MISC平台根据SP申报的短信提醒下发给用户 0000、00000统一取消指令 SP收到0000时组包产生取消菜单下发给用户，收到00000自行取消用户订购关系 MISC平台拦截0000指令并自行组包产生菜单下发，拦截00000指令自动取消用户订购的所有业务 包月话单发起扣费 由SP自行发起SMC