中国联通公司企业标准 QB/CUxxx—2008 中国联通增值业务鉴权中心
接口规范
VAC与增值业务系统接口分册
（V1.1）
China Unicom （Version 1.0）
2008-0X-XX发布 2008-0X-XX实施 中国联通公司发布 中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
目 次
修改记录 ............................................................................ III 前 言 ............................................................................. IX 1 范围 ............................................................................... 10 2 规范性引用文件 ..................................................................... 10 3 缩略语和术语 ....................................................................... 10 3.1 缩略语 ............................................................................ 10 3.2 术语 ............................................................................... 2 4 VAC和增值业务系统间的接口 ........................................................... 2 4.1 实时鉴权计费接口 ................................................................... 2 4.1.1 接口描述 ......................................................................... 2 4.1.2 Command ID （命令字）定义 ........................................................ 3 4.1.3 基本数据类型 ..................................................................... 4 4.1.4 PDU 概述 ......................................................................... 4 4.1.4.1 连接消息 ........................................................................ 5 4.1.4.2 去连接消息 ...................................................................... 6 4.1.4.3 链路握手消息 .................................................................... 6 4.1.4.4 鉴权批价 ........................................................................ 7 4.1.4.5 鉴权批价确认 ................................................................... 13 4.1.4.6 流量计费消息 ................................................................... 14 4.2 统一配置接口 ...................................................................... 17 4.2.1 接口描述 ........................................................................ 17 4.2.2 SP基本信息FTP文件同步接口 ...................................................... 18 4.2.3 SP能力信息FTP文件同步接口 ...................................................... 18 4.2.4 业务信息FTP文件同步接口 ........................................................ 18 4.2.5 业务能力信息FTP文件同步接口 .................................... 错误！未定义书签。 4.2.6 产品信息FTP文件同步接口 ........................................................ 18 4.2.7 订购关系FTP文件同步接口（WAP门户） ........................................... 18 4.2.8 CP基本信息FTP文件同步接口 ..................................................... 18 4.3 查询用户定购关系接口 .............................................................. 18 4.4 查询用户信息接口 .................................................................. 22 4.4.1 接口描述 ........................................................................ 22 4.4.2 发起方系统 ...................................................................... 22 4.4.3 接受方系统 ...................................................................... 22 4.4.4 接口协议 ........................................................................ 22 4.4.5 接口内容 ........................................................................ 22 4.4.5.1 用户信息查询请求（UserIdRequest） ............................................... 22
I
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
4.4.5.2 用户信息查询响应（UserInfoResponse） ............................................ 23 4.4.5.3 用户信息结构 ................................................................... 23 4.5 用户信息同步接口 .................................................................. 24 4.5.1 接口方式 ........................................................................ 24 4.5.2 文件目录 ........................................................................ 24 4.5.3 文件格式 ........................................................................ 24 4.6 用户号段同步接口 .................................................................. 24 4.6.1 接口描述 ........................................................................ 24 4.6.2 接口协议 ........................................................................ 24 4.6.3 接口内容 ........................................................................ 25 4.7 测试用户同步接口 .................................................................. 25 4.7.1 接口描述 ........................................................................ 25 4.7.2 接口协议 ........................................................................ 25 4.7.3 接口内容 ........................................................................ 25 附 录 A （规范性附录） 可选参数标识定义 ............................................ 27 附 录 B （规范性附录） 数据类型定义 ................................................ 28 附 录 C （规范性附录） 鉴权批价接口返回错误结果码定义 .............................. 31 附 录 D （规范性附录） 门户结果码定义 .............................................. 33 附 录 E （规范性附录） wsdl ........................................................ 35
II
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
修改记录
拟文件编号 版本号 制人/ 修改人 V1.0 2008-11-4 2008-11-18 2008-11-20 2008-11-23 如果可信任门户能知晓用户使用的是具体的产品构成，增加SPID+SPEC_Productid模式 新增fee TLV，应对过渡阶段部分业务系统自己批价，如炫铃 设备类型SPMS填SMS Portal Operation Type 增加了 “6、定购关系鉴权(用于检查用户是否订购了此业务)”便于SPMS定购和WAP访问确认URL做定购关系鉴权 封面 4.4 2008-12-18 2009-1-15 2009-1-15 2009-1-20 2009-2-13 2009-2-13 2009-2-13 2009-2-14 修改ServiceType字段备注 修改小节格式 4.1节 4.1.4.4 附录E V1.1 2008-12-03 2008-12-3 2008-12-5 2008-12-14 2008-12-15 2008-12-18 增加定购渠道和计费类型 增加” 鉴权批价接口返回错误结果码定义” 流量计费增加了linkId 增加了wap门户查询用户所有定购关系接口 增加用户信息查询接口 版本号修改 4.1.4.4节 附录C 4.1.4.6 4.3节 4.4节 从1.0改为1.1 附录B 4.1.4.4节 4.1.4.4节注释 4.1.4.4节修订部分 拟制/修改日期 更改理由 主要更改内容 （写要点即可） Service_updown_Type字段，增加P TO E类型 更新成12-24日期的wsdl 增加ContentID 增加响应中CC-Time等4字段取值描述 增加用户服务类型 增加3G业务设备类型 增加发端设备类型 4.1.4.6 流量计费消息 4.4.5.3 附录B 4.4.5.1 用户信息查询请求（UserIdRequest） 2009-2-14 LinkID生成规则调整，适应现网在信业务 4.1.4.4 鉴权批价 4.1.4.6 流量计费消息 2009-2-14 2009-06-19 WSDL文件更新 中国联通增值业务鉴权中心接口规范-VAC与增值系统&全国VAC接口分册”改为“中国联通增值业务鉴权中心附录E 名称修改 III
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
接口规范-VAC与增值系统接口分册 2009-06-19 名称由“WAP门户查询用户所有定购关系接口”修改为“查询用户定购关系接口”； 接口方向：“Portal->VAC”改为“增值系统->VAC”； 删除触发条件、约束； 输入参数中，srcDeviceType字段注释“02：WAP PORTAL ；”改为“填写发端设备的具体类型，见附录B”；srcDeviceID字段注释“02：WAP PORTAL ；”改为“联通指定，可配置” 各字段长度以WSDL文件为准 expireTime字段备注，删除“，自动续订的不填”，改为必填 2009-06-19 名称由“WAP门户查询用户信息接口”修改为“查询用户信息接口； 发起方系统“门户”改为“增值系统”； 用户信息查询请求（UserIdRequest）中srcDeviceType字段描述“02：WAP PORTAL ；”改为“填写发端设备的具体类型，见附录B”；srcDeviceID字段 “02：WAP PORTAL ；”改为“联通指定，可配置” 2009-06-19 ResentTimes字段，增加“默认取值0” fee字段，增加“增值系统不批价的不带fee字段，同时VAC侧支持按照业务类型进行配置是否批价处理。对代收费业务fee、FeeType必须正确填写。（FeeType只能4.1.4.4 鉴权批价 4.4 WAP门户查询用户信息接口 4.3 WAP门户查询用户所有定购关系接口 填2、3）。”，删除“部分业务系统在过渡阶段可自己批价,如炫铃等,” ServiceIDType字段，删除5取值 SP_ID/AccessNo字段，名称改为“SP_ID”，描述改为“填写企业代码” ServiceID/FeatureString字段，删除2,5取值描述 Operation Type，描述中删除“ServiceIDType=3或4时，产品类型必须为点播类。生成LinkID，上行计费的产品同时进行计费。同一LinkID只计费一次。”，是否删除“ServiceIDType=1时，” 2009-06-19 删除本章，相关内容放在总部VAC接口规范分册中 5 VAC和全网VAC系统间的接口 2009-06-19 设备类型（SourceDevice_Type）增加：47：中央音乐平台 48：手机邮箱 增加“对用户数据，除接口中已经明确填写格式的，VAC作为接受方，支持用户号码前加或不加86；其他接收方在接受VAC数据时，也应适应用户号码前加或不加86。” 2009-06-19 （2）OrderMethod字段增加“，在定购时业务系统必须填写” IV
4.1.4.4 鉴权批价 附录B