短信中心与CRM的接口规范摘自联通集团规范(SMC,SACP均可参考).docVIP

SMSC与BSS用户状态同步接口 TCP协议接口 连接方式 BSS与SMSC之间采用长连接方式，BSS作为客户端，SMSC作为服务器端，由客户端主动发起建立连接并通过连接保持消息包，维护连接。 当客户端要发送命令时，主动向服务器端建立连接，然后向服务器端发送命令，并接收应答；服务器端从客户端接收命令，返回应答。 客户端可以同时向服务器端建立多个连接（暂定8条，可配置）；命令及其应答之间的时间间隔最大不能超过3秒（默认，可配置），超时需要重发（重发3次，可配置）；双方在没有消息传递时发送消息维持包保持通讯状态。 包头流水号规则 BSS与SMSC之间传输的每一条命令都有一个流水号，流水号由发起方产生并唯一标记一条命令；也就是说，BSS与SMSC中任何两个命令的流水号都不相同。需要注意的是，一条命令在发送过程中重试的不同副本，应视为一条命令，使用相同的流水号。 流水号由0开始，循环进位，直到进位满了之后再清零，重新开始计数。接收方在返回应答时，应答的流水号必须和相对应的命令的流水号相同。 消息定义 项目 说明 消息头 消息头部分 消息体 消息体部分 数据类型 类型 说明 Integer 无符号整数 Text 定长字符串，左对齐存储，空余位置补“\0” 消息头 字段 类型 长度（字节）定长 说明 Message Length Integer 4 消息的总长度(字节) Command ID Integer 4 命令ID Sequence Number Integer 4 流水号 Command ID定义 Command ID名称 Command ID取值 Bind 0 Bind_Resp 0 Unbind 0 Unbind_Resp 0 User_Info 0 User_Info_Resp 0 Keep_Alive 0 Keep_Alive_Resp 0 消息体说明 一个数据包总长度不可大于10k。 对存在多条返回记录的业务，一数据包可含多条记录。长度如超过10K，应以多包数据发送。 Bind操作 Bind操作用于在客户端和服务器之间建立连接。Bind操作由Bind命令和Bind_Resp应答组成。客户端首先发送Bind命令，服务器端收到Bind命令后，对命令发送方进行验证，然后返回Bind_Resp应答。 Bind命令的语法 字段 类型 长度（字节） 说明 Login Name Text 16 服务器端给客户端分配的登录名 Login Password Text 16 服务器端和Login Name对应的密码 Reserve Text 8 保留，扩展用 Bind_Resp应答的语法 字段 类型 长度（字节） 说明 Result Integer 1 Bind执行命令是否成功。 0：执行成功 执行失败时填写错误代码（详见 附录A） Reserve Text 8 保留，扩展用 Unbind操作 Unbind操作由Unbind命令和Unbind_Resp应答组成。通信连接建立以后，客户端如果要停止通信，需要发送Unbind命令；服务器端收到Unbind命令后，向客户端发送Unbind_Resp相应，然后双方断开连接。 Unbind命令的语法 Unbind命令没有消息体。 Unbind_Resp应答的语法 Unbind_Resp应答没有消息体。 User_Info操作 User_Info操作由User_Info命令和User_Info_Resp应答组成。通信连接建立以后，User_Info命令用于BSS向SMSC系统传送用户状态有新变化的记录，可以1次传送多条记录； SMSC系统服务器收到User_Info命令数据后，进行用户数据处理，处理完成后，向客户端发送User_Info_Resp信息，包含记录处理结果和出错原因代码信息。 User_Info语法 字段 说明 字段 类型 长度 （字节） 备注 Count 记录数 Integer 4 保留，取值固定1。 SequenceId 记录流水号 Integer 4 命令内流水号 MessageID 工单号 Text 18 SMSC不处理 SubscrbStat 用户状态操作 Text 5 用户状态改变类型： 91001-新建用户， 91002-改号， 91003-销户， 91004-预约销户， 91005-取消预约销户， 91009-开机， 91010-营业停机， 91011-欠费停机, 91020-过户, 91030-修改用户信息, 91090-其他，备用 除91001和91003、9103