中国网通PHS短消息网关技术规范V20_免费下载.doc

中国网通PHS短消息网关技术规范V2.0说明中国网通PHS短消息网关技术规范V2.0说明1.1 第一分册（与SP接口规范）1.1.1 5.4.1 login中的ClientID字段说明改为：SMGW设置的SP接入标识。1.1.25 submit和forward消息中的ValidTime, AtTime字段说明中将原格式定义形式改为：参照SMPP3.4协议。会议意见：同意。 forward消息中的ChargeTermId字段说明改为：“表示计费用户号码”。华为：应该加一个FEEUSERTYPE,中兴：改动太大，不加一级网关也可以填入CHARGETERMID.1.1.4 4.3.3 去掉“每个网元单独产生并匹配MsgID。”Err错误代码表后增加：注：没有的错误类型一律用系统错误，即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”），拷贝后删除，如果有问题，应能从话单备份目录中获取同名的文件；话单备份目录的维护应该由厂家负责；至少保留一个帐务周期，定期自动删除，计费采集终端对话单备份目录只有读的权限。.3 payment_request和7.话单格式中的FwdSMGWNo字段说明改为：“下级网元代码”，SMSCNo字段说明改为：“上级网元代码”。payment_request中的FeeCode字段说明改为：“每条短消息的信息费，由SP填写，单位：分。”1.2.36. 计费流程中后付费、预付费方式分别加入SMGW向预付费系统查询的流程（query_userstate）。和6.13说明中加入：网关可以配置是否向用户发送扣费通知短消息。包月扣费短消息流程中的计费通知格式定为：“现在SP已扣您本月的业务包月费共计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 flag8SMSC 系统错误10源地址错误11目的地址错误12无效的短消息ID14无效的密码15无效的SYSTEMID21非法service_type83无效的system_type84无效的replace_if_present97无效的定时下发时间98无效的有效期255未知错其它保留1.3.2message_id字段长度统一改为最大9个字节。1.3.3 5.5.5 SUBMIT_MULTI命令作为可选等级。.4.1 SUBMIT_SM中：registered_delivery说明改为：“注册短消息标志，xxxxxx00：不需要状态报告，xxxxxx01：需要状态报告（缺省），其他：保留”。 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一致）DATA_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.有关字段填写说明字段短消息SubTypeFeeTypeFeeUserTypeFeeCode（字段说明）短消息子类型（0取消订阅，1订阅或点播请求，2点播下发，3订阅下发，其他保留）资费类型00=免费01=按条收费02=包月03=封顶04=包月扣费请求05=CR话单 其他：保留计费用户类型字段0：对目的终端计费1：对源终端计费2：对SP计费3：按照计费用户号码计费其他保留每条短消息的信息费，单位：分点播下发2010xx订阅结果30120取消订阅00110包月扣款请求3040xx订阅下发（包月）30200订阅下发（按条）3010xx自写短信2013xx点到点短消息201（无此字段）0注：对于自写短信的情况，ChargeTermID字段填注册用户ID，SrcTermID字段填SP服务代码，自写短信只能发给当地用户。2.1.2状态报告中SMType字段的填写状态报告的SMType按照原消息的SMType值来填写，即：0=PHS用户发到SP的MO，1PHS用户发到异网用户，2SP发到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 关于第二分册话单中部分字段的说明字段字段名长度（字节）说明短消息标识MessageID20SMSC产生的短消息标识，不足20位左对齐，右补0前转SMGW代码FwdSMGWNo6下级网元代码短消息中心代码SMSCNo6上级网元代码SMGW分配短消息标识MsgID20与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保留20IP地址错21认证错22版本太高23非