中国联通增值业务鉴权中心接口规范VAC与SCPPDSCP接口分册1212.docx

中国联通增值业务鉴权中心接口规范VAC与SCPPDSCP接口分册1212.docx

《中国联通增值业务鉴权中心接口规范VAC与SCPPDSCP接口分册1212.docx》由会员分享，可在线阅读，更多相关《中国联通增值业务鉴权中心接口规范VAC与SCPPDSCP接口分册1212.docx（30页珍藏版）》请在冰豆网上搜索。

中国联通增值业务鉴权中心接口规范VAC与SCPPDSCP接口分册1212

中国联通公司发布

2008-10-24实施

2008-10-24发布

G网智能网与VAC实时扣费接口规范

（V1.1）

QB/CUxxx_xxxx

中国联通公司企业标准

目次

目次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通信使用的实时接口协议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

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消息12

7.2.3.3UNBIND消息12

7.2.3.4UNBIND_RESP消息12

7.3命令标志数值定义12

7.4错误码定义13

附录ASOCKET连接15

修改记录

文件编号

版本号

拟制人/

修改人

拟制/修改日期

更改理由

主要更改内容

（写要点即可）

封面

V1.1

2008-12-18

版本号修改

从1.0改为1.1

6.1.1.1

2008-12-18

修改小节格式

7.2.3

2008-12-18

修改小节格式

7.2.3

2008-12-18

笔误

修改MMSC为VAC

6.1.1.1

2009-6-19

SPNumber字段说明改为“和话单一致，产品接入号，该字段不能为空。

如果没有接入号，则填000000000000”

6.2.1.3错误处理

2009-6-19

补充细化目录和处理机制

6.1.1描述

2009-6-19

增加“当SCP判断当月包月费已扣除、但VAC又发起包月费扣除请求时，SCP完成每月包月费多次扣除的剔重。

”

2009-7-16

FeeType取值2增加说明“对包周期类型计费，仍填2”

6.1.1.1批价请求消息参数（SM_ACC）

注1：

每次更改归档文件时，需填写此表。

注2：

文件第一次归档时，“更改理由”、“主要更改内容”栏写“无”。

前言

本接口规范主要对中国联通增值业务鉴权中心接口规范VAC与SCP的实时扣费接口方面进行了规定。

本标准由中国联通公司增值业务部提出。

本标准由中国联通公司技术部归口。

本标准负责起草单位：

中讯邮电咨询设计院，中国联通公司增值业务部

本标准主要起草人：

本标准的修改和解释权属中国联通公司。

G网智能网与VAC实时扣费接口规范（V1.1）

范围

本接口规范主要对中国联通增值业务鉴权中心接口规范VAC与SCP的实时扣费接口方面进行了规定。

引用标准

下列文件中的条款通过本标准的引用而成为本标准的条款。

凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。

凡是不注日期的引用文件，其最新版本适用于本标准。

《中国联通预付费用户联通在信短消息实时计费实现技术规范V1.2》

《短消息业务联网协议1.2版》

《短消息业务联网规范1.2版》

SMPPV3.3国际规范

SMPPV3.4国际规范

缩略语

VAC

Value-addedserviceAuthenticationCenter

增值业务鉴权中心

MO

MobileOriginal

移动用户发送短消息

MT

MobileTerminal

移动用户接收短消息

PPS

Pre-PaidService

预付费

SCP

ServiceControlPoint

业务控制点

SGIP

ShortmessageGatewayInterfaceProtocol

短消息网关接口协议

SGIP+

ShortmessageGatewayInterfaceProtocolplus

联通在信扣费协议

SMPP

ShortMessagePeertoPeer

短消息点对点协议

VAC实时计费系统组网

图1VAC和预付费系统组网图

基于TCP/IP的协议

通信方式

SCP与VAC之间的通信基于SGIP+协议，但对SGIP+协议进行了扩展，并且只支持本规范所定的一些消息。

