[计算机]第二分册短消息网关与计费中心接口规范V

1、.中国网络通信集团公司企业标准PHS短消息网关技术规范第二分册 短消息网关与计费中心接口规范V2.0；27第 页PHS短消息网关技术规范 第二分册目 录前 言11适用范围22引用标准23缩略语24消息格式定义34.1 基本数据类型34.2 消息结构34.3 消息头格式34.4 SMGW与PSC之间的消息定义44.4.1 login44.4.2 login_resp54.4.3 payment_request64.4.4 payment_request _resp84.4.5 payment_affirm84.4.6 payment_affirm_resp84.4.7 active_test94

2、.4.8 active_test_resp94.4.9 query_userstate94.4.10 query_userstate _resp94.4.11 exit94.4.12 exit_resp105计费原则115.1 后付费方式115.2 预付费方式115.3 计费文件采集126计费流程136.1 后付费MO短消息流程136.2 后付费用户发给异网用户流程136.3 后付费MT短消息流程146.4 异网用户发给PHS用户流程156.5 后付费异地点对点短消息互通流程156.6 后付费包月短消息流程166.7 后付费包月扣费短消息流程176.8 预付费MO短消息流程186.9 预付费用

3、户发给异网用户流程186.10 预付费MT短消息流程196.11 预付费异地点对点短消息互通流程206.12 预付费包月短消息流程216.13 预付费包月扣费短消息流程227话单格式238编码说明258.1 计费确认标识（ResultNotifyCode）代码表25前 言本规范规定了PHS的短消息网关（SMGW）与计费中心之间的通信协议。本规范主要适用于PHS的短消息网关（SMGW）和计费中心，为短消息网关（SMGW）接入计费中心提供技术依据。本标准是PHS短消息网关技术规范的系列规范之一，该系列规范的名称如下：PHS短消息网关技术规范 第一分册：短消息网关与服务提供商（SP）接口规范（CNG

4、P）；PHS短消息网关技术规范 第二分册：短消息网关与计费中心接口规范；PHS短消息网关技术规范 第三分册：短消息中心外部接口协议(CNPP)；PHS短消息网关技术规范 第四分册：短消息网关设备规范；PHS短消息网关技术规范 V2.0说明。1适用范围本规范规定了PHS的短消息网关（SMGW）与计费中心之间的通信协议。本规范主要适用于PHS的短消息网关（SMGW）和计费中心，为短消息网关（SMGW）接入计费中心提供技术依据。2引用标准 SMPP (Short Message Peer to Peer Protocol Specification) v3.43缩略语英文缩写英文全称说明SMGW S

5、hort Message Gateway短消息网关SMPP Short Message Peer to Peer短消息点对点协议SMSCShort Message ServiceCenter短消息中心SP Service Provider服务提供商PSCPrepaid Service Center预付费中心CRCharge RequestSP为收取业务费用而向短消息网关发送的消息，短消息网关收到消息后不送给用户，仅产生相应的话单TLVTag Length Value由tag/length/value三参数定义变量MOMessage Origination用户到SP 的上行过程MTMessage

6、 TerminationSP到用户的下行过程4消息格式定义4.1 基本数据类型类型说明Integer整数，整数的长度根据具体协议确定，多字节情况下高字节在前Unsigned Integer无符号整数Octet String定长字符串，位数不足时左对齐，右补二进制的零4.2 消息结构项目说明格式Message Header消息头（所有消息公共包头）定长Message Body消息体（必选部分）变长Message Body消息体（可选部分）TLV4.3 消息头格式字段名字节数类型描述total_length4Unsigned Integer消息总长度(含消息头及消息体)command_id4Uns

7、igned Integer命令标识command_status4Unsigned Integer命令状态（参见CNGPV2.0的7.4status错误代码表）sequence_id4Unsigned Integer消息流水号，顺序累加，步长为1，循环使用（一对请求和应答消息的流水号必须相同）4.4 SMGW与PSC之间的消息定义请求名称请求标识消息方向说明login0x00000001SMGW®PSC登录请求login_resp0x80000001SMGW¬PSC登录请求的应答payment_request0x0000000ASMGW®PSC扣款请求payment

