MISC系统短信SP接入培训
卓望科技
2005/03
SP接入MISC流程
接口改造分册
正反向订购接口开发说明
网站改造SSO接口流程说明
接口开发说明
MISC系统结构和作用
MISC系统结构和作用
MISC(Mobile Information Service Center移动信息服务中心)是一个完全符合中国移动数据业务管理平台技术规范(DSMP)的数据运营平台,它完成数据业务的业务管理和控制功能,实现用户管理、业务管理和SP管理,对外提供开放的、标准统一的Web Service接口,并可以为各个业务网关、SP提供代计费。
二级管理平面
一级数据平面
梦网WAP门户/访问代理
梦网PDA门户/访问代理
梦网短信网关
梦网www门户
WAP网关
WAP SP
PDA SP
www SP
移动互联网/
Internet
SMS SP
中央
MISC
江苏省
MISC
广东省
MISC
浙江省
MISC
河南省
MISC
福建省
MISC
全网业务管理
SPOA
省级业务管理
SPOA
DSMP接口
中央BOSS
省级WAP门户/PDA门户/www门户/短信网关/省BOSS
省级业务管理
SPOA
省级业务管理
SPOA
SP接入MISC流程
组织SP培训
SP程序开发及业务梳理
安排SP在试验环境做接口测试
现网全业务申报
SP进行全业务自行拨测及相关程序调整
SP提交全业务拨测报告供计费验证
安排割接
N
N
SP接入MISC流程-流程说明
1)首先需要组织SP参与MISC升级改造培训
2)培训结束后SP就应该开始着手进行业务梳理及接口程序开发,并在移动要求的时间内完成这项工作
3)SP具备接口测试条件以后,集中统一安排在测试环境做接口测试及典型业务申报
4)接口测试通过以后根据现网MISC系统建设情况,安排接口测试通过的SP在现网做全业务申报和全业务拨测
5)全业务拨测通过后提交拨测报告供计费做计费验证
6)验证通过后根据网络部的割接计划安排割接
接口改造总体说明
在整个升级改造过程中“接口改造”占了一个非常重要的位置。SP需要根据协议和DSMP规范对自己的接口进行改造开发,才能接入MISC。
接口改造主要分为以下几个方面:
1)接口程序改造
2)正反向订购、取消接口开发
3)网站改造SSO接口开发
接口改造说明
接口开发需具备条件
和区别
协议包体说明
接口改造需具备条件
1、自己开发接口的SP,应根据协议对接口进行修改;使用API的SP,应向接入网关的省公司或网关厂家索取最新的接口API以及使用说明等相关文档
2、不管是自己开发接口的,还是使用接口API的SP,都应该详细了解和的区别
和区别-SP登录
和区别-SP登录
1、SP向所接入的ISMG发送登录请求;
2、ISMG向MISC发送SP登陆鉴权信息查
询请求;
3、MISC向ISMG返回SP登陆鉴权结果;
4、ISMG根据此信息进行SP登陆认证,并向SP返回认证结果;
和区别-协议包的变化
1)CMPP_SUBMIT包内容的变化:
中新增字段:
Fee_terminal_type:被计费用户的号码类型,0:真实号码;1:伪码
Dest_terminal_type:接收短信的用户号码类型,0:真实号码;1:伪码
LinkID:20个字节,点播业务使用,非点播类业务的MT流程不使用该字段
中删除字段:
Reserve:保留字段。
中变化字段:
Fee_terminal_id:被计费用户号码。长度扩展为32个字节,数据类型从
Unsigned Integer修改为Octet String
Dest_terminal_id:接收短信的用户号码。长度扩展为32个字节,数据类
型从Unsigned Integer修改为Octet String
和区别-协议包的变化
2)CMPP_DELIVER包内容的变化
中新增字段:
Src_terminal_type:源终端号码类型,0:真实号码;1:伪码
LinkID:20个字节,点播业务使用,非点播类业务的MT流程不使用字段
中删除字段:
Reserve:保留字段
中变化字段:
Src_terminal_id:源终端号码。长度扩展为32个字节,数据类型从
Unsigned Integer修改为Octet String
字段说明:
伪码:一个随机字符串,对于一个SP,唯一标识一个用户
LinkID:20位字符串,该字段的值由MISC产生,编码格式为4位MISCID+12
位时间+4位序列号。用于点播类业务中MT与MO消息的匹配。
协议包体说明CMPP_SUBMIT
GSM协议类型。详细是解释请参考中的,仅使用1位,右对齐。
Unsigned Integer
1
TP_udhi
GSM协议类型。详细是解释请参考中的。
Unsigned Integer
1
TP_pId
被计费用户的号码类型,0:真实号码;1:伪码。
Unsigned Integer
1
Fee_terminal_type
被计费用户的号码,当Fee_UserType为3时该值有效,当Fee_UserType为0、1、2时该值无意义。
Octet String
32
Fee_terminal_Id
计费用户类型字段:
0:对目的终端MSISDN计费;
1:对源终端MSISDN计费;
2:对SP计费;
3:表示本字段无效,对谁计费参见Fee_terminal_Id字段。
Unsigned Integer
1
Fee_UserType
业务标识,是数字、字母和符号的组合。
Octet String
10
Service_Id
信息级别。
Unsigned Integer
1
Msg_level
是否要求返回状态确认报告:
0:不需要;
1:需要。
Unsigned Integer
1
Registered_Delivery
相同Msg_Id的信息序号,从1开始。
Unsigned Integer
1
Pk_number
相同Msg_Id的信息总条数,从1开始。
Unsigned Integer
1
Pk_total
信息标识
Unsigned Integer
8
Msg_Id
描述
属性
字节数
字段名
协议包体说明CMPP_SUBMIT
源号码。SP的服务代码或前缀为服务代码的长号码, 网关将该号
码完整的填到SMPP协议Submit_SM消息相应的source_addr字段,
该号码最终在用户手机上显示为短消息的主叫号码。
Octet String
21
Src_Id
定时发送时间,格式遵循协议。
Octet String
17
At_Time
存活有效期,格式遵循协议。
Octet String
17
ValId_Time
资费代码(以分为单位)。
Octet String
6
FeeCode
资费类别:
01:对“计费用户号码”免费;
02:对“计费用户号码”按条计信息费;
03:对“计费用户号码”按包月收取信息费。
Octet String
2
FeeType
信息内容来源(SP_Id)。
Octet String
6
Msg_src
信息格式:
0:ASCII串;
3:短信写卡操作;
4:二进制信息;
8:UCS2编码;
15:含GB汉字。。。。。。
Unsigned Integer
1
Msg_Fmt
协议包体说明CMPP_SUBMIT
点播业务使用的LinkID,非点播类业务的MT流程不使用该字段。
Octet String
20
LinkID
信息内容。
Octet String
Msg_length
Msg_Content
信息长度(Msg_Fmt值为0时:<160个字节;其它<=140个字节),
取值大于或等于0。
Unsigned Integer
1
Msg_Length
接收短信的用户的号码类型,0:真实号码;1:伪码。
Unsigned Integer
1
Dest_terminal_type
接收短信的MSISDN号码。
Octet String
32*DestUsr_tl
Dest_terminal_Id
接收信息的用户数量(小于100个用户)。
Unsigned Integer
1
DestUsr_tl
协议包体说明CMPP_SUBMIT_RESP
结果:
0:正确;
1:消息结构错;
2:命令字错;
3:消息序号重复;
4:消息长度错;
5:资费代码错;
6:超过最大信息长;
7:业务代码错;
8:流量控制错;
9:本网关不负责服务此计费号码;
10:Src_Id错误;
11:Msg_src错误;
12:Fee_terminal_Id错误;
13:Dest_terminal_Id错误;
……
Unsigned Integer
4
Result
信息标识,生成算法如下:
采用64位(8字节)的整数:
时间(格式为MMDDHHMMSS,即月日时分秒):bit64~bit39,其中
bit64~bit61:月份的二进制表示;
bit60~bit56:日的二进制表示;
bit55~bit51:小时的二进制表示;
bit50~bit45:分的二进制表示;
bit44~bit39:秒的二进制表示;
短信网关代码:bit38~bit17,把短信网关的代码转换为整数填写到该字段中;
序列号:bit16~bit1,顺序增加,步长为1,循环使用。
各部分如不能填满,左补零,右对齐。
(SP根据请求和应答消息的Sequence_Id一致性就可得到CMPP_Submit消息的Msg_Id)
Unsigned Integer
8
Msg_Id
描述
属性
字节数
字段名
协议包体说明CMPP_DELIVER
GSM协议类型。详细解释请参考中的,
仅使用1位,右对齐。
Unsigned Integer
1
TP_udhi
GSM协议类型。详细解释请参考中的。
Unsigned Integer
1
TP_pid
业务标识,是数字、字母和符号的组合。
Octet String
10
Service_Id
目的号码。
SP的服务代码,一般4--6位,或者是前缀为服务代码的
长号码;该号码是手机用户短消息的被叫号码。
Octet String
21
Dest_Id
信息标识。
生成算法如下:
采用64位(8字节)的整数:
时间(格式为MMDDHHMMSS,即月日时分秒):bit64~bit39,其中
bit64~bit61:月份的二进制表示;
bit60~bit56:日的二进制表示;
bit55~bit51:小时的二进制表示;
bit50~bit45:分的二进制表示;
bit44~bit39:秒的二进制表示;
短信网关代码:bit38~bit17,把短信网关的代码转换为整数填写到该字段中;
序列号:bit16~bit1,顺序增加,步长为1,循环使用。
各部分如不能填满,左补零,右对齐。
Unsigned Integer
8
Msg_Id
描述
属性
字节数
字段名
协议包体说明CMPP_DELIVER
点播业务使用的LinkID,非点播类业务的MT流程不使
用该字段。
Octet String
20
LinkID
消息内容。
Octet String
Msg_length
Msg_Content
消息长度,取值大于或等于0。
Unsigned Integer
1
Msg_Length
是否为状态报告:
0:非状态报告;
1:状态报告。
Unsigned Integer
1
Registered_Delivery
源终端号码类型,0:真实号码;1:伪码。
Unsigned Integer
1
Src_terminal_type
源终端MSISDN号码(状态报告时填为CMPP_SUBMIT
消息的目的终端号码)。
Octet String
32
Src_terminal_Id
信息格式:
0:ASCII串;
3:短信写卡操作;
4:二进制信息;
8:UCS2编码;
15:含GB汉字。
Unsigned Integer
1
Msg_Fmt
协议包体说明CMPP_DELIVER_RESP
结果:
0:正确;
1:消息结构错;
2:命令字错;
3:消息序号重复;
4:消息长度错;
5:资费代码错;
6:超过最大信息长;
7:业务代码错;
8: 流量控制错;
9~ :其他错误。
Unsigned Integer
4
Result
信息标识(CMPP_DELIVER中的Msg_Id字段)。
Unsigned Integer
8
Msg_Id
描述
属性
字节数
字段名
协议包体说明_网关返回状态报告
取自SMSC发送状态报告的消息体中的消息标识。
Unsigned Integer
4
SMSC_sequence
目的终端MSISDN号码(SP发送CMPP_SUBMIT消息
的目标终端)。
Octet String
32
Dest_terminal_Id
YYMMDDHHMM。
Octet String
10
Done_time
YYMMDDHHMM(YY为年的后两位00-99,MM:
01-12,DD:01-31,HH:00-23,MM:00-59)。
Octet String
10
Submit_time
发送短信的应答结果,含义详见表一。SP根据该字段
确定CMPP_SUBMIT消息的处理状态。
Octet String
7
Stat
信息标识。
SP提交短信(CMPP_SUBMIT)操作时,与SP相连
的ISMG产生的Msg_Id。
Unsigned Integer
8
Msg_Id
描述
属性
字节数
字段名
协议包体说明_返回状态报告值
没有从下一级ISMG处接收到状态报告时的状态报告
IC:xxxx
IC:xxxx
下一级ISMG返回错误响应消息时的状态报告
IB:xxxx
IB:xxxx
下一级ISMG不返回响应消息时的状态报告
IA:xxxx
IA:xxxx
SP返回错误响应消息时的状态报告
SB:xxxx
SB:xxxx
SP不返回响应消息时的状态报告
SA:xxxx
SA:xxxx
DSMP返回错误响应消息时的状态报告
DB:xxxx
DB:xxxx
DSMP不返回响应消息时的状态报告
DA:xxxx
DA:xxxx
SCP返回错误响应消息时的状态报告
CB:xxxx
CB:xxxx
SCP不返回响应消息时的状态报告
CA:xxxx
CA:xxxx
没有从SMSC处接收到状态报告时的状态报告
MC:xxxx
MC:xxxx
SMSC返回错误响应消息时的状态报告
MB:xxxx
MB:xxxx
SMSC不返回响应消息时的状态报告
MA:xxxx
MA:xxxx
Message is in a rejected state
REJECTD
REJECTED
Message is in invalid state
UNKNOWN
UNKNOWN
Message is in accepted state(. has been manually read on behalf
of the subscriber by customer service)
ACCEPTD
ACCEPTED
Message is undeliverable
UNDELIV
UNDELIVERABLE
Message has been deleted.
DELETED
DELETED
Message validity period has
expired
EXPIRED
EXPIRED
Message is delivered to destination
DELIVRD
DELIVERED
Description
Final Message States
Message State
MISC常见错误代码说明
点播类业务对应的MT中,业务代码、LINKID和MO中的不匹配
用户没有点播该业务
140
SP向已暂停该业务的用户下发MT消息
用户暂停此业务
116
SP向未订购该业务的用户下发MT消息
用户没有订购此业务
115
MT包中所填的业务在MISC中已被暂停
业务暂停
108
MT包中的Service_Id与SP在MISC中申报的业务代码不一致
业务不存在
107
用户欠费
103
用户停机
102
MT包中的计费号码或者接收号码不是梦网用户
手机号码错误
101
备注
错误描述
错误代码
正、反向接口开发说明
正向同步PROVISION接口规范
正向同步PROVISION接口消息定义
正向订购、取消包示例
反向接口规范
反向订购接口消息定义
反向取消接口消息定义
反向订购、取消包示例
正向同步PROVISION接口规范-流程图
正向同步PROVISION接口规范-流程说明
用户通过手机发送定制或取消指令到相应的SP特服号,网关收到MO消息后向MISC发起MO鉴权批价请求,MISC收到MO鉴权批价请求后进行订购、取消点播指令匹配;如果判断指令是定制或取消指令,则MISC会向SP发送订购关系同步请求包SyncOrderRelationReq
用户通过WWW网站发起订购或取消请求,MISC在收到WWW网站的请求之后,会向SP发送订购关系同步请求包SyncOrderRelationReq
SP收到同步请求包后,对订购请求做相应的订购关系处理,并返回订购关系同步应答SyncOrderRelationResp
MISC收到应答包后,根据返回结果是否正确,在系统中生成正式的订购关系或者取消订购关系,并由1862系统给用户下发订购成功或取消成功的提醒消息
正向同步PROVISION接口消息定义
功能描述
此接口在MISC因为某种情况更新了用户订购关系(包括订购、取消、暂停、激活)的时候,通过此接口发起和SP的更新订购关系的交互。
SPMISC
Response
SyncOrderRelationResp
MISCSP
Request
SyncOrderRelationReq
消息方向
消息类型
消息名
正向同步PROVISION接口消息定义
接口内容描述
SyncOrderRelationReq消息字段描述:
服务状态管理动作代码,具体值如下:
1: 开通服务;
2: 停止服务;
3: 激活服务;
4: 暂停服务;
integer
必须
ActionID
临时订购关系的事务ID
string
可选
LinkID
使用用户标识
user_id_schema
必须
DestUser_ID
计费用户标识
user_id_schema
必须
FeeUser_ID
接收方的地址
address_info_schema
必须
Dest_Address
发送方的地址
address_info_schema
必须
Send_Address
该接口消息的版本号,本次所有的接口消息的版本都
为“”
string
必须
Version
该消息编号
string
必须
TransactionID
消息类型
string
必须
MsgType
说明
类型
重要性
返回定义
正向同步PROVISION接口消息定义
服务订购参数(base64加密),内容是长号码+空格+用户发送内容
binary
可选
FeatureStr
服务的访问方式
1:WEB
2:WAP
3:SMS
Integer
可选
AccessMode
SP中该服务的服务代码
string
必须
SPServiceID
SP的企业代码
string
可选
SPID
产生服务状态管理动作原因的代码,具体值如下:
1:用户发起行为
2:Admin&1860发起行为
3:Boss停机
4:Boss开机
5:Boss过户
6:Boss销户
7:Boss改号
8:扣费失败导致的服务取消
9:其他
integer
必须
ActionReasonID
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、对SP使用其企业代码,该设备编号由MISC分配,并且在同一设备类型中该编号唯一
user_id_schema(用户标识)描述
字段名称
字段类型
字段描述
UserIDType
integer
用户标识类型
1:用手机号标识
2:用伪码标识
3:两者同时标识
MSISDN
string
用户手机号
PseudoCode
binary
用户伪码
正向同步接口应答包消息定义
SyncOrderRelationResp消息字段描述:
返回值,主要错误如下:
0:成功
4007: MISC 同步开通服务,但SP 端已存在订购关系,且状态为开通
4008: MISC 同步开通服务,且SP 端不存在订购关系,但开通服务失败
4010: MISC 同步停止服务, 且SP 端存在订购关系, 但取消服务失败
4011: MISC 同步停止服务, 但SP 端不存在订购关系
4012: MISC 同步暂停服务, 且SP 端存在订购关系, 但暂停服务失败
4013: MISC 同步暂停服务, 但SP 端不存在订购关系
4015: MISC 同步激活服务, 但SP 端已存在订购关系, 且状态为开通
4016: MISC 同步激活服务, 但SP 端不存在订购关系
其它错误请参见《MISC系统短信SP接入指南-接口改造分册》。
integer
必须
hRet
该接口消息的版本号,本次所有的接口消息的版本都
为“”
string
必须
Version
该消息编号
string
必须
TransactionID
消息类型
string
必须
MsgType
说明
类型
重要性
字段名
正向订购、取消包示例
正向订购请求包
<?xml version="" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:xsi="