第三分册 短消息中心外部接口协议(CNPPV2.0).doc

1 中国网络通信集团公司企业标准中国网络通信集团公司企业标准 CNC T 6 2003 PHS 短消息技术规范短消息技术规范 第三分册第三分册 短消息中心外部接口协议短消息中心外部接口协议 CNPP V2 0 PHS 短消息技术规范 第三分册 I 目目 录录 前前 言言 1 1 适用范围适用范围 2 2 引用标准引用标准 2 3 缩略语缩略语 2 4 协议概述协议概述 3 4 1 系统网络结构示例 3 4 2 协议功能 4 4 3 CNPP 协议定义 4 4 4 协议栈 5 4 5 通信方式 5 4 5 1 长连接 6 4 5 2 短连接 8 4 6 会话流程 9 4 6 1 登录模式 9 4 6 2 典型流程 10 4 6 2 1 发送模式 10 4 6 2 2 接收模式 11 4 6 2 3 收发模式 12 5 CNPP PDU 定义定义 13 5 1 PDU 列表 13 5 1 1 ESME到SMSC的消息 13 5 1 2 SMSC到ESME的消息 13 5 2 基本数据类型 15 5 3 PDU 结构 15 PHS 短消息技术规范 第三分册 II 5 4 PDU 头格式 15 5 5 PDU 体结构 16 5 5 1 BIND命令 16 5 5 1 1 BIND RECEIVER 语法 16 5 5 1 2 BIND RECEIVER RESP 语法 16 5 5 1 3 BIND TRANSMITTER 语法 17 5 5 1 4 BIND TRANSMITTER RESP 语法 17 5 5 1 5 BIND TRANSCEIVER 语法 17 5 5 1 6 BIND TRANSCEIVER RESP 语法 17 5 5 2 UNBIND命令 17 5 5 2 1 UNBIND 语法 17 5 5 2 2 UNBIND RESP 语法 18 5 5 3 GENERIC NACK命令 18 5 5 3 1 GENERIC NACK 语法 18 5 5 4 SUBMIT SM命令 18 5 5 4 1 SUBMIT SM 语法 18 5 5 4 2 SUBMIT SM RESP 语法 20 5 5 5 SUBMIT MULTI命令 20 5 5 5 1 SUBMIT MULTI 语法 20 5 5 5 2 SUBMIT MULTI RESP 语法 22 5 5 6 DELIVER SM命令 23 5 5 6 1 DELIVER SM 语法 23 5 5 6 2 DELIVER SM RESP 语法 24 5 5 7 DATA SM命令 25 5 5 7 1 DATA SM 语法 25 5 5 7 2 DATA SM RESP 语法 26 5 5 8 QUERY SM命令 26 5 5 8 1 QUERY SM 语法 26 5 5 8 2 QUERY SM RESP 语法 27 PHS 短消息技术规范 第三分册 III 5 5 9 CANCEL SM命令 27 5 5 9 1 CANCEL SM 语法 27 5 5 9 2 CANCEL SM RESP 语法 28 5 5 10 REPLACE SM命令 28 5 5 10 1 REPLACE SM 语法 28 5 5 10 2 REPLACE SM RESP 语法 29 5 5 11 ENQUIRE LINK命令 30 5 5 11 1 ENQUIRE LINK 语法 30 5 5 11 2 ENQUIRE LINK RESP 语法 30 5 5 12 ALERT NOTIFICATION命令 30 5 5 12 1 ALERT NOTIFICATION 语法 30 6 状态报告状态报告 31 7 参数数值定义参数数值定义 32 7 1 COMMAND ID数值定义 32 PHS 短消息技术规范 第三分册 第 1 页 前前 言言 本标准描述了 PHS 短消息中心 SMSC 和外部短消息实体 ESME 之 间的通信协议 本协议简称 CNPP China Netcom Short Message Peer to Peer Protocol 本标准是 PHS 短消息网关技术规范的系列规范之一 该系列规范的名称如 下 PHS 短消息网关技术规范 第一分册 短消息网关与服务提供商 SP 接 口规范 CNGP PHS 短消息网关技术规范 第二分册 短消息网关与计费中心接口规范 PHS 短消息网关技术规范 第三分册 短消息中心外部接口协议 CNPP PHS 短消息网关技术规范 第四分册 短消息网关设备规范 PHS 短消息网关技术规范 V2 0 说明 PHS 短消息技术规范 第三分册 第 2 页 1 适用范围 本规范规定了 PHS 通信网外部短消息实体 ESME 与短消息中心 SMSC 之间通信协议的技术细节 本规范主要适用于 PHS 通信网外部短消息实体 ESME 和短消息中心 SMSC 为短消息中心 SMSC 接入外部短消息实体 ESME 提供技术 依据 2 2 引用标准 引用标准 SMPP Short Message Peer to Peer Protocol Specification v3 4 3 3 缩略语 缩略语 英文缩写英文缩写英文全称英文全称说明说明 ESMEExternal Short Message Entity外部短消息实体 PDUProtocol Data Unit协议数据单元 SMEShort Message Entity短消息实体 SMPPShort Message Peer to Peer短消息点对点协议 SMSCShort Message Service Center短消息中心 ACKAcknowledgement确认应答 NACKNegative Acknowledgement否认应答 CDRCall Detail Record详细呼叫记录 APIApplication Programming Interface应用编程接口 SMGWShort Message Gateway短消息网关 PSPersonal Station用户终端 SSSecretary System秘书台 ASAuto System自动台 注 在本规范中 ESME 泛指那些处在 PHS 通信网外的短消息源或者接收 PHS 短消息技术规范 第三分册 第 3 页 实体 如 SMGW SS AS 语音邮箱系统和消息处理计算机等 SME 则位于 PHS 通信网内 一般就指用户终端 PS 4 4 协议概述 协议概述 本规范规定了 SMSC 和 ESME 之间通信的数据格式 本规范是在 SMPP3 3 协议的基础上 经过扩展而成 4 14 1 系统网络结构示例系统网络结构示例 SMSC ESMEs ESME1 如SMGW ESME2 如VMS ESME3 如AS ESME4 如SS PHS通信网 用户终端 CNPP CNPP CNPP CNPP 图 1 SMSC 和 ESME 连接的短消息系统网络图 SMSC 指短消息中心 PHS 短消息技术规范 第三分册 第 4 页 ESME 在本规范中指的是通过本规范规定的协议与 SMSC 通信 请求特定 的短消息服务的功能实体 SMGW 指短消息网关 VMS 指语音邮箱系统 SS 指人工话务接入并受理短消息服务请求的系统 AS 指利用交互式语音技术受理短消息服务请求的系统 SMGW VMS SS 和 AS 是典型的 ESME SMSC 和 ESME 之间基于 TCP IP 协议进行通信 4 24 2 协议功能协议功能 通过本规范 一个外部短消息实体 ESME 可以在 TCP IP 连接之上与 SMSC 建立应用层连接 通过该连接 ESME 与 SMSC 之间可以互相发送和接收短消 息 此外 ESME 还可以查询 取消和替代短消息 CNPP 可以实现的功能举例如下 1 ESME 通过 SMSC 向一个或多个目的地址发送短消息 2 ESME 可以通过 SMSC 从其他的 SME 如用户终端 接收短消息 3 查询存储在 SMSC 的短消息的状态 4 取消或替代存储在 SMSC 的短消息 5 设定短消息的发送日期和时间 6 选择短消息的模式 即数据报或者存储转发 7 设置短消息发送的优先级 8 定义短消息的数据编码类型 9 设置短消息的有效期限 4 34 3 CNPP 协议定义协议定义 CNPP 协议是一个数据报方式的交互式协议 通过 TCP IP 协议传递数据 ESME 和 SMSC 之间通过交换请求和应答 PDU 来进行通信 本规范定义了 1 ESME 和 SMSC 之间交互的命令集以及与之相关的 PDU PHS 短消息技术规范 第三分册 第 5 页 2 ESME 和 SMSC 在 CNPP 命令里交换的数据 在 CNPP 里 每一个命令都由一个请求 PDU 和一个应答 PDU 组成 接收 方对于每一个 CNPP PDU 请求 都必须返回一个应答 唯一的例外是 alter notification 没有应答 PDU ESME 和 SMSC 之间的交互消息可以归类为如下的两个部分 1 ESME 到 SMSC 的消息 2 SMSC 到 ESME 的消息 4 44 4 协议栈协议栈 CNPP 标准以 TCP IP 作为底层通信承载 具体结构由图 2 所示 CNPP TCP IP 承载网络 CNPP TCP IP 承载网络 ESMESMSC 图 2 CNPP 协议栈 4 54 5 通信方式通信方式 ESME 和 SMSC 之间进行信息交互时 SMSC 作为服务器端 ESME 作为 客户端建立连接 可以采用长连接方式 也可以采用短连接方式 所谓长连接 指在一个 TCP 连接上可以连续发送多个数据包 在 TCP 连接保持期间 如果 没有数据包发送 需要双方发链路检测消息以维持此连接 短连接是指通信双 方有数据交互时 就建立一个 TCP 连接 数据发送完成后 则断开此 TCP 连 接 即每次 TCP 连接只完成一对 CNPP 消息的发送 基于效率上的考虑 建议使用长连接方式 PHS 短消息技术规范 第三分册 第 6 页 4 5 14 5 1 长连接长连接 通信双方以客户 服务器方式建立 TCP 连接 用于双方信息的相互提交 当 信道上没有数据传输时 通信双方应每隔时间 C 发送链路检测消息以维持此连 接 当链路检测消息发出超过时间 T 后未收到应答 应立即再发送链路检测消 息 再连续发送 N 1 次后仍未得到应答则断开此连接 参数 C T N 原则上应可配置 现阶段建议取值为 C 3 分钟 T 60 秒 N 3 ESME 和 SMSC 之间的消息发送后等待 T 秒后未收到应答 应立即重发 再连续发送 N 1 次后仍未得到应答则停发 现阶段建议取值为 T 60 秒 N 3 消息采用并发方式发送 加以滑动窗口流量控制 窗口大小参数 W 可配置 现 阶段建议为 16 即接收方在应答前一次收到的消息最多不超过 16 条 长连接的操作流程举例如图 3 所示 PHS 短消息技术规范 第三分册 第 7 页 建立 TCP 连接 CNPP 消息 1 客户端服务器端 CNPP 消息 2 对 CNPP 消息 1 的应答 对 CNPP 消息 2 的应答 链路检测消息 链路检测消息应答 建立 TCP 连接 链路检测消息 链路检测消息应答 拆除 TCP 连接 建立 TCP 连接 图 3 长连接 PHS 短消息技术规范 第三分册 第 8 页 4 5 24 5 2 短连接短连接 通信双方以客户 服务器方式建立 TCP 连接 应答与请求在同一个连接中完 成 系统采用客户 服务器模式 操作以客户端驱动方式发起连接请求 完成一 次操作后关闭此连接 ESME 和 SMSC 之间的消息发送后等待 T 秒后未收到应答 应立即重发 再连续发送 N 1 次后仍未得到应答则停发 现阶段建议取值为 T 60 秒 N 3 短连接的操作流程举例如图 4 所示 对 CNPP 消息 1 的应答 CNPP 消息 1 建立 TCP 连接 拆除 TCP 连接 CNPP 消息 2 对 CNPP 消息 2 的应答 建立 TCP 连接 拆除 TCP 连接 建立 TCP 连接 客户端服务器端 PHS 短消息技术规范 第三分册 第 9 页 图 4 短连接的操作流程 4 64 6 会话流程会话流程 4 6 14 6 1 登录模式登录模式 在 CNPP 标准的一个会话中 ESME 可以采用三种方式与 SMSC 相连 发送 模式 Transmit Mode 接收模式 Receive Mode 和收发模式 Transceiver Mode 在发送模式中 ESME 只能发送短消息 在接收模式中 ESME 只能接收 短消息 在收发模式中 ESME 既可以发送也可以接收短消息 三种模式均可以 采用长连接与短连接两种连接方式的一种 根据实际情况选择 PHS 短消息技术规范 第三分册 第 10 页 4 6 24 6 2 典型流程典型流程 4 6 2 14 6 2 1 发送模式发送模式 ESME bind transmitter 1 SMSC bind transmitter resp 1 submit sm 2 submit sm resp 2 submit sm 3 submit sm 4 submit sm 5 submit sm 6 submit sm resp 3 submit sm resp 4 submit sm resp 5 submit sm resp 6 unbind 7 unbind resp 7 图 5 ESME 以发送模式连接到 SMSC 图 5 描述了一个典型的发送模式下的请求应答序列 ESME 以发送模式连 接到 SMSC ESME 向 SMSC 发起提交短消息 查询短消息状态 删除短消息 等请求 SMSC 返回请求的应答 ESME 和 SMSC 之间的请求应答消息可以是阻塞方式也可以是异步方式的 所以 ESME 可能在 SMSC 没有应答的情况下 发起多个请求到 SMSC SMSC 应该按照收到的请求顺序 给 ESME 回响应 但是 ESME 必须能够 处理没有按顺序的响应 PHS 短消息技术规范 第三分册 第 11 页 4 6 2 24 6 2 2 接收模式接收模式 ESME bind receiver1 SMSC bind receiver resp 1 deliver sm resp 1 deliver sm 3 deliver sm 4 deliver sm 2 unbind 2 unbind resp 2 deliver sm 1 deliver sm resp 2 deliver sm resp 3 deliver sm resp 4 图 6 ESME 以接收模式连接到 SMSC 图 6 描述了一个典型的接收模式下的消息序列 ESME 以接收模式连接到 SMSC SMSC 向此类 ESME 转发短消息 ESME 向 SMSC 回应答 ESME 和 SMSC 之间的请求应答消息可以是阻塞方式也可以是异步方式的 所以 SMSC 可能在 ESME 没有回应答的情况下 发送发起多个 deliver sm 请求 到 ESME ESME 应该按照收到的请求顺序 给 SMSC 返回响应 但是 SMSC 必须能 够处理没有按顺序回的响应 PHS 短消息技术规范 第三分册 第 12 页 4 6 2 34 6 2 3 收发模式收发模式 ESME bind transceiver1 SMSC bind transceiver resp 1 data sm resp 1 data sm 3 data sm 2 unbind 4 unbind resp 4 data sm 1 data sm resp 2 data sm resp 3 data sm 2 data sm 3 data sm resp 2 data sm resp 3 图 7 ESME 以收发模式连接到 SMSC 图 7 描述了一个典型的收发模式下的请求应答序列 ESME 以收发模式连 接到 SMSC ESME 向 SMSC 发起提交短消息 查询短消息状态 删除短消息 等请求 SMSC 返回请求的应答 SMSC 向 ESME 转发短消息 ESME 向 SMSC 回应答 ESME 和 SMSC 之间的请求应答消息可以是阻塞方式也可以是异步方式的 所以 ESME 可能在 SMSC 没有应答的情况下 发起多个请求到 SMSC 反之亦 然 SMSC 应该按照收到的请求顺序 给 ESME 回响应 但是 ESME 必须能够 处理没有按顺序的响应 反之亦然 PHS 短消息技术规范 第三分册 第 13 页 5 5 CNPP PDU 定义定义 5 15 1 PDU 列表列表 5 1 15 1 1 ESME 到到 SMSC 的消息的消息 命令命令描述描述实现级别实现级别 bind receiverESME 要求以接收模式连接到 SMSC必选 bind transmitterESME 要求以发送模式连接到 SMSC必选 bind transceiverESME 要求以收发模式连接到 SMSC必选 unbindESME 要求断开连接到 SMSC必选 generic nack表示消息头有错误的响应必选 submit smESME 提交短消息到 SMSC 以便 SMSC 下发 此短消息到指定的用户终端 必选 submit multiESME 提交一条短消息到 SMSC SMSC 下发 此短消息到多个接收者 或者一个或多个发布 列表 必选 deliver sm respdeliver sm 的响应必选 data smESME 请求 SMSC 发送短消息到用户终端可选 data sm respdata sm 的响应消息可选 query smESME 查询以前所提交的短消息的状态必选 cancel smESME 要求取消以前所提交的某条短消息必选 replace smESME 要求替换以前所提交的某条短消息必选 enquire link询问与 SMSC 的连接情况必选 表 1 ESME 到 SMSC 的消息 5 1 25 1 2 SMSC 到到 ESME 的消息的消息 命令命令描述描述实现级别实现级别 PHS 短消息技术规范 第三分册 第 14 页 bind receiver respbind receiver 的响应 status 表示连接成 功与否 必选 bind transmitter respbind transmitter 的响应 status 表示连 接成功与否 必选 bind transceiver respbind transceiver 的响应 status 表示连 接成功与否 必选 unbind respunbind 的响应 status 表示断开连接成 功与否 必选 generic nack表示消息头有错误的响应必选 submit sm respsubmit sm 的响应 status 表明提交短消 息是否成功 必选 submit multi respsubmit multi 的响应 必选 deliver smSMSC 下发短消息到 ESME必选 data smSMSC 将用户终端发送的短消息传递到 ESME 可选 data sm respdata sm 的响应消息可选 query sm respquery sm 的响应 status 表明此次询问 是否成功 其它内容返回查询到的短消 息信息 必选 cancel sm respcancel sm 的响应 Status 表明取消短消 息是否成功 必选 replace sm respreplace sm 的响应 status 表明此次替换 是否成功 必选 enquire link respenquire link 的响应必选 alert notification由 SMSC 产生发送给 ESME 该消息无 响应消息 可选 表 2 SMSC 到 ESME 的消息 PHS 短消息技术规范 第三分册 第 15 页 5 25 2 基本数据类型基本数据类型 类型类型说明说明 Integer无符号整数 C Octet String以 NULL 结尾的 ASCII 字符串 C Octet String Decimal 与 C Octet String 不同的是 串中的每个字符为 ASCII 码中的 0 9 C Octet String Hex 与 C Octet String 不同的是 串中的每个字符为 ASCII 码中的 0 9 A F Octet String不需以 NULL 结尾的字符串 5 35 3 PDU 结构结构 项目项目说明说明格式格式 Message Header消息头 所有消息公共包头 定长 Message Body消息体 必选部分 变长 Message Body消息体 可选部分 TLV 5 4 PDU 头格式头格式 字段名字段名字节数字节数类型类型描述描述 command length4IntegerPDU 总长度 含消息头及消息体 command id4Integer这个字段表明此条短消息的类型 例如 submit sm 表示此消息为 ESME 向 SMSC 提交短消息 取 值见 6 1 command status4Integer此字段表示一个命令的成功与失 败 如失败 指示引起失败的错 误类型等信息 它在请求中必须 PHS 短消息技术规范 第三分册 第 16 页 设为 NULL 参见第 7 2 节 status 错误代码表 sequence number4Integer消息流水号 顺序累加 步长为 1 循环使用 一对请求和应答 消息的流水号必须相同 5 55 5 PDU 体结构体结构 5 5 15 5 1 BIND 命令命令 5 5 1 15 5 1 1 BIND RECEIVER 语法语法 此命令用于 ESME 以接受者的方式与 SMSC 之间建立虚连接 连接建立后 ESME 可以从 SMSC 接受短消息 并发送 CNPP 响应消息给 SMSC 消息头中的 command id 是 bind receiver 消息体定义如下 字段字段长度 字节 长度 字节 数据类型数据类型说明说明 system id最大 16C Octet String 需要与 SMSC 连接的 ESME 标识 password最大 9C Octet String 密码 system type最大 13C Octet String 系统类型 interface version1Integer接口版本号 Addr ton1Integer地址编码类型 不使用置为 0 Addr npi1Integer地址编码方案 不使用置为 0 address range最大 41C Octet String 地址范围 不使用置为 NULL PHS 短消息技术规范 第三分册 第 17 页 5 5 1 25 5 1 2 BIND RECEIVER RESP 语法语法 此命令是 BIND RECEIVER 的响应消息 消息头中的 command id 是 bind receiver resp 消息体定义如下 字段字段长度 字节 长度 字节 数据类型数据类型说明说明 system id最大 16C Octet String ESME 请求连接的 SMSC 标识 5 5 1 35 5 1 3 BIND TRANSMITTER 语法语法 此命令用于 ESME 以发送者的方式与 SMSC 之间建立虚连接 连接建立后 ESME 可以发送短消息到 SMSC 并接受 SMSC 的 CNPP 响应消息 消息头中的 command id 是 bind transmitter 消息体的定义与 BIND RECEIVER 相同 5 5 1 45 5 1 4 BIND TRANSMITTER RESP 语法语法 此命令是 BIND TRANSMITTER 的响应消息 消息头中的 command id 是 bind transmitter resp 消息体的定义与 BIND RECEIVER RESP 相同 5 5 1 55 5 1 5 BIND TRANSCEIVER 语法语法 此命令用于 ESME 以收发者的方式与 SMSC 之间建立虚连接 连接建立后 ESME 可以发送短消息到 SMSC 也可以从 SMSC 接受短消息 消息头中的 command id 是 bind transceiver 消息体的定义与 BIND RECEIVER 相同 5 5 1 65 5 1 6 BIND TRANSCEIVER RESP 语法语法 此命令是 BIND TRANSCEIVER 的响应消息 消息头中的 command id 是 bind transceiver resp 消息体的定义与 BIND RECEIVER RESP 相同 PHS 短消息技术规范 第三分册 第 18 页 5 5 25 5 2 UNBIND 命令命令 5 5 2 15 5 2 1 UNBIND 语法语法 此命令用于断开 ESME 和 SMSC 之间的连接 消息头中的 command id 是 unbind 此消息没有消息体 5 5 2 25 5 2 2 UNBIND RESP 语法语法 此命令是 UNBIND 的响应消息 消息头中的 command id 是 unbind resp 没有消息体 5 5 35 5 3 GENERIC NACK 命令命令 5 5 3 15 5 3 1 GENERIC NACK 语法语法 此命令用于当接收消息头有错误的时候发送的否定响应 该消息只能由收 到请求的一方发出 此消息没有消息体 5 5 45 5 4 SUBMIT SM 命令命令 5 5 4 15 5 4 1 SUBMIT SM 语法语法 ESME 用此命令消息向 SMSC 提交短消息 以便 SMSC 将短消息发给指定 的 SME ESME 也可用此命令发送状态报告消息 消息头中的 command id 是 submit sm 消息体定义如下 字段字段长度 字节 长度 字节 数据类型数据类型说明说明 service type最大 6C Octet String 短消息服务类型 如果使用 SMSC 的默认值 设置为 NULL PHS 短消息技术规范 第三分册 第 19 页 source addr ton1Integer源地址编码类型 如果不知道源地 址的编码类型 设置为 0 source addr npi1Integer源地址编码方案 如果不知道源地 址的编码方案 设置为 0 source addr最大 21C Octet String 源地址 如果不知道源地址 设置 为 NULL dest addr ton1integer目的地址编码类型 dest addr npi1integer目的地址编码方案 destination addr最大 21C Octet String 目的地址 esm class1integer短消息类型 xx0000 xx 普通短消息 xx0001xx 此消息为状态报告消息 其它 保留 protocol id1integer协议类型 priority flag1integer优先级 从 0 到 3 3 为最高级 schedule deliver y time 1 或者 17C Octet String 计划下发短消息的时间 可以是绝 对时间或相对时间 如果立即发送 设置为 NULL validity peroid1 或者 17C Octet String 短消息的有效期限 可以是绝对时 间或相对时间 如果使用 SMSC 的 默认有效期限 设置为 NULL registered delive ry 1integer注册短消息标志 0 不需要状态报告 1 需要状态报告 1 保留 xxxxxx00 不需要状态报 告 xxxxxx01 需要状态报告 缺省 PHS 短消息技术规范 第三分册 第 20 页 其他 保留 replace if prese nt flag 1integer替换短消息标志 指示是否用已提 交的短消息来替代现有的短消息 0 不替换 缺省 1 替换 data coding1integer数据编码方案 sm default msg id 1integer预定义短消息标识 sm length1integer短消息长度 short message最大 254Octet String 短消息内容 5 5 4 25 5 4 2 SUBMIT SM RESP 语法语法 此消息是 SUBMIT SM 的响应消息 消息头中的 command id 是 submit sm resp 消息体定义如下 字段字段长度 字节 长度 字节 数据类型数据类型说明说明 message id最大 9C Octet String 短消息标识 5 5 55 5 5 SUBMIT MULTI 命令命令 可选 可选 5 5 5 15 5 5 1 SUBMIT MULTI 语法语法 SUBMIT MULTI 命令用于将一条 SMPP 消息发送到多个接收者 或者一个 或多个发布列表 消息头中的 command id 是 submit multi 消息体定义如下 字段字段长度长度 字节字节 数据类型数据类型说明说明 PHS 短消息技术规范 第三分册 第 21 页 service type最大 6C Octet String 短消息服务类型 如果使用 SMSC 的默认值 设置为 NULL source addr ton1Integer源地址编码类型 如果不知道源地 址的编码类型 设置为 0 source addr npi1integer源地址编码方案 如果不知道源地 址的编码方案 设置为 0 source addr最大 21C Octet String 源地址 如果不知道源地址 设置 为 NULL number of dests1integer目的地址的个数 最大值为 254 dest address es 2 24见下表一个或多个目的 SME 地址或者发 布列表 esm class1integer短消息类型 xx0000 xx 普通短消息 xx0001xx 此消息为状态报告消息 其它 保留 protocol id1integer协议类型 priority flag1integer优先级 从 0 到 3 3 为最高级 schedule deliver y time 1 或者 17C Octet String 计划下发短消息的时间 可以是绝 对时间或相对时间 如果立即发送 设置为 NULL validity peroid1 或者 17C Octet String 短消息的有效期限 可以是绝对时 间或相对时间 如果使用 SMSC 的 默认有效期限 设置为 NULL registered delive ry 1integer注册短消息标志 0 不需要状态报告 1 需要状态报告 1 保留定义见 5 5 4 1 replace if prese1integer替换短消息标志 指示是否用已提 PHS 短消息技术规范 第三分册 第 22 页 nt flag交的短消息来替代现有的短消息 0 不替换 缺省 1 替换 data coding1integer数据编码方案 sm default msg id 1integer预定义短消息标识 sm length1integer短消息长度 short message最大 254Octet String 短消息内容 目的地址定义目的地址定义 字段字段长度 字节 长度 字节 数据类型数据类型说明说明 dest flag1Integer指示目的地址是发布列表的名字还 是 SME 地址 1 SME 地址 2 发布列表的名字 SME Address or Distribution List Name 见下表见下表根据 dest flag 标志位的不同 或者 是一个 SME 地址 或者是一个发 布列表的名字 字段字段长度 字节 长度 字节 数据类型数据类型说明说明 dest addr ton1IntegerSME 地址类型 dest addr npi1IntegerSME 地址编码方案 destination addr最大 21C Octet String 目的地址 PHS 短消息技术规范 第三分册 第 23 页 发布列表定义发布列表定义 字段字段长度 字节 长度 字节 数据类型数据类型说明说明 dl name最大 21C Octet String 发布列表的名字 5 5 5 25 5 5 2 SUBMIT MULTI RESP 语法语法 此命令是 SUBMIT MULTI 的响应消息 消息头中的 command id 是 submit multi resp 消息体定义如下 字段字段长度 字节 长度 字节 数据类型数据类型说明说明 message id最大 9C Octet String 短消息标识 no unsuccess1Integer发送未成功的数目 unsuccess sme s 7 27见下表发送未成功的 SME 地址和发布列 表的名字 字段字段长度 字节 长度 字节 数据类型数据类型说明说明 Dest addr ton1IntegerSME 地址编码类型 Dest addr npi1IntegerSME 地址编码方案 dstination addr最大 21C Octet String SME 地址 error status cod e 4Integer发送到该 SME 地址是否成功 PHS 短消息技术规范 第三分册 第 24 页 5 5 65 5 6 DELIVER SM 命令命令 5 5 6 15 5 6 1 DELIVER SM 语法语法 此命令由 SMSC 产生 SMSC 通过此命令发送短消息到目的 ESME 也可 用于发送状态报告消息 消息头中的 command id 是 deliver sm 消息体定义如下 字段字段长度 字节 长度 字节 数据类型数据类型说明说明 service type最大 6C Octet String 短消息服务类型 不使用置为 NULL source addr ton1Integer源地址编码类型 如果不知道 源地址的编码类型 设置为 0 source addr npi1Integer源地址编码方案 如果不知道 源地址的编码方案 设置为 0 source addr最大 21C Octet String 源地址 Dest addr ton1Integer目的地址编码类型 Dest addr npi1Integer目的地址编码方案 destination addr最大 21C Octet String 目的地址 Esm class1Integer短消息类型 xx0000 xx 普通短消息 xx0001xx 此消息为状态报告 消息 其它 保留 protocol id1Integer协议类型 priority flag1Integer发送优先级 从 0 到 3 3 为最 高级 PHS 短消息技术规范 第三分册 第 25 页 schedule delivery time 1 或者 17C Octet String 计划下发短消息的时间 可以 是绝对时间或相对时间 如果 立即发送 设置为 NULL 时 间格式参照 SMPP 协议 validity period1 或者 17C Octet String 短消息的有效期限 可以是绝 对时间或相对时间 如果使用 SMSC 的默认有效期限 设置 为 NULL 时间格式参照 SMPP 协议 registered delivery flag 1Integer注册短消息标志 xxxxxx00 不需要状态报告 xxxxxx01 需要状态报告 缺 省 其他 保留 replace if present flag 1Integer保留 应设为 0 Data coding1Integer数据编码方案 sm default msg i d 1Integer保留 应设为 0 sm length1Integer短消息长度 short message最大 254Octet String短消息内容 5 5 6 25 5 6 2 DELIVER SM RESP 语法语法 此命令是 DELIVER SM 的响应消息 消息头中的 command id 是 deliver sm resp 消息体定义如下 字段字段长度 字节 长度 字节 数据类型数据类型说明说明 message id最大 9C Octet 短消息标识 PHS 短消息技术规范 第三分册 第 26 页 String 5 5 75 5 7 DATA SM 命令命令 5 5 7 15 5 7 1 DATA SM 语法语法 此消息用于在 ESME 和 SMSC 之间传递消息 SMSC 和 ESME 都可以使用 此消息 ESME 可以使用此消息请求 SMSC 发送短消息到用户终端 SMSC 也 可用此消息将用户终端发送的短消息传递到 ESME DATA SM 可用来传递状 态报告 消息头中的 command id 是 data sm 消息体定义如下 字段字段长度 字长度 字 节 节 数据类型数据类型说明说明 service type最大 6C Octet String 短消息服务类型 source addr ton1Integer源地址编码类型 不使用设为 0 source addr npi1Integer源地址编码方案 不使用设为 0 source addr最大 65C Octet String 源地址 dest addr ton1Integer源地址编码类型 不使用设为 0 dest addr npi1Integer源地址编码方案 不使用设为 0 destination addr最大 65C Octet String 目的地址 esm class1Integer短消息类型 xx0000 xx 普通短消息 xx0001xx 此消息为状态报告消息 其它 保留 registered delivery1Integer注册短消息标志 xxxxxx00 不需要状态报告 PHS 短消息技术规范 第三分册 第 27 页 xxxxxx01 需要状态报告 缺省 其他 保留 data coding1Integer数据编码方案 set dpfTLV发送挂起标志 当发送失败时 可 将此标志置位 qos time to liveTLV生存时长 提交后的时间长度 以 秒为单位 payload typeTLV用户数据类型 message payloadTLV用户数据 最大 64K 5 5 7 25 5 7 2 DATA SM RESP 语法语法 此消息为 DATA SM 的响应消息 消息头中的 command id 是 data sm resp 消息体定义如下 字段字段长度 字节 长度 字节 数据类型数据类型说明说明 message id最大 9C Octet String 短消息标识 SMSC 为此短消息分 配的消息标识 5 5 85 5 8 QUERY SM 命令命令 5 5 8 15 5 8 1 QUERY SM 语法语法 此命令用于 ESME 向 SMSC 查询以前所提交的短消息的状态 消息头中的 command id 是 query sm 消息体定义如下 字段字段长度 字节 长度 字节 数据类型数据类型说明说明 PHS 短消息技术规范 第三分册 第 28 页 message id最大 9C Octet String 要查询的短消息标识 当使用 submit sm data sm 和 submit multi 命令向 SMSC 提交短消息时 SMSC 会给提交的短消息分配一个 短消息标识 并通过应答消息 返 回给发送者 source addr ton1Integer源地址编码类型 source addr npi1Integer源地址编码方案 source addr最大 21C Octet String 源地址 5 5 8 25 5 8 2 QUERY SM RESP 语法语法 此命令是 QUERY SM 的响应消息 消息头中的 command id 是 query sm resp 消息体定义如下 字段字段长度 字节 长度 字节 数据类型数据类型说明说明 message id最大 9C Octet String 要查询的短消息标识 Final date1 或 17C Octet String 要查询的短消息到达最终状态的时 间 如果该短消息还没有到达最终 状态 则该字段返回 NULL message state1Integer要查询短消息的状态 Error code1Integer短消息发送失败时的错误码 5 5 95 5 9 CANCEL SM 命令命令 5 5 9 15 5 9 1 CANCEL SM 语法语法 此命令用于取消 ESME 以前所提交的 发送未决的短消息 此命令能取消 PHS 短消息技术规范 第三分册 第 29 页 指定短消息标识的短消息 也可取消等待下发的由 CANCEL SM 所指定的源地 址 目的地址和服务类型的所有短消息 此时 message id 为 NULL 消息头中的 command id 是 cancel sm 消息体定义如下 字段字段长度 字节 长度 字节 数据类型数据类型说明说明 service type最大 6C Octet String 短消息服务类型 如果想取消该服 务类型的所有短消息 设置该字段 的值 否则 设置为 NULL message id最大 9C Octet String 要取消的短消息标识 如果取消一 组短消息 设置为 NULL source addr ton1Integer短消息发起者的编码类型 如果不 知道编码类型 设置为 0 source addr npi1Integer短消息发起者的编码方案 如果不 知道编码方案 设置为 0 source addr最大 21C Octet String 要取消短消息的源地址 Dest addr on1Integer目的地址的编码类型 当指定了 message id 字段时 可以设置为 0 Dest addr npi1Integer目的地址的编码方案 当指定了 message id 字段时 可以设置为 0 destination addr最大 21C Octet String 要取消短消息的目的地址 当指定 了 message id 字段时 可以设置为 NULL 5 5 9 25 5 9 2 CANCEL SM RESP 语法语法 此命令是 CANCEL SM 的响应消息 消息头中的 command id 是 cancel sm resp 没有消息体 PHS 短消息技术规范 第三分册 第 30 页 5 5 105 5 10 REPLACE SM 命令命令 5 5 10 15 5 10 1 REPLACE SM 语法语法 此命令由 ESME 产生发送给 SMSC 用于替换以前提交的 目前仍在 SMSC 发送队列中等待发送的短消息 匹配规则是通过消息标识和源地址进行 匹配