8、_request _resp0x8000000ASMGW¬PSC扣款请求的应答payment_affirm0x0000000BSMGW®PSC扣款确认payment_affirm_resp0x8000000BSMGW¬PSC扣款确认的应答active_test0x00000004SMGW®PSC握手请求active_test_resp0x80000004SMGW¬PSC握手请求的应答query_userstate0x0000000CSMGW®PSC查询用户状态query_userstate _resp0x8000000CSMGW

9、72;PSC查询用户状态的应答exit0x00000006SMGW®PSC退出请求exit_resp 0x80000006SMGW¬PSC退出请求的应答4.4.1 login字段长度（字节）数据类型说明ClientID10Octet String此处为SMGW代码AuthenticatorClient16Octet String客户端密码用于鉴别客户端的接入请求。其值通过单向MD5 hash计算得出，表示如下：AuthenticatorClient =MD5（ClientID+7字节的二进制0 +Shared secret+TimeStamp） Shared secret

10、由服务器端与客户端事先商定的，最长15 字节， TimeStamp格式为：mmddhhmmss，即月日时分秒，10位LoginMode1Integer登录类型（0=发送短消息，1=接收短消息，2=收发短消息，其他保留）TimeStamp4Integer时间戳的明文，由客户端产生，格式为mmddhhmmss，即月日时分秒，10位数字的整型，右对齐 Version1Integer客户端支持的版本号(高位4bit表示主版本号，低位4bit表示次版本号)4.4.2 login_resp字段长度（字节）数据类型说明AuthenticatorServer16Octet String服务器端认证码，当客户端

11、认证出错时，此项为空其值通过单向MD5 hash计算得出，表示如下：AuthenticatorServer=MD5(Status+AuthenticatorClient+Shared secret) Shared secret 由服务器端与客户端事先商定，最长15 字节 AuthenticatorClient为客户端发送给服务器端的上一条消息login中的值Version1Integer服务器支持的最高版本号4.4.3 payment_request字段长度（字节）数据类型说明MsgID10Octet StringSMGW产生的短消息流水号，由三部分组成：SMGW代码：3字节（BCD码）时间：

12、4字节（BCD码）序列号：3字节（BCD码）SMType1Integer短消息类型（0=PHS用户发到SP的MO，1PHS用户发到异网用户，2SP发到PHS用户的MT，3异网用户发到PHS用户，4本省不同厂商网络间的点到点，5同一二级SMGW下的不同SMSC之间的点对点，5=异省省点到点，其他保留）SubType 1Integer短消息子类型（0取消订阅，1订阅或点播请求，2点播下发，3订阅下发，其他保留）ChargeTermID21Octet String短消息计费用户号码SPID10Octet String内容提供商统一编号DestTermID21Octet String短消息接收号码Se

13、rviceID10Octet String短消息的业务类型FeeType2Octet String资费类型00=免费01=按条收费02=包月03=封顶04=包月扣费请求05=CR话单其他：保留FeeCode6Octet String每条短消息的信息费，由SP填写，单位：分Priority1Integer发送优先级（从0到3），3是最高级MsgLength1Unsigned Integer短消息长度AreaCode4Octet String 计费用户号码的区号部分（前添零），例如020，0755SMGWNo6Octet String产生话单的SMGW代码FwdSMGWNo6Octet Strin

14、g下级网元代码SMSCNo6Octet String上级网元代码RecvTime 14Octet String格式= yyyymmddhhmmss， 例如20010530120101DoneTime14Octet String如果是MT 话单，则记录SMGW成功提交短消息给SMSC的时间；如果是MO 话单，则记录内容提供商成功接收短消息的时间；如果是异地或者异网话单，则记录SMGW成功转发短消息到外地SMGW的时间4.4.4 payment_request _resp字段长度（字节）数据类型说明ReslutNotifyCode1Integer计费确认标识码（见编码说明8.1）4.4.5 pay

15、ment_affirm字段长度（字节）数据类型说明MsgID10Octet StringSMGW产生的短消息流水号，由三部分组成：SMGW代码：3字节（BCD码）时间：4字节（BCD码）序列号：3字节（BCD码）ReportStatus1Integer消息状态0：提交成功 1：提交失败FeeAddr 21Octet String计费用户地址4.4.6 payment_affirm_resp无消息体4.4.7 active_test无消息体4.4.8 active_test_resp无消息体4.4.9 query_userstate字段长度（字节）数据类型说明QueryUserAddr21Oct

