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

中兴通讯短消息中心营帐受理接口说明（电信版）说明：1、 本文档定义了短消息中心和营帐系统间的用户信息受理接口。接口遵循中国电信CDMA短消息中心设备规范。2、 营帐系统与短消息中心之间为TCP/IP连接，本规范定义了两种接口方式：消息接口和文件接口，推荐使用消息接口方式进行业务受理。1 数据定义1.1 数据类型定义类型名称对应标准C语言类型字节数说明WORDunsigned short2BYTEunsigned char1BYTEiunsigned chariIDWORDunsigned long4INTInt4CHARChar1CHARichariI用CHAR数组表示的字符串，必须以0字符或（NULL）结尾1.2 字节序定义本接口所定义的数据在网络中传输时，采用标准网络字节序（Big-Endian）。1.3 消息头（Message Head）定义单元长度类型说明Command ID2WORD定义本条消息所对应的操作，见1.4Command Length2WORD消息长度Client Node2WORD由短消息厂家分配。短消息中心可以不处理。（默认为201，要求客户端可配置）Server Process2WORD由短消息厂家分配。短消息中心可以不处理此字段。（默认为210，要求客户端可配置）1.4 各类操作的消息头定义操作Command ID开户/请求1100开户/响应110查询用户/请求110查询用户/响应110修改用户/请求110修改用户/响应11030销户/请求1103销户/响应110402 接口说明2.1 消息接口营帐系统与短消息中心之间通过异步Socket通信。短消息中心作为服务器端，提供以下IP供营帐系统连接： ，侦听端口为3000。营帐作为客户端bind到短消息中心，和短消息中心进行受理消息的交互。以下接口的请求消息方向皆为营帐SMSC，响应消息的方向为SMSC营帐。2.1.1 开户 请求单元长度类型说明Message Head8参见1.3中定义。必填。Sequence No.4DWORD由消息发起方分配的一个用于把请求消息与响应消息关联起来的序号。必填。Sub MDN10BYTEi用BCD编码的用户MDN。必填。Sub MIN5BYTEi用BCD编码的用户MIN。必填。如果是空MIN，此5字节必须填全0xFFSub type1BYTE用户优先级：数值0表示普通优先级；数值1表示高优先级必填。Sub language1BYTE语言类型：0:English1:Simplified Chinese其他：保留必填。Sub service32BYTEi业务鉴权信息1、第1个字节表示网内点对点业务鉴权(数值1表示业务允许；数值0表示业务禁止)。第12个字节表示网间互通点对点业务鉴权（数值1表示业务允许；数值0表示业务禁止）2、其他字节保留，供以后新增的其他直连短消息中心的应用扩展使用必填。注：如果业务被禁止，则不能发消息，也不能收消息Time20CHARi 开户时间，格式如下：“YYYY-MM-DD HH:MM:SS”必填。Tsp4DWORD当前操作时间戳 对营帐要求：对同一个用户的开户和修改操作，填写操作时间戳，时间戳为顺序递增的。（如对某一个用户A） 第一次操作：A用户开户设置初始时间戳为1。 第二次操作：修改用户A信息时间戳（2）必须大于1。 第三次操作：修改用户A信息时间戳（3）必须大于2。 对短消息中心要求：短消息中心可以不处理此字段PPFlag1BYTE预付费标记：0：非预付费用户1：预付费用户必填。OCS21CHARiOCS号码，可以为空。 响应单元长度类型说明Message Head8参见1.3中定义Sequence No.4DWORD由消息发起方分配的一个用于把请求消息与响应消息关联起来的序号Command Result2WORD操作结果，0成功；非0见 查询用户 请求单元长度类型说明Message Head8参见1.3中定义Sequence No.4DWORD由消息发起方分配的一个用于把请求消息与响应消息关联起来的序号Sub MDN10BYTEi用BCD编码的用户MDNSub MIN5BYTEi用BCD编码的用户MIN（如果Query Flag0时，此字段可选）Query Flag1BYTE查询条件选择标志：数值0表示按MDN查询；数值1表示按MIN查询（可选）； 响应单元长度类型说明Message Head8参见1.3中定义Sequence No.4DWORD由消息发起方分配的一个用于把请求消息与响应消息关联起来的序号Command Result2WORD操作结果，0成功；非0见3.1Sub MDN10BYTEi用BCD编码的用户MDNSub MIN5BYTEi用BCD编码的用户MIN如果此5字节为全0xFF，表示空MINSub type1BYTE用户优先级：数值0表示普通优先级；数值1表示高优先级Sub language1BYTE语言类型：0:English1:Simplified Chinese其他值保留，显示为其他语言。Sub service32BYTEi业务鉴权信息1、第1个字节表示网内点对点业务鉴权(数值1表示业务允许；数值0表示业务禁止)。第12个字节表示网间互通点对点业务鉴权（数值1表示业务允许；数值0表示业务禁止）2、其他字节保留，供以后新增的其他直连短消息中心的应用扩展使用Time20CHARi 开户时间，格式如下：“YYYY-MM-DD HH:MM:SS”Tsp4DWORD当前操作时间戳要求同上。PPFlag1BYTE预付费标记：0：非预付费用户1：预付费用户OCS21CHARiOCS号码，可以为空。2.1.3 修改用户 请求单元长度类型说明Message Head8参见1.3中定义Sequence No.4DWORD由消息发起方分配的一个用于把请求消息与响应消息关联起来的序号Sub MDN10BYTEi用BCD编码的用户MDNSub MIN5BYTEi用BCD编码的用户MIN如果是空MIN，此5字节必须填全0xFFSub type1BYTE用户优先级：数值0表示普通优先级；数值1表示高优先级Sub language1BYTE语言类型：0:English1:Simplified Chinese其他：保留Sub service32BYTEi业务鉴权信息1、第1个字节表示网内点对点业务鉴权(数值1表示业务允许；数值0表示业务禁止)。第12个字节表示网间互通点对点业务鉴权（数值1表示业务允许；数值0表示业务禁止）2、其他字节保留，供以后新增的其他直连短消息中心的应用扩展使用。Time20CHARi 开户时间，格式如下：“YYYY-MM-DD HH:MM:SS”Tsp4DWORD当前操作时间戳要求同上。PPFlag1BYTE预付费标记：0：非预付费用户1：预付费用户OCS21CHARiOCS号码，可以为空（PPFlag=1时，不允许为空）。 响应单元长度类型说明Message Head8参见1.3中定义Sequence No.4DWORD由消息发起方分配的一个用于把请求消息与响应消息关联起来的序号Command Result2WORD操作结果，0成功；非0见 销户 请求单元长度类型说明Message Head8参见1.3中定义Sequence No.4DWORD由消息发起方分配的一个用于把请求消息与响应消息关联起来的序号Sub MDN10BYTEi用BCD编码的用户MDNSub MIN5BYTEi用BCD编码的用户MIN（如果Query Flag0时，此字段可选）Query Flag1BYTE查询条件选择标志：数值0表示按MDN销户；数值1表示按MIN销户（可选）； 响应单元长度类型说明Message Head8参见1.3中定义Sequence No.4DWORD由消息发起方分配的一个用于把请求消息与响应消息关联起来的序号Command Result2WORD操作结果，0成功；非0见3.12.2 文件接口营帐系统将用户业务受理信息写入文件并通过FTP方式给短消息中心（短消息中心为FTP服务端，营帐系统为FTP客户端）。短消息中心应可以根据文件信息进行业务受理。2.2.1 文件格式短消息业务受理包含2种操作：开户、销户。规定所有业务受理信息全写在同一格式文件内，文件名以SCOA开头，扩展名为sco。如果将开户、销户和修改用户分别称为一个操作，那么每个文件所包含的操作总数不超过500个。为了避免文件名重复使用，生成文件的系统应给每个文件分配永久的唯一标识（名称）。文件名格式为：SCOAYYYYMMDDnnnnnn.sco，其中“YYYYMMDD”表示年月日，“nnnnnn”表示序列号，从“000000”开始，到“999999”结束。文件采用ANSI文本格式。每操作（开户、销户）在文件中用一行表达。2.2.2 操作说明 开户格式如下所示：操作符,MDN,MIN,Sub Type,Sub Language,Time,PPFlag,OCS号码;说明如下： 操作符：1-开户、2-销户。 MDN：手机号码。字符串，最长20位，如：8613312340001。 MIN：如果为空，则不填。字符串，如：0123456789。 Sub Type：用户优先级，0表示普通优先级，1表示高优先级。 Sub Language：1-中文；0-英文。 Time：开户时间，字符串，格式为“YYYY-MM-DD HH:MM:SS” PP Flag：1-预付费，0-非预付费。 OCS：OCS号码，字符串，最长20位，如：460030912348888。 各字段间用英文逗号(,)做分隔符，字段为空时也占用一列，每行以分号(;)结束。例如：1,8613305660001,0912345678,1,1,2008-4-2 12:30:00,1,460030912348888;表示开户。 MDN：8613905660001（手机号码） MIN：0912345678（手机MIN号码） Sub Type：1（高优先级） Sub Language：1（中文）Time：2008-4-2 12:30:00（开户时间）PPFlag：1（预付费）OCS： 460030912348888（所属OCS号码） 销户格式如下所示：操作符,MDN;各字段间用英文逗号(,)做分隔符，字段为空时也占用一列，每行以分号(;)结束。例如：2,8613305660001; 表示删除MDN号码为8613305660001的用户2.2.3 文件样例1,8613305660001,1912345678,1,0,2008-4-2 12:30:00,1,460030912348888;1,8613305660002,2912345678,1,1,2008-4-2 12:30:00,0,460030912348888;1,8613305660003,3912345678,0,1,2008-4-2 12:30:00,1,460030912349999;1,8613305660004,4912345678,0,0,2008-4-2 12:30:00,0,460030912348888;2,8613305660005;