SCP和VAC之间通信采用SOCKET连接方式，SCP为通信服务端，VAC为通信客户端，如果需要，VAC可以同时向一个SCP建立多个连接。

SOCKET连接的方式具体请见附录A。

当客户端要发送命令时，主动向服务器端建立连接，然后向服务器端发送命令，并接收应答；服务器端从客户端接收命令，返回应答。

连接建立以后，客户端可以连续发送多条命令。

如果服务器端检测出一条连接长时间空闲（默认90秒，可配置），可以主动断开该连接。

如果需要，客户端可以同时向一个服务器端建立多个连接。

客户端向服务端发送消息后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。

现阶段建议取值为：

T=60秒，N=3。

（可配置）。

通信初始化

客户端有命令要向服务器端发送时，由客户端首先通过Bind命令向服务器端发起连接。

服务器端根据Bind命令之中的登录名和密码，对客户端的合法性进行验证，然后返回一条Bind_Resp应答给客户端。

如果验证通过，则客户端和服务器端的通信开始，否则中断连接。

客户端在向服务器端发送连接请求时，如果连续3次连接不成功，应报警，并在5分钟后再次发出连接请求。

通信过程

客户端与服务器端之间发送的任何一条命令都带有一个序列号，序列号由命令源产生。

客户端与服务器端通信开始以后，客户端可以向服务器端发送相应的命令，服务器端对收到的命令返回应答。

通信结束

如果客户端认为和服务器端的通信已结束，则客户端应该向服务器端发送Unbind命令，服务器端随后返回Unbind_Resp应答，然后双方断开连接。

网络故障

客户端与服务器端的通信过程中如果检测到双方连接中断（如网络断线），客户端应该断开连接，然后尝试重新向服务器端建立新的连接；服务器端应该按照接收到Unbind的情况进行处理，断开和客户端的连接。

接收到非法命令或应答

如果服务器端接收到的命令语法错误，比如命令不完整、命令无法识别等，则断开和客户端的连接；客户端应该向服务器端建立新连接继续发送命令。

如果客户端接收到的应答语法错误，比如命令不完整、命令无法识别等，则主动断开和服务器端的连接；服务器端也应该断开和客户端的连接。

如果命令语法正确，但服务器端不能处理该命令，比如SCP收到SM_ACC命令，则返回相应应答，并在应答中指定错误原因。

如果应答语法正确，但客户端不处理该应答，比如VAC收到SM_ACC_RESP应答，则丢弃.。

序列号定义

序列号用来唯一标示一个消息的。

在补款话单中，序列号需要与对应的批价请求消息一致。

序列号分成三部分，每部分为一个32位整数，第一部分表示命令源节点的编号，第二部分表示命令产生的日期和时间（网关系统中的任何命令的保存时间都不应该超过一年），格式为十进制的mmddhhmmss，比如11月20日20时32分25秒产生的命令，其第二部分为十进制1120203225；第三部分由0开始，循环进位，直到进位满了之后再清零，重新开始计数。

接收方在返回应答时，应答的序列号必须和相对应的命令的序列号相同。

图2命令序列号格式举例

序列号重复

如果命令的序列号和以前接收到的命令的序列号相同，且命令内容也相同，则接收方丢弃该命令；如果序列号相同，但是命令内容并不相同，则命令接收方在应答中返回错误码。

由于联通在信、炫铃业务都是采用SGIP+消息进行鉴权扣费，所以该序列号需要进行统一规划，对于各个实体，需要统一分配源节点号。

源节点编号为VAC的节点编号，全国唯一，并且需要注意不要和本地其他增值业务平台重复

VAC与SCP通信使用的实时接口协议

批价请求

描述

VAC实现实时计费，必须向SCP发送有关的扣费信息，批价请求消息是基于SUBMIT消息的扩展，它保留了实现实时计费必要的信息。

当SCP判断当月包月费已扣除、但VAC又发起包月费扣除请求时，SCP完成每月包月费多次扣除的剔重。