16、et String查询用户号码SMGWNo6Octet String SMGW代码，查询号码的SMGW代码4.4.10 query_userstate _resp字段长度（字节）数据类型说明UserStatus 1Octet String用户状态：0：正常状态；1：帐户不存在；2：余额不足；3：帐户不可用；4：非预付费用户其它：保留。Count 4Integer预付费帐户上的余额，单位：人民币（分）。非正常状态时，填为04.4.11 exit无消息体4.4.12 exit_resp无消息体5计费原则目前，PHS 系统主要分为两种计费模式，即后付费计费模式和预付费计费模式。费用构成包括以下几部分

17、：1) 上行通信费：用户点播或者订阅一条信息，其服务请求被SP 正确接收，即产生一笔上行通信费用。2) 下行通信费：SP 发送一条点播或者订阅信息，被用户正确接收，即产生一笔下行通信费用。3) 信息费：SP 发送一条点播或者订阅信息，被用户正确接收，即对用户产生一笔点播、订阅信息费用。该费用是SP 委托中国网络通信集团公司收取的代收费用，其资费策略和费率由SP 在信息包中指定，目前支持免费、按条和包月计费。5.1 后付费方式业务请求上行流程中，对用户收取上行通信费，计费原始话单信息在SMGW产生。业务请求下行流程中，对SP收取下行通信费，对用户收取信息费，计费原始话单信息也在SMGW产生。当S

18、MGW与多个计费中心相连时，只送与该计费中心相关的话单。SMGW将根据本协议的SMType 字段定义计费话单类型，以便计费系统采用独立和灵活的计费策略对用户进行计费。5.2 预付费方式业务请求上行流程中，对用户收取上行通信费，由SMGW通过本协议与预付费平台交互进行实时扣费。业务请求下行流程中，对用户收取信息费可以采用预付费方式，由SMGW通过本协议与预付费平台交互进行实时扣费。预付费采用先查后扣的方式，首先由SMGW向预付费平台查询余额（query_userstate），状态报告返回结果成功，再扣款（payment_request）。5.3 计费文件采集对于预付费和后付费方式，网关都应产生话

19、单。话单除了话单采集目录和备份目录，还应有一个对账目录，用于与其他运营商对账。1) 接口协议：FTP。2) 话单采集目录：SMGW上的billing/ 网关先按照PHS预付费、PHS后付费、固网短消息将话单区分目录（对于没有开展固网短消息业务的情况不需此目录）；如果各地计费系统有需要，应进一步将各地的话单按区号分目录存放，如311（石家庄）、312（保定）等。网关先按照PHS预付费、PHS后付费、固网短消息将话单区分目录（对于没有开展固网短消息业务的情况不需此目录），然后分为TOTAL目录和根据各地实际情况需要按照各地的区号分别存放话单的目录。例如：保定的PHS预付费话单存放在“billing

20、/PHS预付费/312”目录下。3) 话单备份目录：SMGW上的backup/采集终端采集失败时可以从此目录中获取同名的文件。目录设置同话单采集目录。4) 话单对账目录：SMGW上的operator/网关将网内话单和、与其他每个运营商互连的话单分别存放在不同的目录下，以用于对账。例如：CMCC、CTC等等。对账目录至少保留一个帐务周期。5) 文件命名规则：局名日期循环序列号例如：假设河北局命名为HBISMG，则话单如：HBISMG.20010612.0001序列号和日期无关，在0000 9999 间循环。6) 采集方式：由采集终端FTP到相应的话单采集目录（如：“billing/ PHS后付费

21、/311”），拷贝后删除，如果有问题，应能从话单备份目录中获取同名的文件；话单备份目录的维护应该由厂家负责；至少保留一个帐务周期，定期自动删除，计费采集终端对话单备份目录只有读的权限。6计费流程6.1 后付费MO短消息流程后付费用户发送短消息给SP的流程，由发起的SMGW计费，比如： 图6.1 后付费MO短消息流程图本地用户àSMSC1àSMGW2àSMGW3 àSP由SMGW2计费。6.2 后付费用户发给异网用户流程后付费用户发送短消息给异网用户的流程，由发起的SMGW计费，比如：图6.2 后付费用户发给异网用户流程图PHS用户àSMSC1&

