中国网通PHS短消息网关技术规范V2.0.doc

《中国网通PHS短消息网关技术规范V2.0》说明
《中国网通PHS短消息网关技术规范V2.0》说明
1.1 第一分册（与SP接口规范）
1.1.1
5.4.1 login中的ClientID字段说明改为：SMGW设置的SP接入标识。
1.1.2
5 submit和forward消息中的ValidTime, AtTime字段说明中将原格式定义形式改为：参照SMPP3.4协议。会议意见：同意。
1.1.3
5.5 forward消息中的ChargeTermId字段说明改为：“表示计费用户号码”。华为：应该加一个FEEUSERTYPE,
中兴：改动太大，不加一级网关也可以填入CHARGETERMID.
1.1.4
4.3.3 去掉“每个网元单独产生并匹配MsgID。”
1.1.5
7.3Err错误代码表后增加：
注：没有的错误类型一律用系统错误，即006。
7.4 status错误代码表增加做如下修改如下内容：
40
帐户不存在
41
余额不足
42
帐户不可用
43
非预付费用户
44-127
保留
1.2 第二分册(与计费中心接口规范)
1.2.1 话单存放问题
5.3 计费文件采集
对于预付费和后付费方式，网关都应产生话单。话单除了话单采集目录和备份目录，还应有一个对账目录，用于与其他运营商对账。
1) 接口协议：FTP。
2) 话单采集目录：SMGW上的billing/
网关先按照PHS预付费、PHS后付费、固网短消息将话单区分目录（对于没有开展固网短消息业务的情况不需此目录）；如果各地计费系统有需要，应进一步将各地的话单按区号分目录存放，如311（石家庄）、312（保定）等。网关先按照PHS预付费、PHS后付费、固网短消息将话单区分目录（对于没有开展固网短消息业务的情况不需此目录），然后分为TOTAL目录和根据各地实际情况需要按照各地的区号分别存放话单的目录。例如：保定的PHS预付费话单存放在“billing/PHS预付费/312”目录下。
3) 话单备份目录：SMGW上的backup/
采集终端采集失败时可以从此目录中获取同名的文件。目录设置同话单采集目录。
4) 话单对账目录：SMGW上的operator/
网关将网内话单和、与其他每个运营商互连的话单分别存放在不同的目录下，以用于对账。例如：CMCC、CTC等等。对账目录至少保留一个帐务周期。
5) 文件命名规则：局名＋日期＋循环序列号
例如：假设河北局命名为HBISMG，则话单如：
HBISMG.20010612.0001
序列号和日期无关，在0000 － 9999 间循环。
6) 采集方式：
由采集终端FTP到相应的话单采集目录（如：“billing/ PHS后付费/311”），拷贝后删除，如果有问题，应能从话单备份目录中获取同名的文件；话单备份目录的维护应该由厂家负责；至少保留一个帐务周期，定期自动删除，计费采集终端对话单备份目录只有读的权限。
1.2.2
4.4.3 payment_request和7.话单格式中的FwdSMGWNo字段说明改为：“下级网元代码”，SMSCNo字段说明改为：“上级网元代码”。payment_request中的FeeCode字段说明改为：“每条短消息的信息费，由SP填写，单位：分。”
1.2.3
6. 计费流程中后付费、预付费方式分别加入SMGW向预付费系统查询的流程（query_userstate）。
1.2.4
6.7和6.13说明中加入：网关可以配置是否向用户发送扣费通知短消息。
包月扣费短消息流程中的计费通知格式定为：“现在SP已扣您本月的业务< ServiceId >包月费共计xxx.xx元。”
1.2.5
7.话单格式中
MessageID的长度改为：“20”；说明改为：“SMSC产生的短消息标识，不足20位左对齐，右补0”
SMGW分配短消息标识的长度改为“20”，说明改为：“与SMGW或SP交互的短消息标识，这个标识与SMGW计费话单第一个字段“短消息标识”不同，它是由SMGW分配的，不是由SMSC分配的。用于对账。不足20位左对齐，右补0。”
计费用户号码（ChargeTermID）说明改为：“计费用户的号码”。
1.3 第三分册(CNPP)
1.3.1
将5.4 PDU头格式中的command_status的描述改为：此字段表示一个命令的成功与失败，如失败，指示引起失败的错误类型等信息，它在请求中必须设为NULL（参见第7.2节 status错误代码表）。
并添加7.2节status错误代码表如下：
0
成功
1
消息长度错误
2
命令长度错误
3
消息ID无效
4
无效的BIND状态
6
无效的优先级
7
无效的registered delivery flag
8
SMSC 系统错误
10
源地址错误
11
目的地址错误
12
无效的短消息ID
14
无效的密码
15
无效的SYSTEMID
21
非法service_type
83
无效的system_type
84
无效的replace_if_present
97
无效的定时下发时间
98
无效的有效期
255
未知错
其它
保留

