互联网短信网关接口协议

互联网短信网关接口协议 中国移动通信互联短信网关接口协议 中国移动通信 互联网短信网关接口协议 (China Mobile Peer to Peer, CMPP) ,V2.0， 中国移动通信集团公司 2002年 4 月 中国移动通信集团公司研发中心 Page 1 of 25 中国移动通信互联短信网关接口协议 目 录 前 言 ......................................................................................................................................................................4 1 范围 ...................................................................................................................................................................5 2 缩略语 ...............................................................................................................................................................5 3(网络结构 .............................................................................................................................................................6 4(CMPP功能概述 ...............................................................................................................................................7 5. 协议栈...................................................................................................................................................................8 6. 通信方式 ..............................................................................................................................................................9 6.1 长连接 ........................................................................................................ 9 6.2 短连接 .......................................................................................................11 6.3 本协议中涉及的端口号.............................................................................. 12 6.4 交互过程中的应答方式.................................................................................... 12 7(消息定义 ...........................................................................................................................................................12 7.1基本数据类型 .................................................................................................... 12 7.2消息结构 ........................................................................................................... 13 7.3 消息头格式(Message Header)......................................................................... 13 7.4信息资源站实体(SP)与互联网短信网关(ISMG)间的消息定义............................... 13 7.4.1 SP请求连接到ISMG(CMPP_CONNECT)操作 ...................................... 13 7.4.2 SP或ISMG请求拆除连接(CMPP_TERMINATE)操作 ........................ 14 7.4.3 SP向ISMG提交短信(CMPP_SUBMIT)操作 ...................................... 15 7.4.4 SP向ISMG查询发送短信状态(CMPP_QUERY)操作错误～未定义书签。 7.4.5 ISMG向SP送交短信(CMPP_DELIVER)操作 .................................... 18 7.4.6 SP向ISMG发起删除短信(CMPP_CANCEL)操作错误～未定义书签。 7.4.7 链路检测(CMPP_ACTIVE_TEST)操作............................................ 21 7.5互联网短信网关(ISMG)之间的消息定义 ............................................................. 21 7.5.1 源ISMG请求连接到目的ISMG(CMPP_CONNECT)操作 ..................... 21 7.5.2 源ISMG请求拆除到目的ISMG的连接(CMPP_TERMINATE)操作 ...... 21 7.5.3链路检测(CMPP_ACTIVE_TEST)操作.................................................. 21 7.5.4 源ISMG向目的ISMG转发短信(CMPP_FWD)操作 . 错误～未定义书签。 7.6互联网短信网关(ISMG)与汇接网关(GNS)之间的消息定义 ...... 错误～未定义书签。 7.6.1 ISMG请求连接到GNS或GNS请求连接到ISMG(CMPP_CONNECT)操作 ............................................................................................ 错误～未定义书签。 中国移动通信集团公司研发中心 Page 2 of 25 中国移动通信互联短信网关接口协议 7.6.2 ISMG请求拆除到GNS的连接或GNS请求拆除到ISMG的连接(CMPP_TERMINATE)操作............................................... 错误～未定义书签。 7.6.3 ISMG向汇接网关查询MT路由(CMPP_MT_ROUTE)操作错误～未定义书签。 7.6.4 ISMG向汇接网关查询MO路由(CMPP_MO_ROUTE)操作错误～未定义书签。 7.6.5ISMG向汇接网关获取路由(CMPP_GET_ROUTE)操作错误～未定义书签。 7.6.6 ISMG向汇接网关更新MT路由(CMPP_MT_ROUTE_UPDATE)操作错误～未定义书签。 7.6.7 ISMG向汇接网关更新MO路由(CMPP_MO_ROUTE_UPDATE)操作 .... 错误～未定义书签。 7.6.8汇接网关向ISMG更新MT路由(CMPP_PUSH_MT_ROUTE_UPDATE)操作 ........................................................................................ 错误～未定义书签。 7.6.9汇接网关向ISMG更新MO路由(CMPP_PUSH_MO_ROUTE_UPDATE)操作 ........................................................................................ 错误～未定义书签。 7.7系统定义 ........................................................................................................... 22 7.7.1 Command_Id定义..................................................................................... 22 附录1 MO状态报告的产生 ...........................................................................................................................23 修订历史 ..................................................................................................................................................................25 中国移动通信集团公司研发中心 Page 3 of 25 中国移动通信互联短信网关接口协议 前 言 本 规范 编程规范下载gsp规范下载钢格栅规范下载警徽规范下载建设厅规范下载 为中国移动通信集团公司企业规范，简称CMPP，现阶段版本是对1.2.1版修订后形成的，为2.0版。本规范描述了中国移动短信业务中各网元(包括ISMG、GNS和SP)之间的相关消息的类型和定义。根据业务的发展，规范中的信令操作和参数将会做进一步的调整和增加。 本规范解释权属于中国移动通信集团公司。 本规范起草单位:中国移动通信集团公司研发中心。 本 标准 excel标准偏差excel标准偏差函数exl标准差函数国标检验抽样标准表免费下载红头文件格式标准下载 主要起草人:党京、孙若雯、于蓉蓉、袁向阳。 中国移动通信集团公司研发中心 Page 4 of 25 中国移动通信互联短信网关接口协议 1 范围 本规范 规定 关于下班后关闭电源的规定党章中关于入党时间的规定公务员考核规定下载规定办法文件下载宁波关于闷顶的规定 了以下三方面的 内容 财务内部控制制度的内容财务内部控制制度的内容人员招聘与配置的内容项目成本控制的内容消防安全演练内容 : (1)信息资源站实体与互联网短信网关之间的接口协议; (2)互联网短信网关之间的接口协议; (3)互联网短信网关与汇接网关之间的接口协议。 本规范适用于各SP和ISMG的开发厂商。 2 缩略语 英文缩写 英文全称 说明 ISMG Internet Short Message Gateway 互联网短信网关 SMPP Short Message Peer to Peer 短消息点对点协议 CMPP China Mobile Peer to Peer 中国移动点对点协议 短消息中心 SMC Short Message Center GNS Gateway Name Server 网关名称服务器(汇接网关) SP Service Provider 业务提供者，即信息资源站实体 SP为收取包月业务费用而向网关发送的消 SMC Short Message Control 息，网关收到后不送给用户仅产生相应的话 单; ISMG_Id 网关代码:0XYZ01~0XYZ99，其中XYZ为 省会区号，位数不足时左补零，如北京编号 为1的网关代码为001001，江西编号为1的 网关代码为079101，依此类推。 SP_Id SP的企业代码:网络中SP地址和身 份的标识、地址翻译、计费、结算等 均以企业代码为依据。企业代码以数 字表示，共6位，从“9XY000”至 “9XY999”，其中“XY”为各移动公 司代码。 SP_Code SP的服务代码:服务代码是在使用 短信方式的点播类业务中，提供给 用户点播的内容/应用服务提供商代 码。服务代码以数字表示，全国业 务服务代码长度统一为 4 位，即 中国移动通信集团公司研发中心 Page 5 of 25 中国移动通信互联短信网关接口协议 “1000”,“9999”;本地业务服务 代码长度统一为5 位，即 “01000”,“09999”。 Service_Id SP的业务类型，数字、字母和符号的 组合，由SP自定，如图片传情可定 为TPCQ，股票查询可定义为11。 3(网络结构 SP . . .SP SMPP短信ISMGGNS中心CMPP 专线或局域网Internet . . . .Internet . . SMPPSMPP短信短信ISMGISMGGNSSMPPSMPP中心中心短信短信ISMGISMG中心中心SPSP专线或局域网 . . . 图1 互联网短信网关逻辑网络结构 如图1所示，互联网短信网关(ISMG)是外部信息资源站实体(SP)与移动网内短信中心 之间的中介实体，互联网短信网关一方面负责接收SP发送给移动用户的信息和提交给短信 中心。另一方面，移动用户点播SP业务的信息将由短信中心通过互联网短信网关发给SP。 另外，为了减轻短信中心的信令负荷，互联网短信网关还应根据路由原则将SP提交的信息 转发到相应的互联网短信网关。互联网短信网关通过向汇接网关(GNS)查询的方式获得网 关间的转发路由信息。 中国移动通信集团公司研发中心 Page 6 of 25 中国移动通信互联短信网关接口协议 4(CMPP功能概述 CMPP协议主要提供以下两类业务操作: (1) 短信发送(Short Message Mobile Originate，SM MO) 典型的业务操作举例如图2所示: 3 GNS(汇接网关) 4 5 源ISMG 目的ISMG 6 1 2 7 8 SMC SP 图2 需要前转的MO示意图 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) 短信接收(Short Message Mobile Terminated，SM MT) 典型的业务操作举例如图3所示: 中国移动通信集团公司研发中心 Page 7 of 25 中国移动通信互联短信网关接口协议 3 GNS(汇接网关) 4 5 源ISMG 目的ISMG 6 1 7 8 2 SP SMC 图3 需要前转的MT示意图 1) SP发出数据请求(可能是短信通知或手机铃声等)，被源ISMG接收; 2) 源ISMG对接收到的信息返回响应; 3) 源ISMG在本地数据库中找不到要目的手机号段所对应网关代码，向GNS(汇接网关) 发路由请求信息; 4) 汇接网关将路由信息返回; 5) 源ISMG根据路由信息将请求前转给目的ISMG; 6) 目的ISMG对接收到的信息返回响应; 7) 目的ISMG将请求信息发送至SMC; 8) SMC向目的ISMG返回响应; 在上述操作中，步骤1到步骤6均使用CMPP协议; 在随后的操作中，SMC将通过NO.7信令网向移动用户发送信息，移动用户收到后将返回状态报告(Delivery-Receipt)给短信中心，短信中心将按照MO操作的流程将状态报告返回给SP(如果SP要求返回状态报告)。 5. 协议栈 CMPP协议以TCP/IP作为底层通信承载，具体结构由图4所示: 中国移动通信集团公司研发中心 Page 8 of 25 中国移动通信互联短信网关接口协议 SP ISMG ISMG GNS CMPP CMPP CMPP CMPP TCP TCP TCP TCP IP IP IP IP 底层承载 底层承载 底层承载 底层承载 图4 CMPP协议栈 6. 通信方式 SP与ISMG之间、ISMG之间进行信息交互时，可以采用长连接方式，也可以采用短连接方式。所谓长连接，指在一个TCP连接上可以连续发送多个数据包，在TCP连接保持期间，如果没有数据包发送，需要双方发链路检测包以维持此连接。短连接是指通信双方有数据交互时，就建立一个TCP连接，数据发送完成后，则断开此TCP连接，即每次TCP连接只完成一对CMPP消息的发送。 6.1 长连接 通信双方以客户-服务器方式建立TCP连接，用于双方信息的相互提交。当信道上没有数据传输时，通信双方应每隔时间C发送链路检测包以维持此连接，当链路检测包发出超过时间T后未收到响应，应立即再发送链路检测包，再连续发送N-1次后仍未得到响应则断开此连接。 参数C、T、N原则上应可配置，现阶段建议取值为:C=30秒，T=60秒，N=3。 网关与SP之间、网关之间的消息发送后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为:T=60秒，N=3。 消息采用并发方式发送，加以滑动窗口流量控制，窗口大小参数W可配置，现阶段建 议为16，即接收方在应答前一次收到的消息最多不超过16条。 长连接的操作流程举例如图5所示: 中国移动通信集团公司研发中心 Page 9 of 25 中国移动通信互联短信网关接口协议 客户端 服务器端 建立TCP连接 CMPP消息1 CMPP消息2 对CMPP消息1的响应 对CMPP消息2的响应 滑动窗口不大于W W . . . . . . TCP建立连接 链路检测包 链路检测包响应 链路检测包 链路检测包响应 . . . . . . TCP建立连接 拆除TCP连接 图5 长连接一次操作流程 中国移动通信集团公司研发中心 Page 10 of 25 中国移动通信互联短信网关接口协议 6.2 短连接 通信双方以客户-服务器方式建立TCP连接，应答与请求在同一个连接中完成。系统采用客户/服务器模式，操作以客户端驱动方式发起连接请求，完成一次操作后关闭此连接。 网关与SP之间、网关之间的消息发送后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为:T=60秒，N=3。 短连接的操作流程举例如图6所示: 建立TCP连接 客户端/服务器服务器/客户端 端 CMPP消息1 对CMPP消息1的响应 拆除TCP连接 建立TCP连接 CMPP消息2 对CMPP消息2的响应 拆除TCP连接 . . . . . . TCP建立连接 图6 短连接的操作流程 中国移动通信集团公司研发中心 Page 11 of 25 中国移动通信互联短信网关接口协议 6.3 本协议中涉及的端口号 端口号 应用 7899 长连接(SP与网关间) 8899 单向长连接(只下行) 6.4 交互过程中的应答方式 在SP与ISMG之间、SMC与ISMG之间及ISMG之间的交互过程中均采用异步方式，即任 一个网元在收到请求消息后应立即回送响应消息。举例如图7所示: SMC ISMG1 ISMG2 SP SMPP请求消息 CMPP请求消息 SMPP响应消息 CMPP响应消息 CMPP请求消息 CMPP响应消息 图7 异步交互方式示意图 7(消息定义 7.1基本数据类型 Unsigned Integer 无符号整数 Integer 整数，可为正整数、负整数或零 Octet String 定长字符串，位数不足时，如果左补0则补ASCII表示的 零，如果右补0则补二进制的零 中国移动通信集团公司研发中心 Page 12 of 25 中国移动通信互联短信网关接口协议 7.2消息结构 项目 说明 Message Header 消息头(所有消息公共包头) Message Body 消息体 7.3 消息头格式(Message Header) 字段名 字节数 描述 类型 Total_Length 4 Unsigned 消息总长度(含消息头及消息体) Integer Command_Id 4 Unsigned 命令或响应类型 Integer Sequence_Id 4 Unsigned 消息流水号,顺序累加,步长为1,循环使用 Integer (一对请求和应答消息的流水号必须相 同) 7.4信息资源站实体(SP)与互联网短信网关(ISMG)间的消息定义 SP与ISMG之间互为客户/服务器，但要求SP首先以客户的身份请求连接到ISMG，之后SP与ISMG之间方可进行数据传输。 7.4.1 SP请求连接到ISMG(CMPP_CONNECT)操作 CMPP_CONNECT操作的目的是SP向ISMG注册作为一个合法SP身份，若注册成功后即建立了应用层的连接，此后SP可以通过此ISMG接收和发送短信。 ISMG以CMPP_CONNECT_RESP消息响应SP的请求。 7.4.1.1 CMPP_CONNECT消息定义(SP,ISMG) 字段名 字节数 属性 描述 Source_Addr 6 Octet String 源地址，此处为SP_Id，即SP的企业 代码。 AuthenticatorSource 16 Octet String 用于鉴别源地址。其值通过单向MD5 hash计算得出，表示如下: 中国移动通信集团公司研发中心 Page 13 of 25 中国移动通信互联短信网关接口协议 AuthenticatorSource = MD5(Source_Addr+9 字节的0 +shared secret+timestamp) Shared secret 由中国移动与源地址实 体事先商定，timestamp格式为: MMDDHHMMSS，即月日时分秒，10 位。 Version 1 Unsigned 双方协商的版本号(高位4bit表示主 Integer 版本号,低位4bit表示次版本号) 填写0x20 Unsigned Timestamp 4 时间戳的明文,由客户端产生,格式为 Integer MMDDHHMMSS，即月日时分秒，10 位数字的整型，右对齐 。 7.4.1.2 CMPP_CONNECT_RESP消息定义(ISMG , SP) 字段名 字节数 描述 属性 1 Unsigned Status 状态 Integer 0:正确 1:消息结构错 2:非法源地址 3:认证错 4:版本太高 5~ :其他错误 100:账户被禁用 101:余额不足 110:连接过多 AuthenticatorISMG 16 Octet String ISMG认证码，用于鉴别ISMG。 其值通过单向MD5 hash计算得出， 表示如下: AuthenticatorISMG =MD5 (Status+AuthenticatorSource+share d secret)，Shared secret 由中国移动 与源地址实体事先商定， AuthenticatorSource为源地址实体 发送给ISMG的对应消息 CMPP_Connect中的值。 认证出错时，此项为空。 此处无定义，请忽略 Version 1 Unsigned 服务器支持的最高版本号 Integer 7.4.2 SP或ISMG请求拆除连接(CMPP_TERMINATE)操作 CMPP_TERMINATE操作的目的是SP或ISMG基于某些原因决定拆除当前的应用层连接而 中国移动通信集团公司研发中心 Page 14 of 25 中国移动通信互联短信网关接口协议 发起的操作。此操作完成后SP与ISMG之间的应用层连接被释放，此后SP若再要与ISMG通信时应发起CMPP_CONNECT操作。 ISMG或SP以CMPP_TERMINATE_RESP消息响应请求。 7.4.2.1 CMPP_TERMINATE消息定义(SP,ISMG或ISMG , SP) 无消息体。 7.4.2.2 CMPP_TERMINATE_RESP消息定义(SP,ISMG或ISMG , SP) 无消息体。 7.4.3 SP向ISMG提交短信(CMPP_SUBMIT)操作 CMPP_SUBMIT操作的目的是SP在与ISMG建立应用层连接后向ISMG提交短信。 ISMG以CMPP_SUBMIT_RESP消息响应。 7.4.3.1 CMPP_SUBMIT消息定义(SP,ISMG) 字段名 字节数 属性 描述 8 Msg_Id Unsigned 信息标识，由SP侧短信网关本身产生， Integer 本处填空。 1 Pk_total Unsigned 相同Msg_Id的信息总条数，从1开始 Integer 通常填充0x01 1 Pk_number Unsigned 相同Msg_Id的信息序号，从1开始 通常填充0x01 Integer 1 Registered_DelUnsigned 是否要求返回状态确认报告: ivery Integer 0:不需要 1:需要 2:产生SMC话单 (该类型短信仅供网关计费使用，不发 送给目的终端) 填充0x01 1 Msg_level Unsigned 信息级别 中国移动通信集团公司研发中心 Page 15 of 25 中国移动通信互联短信网关接口协议 Integer 填充0x00 Service_Id 10 Octet String 业务类型，是数字、字母和符号的组合。 填充0x00 Fee_UserType 1 Unsigned 计费用户类型字段 Integer 0:对目的终端MSISDN计费; 1:对源终端MSISDN计费; 2:对SP计费; 3:表示本字段无效，对谁计费参见 Fee_terminal_Id字段。 填充0xFF Fee_terminal_I21 Unsigned 被计费用户的号码(如本字节填空，则表 d Integer 示本字段无效，对谁计费参见 Fee_UserType字段，本字段与 Fee_UserType字段互斥) 填充0x00 Unsigned TP_pId 1 GSM协议类型。详细是解释请参考 Integer GSM03.40中的9.2.3.9 填充0x00 Unsigned TP_udhi 1 GSM协议类型。详细是解释请参考 Integer GSM03.40中的9.2.3.23,仅使用1位，右 对齐 填充0x00 1 Msg_Fmt Unsigned 信息格式 Integer 0:ASCII串 3:短信写卡操作 4:二进制信息 8:UCS2编码 15:含GB汉字 。。。。。。 通常填充8或15 6 Octet String Msg_src 信息内容来源(SP_Id) 填充0x00 2 Octet String FeeType 资费类别 01:对“计费用户号码”免费 02:对“计费用户号码”按条计信息费 03:对“计费用户号码”按包月收取信息 费 04:对“计费用户号码”的信息费封顶 05:对“计费用户号码”的收费是由SP 实现 填充0x00 6 Octet String FeeCode 资费代码(以分为单位) 填充0x00 ValId_Time 17 Octet String 存活有效期，格式遵循SMPP3.3协议 填充0x00 At_Time 17 Octet String 定时发送时间，格式遵循SMPP3.3协议 填充0x00 Src_Id 21 Octet String 源号码 SP的服务代码或前缀为服务代码的长号 码, 网关将该号码完整的填到SMPP协议 中国移动通信集团公司研发中心 Page 16 of 25 中国移动通信互联短信网关接口协议 Submit_SM消息相应的source_addr字段， 该号码最终在用户手机上显示为短消息 的主叫号码 分配的接入号或接入号+扩展号 1 Unsigned DestUsr_tl 接收信息的用户数量(小于100个用户) Integer 填充1 Dest_terminal_Id 21*DestUsr_tl Octet String 接收短信的MSISDN号码 只允许1个号码 Msg_Length 1 Unsigned 信息长度(Msg_Fmt值为0时:<160个字 Integer 节;其它<=140个字节) 内容的字节数 Msg_Content Msg_length Octet String 信息内容 不包含结束符(‘\0’) Reserve 8 Octet String 保留 以0x00填充 注意:关于短信群发的问题，若SP对于群发消息不要求状态报告的回送时，才可以考虑群发，否则必须逐条发送。 7.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 1 Unsigned 结果 Integer 0:正确 1:消息结构错 中国移动通信集团公司研发中心 Page 17 of 25 中国移动通信互联短信网关接口协议 2:命令字错 3:消息序号重复 4:消息长度错 5:资费代码错 6:超过最大信息长 7:业务代码错 8:流量控制错 9 :其他错误 10:Src_Id错误; 11:Msg_src错误; 12:Fee_terminal_Id错误; 13:Dest_terminal_Id错误; 100:账户被禁用 101:余额不足 102:认证错 103:黑名单过滤 104:无内容或关键字过滤 105:端口不可用 106:发送时段不符 110:连接过多 200:端口错误 201:端口源地址错误 202:端口无反馈错误 7.4.5 ISMG向SP送交短信(CMPP_DELIVER)操作 CMPP_DELIVER操作的目的是ISMG把从短信中心或其它ISMG转发来的短信送交SP， SP以CMPP_DELIVER_RESP消息回应。 7.4.5.1 CMPP_DELIVER消息定义(ISMG,SP) 字段名 字节数 属性 描述 Msg_Id 8 Unsigned Integer 信息标识 生成算法如下: 采用64位(8字节)的整数: (1)时间(格式为 MMDDHHMMSS，即月日时 分秒):bit64~bit39，其中 bit64~bit61:月份的二进制表 示; bit60~bit56:日的二进制表示; bit55~bit51:小时的二进制表 示; 中国移动通信集团公司研发中心 Page 18 of 25 中国移动通信互联短信网关接口协议 bit50~bit45:分的二进制表示; bit44~bit39:秒的二进制表示; (2)短信网关代码:bit38~bit17， 把短信网关的代码转换为整 数填写到该字段中。 (3)序列号:bit16~bit1，顺序增加， 步长为1，循环使用。 各部分如不能填满，左补零，右对 齐。 Dest_Id 21 Octet String 目的号码 SP的服务代码，一般4--6位，或者 是前缀为服务代码的长号码;该号 码是手机用户短消息的被叫号码。 Service_Id 10 Octet String 业务类型，是数字、字母和符号的 组合。 Unsigned Integer TP_pid 1 GSM协议类型。详细解释请参考 GSM03.40中的9.2.3.9 Unsigned Integer TP_udhi 1 GSM协议类型。详细解释请参考 GSM03.40中的9.2.3.23，仅使用1 位，右对齐 Msg_Fmt 1 Unsigned 信息格式 Integer 0:ASCII串 3:短信写卡操作 4:二进制信息 8:UCS2编码 15:含GB汉字 Src_terminal_Id 21 Octet String 源终端MSISDN号码(状态报告时 填为CMPP_SUBMIT消息的目的终 端号码) 1 Registered_DeliverUnsigned 是否为状态报告 y Integer 0:非状态报告 1:状态报告 Msg_Length 1 Unsigned 消息长度 Integer Msg_Content Msg_length Octet String 消息内容 8 Octet String Reserved 保留项 当ISMG向SP送交状态报告时，信息内容字段(Msg_Content)格式定义如下: 字段名 字节数 属性 描述 Msg_Id 8 Unsigned 信息标识 Integer SP提交短信(CMPP_SUBMIT)操作时，与SP 相连的ISMG产生的Msg_Id。 Stat 7 Octet String 发送短信的应答结果，含义与SMPP协议要求 中stat字段定义相同，详见表一。SP根据该字 段确定CMPP_SUBMIT消息的处理状态。 Submit_time 10 Octet String YYMMDDHHMM(YY为年的后两位00-99， MM:01-12，DD:01-31，HH:00-23，MM: 00-59) 中国移动通信集团公司研发中心 Page 19 of 25 中国移动通信互联短信网关接口协议 Done_time 10 Octet String YYMMDDHHMM Dest_terminal_Id 21 Octet String 目的终端MSISDN号码(SP发送 CMPP_SUBMIT消息的目标终端) SMSC_sequence 4 Unsigned 取自SMSC发送状态报告的消息体中的消息标 Integer 识。 表一 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 注意: 1(其中ACCEPTED为中间状态，网关若从短信中心收到后应丢弃，不做任何操作。 2(Stat字段长度为7个字节，填写时应填表一中Final Message States中的缩写形式，如 状态为DELIVERED时填写DELIVRD，依此类推。 3(SP等待状态报告缺省时间为48小时。 7.4.5.2 CMPP_DELIVER_RESP消息定义(SP , ISMG) 字段名 字节数 属性 描述 Msg_Id 8 Unsigned Integer 信息标识 (CMPP_DELIVER中的Msg_Id 字段) Result 1 Unsigned 结果 Integer 0:正确 1:消息结构错 2:命令字错 3:消息序号重复 4:消息长度错 5:资费代码错 6:超过最大信息长 7:业务代码错 中国移动通信集团公司研发中心 Page 20 of 25 中国移动通信互联短信网关接口协议 8: 流量控制错 9~ :其他错误 7.4.6 链路检测(CMPP_ACTIVE_TEST)操作 本操作仅适用于通信双方采用长连接通信方式时用于保持连接。 7.4.7.1 CMPP_ACTIVE_TEST定义(SP , ISMG或ISMG,SP) 无消息体。 7.4.7.2 CMPP_ACTIVE_TEST_RESP定义(SP , ISMG或ISMG,SP) 字段名 字节数 属性 描述 Reserved 1 7.5互联网短信网关(ISMG)之间的消息定义 网关之间互为客户/服务器，任一方都可在需要时建立连接进行数据传输。 7.5.1 源ISMG请求连接到目的ISMG(CMPP_CONNECT)操作 消息定义同7.4.1.1和7.4.1.2所述。其中Source_Addr填源网关代码。 7.5.2 源ISMG请求拆除到目的ISMG的连接(CMPP_TERMINATE)操作 消息定义同7.4.2.1和7.4.2.2所述。 7.5.3链路检测(CMPP_ACTIVE_TEST)操作 本操作仅用于通信双方采用长连接通信方式时保持连接。消息定义同7.4.6.1和7.4.6.2所述。 中国移动通信集团公司研发中心 Page 21 of 25 中国移动通信互联短信网关接口协议 7.7系统定义 7.7.1 Command_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路由更新应答 中国移动通信集团公司研发中心 Page 22 of 25 中国移动通信互联短信网关接口协议 附录1 MO状态报告的产生 为解决MO业务计费及使源网关获知SP对转发的MO消息的接收状态，现要求网关处理流程如下图所示: MSCSMSCISMG1ISMG2SP 1:提交短消息 2:提交短消息应答3:DELIVER_SM(SMPP) 4:DELIVER_SM_RESP(SMPP) 5:CMPP_FWD 6: CMPP_FWD_RESP 7:CMPP_DELIVER 8:CMPP_DELIVER_RESP 9: CMPP_FWD网关产生的MO状态报告10:CMPP_FWD 附录1-图1 MO状态报告的产生 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消息应答; 中国移动通信集团公司研发中心 Page 23 of 25 中国移动通信互联短信网关接口协议 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 Octet SP的应答结果，CMPP_DELIVER_RESP中 String Result值的字符表示，左对齐。Result为0时， 填字符DELIVRD，其余值填REJECTD CMPP_Deliver_time 10 Octet YYMMDDHHMM(YY为年的后两位00-99， String MM:01-12，DD:01-31，HH:00-23，MM: 00-59) 注:短信网关发出CMPP_DELIVER的时间。 CMPP_Deliver_RESP_10 Octet YYMMDDHHMM time String 注:短信网关收到CMPP_DELIVER_RESP 的时间。 Dest_Id 21 Octet 目的SP的服务代码，左对齐。 String Reserved 4 Reserved 中国移动通信集团公司研发中心 Page 24 of 25 中国移动通信互联短信网关接口协议 修订历史 版本号 时间 主要内容或重大修改 CMPP V1.2.1 2001.6 CMPP V2.0 2002.4 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. 对原协议中的端口号作了重新规定。 中国移动通信集团公司研发中心 Page 25 of 25