思迅通

CMPP2.0协议网关【开发 实例 文档 代码】发布时间:2018-06-08 11:24:27

 CMPP互联网fun88体育网关接口协议(V2.0)
本规范为中国移动通信集团公司企业规范,简称CMPP,现阶段版本是对1.2.1版修订后形成的,为2.0版。本规范描述了中国移动fun88体育业务中各网元(包括ISMG、GNS和SP)之间的相关消息的类型和定义。根据业务的发展,规范中的信令操作和参数将会做进一步的调整和增加。

1         范围

本规范规定了以下三方面的内容:
(1)信息资源站实体与互联网fun88体育网关之间的接口协议;
(2)互联网fun88体育网关之间的接口协议;
(3)互联网fun88体育网关与汇接网关之间的接口协议。
本规范适用于各SP和ISMG的开发厂商。

cmpp2.0

2         缩略语

英文缩写英文全称说明
ISMG          Internet Short Message Gateway互联网fun88体育网关
SMPP            Short Message Peer to Peer短消息点对点协议
CMPP            China Mobile Peer to Peer中国移动点对点协议
SMCShort Message Center短消息
GNS             Gateway Name Server网关名称服务器(汇接网关)
SP               Service Provider业务提供者,即信息资源站实体
SMCShort Message ControlSP为收取包月业务费用而向网关发送的消息,网关收到后不送给用户仅产生相应的话单;
ISMG_Id
网关代码:0XYZ01~0XYZ99,其中XYZ为省会区号,位数不足时左补零,如北京编号为1的网关代码为001001,江西编号为1的网关代码为079101,依此类推。
SP_Id
SP的企业代码:网络中SP地址和身                                               份的标识、地址翻译、计费、结算等                                               均以企业代码为依据。企业代码以数                                               字表示,共6位,从“9XY000”至                                              “9XY999”,其中“XY”为各移动公                                               司代码。
SP_Code
SP的服务代码:服务代码是在使用                                            fun88体育方式的点播类业务中,提供给                                            用户点播的内容/应用服务提供商代                                             码。服务代码以数字表示,业                                             务服务代码长度统一为 4 位,即                                            “1000”-“9999”;本地业务服务                                              代码长度统一为5 位,即                                              “01000”-“09999”。
Service_Id
SP的业务类型,数字、字母和符号的                                              组合,由SP自定,如图片传情可定                                             为TPCQ,股票查询可定义为11。

 

3.网络结构


如图1所示,互联网fun88体育网关(ISMG)是外部信息资源站实体(SP)与移动网内fun88体育之间的中介实体,互联网fun88体育网关一方面负责接收SP发送给移动用户的信息和提交给fun88体育。另一方面,移动用户点播SP业务的信息将由fun88体育通过互联网fun88体育网关发给SP。另外,为了减轻fun88体育的信令负荷,互联网fun88体育网关还应根据路由原则将SP提交的信息转发到相应的互联网fun88体育网关。互联网fun88体育网关通过向汇接网关(GNS)查询的方式获得网关间的转发路由信息。
 

4.CMPP功能概述

CMPP协议主要提供以下两类业务操作:
(1)           fun88体育发送(Short Message Mobile Originate,SM MO)

图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)           fun88体育接收(Short Message Mobile Terminated,SM MT)
 

图3  需要前转的MT示意图

             
1)        SP发出数据请求(可能是fun88体育通知或手机铃声等),被源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)给fun88体育,fun88体育将按照MO操作的流程将状态报告返回给SP(如果SP要求返回状态报告)。

5. 协议栈

CMPP协议以TCP/IP作为底层通信承载,具体结构由图4所示: 
 

图4 CMPP协议栈

6. 通信方式

SP与ISMG之间、ISMG之间进行信息交互时,可以采用长连接方式,也可以采用短连接方式。所谓长连接,指在一个TCP连接上可以连续发送多个数据包,在TCP连接保持期间,如果没有数据包发送,需要双方发链路检测包以维持此连接。短连接是指通信双方有数据交互时,就建立一个TCP连接,数据发送完成后,则断开此TCP连接,即每次TCP连接只完成一对CMPP消息的发送。
 

6.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条。
   

6.2                            短连接

通信双方以客户-服务器方式建立TCP连接,应答与请求在同一个连接中完成。系统采用客户/服务器模式,操作以客户端驱动方式发起连接请求,完成操作后关闭此连接。
    网关与SP之间、网关之间的消息发送后等待T秒后未收到响应,应立即重发,再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为:T=60秒,N=3。
短连接的操作流程举例
 

图6 短连接的操作流程

6.3              本协议中涉及的端口号

端口号应用
7890              长连接(SP与网关间)
7900短连接(SP与网关间或网关之间)
7930      长连接(网关之间)
9168短连接(fun88体育网关与汇接网关之间)

 

6.4  交互过程中的应答方式

在SP与ISMG之间、SMC与ISMG之间及ISMG之间的交互过程中均采用异步方式,即任一个网元在收到请求消息后应立即回送响应消息。举例如图7所示:


图7 异步交互方式示意图
 

7.消息定义

 7.1基本数据类型

Unsigned Integer 无符号整数
Integer整数,可为正整数、负整数或零
Octet String定长字符串,位数不足时,如果左补0则补ASCII表示的零,如果右补0则补二进制的零

7.2消息结构

项目说明
Message Header消息头(消息公共包头)
Message Body消息体

 