批价请求消息参数（SM_ACC）

字段

长度

（字节）

类型

说明

SPNumber

21

Text

和话单一致，产品接入号，该字段不能为空。

如果没有接入号，则填000000000000

CorpId

5

Text

企业代码，取值范围0-99999，该字段不能为空。

（现有企业代码为8位，只向SCP同步前5位X1X2X3X4X5）

ServiceType

10

Text

业务代码，由SP定义，该字段不能为空。

SmgCode

6

Text

填写发起方设备编号，填写源发起方设备编号，例如彩信中心编号

Priority

1

Integer

优先级0-9从低到高，默认为0

Pay_msdn

21

Text

付费号码，手机号码前加“86”国别标志，该字段不能为空。

SCP通过该号码进行鉴权扣费。

对于SP彩信，就是接受方号码。

UserNumber

21

Text

接收该彩信的手机号，手机号码前加“86”国别标志

FeeValue

6

Text

取值范围0-99999，该条彩信的收费值，单位为分，由SP定义

对于包月制收费的用户，该值为月租费的值，该字段不能为空。

FeeType

1

Integer

计费类型，该字段不能为空。

计费类型，该字段不能为空。

0：

不计费，仅用于核减SP对称的信道费；

1：

免费；

2：

按条/次计费；对包周期类型计费，仍填2

3：

按包月收取；

4：

封顶计费

5：

按流量计费

6：

按时长计费

7：

包多月计费

GivenValue

6

Text

取值范围0-99999，赠送用户的话费，单位为分，由SP定义，特指由SP向用户发送广告时的赠送话费；

保留，暂时不使用。

VAC填写0.

MorelatetoMTFlag

1

Integer

业务类型，该字段不能为空，根据实际情况填写。

0-4-保留。

5-彩信MOAT

6-彩信AOMT

7-彩信MOMT

8-彩信MOET

9-彩信EOMT

10-彩信DlvRpt

11-彩信RdRpt

12-彩信Reply

VAC填写0

CPID

8

Text

CP代码，做结算用，当CPID、SPID字段均存在时，以CPID进行结算；当CPID为空时，以SPID进行结算

ContentID

30

Text

填写中国联通已分配了ContentID的内容ID

Service_Type

2

Text

业务类型取值见VAC接口规范附录A（业务类别）

CDRType

4

Text

CDR类型，如点到点、点到应用等

1：

MOAT（移动用户始发、应用终止）

2：

AOMT（应用始发、移动用户终止）

3：

MOMT（移动用户始发、移动用户终止）

4：

MOET（移动用户始发、Email终止）

5：

EOMT（Email始发、移动用户终止）

9：

Other（其他）

ProductID

8

Text

CRM侧产品ID

SPC_ProductID

12

Text

CRM侧构成产品代码

SP_ProductID

12

Text

PRM侧SP产品代码

OrderMethod

4

Text

订购渠道，取值见附录A

PushId

20

Text

推荐人（发展人）ID

OAMDN

21

Text

发起方手机号码,无手机号填空，手机号码前加“86”国别标志

TimeSec

6

Text

时长（秒）

InputOctets

10

Text

上行流量（Byte）

OutputOctets

10

Text

下行流量（Byte）

Reserve1

32

Text

保留，扩展用

Reserve2

32

Text

保留，扩展用

方向：

VAC－>SCP

批价请求响应消息参数（SM_ACC_RESP）

字段

长度（字节）

类型

说明

Operate_Result

1

Integer

SM_ACC命令是否成功。

0：

执行成功

其它：

错误码

Reserve

8

Text

保留，扩展用

方向：

VAC<－SCP

错误处理

应用层的错误在批价请求响应结果中定义。

结果通知

描述

由于预付费计费方式采用先计费后发送的方式，对于用户不能成功发送或接受的业务，需要对用户进行补款，补款的方式就是VAC向SCP发送结果通知消息。

结果通知消息参数（SM_FM）