22、#224;SMGW2àSMGW3 à异网SMGW由SMGW2计费。与异网SMGW连接的PHS互联SMGW也产生话单，以便与其他运营商进行结算核对。6.3 后付费MT短消息流程SP发送短消息给后付费用户的流程，由落地的SMGW计费， 比如：图6.3 后付费MT短消息流程图SPà SMGW3àSMGW2à SMSC1 à异地用户由SMGW2计费6.4 异网用户发给PHS用户流程异网用户发送短消息给PHS用户的流程，由接收异网短消息的SMGW产生话单，以便与其他运营商进行结算。 SMSC产生状态报告，SMGW修改状态报告中的MsgID并转发

23、，比如：图6.4 异网用户发给PHS用户流程图异网SMGWà SMGW3àSMGW2à SMSC1 àPHS用户注：此处PHS用户包括预付费用户和后付费用户。6.5 后付费异地点对点短消息互通流程后付费用户发送短消息给异省用户或者后付费用户发送短消息给同一二级SMGW下不同SMSC的用户的流程，由发起地的SMGW计费。以异省点对点短消息为例： 图6.5 后付费异地点对点短消息互通流程图本地用户àSMSC1àSMGW2à SMGW3 à SMGW4àSMSC5à异地用户由SMGW2计费6.6 后付

24、费包月短消息流程包月服务对用户的普通信息不进行扣费，SMGW只统计下行量，以便对SP结算流量。比如：图6.6 后付费包月短消息流程图SPàSMGW3àSMGW2àSMSC1à用户6.7 后付费包月扣费短消息流程包月服务扣费信息由落地SMGW对用户扣费。扣费结果通过状态报告进行通知，包括扣费失败、扣费成功、已扣费。网关可以配置是否向用户发送扣费通知短消息。比如：图6.7 后付费包月扣费短消息流程图暂将计费通知的格式定为：现在SP<SPID>已扣您本月的业务<ServiceId>包月费共计xxx.xx元。SPà SMGW3&

25、#224;SMGW2à SMSC1 à异地用户由SMGW2计费6.8 预付费MO短消息流程预付费用户发送短消息给SP的流程，由发起的SMGW计费，比如： 图6.8 预付费MO短消息流程图本地用户àSMSC1àSMGW2àSMGW3 àSP由SMGW2计费6.9 预付费用户发给异网用户流程预付费用户发送短消息给异网用户的流程，由发起的SMGW计费，比如：图6.9 预付费用户发给异网用户流程图本地用户àSMSC1àSMGW2àSMGW3 à异网SMGW由SMGW2计费。与异网SMGW连接的PHS互联

26、SMGW也产生话单，以便与其他运营商进行结算核对。6.10 预付费MT短消息流程SP发送短消息给预付费用户的流程，由落地的SMGW计费， 比如：图6.10 预付费MT短消息流程图SPà SMGW3àSMGW2à SMSC1 à用户计费点为SMGW26.11 预付费异地点对点短消息互通流程预付费用户发送短消息给异省用户或者预付费用户发送短消息给同一二级SMGW下不同SMSC的用户的流程，由发起地的SMGW计费。以异省点对点短消息为例：图6.11 预付费异地点对点短消息互通流程图本地预付费用户àSMSC1àSMGW2àSMGW3

27、 àSMSC4à异地用户由SMGW2计费6.12 预付费包月短消息流程包月服务对预付费用户的普通信息不进行扣费，SMGW只统计下行量，以便对SP结算流量。比如：图6.12 预付费包月短消息流程图SPàSMGW3àSMGW2àSMSC1à用户6.13 预付费包月扣费短消息流程包月服务扣费信息由落地SMGW对预付费用户扣费。扣费结果通过状态报告进行通知，包括扣费失败、扣费成功、已扣费。网关可以配置是否向用户发送扣费通知短消息。比如：暂将计费通知的格式定为：现在SP<SPID>已扣您本月的业务< ServiceId >包月费共计xxx.xx元。图6.13 预付费包月扣费短消息流程图SPà SMGW3àSMGW2à SMSC1 à用户由SMGW2计费7话单格式当字段长度不满规定长度时，采用左对齐方式，右补空格。字段字段名长度（字节）说明短消息标识MessageID20SMSC产生的短消息标识，不足20位左对齐，右补0。短消息类型SMType1短消息类型（0=PHS用户发到SP的MO，1PHS用