《中国联通G网智能网与VAC实时扣费接口规范》由会员分享,可在线阅读,更多相关《中国联通G网智能网与VAC实时扣费接口规范(23页珍藏版)》请在金锄头文库上搜索。
1、i 中国联通公司企业标准 QB/CU xxx_xxxx G 网智能网与 VAC 实时扣费接口规范 (V 1.1) 2008-10-24 发布2008-10-24 实施 中国联通公司 发布 i 目 次 目 次.I 修改记录.I 前 言1 G 网智能网与 VAC 实时扣费接口规范(V1.1).2 1范围2 2引用标准2 3缩略语2 4VAC 实时计费系统组网.3 5基于 TCP/IP 的协议3 5.1通信方式3 5.2通信初始化4 5.3通信过程4 5.4通信结束4 5.5网络故障4 5.6接收到非法命令或应答4 5.7序列号定义5 5.8序列号重复5 6VAC 与 SCP 通信使用的实时接口协议
2、 .6 6.1批价请求6 6.1.1描述6 6.1.1.1批价请求消息参数(SM_ACC) 6 6.1.1.2批价请求响应消息参数(SM_ACC_RESP) 8 6.1.1.3错误处理8 ii 6.2结果通知9 6.2.1描述9 6.2.1.1结果通知消息参数(SM_FM).9 6.2.1.2结果通知响应消息参数(SM_FM_REP) 9 6.2.1.3错误处理.10 7通信协议10 7.1VAC 与 SCP 之间的消息10 7.2消息定义10 7.2.1数据类型11 7.2.2消息头的格式11 7.2.3消息体的格式11 7.2.3.1BIND 消息 .11 7.2.3.2BIND_RESP
3、 消息 .12 7.2.3.3UNBIND 消息 12 7.2.3.4UNBIND_RESP 消息.12 7.3命令标志数值定义12 7.4错误码定义13 附录 A SOCKET 连接.15 i 修改记录 文件编号版本号 拟制人/ 修改人 拟制/修改日期更改理由 主要更改内容 (写要点即可) 封面V1.12008-12-18版本号修改从 1.0 改为 1.1 6.1.1.12008-12-18修改小节格式 7.2.32008-12-18修改小节格式 7.2.32008-12-18笔误修改 MMSC 为 VAC 6.1.1.1 2009-6-19SPNumber 字段说明改为“和话 单一致,产品
4、接入号,该字段 不能为空。如果没有接入号, 则填 000000000000” 6.2.1.3 错 误处理 2009-6-19补充细化目录和处理机制 6.1.1 描述2009-6-19增加“当 SCP 判断当月包月费 已扣除、但 VAC 又发起包月费 扣除请求时,SCP 完成每月包 月费多次扣除的剔重。 ” 2009-7-16FeeType 取值 2 增加说明“对包 周期类型计费,仍填 2” 6.1.1.1批价请求消 息参数(SM_ACC) 注 1:每次更改归档文件时,需填写此表。 注 2:文件第一次归档时, “更改理由” 、 “主要更改内容”栏写“无” 。 1 前 言 本接口规范主要对中国联通
5、增值业务鉴权中心接口规范 VAC与SCP的实时扣费接口方面 进行了规定。 本标准由中国联通公司增值业务部提出。 本标准由中国联通公司技术部归口。 本标准负责起草单位:中讯邮电咨询设计院,中国联通公司增值业务部 本标准主要起草人: 本标准的修改和解释权属中国联通公司。 2 G 网智能网与 VAC 实时扣费接口规范(V1.1) 1范围范围 本接口规范主要对中国联通增值业务鉴权中心接口规范 VAC与SCP的实时扣费接口 方面进行了规定。 2引用标准引用标准 下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件, 其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而
6、,鼓励根据 本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件, 其最新版本适用于本标准。 中国联通预付费用户联通在信短消息实时计费实现技术规范 V1.2 短消息业务联网协议 1.2 版 短消息业务联网规范 1.2 版 SMPPV3.3 国际规范 SMPPV3.4 国际规范 3缩略语缩略语 VACValue-added service Authentication Center 增值业务鉴权中心 MOMobile Original移动用户发送短消息 MTMobile Terminal移动用户接收短消息 PPSPre-Paid Service预付费 SCPService
7、 Control Point业务控制点 SGIPShort message Gateway Interface Protocol短消息网关接口协议 SGIP+Short message Gateway Interface Protocol plus联通在信扣费协议 SMPPShort Message Peer to Peer短消息点对点协议 3 4VAC 实时计费系统组网实时计费系统组网 图 1 VAC 和预付费系统组网图 5基于基于 TCP/IP 的协议的协议 5.1 通信方式通信方式 SCP 与 VAC 之间的通信基于 SGIP+协议,但对 SGIP+协议进行了扩展,并且只支持 本规范所定
8、的一些消息。 SCP 和 VAC 之间通信采用 SOCKET 连接方式,SCP 为通信服务端,VAC 为通信客户 端,如果需要,VAC 可以同时向一个 SCP 建立多个连接。SOCKET 连接的方式具体请见 附录 A。 当客户端要发送命令时,主动向服务器端建立连接,然后向服务器端发送命令,并接 收应答;服务器端从客户端接收命令,返回应答。连接建立以后,客户端可以连续发送多 条命令。 如果服务器端检测出一条连接长时间空闲(默认 90 秒,可配置),可以主动断开该连接。 如果需要,客户端可以同时向一个服务器端建立多个连接。 客户端向服务端发送消息后等待 T 秒后未收到响应,应立即重发,再连续发送
9、N-1 次 后仍未得到响应则停发。现阶段建议取值为:T=60 秒,N=3。 (可配置) 。 4 5.2 通信初始化通信初始化 客户端有命令要向服务器端发送时,由客户端首先通过 Bind 命令向服务器端发起连接。 服务器端根据 Bind 命令之中的登录名和密码,对客户端的合法性进行验证,然后返回一条 Bind_Resp 应答给客户端。如果验证通过,则客户端和服务器端的通信开始,否则中断连 接。 客户端在向服务器端发送连接请求时,如果连续 3 次连接不成功,应报警,并在 5 分 钟后再次发出连接请求。 5.3 通信过程通信过程 客户端与服务器端之间发送的任何一条命令都带有一个序列号,序列号由命令源
10、产生。 客户端与服务器端通信开始以后,客户端可以向服务器端发送相应的命令,服务器端对收 到的命令返回应答。 5.4 通信结束通信结束 如果客户端认为和服务器端的通信已结束,则客户端应该向服务器端发送 Unbind 命令, 服务器端随后返回 Unbind_Resp 应答,然后双方断开连接。 5.5 网络故障网络故障 客户端与服务器端的通信过程中如果检测到双方连接中断(如网络断线),客户端应该 断开连接,然后尝试重新向服务器端建立新的连接;服务器端应该按照接收到 Unbind 的情 况进行处理,断开和客户端的连接。 5.6 接收到非法命令或应答接收到非法命令或应答 如果服务器端接收到的命令语法错误
11、,比如命令不完整、命令无法识别等,则断开和 客户端的连接;客户端应该向服务器端建立新连接继续发送命令。 如果客户端接收到的应答语法错误,比如命令不完整、命令无法识别等,则主动断开 和服务器端的连接;服务器端也应该断开和客户端的连接。 如果命令语法正确,但服务器端不能处理该命令,比如 SCP 收到 SM_ACC 命令,则 返回相应应答,并在应答中指定错误原因。如果应答语法正确,但客户端不处理该应答, 比如 VAC 收到 SM_ACC_RESP 应答,则丢弃.。 Comment xujh1: 待统一分配 5 5.7 序列号定义序列号定义 序列号用来唯一标示一个消息的。在补款话单中,序列号需要与对应
12、的批价请求消息 一致。 序列号分成三部分,每部分为一个 32 位整数,第一部分表示命令源节点的编号,第二 部分表示命令产生的日期和时间(网关系统中的任何命令的保存时间都不应该超过一年), 格式为十进制的 mmddhhmmss,比如 11 月 20 日 20 时 32 分 25 秒产生的命令,其第二部 分为十进制 1120203225;第三部分由 0 开始,循环进位,直到进位满了之后再清零,重新 开始计数。接收方在返回应答时,应答的序列号必须和相对应的命令的序列号相同。 图 2 命令序列号格式举例 5.8 序列号重复序列号重复 如果命令的序列号和以前接收到的命令的序列号相同,且命令内容也相同,则
13、接收方丢 弃该命令;如果序列号相同,但是命令内容并不相同,则命令接收方在应答中返回错误码。 由于联通在信、炫铃业务都是采用 SGIP+消息进行鉴权扣费,所以该序列号需要进行统 一规划,对于各个实体,需要统一分配源节点号。 源节点编号为 VAC 的节点编号,全国唯一,并且需要注意不要和本地其他增值业务平台 重复 6 6VAC 与与 SCP 通信使用的通信使用的实时接口协议实时接口协议 6.1 批价请求批价请求 6.1.1描述描述 VAC实现实时计费,必须向SCP发送有关的扣费信息,批价请求消息是基于SUBMIT消息 的扩展,它保留了实现实时计费必要的信息。 当SCP判断当月包月费已扣除、但VAC
14、又发起包月费扣除请求时,SCP完成每月包月费多 次扣除的剔重。 6.1.1.1批价请求消息参数(SM_ACC) 字段长度 (字节) 类型说明 SPNumber21Text和话单一致,产品接入号,该字段不能为空。如果没有接入号, 则填 000000000000 CorpId5Text企业代码,取值范围0-99999,该字段不能为空。(现有企业代码为 8位,只向SCP同步前5位 X1X2X3X4X5) ServiceType10Text业务代码,由SP定义,该字段不能为空。 SmgCode6Text填写发起方设备编号,填写源发起方设备编号,例如彩信中心编 号 Priority1Integer优先级
15、0-9从低到高,默认为0 Pay_msdn21Text付费号码,手机号码前加“86”国别标志,该字段不能为空。 SCP通过该号码进行鉴权扣费。 对于SP彩信,就是接受方号码。 UserNumber21Text接收该彩信的手机号,手机号码前加“86”国别标志 FeeValue6Text取值范围 0-99999,该条彩信的收费值,单位为分,由 SP 定义 对于包月制收费的用户,该值为月租费的值,该字段不能为空。 7 FeeType1Integer计费类型,该字段不能为空。 计费类型,该字段不能为空。 0:不计费,仅用于核减SP对称的信道费; 1:免费; 2:按条/次计费;对包周期类型计费,仍填 2
16、 3:按包月收取; 4:封顶计费 5:按流量计费 6:按时长计费 7:包多月计费 GivenValue6Text取值范围 0-99999,赠送用户的话费,单位为分,由 SP 定义,特 指由 SP 向用户发送广告时的赠送话费; 保留,暂时不使用。VAC 填写 0. MorelatetoMTFlag1Integer业务类型,该字段不能为空,根据实际情况填写。 0-4-保留。 5-彩信 MOAT 6-彩信 AOMT 7-彩信 MOMT 8-彩信 MOET 9-彩信 EOMT 10-彩信 DlvRpt 11-彩信 RdRpt 12-彩信 Reply VAC 填写 0 CPID8TextCP 代码,做结算用,当 CPID、SPID 字段均存在时,以 CPID 进 行结算;当 CPID 为空时,以 SPID 进行结算 ContentID30Text填写中国联通已分配了 ContentID 的内容 ID Service_Type2Text业务类型 取值见 VAC 接口规范附录 A(业务类别) CDRType 4 Text CDR 类型,如点到点、点到应用等 1:MOAT(移