7.3 消息头格式(Message Header)

字段名字节数类型描述
Total_Length 4Unsigned  Integer消息总长度(含消息头及消息体)
Command_Id4Unsigned Integer命令或响应类型
Sequence_Id4Unsigned Integer消息流水号,顺序累加,步长为1,循环使用(一对请求和应答消息的流水号需要相同)

 

7.4信息资源站实体(SP)与互联网fun88体育网关(ISMG)间的消息定义

SP与ISMG之间互为客户/服务器,但要求SP首先以客户的身份请求连接到ISMG,之后SP与ISMG之间方可进行数据传输。

7.4.1 SP请求连接到ISMG(CMPP­_CONNECT)操作

 
CMPP_CONNECT操作的目的是SP向ISMG注册作为一个合法SP身份,若注册成功后即建立了应用层的连接,此后SP可以通过此ISMG接收和发送fun88体育。
ISMG以CMPP_CONNECT_RESP消息响应SP的请求。

7.4.1.1 CMPP_CONNECT消息定义(SPàISMG)

字段名字节数属性描述
Source_Addr 6Octet String源地址,此处为SP_Id,即SP的企业代码。
AuthenticatorSource16Octet String用于鉴别源地址。其值通过单向MD5 hash计算得出,表示如下:
AuthenticatorSource =
MD5(Source_Addr+9 字节的0 +shared secret+timestamp)
Shared secret 由中国移动与源地址实体事先商定,timestamp格式为:MMDDHHMMSS,即月日时分秒,10位。
Version1Unsigned Integer双方协商的版本号(高位4bit表示主版本号,低位4bit表示次版本号)
Timestamp4Unsigned Integer时间戳的明文,由客户端产生,格式为MMDDHHMMSS,即月日时分秒,10位数字的整型,右对齐 。

7.4.1.2 CMPP_CONNECT_RESP消息定义(ISMG à SP)

字段名字节数属性描述
Status1Unsigned Integer状态
0:正确
1:消息结构错
 2:非法源地址
 3:认证错
 4:版本太高
  5~ :其他错误
AuthenticatorISMG16Octet StringISMG认证码,用于鉴别ISMG。
其值通过单向MD5 hash计算得出,表示如下:
AuthenticatorISMG =MD5(Status+AuthenticatorSource+shared secret),Shared secret 由中国移动与源地址实体事先商定,AuthenticatorSource为源地址实体发送给ISMG的对应消息CMPP_Connect中的值。
 认证出错时,此项为空。
Version1Unsigned Integer服务器支持的好高版本号

 

7.4.2  SP或ISMG请求拆除连接(CMPP­_TERMINATE)操作

CMPP_TERMINATE操作的目的是SP或ISMG基于某些原因决定拆除当前的应用层连接而发起的操作。此操作完成后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提交fun88体育(CMPP­_SUBMIT)操作

CMPP_SUBMIT操作的目的是SP在与ISMG建立应用层连接后向ISMG提交fun88体育。
ISMG以CMPP_SUBMIT_RESP消息响应。
 

7.4.3.1 CMPP­_SUBMIT消息定义(SPàISMG)

字段名字节数属性描述
Msg_Id8Unsigned Integer信息标识,由SP侧fun88体育网关本身产生,本处填空。
Pk_total1Unsigned Integer相同Msg_Id的信息总条数,从1开始
Pk_number1Unsigned Integer相同Msg_Id的信息序号,从1开始
Registered_Delivery1Unsigned Integer是否要求返回状态确认报告:
0:不需要
1:需要
2:产生SMC话单
 (该类型fun88体育仅供网关计费使用,不发送给目的终端)
Msg_level1Unsigned Integer信息级别
Service_Id10Octet String业务类型,是数字、字母和符号的组合。
Fee_UserType1Unsigned Integer计费用户类型字段
0:对目的终端MSISDN计费;
1:对源终端MSISDN计费;
2:对SP计费;
3:表示本字段无效,对谁计费参见Fee_terminal_Id字段。
Fee_terminal_Id21Unsigned Integer被计费用户的号码(如本字节填空,则表示本字段无效,对谁计费参见Fee_UserType字段,本字段与Fee_UserType字段互斥)
TP_pId1Unsigned IntegerGSM协议类型。详细是解释请参考GSM03.40中的9.2.3.9
TP_udhi1Unsigned IntegerGSM协议类型。详细是解释请参考GSM03.40中的9.2.3.23,仅使用1位,右对齐
Msg_Fmt1Unsigned Integer信息格式
  0:ASCII串
  3:fun88体育写卡操作
  4:二进制信息
  8:UCS2编码
15:含GB汉字  。。。。。。
Msg_src6Octet String信息内容来源(SP_Id)
FeeType2Octet String资费类别
01:对“计费用户号码”
02:对“计费用户号码”按条计信息费
03:对“计费用户号码”按包月收取信息费
04:对“计费用户号码”的信息费封顶
05:对“计费用户号码”的收费是由SP实现
FeeCode6Octet String资费代码(以分为单位)
ValId_Time17Octet String存活期,格式遵循SMPP3.3协议
At_Time17Octet String定时发送时间,格式遵循SMPP3.3协议
Src_Id21Octet String源号码
SP的服务代码或前缀为服务代码的长号码, 网关将该号码完整的填到SMPP协议Submit_SM消息相应的source_addr字段,该号码好终在用户手机上显示为短消息的主叫号码
DestUsr_tl1Unsigned Integer接收信息的用户数量(小于100个用户)
Dest_terminal_Id21*DestUsr_tlOctet String接收fun88体育的MSISDN号码
Msg_Length1Unsigned Integer信息长度(Msg_Fmt值为0时:<160个字节;其它<=140个字节)
Msg_ContentMsg_lengthOctet String信息内容
Reserve8Octet String保留

 
注意:关于fun88体育软件的问题,若SP对于群发消息不要求状态报告的回送时,才可以考虑群发,否则需要逐条发送。
 