字段

长度（字节）

类型

说明

OrgSmgMsgSeq

12

Integer

本消息报告对应的原始消息的SGIP序列号（原始消息

的消息头定义）

Pay_msdn

21

Text

付费号码，手机号码前加“86”国别标志，该字段不能为空。

SCP通过该号码进行鉴权扣费。

对于SP彩信，就是接受方号码。

Result

1

Integer

状态信息，标志发送成功还是失败；0：

失败；1：

成功

Reserve

8

Text

保留，扩展用

方向：

VAC－－>SCP

结果通知响应消息参数（SM_FM_REP）

字段

长度（字节）

类型

说明

Operate_Result

1

Integer

SM_FM命令是否成功。

0：

执行成功

其它：

错误码

Reserve

8

Text

保留，扩展用

错误处理

应用层的错误在结果通知响应结果中定义。

SCP/PDSCP用户正常使用时，VAC产生话单（当VAC与SCP/PDSCP断链，仍允许用户使用时，仍产生本话单）格式见VAC与BSS接口规范6.1.6.3.2节，存放目录如下：

<根目录>//////

当VAC与SCP/PDSCP断链，仍允许用户使用时，VAC产生的用于给运营商补款的话单格式见VAC与BSS接口规范6.1.6.3.2节，存放目录如下：

<根目录>//////

当计费成功，但向用户服务失败、同时VAC与SCP/PDSCP断链时，VAC给用户补款话单格式见附录B，存放目录如下：

<根目录>//////

通信协议

VAC与SCP之间的消息

VAC与SCP之间的通信目前主要支持以下消息：

消息

说明

BIND

服务器端接受客户端的登陆

BIND_RESP

服务器端给客户端登陆信息的反馈

UNBIND

客户端向服务器端发起关闭连接

UNBIND_RESP

服务器端对关闭连接请求的响应

SM_ACC

批价请求消息，VAC－>SCP

SM_ACC_RESP

批价请求响应消息，SCP－>VAC

SM_FM

VAC向SCP提出结果通知消息

SM_FM_REP

SCP对结果通知消息的响应

消息定义

定义的消息由消息头和消息体组成。

数据类型

类型

说明

Integer

无符号整数

Text

定长字符串，左对齐存储，空余位置补’\0’

消息中的所有Integer类型的字段均采用网络字节顺序。

所有消息中的序列号字段均占12个字节，分为3个4字节整数；通信传输时每个整数都使用网络字节顺序，但整数的次序并不改变。

也就是说，通信传输的时候，序列号字段应该按照三个连续的4字节整数来处理

消息头的格式

字段

长度（字节）

类型

说明

MessageLength

4

Integer

消息的总长度（字节）

CommandID

4

Integer

命令ID

SequenceNumber

12

Integer

序列号

消息体的格式

BIND消息

字段

长度（字节）

类型

说明

LoginType

1

Integer

登录类型。

1：

VAC向SCP建立的连接，用于发送命令

2：

SCP向VAC建立的连接，用于发送命令

其它：

保留

LoginName

16

Text

服务器端给客户端分配的登录名

LoginPassoword

16

Text

服务器端和LoginName对应的密码

Reserve

8

Text

保留，扩展用

BIND_RESP消息

字段

长度（字节）

类型

说明

Result

1

Integer

Bind执行命令是否成功。

0：

执行成功

其它：

错误码

Reserve

8

Text

保留，扩展用

UNBIND消息

通信连接建立以后，客户端如果要停止通信，需要发送Unbind命令；服务器端收到Unbind命令后，向客户端发送Unbind_Resp相应，然后双方断开连接。

UNBIND_RESP消息

UNBIND_RESP消息没有消息体

命令标志数值定义

命令宏定义

数值

说明

BIND

0X1

服务器端接受客户端的登陆

BIND_RESP

0X80000001

服务器端给客户端登陆信息的反馈

UNBIND

0X2

客户端向服务器端发起关闭连接

