息中心营帐受理接口说明(电信版).docVIP

中兴通讯短消息中心营帐受理接口说明 （电信版） 说明： 本文档定义了短消息中心和营帐系统间的用户信息受理接口。接口遵循《中国电信CDMA短消息中心设备规范》。 营帐系统与短消息中心之间为TCP/IP连接，本规范定义了两种接口方式：消息接口和文件接口，推荐使用消息接口方式进行业务受理。 数据定义 数据类型定义 类型名称 对应标准C语言类型 字节数 说明 WORD unsigned short 2 BYTE unsigned char 1 BYTEi unsigned char[i] I DWORD unsigned long 4 INT Int 4 CHAR Char 1 CHARi char[i] I 用CHAR数组表示的字符串，必须以0字符或（NULL）结尾 字节序定义 本接口所定义的数据在网络中传输时，采用标准网络字节序（Big-Endian）。 消息头（Message Head）定义 单元 长度 类型 说明 Command ID 2 WORD 定义本条消息所对应的操作，见1.4 Command Length 2 WORD 消息长度 Client Node 2 WORD 由短消息厂家分配。 短消息中心可以不处理。 （默认为201，要求客户端可配置） Server Process 2 WORD 由短消息厂家分配。 短消息中心可以不处理此字段。 （默认为210，要求客户端可配置） 各类操作的消息头定义 操作 Command ID 开户/请求 11005 开户/响应 11010 查询用户/请求 11015 查询用户/响应 11020 修改用户/请求 11025 修改用户/响应 11030 销户/请求 11035 销户/响应 11040 接口说明 消息接口 营帐系统与短消息中心之间通过异步Socket通信。短消息中心作为服务器端，提供以下IP供营帐系统连接： ，侦听端口为3000。营帐作为客户端bind到短消息中心，和短消息中心进行受理消息的交互。 以下接口的请求消息方向皆为营帐－SMSC，响应消息的方向为SMSC－营帐。 开户 请求 单元 长度 类型 说明 Message Head 8 参见1.3中定义。必填。 Sequence No. 4 DWORD 由消息发起方分配的一个用于把请求消息与响应消息关联起来的序号。必填。 Sub MDN 10 BYTEi 用BCD编码的用户MDN。必填。 Sub MIN 5 BYTEi 用BCD编码的用户MIN。必填。如果是空MIN，此5字节必须填全0xFF Sub type 1 BYTE 用户优先级： 数值0表示普通优先级； 数值1表示高优先级 必填。 Sub language 1 BYTE 语言类型： 0:English 1:Simplified Chinese 其他：保留 必填。 Sub service 32 BYTEi 业务鉴权信息 1、第1个字节表示网内点对点业务鉴权(数值1表示业务允许；数值0表示业务禁止)。 第12个字节表示网间互通点对点业务鉴权（数值1表示业务允许；数值0表示业务禁止） 2、其他字节保留，供以后新增的其他直连短消息中心的应用扩展使用 必填。 注：如果业务被禁止，则不能发消息，也不能收消息 Time 20 CHARi 开户时间，格式如下： “YYYY-MM-DD HH:MM:SS” 必填。 Tsp 4 DWORD 当前操作时间戳 对营帐要求： 对同一个用户的开户和修改操作，填写操作时间戳，时间戳为顺序递增的。（如对某一个用户A） 第一次操作：A用户开户设置初始时间戳为1。 第二次操作：修改用户A信息时间戳（2）必须大于1。 第三次操作：修改用户A信息时间戳（3）必须大于2。 对短消息中心要求： 短消息中心可以不处理此字段 PPFlag 1 BYTE 预付费标记： 0：非预付费用户 1：预付费用户 必填。 OCS 21 CHARi OCS号码，可以为空。 响应 单元 长度 类型 说明 Message Head 8 参见1.3中定义 Sequence No. 4 DWORD 由消息发起方分配的一个用于把请求消息与响应消息关联起来的序号 Command Result 2 WORD 操作结果， 0－成功； 非0－见3.1 查询用户 请求 单元 长度 类型 说明 Message Head 8 参见1.3中定义 Sequence No. 4 DWORD 由消息发起方分配的一个用于把请求消息与响应消息关联起来的序号 Sub MDN 10 BYTEi 用BCD编码的用户MDN Sub MIN 5 BYTEi 用BCD编码的用户