7.4.3.2 CMPP­_SUBMIT_RESP消息定义(ISMG à SP)

 

字段名字节数属性描述
Msg_Id8Unsigned Integer信息标识,生成算法如下:
采用64位(8字节)的整数:
(1)时间(格式为MMDDHHMMSS,即月日时分秒):bit64~bit39,其中
bit64~bit61:月份的二进制表示;
bit60~bit56:日的二进制表示;
bit55~bit51:小时的二进制表示;
bit50~bit45:分的二进制表示;
bit44~bit39:秒的二进制表示;
(2)fun88体育网关代码:bit38~bit17,把fun88体育网关的代码转换为整数填写到该字段中。
(3)序列号:bit16~bit1,顺序增加,步长为1,循环使用。
各部分如不能填满,左补零,右对齐。
 
(SP根据请求和应答消息的Sequence_Id一样性就可得到CMPP_Submit消息的Msg_Id)
Result1Unsigned Integer结果
0:正确
1:消息结构错
 2:命令字错
 3:消息序号重复
4:消息长度错
5:资费代码错
6:超过好大信息长
7:业务代码错
8:流量控制错
9~ :其他错误

 

7.4.4  SP向ISMG查询发送fun88体育状态(CMPP­_QUERY)操作

CMPP_QUERY操作的目的是SP向ISMG查询某时间的业务统计情况,可以按总数或按业务代码查询。   ISMG以CMPP_QUERY_RESP应答。
 
 

7.4.4.1 CMPP_QUERY消息的定义(SPàISMG)

字段名字节数属性描述
Time8Octet String时间YYYYMMDD(至日)
Query_Type1Unsigned Integer查询类别
0:总数查询
1:按业务类型查询
Query_Code10Octet String查询码
当Query_Type为0时,此项无效;当Query_Type为1时,此项填写业务类型Service_Id.
Reserve8Octet String保留

 

7.4.4.2 CMPP_QUERY_RESP消息的定义(ISMG àSP)

字段名字节数属性描述
Time8Octet String时间(至日)
Query_Type1Unsigned Integer查询类别
0:总数查询
1:按业务类型查询
Query_Code10Octet String查询码
MT_TLMsg4Unsigned Integer从SP接收信息总数
MT_Tlusr4Unsigned Integer从SP接收用户总数
MT_Scs4Unsigned Integer成功转发数量
MT_WT4Unsigned Integer待转发数量
MT_FL4Unsigned Integer转发失败数量
MO_Scs4Unsigned Integer向SP成功送达数量
MO_WT4Unsigned Integer向SP待送达数量
MO_FL4Unsigned Integer向SP送达失败数量

 

7.4.5  ISMG向SP送交fun88体育(CMPP­_DELIVER)操作

CMPP_DELIVER操作的目的是ISMG把从fun88体育或其它ISMG转发来的fun88体育送交SP,SP以CMPP_DELIVER_RESP消息回应。

7.4.5.1 CMPP_DELIVER消息定义(ISMGàSP)

字段名字节数属性描述
Msg_Id8Unsigned Integer信息标识
生成算法如下:
采用64位(8字节)的整数:
(1)时间(格式为MMDDHHMMSS,即月日时分秒):bit64~bit39,其中
bit64~bit61:月份的二进制表示;
bit60~bit56:日的二进制表示;
bit55~bit51:小时的二进制表示;
bit50~bit45:分的二进制表示;
bit44~bit39:秒的二进制表示;
(2)fun88体育网关代码:bit38~bit17,把fun88体育网关的代码转换为整数填写到该字段中。
(3)序列号:bit16~bit1,顺序增加,步长为1,循环使用。
各部分如不能填满,左补零,右对齐。
Dest_Id21Octet String目的号码
SP的服务代码,一般4--6位,或者是前缀为服务代码的长号码;该号码是手机用户短消息的被叫号码。
Service_Id10Octet String业务类型,是数字、字母和符号的组合。
TP_pid1Unsigned IntegerGSM协议类型。详细解释请参考GSM03.40中的9.2.3.9
TP_udhi1Unsigned IntegerGSM协议类型。详细解释请参考GSM03.40中的9.2.3.23,仅使用1位,右对齐
Msg_Fmt1Unsigned Integer信息格式
  0:ASCII串
  3:fun88体育写卡操作
  4:二进制信息
  8:UCS2编码
15:含GB汉字   
Src_terminal_Id21Octet String源终端MSISDN号码(状态报告时填为CMPP_SUBMIT消息的目的终端号码)
Registered_Delivery1Unsigned Integer是否为状态报告
0:非状态报告
1:状态报告
Msg_Length1Unsigned Integer消息长度
Msg_ContentMsg_lengthOctet String消息内容
Reserved8Octet String保留项

 
当ISMG向SP送交状态报告时,信息内容字段(Msg_Content)格式定义如下:
 