1.3.2
message_id字段长度统一改为最大9个字节。
1.3.3
5.5.5 SUBMIT_MULTI命令作为可选等级。
1.3.4
5.5.4.1 SUBMIT_SM中：registered_delivery说明改为：“注册短消息标志，xxxxxx00：不需要状态报告，xxxxxx01：需要状态报告（缺省），其他：保留”。
5.5.6.1 DELIVER_SM 中：
receipted_message_id字段去掉；
register_delivery_flag说明如下：“注册短消息标志，xxxxxx00：不需要状态报告，xxxxxx01：需要状态报告（缺省），其他：保留”；
schedule_delivery_time字段长度改为：1或者17，字段说明改为：“计划下发短消息的时间。可以是绝对时间或相对时间，如果立即发送，设置为NULL。时间格式参照SMPP协议” ；（与SUBMIT_SM一致）
validity_period字段长度改为：1或者17，字段说明改为：“短消息的有效期限，可以是绝对时间或相对时间，如果使用SMSC的默认有效期限，设置为NULL。时间格式参照SMPP协议” 。（与SUBMIT_SM一致）
5.5.7.1DATA_SM中：registered_delivery字段说明改为：“注册短消息标志，xxxxxx00：不需要状态报告，xxxxxx01：需要状态报告（缺省），其他：保留”。

二、《PHS短消息网关技术规范》V2.0补充说明
2.1 第一分册中关于部分短消息字段填写的说明
2.1.1发送到PS的短消息
1. 发送到PS的短消息分类
1) 点播下发短消息。指用户发送点播请求至SP，SP根据用户的要求下发的短消息。一般为按条收费。
2) 订阅结果短消息。指用户在SP的门户网站上订阅某项业务，SP发送给用户的订阅成功与否短消息。
3) 订阅下发短消息。指用户在门户网站上订阅了某项业务，SP定期发送给用户的短消息。包括按条收费和包月的两种。
4) 订阅取消短消息。指用户发送退订短消息或者从门户网站上取消订制的某项业务后，SP发送给用户的退订成功与否的短消息。
5) 包月扣款短消息。指对于包月业务，SP会定期发送给短消息网关的包月扣款请求短消息。
6) 自写短信。指用户从SP门户网站上给小灵通用户发送的自写内容的短信。
7) 点对点短消息。指PS发送到PS的短消息。

2.有关字段填写说明
字段
短消息
SubType
FeeType
FeeUserType
FeeCode
（字段说明）
短消息子类型（0＝取消订阅，1＝订阅或点播请求，2＝点播下发，3＝订阅下发，其他保留）
资费类型
00=免费
01=按条收费
02=包月
03=封顶
04=包月扣费请求
05=CR话单
其他：保留
计费用户类型字段
0：对目的终端计费
1：对源终端计费
2：对SP计费
3：按照计费用户号码计费
其他保留
每条短消息的信息费，单位：分
点播下发
2
01
0
xx
订阅结果
3
01
2
0
取消订阅
0
01
1
0
包月扣款请求
3
04
0
xx
订阅下发（包月）
3
02
0
0
订阅下发（按条）
3
01
0
xx
自写短信
2
01
3
xx
点到点短消息
2
01
（无此字段）
0
注：对于自写短信的情况，ChargeTermID字段填注册用户ID，SrcTermID字段填SP服务代码，自写短信只能发给当地用户。
2.1.2状态报告中SMType字段的填写
状态报告的SMType按照原消息的SMType值来填写，即：0=PHS用户发到SP的MO，1＝PHS用户发到异网用户，2＝SP发到PHS用户的MT，3＝异网用户发到PHS用户，4＝同一二级SMGW下的不同SMSC之间的点对点，5=异省点到点，其他保留。
2.1.3 ChargeTermID字段
为了全国预付费短消息业务开展的需要，启用ChargeTermID字段，表示“计费用户号码”。一级SMGW和二级SMGW以ChargeTermID字段作为计费号码标识。
对于点对点短消息，ChargeTermID由发端二级SMGW填写，填主叫号码，一级SMGW透传该字段。收端SMGW不做判断，将该字段内容填入话单，发端SMGW根据原短消息的ChargeTermID字段计费。
对于MT过程，与SP连接的SMGW根据SP发送到SMGW的submit消息中的FeeUserType和ChargeTermID字段来判断计费用户号码，并填写ChargeTermID字段。
2.2 关于第二分册话单中部分字段的说明
字段
字段名
长度（字节）
说明
短消息标识
MessageID
20
SMSC产生的短消息标识，不足20位左对齐，右补0
前转SMGW代码
FwdSMGWNo
6
下级网元代码
短消息中心代码
SMSCNo
6
上级网元代码
SMGW分配短消息标识

