中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
为5时填写SPEC_ProductID(业务部件能知晓用户定购或点播CRM的产品构成) ProductID Octet String 8 4 CRM产品ID, ServiceIDType为5时有效，其他填8个空格 操作类型： 1：开始会话 2：继续会话 3：停止会话 Other：无效 开始时间 结束时间 实际使用的流量，用于计费，开始会话时，填-1， 按流量计费产品，继续会话、停止会话时，本字段必须>=0 实际使用会话时长,用于计费, 开始会话时，填-1 按时长计费产品，继续会话、停止会话时，本字段必须>=0 上行流量 下行流量 OperationType Integer4 Begin_Time End_Time Volume Octet String 14 Octet String 14 Integer4 4 Duration Integer4 4 UpVolume DownVolume ServiceType 可选参数 LinkID Integer4 Integer4 4 4 Octet String 2 业务类型，见VAC与BSS接口规范附录A 7 TLV 20 事务关联ID，点播业务的事务关联，由AAA产生。格式如下：8位随机序列数； 为空(二进制0)表示无效 营销方式,推荐方ID 内容代码 PushId ContentID
TLV TLV 20 22 2） TrafficPriceResp流量计费应答 方向 : VAC-->业务系统/业务引擎
TrafficPriceResp流量计费应答消息中包含的参数如下:
字段名称 Result_Code 类型 Integer4 长度/最大描述 长度（字节） 4 结果： 0：成功 Xxx：与OCS、SCP通信失败 其他：OCS、SCP错误代码 如果失败则关闭此次会话 16
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
Validity-Time Integer4 4 包含所分配的业务单元的有效时间，以秒计。当采用流量计费时，客户端在本次分配配额已使用时长到达Validity-Time表示值时，向服务器端发起重新授权申请新的配额。 包含以秒计的门限。客户端在剩余配额低于门限值时将向服务器端发起重新授权申请新的配额。在重新授权过程中，客户端将允许用户继续使用业务，直到先前的配额全部用完。 包含以字节计的门限值。客户端在剩余配额低于门限值时将向服务器端发起重新授权申请新的配额。在重新授权过程中，客户端将允许用户继续使用业务，直到先前的配额全部用完。 分配的时间。单位：秒。按流量计费时填 -1。 分配的上下行总字节数。按时长计费时填 -1。 分配的上行字节数。按时长计费时填 -1。 分配的下行字节数。按时长计费时填 -1。 Time-Quota-Threshold Integer4 4 Volume-Quota-Threshold Integer4 4 CC-Time CC-Total-Octets CC-Input-Octets CC-Output-Octets 可选参数 Integer4 Integer4 Integer4 Integer4 4 4 4 4
4.2 统一配置接口 4.2.1 接口描述
IF17：统一配置接口
接口功能：用于VAC向业务系统同步相关业务及业务能力配置信息。
接口方式：FTP文件方式。VAC为文件生成方，业务系统定期到VAC指定路径，获取业务能力配置信息同步文件。
统一配置接口回执文件名格式为：请求文件名_SourceDevice_ID.tttt，其中“请求文件名”指vac与bss接口中相应请求文件命名，SourceDevice_ID表示生成回执文件方编码，定义为“2位设备类型＋3位省分代码＋1位序列号”，2位设备类型见vac与增值系统规范附录B，3位省分代码见VAC与BSS规范附录A.16。(如北京spms对sp管理信息请求文件spinfo_2009120108150110001.rreq生成的回执文件为：spinfo_2009120108150110001_240111.rrsp.)
包括增量同步接口和全量同步接口，VAC在放置数据时不区分业务系统，由业务系统获取后自行筛选自身需要数据。
（1）增量同步接口
17
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
该接口用于VAC与业务系统同步每天增量配置数据。VAC根据与PRM/CRM间的实时接口每15分钟（可配置）生成一次增量文件，由业务系统定期扫描并读取。
（2）全量同步接口
该接口用于VAC与业务系统同步全量配置数据。全量文件由省分PRM/CRM生成，VAC存放在指定目录下，由业务平台每天凌晨3：00（可配置）读取。
4.2.2 SP基本信息FTP文件同步接口
参见VAC与PRM之间接口，VAC根据业务能力传递给相关业务系统。
4.2.3 SP能力信息FTP文件同步接口
参见VAC与PRM之间接口，VAC根据业务能力传递给相关业务系统。 4.2.4 业务信息FTP文件同步接口
参见VAC与PRM之间接口，VAC根据业务能力传递给相关业务系统。 4.2.5 产品信息FTP文件同步接口
参见VAC与CRM之间接口，VAC根据业务能力传递给相关业务系统。
4.2.6 订购关系FTP文件同步接口（WAP门户）
参见VAC与SP之间定购关系同步接口。
4.2.7 CP基本信息FTP文件同步接口
接口功能：用于VAC向CMS同步相关CP基本信息。
接口方式：FTP文件方式。VAC为文件生成方，CMS定期到VAC指定路径，获取CP信息同步文件。
具体见VAC与BSS接口规范：4.4.5.2节。
4.3 查询用户定购关系接口
对应webservice接口中的方法： ? 协议： webservice ? 接口方向： 增值系统->VAC ? 接口交互流程：
18
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
用户门户/增值系统VAC用户在门户浏览定购夹查询定购关系返回门户用户定购关系列表展现定购夹
用户定购关系查询
? 消息体定义： （1）getSubscription()
输入参数
参数名 streamingNo 类型 String 出现次数 1 注释 流水号，可用于调用／提供双方比较接口调用情况 60位，从0开始，用满归零 srcDeviceType Integer 1 发端设备类型 填写发端设备的具体类型，见附录B； srcDeviceID String 1 发端设备ID 联通指定，可配置； userID userIDType String Integer 1 1 用户号码 0：MSISDN 输出参数
参数名 streamingNo 类型 String 出现次数 1 注释 将调用的StreamingNo原样返回，保证调用／返回的同步 resultCode Integer 1 参见附录D 19
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1） subInfo SubInfo 0…n 定购关系列表 SubInfo 数据类型
参数名 类型 出现次数 IDType Integer 1 0:SP_ProductID 用户查看产品时此字段填写0，查看套餐时填写1 ID status subscribeTime effectiveTime expireTime suspendTime resumeTime OA OAType DA String Integer Datetime Datetime Datetime Datetime Datetime String Integer String 1 1 1 1 1 0…1 0…1 1 1 1 IDType为0，本字段填产品ID， 0：正常 用户定购请求发起时间 定购关系生效时间 定购关系失效时间 保留字段，填空 保留字段，填空 定购方用户号码 0：MSISDN 使用方用户号码，默认与定购方相同，用户赠送时为受赠方号码 DAType FA FAType corpID Integer String Integer String 1 1 1 0...1 0：MSISDN 保留字段，填空 0：MSISDN 用户所属的集团ID，集团为集团成员定购时填写 注释 （2）getSubscriptionNew() 输入参数
参数名 streamingNo 类型 String 出现次数 1 注释 流水号，可用于调用／提供双方比较接口调用情况 60位，从0开始，用满归零 srcDeviceType Integer 1 发端设备类型 填写发端设备的具体类型，见附录B； 20