字段名字节数属性描述
Msg_Id8Unsigned Integer信息标识
SP提交fun88体育(CMPP_SUBMIT)操作时,与SP相连的ISMG产生的Msg_Id。
Stat7Octet String发送fun88体育的应答结果,含义与SMPP协议要求中stat字段定义相同,详见表一。SP根据该字段确定CMPP_SUBMIT消息的处理状态。
Submit_time10Octet StringYYMMDDHHMM(YY为年的后两位00-99,MM:01-12,DD:01-31,HH:00-23,MM:00-59)
Done_time10Octet StringYYMMDDHHMM
Dest_terminal_Id21Octet String目的终端MSISDN号码(SP发送CMPP_SUBMIT消息的目标终端)
SMSC_sequence4Unsigned Integer取自SMSC发送状态报告的消息体中的消息标识。

 
表一  Stat字段定义

Message StateFinal Message StatesDescription
DELIVEREDDELIVRDMessage is delivered to destination
EXPIREDEXPIREDMessage validity period has
expired
DELETEDDELETEDMessage has been deleted.
UNDELIVERABLEUNDELIVMessage is undeliverable
ACCEPTEDACCEPTDMessage is in accepted state(i.e. has been manually read on behalf of the subscriber by customer service)
UNKNOWNUNKNOWNMessage is in invalid state
REJECTEDREJECTDMessage is in a rejected state

 
 
 
 
注意:
1.其中ACCEPTED为中间状态,网关若从fun88体育收到后应丢弃,不做操作。
2.Stat字段长度为7个字节,填写时应填表一中Final Message States中的缩写形式,如
   状态为DELIVERED时填写DELIVRD,依此类推。
3.SP等待状态报告缺省时间为48小时。
 

7.4.5.2 CMPP_DELIVER_RESP消息定义(SP à ISMG)

字段名字节数属性描述
Msg_Id8Unsigned Integer信息标识
(CMPP_DELIVER中的Msg_Id字段)
Result1Unsigned Integer结果
0:正确
1:消息结构错
 2:命令字错
 3:消息序号重复
4:消息长度错
5:资费代码错
6:超过好大信息长
7:业务代码错
8: 流量控制错
9~ :其他错误

 

7.4.6             SP向ISMG发起删除fun88体育(CMPP­_CANCEL)操作

CMPP_CANCEL操作的目的是SP通过此操作可以将已经提交给ISMG的fun88体育删除,ISMG将以CMPP_CANCEL_RESP回应删除操作的结果。
 

7.4.6.1 CMPP_CANCEL消息定义(SP à ISMG)

字段名字节数属性描述
Msg_Id8Unsigned Integer信息标识(SP想要删除的信息标识)

 

7.4.6.2 CMPP_CANCEL_RESP消息定义(ISMG à SP)

字段名字节数属性描述
Success_Id1Unsigned Integer成功标识
0:成功
1:失败

 
 

7.4.7             链路检测(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)

字段名字节数属性描述
Reserved1

 
 

