(售后服务)短消息信息服
务技术协议
中国移动通信
互联网短信网关接口协议
(ChinaMobilePeertoPeer,CMPP)
()
中国移动通信集团公司
2002年 4月
目录
前 言 4
1范围 5
2缩略语 5
3.网络结构 6
4.CMPP功能概述 7
5. 协议栈 8
6. 通信方式 9
长连接 9
短连接 11
本协议中涉及的端口号 12
交互过程中的应答方式 12
7.消息定义 13
基本数据类型 13
消息结构 13
消息头格式(Message Header)13
信息资源站实体(SP)与互联网短信网关(ISMG)间的消息定义 13
SP请求连接到 ISMG(CMPP_CONNECT)操作 13
SP或 ISMG请求拆除连接(CMPP_TERMINATE)操作 15
SP向 ISMG提交短信(CMPP_SUBMIT)操作 15
SP向 ISMG查询发送短信状态(CMPP_QUERY)操作 18
ISMG向 SP送交短信(CMPP_DELIVER)操作 19
向 ISMG发起删除短信(CMPP_CANCEL)操作 22
链路检测(CMPP_ACTIVE_TEST)操作 23
互联网短信网关(ISMG)之间的消息定义 23
源 ISMG请求连接到目的 ISMG(CMPP_CONNECT)操作 23
源 ISMG请求拆除到目的 ISMG的连接(CMPP_TERMINATE)操作 23
链路检测(CMPP_ACTIVE_TEST)操作 23
源 ISMG向目的 ISMG转发短信(CMPP_FWD)操作 23
互联网短信网关(ISMG)与汇接网关(GNS)之间的消息定义 28
ISMG请求连接到 GNS或 GNS请求连接到 ISMG(CMPP_CONNECT)操作 28
ISMG请求拆除到 GNS的连接或 GNS请求拆除到 ISMG的连接(CMPP_TERMINATE)操作 28
ISMG向汇接网关查询 MT路由(CMPP_MT_ROUTE)操作 28
ISMG向汇接网关查询 MO路由(CMPP_MO_ROUTE)操作 29
向汇接网关获取路由(CMPP_GET_ROUTE)操作 30
ISMG向汇接网关更新 MT路由(CMPP_MT_ROUTE_UPDATE)操作 31
ISMG向汇接网关更新 MO路由(CMPP_MO_ROUTE_UPDATE)操作 32
汇接网关向 ISMG更新 MT路由(CMPP_PUSH_MT_ROUTE_UPDATE)操作 33
汇接网关向 ISMG更新 MO路由(CMPP_PUSH_MO_ROUTE_UPDATE)操作 34
系统定义 35
Command_Id定义 35
附录 1 MO状态报告的产生 37
修订历史 39
前言
本规范为中国移动通信集团公司企业规范,简称 CMPP,现阶段版本是对 版修订后形成
的,为 版。本规范描述了中国移动短信业务中各网元(包括 ISMG、GNS和 SP)之间的相
关消息的类型和定义。根据业务的发展,规范中的信令操作和参数将会做进一步的调整和增
加。
本规范解释权属于中国移动通信集团公司。
本规范起草单位:中国移动通信集团公司研发中心。
本标准主要起草人:党京、孙若雯、于蓉蓉、袁向阳。
1 范围
本规范规定了以下三方面的内容:
(1) 信息资源站实体与互联网短信网关之间的接口协议;
(2) 互联网短信网关之间的接口协议;
(3) 互联网短信网关与汇接网关之间的接口协议。
本规范适用于各 SP和 ISMG的开发厂商。
2 缩略语
英文缩写 英文全称 说明
ISMG InternetShortMessageGateway 互联网短信网关
SMPP ShortMessagePeertoPeer 短消息点对点协议
CMPP ChinaMobilePeertoPeer 中国移动点对点协议
SMC ShortMessageCenter 短消息中心
GNS GatewayNameServer 网关名称服务器(汇接网关)
SP ServiceProvider 业务提供者,即信息资源站实体
SMC ShortMessageControl
SP为收取包月业务费用而向网关发送的消息,
网关收到后不送给用户仅产生相应的话单;
ISMG_Id 网关代码:0XYZ01~0XYZ99,其中 XYZ为省会
区号,位数不足时左补零,如北京编号为 1
的网关代码为 001001,江西编号为 1的网关
代码为 079101,依此类推。
SP_Id SP的企业代码:网络中SP地址和身份的标识、
地址翻译、计费、结算等均以企业代码为依
据。企业代码以数字表示,共 6位,从
“9XY000”至“9XY999”,其中“XY”为各移
动公司代码。
SP_Code SP的服务代码:服务代码是在使用短信方式
的点播类业务中,提供给用户点播的内容/应
用服务提供商代码。服务代码以数字表示,
全国业务服务代码长度统一为 4位,即
“1000”-“9999”;本地业务服务代码长度
统一为 5位,即“01000”-“09999”。
Service_I
d
SP的业务类型,数字、字母和符号的组合,
由 SP自定,如图片传情可定为 TPCQ,股票查
询可定义为 11。
3.网络结构
如图 1所示,互联网短信网关(ISMG)是外部信息资源站实体(SP)与移动网内短信中心之
间的中介实体,互联网短信网关一方面负责接收 SP发送给移动用户的信息和提交给短信中
心。另一方面,移动用户点播 SP业务的信息将由短信中心通过互联网短信网关发给 SP。另
外,为了减轻短信中心的信令负荷,互联网短信网关还应根据路由原则将 SP提交的信息转
发到相应的互联网短信网关。互联网短信网关通过向汇接网关(GNS)查询的方式获得网关
间的转发路由信息。
4.CMPP功能概述
CMPP协议主要提供以下两类业务操作:
(1) 短信发送(ShortMessageMobileOriginate,SMMO)
典型的业务操作举例如图 2所示:
1) 手机发出数据请求(可能是订阅信息或图片点播等),被源 ISMG接收;
2) 源 ISMG对接收到的信息返回响应;
3) 源 ISMG在本地查询不到要连接的 SP,向 GNS(汇接网关)发路由请求信息;
4) GNS将路由信息返回;
5) 源 ISMG根据路由信息将请求前转给目的 ISMG;
6) 目的 ISMG对接收到的信息返回响应;
7) 目的 ISMG将请求信息送 SP
8) SP返回响应;
在以上操作中,步骤 3到步骤 8均使用 CMPP协议;
在随后的操作中,目的 ISMG在接收到 SP的响应后将产生 MO状态报告发给源 ISMG。
(2) 短信接收(ShortMessageMobileTerminated,SMMT)
典型的业务操作举例如图 3所示:
6
4
1
源 ISMG 目的 ISMG
SMC SP
GNS(汇接网关)
3
5
7 82
1) SP发出数据请求(可能是短信通知或手机铃声等),被源 ISMG接收;
2) 源 ISMG对接收到的信息返回响应;
3) 源 ISMG在本地数据库中找不到要目的手机号段所对应网关代码,向 GNS(汇接网关)发
路由请求信息;
4) 汇接网关将路由信息返回;
5) 源 ISMG根据路由信息将请求前转给目的 ISMG;
6) 目的 ISMG对接收到的信息返回响应;
7) 目的 ISMG将请求信息发送至 SMC;
8) SMC向目的 ISMG返回响应;
在上述操作中,步骤 1到步骤 6均使用 CMPP协议;
在随后的操作中,SMC将通过 信令网向移动用户发送信息,移动用户收到后将返回状态
报告(Delivery-Receipt)给短信中心,短信中心将按照 MO操作的流程将状态报告返回给 SP
(如果 SP要求返回状态报告)。
5.协议栈
CMPP协议以 TCP/IP作为底层通信承载,具体结构由图 4所示:
6
4
1
源 ISMG 目的 ISMG
SP SMC
GNS(汇接网关)
2
3
5
7 8
图 4CMPP协议栈
6.通信方式
SP与 ISMG之间、ISMG之间进行信息交互时,可以采用长连接方式,也可以采用短连接方式。
所谓长连接,指在一个 TCP连接上可以连续发送多个数据包,在 TCP连接保持期间,如果没
有数据包发送,需要双方发链路检测包以维持此连接。短连接是指通信双方有数据交互时,
就建立一个 TCP连接,数据发送完成后,则断开此 TCP连接,即每次 TCP连接只完成一对 CMPP
消息的发送。
长连接
通信双方以客户-服务器方式建立 TCP连接,用于双方信息的相互提交。当信道上没有数据
传输时,通信双方应每隔时间 C发送链路检测包以维持此连接,当链路检测包发出超过时间
T后未收到响应,应立即再发送链路检测包,再连续发送 N-1次后仍未得到响应则断开此连
接。
参数 C、T、N原则上应可配置,现阶段建议取值为:C=3分钟,T=60秒,N=3。
网关与 SP之间、网关之间的消息发送后等待 T秒后未收到响应,应立即重发,再连续发送 N-1
次后仍未得到响应则停发。现阶段建议取值为:T=60秒,N=3。
消息采用并发方式发送,加以滑动窗口流量控制,窗口大小参数 W可配置,现阶段建
议为 16,即接收方在应答前一次收到的消息最多不超过 16条。
长连接的操作流程举例如图 5所示:
图 5长连接一次操作流程
短连接
通信双方以客户-服务器方式建立 TCP连接,应答与请求在同一个连接中完成。系统采用客
户/服务器模式,操作以客户端驱动方式发起连接请求,完成一次操作后关闭此连接。
网关与 SP之间、网关之间的消息发送后等待 T秒后未收到响应,应立即重发,再连续发送 N-1
次后仍未得到响应则停发。现阶段建议取值为:T=60秒,N=3。
短连接的操作流程举例如图 6所示:
CMPP 消息 1
服务器端
. . . . . .
建立 TC P 连接
对 CMPP 消息 2 的响应
服务器/客户端
图 6短连接的操作流程
本协议中涉及的端口号
端口号 应用
7890 长连接(SP与网关间)
7900 短连接(SP与网关间或网关之间)
7930 长连接(网关之间)
9168 短连接(短信网关与汇接网关之间)
交互过程中的应答方式
在 SP与 ISMG之间、SMC与 ISMG之间及 ISMG之间的交互过程中均采用异步方式,即任一个
网元在收到请求消息后应立即回送响应消息。举例如图 7所示:
图 7异步交互方式示意图
7.消息定义
基本数据类型
UnsignedInteger 无符号整数
Integer 整数,可为正整数、负整数或零
OctetString 定长字符串,位数不足时,如果左补 0则补 ASCII表示的
零,如果右补 0则补二进制的零
消息结构
项目 说明
MessageHeader 消息头(所有消息公共包头)
MessageBody 消息体
消息头格式(MessageHeader)
字段名 字节数 类型 描述
Total_Length 4 Unsigned 消息总长度(含消息头及消息体)
SP
CMPP 请求消息
CMPP 响应消息
Integer
Command_Id 4 Unsigned
Integer
命令或响应类型
Sequence_Id 4 Unsigned
Integer
消息流水号,顺序累加,步长为 1,循环使用
(一对请求和应答消息的流水号必须相同)
信息资源站实体(SP)与互联网短信网关(ISMG)间的消息定义
SP与 ISMG之间互为客户/服务器,但要求 SP首先以客户的身份请求连接到 ISMG,之后 SP
与 ISMG之间方可进行数据传输。
请求连接到 ISMG(CMPP_CONNECT)操作
CMPP_CONNECT操作的目的是 SP向 ISMG注册作为一个合法 SP身份,若注册成功后即建立了
应用层的连接,此后 SP可以通过此 ISMG接收和发送短信。
ISMG以 CMPP_CONNECT_RESP消息响应 SP的请求。
_CONNECT消息定义(SPISMG)
字段名 字节数 属性 描述
Source_Addr 6 OctetStrin
g
源地址,此处为 SP_Id,即 SP的企业
代码。
AuthenticatorSour
ce
16 OctetStrin
g
用于鉴别源地址。其值通过单向
MD5hash计算得出,表示如下:
AuthenticatorSource=
MD5( Source_Addr+9字 节 的
0+sharedsecret+timestamp)
Sharedsecret由中国移动与源地址
实体事先商定,timestamp格式为:
MMDDHHMMSS,即月日时分秒,10位。
Version 1 UnsignedIn
teger
双方协商的版本号(高位 4bit表示主
版本号,低位 4bit表示次版本号)
Timestamp 4 UnsignedInt
eger
时间戳的明文,由客户端产生,格式为
MMDDHHMMSS,即月日时分秒,10位数
字的整型,右对齐。
_CONNECT_RESP消息定义(ISMGSP)
字段名 字节数 属性 描述
Status 1 UnsignedInt
eger
状态
0:正确
1:消息结构错
2:非法源地址
3:认证错
4:版本太高
5~:其他错误
AuthenticatorISMG 16 OctetString ISMG认证码,用于鉴别 ISMG。
其值通过单向 MD5hash计算得出,表
示如下:
AuthenticatorISMG=MD5
( Status+AuthenticatorSource+sh
aredsecret),Sharedsecret由中国
移 动 与 源 地 址 实 体 事 先 商 定 ,
AuthenticatorSource为源地址实体
发 送 给 ISMG的 对 应 消 息
CMPP_Connect中的值。
认证出错时,此项为空。
Version 1 UnsignedIn
teger
服务器支持的最高版本号
或 ISMG请求拆除连接(CMPP_TERMINATE)操作
CMPP_TERMINATE操作的目的是 SP或 ISMG基于某些原因决定拆除当前的应用层连接而发起的
操作。此操作完成后 SP与 ISMG之间的应用层连接被释放,此后 SP若再要与 ISMG通信时应
发起 CMPP_CONNECT操作。
ISMG或 SP以 CMPP_TERMINATE_RESP消息响应请求。
_TERMINATE消息定义(SPISMG或 ISMGSP)
无消息体。
_TERMINATE_RESP消息定义(SPISMG或 ISMGSP)
无消息体。
向 ISMG提交短信(CMPP_SUBMIT)操作
CMPP_SUBMIT操作的目的是 SP在与 ISMG建立应用层连接后向 ISMG提交短信。
ISMG以 CMPP_SUBMIT_RESP消息响应。
_SUBMIT消息定义(SPISMG)
字段名 字节数 属性 描述
Msg_Id 8 UnsignedIn
teger
信息标识,由 SP侧短信网关本身产生,
本处填空。
Pk_total 1 UnsignedIn
teger
相同 Msg_Id的信息总条数,从 1开始
Pk_number 1 UnsignedIn
teger
相同 Msg_Id的信息序号,从 1开始
Registered_D
elivery
1 UnsignedIn
teger
是否要求返回状态确认报告:
0:不需要
1:需要
2:产生 SMC话单
(该类型短信仅供网关计费使用,不发送
给目的终端)
Msg_level 1 UnsignedIn
teger
信息级别
Service_Id 10 OctetStrin
g
业务类型,是数字、字母和符号的组合。
Fee_UserType 1 UnsignedIn
teger
计费用户类型字段
0:对目的终端 MSISDN计费;
1:对源终端 MSISDN计费;
2:对 SP计费;
3:表示本字段无效,对谁计费参见
Fee_terminal_Id 字段。
Fee_terminal
_Id
21 UnsignedIn
teger
被计费用户的号码(如本字节填空,则表
示 本 字 段 无 效 , 对 谁 计 费 参 见
Fee_UserType字 段 , 本 字 段 与
Fee_UserType字段互斥)
TP_pId 1 UnsignedInt
eger
GSM协议类型。详细是解释请参考
中的
TP_udhi 1 UnsignedInt
eger
GSM协议类型。详细是解释请参考
中的 ,仅使用 1位,右
对齐
Msg_Fmt 1 UnsignedIn
teger
信息格式
0:ASCII串
3:短信写卡操作
4:二进制信息
8:UCS2编码
15:含 GB汉字。。。。。。
Msg_src 6 OctetString 信息内容来源(SP_Id)
FeeType 2 OctetString 资费类别
01:对“计费用户号码”免费
02:对“计费用户号码”按条计信息费
03:对“计费用户号码”按包月收取信息
费
04:对“计费用户号码”的信息费封顶
05:对“计费用户号码”的收费是由 SP
实现
FeeCode 6 OctetString 资费代码(以分为单位)
ValId_Time 17 OctetString 存活有效期,格式遵循 协议
At_Time 17 OctetString 定时发送时间,格式遵循 协议
Src_Id 21 OctetString 源号码
SP的服务代码或前缀为服务代码的长号
码,网关将该号码完整的填到 SMPP协议
Submit_SM消息相应的source_addr字段,
该号码最终在用户手机上显示为短消息
的主叫号码
DestUsr_tl 1 UnsignedInt
eger
接收信息的用户数量(小于 100个用户)
Dest_terminal_
Id
21*DestUsr_tl OctetString 接收短信的 MSISDN号码
Msg_Length 1 UnsignedInt
eger
信息长度(Msg_Fmt值为 0时:<160个字
节;其它<=140个字节)
Msg_Content Msg_length OctetString 信息内容
Reserve 8 OctetString 保留
注意:关于短信群发的问题,若 SP对于群发消息不要求状态报告的回送时,才可以考虑群
发,否则必须逐条发送。
_SUBMIT_RESP消息定义(ISMGSP)
字段名 字节数 属性 描述
Msg_Id 8 UnsignedI
nteger
信息标识,生成算法如下:
采用 64位(8字节)的整数:
(1)时间(格式为 MMDDHHMMSS,即月日
时分秒):bit64~bit39,其中
bit64~bit61:月份的二进制表示;
bit60~bit56:日的二进制表示;
bit55~bit51:小时的二进制表示;
bit50~bit45:分的二进制表示;
bit44~bit39:秒的二进制表示;
(2)短信网关代码:bit38~bit17,把短
信网关的代码转换为整数填写到该字段
中。
(3)序列号:bit16~bit1,顺序增加,
步长为 1,循环使用。
各部分如不能填满,左补零,右对齐。
(SP根据请求和应答消息的 Sequence_Id
一致性就可得到 CMPP_Submit消息的
Msg_Id)
Result 1 Unsigned
Integer
结果
0:正确
1:消息结构错
2:命令字错
3:消息序号重复
4:消息长度错
5:资费代码错
6:超过最大信息长
7:业务代码错
8:流量控制错
9~:其他错误
向 ISMG查询发送短信状态(CMPP_QUERY)操作
CMPP_QUERY操作的目的是 SP向 ISMG查询某时间的业务统计情况,可以按总数或按业务代码
查询。ISMG以 CMPP_QUERY_RESP应答。
_QUERY消息的定义(SPISMG)
字段名 字节数 属性 描述
Time 8 OctetString 时间 YYYYMMDD(精确至日)
Query_Type 1 UnsignedIn
teger
查询类别
0:总数查询
1:按业务类型查询
Query_Code 10 OctetString 查询码
当 Query_Type为 0时,此项无效;当
Query_Type为 1时,此项填写业务类型
Service_Id.
Reserve 8 OctetString 保留
_QUERY_RESP消息的定义(ISMGSP)
字段名 字节数 属性 描述
Time 8 OctetString 时间(精确至日)
Query_Type 1 UnsignedInt
eger
查询类别
0:总数查询
1:按业务类型查询
Query_Code 10 OctetString 查询码
MT_TLMsg 4 UnsignedInt
eger
从 SP接收信息总数
MT_Tlusr 4 UnsignedInt
eger
从 SP接收用户总数
MT_Scs 4 UnsignedInt
eger
成功转发数量
MT_WT 4 UnsignedInt
eger
待转发数量
MT_FL 4 UnsignedInt
eger
转发失败数量
MO_Scs 4 UnsignedInt
eger
向 SP成功送达数量
MO_WT 4 UnsignedInt
eger
向 SP待送达数量
MO_FL 4 UnsignedInt
eger
向 SP送达失败数量
向 SP送交短信(CMPP_DELIVER)操作
CMPP_DELIVER操作的目的是 ISMG把从短信中心或其它 ISMG转发来的短信送交 SP,SP以
CMPP_DELIVER_RESP消息回应。
_DELIVER消息定义(ISMGSP)
字段名 字节数 属性 描述
Msg_Id 8 UnsignedInteger 信息标识
生成算法如下:
采用 64位(8字节)的整数:
(1)时间(格式为 MMDDHHMMSS,即
月日时分秒):bit64~bit39,其中
bit64~bit61:月份的二进制表示;
bit60~bit56:日的二进制表示;
bit55~bit51:小时的二进制表示;
bit50~bit45:分的二进制表示;
bit44~bit39:秒的二进制表示;
(2)短信网关代码:bit38~bit17,
把短信网关的代码转换为整数填写
到该字段中。
(3)序列号:bit16~bit1,顺序增
加,步长为 1,循环使用。
各部分如不能填满,左补零,右对
齐。
Dest_Id 21 OctetString 目的号码
SP的服务代码,一般 4--6位,或者
是前缀为服务代码的长号码;该号
码是手机用户短消息的被叫号码。
Service_Id 10 OctetString 业务类型,是数字、字母和符号的
组合。
TP_pid 1 UnsignedInteger GSM协议类型。详细解释请参考
中的
TP_udhi 1 UnsignedInteger GSM协议类型。详细解释请参考
中的 ,仅使用 1
位,右对齐
Msg_Fmt 1 UnsignedInteg
er
信息格式
0:ASCII串
3:短信写卡操作
4:二进制信息
8:UCS2编码
15:含 GB汉字
Src_terminal_Id 21 OctetString 源终端 MSISDN号码(状态报告时填
为 CMPP_SUBMIT消息的目的终端号
码)
Registered_Deliv
ery
1 UnsignedInteg
er
是否为状态报告
0:非状态报告
1:状态报告
Msg_Length 1 UnsignedInteg
er
消息长度
Msg_Content Msg_lengt
h
OctetString 消息内容
Reserved 8 OctetString 保留项
当 ISMG向 SP送交状态报告时,信息内容字段(Msg_Content)格式定义如下:
字段名 字节数 属性 描述
Msg_Id 8 UnsignedInt
eger
信息标识
SP提交短信(CMPP_SUBMIT)操作时,与 SP相
连的 ISMG产生的 Msg_Id。
Stat 7 OctetString 发送短信的应答结果,含义与 SMPP协议要求中
stat字段定义相同,详见表一。SP根据该字段
确定 CMPP_SUBMIT消息的处理状态。
Submit_time 10 OctetString YYMMDDHHMM(YY为年的后两位 00-99,MM:
01-12,DD:01-31,HH:00-23,MM:00-59)
Done_time 10 OctetString YYMMDDHHMM
Dest_terminal_
Id
21 OctetString 目的终端 MSISDN号码(SP发送 CMPP_SUBMIT消
息的目标终端)
SMSC_sequence 4 UnsignedInt
eger
取自 SMSC发送状态报告的消息体中的消息标
识。
表一 Stat字段定义
MessageState FinalMessageStates Description
DELIVERED DELIVRD Messageisdeliveredtodestinati
on
EXPIRED EXPIRED Messagevalidityperiodhas
expired
DELETED DELETED Messagehasbeendeleted.
UNDELIVERABLE UNDELIV Messageisundeliverable
ACCEPTED ACCEPTD Messageisinacceptedstate(.
hasbeenmanuallyreadonbehalfof
thesubscriberbycustomerservic
e)
UNKNOWN UNKNOWN Messageisininvalidstate
REJECTED REJECTD Messageisinarejectedstate
注意:
1.其中 ACCEPTED为中间状态,网关若从短信中心收到后应丢弃,不做任何操作。
2.Stat字段长度为 7个字节,填写时应填表一中 FinalMessageStates中的缩写形式,如
状态为 DELIVERED时填写 DELIVRD,依此类推。
3.SP等待状态报告缺省时间为 48小时。
_DELIVER_RESP消息定义(SPISMG)
字段名 字节数 属性 描述
Msg_Id 8 UnsignedInteger 信息标识
(CMPP_DELIVER中的Msg_Id字段)
Result 1 UnsignedInteg
er
结果
0:正确
1:消息结构错
2:命令字错
3:消息序号重复
4:消息长度错
5:资费代码错
6:超过最大信息长
7:业务代码错
8:流量控制错
9~:其他错误
SP向 ISMG发起删除短信(CMPP_CANCEL)操作
CMPP_CANCEL操作的目的是 SP通过此操作可以将已经提交给 ISMG的短信删除,ISMG将以
CMPP_CANCEL_RESP回应删除操作的结果。
_CANCEL消息定义(SPISMG)
字段名 字节数 属性 描述
Msg_Id 8 Unsigne
dIntege
r
信息标识(SP想要删除的信息标识)
_CANCEL_RESP消息定义(ISMGSP)
字段名 字节数 属性 描述
Success_Id 1 Unsigne
dIntege
r
成功标识
0:成功
1:失败
链路检测(CMPP_ACTIVE_TEST)操作
本操作仅适用于通信双方采用长连接通信方式时用于保持连接。
_ACTIVE_TEST定义(SPISMG或 ISMGSP)
无消息体。
_ACTIVE_TEST_RESP定义(SPISMG或 ISMGSP)
字段名 字节数 属性 描述
Reserved 1
互联网短信网关(ISMG)之间的消息定义
网关之间互为客户/服务器,任一方都可在需要时建立连接进行数据传输。
源 ISMG请求连接到目的 ISMG(CMPP_CONNECT)操作
消息定义同 和 所述。其中 Source_Addr填源网关代码。
源 ISMG请求拆除到目的 ISMG的连接(CMPP_TERMINATE)操作
消息定义同 和 所述。
链路检测(CMPP_ACTIVE_TEST)操作
本操作仅用于通信双方采用长连接通信方式时保持连接。消息定义同 和 所
述。
源 ISMG向目的 ISMG转发短信(CMPP_FWD)操作
CMPP_FWD操作的目的是源 ISMG可以根据一定的路由策略将 SP提交的短信、MO状态报告、
短信中心产生的状态报告、用户提交的短信转发到目的 ISMG,目的 ISMG以 CMPP_FWD_RESP
回应。
_FWD定义(ISMGISMG)
字段名 字节数 属性 描述
Source_Id 6 OctetStri
ng
源网关的代码(右对齐,左补 0)
Destination_Id 6 OctetStri
ng
目的网关代码(右对齐,左补 0)
NodesCount 1 UnsignedI
nteger
经过的网关数量
Msg_Fwd_Type 1 UnsignedI
nteger
前转的消息类型
0:MT前转
1:MO前转
2:MT时的状态报告
3:MO时的状态报告
Msg_Id 8 UnsignedI
nteger
信息标识
Pk_total 1 Unsigned
Integer
相同 Msg_Id的消息总条数,从 1开始
Pk_number 1 Unsigned
Integer
相同 Msg_Id的消息序号,从 1开始
Registered_De
livery
1 Unsigned
Integer
是否要求返回状态确认报告
0:不需要
1:需要
2:产生 SMC话单
Msg_level 1 Unsigned
Integer
信息级别
Service_Id 10 OctetStri
ng
业务类型
Fee_UserType 1 Unsigned
Integer
计费用户类型字段
0:对目的终端 MSISDN计费;
1:对源终端 MSISDN计费;
2:对 SP计费;
3:表示本字段无效,对谁计费参见
Fee_terminal_Id 字段。
Fee_terminal_
Id
21 Unsigned
Integer
被计费用户的号码(如本字节填空,则
表示本字段无效,对谁计费参见
Fee_UserType字 段 。 本 字 段 与
Fee_UserType字段互斥)
TP_pid 1 UnsignedI
nteger
GSM协 议 类 型 。 详 细 解 释 请 参 考
中的
TP_udhi 1 UnsignedI
nteger
GSM协 议 类 型 。 详 细 解 释 请 参 考
中的 ,仅使用 1位,
右对齐
Msg_Fmt 1 UnsignedI
nteger
信息格式
0:ASCII串
3:短信写卡操作
4:二进制信息
8:UCS2编码
15:含 GB汉字
Msg_src 6 OctetStri
ng
信息内容来源(SP_Id,SP的企业代码)
FeeType 2 OctetStri
ng
资费类别
00:“短消息类型”为“发送”,对“计
费用户号码”不计信息费,此类
话单仅用于核减 SP对称的信道费
01:对“计费用户号码”免费
02:对“计费用户号码”按条计信息
费
03:对“计费用户号码”按包月收取
信息费
04:对“计费用户号码”的信息费封
顶
05:对“计费用户号码”的收费是由 SP
实现
FeeCode 6 OctetStri
ng
资费代码(以分为单位)
Valid_Time 17 OctetStri
ng
有效期
At_Time 17 OctetStri
ng
定时发送的时间
Src_Id 21 OctetStri
ng
源号码
1. MT时 为 SP的 服 务 代 码 , 即
CMPP_SUBMIT消息中的 Src_Id。
2. MO时为发送此消息的源终端
MSISDN号码。
3. MT状态报告时,可填空或填接收到
短信的终端 MSISDN号码,即对应
CMPP_SUBMIT消 息 中 的
Dest_Terminal_Id。
4. MO状态报告时,可填空或填 SP的
服 务 代 码 , 即 CMPP_DELIVER中 的
Dest_Id。
DestUsr_tl 1 UnsignedI
nteger
接收消息的用户数量
Dest_Id 21*DestUsr_tl OctetStri
ng
目的号码
1.MT转发时为目的终端 MSISDN号码,
即 对 应 CMPP_SUBMIT消 息 中 的
Dest_Terminal_Id。
2.MO转发时为 SP的服务代码,一般
4--6位,或者是前缀为服务代码的长号
码,该号码是手机用户短消息的被叫号
码。
3.MT状态报告时,可填空或填目的 SP
的服务代码,即 CMPP_SUBMIT消息中的
Src_Id。
4.MO状态报告时,可填空或填发送短
信的移动用户 MSISDN号码。
Msg_Length 1 UnsignedI
nteger
消息长度
Msg_Content Msg_length OctetStri
ng
消息内容
Reserve 8 保留
注意:
1.对于包月的 SMC消息,应由 ISMG向 SP返回成功与否的状态报告,格式同 定义,
若成功回送 Stat值为“DELIVRD”,失败则回送 Stat值“UNDELIV”。
2.当转发消息为 MO状态报告( MO状态报告的产生见附录 1)时,信息内容字段
(Msg_Content)格式定义如下:
字段名 字节数 属性 描述
Msg_Id 8 UnsignedI
nteger
信息标识
给SP的CMPP_Deliver消息中的Msg_Id,
与源网关转发 MO消息时产生的 Msg_Id
相同。
Stat 7 OctetStri
ng
SP的应答结果,CMPP_DELIVER_RESP中
Result为 0时,填字符 DELIVRD,其余
值填 REJECTD。
CMPP_DELIVER_ti
me
10 OctetStri
ng
YYMMDDHHMM(YY为年的后两位 00-99,
MM:01-12,DD:01-31,HH:00-23,
MM:00-59)
注:短信网关发出 CMPP_DELIVER的时
间。
CMPP_DELIVER_RE
SP_time
10 OctetStri
ng
YYMMDDHHMM
注:短信网关收到 CMPP_DELIVER_RESP
的时间。
Dest_Id 21 Reserved 目的 SP的服务代码,左对齐。
Reserved 4
注意:
在 MO流程中,若短信经 ISMG2转发给与 SP相连的 ISMG1,ISMG1在给 SP发送消息时可能存
在四种情况:①发送消息前连接断开;②多次发送消息后没有接收到响应消息;③发送消息
后接收到错误的响应消息;④发送消息后接收到正确的应答消息。对这四种情况的处理描述
如下:
①②③:ISMG1在处理这三种情况的时候,向 ISMG2发送 MO状态报告,状态报告中的 stat
字段取值为“REJECTD”。
④:ISMG1在处理这种情况时,向 ISMG2发送 MO状态报告,其中 stat字段取值“DELIVRD”。
3.当转发消息为 MT状态报告时,信息内容字段(Msg_Content)格式同 定义。若 SP
发送的短信经由 ISMG1转发给 ISMG2,ISMG1给 ISMG2发送消息时可能存在四种情况:①发
送消息前连接断开;②多次发送消息后没有接收到响应消息;③发送消息后接收到错误的响
应消息;④发送消息后接收到正确的应答消息。对这四种情况的处理描述如下:
①②③:ISMG1在处理这三种情况的时候,向 SP发送 MT状态报告(如果 SP要求状态报告),
状态报告中的 stat字段取值为“REJECTD”。
④:ISMG1在处理这种情况时,继续等待 ISMG2返回状态报告。
随后,ISMG2给 SMC发送消息时可能存在四种情况:①发送消息前连接断开;②多次发送消
息后没有接收到响应消息;③发送消息后接收到错误的响应消息;④发送消息后接收到正确
的应答消息。对这四种情况的处理描述如下:
①②③:ISMG2在处理这三种情况的时候,向 SP发送 MT状态报告(如果 SP要求状态报告),
状态报告中的 stat字段取值为“REJECTD”。
④:ISMG2在处理这种情况时,继续等待 SMC返回状态报告。
_FWD_RESP定义(ISMGISMG)
字段名 字节数 属性 描述
Msg_Id 8 UnsignedI
nteger
信息标识(CMPP_FWD中字段值)
Pk_total 1 Unsigned
Integer
相同 Msg_Id的消息总条数
Pk_number 1 Unsigned
Integer
相同 Msg_Id的消息序号
Result 1 UnsignedI
nteger
结果
0:正确
1:消息结构错
2:命令字错
3:消息序号重复
4:消息长度错
5:资费代码错
6:超过最大信息长
7:业务代码错
8:流量控制错
9:前转判断错(此 SP不应发往本 ISMG)
10~:其他错误
互联网短信网关(ISMG)与汇接网关(GNS)之间的消息定义
要求 ISMG与 GNS在信息交互时使用短连接的通信方式。ISMG与 GNS可互为客户/服务器。
请求连接到 GNS或 GNS请求连接到 ISMG(CMPP_CONNECT)操作
消息定义同 和 所述,其中 Source_Addr填源网关代码,可能是 ISMG代码
或 GNS代码。
请求拆除到 GNS的连接或 GNS请求拆除到 ISMG的连接(CMPP_TERMINATE)操作
消息定义同 和 所述。
向汇接网关查询 MT路由(CMPP_MT_ROUTE)操作
CMPP_MT_ROUTE操作用于 ISMG不知道需要转发 MT消息的路由时查询 GNS。 GNS以
CMPP_MT_ROUTE_RESP应答。
_MT_ROUTE消息定义(ISMGGNS)
字段名 字节数 属性 描述
Source_Id 6 OctetString 源网关代码
Terminal_Id 21 OctetString 目的终端 MSISDN号码
_MT_ROUTE_RESP消息定义(GNSISMG)
字段名 字节数 属性 描述
Route_Id 4 UnsignedInteg
er
路由编号(从 0开始,由 GNS统一分配)
Destination_Id 6 OctetString 目标网关代码
Gateway_IP 15 OctetString 目标网关 IP地址
Gateway_port 2 UnsignedInteg
er
目标网关 IP端口(7890或 7900)
Start_Id 6 OctetString MT路由起始号码段
End_Id 6 OctetString MT路由截止号码段
Area_code 4 OctetString 手机所属省代号
Result 1 UnsignedInteg
er
结果
0:正常
1:没有匹配路由
2:这是最后 1条路由
向汇接网关查询 MO路由(CMPP_MO_ROUTE)操作
CMPP_MO_ROUTE操作的目的是使 ISMG当不知道需要转发 MO消息的路由时可向 GNS查询得到。
GNS以 CMPP_MO_ROUTE_RESP应答。
_MO_ROUTE消息定义(ISMGGNS)
字段名 字节数 属性 描述
Source_Id 6 OctetString 源网关代码
SP_Code 21 OctetString SP的服务代码
Service_Id 10 OctetString 请求的业务类型(此项适合全网服务内容,
如爱心卡图片传情)
Service_Code 4 UnsignedInteg
er
请求的业务代码
(如果未置 Service_Id字段,此字段为
空,如爱心卡图片传情 TPCQ1000—2000
对应某个网站的某些相应图片)
_MO_ROUTE_RESP消息定义(GNSISMG)
字段名 字节数 属性 描述
Route_Id 4 UnsignedInteg
er
路由编号
Destination_Id 6 OctetString 目标网关代码
Gateway_IP 15 OctetString 目标网关 IP地址
Gateway_port 2 UnsignedInteg
er
目标网关 IP端口
SP_Id 21 OctetString SP的企业代码
Start_code 4 UnsignedInteg
er
MO路由起始业务代码
(如果未置请求的 Service_Id字段,此
字段为空)
End_code 4 UnsignedInteg MO路由截止业务代码
er (如果未置请求的 Service_Id字段,此
字段为空)
Result 1 UnsignedInteg
er
结果
0:正常
1:没有匹配路由
2:这是最后 1条路由
向汇接网关获取路由(CMPP_GET_ROUTE)操作
CMPP_GET_ROUTE操作的目的是使 ISMG可向 GNS查询 MO或 MT时的路由信息。 GNS以
CMPP_GET_ROUTE_RESP消息回应。
_GET_ROUTE消息定义(ISMGGNS)
字段名 字节数 属性 描述
Source_Id 6 OctetString 源网关代码
Route_type 2 OctetString 路由类型
MO:MO路由
MT:MT路由
Last_route_Id 4 Integer 已经接收的上一条路由编号
(第 1次发送此请求时 Last_route_Id=
-1)
_GET_ROUTE_RESP消息定义(GNSISMG)
字段名 字节数 属性 描述
Route_Id 4 UnsignedInteg
er
路由编号
Destination_Id 6 OctetString 目标网关代码
Gateway_IP 15 OctetString 目标网关 IP地址
Gateway_port 2 UnsignedInteg
er
目标网关 IP端口
SP_Code 21 OctetString SP的服务代码
(请求的路由类型=MT时,此字段为空)
Service_Id 10 OctetString 请求的业务类型
(此项适合全网服务内容,如爱心卡图片
传情)
Start_code 4 UnsignedInteg 请求的路由类型=MO时:
er 起始业务代码(如果未置 Service_Id字
段,此字段为空)
请求的路由类型=MT时:
手机号码段的起始号码
End_code 4 UnsignedInteg
er
请求的路由类型=MO时:
截止业务代码(如果未置 Service_Id字
段,此字段为空)
请求的路由类型=MT时:
手机号码段的截止号码
Area_code 4 OctetString 手机所属省代码
(请求的路由类型=MO时,此字段为空)
Result 1 UnsignedInteg
er
结果
0:正常
1:没有匹配路由
2:这是最后 1条路由
向汇接网关更新 MT路由(CMPP_MT_ROUTE_UPDATE)操作
CMPP_MT_ROUTE_UPDATE操 作 的 目 的 是 使 ISMG可 向 GNS更 新 MT路 由 信 息 。 GNS以
CMPP_MT_ROUTE_UPDATE_RESP消息回应。
_MT_ROUTE_UPDATE消息定义(ISMGGNS)
字段名 字节数 属性 描述
Update_type 1 UnsignedInteg
er
0:添加
1:删除
2:更新
Route_Id 4 UnsignedInteg
er
路由编号
(若 update_type为 0,即添加时,此字
段为零)
Destination_Id 6 OctetString 目标网关代码
Gateway_IP 15 OctetString 目标网关 IP地址
Gateway_port 2 UnsignedInteg
er
目标网关 IP端口
Start_Id 6 OctetString MT路由起始号码段
End_Id 6 OctetString MT路由截止号码段
Area_code 4 OctetString 手机所属省代码
_MT_ROUTE_UPDATE_RESP消息定义(GNSISMG)
字段名 字节数 属性 描述
Result 1 UnsignedInteg
er
0:数据合法,等待核实
1:数据不合法
向汇接网关更新 MO路由(CMPP_MO_ROUTE_UPDATE)操作
CMPP_MO_ROUTE_UPDATE操 作 的 目 的 是 使 ISMG可 向 GNS更 新 MO路 由 信 息 。 GNS以
CMPP_MO_ROUTE_UPDATE_RESP消息回应。
_MO_ROUTE_UPDATE消息定义(ISMGGNS)
字段名 字节数 属性 描述
Update_type 1 UnsignedInteg
er
0:添加
1:删除
2:更新
Route_Id 4 UnsignedInteg
er
路由编号
(若 update_type为 0,即添加时,此字
段为零)
Destination_Id 6 OctetString 目标网关代码
Gateway_IP 15 OctetString 目标网关 IP地址
Gateway_port 2 UnsignedInteg
er
目标网关 IP端口
SP_Code 21 OctetString SP的服务号码
Service_Id 10 OctetString 请求的业务类型(此项适合全网服务内容,
如爱心卡图片传情,如该路由不包含此业
务,此字段为空)
Start_code 4 UnsignedInteg
er
MO路由起始业务代码(如果未置请求的
Service_Id字段,此字段为空)
End_code 4 UnsignedInteg
er
MO路由截止业务代码(如果未置请求的
Service_Id字段,此字段为空)
_MO_ROUTE_UPDATE_RESP消息定义(GNSISMG)
字段名 字节数 属性 描述
Result 1 UnsignedInteg
er
0:数据合法,等待核实
1:数据不合法
汇接网关向 ISMG更新 MT路由(CMPP_PUSH_MT_ROUTE_UPDATE)操作
CMPP_PUSH_MT_ROUTE_UPDATE操作的目的是使 GNS可向 ISMG更新 MT路由信息。ISMG以
CMPP_PUSH_MT_ROUTE_UPDATE_RESP消息回应。
_PUSH_MT_ROUTE_UPDATE消息定义(GNSISMG)
字段名 字节数 属性 描述
Update_type 1 UnsignedInteg
er
0:添加;
1:删除;
2:更新
Route_Id 4 UnsignedInteg
er
路由编号
Destination_Id 6 OctetString 目标网关代码
Gateway_IP 15 OctetString 目标网关 IP地址
Gateway_port 2 UnsignedInteg
er
目标网关 IP端口
Start_Id 6 OctetString MT路由起始号码段
End_Id 6 OctetString MT路由截止号码段
Area_code 4 OctetString 手机所属省代码
_PUSH_MT_ROUTE_UPDATE_RESP消息定义(ISMGGNS)
字段名 字节数 属性 描述
Result 1 UnsignedInteg
er
0:成功更改
1:更改失败
汇接网关向 ISMG更新 MO路由(CMPP_PUSH_MO_ROUTE_UPDATE)操作
CMPP_PUSH_MO_ROUTE_UPDATE操作的目的是使 GNS可向 ISMG更新 MO路由信息。ISMG以
CMPP_PUSH_MO_ROUTE_UPDATE_RESP消息回应。
_PUSH_MO_ROUTE_UPDATE消息定义(GNSISMG)
字段名 字节数 属性 描述
Update_type 1 UnsignedInteg
er
0:添加;
1:删除;
2:更新
Route_Id 4 UnsignedInteg
er
路由编号
Destination_Id 6 OctetString 目标网关代码
Gateway_IP 15 OctetString 目标网关 IP地址
Gateway_port 2 UnsignedInteg
er
目标网关 IP端口
SP_Code 21 OctetString SP的服务号码
Service_Id 10 OctetString 请求的业务类型(此项适合全网服务内容,
如爱心卡图片传情,如该路由不包含此业
务,此字段为空)
Start_code 4 UnsignedInteg
er
MO路由起始业务代码(如果未置请求的
Service_Id字段,此字段为空)
End_code 4 UnsignedInteg
er
MO路由截止业务代码(如果未置请求的
Service_Id字段,此字段为空)
_PUSH_MO_ROUTE_UPDATE_RESP消息定义(ISMGGNS)
字段名 字节数 属性 描述
Result 1 Unsigned
Integer
0:成功更改
1:更改失败
系统定义
_Id定义
消息 Command_Id值 说明
CMPP_CONNECT 0x00000001 请求连接
CMPP_CONNECT_RESP 0x80000001 请求连接应答
CMPP_TERMINATE 0x00000002 终止连接
CMPP_TERMINATE_RESP 0x80000002 终止连接应答
CMPP_SUBMIT 0x00000004 提交短信
CMPP_SUBMIT_RESP 0x80000004 提交短信应答
CMPP_DELIVER 0x00000005 短信下发
CMPP_DELIVER_RESP 0x80000005 下发短信应答
CMPP_QUERY 0x00000006 发送短信状态查询
CMPP_QUERY_RESP 0x80000006 发送短信状态查询应答
CMPP_CANCEL 0x00000007 删除短信
CMPP_CANCEL_RESP 0x80000007 删除短信应答
CMPP_ACTIVE_TEST 0x00000008 激活测试
CMPP_ACTIVE_TEST_RESP 0x80000008 激活测试应答
CMPP_FWD 0x00000009 消息前转
CMPP_FWD_RESP 0x80000009 消息前转应答
CMPP_MT_ROUTE 0x00000010 MT路由请求
CMPP_MT_ROUTE_RESP 0x80000010 MT路由请求应答
CMPP_MO_ROUTE 0x00000011 MO路由请求
CMPP_MO_ROUTE_RESP 0x80000011 MO路由请求应答
CMPP_GET_ROUTE 0x00000012 获取路由请求
CMPP_GET_ROUTE_RESP 0x80000012 获取路由请求应答
CMPP_MT_ROUTE_UPDATE 0x00000013 MT路由更新
CMPP_MT_ROUTE_UPDATE_RESP 0x80000013 MT路由更新应答
CMPP_MO_ROUTE_UPDATE 0x00000014 MO路由更新
CMPP_MO_ROUTE_UPDATE_RESP 0x80000014 MO路由更新应答
CMPP_PUSH_MT_ROUTE_UPDATE 0x00000015 MT路由更新
CMPP_PUSH_MT_ROUTE_UPDATE_RESP 0x80000015 MT路由更新应答
CMPP_PUSH_MO_ROUTE_UPDATE 0x00000016 MO路由更新
CMPP_PUSH_MO_ROUTE_UPDATE_RESP 0x80000016 MO路由更新应答
附录 1MO状态报告的产生
为解决 MO业务计费及使源网关获知 SP对转发的 MO消息的接收状态,现要求网关处理流程
如下图所示:
附录 1-图 1MO状态报告的产生
1. 用户提交短信到 SMSC;
2. SMSC给用户返回提交短信的应答,让用户知道短信发送成功与否,如果该处失败,则 SMSC
不再进行下述的流程;
3. SMSC通过 SMPP消息 DELIVER_SM把短信发送给 ISMG1;
4. ISMG1以 DELIVER_SM_RESP消息应答给 SMSC;
5. ISMG1根据用户发送的短消息中目的 SP服务代码查询路由后转发给 ISMG2;
6. ISMG2发送 CMPP_FWD_RESP消息应答;
7. SP对 ISMG2将用户的短信提交给 SP;
8. ISMG2发送提交应答;
9. 为保证 ISMG1获知 SP的接收情况,此时 ISMG2应产生一个状态报告转发给 ISMG1;
10. ISMG1收到此状态报告后发送转发应答响应;
目的网关用于向源网关通知 SP接收情况的状态报告时,CMPP_FWD消息中 Msg_Fwd_Type值为
3,表示 MO的状态报告,信息内容字段(Msg_Content)格式定义如下:
字段名 字节数 属性 描述
Msg_Id 8 Unsigned
Integer
信息标识
给 SP的 CMPP_Deliver消息中的 Msg_Id,与
源网关转发 MO消息时产生的 Msg_Id相同。
Stat 7 OctetStr
ing
SP的 应 答 结 果 , CMPP_DELIVER_RESP中
Result值的字符表示,左对齐。Result为 0
时,填字符 DELIVRD,其余值填 REJECTD
CMPP_Deliver_time 10 OctetStr
ing
YYMMDDHHMM(YY为年的后两位 00-99,MM:
01-12,DD:01-31,HH:00-23,MM:00-59)
注:短信网关发出 CMPP_DELIVER的时间。
CMPP_Deliver_RESP_t
ime
10 OctetStr
ing
YYMMDDHHMM
注:短信网关收到 CMPP_DELIVER_RESP的时
间。
Dest_Id 21 OctetStr
ing
目的 SP的服务代码,左对齐。
Reserved 4 Reserved
修订历史
版本号 时间 主要内容或重大修改
1. 修改了 Msg_Id的生成算法;
2. 明确了有关短信群发的问题;
3. CMPP_MO_ROUTE_RESP中的 SP_CODE改为 SP_Id
(SP企业代码);
4. ISMG与 GNS交互的消息中 Area_Code含义定义为
省代码,用省会城市区号表示;
5. 对 Service_Id字段的要求放宽,可以是数字、
字母和符号的组合;
6. 明确 Dest_terminal_Id字段允许在用户终端号
码前加“86”或“+86”;
7. 规定网关 SP之间、网关之间消息发送等待确认
时间暂定为 60秒,超过则认为超时需要重发两次;
8. 规定了对于包月的 SMC消息,应向 SP返回成功
与否的状态报告,若成功 Stat值为 DELIVRD,失败
Stat值为 UNDELIV;
9. 明确状态报告中 ACCEPTED为中间状态,网关收
到后应丢弃不做任何操作;
10. 修改了 CMPP_ACTIVE_TEST_RESP的消息格式;
11. 增加了 MO状态报告的格式、流程;
12. 在缩略语中增加了一些定义,改正了一些文字上
前后不一致的地方,进行了版面调整;
13. 增加了网关在异常情形下的MO/MT状态报告的产
生机制;
14. 对原协议中的端口号作了重新规定。