UNBIND_RESP

0X80000002

服务器端对关闭连接请求的响应

SM_ACC

0X2000

批价请求消息，VAC－>SCP

SM_ACC_RESP

0X80002000

批价请求响应消息，SCP－>VAC

SM_FM

0X4000

VAC向SCP提出结果通知消息，由SCP与VAC使用。

SM_FM_REP

0X80004000

SCP对结果通知消息的响应，由SCP与VAC协商使用。

错误码定义

错误码

描述

0

无错误，命令正确接收

1

非法登录，如登录名、口令出错、登录名与口令不符等。

2

重复登录，如在同一TCP/IP连接中连续两次以上请求登录。

3

连接过多，指单个节点要求同时建立的连接数过多。

4

登录类型错，指bind命令中的logintype字段出错。

5

参数格式错，指命令中参数值与参数类型不符或与协议规定的范围不符。

6

非法手机号码，协议中所有手机号码字段出现非86130号码或手机号码前未加“86”时都应报错。

7

消息ID错

8

信息长度错

9

非法序列号，包括序列号重复、序列号格式错误等

10

扩展

11

扩展

21

用户号码已挂失

22

用户号码已处于保留期

23

用户号码处于冷冻期

24

扩展

25

扩展

26

扩展

27

扩展

28

扩展

29

计费用户不存在（当用户不存在时，网关要删除用户信息表中相应的号码）

30

计费用户不提供此功能

31

非法设备

32

系统失败

33

扩展

34

计费用户是和约用户

35

计费用户余额不足

36

计费用户不支持增值业务

其它

其它错误码（待定义）

附录ASOCKET连接

通信双方以客户-服务器方式建立TCP连接，用于双方信息的相互提交。

VAC为客户端，SCP为服务端；

当客户端要发送命令时，主动向服务器端建立连接，然后向服务器端发送命令，并接收应答；服务器端从客户端接收命令，返回应答。

连接建立以后，客户端可以连续发送多条命令。

命令发送完并接收到所有应答后，客户端应该主动断开连接。

如果服务器端检测出一条连接长时间空闲（默认90秒，可配置），可以主动断开该连接。

如果需要，客户端可以同时向一个服务器端建立多个连接。

VAC向SCP发送消息后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。

现阶段建议取值为：

T=60秒，N=3。

（可配置）

附录B用户补款话单格式

1、话单文件命名

文件类型（2位）+文件标志（1位）+帐务周期月份（2位）+文件产生的时间（精确到年月日时分）+SSID（3位）+序列号（4位）＋.后缀。

（1）文件类型

取值：

20

（2）后缀

<根目录>//////下为req；

<根目录>//////下为res；

（3）序列号

以帐期为循环单位，每帐期从0001开始，同一帐期内连续进行累加。

（4）文件标志

取值：

N－表示正常文件；T－表示测试文件。

2、原始话单文件头

序号

名称

长度

备注

1

文件序列号（流水号）

CHAR（4）

以帐期为单位，从0001开始，排满9999后重新循环

2

文件版本号

CHAR

（2）

取值：

02

3

文件产生时间

CHAR（14）

Yyyymmddhhmmss

4

文件生成方系统代码

CHAR（8）

902

5

文件接收方系统代码

CHAR（3）

104

6

记录开始日期时间

CHAR（14）

Yyyymmddhhmmss

7

记录结束日期时间

CHAR（14）

Yyyymmddhhmmss

8

总记录数

CHAR（10）

右对齐，左补0

9

备注

CHAR（40）

10

换行

CHAR

（1）

3、回执文件头

序号

名称

长度

备注

1

文件序列号

CHAR（4）

从0001开始排序，排满9999后重

新循环

2

文件版本号

CHAR

（2）

取值：

02

3

文件产生时间

CHAR（14）

Yyyymmddhhmmss

4

文件生成方系统代码

CHAR（3）

902

5

文件接收方系统代码

CHAR（8）