7.5互联网fun88体育网关(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所述。

7.5.4 源ISMG向目的ISMG转发fun88体育(CMPP­_FWD)操作

CMPP_FWD操作的目的是源ISMG可以根据一定的路由策略将SP提交的fun88体育、MO状态报告、fun88体育产生的状态报告、用户提交的fun88体育转发到目的ISMG,目的ISMG以CMPP_FWD_RESP回应。

7.5.4.1 CMPP_FWD定义(ISMGà ISMG)

字段名字节数属性描述
Source_ Id6Octet String源网关的代码(右对齐,左补0)
Destination_Id6Octet String目的网关代码(右对齐,左补0)
NodesCount1Unsigned Integer经过的网关数量
Msg_Fwd_Type1Unsigned Integer前转的消息类型
0:MT前转
1:MO前转
2:MT时的状态报告
3:MO时的状态报告
Msg_Id8Unsigned Integer信息标识
Pk_total1Unsigned Integer相同Msg_Id的消息总条数,从1开始
Pk_number1Unsigned Integer相同Msg_Id的消息序号,从1开始
Registered_Delivery1Unsigned Integer是否要求返回状态确认报告
0:不需要
1:需要
2:产生SMC话单
Msg_level1Unsigned Integer信息级别
Service_Id10Octet String业务类型
Fee_UserType1Unsigned Integer计费用户类型字段
0:对目的终端MSISDN计费;
1:对源终端MSISDN计费;
2:对SP计费;
3: 表示本字段无效,对谁计费参见Fee_terminal_Id字段。
Fee_terminal_Id21Unsigned Integer被计费用户的号码(如本字节填空,则表示本字段无效,对谁计费参见Fee_UserType字段。本字段与Fee_UserType字段互斥)
TP_pid1Unsigned IntegerGSM协议类型。详细解释请参考GSM03.40中的9.2.3.9
TP_udhi1Unsigned IntegerGSM协议类型。详细解释请参考GSM03.40中的9.2.3.23,仅使用1位,右对齐
Msg_Fmt1Unsigned Integer信息格式
  0:ASCII串
  3:fun88体育写卡操作
  4:二进制信息
  8:UCS2编码
15:含GB汉字  
Msg_src6Octet String信息内容来源(SP_Id,SP的企业代码)
FeeType2Octet String资费类别
00:“短消息类型”为“发送”,对“计
费用户号码”不计信息费,此类
话单仅用于核减SP对称的信道费
01:对“计费用户号码”
02:对“计费用户号码”按条计信息
    费
03:对“计费用户号码”按包月收取
    信息费
04:对“计费用户号码”的信息费封
    顶
05:对“计费用户号码”的收费是由SP
    实现
FeeCode6Octet String资费代码(以分为单位)
Valid_Time17Octet String
At_Time17Octet String定时发送的时间
Src_Id21Octet String源号码
1.   MT时为SP的服务代码,即CMPP_SUBMIT消息中的Src_Id。
2.   MO时为发送此消息的源终端MSISDN号码。
3.   MT状态报告时,可填空或填接收到fun88体育的终端MSISDN号码,即对应CMPP_SUBMIT消息中的Dest_Terminal_Id。
4.   MO状态报告时,可填空或填SP的服务代码,即CMPP_DELIVER中的Dest_Id。
DestUsr_tl1Unsigned Integer接收消息的用户数量
Dest_Id21*DestUsr_tlOctet String目的号码
1.MT转发时为目的终端MSISDN号码,即对应CMPP_SUBMIT消息中的Dest_Terminal_Id。
2.MO转发时为SP的服务代码,一般4--6位,或者是前缀为服务代码的长号码,该号码是手机用户短消息的被叫号码。
3.MT状态报告时,可填空或填目的SP的服务代码,即CMPP_SUBMIT消息中的Src_Id。
4.MO状态报告时,可填空或填发送fun88体育的移动用户MSISDN号码。
Msg_Length1Unsigned Integer消息长度
Msg_ContentMsg_lengthOctet String消息内容
Reserve8
保留

 
注意:
1.对于包月的SMC消息,应由ISMG向SP返回成功与否的状态报告,格式同7.4.5.1定义,若成功回送Stat值为“DELIVRD”,失败则回送Stat值“UNDELIV”。
2.当转发消息为MO状态报告(MO状态报告的产生见附录1)时,信息内容字段(Msg_Content)格式定义如下:

字段名字节数属性描述
Msg_Id8Unsigned Integer信息标识
给SP的CMPP_Deliver消息中的Msg_Id,与源网关转发MO消息时产生的Msg_Id相同。
Stat7Octet StringSP的应答结果,CMPP_DELIVER_RESP中Result为0时,填字符DELIVRD,其余值填REJECTD。
CMPP_DELIVER_time10Octet StringYYMMDDHHMM(YY为年的后两位00-99,MM:01-12,DD:01-31,HH:00-23,MM:00-59)
注:fun88体育网关发出CMPP_DELIVER的时间。
CMPP_DELIVER_RESP_time10Octet StringYYMMDDHHMM
注:fun88体育网关收到CMPP_DELIVER_RESP的时间。
Dest_Id21Reserved目的SP的服务代码,左对齐。
Reserved4

 
注意:
在MO流程中,若fun88体育经ISMG2转发给与SP相连的ISMG1,ISMG1在给SP发送消息时可能存在四种情况:①发送消息前连接断开;②多次发送消息后没有接收到响应消息;③发送消息后接收到错误的响应消息;④发送消息后接收到正确的应答消息。对这四种情况的处理描述如下:
       ①②③:ISMG1在处理这三种情况的时候,向ISMG2发送MO状态报告,状态报告中的stat字段取值为“REJECTD”。
       ④:ISMG1在处理这种情况时,向ISMG2发送MO状态报告,其中stat字段取值“DELIVRD”。
3.当转发消息为MT状态报告时,信息内容字段(Msg_Content)格式同7.4.5.1定义。若SP发送的fun88体育经由ISMG1转发给ISMG2,ISMG1给ISMG2发送消息时可能存在四种情况:①发送消息前连接断开;②多次发送消息后没有接收到响应消息;③发送消息后接收到错误的响应消息;④发送消息后接收到正确的应答消息。对这四种情况的处理描述如下:
       ①②③:ISMG1在处理这三种情况的时候,向SP发送MT状态报告(如果SP要求状态报告),状态报告中的stat字段取值为“REJECTD”。
       ④:ISMG1在处理这种情况时,继续等待ISMG2返回状态报告。
随后,ISMG2给SMC发送消息时可能存在四种情况:①发送消息前连接断开;②多次发送消息后没有接收到响应消息;③发送消息后接收到错误的响应消息;④发送消息后接收到正确的应答消息。对这四种情况的处理描述如下:
       ①②③:ISMG2在处理这三种情况的时候,向SP发送MT状态报告(如果SP要求状态报告),状态报告中的stat字段取值为“REJECTD”。
       ④:ISMG2在处理这种情况时,继续等待SMC返回状态报告。
 

7.5.4.2 CMPP_FWD_RESP定义(ISMGà ISMG)

字段名字节数属性描述
Msg_Id8Unsigned Integer信息标识(CMPP_FWD中字段值)
Pk_total1Unsigned Integer相同Msg_Id的消息总条数
Pk_number1Unsigned Integer相同Msg_Id的消息序号
Result1Unsigned Integer结果
0:正确
1:消息结构错
 2:命令字错
 3:消息序号重复
4:消息长度错
5:资费代码错
6:超过好大信息长
7:业务代码错
8: 流量控制错
9: 前转判断错(此SP不应发往本ISMG)
10~ :其他错误

 
 
 

7.6互联网fun88体育网关(ISMG)与汇接网关(GNS)之间的消息定义

要求ISMG与GNS在信息交互时使用短连接的通信方式。ISMG与GNS可互为客户/服务器。

7.6.1 ISMG请求连接到GNS或GNS请求连接到ISMG(CMPP_CONNECT)操作

消息定义同7.4.1.1和7.4.1.2所述,其中Source_Addr填源网关代码,可能是ISMG代码或GNS代码。

7.6.2 ISMG请求拆除到GNS的连接或GNS请求拆除到ISMG的连接(CMPP­_TERMINATE)操作

消息定义同7.4.2.1和7.4.2.2所述。

7.6.3 ISMG向汇接网关查询MT路由(CMPP_MT_ROUTE)操作

CMPP_MT_ROUTE操作用于ISMG不知道需要转发MT消息的路由时查询GNS。GNS以CMPP_MT_ROUTE_RESP应答。

7.6.3.1 CMPP_MT_ROUTE消息定义(ISMGàGNS)

字段名字节数属性描述
Source_Id6Octet String源网关代码
Terminal_Id21Octet String目的终端MSISDN号码

7.6.3.2 CMPP_MT_ROUTE_RESP消息定义(GNS à ISMG)

字段名字节数属性描述
Route_Id4Unsigned Integer路由编号(从0开始,由GNS统一分配)
Destination_Id6Octet String目标网关代码
Gateway_IP15Octet String目标网关IP地址
Gateway_port2Unsigned Integer目标网关IP端口(7890或7900)
Start_Id6Octet StringMT路由起始号码段
End_Id6Octet StringMT路由截止号码段
Area_code4Octet String手机所属省代号
Result1Unsigned Integer结果
0:正常
1:没有匹配路由
2:这是好后1条路由

 

7.6.4 ISMG向汇接网关查询MO路由(CMPP_MO_ROUTE)操作

CMPP_MO_ROUTE操作的目的是使ISMG当不知道需要转发MO消息的路由时可向GNS查询得到。GNS以CMPP_MO_ROUTE_RESP应答。

7.6.4.1 CMPP_MO_ROUTE消息定义(ISMGàGNS)

字段名字节数属性描述
Source_Id6Octet String源网关代码
SP_Code21Octet StringSP的服务代码
Service_Id10Octet String请求的业务类型(此项适合服务内容,如爱心卡图片传情)
Service_Code4Unsigned Integer请求的业务代码
(如果未置Service_Id字段,此字段为空,如爱心卡图片传情TPCQ1000—2000对应某个网站的某些相应图片)

7.6.4.2 CMPP_MO_ROUTE_RESP消息定义(GNS à ISMG)

字段名字节数属性描述
Route_Id4Unsigned Integer路由编号
Destination_Id6Octet String目标网关代码
Gateway_IP15Octet String目标网关IP地址
Gateway_port2Unsigned Integer目标网关IP端口
SP_Id21Octet StringSP的企业代码
Start_code4Unsigned IntegerMO路由起始业务代码
(如果未置请求的Service_Id字段,此字段为空)
End_code4Unsigned IntegerMO路由截止业务代码
(如果未置请求的Service_Id字段,此字段为空)
Result1Unsigned Integer结果
0:正常
1:没有匹配路由
2:这是好后1条路由

 

7.6.5ISMG向汇接网关获取路由(CMPP_GET_ROUTE)操作

CMPP_GET_ROUTE操作的目的是使ISMG可向GNS查询MO或MT时的路由信息。GNS以CMPP_GET_ROUTE_RESP消息回应。

7.6.5.1 CMPP_GET_ ROUTE消息定义(ISMGàGNS)

字段名字节数属性描述
Source_Id6Octet String源网关代码
Route_type2Octet String路由类型
MO:MO路由
MT:MT路由
Last_route_Id4Integer已经接收的上一条路由编号
(第1次发送此请求时Last_route_Id=
-1)

7.6.5.2 CMPP_GET_ ROUTE_RESP消息定义(GNS à ISMG)

字段名字节数属性描述
Route_Id4Unsigned Integer路由编号
Destination_Id6Octet String目标网关代码
Gateway_IP15Octet String目标网关IP地址
Gateway_port2Unsigned Integer目标网关IP端口
SP_Code21Octet StringSP的服务代码
(请求的路由类型=MT时,此字段为空)
Service_Id10Octet String请求的业务类型
(此项适合服务内容,如爱心卡图片传情)
Start_code4Unsigned Integer请求的路由类型=MO时:
起始业务代码(如果未置Service_Id字段,此字段为空)
请求的路由类型=MT时:
手机号码段的起始号码
End_code4Unsigned Integer请求的路由类型=MO时:
截止业务代码(如果未置Service_Id字段,此字段为空)
请求的路由类型=MT时:
手机号码段的截止号码
Area_code4Octet String手机所属省代码
(请求的路由类型=MO时,此字段为空)
Result1Unsigned Integer结果
0:正常
1:没有匹配路由
2:这是好后1条路由

 
 

7.6.6 ISMG向汇接网关更新MT路由(CMPP_MT_ROUTE_UPDATE)操作

CMPP_MT_ROUTE_UPDATE操作的目的是使ISMG可向GNS更新MT路由信息。GNS以CMPP_MT_ROUTE_UPDATE _RESP消息回应。

7.6.6.1 CMPP_MT_ROUTE_UPDATE消息定义(ISMGàGNS)

字段名字节数属性描述
Update_type1Unsigned Integer0:添加
1:删除
2:更新
Route_Id4Unsigned Integer路由编号
(若update_type 为0,即添加时,此字段为零)
Destination_Id6Octet String目标网关代码
Gateway_IP15Octet String目标网关IP地址
Gateway_port2Unsigned Integer目标网关IP端口
Start_Id6Octet StringMT路由起始号码段
End_Id6Octet StringMT路由截止号码段
Area_code4Octet String手机所属省代码

7.6.6.2 CMPP_MT_ROUTE_UPDATE_RESP消息定义(GNS à ISMG)

字段名字节数属性描述
Result1Unsigned Integer0:数据合法,等待核实
1:数据不合法

 

7.6.7 ISMG向汇接网关更新MO路由(CMPP_MO_ROUTE_UPDATE)操作

CMPP_MO_ROUTE_UPDATE操作的目的是使ISMG可向GNS更新MO路由信息。GNS以CMPP_MO_ROUTE_UPDATE _RESP消息回应。

7.6.7.1 CMPP_MO_ROUTE_UPDATE消息定义(ISMGàGNS)

字段名字节数属性描述
Update_type1Unsigned Integer0:添加
1:删除
2:更新
Route_Id4Unsigned Integer路由编号
(若update_type 为0,即添加时,此字段为零)
Destination_Id6Octet String目标网关代码
Gateway_IP15Octet String目标网关IP地址
Gateway_port2Unsigned Integer目标网关IP端口
SP_Code21Octet StringSP的服务号码
Service_Id10Octet String请求的业务类型(此项适合服务内容,如爱心卡图片传情,如该路由不包含此业务,此字段为空)
Start_code4Unsigned IntegerMO路由起始业务代码(如果未置请求的Service_Id字段,此字段为空)
End_code4Unsigned IntegerMO路由截止业务代码(如果未置请求的Service_Id字段,此字段为空)

7.6.7.2CMPP_MO_ROUTE_UPDATE_RESP消息定义(GNS à ISMG)

字段名字节数属性描述
Result1Unsigned Integer0:数据合法,等待核实
1:数据不合法

 
 

7.6.8汇接网关向ISMG更新MT路由(CMPP_PUSH_MT_ROUTE_UPDATE)操作

 
CMPP_PUSH_MT_ROUTE_UPDATE操作的目的是使GNS可向ISMG更新MT路由信息。ISMG以CMPP_PUSH_MT_ROUTE_UPDATE_RESP 消息回应。

7.6.8.1  CMPP_PUSH_MT_ROUTE_UPDATE消息定义(GNSàISMG)

字段名字节数属性描述
Update_type1Unsigned Integer0:添加;
1:删除;
2:更新
Route_Id4Unsigned Integer路由编号
Destination_Id6Octet String目标网关代码
Gateway_IP15Octet String目标网关IP地址
Gateway_port2Unsigned Integer目标网关IP端口
Start_Id6Octet StringMT路由起始号码段
End_Id6Octet StringMT路由截止号码段
Area_code4Octet String手机所属省代码

7.6.8.2  CMPP_PUSH_MT_ROUTE_UPDATE_RESP消息定义(ISMG à GNS)

字段名字节数属性描述
Result1Unsigned Integer0:成功更改
1:更改失败

 

7.6.9汇接网关向ISMG更新MO路由(CMPP_PUSH_MO_ROUTE_UPDATE)操作

CMPP_PUSH_MO_ROUTE_UPDATE操作的目的是使GNS可向ISMG更新MO路由信息。ISMG以CMPP_PUSH_MO_ROUTE_UPDATE_RESP 消息回应。

7.6.9.1  CMPP_PUSH_MO_ROUTE_UPDATE消息定义(GNSàISMG)

字段名字节数属性描述
Update_type1Unsigned Integer0:添加;
1:删除;
2:更新
Route_Id4Unsigned Integer路由编号
Destination_Id6Octet String目标网关代码
Gateway_IP15Octet String目标网关IP地址
Gateway_port2Unsigned Integer目标网关IP端口
SP_Code21Octet StringSP的服务号码
Service_Id10Octet String请求的业务类型(此项适合服务内容,如爱心卡图片传情,如该路由不包含此业务,此字段为空)
Start_code4Unsigned IntegerMO路由起始业务代码(如果未置请求的Service_Id字段,此字段为空)
End_code4Unsigned IntegerMO路由截止业务代码(如果未置请求的Service_Id字段,此字段为空)

7.6.9.2  CMPP_PUSH_MO_ROUTE_UPDATE_RESP消息定义(ISMG à GNS)

字段名字节数属性描述
Result1Unsigned
Integer
0:成功更改
1:更改失败

 
 

7.7系统定义

7.7.1 Command_Id定义

消息Command_Id值说明
CMPP_CONNECT0x00000001请求连接
CMPP_CONNECT_RESP0x80000001请求连接应答
CMPP_TERMINATE0x00000002终止连接
CMPP_TERMINATE_RESP0x80000002终止连接应答
CMPP_SUBMIT   0x00000004提交fun88体育
CMPP_SUBMIT_RESP0x80000004提交fun88体育应答
CMPP_DELIVER0x00000005fun88体育下发
CMPP_DELIVER_RESP0x80000005下发fun88体育应答
CMPP_QUERY0x00000006发送fun88体育状态查询
CMPP_QUERY_RESP0x80000006发送fun88体育状态查询应答
CMPP_CANCEL  0x00000007删除fun88体育
CMPP_CANCEL_RESP0x80000007删除fun88体育应答
CMPP_ACTIVE_TEST0x00000008测试
CMPP_ACTIVE_TEST_RESP0x80000008测试应答
CMPP_FWD0x00000009消息前转
CMPP_FWD_RESP0x80000009消息前转应答
CMPP_MT_ROUTE0x00000010MT路由请求
CMPP_MT_ROUTE_RESP0x80000010MT路由请求应答
CMPP_MO_ROUTE0x00000011MO路由请求
CMPP_MO_ROUTE_RESP0x80000011MO路由请求应答
CMPP_GET_ROUTE0x00000012获取路由请求
CMPP_GET_ROUTE_RESP0x80000012获取路由请求应答
CMPP_MT_ROUTE_UPDATE0x00000013MT路由更新
CMPP_MT_ROUTE_UPDATE_RESP0x80000013MT路由更新应答
CMPP_MO_ROUTE_UPDATE0x00000014MO路由更新
CMPP_MO_ROUTE_UPDATE_RESP0x80000014MO路由更新应答
CMPP_PUSH_MT_ROUTE_UPDATE0x00000015MT路由更新
CMPP_PUSH_MT_ROUTE_UPDATE_RESP0x80000015MT路由更新应答
CMPP_PUSH_MO_ROUTE_UPDATE0x00000016MO路由更新
CMPP_PUSH_MO_ROUTE_UPDATE_RESP0x80000016MO路由更新应答

 

 

附录1  MO状态报告的产生

 
为解决MO业务计费及使源网关获知SP对转发的MO消息的接收状态,现要求网关处理流程如下图所示:
 


附录1-图1    MO状态报告的产生
 
 
1.         用户提交fun88体育到SMSC;
2.         SMSC给用户返回提交fun88体育的应答,让用户知道fun88体育发送成功与否,如果该处失败,则SMSC不再进行下述的流程;
3.         SMSC通过SMPP消息DELIVER_SM把fun88体育发送给ISMG1;
4.         ISMG1以DELIVER_SM_RESP消息应答给SMSC;
5.         ISMG1根据用户发送的短消息中目的SP服务代码查询路由后转发给ISMG2;
6.         ISMG2发送CMPP_FWD_RESP消息应答;
7.         SP对 ISMG2将用户的fun88体育提交给SP;
8.         ISMG2发送提交应答;
9.         为ISMG1获知SP的接收情况,此时ISMG2应产生一个状态报告转发给ISMG1;
10.     ISMG1收到此状态报告后发送转发应答响应;
 
目的网关用于向源网关通知SP接收情况的状态报告时,CMPP_FWD消息中Msg_Fwd_Type值为3,表示MO的状态报告,信息内容字段(Msg_Content)格式定义如下:

字段名字节数属性描述
Msg_Id8Unsigned Integer信息标识
给SP的CMPP_Deliver消息中的Msg_Id,与源网关转发MO消息时产生的Msg_Id相同。
Stat7Octet StringSP的应答结果,CMPP_DELIVER_RESP中Result值的字符表示,左对齐。Result为0时,填字符DELIVRD,其余值填REJECTD
CMPP_Deliver_time10Octet StringYYMMDDHHMM(YY为年的后两位00-99,MM:01-12,DD:01-31,HH:00-23,MM:00-59)
注:fun88体育网关发出CMPP_DELIVER的时间。
CMPP_Deliver_RESP_time10Octet StringYYMMDDHHMM
注:fun88体育网关收到CMPP_DELIVER_RESP的时间。
Dest_Id21Octet String目的SP的服务代码,左对齐。
Reserved4Reserved


修订历史

版本号时间主要内容或重大修改
CMPP V1.2.12001.6
CMPP V2.02002.41.修改了Msg_Id的生成算法;
2.明确了有关fun88体育软件的问题;
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.     对原协议中的端口号作了重新规定。


fun88体育整理,更多精彩请持续关注!!! 

靠谱的fun88体育注册fun88体育,现在就开始

无需下载部署,注册即用,好快搭建与用户无障碍交流的桥梁

 

标签: cmpp2.0

热门产品 106fun88体育 106fun88体育接口 fun88体育验证码 106fun88体育平台 营销fun88体育 企业fun88体育 语音fun88体育 国际fun88体育

热门推荐 石油会员营销 用品会员营销 文教会员营销 装饰会员营销 印刷会员营销 咨询会员营销 机械会员营销 舞蹈会员营销

更多推荐 fun88体育接口fun88体育平台营销fun88体育106fun88体育语音fun88体育fun88体育验证码企业fun88体育106fun88体育平台

资质认证

企业签名实名审核认证

支付安全

明码标价支付及信息安全

多快好稳

通道多速度快体验好稳定高

售后无忧

服务出问题客服全程跟进
扫码关注fun88体育注册 fun88体育一手掌握
服务支持
021-31130006
周一至周日7:00-24:00
地址:上海浦东新区张杨路628号      
东明广场2号楼7C
Copyright © 2013-2021 川道fun88体育
fun88体育接口-专注fun88体育平台,验证码fun88体育,106fun88体育服务商
 

电话咨询
021-31130006

Processed in 0.210008 Second , 91 querys.