中国电信SSMP短信割接

SP业务管理平台与SP相关的包括两部分： （１） 对上下行的消息进行鉴权处理部分。SP与这部分的接口是采用的SMGP协议，使用到的信令包括submit和deliver。通过SMGP协议进行点对点通信，消息内容为特定的字符串。具体格式后面将有介绍。 （２） SP门户部分：SP门户给SP提供了一种通过浏览器申请资源，开通并且管理自己业务的途径。具体操作方式参见《SP门户使用方法说明》。 回页首
SP门户上应做哪些准备？
登录门户网站：http://portalwebsite/webroot。其中的portalwebsite是待确定的IP地址或者域名信息。 SP需要完成如下工作，完成的具体过程参见《SP门户使用方法说明》： 1．SP注册自己的账户； 2．使用注册的账户进入门户，提交“接入资格申请”； 3．待通过接入资格申请后再提交“接入资源申请”。 这三步完成后，SP就可以申请开通新业务了。不过在割接的时候，由于业务会比较多，平台专门为割接提供了批量导入的方式。 回页首
需要修改程序的哪些部分？
由于有了平台的存在，所有的订购关系信息在平台和SP都有记录。这就存在一个两个地方的记录要保持一致，必须进行同步的问题。所以以前的订购流程： 1、终端订购建立订购关系 2、终端取消单个订购关系 3、终端取消所有订购关系 4、用户在SP网站上建立订购关系 5、用户在SP网站上取消单个订购关系 6、用户在SP网站上取消所有订购关系 都要做相应的修改。 另外点播流程不需要修改，SP不再需要发起包月扣费流程，改由平台发起。 在割接以前，SP必须修改自己的程序，实现与平台同步的接口。 回页首
终端建立订购关系的流程
用户订购关系建立流程如下表所示。原来的处理方式是： (1) 用户发送订购请求到网关； (2) 网关转发订购请求到SP，使用deliver消息。 现在的处理方式修改为： (1) 用户发送订购请求到网关； (2) 网关转发订购请求到平台； (3) 如果不需要二次确认，转步骤(4)；如果需要二次确认，平台发送二次确认消息到用户进行二次确认，二次确认完成，转步骤(4)； (4) 平台发送订购关系同步消息到网关，目的地址为SP；网关使用deliver消息转发到SP；消息内容为： 1001[SPACE]业务代码[SPACE]订购用户号码{[SPACE]计费号码} 其中[SPACE]为空格，{}中的内容为可选内容。 (5) SP建立订购关系，使用submit消息给平台回响应消息。流程完成。消息内容为： 1001[SPACE][RETCODE][SPACE]业务代码[SPACE]订购用户号码{[SPACE]计费号码} 分析新的处理方式，可知SP只需要同平台交互就能建立订购关系。 回页首
订购关系建立过程举例
SP的接入号码为1183333，管理平台的接入号码为1181111，业务不需二次确认。 (1) 业务发布了以后，号码为0226666666的用户发送“YKYBTCS”到1183333。平台会收到网关转发的消息，消息内容为“YKYBTCS”。 (2) 平台会使用submit信令向SP发送消息，内容为 “1001 YKYBTCS 0226666666 0226666666”。注意图3-2-1中的“业务特征码”和“业务代码”可以设置为不同。消息内容中的“YKYBTCS”对应的是“业务代码”中的值。 (3) SP收到后就建立订购关系。如果成功，就给平台回 “1001 0 YKYBTCS 0226666666 0226666666”。 如果失败，就回“1001 1 YKYBTCS 0226666666 0226666666”。 回页首
终端取消单个订购关系
原来的处理方式是： (1) 用户发送“取消单个订购关系”请求到网关； (2) 网关转发订购请求到SP，使用deliver消息。 现在的处理方式修改为： (1) 用户发送“取消单个订购关系”请求到网关； (2) 网关转发“取消单个订购关系”请求到平台； (3) 平台取消订购关系，向用户发送通知消息。并且向SP发送取消单个订购关系同步消息到网关，目的地址为SP；网关使用deliver消息转发到SP；消息内容为： 1002[SPACE]业务代码[SPACE]订购用户号码{[SPACE]计费号码} (3) SP取消订购关系，使用submit消息给平台回响应消息。流程完成。消息内容为： 1002[SPACE][RETCODE][SPACE]业务代码[SPACE]订购用户号码{[SPACE]计费号码} 　　SP成功取消[RETCODE]为0，取消失败[RETCODE]为1。 分析新的处理方式，可知SP只需要同平台交互就能取消单个订购关系。 回页首
取消单个订购关系举例
继续3.2中例子。 (1) 号码为0226666666的用户想取消订购关系。图3-2-1中，退定的业务特征码为“TDYKYBY”。发送“TDYKYBY”到1183333。平台会收到网关转发的消息，消息内容为“TDYKYBY”。 (2) 平台会首先取消在自身的订购关系记录，然后使用submit信令向SP发送消息，内容为 “1002 YKYBTCS 0226666666 0226666666”。 消息内容中的“YKYBTCS”对应的是“业务代码”中的值。 (3) SP收到后就取消订购关系。如果成功，就给平台回 “1002 0 YKYBTCS 0226666666 0226666666”。 如果失败，就回“1002 1 YKYBTCS 0226666666 0226666666”。 回页首
终端取消所有订购关系
原来的处理方式是： (1) 用户发送“取消全部订购关系”请求到网关； (2) 网关转发订购请求到SP，使用deliver消息。 现在的处理方式修改为： (1) 用户发送“取消全部订购关系”请求到网关； (2) 网关转发“取消全部订购关系”请求到平台； (3) 平台取消SP与该用户的全部订购关系，向用户发送通知消息。并且向SP发送取消全部订购关系同步消息到网关，目的地址为SP；网关使用deliver消息转发到SP；消息内容为： 1003[SPACE]订购用户号码 (4) SP取消全部订购关系，使用submit消息给平台回响应消息。流程完成。消息内容为： 1003[SPACE][RETCODE][SPACE]订购用户号码 　　SP成功取消[RETCODE]为0，取消失败[RETCODE]为1。 分析新的处理方式，可知SP只需要同平台交互就能取消全部订购关系。 回页首
取消全部订购关系举例
继续3.2中例子。 (1) 号码为0226666666的用户想取消在SP的全部订购关系。假设平台设定的取消全部订购关系的指令为“00000”。用户发送“00000”到1183333。平台会收到网关转发的消息，消息内容为“00000”。 (2) 平台会首先取消在自身的订购关系记录，然后使用submit信令向SP发送消息，内容为 “1003 0226666666”。 (3) SP收到后就取消订购关系。如果成功，就给平台回 “1003 0 0226666666”。 如果失败，就回“1003 1 0226666666”。 回页首
用户在SP网站上建立订购关系
原来的处理方式是： 用户在SP网站上订购业务，SP直接建立订购关系，然后给用户发送通知消息。 现在的处理方式修改为： (1) 用户在网站上发送建立订购关系的请求，SP建立订购关系。 (2) 然后SP必须给平台发送订购关系同步消息。网关会转发该消息到平台。消息内容为： 　　2001[SPACE]业务代码[SPACE]订购用户号码{[SPACE]计费号码} (3) 如果该业务的配置为“不需要二次确认”，则转步骤(4)；否则，平台给用户发送二次确认消息，用户回应，二次确认通过。 (4) 平台建立订购关系。然后给SP回建立订购关系响应消息。流程结束。响应消息内容为： 　2001[SPACE][RETCODE][SPACE]业务代码[SPACE]订购用户号码{[SPACE]计费号码} 回页首
SP网站建立订购关系举例
继续以3.2中业务为例子。 (1) 号码为0226666666的用户在SP网站上操作，发送建立订购关系的请求。SP建立订购关系，然后向平台发送同步消息。消息内容为： 2001 YKYBTCS 0226666666 0226666666 (2) 平台在自身建立0226666666用户与“YKYBTCS”业务的订购关系。然后给SP发送同步响应消息。如果建立订购关系成功，消息内容为： 2001 0 YKYBTCS 0226666666 0226666666 如果失败，消息内容为： 2001 1 YKYBTCS 0226666666 0226666666 回页首
用户在SP网站上取消单个订购关系
原来的处理方式是： 用户在SP网站上取消单个订购关系，SP直接将订购关系删除，然后给用户发送通知消息。 现在的处理方式修改为： (1) 用户在网站上发送取消订购关系的请求，SP取消单个订购关系。 (2) 然后SP必须给平台发送取消单个订购关系的同步消息。网关会转发该消息到平台。消息内容为： 2002[SPACE]业务代码[SPACE]订购用户号码{[SPACE]计费号码} (3) 平台向用户发送确认消息，用户回复确认，确认过程完成。 (4) 平台取消指定的订购关系，然后向SP发送同步响应消息，消息内容为： 2002[SPACE][RETCODE][SPACE]业务代码[SPACE]订购用户号码{[SPACE]计费号码} 回页首
SP网站取消单个订购关系举例
继续以3.2中业务为例子。 (1)号码为0226666666的用户在SP网站上操作，发送取消与业务“YKYBTCS”的订购关系的请求。SP取消订购关系，然后向平台发送同步消息。消息内容为： 2002 YKYBTCS 0226666666 0226666666 (3) 平台在向0226666666用户发送确认消息，并且收到回复以后，自身取消0226666666用户与“YKYBTCS”业务的订购关系。然后给SP发送同步响应消息。如果取消订购关系成功，消息内容为： 2002 0 YKYBTCS 0226666666 0226666666 如果失败，消息内容为： 2002 1 YKYBTCS 0226666666 0226666666 回页首
用户在SP网站上取消所有订购关系
原来的处理方式是： 用户在SP网站上取消其在该SP的所有订购关系，SP直接将订购关系删除，然后给用户发送通知消息。 现在的处理方式修改为： (1) 用户在网站上发送取消订购关系的请求，SP取消所有订购关系。 (2) 然后SP必须给平台发送取消所有订购关系的同步消息。网关会转发该消息到平台。消息内容为： 2003[SPACE]用户号码 (3) 平台删除0226666666用户与该SP的所有订购关系记录，然后向SP发送同步响应消息。消息内容为： 2003[SPACE][RETCODE][SPACE]用户号码 回页首
SP网站取消所有订购关系举例
继续以3.2中业务为例子。 (1) 号码为0226666666的用户在SP网站上操作，发送取消在该SP上所有业务的请求。SP取消所有订购关系，然后向平台发送同步消息。消息内容为： 2003 0226666666 (2) 平台自身取消0226666666用户与该SP的所有订购关系的记录。然后给SP发送同步响应消息。如果取消订购关系成功，消息内容为： 2003 0 0226666666 如果失败，消息内容为： 2003 1 0226666666 回页首
定购完成以后，为什么不能立即下发。
当建立订购关系的流程完成以后，平台在处理订购关系的时候可能还有一些相关操作没有完成。这时候，如果SP立即下发业务消息，将不能通过平台的鉴权。为了避免这种情况的出现，增加了下面这个没有响应的同步消息。 1000[SPACE]业务代码[SPACE]订购用户号码{[SPACE]计费号码} 当平台完成了所有的操作以后，通过这个消息告诉SP“可以下发业务消息”了。以3.2中业务为例，平台发送的消息内容为： 1000 YKYBTCS 0226666666 0226666666 回页首
业务信息文件实例
[ICP_BASIC] SPID = 87100070 Name_Cn = 尖端科技 Name_Short = JDKJ AccessNO = 1181231 [SERVICE] ServiceCount = 6 业务1：普通点播类业务，业务名称"爱情风向标"，发送“CTAQ”到1231点播，一个点播请求对应一个点播 应答消息，业务代码为CTAQ，每条0.08元 [SERVICE_001] SMSCount = 1 #SmsMsgCount 为一个MO对应的MT数目 SmsMsgCount = 1 ServiceName = 爱情风向标 DemandFlag = 2 ConfirmType = Confirm_Prompt1 = Confirm_Prompt2 = 此处为业务说明信息 #点播的接入及下发描述 [SERVICE_001_SMS_01] ServiceCode = CTAQ AccessNO = 1181231 ANCheckFlag = 1 FeatureStr = CTAQ FSCheckFlag = 1 CommandType = 5 FeeType = 1 FeeCode = 8 FixedFee = 0 业务2：普通订阅类业务，业务名称为“体育新闻”，发送“TYXW”到1231定制，发送“QRTYXW”到1231确认定制， 发送“QXTYXW”退订，每天下发5条，每月8元 [SERVICE_002] SMSCount = 3 SmsMsgCount = 5 ServiceName = 体育新闻 DemandFlag = 0 #需要确认 ConfirmType = 2 #订购成功提示语，包括如何退订、业务资费谢谢，提示内容（不超过80字节）如下： Confirm_Prompt1 = 订购成功,谢谢使用明益科技的体育新闻业务,业务资费每月8元,发送QXTQYB到1231取消订购 #业务使用说明，包括sp、业务名称，如何订购，如何退订，业务资费 Confirm_Prompt2 = 明益科技的体育新闻业务,发送TQYB到1231定制,业务资费每月8元,发送QXTQYB到1231取消订购 #订购接入及下发的描述 [SERVICE_002_SMS_01] #订购与订购下发相对应，所以要定义业务代码及其费率 ServiceCode = TYXW AccessNO = 1181231 ANCheckFlag = 1 FeatureStr = TYXW FSCheckFlag = 1 CommandType = 1 FeeType = 2 FeeCode = 0 FixedFee = 800 #如果只是通过0000查询后取消，就不必定义取消的接入方式了 [SERVICE_002_SMS_02] #取消订购没有对应的SP下发消息，因此不需要业务代码，也没有必要定义费率 ServiceCode = AccessNO = 1181231 ANCheckFlag = 1 FeatureStr = QXTYXW FSCheckFlag = 1 CommandType = 2 #如果不需要确认的话，就没有必要定义确认的接入方式了 [SERVICE_002_SMS_03] #确认订购没有对应的SP下发消息，因此不需要业务代码，也没有必要定义费率 ServiceCode = AccessNO = 1181231 ANCheckFlag = 1 FeatureStr = QRTYXW FSCheckFlag = 1 CommandType = 7 业务3：定制点播类业务，即必须建立订购关系才能点播的业务。 发送“DGXH”到1231订购，发送“XH”到1231点播，发送“QXXH”到1231退订 [SERVICE_003] SMSCount = 4 SmsMsgCount = 1 ServiceName = 极品笑话 DemandFlag = 3 #需要确认 ConfirmType = 2 #订购成功提示语，包括如何退订、业务资费谢谢，提示内容（不超过80字节）如下： Confirm_Prompt1 = 订购成功,谢谢使用明益科技的极品笑话业务,业务资费每月8元,。。。 #业务使用说明，包括sp、业务名称，如何订购，如何退订，业务资费 Confirm_Prompt2 = 明益科技的极品笑话业务,。。。 #订购接入及下发的描述 [SERVICE_003_SMS_01] #定制点播类业务没有SP订购下发消息，所以不要定义业务代码及其费率 ServiceCode = AccessNO = 1181231 ANCheckFlag = 1 FeatureStr = DYXH FSCheckFlag = 1 CommandType = 1 #如果只是通过0000查询后取消，就不必定义取消的接入方式了 [SERVICE_003_SMS_02] #取消订购没有对应的SP下发消息，因此不需要业务代码，也没有必要定义费率 ServiceCode = AccessNO = 1181231 ANCheckFlag = 1 FeatureStr = QXXH FSCheckFlag = 1 CommandType = 2 #如果不需要确认的话，就没有必要定义确认的接入方式了 [SERVICE_003_SMS_03] #确认订购没有对应的SP下发消息，因此不需要业务代码，也没有必要定义费率 ServiceCode = AccessNO = 1181231 ANCheckFlag = 1 FeatureStr = QRXH FSCheckFlag = 1 CommandType = 7 #点播接入及下发的描述 [SERVICE_003_SMS_04] ServiceCode = JPXH AccessNO = 1181231 ANCheckFlag = 1 FeatureStr = XH FSCheckFlag = 1 CommandType = 5 FeeType = 2 FeeCode = 0 FixedFee = 800 业务4：定制使用类业务，即普通定制类业务＋定制点播类业务，都必须定制才能使用的业务。 发送“DGZJXH”到1231订购，发送“ZJXH”到1231点播，发送“QXZJXH”到1231退订 [SERVICE_004] SMSCount = 4 SmsMsgCount = 1 ServiceName = 终极笑话 DemandFlag = 4 #需要确认 ConfirmType = 2 #订购成功提示语，包括如何退订、业务资费谢谢，提示内容（不超过80字节）如下： Confirm_Prompt1 = 订购成功,谢谢使用明益科技的终极笑话业务,业务资费每月10元,另行点播每条0.10元。。。 #业务使用说明，包括sp、业务名称，如何订购，如何退订，业务资费 Confirm_Prompt2 = 明益科技的终极笑话业务,。。。 #订购接入及下发的描述 [SERVICE_004_SMS_01] #定制使用类业务，需要为定购配置业务代码、特征码和费率 ServiceCode = ZJXH AccessNO = 1181231 ANCheckFlag = 1 FeatureStr = DGZJXH FSCheckFlag = 1 CommandType = 1 FeeType = 2 FeeCode = 0 FixedFee = 1000 #如果只是通过0000查询后取消，就不必定义取消的接入方式了 [SERVICE_004_SMS_02] #取消订购没有对应的SP下发消息，因此不需要业务代码，也没有必要定义费率 ServiceCode = AccessNO = 1181231 ANCheckFlag = 1 FeatureStr = QXZJXH FSCheckFlag = 1 CommandType = 2 #如果不需要确认的话，就没有必要定义确认的接入方式了 [SERVICE_004_SMS_03] #确认订购没有对应的SP下发消息，因此不需要业务代码，也没有必要定义费率 ServiceCode = AccessNO = 1181231 ANCheckFlag = 1 FeatureStr = QRZJXH FSCheckFlag = 1 CommandType = 7 #点播接入及下发的描述 [SERVICE_004_SMS_04] ServiceCode = DBXH AccessNO = 1181231 ANCheckFlag = 1 FeatureStr = ZJXH FSCheckFlag = 1 CommandType = 1 FeeType = 1 FeeCode = 10 FixedFee = 0 业务5：网站点播类业务 业务代码为WZDB，每条0.10元 [SERVICE_005] SMSCount = 1 #SmsMsgCount 为一个MO对应的MT数目 SmsMsgCount = 1 ServiceName = 网站点播 DemandFlag = 1 ConfirmType = Confirm_Prompt1 = Confirm_Prompt2 = 此处为业务说明信息 #点播的接入及下发描述 [SERVICE_005_SMS_01] ServiceCode = WZDB AccessNO = 1181231 ANCheckFlag = 1 #没有上行，只有下行，因此特征码就不必了 FeatureStr = FSCheckFlag = 1 CommandType = 5 FeeType = 1 FeeCode = 10 FixedFee = 0 业务6：短信参与类业务，只有上行没有下行消息的业务，如投票类业务 每条1元 [SERVICE_005] SMSCount = 1 #SmsMsgCount 为一个MO对应的MT数目 SmsMsgCount = 1 ServiceName = 昆明十大 DemandFlag = 5 ConfirmType = Confirm_Prompt1 = Confirm_Prompt2 = 此处为业务说明信息 #点播的接入及下发描述 [SERVICE_005_SMS_01] #没有下行消息，业务代码无效 ServiceCode = AccessNO = 1181231 ANCheckFlag = 1 FeatureStr = KMSD FSCheckFlag = 1 CommandType = 6 FeeType = 1 FeeCode = 100 FixedFee = 0 回页首
错误代码134是啥意思？
错误代码是134，意味着在测试阶段只能使用FREE作为业务代码下发信息。 回页首
SP注意事项
1、 短消息类型MSGTYPE：1=取消订阅，2=订阅请求，3=点播，4=订阅。 * 下发订阅信息和包月话单时，MSGTYPE=4订阅 2、 包月费计费情况： SP收到订阅请求后，必须发送一条“订阅确认”消息，MsgType=2,FeeType=0（包月）,FeeCode=0,FixedFee=0。 以后的订阅信息MsgType=4，FeeType=0,FeeCode=0,FixedFee=0； 下发包月话单MsgType=4，FeeType=4,FeeCode=0,FixedFee=包月费。 所有业务必须区分业务代码，同种业务有点播/订阅两种形式时，也需要设定不同的业务代码，请SP根据业务类型制定不同的ServiceID号。 3、 若订阅失败，SP必须发送一条“订阅确认”消息，MsgType=2,FeeType=0,FeeCode=0,FixedFee=0。 4、 注意ChargeTermID字段的填写,一般情况下为缺省，不需要填写该字段，系统会自动将目的用户号码设为扣费用户号码，只有对第三方计费时，才填写ChargeTermID字段。 5、 NeedReport是否返回状态报告,0=不要求，1=要求。 6、 SP收到网关回复的submit-resp状态报告中的status=1或8时为SP下发流量过大，需要调整流量。 7、 SP回复网关的deliver-resp消息中的MSGID，必须与收到网关的deliver消息中的MSGID一致，一般格式为网关代码（3字节）+时间（4字节）+序列号（3字节），否则上行消息失败。 8、SP下发消息的主叫号码srcTermID必须填写为118+SPID，否则下发消息失败