MsgID
20
与SMGW或SP交互的短消息标识，这个标识与SMGW计费话单第一个字段“短消息标识”不同，它是由SMGW分配的，不是由SMSC分配的。用于对账。不足20位左对齐，右补0。
说明：短消息标识填SMSC产生的短消息标识（在submit_sm_resp中携带），如果与之交互的SMSC没有产生MessgeID，此字段填NULL；SMGW分配短消息标识填与SMGW或SP交互的短消息标识，如果没有与之交互的SMGW或SP，则填NULL。
对于经过多个SMGW的情况，这些SMGW统一采用第一个SMGW产生的MsgID，其它网关透传。与SP或其它SMGW对账时，统一使用MsgID字段。
以上是网内的情况，与异网互联的情况比较特殊，互联网关要进行网内短消息标识到互通短消息标识的转换，互联网关的话单的短消息标识字段填互通短消息标识，用于网间对账；SMGW分配短消息标识字段仍填本网内短消息标识，用于网内对账。
前转SMGW代码和短消息中心代码分别填下级网元和上级网元代码，此处的“上级”和“下级”是指流程上的上下级，而不是网络等级结构上的上下级。
举例：
1)

其中对于SMGW1产生的话单，MessageID填NULL，MsgID填ID2；SMGW2产生的话单，MessageID填NULL，MsgID填ID2。
2)网内点对点短消息：
对于SMGW1产生的话单，MessageID填NULL，MsgID填ID2；SMGW2产生的话单，MessageID填NULL，MsgID填ID2；对于SMGW3产生的话单，MessageID填ID3，MsgID填ID2。
3)

对于SMGW1产生的话单，MessageID填ID2，MsgID填NULL。
4)异网点对点短消息：
对于SMGW1产生的话单，MessageID填NULL，MsgID填ID2；SMGW2（互联）产生的话单，MessageID填ID3，MsgID填ID2。
2.3第二分册中关于payment_request消息的说明
对于异地或异网点对点消息，网关向预付费平台发送payment_request消息时不需要填写FeeCode字段，最终的费率由预付费平台决定。
2.4第二分册中关于query_userstate _resp消息的说明
对于预付费平台可以区分账户不存在和后付费用户的情况，账户不存在返回1，非预付费用户返回4；对于不能区分账户不存在和后付费用户的情况，统一返回4，启动后付费流程。
2.5 对于没有明确定义的字段填写说明
对于在某个流程中规范没有明确定义取值的字段，Integer类型的字段填0，Octet string类型的填NULL。例如：状态报告消息中除了MsgContent和SMType等字段按照定义来填写，对于其它没有明确定义取值的字段，Integer类型的字段填0，Octet string类型的填NULL 。
2.6 关于失败日志的说明
要求网关对于发送失败的消息不但要回送失败的回执，还要记录下失败的日志，日志中应包括以下内容：短消息类型、短消息子类型、计费用户号码、SP号码、目的地号码、业务代码、用户计费类别、信息费、短消息发送优先级、信息长度、计费号码归属地的区号、SMGW代码、前转SMGW代码、短消息中心代码、提交时间、处理结束时间、SMGW分配短消息标识、失败原因等；失败日志应保存至少一个帐务周期。各字段的填写参考话单格式，失败原因字段填写见下表：
代码
含义
0
成功
1
系统忙
2
超过最大连接数
3-9
保留
10
消息结构错
11
命令字错
12
序列号重复
13-19
保留
20
IP地址错
21
认证错
22
版本太高
23
非法FeeUserType
24
非法SubType
25
NodesCount 超过阈值
26
非法MsgID
27-29
保留
30
非法消息类型（SMType）
31
非法优先级（Priority）
32
非法资费类型（FeeType）
33
非法资费代码（FeeCode）
34
非法短消息格式（MsgFormat）
35
非法时间格式
36
非法短消息长度（MsgLength）
37
有效期已过
38
非法查询类别（QueryType）
39
路由错误
40
帐户不存在
41
余额不足
42
帐户不可用
43
非预付费用户
44
发送超时
45
发送失败
46
对方回复失败
47
收到失败回执
48-127
保留
128-255
厂家自定义

13
第 页