中国电信SSMP短信割接

来源:互联网 发布:mac阿里旺旺下载2015 编辑:程序博客网 时间:2024/04/29 06:48
SP业务管理平台与SP相关的包括两部分:
(1) 对上下行的消息进行鉴权处理部分。SP与这部分的接口是采用的SMGP协议,使用到的信令包括submit和deliver。通过SMGP协议进行点对点通信,消息内容为特定的字符串。具体格式后面将有介绍。
(2) 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,否则下发消息失败