短消息SMPP开发接口概要
SMPP是一种通用的短信接口协议，本文摘录了能实现短信基本功能的内容。
前言
短消息中心（SMSC）可以与各种扩展短消息实体（ESME）配合工作，从而为移动用户提供丰富多采的功能。
符号和缩略语
ESME Agent
External Short Message Entity Agent 扩展短消息实体代理
ESME
External Short Message Entity 扩展短消息实体
PLMN
Public Land Mobile Network 公共陆地移动网
SMSC
Short Message Service Center 短消息中心
SMPP
Short Message Peer to Peer 短消息点对点协议
SS
Secretary System 秘书台
AS
Auto System 自动台
SMSC指短消息中心。
ESME在本规范中指的是通过本规范规定的协议与SMSC通信，请求特定的短消息服务的功能实体。
SS指人工话务接入并受理短消息服务请求的系统。
AS指利用交互式语音技术受理短消息服务请求的系统。
SS（秘书台）和AS（自动台）是典型的ESME。
SMSC和ESME之间的传输网络可以是基于X.25, 或TCP/IP。
ESME到SMSC的消息
ESME到SMSC的消息，如：提交、查询、删除短消息等请求，ESME必须以TRANSMITTER类型连接到SMSC。
图4描述了一个典型的TRANSMITTER类型的请求应答的示例。TRANSMITTER类型的ESME是以BIND_TRANCESMITTER连接到SMSC的ESME，此类型的ESME向SMSC发起提交短消息，查询短消息状态，删除短消息等请求，SMSC返回请求的应答。
ESME和SMSC之间的请求应答消息可以是阻塞方式也可以是异步方式的。所以ESME可能在SMSC没有应答的情况下，发起多个请求到SMSC。
SMSC应该按照收到的请求顺序，给EMSE回响应。但是ESME必须能够处理没有按顺序的响应。
SMSC到ESME的消息
SMSC到ESME的消息，如：SMSC转发短消息到ESME，ESME必须以RECEIVER类型连接到SMSC。
图5描述了一个典型的RECEIVER类型的ESME和SMSC之间的消息序列的示例。RECEIVER类型的ESME是以BIND_RECEIVER连接到SMSC的ESME，SMSC向此类ESME转发短消息，ESME向SMSC回应答。
ESME和SMSC之间的请求应答消息可以是阻塞方式也可以是异步方式的。所以SMSC可能在ESME没有回应答的情况下，发送发起多个deliver_sm请求到ESME。
ESME应该按照收到的请求顺序，给SMSC返回响应。但是SMSC必须能够处理没有按顺序回的响应。
消息流
本规范中规定的所有协议，不管是从ESME到SMSC，还是从SMSC到ESME的消息，接收到请求的一方，都必须给请求方回一个应答消息（acknowledge）。
消息语法
在以下语法说明中，遵从以下规则：
A.未使用的字段，依据类型必须设置为0或NULL。
B.消息由消息头和消息体组成。
C.状态（Command_status）的定义如表3所示。
状态定义
错误代码
描述
E_SUCCESS（0X00000000）
成功
E_OTHERERR（0X00000001）
其他错误
0X00000002 – 0X0000000F
保留给SMSC厂商定义错误
E_MSGLENERR（0X00000010）
消息长度错误
E_CMDLENERR（0X00000011）
命令长度错误
E_INVLDCMDID（0X00000012）
消息ID无效
E_NORIGHT（0X00000013）
没有执行此命令的权限
0X00000014 – 0X0000001F
保留
E_INVLDSYSTEMID（0X00000020）
无效的SYSTEMID
E_INVLDPASSWORD（0X00000021）
无效的密码
E_INVLDSYSTEMTYPE（0X00000022）
无效的SYSTEMTYPE
0X00000023 – 0X0000003F
保留
E_ADDRERR（0X00000040）
地址错误
E_MOEXCEED（0X00000041）
超过最大提交数
E_MTEXCEED（0X00000042）
超过最大下发数
E_INVLDUSER（0X00000043）
无效的用户
E_INVLDDATAFMT（0X00000044）
无效的数据格式
E_CREATEMSGFAILURE（0X00000045）
创建消息失败
E_INVLDMSGID（0X00000046）
无效的短消息ID
E_DATABASEFAILURE（0X00000047）
数据库失败
E_CANCELMSGFAILURE（0X00000048）
取消消息失败
E_MSGSTATEERR（0X00000049）
短消息状态错误
E_REPLACEMSGFAILURE（0X0000004A）
替换消息失败
E_INVLDRPLADDR（0X0000004B）
替换消息源地址错误
0X0000004C – 0X0000005F
保留
E_INVLDORGTON（0X00000060）
无效的源地址TON
E_INVLDORGNPI（0X00000061）
无效的源地址NPI
E_ORGADDRERR（0X00000062）
源地址错误
E_INVLDDESTTON（0X00000063）
无效的目的地址TON
E_INVLDDESTNPI（0X00000064）
无效的目的地址NPI
E_DESTADDRERR（0X00000065）
目的地址错误
E_INVLDSCHEDULE（0X00000066）
无效的定时时间
E_INVLDEXPIRE（0X00000067）
无效的超时时间
E_INVLDESM（0X00000068）
无效的ESM_CALSS
E_INVLDUDLEN（0X00000069）
无效的UDLEN
E_INVLDPRI（0X0000006A）
无效的PRI
E_INVLDRDF（0X0000006B）
无效的Registered_delivery_flag
E_INVLDRPF（0X0000006C）
无效的Replace_if_present_flag
0X0000006D – 0X0000007F
保留
用户管理部分（可选）
E_USERALREADYEXIST（0X00000080）
指定用户已经存在
E_CREATEUSERERR（0X00000081）
创建用户失败
E_USERIDERR（0X00000082）
用户ID错误
E_USERNOTEXIST（0X00000083）
指定用户不存在
0X00000084 – 0X0000008F
保留
0X00000090 – 0X00000FFF
保留给SMSC厂商定义错误
其他
保留
类型定义
（1）integer：一定字节数所组成的整数，高位在前，低位在后。例 如：1字节（BYTE），2字节（WORD ) , 4字节 （DWORD) ，6字节等等。
（2）C_String：以NULL结束的ASCII字符串。
（3）C_DecString：以NULL结束的ASCII字符串，它由一系列的10进制字符 组成（‘0’---‘9’）。
（4）C_OctetString：由任意8位字节组成数据流串。
（5）C_HexString：以NULL结束的ASCII字符串，它由一系列的16进制字符组 成（‘0’---‘9’，‘A’（‘a’）---‘F’（‘f’））。
（6）C_UnicodeString：以NULL结束的Unicode编码的字符串。
（7）C_StringTime：表示时间的字符串，它为以下格式。“YYMMDDhhmmsstnnp" ， 长度定为17个字节或1个字节，最后一个字节值必须为NULL，1个字节表示 使用缺省的时间定义（由短消息中心实现时具体设置），17个字节的具体格式 如下：
YY'
年份的最后2位 (00-99)
MM
月份(01-12)
DD
日 (01-31)
Hh
小时 (00-23)
Mm
分 (00-59)
Ss
秒 (00-59)
T
十分之一秒 (0-9)
Nn
与UTC (Universal Time Constant) 时间超前或落后 的差距(00-48).
‘+’（p)
时间超前于UTC time.
‘-’（p)
时间落后于 UTC time.
对于千年问题，采用时间窗口的方法来解决，具体方法为YY>90解释为19YY；否则解释为20YY。
消息头语法
表4：短消息头语法
字段
长度（字节）
类型
描述
Command_Length
4
integer
消息包的长度，包括此字段
Command_ID
4
integer
这个字段表明此条短消息的类型，例如ESME_SUB_SM表示此消息为ESME向SMSC提交短消息。具体数值定义见附录A。
Command_status
4
integer
此字段表示一个命令的成功与失败，如失败，指示引起失败的错误类型等信息，它在请求中必须设为0。
Sequence_No
4
integer
此字段表示消息的序列号，它由ESME产生，它是消息和它的应答之间的对应标志，它的数值在0到0XFFFFFFFF间必须保证严格单调的递增，当达到0XFFFFFFFF时，从0开始下一循环。
Optional Message Body
可变
混合
此字段表示短消息的消息体部分，具体定义见6.5.2
消息体语法
以下几条命令实现后，就可以实现短消息的收发。
BIND_RECEIVER命令
此命令在扩展短消息实体和短消息中心之间产生虚连接，该连接支持所有的协议命令。
BIND_RECEIVER语法
消息头中的Command_ID是“bind_receiver"
表5：BIND_RECEIVER语法
字段
长度(字节)
类型
描述
system_id
最大 16
C_String
接口ID
password
最大 9
C_String
密码
system_type
最大 13
C_String
接口类型
Interface_version
1
integer
接口版本号
Ton
1
integer
保留，应设置为0
npi
1
integer
保留，应设置为0
address_range
最大 41
C_DecString
保留，应设置为NULL
BIND_RECEIVER_RESP语法
消息头中的Command_ID 是“bind_receiver_resp"。
表6：BIND_RECEIVER_RESP语法
字段
大小(字节)
类型
描述
System_id
最大 16
C_String
接口ID
状态取值范围：
E_SUCCESS
E_OTHERERR
E_CMDLENERR
E_NORIGHT
E_INVLDSYSTEMID
E_INVLDPASSWORD
E_INVLDSYSTEMTYPE
E_INVLDIFVER
UNBIND命令
此命令用于断开ESME和SMSC之间的连接。
UNBIND语法
此消息只有消息头，没有消息体，消息头中的Command_ID是“unbind"。
UNBIND_RESP语法
此消息只有消息头，没有消息体，消息头中的Command_ID是“unbind_resp"。
状态取值范围：
E_SUCCESS
E_OTHERERR
E_CMDLENERR
E_NORIGHT
6.5.2.4 SUBMIT_SM命令
此命令用于ESME提交短消息到SMSC,以便SMSC把此短消息发给特定的移动台。
SUBMIT_SM语法
消息头中的Command_ID是"submit_sm"
表7：SUBMIT_SM语法
字段
长度（字节）
类型
描述
service_type
最大6
C_OctetString
保留，必须设为0
source_address_ton
1
integer
源地址编码类型
source_address_npi
1
integer
源地址编码方案
source_address
最大21
C_DecString
源地址
dest_address_ton
1
integer
目的地址编码类型
dest_address_npi
1
integer
目的地址编码方案
destination_address
最大21
C_DecString
目的地址
esm_class
1
integer
短消息类型
protocol_ID
1
integer
GSM协议类型
priority_flag
1
integer
优先级
schedule_delivery_time
最大17
C_StringTime
计划下发短消息的时间
validity_period
最大17
C_StringTime
短消息的最后有效期限
registered_delivery_flag
1
integer
注册短消息标志
replace_if_present_flag
1
integer
替换短消息标志。
data_coding
1
integer
数据编码方案
sm_default_msg_id
1
integer
预定义短消息ID
sm_length
1
integer
短消息的长度
short_message_text
最大161
可变
短消息数据内容
SUBMIT_SM_RESP语法
消息头中的Command_ID是"submit_sm_resp"
表8：SUBMIT_SM_RESP语法
字段
长度（字节）
类型
描述
Message_id
最大9
C_HexString
短消息ID
状态取值范围：
E_SUCCESS
E_OTHERERR
E_CMDLENERR
E_NORIGHT
E_ADDRERR
E_MOEXCEED
E_MTEXCEED
E_INVLDUSER
E_INVLDDATAFMT
E_CREATEMSGFAILURE
E_INVLDORGTON
E_INVLDORGNPI
E_ORGADDRERR
E_INVLDDESTTON
E_INVLDDESTNPI
E_DESTADDRERR
E_INVLDSCHEDULE
E_INVLDEXPIRE
E_INVLDESM
E_INVLDUDLEN
E_INVLDPRI
E_INVLDRDF
E_INVLDRPF
DELIVER_SM命令
此命令由SMSC产生，SMSC通过此命令发送短消息到目的ESME，它也可用于发送转发状态报告（DELIVERY RECEIPT）消息。
DELIVER_SM语法
它的语法和SUBMIT_SM的语法消息体是相同的，只是在消息头中的Command_ID是“deliver_sm"。
DELIVER_SM_RESP语法
它的语法和SUBMIT_SM_RESP的语法消息体是一样的，只是在消息头中的Command_ID是“deliver_sm_resp"。
附：消息体参数说明
address：
地址号码
address_range
地址范围
data_coding：
数据编码方案, ( 详见GSM 03.40 [1] 9.2.3.10)
dest_address_npi：
目的地址编码方案，同npi
dest_address_ton：
目的地址编码类型，同ton
destination_address：
目的地址，同address
esm_class：
短消息类型
Bit:
7
6
5
4
3
2
1
0
Flag:
Reserved
UDHI
Reserved
Delivery
RCPT
Reserved
其中UDHI为1表示短消息内容中有头结构，为0表示没有头结构。
Delivery RCPT为1表示是此条短消息是状态报告，0表示为正常的下发短消息。此位只对DELIVER_SM有效。
其他为保留。
如果有头结构，short_message_text为以下格式：
{
BYTE UDHL; //信息元素的结构集合所用的字节数
Information?Element-struct Information?Element;
//若干信息元素的结构集合, 其占用的字节数目由UDHL指示
...
SM; 短消息内容
}
其中Information?Element-struct的结构如下:
{
BYTE Information?Element?Identifier // 信息元素的标志
BYTE Length of Information?Element //信息元素数据所用的字节数
Information?Element Data
//信息元素数据，其占用的字节数目由Length of Information?Element指示
}
定义详见GSM 03.40 (7.2.0) 9.2.3.24
final_date：
短消息的生命期终止的实际时间，如果此短消息已从SMSC的等待发送队列中删除，即为删除时间，否则为SMSC当前的时间
GSM_code：
GSM错误码，见下表
错误码
值
描述
ERROR_NONE
0
无错误
P_UNKNOWN
1
不知道的用户
P_PROVISION
2
不提供此功能
T_BARRED
3
呼叫废弃
T_SUPPORT
4
此机制不支持
T_ABSENT
5
用户不能通讯
T_MSSUPPORT
6
移动台不支持短消息
T_MSERROR
7
移动台接收短消息出现错误
P_ILLEGAL_SUB
8
不合法的用户
P_ILLEGAL_EQUIP
9
不合法的设备
T_SYSTEM
10
系统失败
T_MEMCAP
11
内存不足
interface_version：
用来描述本协议的版本号
在ESME连接SMSC时，如果ESME提出的版本号高于SMSC的版本号，则SMSC给出否定响应，响应中的status表示SMSC的版本号；ESME提出的版本号低于或等于SMSC的版本号，则SMSC给出肯定响应，在连接成功后的会话过程中，双方将以ESME提出的版本号作为通信的依据。interface_version的值从1开始，0保留。
现约定，对于interface_version>=1，必须支持除REPLACE_SM_EX命令和用户管理命令以外的所有协议命令, 对于interface_version>=2, 必须支持所有本文中提到的协议命令。
message_id：
短消息ID，它由SMSC设置。用于查询以及替换短消息等操作时使用。
message_status：
短消息当前的状态：
0：转发状态
1：发送成功（不在尝试转发）
2：发送失败（不在尝试转发）
3：因下发失败而等待（继续尝试转发）
4：因定时消息而等待（继续尝试转发）
5：短消息被删除（不在尝试转发）
6：短消息超时删除（不在尝试转发）
7：无效状态（不在尝试转发）
8：EN_ROUTE，为兼容SMPP协议保留
9：DELIVERED，为兼容SMPP协议保留
10：EXPIRED，为兼容SMPP协议保留
11：DELETED，为兼容SMPP协议保留
12：UNDELIVERABLE，为兼容SMPP协议保留
13：ACCEPTED，为兼容SMPP协议保留
14：INVALID，为兼容SMPP协议保留
其他：保留
MS_type：
手机类型
0：中文手机
1：英文手机
>1：保留
npi：
地址编码方案，（定义详见GSM03.40[1] 9.1.2.5)
0：未知
1：ISDN电话编码方案
3：数据编码方案(X.121)
4：电报编码方案
8：国家编码方案
9：专用编码方案
10：ERMES 编码方案(ETSI DE/PS 3 01?3)
15：扩充保留
从0到15的其他值保留
OCOS：
最大提交短消息，某移动台提交到SMSC的等待下发的短消息的最大数目
password：
用来登录的密码
priority_flag：
优先级
1：高优先级
0：普通优先级
>1：保留
protocol_ID：
GSM协议类型（定义详见GSM03.40[1] 9.2.3.9)
registered_delivery_flag：
注册短消息标志，它表示当此短消息到达最后的目的地后，是否需要 转发状态报告（DELIVERY RECEIPT）。
0：不需要
1：需要
>1：保留
replace_if_present_flag：
替换标志，当SUBMIT命令中指示的源地址和目的地址与等待下发的短消息的源地址和目的地址都相同时，是否替换这些等待下发的短消息。在DELIVERY命令中该参数无效，需置为0。
0：不替换
1：替换
>1：保留
schedule_delivery_time：
对于SUBMIT命令，该参数指计划下发短消息的时间，对于DELIVERY命令，该参数指SMSC收到要下发到ESME的短消息的时间。
service_type：
保留，必须设为NULL，原该参数指明短消息服务的类别
short_message_text：
短消息数据内容，当编码类型为7位码，类型为C_String，最大长度为160个字符。8位码时，类型为C_String，最大长度为140个字节。当为Unicode时，类型为C_UnicodeString，最大长度为70个字符。
SM_allowed：
是否提供短消息业务
0：不提供
1：提供
其余值保留
sm_default_msg_id：
预定义短消息ID，不是预定义短消息时应设为0。预定义短消息ID值从0x01到 0x64，其值的具体含义由特定的ESME和SMSC约定。其余值保留。
sm_length：
短消息的数据长度，以字节计算。
source_address：
源地址编号，同address。
source_address_npi：
源地址编码方案，同npi。
source_address_ton：
源地址编码类型，同 ton。
sub_address：
用户通信地址。
sub_ID：
用户ID，同address。
sub_name：
用户名。
reg_datetime：
用户注册登记时间 。
system_id：
接口ID，用来描述虚拟连接的用户名，即ESME登录SMSC使用的帐号。
system_type：
用来描述用户的类型。
TCOS：
最大下发数，指等待下发到某移动台的最大短消息数目。
ton：
地址编码类型，（定义详见GSM03.40[1] 9.1.2.5)
0 未知号码
1 国际号码，例如8613901234567
2 国内号码，例如13901234567
3 网络专用号码
4 用户号码
5 字母号码(按照 GSM?TS03.38 7-bit 缺省字母表编码)
6 缩写号码
7 保留
validity_peroid：
短消息的最后生存期限。
附录A：命令标志数值定义
命令码宏定义
数值
描述
ESME_BNDRCV
0X00000001
ESME要求连接到SMSC
ESME_BNDRCV
0X80000001
连接SMSC的响应
ESME_BNDTRN
0X00000002
ESME要求连接到SMSC
ESME_BNDTRN_RESP
0X80000002
连接SMSC的响应
ESME_UBD
0X00000006
ESME要求断开连接到SMSC
ESME_UBD_RESP
0X80000006
断开连接的响应
ESME_SUB_SM
0X00000004
ESME提交短消息到SMSC，以便SMSC下发此短消息到特定的用户。
ESME_SUB_SM_RESP
0X80000004
提交短消息的响应
ESME_DELIVER_SM
0X00000005
SMSC下发短消息到特定的ESME
ESME_DELIVER_SM_RESP
0X80000005
下发短消息的响应
ESME_QUERY_SM
0X00000003
ESME查询以前所提交的短消息的状态
ESME_QUERY_SM_RESP
0X80000003
查询短消息的响应
ESME_CANCEL_SM
0X00000008
ESME要求取消以前所提交的某条短消息
ESME_CANCEL_SM_RESP
0X80000008
ESME要求取消以前所提交的某条短消息的响应
ESME_REPLACE_SM
0X00000007
ESME要求替换以前所提交的某条短消息
ESME_REPLACE_SM_RESP
0X80000007
ESME要求替换以前所提交的某条短消息的响应
ESME_QRYLINK
0X00000015
询问扩展短消息实体与短消息中心的连接情况
ESME_QRYLINK_RESP
0X80000015
询问扩展短消息实体与短消息中心的连接情况的响应
ESME_NACK
0X80000000
接收消息头错误的响应
ESME_REPLACE_SM_EX
0X00000090
ESME要求替换以前所提交的某条短消息的扩展命令，它增加了数据编码格式字段
ESME_REPLACE_SM_EX_RESP
0X80000090
扩展替换短消息的的响应
ESME_ADD_SUB
0X000000A0
增加用户
ESME_ADD_SUB_RESP
0X800000A0
增加用户的响应
ESME_DEL_SUB
0X000000A1
删除用户
ESME_DEL_SUB_RESP
0X800000A1
删除用户的响应
ESME_MOD_SUB
0X000000A2
修改用户
ESME_MOD_SUB_RESP
0X800000A2
修改用户的响应
ESME_QRY_SUB
0X000000A3
查询用户的信息
ESME_QRY_SUB_RESP
0X800000A3
查询用户的信息的响应
