CMPP3.0,cmpp3.0协议

('中国移动通信互联短信网关接口协议中国移动通信互联网短信网关接口协议(ChinaMobilePeertoPeer,CMPP)中国移动通信集团公司研发中心第1页共47页中国移动通信互联短信网关接口协议（V3.0）中国移动通信集团公司2003年6月目录前言........................................................................................................................................................41范围........................................................................................................................................................52缩略语....................................................................................................................................................53网络结构................................................................................................................................................6中国移动通信集团公司研发中心第2页共47页中国移动通信互联短信网关接口协议4CMPP功能概述....................................................................................................................................75协议栈....................................................................................................................................................86通信方式................................................................................................................................................96.1长连接................................................................................................................................96.2短连接..............................................................................................................................116.3本协议中涉及的端口号...................................................................................................126.4交互过程中的应答方式...................................................................................................127消息定义..............................................................................................................................................127.1基本数据类型..................................................................................................................127.2消息结构..........................................................................................................................137.3消息头格式（MessageHeader）....................................................................................137.4信息资源站实体(SP)与互联网短信网关(ISMG)间的消息定义...................................137.4.1SP请求连接到ISMG（CMPP_CONNECT）操作............................................137.4.2SP或ISMG请求拆除连接（CMPP_TERMINATE）操作................................147.4.3SP向ISMG提交短信（CMPP_SUBMIT）操作...............................................157.4.4SP向ISMG查询发送短信状态（CMPP_QUERY）操作.................................177.4.5ISMG向SP送交短信（CMPP_DELIVER）操作.............................................187.4.6SP向ISMG发起删除短信（CMPP_CANCEL）操作.......................................217.4.7链路检测（CMPP_ACTIVE_TEST）操作.........................................................217.5互联网短信网关(ISMG)之间的消息定义......................................................................227.5.1源ISMG请求连接到目的ISMG（CMPP_CONNECT）操作..........................227.5.2源ISMG请求拆除到目的ISMG的连接（CMPP_TERMINATE）操作..........227.5.3链路检测（CMPP_ACTIVE_TEST）操作.........................................................227.5.4源ISMG向目的ISMG转发短信（CMPP_FWD）操作...................................227.6互联网短信网关(ISMG)与汇接网关(GNS)之间的消息定义........................................277.6.1ISMG请求连接到GNS或GNS请求连接到ISMG（CMPP_CONNECT）操作........................................................................................................................................277.6.2ISMG请求拆除到GNS的连接或GNS请求拆除到ISMG的连接（CMPP_TERMINATE）操作.....................................................................................277.6.3ISMG向汇接网关查询MT路由（CMPP_MT_ROUTE）操作........................277.6.4ISMG向汇接网关查询MO路由（CMPP_MO_ROUTE）操作.......................287.6.5ISMG向汇接网关获取MT路由（CMPP_GET_MT_ROUTE）操作..............297.6.6ISMG向汇接网关获取MO路由（CMPP_GET_MO_ROUTE）操作.............307.6.7ISMG向汇接网关更新MT路由（CMPP_MT_ROUTE_UPDATE）操作.......317.6.8ISMG向汇接网关更新MO路由（CMPP_MO_ROUTE_UPDATE）操作......337.6.9汇接网关向ISMG更新MT路由（CMPP_PUSH_MT_ROUTE_UPDATE）操作....................................................................................................................................347.6.10汇接网关向ISMG更新MO路由（CMPP_PUSH_MO_ROUTE_UPDATE）操作................................................................................................................................357.7系统定义..........................................................................................................................36中国移动通信集团公司研发中心第3页共47页中国移动通信互联短信网关接口协议7.7.1Command_Id定义.................................................................................................36附录1MO状态报告的产生.................................................................................................................38修订历史.................................................................................................................................................40中国移动通信集团公司研发中心第4页共47页中国移动通信互联短信网关接口协议前言本规范为中国移动通信集团公司企业规范，简称CMPP，现阶段版本是对2.1版修订后形成的，为3.0版。本规范描述了中国移动短信业务中各网元（包括ISMG、GNS和SP）之间的相关消息的类型和定义。根据业务的发展，规范中的信令操作和参数将会做进一步的调整和增加。本规范解释权属于中国移动通信集团公司。本规范起草单位：中国移动通信集团公司研发中心。本标准主要起草人：党京、孙若雯、于蓉蓉、袁向阳。中国移动通信集团公司研发中心第5页共47页中国移动通信互联短信网关接口协议1范围本规范规定了以下三方面的内容：（1）信息资源站实体与互联网短信网关之间的接口协议；（2）互联网短信网关之间的接口协议；（3）互联网短信网关与汇接网关之间的接口协议。本规范适用于各SP和ISMG的开发厂商。2缩略语英文缩写英文全称说明ISMGInternetShortMessageGateway互联网短信网关SMPPShortMessagePeertoPeer短消息点对点协议CMPPChinaMobilePeertoPeer中国移动点对点协议SMCShortMessageCenter短消息中心GNSGatewayNameServer网关名称服务器（汇接网关）SPServiceProvider业务提供者，即信息资源站实体SMCShortMessageControlSP为收取包月业务费用而向网关发送的消息，网关收到后不送给用户仅产生相应的话单；ISMG_Id网关代码：0XYZ01~0XYZ99，其中XYZ为省会区号，位数不足时左补零，如北京编号为1的网关代码为001001，江西编号为1的网关代码为079101，依此类推。SP_IdSP的企业代码：网络中SP地址和身份的标识、地址翻译、计费、结算等均以企业代码为依据。企业代码以数字表示，共6位，从“9XY000”至“9XY999”，其中“XY”为各移动公司代码。SP_CodeSP的服务代码：服务代码是在使用短信方式的点播类业务中，提供给用户点播的内容/应用服务提供商代中国移动通信集团公司研发中心第6页共47页中国移动通信互联短信网关接口协议码。服务代码以数字表示，全国业务服务代码长度统一为4位，即“1000”－“9999”；本地业务服务代码长度统一为5位，即“01000”－“09999”。Service_IdSP的业务类型，数字、字母和符号的组合，由SP自定，如图片传情可定为TPCQ，股票查询可定义为11。3网络结构如图1所示，互联网短信网关（ISMG）是外部信息资源站实体（SP）与移动网内短信中心之间的中介实体，互联网短信网关一方面负责接收SP发送给移动用户的信息和提交给短信中心。另一方面，移动用户点播SP业务的信息将由短信中心通过互联网短信网关发给SP。另外，为了减轻短信中心的信令负荷，互联网短信网关还应根据路由原则将SP提交的信息转发到相应的互联网短信网关。互联网短信网关通过向汇接网关（GNS）查询的方式获得网关间的转发路由信息。中国移动通信集团公司研发中心第7页共47页中国移动通信互联短信网关接口协议4CMPP功能概述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所示：中国移动通信集团公司研发中心第8页共47页图2需要前转的MO示意图641归属ISMG接入ISMGSMCSPGNS(汇接网关)35782中国移动通信互联短信网关接口协议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所示：中国移动通信集团公司研发中心第9页共47页641接入ISMG归属ISMGSPSMCGNS(汇接网关)23578图3需要前转的MT示意图中国移动通信互联短信网关接口协议图4CMPP协议栈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。现阶段建议为16，即接收方在应答前一次收到的消息最多不超过16条。长连接的操作流程举例如图5所示：中国移动通信集团公司研发中心第10页共47页CMPPTCPIP底层承载ISMGCMPPTCPIP底层承载CMPPTCPIP底层承载CMPPTCPIP底层承载ISMGSPGNS中国移动通信互联短信网关接口协议中国移动通信集团公司研发中心第11页共47页......建立TCP连接滑动窗口不大于WWCMPP消息1客户端服务器端CMPP消息2对CMPP消息1的响应对CMPP消息2的响应链路检测包链路检测包响应建立TCP连接链路检测包链路检测包响应拆除TCP连接......建立TCP连接中国移动通信互联短信网关接口协议图5长连接操作流程6.2短连接通信双方以客户-服务器方式建立TCP连接，应答与请求在同一个连接中完成。系统采用客户/服务器模式，操作以客户端驱动方式发起连接请求，完成一次操作后关闭此连接。网关与SP之间、网关之间的消息发送后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为：T=60秒，N=3。短连接的操作流程举例如图6所示：图6短连接的操作流程中国移动通信集团公司研发中心第12页共47页对CMPP消息1的响应CMPP消息1建立TCP连接拆除TCP连接CMPP消息2对CMPP消息2的响应建立TCP连接拆除TCP连接......建立TCP连接客户端/服务器端服务器/客户端中国移动通信互联短信网关接口协议6.3本协议中涉及的端口号端口号应用7890长连接（SP与网关间）7900短连接（SP与网关间）7930长连接（网关之间）9168短连接（短信网关与汇接网关之间）6.4交互过程中的应答方式在SP与ISMG之间、SMC与ISMG之间及ISMG之间的交互过程中均采用异步方式，即任一个网元在收到请求消息后应立即回送响应消息。举例如图7所示：图7异步交互方式示意图7消息定义7.1基本数据类型UnsignedInteger无符号整数Integer整数，可为正整数、负整数或零中国移动通信集团公司研发中心第13页共47页SMCISMG1ISMG2SPSMPP请求消息SMPP响应消息CMPP请求消息CMPP响应消息CMPP请求消息CMPP响应消息中国移动通信互联短信网关接口协议OctetString定长字符串，位数不足时，如果左补0则补ASCII表示的零以填充，如果右补0则补二进制的零以表示字符串的结束符7.2消息结构项目说明MessageHeader消息头(所有消息公共包头)MessageBody消息体7.3消息头格式（MessageHeader）字段名字节数类型描述Total_Length4UnsignedInteger消息总长度(含消息头及消息体)Command_Id4UnsignedInteger命令或响应类型Sequence_Id4UnsignedInteger消息流水号,顺序累加,步长为1,循环使用（一对请求和应答消息的流水号必须相同）7.4信息资源站实体(SP)与互联网短信网关(ISMG)间的消息定义SP为客户端，向作为服务器端的ISMG发起连接请求，在通过身份验证之后SP与ISMG之间方可进行数据传输。7.4.1SP请求连接到ISMG（CMPP_CONNECT）操作CMPP_CONNECT操作的目的是SP向ISMG注册作为一个合法SP身份，若注册成功后即建立了应用层的连接，此后SP可以通过此ISMG接收和发送短信。ISMG以CMPP_CONNECT_RESP消息响应SP的请求。7.4.1.1CMPP_CONNECT消息定义（SP\uf0e0ISMG）字段名字节数属性描述Source_Addr6OctetString源地址，此处为SP_Id，即SP的企中国移动通信集团公司研发中心第14页共47页中国移动通信互联短信网关接口协议业代码。AuthenticatorSource16OctetString用于鉴别源地址。其值通过单向MD5hash计算得出，表示如下：AuthenticatorSource=MD5（Source_Addr+9字节的0+sharedsecret+timestamp）Sharedsecret由中国移动与源地址实体事先商定，timestamp格式为：MMDDHHMMSS，即月日时分秒，10位。Version1UnsignedInteger双方协商的版本号(高位4bit表示主版本号,低位4bit表示次版本号)，对于3.0的版本，高4bit为3，低4位为0Timestamp4UnsignedInteger时间戳的明文,由客户端产生,格式为MMDDHHMMSS，即月日时分秒，10位数字的整型，右对齐。7.4.1.2CMPP_CONNECT_RESP消息定义（ISMG\uf0e0SP）字段名字节数属性描述Status4UnsignedInteger状态0：正确1：消息结构错2：非法源地址3：认证错4：版本太高5~：其他错误AuthenticatorISMG16OctetStringISMG认证码，用于鉴别ISMG。其值通过单向MD5hash计算得出，表示如下：AuthenticatorISMG=MD5（Status+AuthenticatorSource+sharedsecret），Sharedsecret由中国移动与源地址实体事先商定，AuthenticatorSource为源地址实体发送给ISMG的对应消息CMPP_Connect中的值。认证出错时，此项为空。Version1UnsignedInteger服务器支持的最高版本号，对于3.0的版本，高4bit为3，低4位为0中国移动通信集团公司研发中心第15页共47页中国移动通信互联短信网关接口协议7.4.2SP或ISMG请求拆除连接（CMPP_TERMINATE）操作CMPP_TERMINATE操作的目的是SP或ISMG基于某些原因决定拆除当前的应用层连接而发起的操作。此操作完成后SP与ISMG之间的应用层连接被释放，此后SP若再要与ISMG通信时应发起CMPP_CONNECT操作。ISMG或SP以CMPP_TERMINATE_RESP消息响应请求。7.4.2.1CMPP_TERMINATE消息定义（SP\uf0e0ISMG或ISMG\uf0e0SP）无消息体。7.4.2.2CMPP_TERMINATE_RESP消息定义（SP\uf0e0ISMG或ISMG\uf0e0SP）无消息体。7.4.3SP向ISMG提交短信（CMPP_SUBMIT）操作CMPP_SUBMIT操作的目的是SP在与ISMG建立应用层连接后向ISMG提交短信。ISMG以CMPP_SUBMIT_RESP消息响应。7.4.3.1CMPP_SUBMIT消息定义（SP\uf0e0ISMG）字段名字节数属性描述Msg_Id8UnsignedInteger信息标识，由SP接入的短信网关本身产生，本处填空。Pk_total1UnsignedInteger相同Msg_Id的信息总条数，从1开始Pk_number1UnsignedInteger相同Msg_Id的信息序号，从1开始Registered_Delivery1UnsignedInteger是否要求返回状态确认报告：0：不需要1：需要Msg_level1Unsigned信息级别中国移动通信集团公司研发中心第16页共47页中国移动通信互联短信网关接口协议IntegerService_Id10OctetString业务标识，是数字、字母和符号的组合。Fee_UserType1UnsignedInteger计费用户类型字段0：对目的终端MSISDN计费；1：对源终端MSISDN计费；2：对SP计费;3：表示本字段无效，对谁计费参见Fee_terminal_Id字段。Fee_terminal_Id32OctetString被计费用户的号码（如本字节填空，则表示本字段无效，对谁计费参见Fee_UserType字段，本字段与Fee_UserType字段互斥）Fee_terminal_type1UnsignedInteger被计费用户的号码类型，0：真实号码；1：伪码TP_pId1UnsignedIntegerGSM协议类型。详细是解释请参考GSM03.40中的9.2.3.9TP_udhi1UnsignedIntegerGSM协议类型。详细是解释请参考GSM03.40中的9.2.3.23,仅使用1位，右对齐Msg_Fmt1UnsignedInteger信息格式0：ASCII串3：短信写卡操作4：二进制信息8：UCS2编码15：含GB汉字。。。。。。Msg_src6OctetString信息内容来源(SP_Id)FeeType2OctetString资费类别01：对“计费用户号码”免费02：对“计费用户号码”按条计信息费03：对“计费用户号码”按包月收取信息费04：对“计费用户号码”的信息费封顶05：对“计费用户号码”的收费是由SP实现FeeCode6OctetString资费代码（以分为单位）ValId_Time17OctetString存活有效期，格式遵循SMPP3.3协议At_Time17OctetString定时发送时间，格式遵循SMPP3.3协议Src_Id21OctetString源号码SP的服务代码或前缀为服务代码的长号码,网关将该号码完整的填到SMPP协议Submit_SM消息相应的source_addr字段，该号码最终在用户手机上显示为短消息的主叫号码中国移动通信集团公司研发中心第17页共47页中国移动通信互联短信网关接口协议DestUsr_tl1UnsignedInteger接收信息的用户数量(小于100个用户)Dest_terminal_Id32DestUsr_tlOctetString接收短信的MSISDN号码Dest_terminal_type1UnsignedInteger接收短信的用户的号码类型，0：真实号码；1：伪码Msg_Length1UnsignedInteger信息长度(Msg_Fmt值为0时：<160个字节；其它<=140个字节)Msg_ContentMsg_lengthOctetString信息内容LinkID20OctetString点播业务使用的LinkID，非点播类业务的MT流程不使用该字段系统应该支持短信的群发功能，关于短信群发功能的实现请参阅“附录1短信群发功能的实现”。7.4.3.2CMPP_SUBMIT_RESP消息定义（ISMG\uf0e0SP）字段名字节数属性描述Msg_Id8UnsignedInteger信息标识，生成算法如下：采用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）Result4UnsignedInteger结果0：正确1：消息结构错2：命令字错3：消息序号重复中国移动通信集团公司研发中心第18页共47页中国移动通信互联短信网关接口协议4：消息长度错5：资费代码错6：超过最大信息长7：业务代码错8：流量控制错9：本网关不负责服务此计费号码10：Src_Id错误11：Msg_src错误12：Fee_terminal_Id错误13：Dest_terminal_Id错误……7.4.4SP向ISMG查询发送短信状态（CMPP_QUERY）操作CMPP_QUERY操作的目的是SP向ISMG查询某时间的业务统计情况，可以按总数或按业务代码查询。ISMG以CMPP_QUERY_RESP应答。7.4.4.1CMPP_QUERY消息的定义（SP\uf0e0ISMG）字段名字节数属性描述Time8OctetString时间YYYYMMDD(精确至日)Query_Type1UnsignedInteger查询类别0：总数查询1：按业务类型查询Query_Code10OctetString查询码当Query_Type为0时，此项无效；当Query_Type为1时，此项填写业务类型Service_Id.Reserve8OctetString保留7.4.4.2CMPP_QUERY_RESP消息的定义（ISMG\uf0e0SP）字段名字节数属性描述Time8OctetString时间(精确至日)Query_Type1UnsignedInteger查询类别0：总数查询1：按业务类型查询Query_Code10OctetString查询码中国移动通信集团公司研发中心第19页共47页中国移动通信互联短信网关接口协议MT_TLMsg4UnsignedInteger从SP接收信息总数MT_Tlusr4UnsignedInteger从SP接收用户总数MT_Scs4UnsignedInteger成功转发数量MT_WT4UnsignedInteger待转发数量MT_FL4UnsignedInteger转发失败数量MO_Scs4UnsignedInteger向SP成功送达数量MO_WT4UnsignedInteger向SP待送达数量MO_FL4UnsignedInteger向SP送达失败数量7.4.5ISMG向SP送交短信（CMPP_DELIVER）操作CMPP_DELIVER操作的目的是ISMG把从短信中心或其它ISMG转发来的短信送交SP，SP以CMPP_DELIVER_RESP消息回应。7.4.5.1CMPP_DELIVER消息定义（ISMG\uf0e0SP）字段名字节数属性描述中国移动通信集团公司研发中心第20页共47页中国移动通信互联短信网关接口协议Msg_Id8UnsignedInteger信息标识生成算法如下：采用64位（8字节）的整数：（1）时间（格式为MMDDHHMMSS，即月日时分秒）：bit64~bit39，其中bit64~bit61：月份的二进制表示；bit60~bit56：日的二进制表示；bit55~bit51：小时的二进制表示；bit50~bit45：分的二进制表示；bit44~bit39：秒的二进制表示；（2）短信网关代码：bit38~bit17，把短信网关的代码转换为整数填写到该字段中。（3）序列号：bit16~bit1，顺序增加，步长为1，循环使用。各部分如不能填满，左补零，右对齐。Dest_Id21OctetString目的号码SP的服务代码，一般4--6位，或者是前缀为服务代码的长号码；该号码是手机用户短消息的被叫号码。Service_Id10OctetString业务标识，是数字、字母和符号的组合。TP_pid1UnsignedIntegerGSM协议类型。详细解释请参考GSM03.40中的9.2.3.9TP_udhi1UnsignedIntegerGSM协议类型。详细解释请参考GSM03.40中的9.2.3.23，仅使用1位，右对齐Msg_Fmt1UnsignedInteger信息格式0：ASCII串3：短信写卡操作4：二进制信息8：UCS2编码15：含GB汉字Src_terminal_Id32OctetString源终端MSISDN号码（状态报告时中国移动通信集团公司研发中心第21页共47页中国移动通信互联短信网关接口协议填为CMPP_SUBMIT消息的目的终端号码）Src_terminal_type1UnsignedInteger源终端号码类型，0：真实号码；1：伪码Registered_Delivery1UnsignedInteger是否为状态报告0：非状态报告1：状态报告Msg_Length1UnsignedInteger消息长度Msg_ContentMsg_lengthOctetString消息内容LinkID20OctetString点播业务使用的LinkID，非点播类业务的MT流程不使用该字段当ISMG向SP送交状态报告时，信息内容字段（Msg_Content）格式定义如下：字段名字节数属性描述Msg_Id8UnsignedInteger信息标识SP提交短信（CMPP_SUBMIT）操作时，与SP相连的ISMG产生的Msg_Id。Stat7OctetString发送短信的应答结果，含义与SMPP协议要求中stat字段定义相同，详见表一。SP根据该字段确定CMPP_SUBMIT消息的处理状态。Submit_time10OctetStringYYMMDDHHMM（YY为年的后两位00-99，MM：01-12，DD：01-31，HH：00-23，MM：00-59）Done_time10OctetStringYYMMDDHHMMDest_terminal_Id21OctetString目的终端MSISDN号码(SP发送CMPP_SUBMIT消息的目标终端)SMSC_sequence4UnsignedInteger取自SMSC发送状态报告的消息体中的消息标识。表一Stat字段定义MessageStateFinalMessageStatesDescriptionDELIVEREDDELIVRDMessageisdeliveredtodestinationEXPIREDEXPIREDMessagevalidityperiodhasexpiredDELETEDDELETEDMessagehasbeendeleted.UNDELIVERABLEUNDELIVMessageisundeliverableACCEPTEDACCEPTDMessageisinacceptedstate(i.e.hasbeenmanuallyreadonbehalfofthesubscriberbycustomerservice)UNKNOWNUNKNOWNMessageisininvalidstate中国移动通信集团公司研发中心第22页共47页中国移动通信互联短信网关接口协议REJECTEDREJECTDMessageisinarejectedstateMA:xxxxMA:xxxxSMSC不返回响应消息时的状态报告MB:xxxxMB:xxxxSMSC返回错误响应消息时的状态报告CA:xxxxCA:xxxxSCP不返回响应消息时的状态报告CB:xxxxCB:xxxxSCP返回错误响应消息时的状态报告注意：1．其中ACCEPTED为中间状态，网关若从短信中心收到后应丢弃，不做任何操作。2．Stat字段长度为7个字节，填写时应填表一中FinalMessageStates中的缩写形式，如状态为DELIVERED时填写DELIVRD，依此类推。3．SP等待状态报告缺省时间为48小时。7.4.5.2CMPP_DELIVER_RESP消息定义（SP\uf0e0ISMG）字段名字节数属性描述Msg_Id8UnsignedInteger信息标识（CMPP_DELIVER中的Msg_Id字段）Result4UnsignedInteger结果0：正确1：消息结构错2：命令字错3：消息序号重复4：消息长度错5：资费代码错6：超过最大信息长7：业务代码错8:流量控制错9~：其他错误7.4.6SP向ISMG发起删除短信（CMPP_CANCEL）操作CMPP_CANCEL操作的目的是SP通过此操作可以将已经提交给ISMG的短信删除，ISMG将以CMPP_CANCEL_RESP回应删除操作的结果。中国移动通信集团公司研发中心第23页共47页中国移动通信互联短信网关接口协议7.4.6.1CMPP_CANCEL消息定义（SP\uf0e0ISMG）字段名字节数属性描述Msg_Id8UnsignedInteger信息标识（SP想要删除的信息标识）7.4.6.2CMPP_CANCEL_RESP消息定义（ISMG\uf0e0SP）字段名字节数属性描述Success_Id4UnsignedInteger成功标识0：成功1：失败7.4.7链路检测（CMPP_ACTIVE_TEST）操作本操作仅适用于通信双方采用长连接通信方式时用于保持连接。7.4.7.1CMPP_ACTIVE_TEST定义（SP\uf0e0ISMG或ISMG\uf0e0SP）无消息体。7.4.7.2CMPP_ACTIVE_TEST_RESP定义（SP\uf0e0ISMG或ISMG\uf0e0SP）字段名字节数属性描述Reserved17.5互联网短信网关(ISMG)之间的消息定义网关之间互为客户/服务器，任一方都可在需要时建立连接进行数据传输。7.5.1源ISMG请求连接到目的ISMG（CMPP_CONNECT）操作消息定义同7.4.1.1和7.4.1.2所述。其中Source_Addr填源网关代码。中国移动通信集团公司研发中心第24页共47页中国移动通信互联短信网关接口协议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转发短信（CMPP_FWD）操作CMPP_FWD操作的目的是源ISMG可以根据一定的路由策略将SP提交的短信、MO状态报告、短信中心产生的状态报告、用户提交的短信转发到目的ISMG，目的ISMG以CMPP_FWD_RESP回应。7.5.4.1CMPP_FWD定义（ISMG\uf0e0ISMG）字段名字节数属性描述Source_Id6OctetString源网关的代码（右对齐，左补0）Destination_Id6OctetString目的网关代码（右对齐，左补0）NodesCount1UnsignedInteger经过的网关数量Msg_Fwd_Type1UnsignedInteger前转的消息类型0：MT前转1：MO前转2：MT时的状态报告3：MO时的状态报告Msg_Id8UnsignedInteger信息标识Pk_total1UnsignedInteger相同Msg_Id的消息总条数，从1开始Pk_number1UnsignedInteger相同Msg_Id的消息序号，从1开始Registered_Delivery1UnsignedInteger是否要求返回状态确认报告0：不需要1：需要2：产生SMC话单Msg_level1UnsignedInteger信息级别Service_Id10OctetString业务标识中国移动通信集团公司研发中心第25页共47页中国移动通信互联短信网关接口协议Fee_UserType1UnsignedInteger计费用户类型字段0：对目的终端MSISDN计费；1：对源终端MSISDN计费；2：对SP计费;3：表示本字段无效，对谁计费参见Fee_terminal_Id字段。Fee_terminal_Id21OctetString被计费用户的号码（如本字节填空，则表示本字段无效，对谁计费参见Fee_UserType字段。本字段与Fee_UserType字段互斥）Fee_terminal_Pseudo32OctetString被计费用户的伪码Fee_terminal_UserType1UnsignedInteger计费用户号码的用户类型，0：全球通，1：神州行TP_pid1UnsignedIntegerGSM协议类型。详细解释请参考GSM03.40中的9.2.3.9TP_udhi1UnsignedIntegerGSM协议类型。详细解释请参考GSM03.40中的9.2.3.23,仅使用1位，右对齐Msg_Fmt1UnsignedInteger信息格式0：ASCII串3：短信写卡操作4：二进制信息8：UCS2编码15：含GB汉字Msg_src6OctetString信息内容来源（SP_Id，SP的企业代码）FeeType2OctetString资费类别00：“短消息类型”为“发送”，对“计费用户号码”不计信息费，此类话单仅用于核减SP对称的信道费01：对“计费用户号码”免费02：对“计费用户号码”按条计信息费03：对“计费用户号码”按包月收取信息费04：对“计费用户号码”的信息费封顶05：对“计费用户号码”的收费是由SP实现06：对“计费用户号码”按包月查询中国移动通信集团公司研发中心第26页共47页中国移动通信互联短信网关接口协议收费FeeCode6OctetString资费代码（以分为单位）Valid_Time17OctetString有效期At_Time17OctetString定时发送的时间Src_Id21OctetString源号码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_Pseudo32OctetString源号码的伪码Src_UserType1UnsignedInteger源号码的用户类型，0：全球通，1：神州行Src_type1UnsignedInteger传递给SP的源号码的类型，0：真实号码；1：伪码DestUsr_tl1UnsignedInteger接收消息的用户数量，必须位1Dest_Id21DestUsr_tlOctetString目的号码1．MT转发时为目的终端MSISDN号码，即对应CMPP_SUBMIT消息中的Dest_Terminal_Id。2．MO转发时为SP的服务代码，一般4--6位，或者是前缀为服务代码的长号码，该号码是手机用户短消息的被叫号码。3．MT状态报告时，填目的SP的服务代码，即CMPP_SUBMIT消息中的Src_Id。4．MO状态报告时，填发送短信的移动用户MSISDN号码。Dest_Pseudo32OctetString目的用户的伪码Dest_UserType1UnsignedInteger目的号码的用户类型，0：全球通，1：神州行Msg_Length1UnsignedInteger消息长度Msg_ContentMsg_lengthOctetString消息内容中国移动通信集团公司研发中心第27页共47页中国移动通信互联短信网关接口协议LinkID20OctetString点播业务使用的LinkID注意：1．当转发消息为MO状态报告时，信息内容字段（Msg_Content）格式定义如下：字段名字节数属性描述Msg_Id8UnsignedInteger信息标识给SP的CMPP_Deliver消息中的Msg_Id，与源网关转发MO消息时产生的Msg_Id相同。Stat7OctetStringSP的应答结果，CMPP_DELIVER_RESP中Result为0时，填字符DELIVRD,其余值填REJECTD。CMPP_DELIVER_time10OctetStringYYMMDDHHMM（YY为年的后两位00-99，MM：01-12，DD：01-31，HH：00-23，MM：00-59）注：短信网关发出CMPP_DELIVER的时间。CMPP_DELIVER_RESP_time10OctetStringYYMMDDHHMM注：短信网关收到CMPP_DELIVER_RESP的时间。Dest_Id21Reserved目的SP的服务代码，左对齐。Reserved42．当转发消息为MT状态报告时，信息内容字段（Msg_Content）格式同7.4.5.1定义。7.5.4.2CMPP_FWD_RESP定义（ISMG\uf0e0ISMG）字段名字节数属性描述Msg_Id8UnsignedInteger信息标识（CMPP_FWD中字段值）Pk_total1UnsignedInteger相同Msg_Id的消息总条数Pk_number1UnsignedInteger相同Msg_Id的消息序号Result4UnsignedInteger结果0：正确1：消息结构错2：命令字错3：消息序号重复4：消息长度错中国移动通信集团公司研发中心第28页共47页中国移动通信互联短信网关接口协议5：资费代码错6：超过最大信息长7：业务代码错8:流量控制错9:前转判断错(此SP不应发往本ISMG)10~：其他错误7.6互联网短信网关(ISMG)与汇接网关(GNS)之间的消息定义要求ISMG与GNS在信息交互时使用短连接的通信方式。ISMG与GNS可互为客户/服务器。7.6.1ISMG请求连接到GNS或GNS请求连接到ISMG（CMPP_CONNECT）操作消息定义同7.4.1.1和7.4.1.2所述，其中Source_Addr填源网关代码，可能是ISMG代码或GNS代码。7.6.2ISMG请求拆除到GNS的连接或GNS请求拆除到ISMG的连接（CMPP-_TERMINATE）操作消息定义同7.4.2.1和7.4.2.2所述。7.6.3ISMG向汇接网关查询MT路由（CMPP_MT_ROUTE）操作CMPP_MT_ROUTE操作用于ISMG不知道需要转发MT消息的路由时查询GNS。GNS以CMPP_MT_ROUTE_RESP应答。7.6.3.1CMPP_MT_ROUTE消息定义（ISMG\uf0e0GNS）字段名字节数属性描述Source_Id6OctetString源网关代码Terminal_Id21OctetString目的终端MSISDN号码中国移动通信集团公司研发中心第29页共47页中国移动通信互联短信网关接口协议7.6.3.2CMPP_MT_ROUTE_RESP消息定义（GNS\uf0e0ISMG）字段名字节数属性描述Route_Id4UnsignedInteger路由编号(MO/MT分别从0开始,由GNS统一分配)Destination_Id6OctetString目标网关代码Gateway_IP15OctetString目标网关IP地址(地址格式举例：67.221.134.12，左对齐)Gateway_port2UnsignedInteger目标网关IP端口Start_Id9OctetStringMT路由起始号码段End_Id9OctetStringMT路由截止号码段Area_code4OctetString手机所属省代号Result1UnsignedInteger结果0：正常1：没有匹配路由2：源网关代码错9：系统繁忙User_type1UnsignedInteger用户类型0：全球通1：神州行2：M-Zone…...Time_stamp14OctetString本路由信息的最后修改时间格式是：yyyymmddhhmmss，例如200301170145127.6.4ISMG向汇接网关查询MO路由（CMPP_MO_ROUTE）操作CMPP_MO_ROUTE操作的目的是使ISMG当不知道需要转发MO消息的路由时可向GNS查询得到。GNS以CMPP_MO_ROUTE_RESP应答。7.6.4.1CMPP_MO_ROUTE消息定义（ISMG\uf0e0GNS）字段名字节数属性描述Source_Id6OctetString源网关代码中国移动通信集团公司研发中心第30页共47页中国移动通信互联短信网关接口协议SP_Code21OctetStringSP的服务代码Service_Id10OctetString请求的业务标识（此项适合全网服务内容，如梦网卡图片传情）Service_Code4UnsignedInteger请求的业务代码（如果未置Service_Id字段，此字段为空，如梦网卡图片传情TPCQ1000—2000对应某个网站的某些相应图片）7.6.4.2CMPP_MO_ROUTE_RESP消息定义（GNS\uf0e0ISMG）字段名字节数属性描述Route_Id4UnsignedInteger路由编号（MO/MT分别从0开始,由GNS统一分配）Destination_Id6OctetString目标网关代码Gateway_IP15OctetString目标网关IP地址Gateway_port2UnsignedInteger目标网关IP端口SP_Id6OctetStringSP的企业代码SP_Code21OctetStringSP的服务代码SP_AcessType1UnsignedIntegerSP接入类型0：全网业务SP全网接入，即接入网关为SP的主力接入点1：全网业务SP镜像接入，即接入网关为SP的镜像接入点Start_code4UnsignedIntegerMO路由起始业务代码（如果未置请求的Service_Id字段，此字段为空）End_code4UnsignedIntegerMO路由截止业务代码（如果未置请求的Service_Id字段，此字段为空）Result1UnsignedInteger结果0：正常1：没有匹配路由2：源网关服务代码错9：系统繁忙Time_stamp14OctetString本路由信息的最后修改时间格式是：yyyymmddhhmmss，例如20030117014512中国移动通信集团公司研发中心第31页共47页中国移动通信互联短信网关接口协议7.6.5ISMG向汇接网关获取MT路由（CMPP_GET_MT_ROUTE）操作CMPP_GET_MT_ROUTE操作的目的是使ISMG可向GNS查询MT的路由信息。GNS以CMPP_GET_MT_ROUTE_RESP消息回应。7.6.5.1CMPP_GET_MT_ROUTE消息定义（ISMG\uf0e0GNS）字段名字节数属性描述Source_Id6OctetString源网关代码Route_type4OctetString路由类型MT：MT路由（考虑今后的扩展性，故保留此字段）Last_route_Id4Integer已经接收的上一条路由编号（第1次发送此请求时Last_route_Id=-1）7.6.5.2CMPP_GET_ROUTE_RESP消息定义（GNS\uf0e0ISMG）字段名字节数属性描述Route_Id4UnsignedInteger路由编号（MO/MT分别从0开始,由GNS统一分配）Destination_Id6OctetString目标网关代码Gateway_IP15OctetString目标网关IP地址Gateway_port2UnsignedInteger目标网关IP端口Start_Id9OctetString手机号码段的起始号码End_Id9OctetString手机号码段的截止号码Area_code4OctetString手机所属省代码Result1UnsignedInteger结果0：正常1：没有匹配路由2：源网关代码错3：路由类型错9：系统繁忙User_type1UnsignedInteger用户类型0：全球通1：神州行2：M-Zone中国移动通信集团公司研发中心第32页共47页中国移动通信互联短信网关接口协议……Route_total4UnsignedInteger返回路由总数Route_number4UnsignedInteger当前返回的路由序号，从1开始，顺序递增Time_stamp14OctetString本路由信息的最后修改时间格式是：yyyymmddhhmmss，例如20030117014512说明：Route_total和Route_number两个字段，能够让短信网关清楚地知道MT/MO的总路由数，以及当前拿的是第几条路由记录。这样，短信网关就可以更加方便地检验是否已经完全获取所有路由记录，以便更新本地缓存的路由表。7.6.6ISMG向汇接网关获取MO路由（CMPP_GET_MO_ROUTE）操作7.6.6.1CMPP_GET_MO_ROUTE消息定义（ISMG\uf0e0GNS）字段名字节数属性描述Source_Id6OctetString源网关代码Route_type4OctetString路由类型MO：MO路由（考虑今后的扩展性，故保留此字段）Last_route_Id4Integer已经接收的上一条路由编号（第1次发送此请求时Last_route_Id=-1）7.6.6.2CMPP_GET_MO_ROUTE_RESP消息定义（GNS\uf0e0ISMG）字段名字节数属性描述Route_Id4UnsignedInteger路由编号（MO/MT分别从0开始,由GNS统一分配）Destination_Id6OctetString目标网关代码Gateway_IP15OctetString目标网关IP地址Gateway_port2UnsignedInteger目标网关IP端口SP_Id6OctetStringSP的企业代码SP_Code21OctetStringSP的服务代码SP_AcessType1UnsignedSP接入类型中国移动通信集团公司研发中心第33页共47页中国移动通信互联短信网关接口协议Integer0：全网业务SP全网接入，即接入网关为SP的主力接入点1：全网业务SP镜像接入，即接入网关为SP的镜像接入点Service_Id10OctetString请求的业务标识（此项适合全网服务内容，如梦网卡图片传情）Start_code4UnsignedInteger请求的路由类型=MO时：起始业务代码（如果未置Service_Id字段，此字段为空）End_code4UnsignedInteger请求的路由类型=MO时：截止业务代码（如果未置Service_Id字段，此字段为空）Result1UnsignedInteger结果0：正常1：没有匹配路由2：源网关代码错3：路由类型错9：系统繁忙Route_total4UnsignedInteger返回路由总数Route_number4UnsignedInteger当前返回的路由序号，从1开始，顺序递增Time_stamp14OctetString本路由信息的最后修改时间格式是：yyyymmddhhmmss，例如200301170145127.6.7ISMG向汇接网关更新MT路由（CMPP_MT_ROUTE_UPDATE）操作CMPP_MT_ROUTE_UPDATE操作的目的是使ISMG可向GNS更新MT路由信息。GNS以CMPP_MT_ROUTE_UPDATE_RESP消息回应。7.6.7.1CMPP_MT_ROUTE_UPDATE消息定义（ISMG\uf0e0GNS）字段名字节数属性描述Update_type1UnsignedInteger0：添加1：删除2：更新Route_Id4Unsigned路由编号（MO/MT分别从0开始,由中国移动通信集团公司研发中心第34页共47页中国移动通信互联短信网关接口协议IntegerGNS统一分配）（若update_type为0，即添加时，此字段为零）Destination_Id6OctetString目标网关代码Gateway_IP15OctetString目标网关IP地址Gateway_port2UnsignedInteger目标网关IP端口Start_Id9OctetStringMT路由起始号码段End_Id9OctetStringMT路由截止号码段Area_code4OctetString手机所属省代码User_type1UnsignedInteger用户类型0：全球通1：神州行2：M-Zone……7.6.7.2CMPP_MT_ROUTE_UPDATE_RESP消息定义（GNS\uf0e0ISMG）字段名字节数属性描述Result1UnsignedInteger0：数据合法，等待核实4：本节点不支持更新（GNS分节点）9：系统繁忙10：Update_type错误11：路由编号错误12：目的网关代码错误13：目的网关IP错误14：目的网关Port错误15：MT路由起始号码段错误16：MT路由截止号码段错误17：手机所属省代码错误18：用户类型错误Route_Id4UnsignedInteger路由编号（当路由更新类型为更新和删除时返回原路由编号，当路由更新类型为添加时返回新分配的路由编号）Time_stamp14OctetString本路由信息的更新请求收到时间格式是：yyyymmddhhmmss，例如20030117014512说明：如果插入新路由，汇接网关就分配新的Route_Id，并且返回。中国移动通信集团公司研发中心第35页共47页中国移动通信互联短信网关接口协议7.6.8ISMG向汇接网关更新MO路由（CMPP_MO_ROUTE_UPDATE）操作CMPP_MO_ROUTE_UPDATE操作的目的是使ISMG可向GNS更新MO路由信息。GNS以CMPP_MO_ROUTE_UPDATE_RESP消息回应。7.6.8.1CMPP_MO_ROUTE_UPDATE消息定义（ISMG\uf0e0GNS）字段名字节数属性描述Update_type1UnsignedInteger0：添加1：删除2：更新Route_Id4UnsignedInteger路由编号（若update_type为0，即添加时，此字段为零）Destination_Id6OctetString目标网关代码Gateway_IP15OctetString目标网关IP地址Gateway_port2UnsignedInteger目标网关IP端口SP_Id6OctetStringSP的企业代码SP_Code21OctetStringSP的服务号码SP_AcessType1UnsignedIntegerSP接入类型0：全网业务SP全网接入，即接入网关为SP的主力接入点1：全网业务SP镜像接入，即接入网关为SP的镜像接入点Service_Id10OctetString请求的业务标识（此项适合全网服务内容，如梦网卡图片传情,如该路由不包含此业务，此字段为空）Start_code4UnsignedIntegerMO路由起始业务代码（如果未置请求的Service_Id字段，此字段为空）End_code4UnsignedIntegerMO路由截止业务代码（如果未置请求的Service_Id字段，此字段为空）7.6.8.2CMPP_MO_ROUTE_UPDATE_RESP消息定义（GNS\uf0e0ISMG）字段名字节数属性描述Result1Unsigned0：数据合法，等待核实中国移动通信集团公司研发中心第36页共47页中国移动通信互联短信网关接口协议Integer4：本节点不支持更新（GNS分节点）9：系统繁忙10：Update_type错误11：路由编号错误12：目标网关代码错误13：目标网关IP错误14：目标网关Port错误19：SP_Id错误20：SP_Code错误21：SP_AccessType错误22：Service_Id错误23：Start_code错误24：End_code错误Route_Id4UnsignedInteger路由编号（当路由更新类型为更新和删除时返回原路由编号，当路由更新类型为添加时返回新分配的路由编号）Time_stamp14OctetString本路由信息的更新请求收到时间格式是：yyyymmddhhmmss，例如20030117014512说明：如果插入新路由，汇接网关就分配新的Route_Id，并且返回。7.6.9汇接网关向ISMG更新MT路由（CMPP_PUSH_MT_ROUTE_UPDATE）操作CMPP_PUSH_MT_ROUTE_UPDATE操作的目的是使GNS可向ISMG更新MT路由信息。ISMG以CMPP_PUSH_MT_ROUTE_UPDATE_RESP消息回应。7.6.9.1CMPP_PUSH_MT_ROUTE_UPDATE消息定义（GNS\uf0e0ISMG）字段名字节数属性描述Update_type1UnsignedInteger0：添加；1：删除；2：更新Route_Id4UnsignedInteger路由编号Destination_Id6OctetString目标网关代码Gateway_IP15OctetString目标网关IP地址中国移动通信集团公司研发中心第37页共47页中国移动通信互联短信网关接口协议Gateway_port2UnsignedInteger目标网关IP端口Start_Id9OctetStringMT路由起始号码段End_Id9OctetStringMT路由截止号码段Area_code4OctetString手机所属省代码User_type1UnsignedInteger用户类型0：全球通1：神州行2：M-Zone……Time_stamp14OctetString本路由信息的最后修改时间格式是：yyyymmddhhmmss，例如200301170145127.6.9.2CMPP_PUSH_MT_ROUTE_UPDATE_RESP消息定义（ISMG\uf0e0GNS）字段名字节数属性描述Result1UnsignedInteger0：成功更改5：路由信息更新失败6：汇接网关路由信息时间戳比本地路由信息时间戳旧9：系统繁忙7.6.10汇接网关向ISMG更新MO路由（CMPP_PUSH_MO_ROUTE_UPDATE）操作CMPP_PUSH_MO_ROUTE_UPDATE操作的目的是使GNS可向ISMG更新MO路由信息。ISMG以CMPP_PUSH_MO_ROUTE_UPDATE_RESP消息回应。7.6.10.1CMPP_PUSH_MO_ROUTE_UPDATE消息定义（GNS\uf0e0ISMG）字段名字节数属性描述Update_type1UnsignedInteger0：添加；1：删除；2：更新Route_Id4UnsignedInteger路由编号中国移动通信集团公司研发中心第38页共47页中国移动通信互联短信网关接口协议Destination_Id6OctetString目标网关代码Gateway_IP15OctetString目标网关IP地址Gateway_port2UnsignedInteger目标网关IP端口SP_Id6OctetStringSP的企业代码SP_Code21OctetStringSP的服务号码SP_AcessType1UnsignedIntegerSP接入类型0：全网业务SP全网接入，即接入网关为SP的主力接入点1：全网业务SP镜像接入，即接入网关为SP的镜像接入点Service_Id10OctetString请求的业务标识（此项适合全网服务内容，如梦网卡图片传情,如该路由不包含此业务，此字段为空）Start_code4UnsignedIntegerMO路由起始业务代码（如果未置请求的Service_Id字段，此字段为空）End_code4UnsignedIntegerMO路由截止业务代码（如果未置请求的Service_Id字段，此字段为空）time_stamp14OctetString本路由信息的最后修改时间格式是：yyyymmddhhmmss，例如200301170145127.6.10.2CMPP_PUSH_MO_ROUTE_UPDATE_RESP消息定义（ISMG\uf0e0GNS）字段名字节数属性描述Result1UnsignedInteger0：成功更改5：路由信息更新失败6：汇接网关路由信息时间戳比本地路由信息时间戳旧9：系统繁忙7.7系统定义7.7.1Command_Id定义消息Command_Id值说明中国移动通信集团公司研发中心第39页共47页中国移动通信互联短信网关接口协议CMPP_CONNECT0x00000001请求连接CMPP_CONNECT_RESP0x80000001请求连接应答CMPP_TERMINATE0x00000002终止连接CMPP_TERMINATE_RESP0x80000002终止连接应答CMPP_SUBMIT0x00000004提交短信CMPP_SUBMIT_RESP0x80000004提交短信应答CMPP_DELIVER0x00000005短信下发CMPP_DELIVER_RESP0x80000005下发短信应答CMPP_QUERY0x00000006发送短信状态查询CMPP_QUERY_RESP0x80000006发送短信状态查询应答CMPP_CANCEL0x00000007删除短信CMPP_CANCEL_RESP0x80000007删除短信应答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_MT_ROUTE0x00000012获取MT路由请求CMPP_GET_MT_ROUTE_RESP0x80000012获取MT路由请求应答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路由更新应答CMPP_GET_MO_ROUTE0x00000017获取MO路由请求CMPP_GET_MO_ROUTE_RESP0x80000017获取MO路由请求应答7.7.2错误码使用说明目前CMPP2.0中定义了响应消息中的10个返回码，其中0表示成功，1-9分别表示各种错误类型，各厂家在返回错误码时应尽可能向这9个错误码靠拢，当然，因为设计的原因或者查错的方便，厂家可以在规定的厂家自定义错误码空间中定义自己的错误码，但是，定义错误码时不允许存在类似与“其它错误”或者“系统错误”这类含义模糊的情况，即各中国移动通信集团公司研发中心第40页共47页中国移动通信互联短信网关接口协议厂家能够对自己返回的每一个错误码给出明确的含义解释，以利于错误发生时的定位工作0－99为CMPP协议保留的错误码空间，请各厂家在预留的错误码空间范围：100－199内自行定义，并提供详细的编码解释列表。7.7.3ISMG与GNS之间消息使用的错误码定义0：系统操作成功；1：没有匹配路由；2：源网关代码错误；3：路由类型错误；4：本节点不支持更新（GNS分节点）；5：路由信息更新失败；6：汇接网关路由信息时间戳比本地路由信息时间戳旧；9：系统繁忙；10：Update_type错误；11：路由编号错误；12：目的网关代码错误；13：目的网关IP错误；14：目的网关Port错误；15：MT路由起始号码段错误；16：MT路由截止号码段错误；17：手机所属省代码错误；18：用户类型错误；19：SP_Id错误；20：SP_Code错误；21：SP_AccessType错误；22：Service_Id错误；23：Start_code错误；24：End_code错误。中国移动通信集团公司研发中心第41页共47页中国移动通信互联短信网关接口协议100~199：厂家自定义错误码空间。7.7.4GNS上路由信息的Route_Id的编号规则按运营商、MO/MT分类，由0开始往上分配。中国移动通信集团公司研发中心第42页共47页中国移动通信互联短信网关接口协议附录1短信群发功能的实现目前拟定按如下方式实现MT短信的群发功能（对SMC暂不实现群发）：SP侧ISMG接收到CMPP_SUBMIT消息后，判断是否为群发的MT短信，如果为群发的SMC，则返回错误；如果为其它类型的操作，仍旧按照以前的业务流程进行。如果是群发的MT短信（假设群发目的号码数为n），则将该消息拆包为n条CMPP_Fwd消息或直接发给SMSC的SUBMIT_SM消息，其中计费规则（对谁计费和计费多少）与单条MT短信的计费规则相同。返回给SP的CMPP_SUBMIT_RESP消息中的Msg_Id则暗示一个范围，即Msg_Id～Msg_Id＋（n－1）分别对应n个目的手机用户的信息标识，那么在返回的状态报告中可以依据Msg_Id～Msg_Id＋（n－1）范围内的数字匹配出群发短信中的每一个短信发送请求。需要注意的是，Msg_Id～Msg_Id＋（n－1）范围内的信息标识不能被随后的其它CMPP_SUBMIT_RESP消息使用。在Msg_Id中的“序列号”如下定义：“序列号：bit16~bit1，顺序增加，步长为1，循环使用。”，那么如果在Msg_Id～Msg_Id＋（n－1）范围中仍然依据此规则，如果其中“序列号”到达最大值，则从0开始循环使用。增加此短信群发功能，实际上等同于SP把以前分为n次发送的短信合并到一条消息中，但是SP仍然应该把此一条消息当作n条短信提交请求，并相应记录n条话单，SP拿n条话单与移动公司进行对帐和结算。在短信群发的消息中，仍然需要判断消息中的计费号码、所有的目的号码的合法性，SP应该保证其中每个号码都是合法的，如果其中任何一个号码有错误，接入ISMG对此消息判断为错误，并给SP返回错误，不对其中任何号码进行发送处理。接入ISMG对SP下发的短信的流量具有限制功能，对SP流量的统计对短信群发来说，应该计算为n条短信。中国移动通信集团公司研发中心第43页共47页中国移动通信互联短信网关接口协议附录2GNS协议目前实现说明1、MT路由信息中的Start_Id和End_Id应该相同，格式均应该为13XH0H1H2H3（其中X为5、6、7、8、9）；2、MO路由信息目前主要根据Source_Id（源网关代码）和SP_Code（SP的服务代码）决定，Service_Id和Service_Code目前尚未使用；3、Route_Id的编号目前仅按照MO/MT进行分别编号，并且MO和MT类的路由Route_Id均从0开始编号。中国移动通信集团公司研发中心第44页共47页中国移动通信互联短信网关接口协议修订历史版本号时间主要内容或重大修改CMPPV1.2.12001.6CMPPV2.02002.41.修改了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.对原协议中的端口号作了重新规定。CMPPV2.12003.51、取消“源ISMG”和“目的ISMG”的说法，把用户归属的ISMG简称为“归属ISMG”，把SP接入的ISMG简称为“接入ISMG”，如果“归属ISMG”和“接入ISMG”为同一个ISMG，则用“归属/接入ISMG”或者“接入/归属ISMG”来代称；但在泛称时仍可能使用“源ISMG”和“目的ISMG”；2、明确SP与ISMG之间、ISMG与ISMG之间的连接建议为采用长连接方式；3、明确SP与ISMG之间的连接方式：SP为客户端、ISMG中国移动通信集团公司研发中心第45页共47页中国移动通信互联短信网关接口协议为服务器端；4、取消CMPP_SUBMIT中对短信群发必须在SP不要求状态报告时的限制；5、状态报告中增加了MA:xxxx、MB:xxxx、CA:xxxx、CB:xxxx的状态值；6、明确CMPP_FWD消息中的Src_Id和Dest_Id字段的填写情况，原则上不再允许状态报告中填写空值；7、更新了GNS协议的所有消息，增加了GNS协议相关的系统定义（CommandId、错误码、Route_Id的编号规则）；8、添加了对错误码使用范围的说明；9、删除了原“附录1MO状态报告的产生”，因为MO状态报告在《移动梦网短信业务信令流程规范》中已经进行详细的说明；10、因为要求ISMG对CMPP_SUBMIT中的各字段进行更详细的判断，添加了CMPP_SUBMIT_RESP中的返回码的取值范围；11、删除了原CMPP_FWD中对状态报告的产生流程的描述，因为这些流程在《移动梦网短信业务信令流程规范》中已经进行了详细的说明；CMPPV3.02003-6-31、删除CMPP_SUBMIT、CMPP_DELIVER、CMPP_FWD消息中的Reserve字段，添加LinkID字段；（20个字节长字符串类型）；2、CMPP_SUBMIT消息：增加Fee_terminal_type字段，表明Fee_terminal_Id是真实用户号码还是伪码；3、CMPP_SUBMIT消息：扩展Fee_terminal_Id长度为32字节，适应伪码的长度需求，并把其类型从UnsignedInteger修改为OctetString。4、CMPP_SUBMIT消息：增加Dest_terminal_type字段，表明Dest_terminal_Id是真实用户号码还是伪码；5、CMPP_SUBMIT消息：扩展Dest_terminal_Id的单元长度为32字节，适应伪码的长度需求。6、CMPP_DELIVER消息：增加Src_terminal_type字段，表明Src_terminal_Id是真实用户号码还是伪码；7、CMPP_DELIVER消息：扩展Src_terminal_Id的单元长度为32字节，适应伪码的长度需求。8、CMPP_FWD消息：增加Fee_terminal_Pseudo字段，32个字节长；9、CMPP_FWD消息：增加Src_Id_Pseudo字段，32个字节长；10、CMPP_FWD消息：增加Src_Id_type字段，表明MO中国移动通信集团公司研发中心第46页共47页中国移动通信互联短信网关接口协议时传递给SP的到底是真实号码还是伪码；11、CMPP_FWD消息：增加Dest_Id_Pseudo字段，32个字节长。12、CMPP_FWD消息：增加Fee_terminal_UserType字段；13、CMPP_FWD消息：增加Src_UserType字段；14、CMPP_FWD消息：增加Dest_UserType字段；15、CMPP_FWD消息：增加FeeType的值：06表明包月查询。16、把所有响应消息中的状态码字段从1个字节扩展为4个字节，包括：CMPP_CONNECT_RESP消息中的status字段；CMPP_SUBMIT_RESP消息中的Result字段；CMPP_DELIVER_RESP消息中的Result字段；CMPP_CANCEL_RESP消息中的Success_Id字段；CMPP_FWD消息中的Result字段；GNS部分相关协议不作修改。17、CMPP_SUBMIT消息：Register_Delivery字段删除对2（产生SMC话单）的支持；18、对于3.0版本CMPP，要求CMPP_CONNECT消息和CMPP_CONNECT_RESP消息中的Version字段表示3.0版本；19、把Service_Id的名称从“业务类型”改为“业务标识”；20、删除CMPP中用于ISMG之间短连接的端口号，不再允许ISMG直接采用短连接；中国移动通信集团公司研发中心第47页共47页',)