互联网短信网关接口
协议
离婚协议模板下载合伙人协议 下载渠道分销协议免费下载敬业协议下载授课协议下载
C h i n a M o b i l e P o i n t t o P o i n t
版 本 号 :
3 . 0 . 0
目录
41
范围
52
引用标准
53
术语和定义
64
网络结构
65
CMPP 功能概述
66
协议栈
77
通信方式
77.1
长连接
87.2
短连接
97.3
本协议涉及的端口号
97.4
交互过程中的应答方式
108
消息定义
108.1
基本数据类型
108.2
消息结构
108.3
消息头格式(Message Header)
108.4
业务提供商(SP)与互联网短信网关(ISMG)间的消息定义
118.4.1
SP 请求连接到 ISMG(CMPP_CONNECT)操作
128.4.2
SP 或 ISMG 请求拆除连接(CMPP_TERMINATE)操作
128.4.3
SP 向 ISMG 提交短信(CMPP_SUBMIT)操作
148.4.4
SP 向 ISMG 查询发送短信状态(CMPP_QUERY)操作
158.4.5
ISMG 向 SP 送交短信(CMPP_DELIVER)操作
188.4.6
SP 向 ISMG 发起删除短信(CMPP_CANCEL)操作
188.4.7
链路检测(CMPP_ACTIVE_TEST)操作
188.5
互联网短信网关(ISMG)之间的消息定义
198.5.1
源 ISMG 请求连接到目的 ISMG(CMPP_CONNECT)操作
198.5.2
源 ISMG 请求拆除到目的 ISMG 的连接(CMPP_TERMINATE)操作
198.5.3
链路检测(CMPP_ACTIVE_TEST)操作
198.5.4
源 ISMG 向目的 ISMG 转发短信(CMPP_FWD)操作
228.6
互联网短信网关(ISMG)与汇接网关(GNS)之间的消息定义
228.6.1
ISMG 请求连接到 GNS 或 GNS 请求连接到 ISMG(CMPP_CONNECT)操作
228.6.2
ISMG 请求拆除到 GNS 的连接或 GNS 请求拆除到 ISMG 的连接(CMPP_TERMINATE)操作
228.6.3
ISMG 向汇接网关查询 MT 路由(CMPP_MT_ROUTE)操作
238.6.4
ISMG 向汇接网关查询 MO 路由(CMPP_MO_ROUTE)操作
248.6.5
ISMG 向汇接网关获取 MT 路由(CMPP_GET_MT_ROUTE)操作
258.6.6
SMG 向汇接网关获取 MO 路由(CMPP_GET_MO_ROUTE)操作
268.6.7
ISMG 向汇接网关更新 MT 路由(CMPP_MT_ROUTE_UPDATE)操作
278.6.8
ISMG 向汇接网关更新 MO 路由(CMPP_MO_ROUTE_UPDATE)操作
288.6.9
汇接网关向 ISMG 更新 MT 路由(CMPP_PUSH_MT_ROUTE_UPDATE)操作
298.6.10
汇接网关向 ISMG 更新 MO 路由(CMPP_PUSH_MO_ROUTE_UPDATE)操作
308.7
系统定义
308.7.1
Command_Id 定义
318.7.2
错误码使用说明
318.7.3
ISMG 与 GNS 之间消息使用的错误码定义
328.7.4
GNS 上路由信息的 Route_Id 的编号规则
329
附录 1 短信群发功能的实现
3310
附录 2 GNS 协议目前实现说明
3311
修订历史
前
言
本规范规定了移动梦网短信业务开展过程中各网元(包括 ISMG、GNS 和 SP)之间的消息类型和定义,目前为 3.0.0 版本,是在原来 2.1.0 版本的基础上进行修订而成。根据业务的发展,规范中的信令操作和参数将会做进一步的调整和增加。
本标准由中国移动通信集团公司技术部提出并归口。
本标准起草单位:中国移动通信集团公司研发中心。
本标准主要起草人:党京、孙若雯、于蓉蓉、袁向阳。
本标准解释单位:同提出单位。
1 范围
本规范规定了以下三方面的内容:
· 业务提供商与互联网短信网关之间的接口协议;
· 互联网短信网关之间的接口协议;
· 互联网短信网关与汇接网关之间的接口协议。
本规范适用于各 SP 和 ISMG、GNS 的开发厂商。
2 引用标准
下列标准所包含的条文,通过在本标准中引用而成为本标准的条文。本标准出版时,所示版本均为有效。所有标准都会被修订,使用本标准的各方应探讨使用下列标准最新版本的可能性。
《SMPP》
《移动梦网短信业务技术方案》
3 术语和定义
英文缩写
英文全称
说明
ISMG
Intenet Short Message Gateway
互联网短信网关
DSMP
Data Service Manage Platform
数据业务管理平台
SMPP
Short Message Peer to Peer
短消息点对点协议
CMPP
China Mobile Peer to Peer
中国移动点对点协议
SMSC
Short Message Service Center
短消息中心
GNS
Gateway Name Server
网关名称服务器(汇接网关)
SP
Service Provider
业务提供者
ISMG_Id
网关代码:0XYZ01~0XYZ99,其中 XYZ
为省会区号,位数不足时左补零,如北京
编号为 1 的网关代码为
001001,江西编号为 1 的网关代码为 079101,依此类推
SP_Id
SP 的企业代码:网络中 SP 地址和身份的标识、地址翻译、计费、结算等均以企业代码为依据。企业代码以数字
表
关于同志近三年现实表现材料材料类招标技术评分表图表与交易pdf视力表打印pdf用图表说话 pdf
示,共 6位,从“9XY000”至“9XY999”,其中“XY”为各移动公司代码
SP_Code
SP的服务代码:服务代码是在使用短信
方式的上行类业务中,提供给用户使用的
服务提供商代码。服务代码以数字表示,
全国业务服务代码长度为 4 位,即“1000”-“9999”;本地业务服务代码长度统一为 5 位,即“01000”-“09999”;信产部对新的 SP 的服务代码分配提出了新的要求,要求以“1061”-“1069”作为前缀,目前中国移动进行了如下分配:1062:用于省内 SP 服务代码1066:用于全国 SP 服务代码其它号段保留。
Service_Id
SP的业务类型,数字、字母和符号的组
合,由 SP 自定,如图片传情可定为 TPCQ,
股票查询可定义为 11
4 网络结构
图1
互联网短信网关组网结构
如图 1 所示,互联网短信网关(ISMG)是业务提供商(SP)与移动网内短信中心之间的中介实体,互联网短信网关一方面负责接收 SP 发送给移动用户的信息和提交给短信中心。
另一方面,移动用户点播 SP 业务的信息将由短信中心通过互联网短信网关发给 SP。另外,为了减轻短信中心的信令负荷,互联网短信网关还应根据路由原则将 SP 提交的信息转发到相应的互联网短信网关。互联网短信网关通过向汇接网关(GNS)查询的方式获得网关间的转发路由信息。
另外,ISMG 还必须与数据业务管理平台 DSMP 进行连接,在业务流程中对用户、业务以及定购关系等进行鉴权并对业务进行批价。
5 CMPP 功能概述
CMPP 协议主要提供以下两类业务操作:
(1)短信发送(Short Message Mobile Originate,SM MO)
详细的流程请参考《移动梦网短信业务信令流程规范 V3.0.0》;
(2)短信接收(Short Message Mobile Terminated,SM MT)
详细的流程请参考《移动梦网短信业务信令流程规范 V3.0.0》;
6 协议栈
CMPP 协议以 TCP/IP 作为底层通信承载,具体结构由图 2 所示:
7 通信方式
各网元之间共有两种连接方式:长连接和短连接。所谓长连接,指在一个 TCP 连接上可以连续发送多个数据包,在 TCP 连接保持期间,如果没有数据包发送,需要双方发链路检测包以维持此连接。短连接是指通信双方有数据交互时,就建立一个 TCP 连接,数据发送完成后,则断开此 TCP 连接,即每次 TCP 连接只完成一对 CMPP 消息的发送。现阶段,要求 ISMG 之间必须采用长连接的通信方式,建议 SP 与 ISMG 之间采用长连接的通信方式。
7.1 长连接
通信双方以客户-服务器方式建立 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 条。
长连接的操作流程举例 图3所示:
7.2 短连接
通信双方以客户-服务器方式建立 TCP 连接,应答与请求在同一个连接中完成。系统采用客户/服务器模式,操作以客户端驱动方式发起连接请求,完成一次操作后关闭此连接。
网关与 SP 之间、网关之间的消息发送后等待 T 秒后未收到响应,应立即重发,再连续发送 N-1 次后仍未得到响应则停发。
现阶段建议取值为:T=60 秒,N=3。
短连接的操作流程举例如图 4 所示:
7.3 本协议涉及的端口号
端口号
应用
7890 长连接(SP 与网关间)
7900 短连接(SP 与网关间)
7930 长连接(网关之间)
9168 短连接(短信网关与汇接网关之间)
7.4 交互过程中的应答方式
在 SP 与 ISMG 之间、SMSC 与 ISMG 之间及 ISMG 之间的交互过程中均采用异步方式,即
任一个网元在收到请求消息后应立即回送响应消息。举例如图 7 所示:
8 消息定义
8.1 基本数据类型
Unsigned Integer
无符号整数
Integer
整数,可为正整数、负整数或零
Octet String
定长字符串,位数不足时,如果左补 0 则补 ASCII 表示的
零以填充,如果右补 0 则补二进制的零以表示字符串的结
束符
8.2 消息结构
项目
说明
Message Header
消息头(所有消息公共包头)
Message Body
消息体
8.3 消息头格式(Message Header)
字段名
字节数
类型
描述
Total_Length
4
Unsigned Integer
消息总长度(含消息头及消息体)
Command_Id
4
Unsigned Integer
命令或响应类型
Sequence_Id
4
Unsigned Integer
消息流水号,顺序累加,步长为
1,循环使用(一对请求和应答消息的流水号必须相同)
8.4 业务提供商(SP)与互联网短信网关(ISMG)间的消息定义
SP 为客户端,向作为服务器端的 ISMG 发起连接请求,在通过身份验证之后 SP 与 ISMG之间方可进行数据传输。
8.4.1 SP 请求连接到 ISMG(CMPP_CONNECT)操作
CMPP_CONNECT 操作的目的是 SP 向 ISMG 注册作为一个合法 SP 身份,若注册成功后即建立了应用层的连接,此后 SP 可以通过此 ISMG 接收和发送短信。ISMG 以 CMPP_CONNECT_RESP 消息响应 SP 的请求。
8.4.1.1 CMPP_CONNECT 消息定义(SP → ISMG)
字段名
字节数
属性
描述
Source_Addr
6
Octet String
源地址,此处为 SP_Id,即 SP 的企业代码。
AuthenticatorSource
16
Octet String
用于鉴别源地址。其值通过单向 MD5 hash 计算得出,表示如下:AuthenticatorSource =MD5 ( Source_Addr+9
字 节 的
0+shared secret+timestamp)Shared secret 由中国移动与源地址实体 事 先 商 定 , timestamp
格 式 为 :MMDDHHMMSS,即月日时分秒,10位。
Version
1
Unsigned Integer
双方协商的版本号(高位
4bit
表示主版本号,低位
4bit
表示次版本号),对于 3.0 的版本,高 4bit 为 3,低 4 位为80
Timestamp
4
Unsigned
Integer
时间戳的明文,由客户端产生,格式为MMDDHHMMSS,即月日时分秒,10位数字的整型,右对齐。
8.4.1.2 CMPP_CONNECT_RESP 消息定义(ISMG → SP)
字段名
字节数
属性
描述
Status
4
Unsigned
Integer
状态
0:正确
1:消息结构错
2:非法源地址
3:认证错
4:版本太高
5:其他错误
AuthenticatorISMG
16
Octet String
ISMG 认证码,用于鉴别 ISMG。其值通过单向 MD5 hash 计算得出,表示如下:AuthenticatorISMG
=MD5(Status+AuthenticatorSource+shared secret),Shared secret 由中国移动与 源 地 址 实 体 事 先 商 定 ,AuthenticatorSource
为源地址实体发 送 给
ISMG
的 对 应 消 息CMPP_Connect 中的值。认证出错时,此项为空。
Version
1
Unsigned
Integer
服务器支持的最高版本号,对于
3.0的版本,高 4bit 为 3,低 4 位为 0
8.4.2 SP 或 ISMG 请求拆除连接(CMPP_TERMINATE)操作
CMPP_TERMINATE 操作的目的是 SP 或 ISMG 基于某些原因决定拆除当前的应用层连接而发起的操作。此操作完成后 SP 与 ISMG 之间的应用层连接被释放,此后 SP 若再要与 ISMG通信时应发起 CMPP_CONNECT 操作。
ISMG 或 SP 以 CMPP_TERMINATE_RESP 消息响应请求。
8.4.2.1 CMPP_TERMINATE 消息定义(SP → ISMG 或 ISMG → SP)
无消息体。
8.4.2.2 CMPP_TERMINATE_RESP 消息定义(SP → ISMG 或 ISMG → SP)
无消息体。
8.4.3 SP 向 ISMG 提交短信(CMPP_SUBMIT)操作
CMPP_SUBMIT 操作的目的是 SP 在与 ISMG 建立应用层连接后向 ISMG 提交短信。
ISMG 以 CMPP_SUBMIT_RESP 消息响应。
8.4.3.1 CMPP_SUBMIT 消息定义(SP → ISMG)
字段名
字节数
属性
描述
Msg_Id
8
Unsigned Integer
信息标识。
Pk_total
1
Unsigned Integer
相同 Msg_Id 的信息总条数,从 1 开始。
Pk_number
1
Unsigned Integer
相同 Msg_Id 的信息序号,从 1 开始。
Registered_Delivery
1
Unsigned Integer
是否要求返回状态确认报告:
0:不需要;
1:需要。
Msg_level
1
Unsigned Integer
信息级别。
Service_Id
10
Octet String
业务标识,是数字、字母和符号的组合。
Fee_UserType
1
Unsigned Integer
计费用户类型字段:
0:对目的终端 MSISDN 计费;
1:对源终端 MSISDN 计费;
2:对 SP 计费;
3 : 表 示 本 字 段 无 效 , 对 谁 计 费 参 见Fee_terminal_Id 字段。
Fee_terminal_Id
32
Octet String
被计费用户的号码,当 Fee_UserType 为 3时该值有效,当 Fee_UserType 为 0、1、2时该值无意义。
Fee_terminal_type
1
Unsigned Integer
被计费用户的号码类型,0:真实号码;1:
伪码。
TP_pId
1
Unsigned Integer
GSM 协议类型。详细是解释请参考GSM03.40 中的 9.2.3.9。
TP_udhi
1
Unsigned Integer
GSM 协议类型。详细是解释请参考GSM03.40 中的 9.2.3.23,仅使用 1 位,右对齐。
Msg_Fmt
1
Unsigned Integer
信息格式:
0:ASCII 串;
3:短信写卡操作;
4:二进制信息;
8:UCS2 编码;
15:含 GB 汉字。。。。。。
Msg_src
6
Octet String
信息内容来源(SP_Id)。
FeeType
2
Octet String
资费类别:
01:对“计费用户号码”免费;
02:对“计费用户号码”按条计信息费;
03:对“计费用户号码”按包月收取信息费。
FeeCode
6
Octet String
资费代码(以分为单位)。
ValId_Time
17
Octet String
存活有效期,格式遵循 SMPP3.3 协议。
At_Time
17
Octet String
定时发送时间,格式遵循 SMPP3.3 协议。
Src_Id
21
Octet String
源号码。SP
的服务代码或前缀为服务代码的长号码,
网关将该号码完整的填到SMPP
协 议
Submit_SM
消 息 相 应 的source_addr 字段,该号码最终在用户手机上显示为短消息的主叫号码。
DestUsr_tl
1
Unsigned Integer
接收信息的用户数量(小于 100 个用户)。
Dest_terminal_Id
32*DestUsr_tl
Octet String
接收短信的 MSISDN 号码。
Dest_terminal_type
1
Unsigned Integer
接收短信的用户的号码类型,0:真实号
码;1:伪码。
Msg_Length
1
Unsigned Integer
信息长度(Msg_Fmt 值为 0 时:<160 个字
节;其它<=140 个字节),取值大于或等于0。
Msg_Content
Msg_length
Octet String
信息内容。
LinkID
20
Octet String
点播业务使用的 LinkID,非点播类业务的MT 流程不使用该字段。
系统应该支持短信的群发功能,关于短信群发功能的实现请参阅“附录
1
短信群发功能的实现”。
8.4.3.2 CMPP_SUBMIT_RESP 消息定义(ISMG → SP)
字段名
字节数
属性
描述
Msg_Id
8
Unsigned Integer
采用 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
4
Unsigned
Integer
结果:
0:正确;
1:消息结构错;
2:命令字错;
3:消息序号重复;
4:消息长度错;
5:资费代码错;
6:超过最大信息长;
7:业务代码错;
8:流量控制错;
9:本网关不负责服务此计费号码;
10:Src_Id 错误;
11:Msg_src 错误;
12:Fee_terminal_Id 错误;
13:Dest_terminal_Id 错误;
……
8.4.4 SP 向 ISMG 查询发送短信状态(CMPP_QUERY)操作
CMPP_QUERY 操作的目的是 SP 向 ISMG 查询某时间的业务统计情况,可以按总数或按业务代码查询。ISMG 以 CMPP_QUERY_RESP 应答。
8.4.4.1 CMPP_QUERY 消息的定义(SP → ISMG)
字段名
字节数
属性
描述
Time
8
Octet String
时间 YYYYMMDD(精确至日)。
Query_Type
1
Unsigned Integer
查询类别:0:总数查询;1:按业务类型查询。
Query_Code
10
Octet String
查询码。当 Query_Type 为 0 时,此项无效;当Query_Type 为 1 时,此项填写业务类型service_Id.。
Reserve
8
Octet String
保留。
8.4.4.2 CMPP_QUERY_RESP 消息的定义(ISMG → SP)
字段名
字节数
属性
描述
Time
8
Octet String
时间(精确至日)。
Query_Type
1
Unsigned Integer
查询类别:0:总数查询;1:按业务类型查询。
Query_Code
10
Octet String
查询码。
MT_TLMsg
4
Unsigned Integer
从 SP 接收信息总数。
MT_Tlusr
4
Unsigned Integer
从 SP 接收用户总数。
MT_Scs
4
Unsigned Integer
成功转发数量。
MT_WT
4
Unsigned Integer
待转发数量。
MT_FL
4
Unsigned Integer
转发失败数量。
MO_Scs
4
Unsigned Integer
向 SP 成功送达数量。
MO_WT
4
Unsigned Integer
向 SP 待送达数量。
MO_FL
4
Unsigned Integer
向 SP 送达失败数量。
8.4.5 ISMG 向 SP 送交短信(CMPP_DELIVER)操作
CMPP_DELIVER 操作的目的是 ISMG 把从短信中心或其它 ISMG 转发来的短信送交 SP,SP 以 CMPP_DELIVER_RESP 消息回应。
8.4.5.1 CMPP_DELIVER 消息定义(ISMG → SP)
字段名
字节数
属性
描述
Msg_Id
8
Unsigned Integer
信息标识。
生成算法如下:
采用 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
Octet String
目的号码。
SP 的服务代码,一般 4--6 位,或者
是前缀为服务代码的长号码;该号
码是手机用户短消息的被叫号码。
Service_Id
10
Octet String
业务标识,是数字、字母和符号的
组合。
TP_pid
1
Unsigned Integer
GSM 协议类型。详细解释请参考GSM03.40 中的 9.2.3.9。
TP_udhi
1
Unsigned Integer
GSM 协议类型。详细解释请参考GSM03.40 中的 9.2.3.23,仅使用 1位,右对齐。
Msg_Fmt
1
Unsigned Integer
信息格式:
0:ASCII 串;
3:短信写卡操作;
4:二进制信息;
8:UCS2 编码;
15:含 GB 汉字。
Src_terminal_Id
32
Octet String
源终端 MSISDN 号码(状态报告时
填为 CMPP_SUBMIT 消息的目的终
端号码)。
Src_terminal_type
1
Unsigned Integer
源终端号码类型,0:真实号码;1:伪码。
Registered_Delivery
1
Unsigned Integer
是否为状态报告:
0:非状态报告;
1:状态报告。
Msg_Length
1
Unsigned Integer
消息长度,取值大于或等于 0。
Msg_Content
Msg_length
Octet String
消息内容。
LinkID
20
Octet String
点播业务使用的 LinkID,非点播类
业务的 MT 流程不使用该字段。
当 ISMG 向 SP 送交状态报告时,信息内容字段(Msg_Content)格式定义如下:
字段名
字节数
属性
描述
Msg_Id
8
Unsigned Integer
信息标识。
SP 提交短信(CMPP_SUBMIT)操作时,与 SP
相连的 ISMG 产生的 Msg_Id。
Stat
7
Octet String
发送短信的应答结果,含义详见表一。SP 根据
该字段确定 CMPP_SUBMIT 消息的处理状态。
Submit_time
10
Octet String
YYMMDDHHMM(YY 为年的后两位 00-99,MM:01-12,DD:01-31,HH:00-23,MM:00-59)。
Done_time
10
Octet String
YYMMDDHHMM。
Dest_terminal_Id
32
Octet String
目 的 终 端
MSISDN
号 码
(SP
发 送
CMPP_SUBMIT 消息的目标终端)。
SMSC_sequence
4
Unsigned Integer
取自 SMSC 发送状态报告的消息体中的消息标识。
表一 Stat 字段定义
Message State
Final Message States
Description
DELIVERED
DELIVRD
Message is delivered to destination
EXPIRED
EXPIRED
Message validity period has expired
DELETED
DELETED
Message has been deleted.
UNDELIVERABLE
UNDELIV
Message is undeliverable
ACCEPTED
ACCEPTD
Message is in accepted state(i.e. has been manually read on behalf of the subscriber by customer service)
UNKNOWN
UNKNOWN
Message is in invalid state
REJECTED
REJECTD
Message is in a rejected state
MA:xxxx
MA:xxxx
SMSC 不返回响应消息时的状态报告
MB:xxxx
MB:xxxx
SMSC 返回错误响应消息时的状态报告
MC:xxxx
MC:xxxx
没有从 SMSC 处接收到状态报告时的状态报告
CA:xxxx
CA:xxxx
SCP 不返回响应消息时的状态报告
CB:xxxx
CB:xxxx
SCP 返回错误响应消息时的状态报告
DA:xxxx
DA:xxxx
DSMP 不返回响应消息时的状态报告
DB:xxxx
DB:xxxx
DSMP 返回错误响应消息时的状态报告
SA:xxxx
SA:xxxx
SP 不返回响应消息时的状态报告
SB:xxxx
SB:xxxx
SP 返回错误响应消息时的状态报告
IA:xxxx
IA:xxxx
下一级 ISMG 不返回响应消息时的状态报告
IB:xxxx
IB:xxxx
下一级 ISMG 返回错误响应消息时的状态报告
IC:xxxx
IC:xxxx
没有从下一级 ISMG 处接收到状态报告时的状态报告
注意:
1. 其中 ACCEPTED 为中间状态,网关若从短信中心收到后应丢弃,不做任何操作;
2. Stat 字段长度为 7 个字节,填写时应填表一中 Final Message States 中的缩写形式,如状态为 DELIVERED 时填写 DELIVRD,依此类推;
3. SP 等待状态报告缺省时间为 48 小时。
8.4.5.2 CMPP_DELIVER_RESP 消息定义(SP → ISMG)
字段名
字节数
属性
描述
Msg_Id
8
Unsigned Integer
信息标识(CMPP_DELIVER 中的Msg_Id 字段)。
Result
4
Unsigned Integer
结果:
0:正确;
1:消息结构错;
2:命令字错;
3:消息序号重复;
4:消息长度错;
5:资费代码错;
6:超过最大信息长;
7:业务代码错;
8:
流量控制错;
9~
:其他错误。
8.4.6 SP 向 ISMG 发起删除短信(CMPP_CANCEL)操作
CMPP_CANCEL 操作的目的是 SP 通过此操作可以将已经提交给 ISMG 的短信删除,ISMG将以 CMPP_CANCEL_RESP 回应删除操作的结果。
8.4.6.1 CMPP_CANCEL 消息定义(SP → ISMG)
字段名
字节数
属性
描述
Msg_Id
8
Unsigned Integer
信息标识(SP 想要删除的信息标识)。
8.4.6.2 CMPP_CANCEL_RESP 消息定义(ISMG → SP)
字段名
字节数
属性
描述
Success_Id
4
Unsigned Integer
成功标识:
0:成功;
1:失败。
8.4.7 链路检测(CMPP_ACTIVE_TEST)操作
本操作仅适用于通信双方采用长连接通信方式时用于保持连接。
8.4.7.1 CMPP_ACTIVE_TEST 定义(SP → ISMG 或 ISMG → SP)
无消息体。
8.4.7.2 CMPP_ACTIVE_TEST_RESP 定义(SP → ISMG 或 ISMG → SP)
字段名
字节数
属性
描述
Reserved
1
8.5 互联网短信网关(ISMG)之间的消息定义
网关之间互为客户/服务器,任一方在需要传递消息时,向对方请求建立连接,并在身份验证通过后进行数据传输。
8.5.1 源 ISMG 请求连接到目的 ISMG(CMPP_CONNECT)操作
消息定义同 8.4.1.1 和 8.4.1.2 所述。其中 Source_Addr 填源网关代码。
8.5.2 源 ISMG 请求拆除到目的 ISMG 的连接(CMPP_TERMINATE)操作
消息定义同 8.4.2.1 和 8.4.2.2 所述。
8.5.3 链路检测(CMPP_ACTIVE_TEST)操作
本操作仅用于通信双方采用长连接通信方式时保持连接。消息定义同 8.4.6.1 和 8.4.6.2 所述。
8.5.4 源 ISMG 向目的 ISMG 转发短信(CMPP_FWD)操作
CMPP_FWD 操作的目的是源 ISMG 可以根据一定的路由策略将 SP 提交的短信、MO 状态报告、短信中心产生的状态报告、用户提交的短信转发到目的
ISMG ,目的
ISMG
以CMPP_FWD_RESP 回应。
8.5.4.1 CMPP_FWD 定义(ISMG → ISMG)
字段名
字节数
属性
描述
Source_Id
6
Octet String
源网关的代码(右对齐,左补 0)。
Destination_Id
6
Octet String
目的网关代码(右对齐,左补 0)。
NodesCount
1
Unsigned Integer
经过的网关数量。
Msg_Fwd_Type
1
Unsigned Integer
前转的消息类型:
0:MT 前转;
1:MO 前转;
2:MT 时的状态报告;
3:MO 时的状态报告;
Msg_Id
8
Unsigned Integer
信息标识。
Pk_total
1
Unsigned Integer
相同 Msg_Id 的消息总条数,从 1 开始。
Pk_number
1
Unsigned Integer
相同 Msg_Id 的消息序号,从 1 开始。
Registered_Delivery
1
Unsigned Integer
是否要求返回状态确认报告:
0:不需要;
1:需要;
2:产生 SMC 话单。
Msg_level
1
Unsigned Integer
信息级别。
Service_Id
10
Octet String
业务标识。
Fee_UserType
1
Unsigned Integer
计费用户类型字段:
0:对目的终端 MSISDN 计费;
1:对源终端 MSISDN 计费;
2:对 SP 计费;
3:表示本字段无效, 对谁计费参 见
Fee_terminal_Id 字段。
Fee_terminal_Id
21
Octet String
被计费用户的号码,当 Fee_UserType 为3 时该值有效,当 Fee_UserType 为 0、1、2 时该值无意义。
Fee_terminal_Pseudo
32
Octet String
被计费用户的伪码。
Fee_terminal_UserType
1
Unsigned Integer
计费用户号码的用户类型,0:全球通,1:神州行。
TP_pid
1
Unsigned Integer
GSM 协议类型。详细解释请参考GSM03.40 中的 9.2.3.9。
TP_udhi
1
Unsigned Integer
GSM 协议类型。详细解释请参考GSM03.40 中的 9.2.3.23,仅使用 1 位,右对齐。
Msg_Fmt
1
Unsigned Integer
信息格式:
0:ASCII 串;
3:短信写卡操作;
4:二进制信息;
8:UCS2 编码;
15:含 GB 汉字。
Msg_src
6
Octet String
信息内容来源(SP_Id,SP 的企业代码)。
FeeType
2
Octet String
资费类别。
01:对“计费用户号码”免费;
02:对“计费用户号码”按条计信息费;
03:对“计费用户号码”按包月收取信息费;
06:对“计费用户号码”按包月查询收费。
FeeCode
6
Octet String
资费代码(以分为单位)。
Valid_Time
17
Octet String
有效期。
At_Time
17
Octet String
定时发送的时间。
Src_Id
21
Octet String
源号码。
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。
Src_Pseudo
32
Octet String
源号码的伪码。
Src_UserType
1
Unsigned Integer
源号码的用户类型,0:全球通,1:神州行。
Src_type
1
Unsigned Integer
传递给 SP 的源号码的类型,0:真实号码;1:伪码。
DestUsr_tl
1
Unsigned Integer
接收消息的用户数量,必须为 1。
Dest_Id
21*DestUsr_tl
Octet String
目的号码。
1.MT 转发时为目的终端 MSISDN
号码,即对应 CMPP_SUBMIT 消息中的 Dest_Terminal_Id。
2.MO 转发时为 SP 的服务代码,一般
4--6 位,或者是前缀为服务代码的长号码,该号码是手机用户短消息的被叫号码。
3.MT 状态报告时,填目的 SP 的服务代码,即 CMPP_SUBMIT 消息中的Src_Id。
4.MO 状态报告时,填发送短信的移动用户 MSISDN 号码。
Dest_Pseudo
32
Octet String
目的用户的伪码。
Dest_UserType
1
Unsigned Integer
目的号码的用户类型,0:全球通,1:神州行。
Msg_Length
1
Unsigned Integer
消息长度,取值大于或等于 0。
Msg_Content
Msg_length
Octet String
消息内容。
LinkID
20
Octet String
点播业务使用的 LinkID。
注意:
当转发消息为 MO 状态报告时,信息内容字段(Msg_Content)格式定义如下:
字段名
字节数
属性
描述
Msg_Id
8
Unsigned Integer
信息标识。
给SP的
CMPP_Deliver消 息 中 的Msg_Id,与源网关转发 MO 消息时产生的 Msg_Id 相同。
Stat
7
Octet String
SP
的应答结果
,CMPP_DELIVER_RESP 中 Result 为 0时,填字符DELIVRD,其余异常的值
可能为 SA:xxxx 或 SB:xxxx,含义请参考 CMPP_DELIVER 中对状态报告的说明。
CMPP_DELIVER_time
10
Octet String
YYMMDDHHMM(YY
为年的后两位00-99,MM:01-12,DD:01-31,HH:00-23,MM:00-59)。注:短信网关发出 CMPP_DELIVER 的时间。
CMPP_DELIVER_RESP_time
10
Octet String
YYMMDDHHMM。注:短信网关收到CMPP_DELIVER_RESP 的时间。
Dest_Id
21
Octet String
目的 SP 的服务代码,左对齐。
Reserved
4
1. 当转发消息为 MT 状态报告时,信息内容字段(Msg_Content)格式同 8.4.5.1 定义。
8.5.4.2 CMPP_FWD_RESP 定义(ISMG → ISMG)
字段名
字节数
属性
描述
Msg_Id
8
Unsigned Integer
信息标识(CMPP_FWD 中字段值)
Pk_total
1
Unsigned Integer
相同 Msg_Id 的消息总条数
Pk_number
1
Unsigned Integer
相同 Msg_Id 的消息序号
Result
4
Unsigned Integer
结果
0:正确
1:消息结构错
2:命令字错
3:消息序号重复
4:消息长度错
5:资费代码错
6:超过最大信息长
7:业务代码错
8:
流量控制错
9:
前转判断错(此 SP 不应发往本 ISMG)
10~
:其他错误
8.6 互联网短信网关(ISMG)与汇接网关(GNS)之间的消息定义
要求 ISMG 与 GNS 在信息交互时使用短连接的通信方式。ISMG 与 GNS 可互为客户/服务器。
8.6.1 ISMG 请求连接到 GNS 或 GNS 请求连接到 ISMG(CMPP_CONNECT)操作
消息定义同 8.4.1.1 和 8.4.1.2 所述,其中 Source_Addr 填源网关代码,可能是 ISMG 代码或GNS 代码。
8.6.2 ISMG 请求拆除到 GNS 的连接或 GNS 请求拆除到 ISMG 的连接(CMPP_TERMINATE)操作
消息定义同 8.4.2.1 和 8.4.2.2 所述。
8.6.3 ISMG 向汇接网关查询 MT 路由(CMPP_MT_ROUTE)操作
CMPP_MT_ROUTE 操作用于 ISMG 不知道需要转发 MT 消息的路由时查询 GNS。GNS 以CMPP_MT_ROUTE_RESP 应答。
8.6.3.1 CMPP_MT_ROUTE 消息定义(ISMG → GNS)
字段名
字节数
属性
描述
Source_Id
6
Octet String
源网关代码
Terminal_Id
21
Octet String
目的终端 MSISDN 号码
8.6.3.2 CMPP_MT_ROUTE_RESP 消息定义(GNS → ISMG)
字段名
字节数
属性
描述
Route_Id
4
Unsigned Integer
路由编号(MO/MT 分别从 0 开始,由 GNS统一分配)
Destination_Id
6
Octet String
目标网关代码
Gateway_IP
15
Octet String
目标网关 IP 地址(地址格式举例:67.221.134.12,左对齐)
Gateway_port
2
Unsigned Integer
目标网关 IP 端口
Start_Id
9
Octet String
MT 路由起始号码段
End_Id
9
Octet String
MT 路由截止号码段
Area_code
4
Octet String
手机所属省代号
Result
1
Unsigned Integer
结果
0:正常
1:没有匹配路由
2:源网关代码错
9:系统繁忙
User_type
1
Unsigned Integer
用户类型
0:全球通
1:神州行
2:M-Zone
…...
Time_stamp
14
Octet String
本路由信息的最后修改时间
格式是:yyyymmddhhmmss,
例如 20030117014512
8.6.4 ISMG 向汇接网关查询 MO 路由(CMPP_MO_ROUTE)操作
CMPP_MO_ROUTE 操作的目的是使 ISMG 当不知道需要转发 MO 消息的路由时可向 GNS查询得到。GNS 以 CMPP_MO_ROUTE_RESP 应答。
8.6.4.1 CMPP_MO_ROUTE 消息定义(ISMG → GNS)
字段名
字节数
属性
描述
Source_Id
6
Octet String
源网关代码
SP_Code
21
Octet String
SP 的服务代码
Service_Id
10
Octet String
请求的业务类型(此项适合全网服务内
容,如梦网卡图片传情)
Service_Code
4
Unsigned Integer
请求的业务代码(如果未置 Service_Id 字段,此字段为空,如梦网卡图片传情 TPCQ1000—2000 对应,某个网站的某些相应图片)
8.6.4.2 CMPP_MO_ROUTE_RESP 消息定义(GNS → ISMG)
字段名
字节数
属性
描述
Route_Id
4
Unsigned Integer
路由编号(MO/MT 分别从 0 开始,由 GNS
统一分配)
Destination_Id
6
Octet String
目标网关代码
Gateway_IP
15
Octet String
目标网关 IP 地址
Gateway_port
2
Unsigned Integer
目标网关 IP 端口
SP_Id
6
Octet String
SP 的企业代码
SP_Code
21
Octet String
SP 的服务代码
SP_AcessType
1
Unsigned Integer
SP 接入类型
0:全网业务 SP 全网接入,即接入网关为SP 的主力接入点
1:全网业务 SP 镜像接入,即接入网关为SP 的镜像接入点
Start_code
4
Unsigned Integer
MO 路由起始业务代码(如果未置请求的 Service_Id 字段,此字段为空)
End_code
4
Unsigned Integer
MO