2009年中国联通增值业务鉴权中心接口规范-VAC与SP接口规范

6中 国 联 通 公 司 企 业 标 准QB/CU 中国联通VAC平台接口技术要求：VAC与SP接口规范（暂定名）（V1.1）-发布 -实施中国联通公司发布中国联通VAC平台接口技术要求：VAC与SP接口规范（V1.1）目 次修改记录.II前 言.III1范围.42规范性引用文件.43定义与缩略语.43.1定义.43.2缩略语.43.3信息更新时机定义.54VAC和SP间的接口.54.1定购通知接口.54.1.1接口描述.54.1.2发起方系统.54.1.3接受方系统.54.1.4接口协议.54.1.5接口内容.54.2定购关系同步接口.74.2.1接口描述.74.2.2发起方系统.74.2.3接受方系统.74.2.4接口协议.74.2.5接口内容.74.2.6过渡阶段定制关系变更通知SP通用流程.8I修改记录文件编号 版本号 拟制人/修改人拟制/修改日期更改理由 主要更改内容（写要点即可）封面 V1.1 2008-12-18 版本号修改 从1.0改为1.14.1.3 增加本节2009-2-14 增 加Time_Stamp、EncodeStr，对订购关系进行加密，保持数据安全性4.1.5.1订购关系通知 SP 请求（OrderRelationUpdateNotifyReq）4.2.5.1请求文件头（定长）2009-2-14 增加接口约束 4.2.1接口描述注1：每次更改归档文件时，需填写 注2：文件 次归档时， 更改理由 、 主要更改内容 写 前 言本 中国联通增 中 系 ，本系 的 期 ：中国联通增 中 （VAC）技术 制 本 据 的 与需求，时进行修改 本 由中国联通增 currency1 本 由中国联通技术归口 本 主要起“：中fifl ，中国联通增 本 主要起“人： 本 的修改和 中国联通 中国联通增值业务鉴权中心接口技术要求：VAC平台与SP接口规范（V1.1）1范围本 规定中国联通VAC与SP 间的接口 用”联通、和 进行VAC和SP系统联 的制、 发和， 中国联通VAC、SP接规和 的本据 2规范性引用文件文件中的 通过本 的引用为本 的 注日期的引用文件， 的修改（ 的内容） 修订版 用”本 ， ， 据本 协议的 方可 用 文件的新版本 注日期的引用文件，新版本用”本 3定义与缩略语3.1定义本 用 定义：1 ： 定的内容和 的 名 用 用 同的增 的 理 ， currency1 与 进行 理和 的对 新 ：指础增 ，例 ：fi件、消息、浏览、流媒 等，可 用 进行组 ， 造特定的 ，满足细的用 需求 3 引擎：指现 个 的物理 4 产品：产品 对 的 价， 用 购买 的方式，即用 用 需要支付的价钱、支付的方式、 及够获得的 用额度 VAC系统中，产品 订购、 、和费的对，月5元 个 对应多个产品， 个产品唯 对应 个 5 内容：内容 用 真正 用的对， 中currency1 的 个个 ， 手机 中的 个 片 6 门 ：指直接面对用 的界面 增 中 通过多种承载形式currency1 给用 多样化的操作， 订购、取消、查、导购、帮助等 ” 同的承载形式，门 可 WAP门、WEB门 、短信门 和语音门 3.2缩略语本 用 缩略语：VAC Value-added Service Platform 增 中 AAA Authentication Authorization Account 认证授 费Brew Binary Runtime Environment for Wireless 线二进制 行环境CDMA Code Division Multiple Access 码多址DM Device Management 备 理DRM Digital Right Management 数字版 理4IM Instant Massage 即时消息GSM Global System for Mobile communication 全球移动通信系统GPRS General Packet Radio Service 通用 线组 LCS Location Services 定 MMS Multimedia Messaging Service 多媒 消息 OTA Over the Air 空中 载PIM Personal Information Management 个人信息 理PoC PTT over the Cellular ”蜂窝网的PTT PTT Push to Talk 按即说SLA Service Level Agreement 品质协议SP Service Provider currency1 SSG Service Select Gateway 选择网关TTS Text-To-Speech 文本语音转换WAP Wireless Application Protocol 线应用协议3.3信息更新时机定义- 对”新增的CP SP，当 次转为 ， 次转为用 时， 需要更新 次 - 对” CP SP，信息发 变化时，需要更新 种 ，BSS VAC CP SP信息 4VAC和SP间的接口4.1定购通知接口4.1.1接口描述用 订购关系发 变化时 及用 点 SP 时，VAC通过 接口时通知SP 、 时 用 接口通知SP，通过 TP订购关系同步接口通知SP 通知 时， 据 ，VAC可进行 ， 记录日 ， 通过 TP订购关系同步接口进行 为 SP改造的 作 ，保 联通信平台SGIP与WAP平台（ ）ttp 种通知SP的方式， SP可 从种方式中选择 种 4.1.2发起方系统VAC 4.1.3接受方系统SP 4.1.4接口协议接口 用Web Service方式 4.1.5接口内容4.1.5.1订购关系通知SP请求（OrderRelationUpdateNotifyReq）数名 currency1 “ 描述RecordSequenceIDstring 18 流号, UserIdType integer 4 用 IDcurrency11: MSISDN52: PsedoCodeUserId string 36 用 手机号码 码UserIdType填1 为手机号码UserIdType填2 为码ServiceType String 2 currency1,fi录SpId string 21 SP ProductId string 21 产品 （ 为SPPRMfl 请的SP_Productid）UpdateType integer 4 更新操作的currency1 ：1：订购2：取消订购3：点 UpdateTime string 14 更新时间UpdateDesc string 100 更新操作的细描述，认为空LinkID string 20 关联ID，用”点 的时定购关系关联，由平台产 式 ：MMDDHHMMSS+10机 号 为空 用 点 时 用 Content string 140 内容EffectiveDate string 14 订购关系 时间 式：yyyyMMddhhmmssExpireDate string 14 订购关系 时间 式：yyyyMMddhhmmssTime_Stamp string 10 时间”由VAC 式 MMDDMMSS，月日时 EncodeStr string 32 用3 的MD5加密 SP 定购关系 的 性 MD5 加密 EncodeStrserId密 ProductId TimeStamp密由SP 时间”由VAC备 ， 式 ：MMDDMMSS，月日时 密的定义BSS与VAC接口规范SP性接口Order eySP的Order ey为空VAC 加密4.1.5.2订购关系通知SP响应（OrderRelationUpdateNotifyRsp）数名 currency1 字节“描述RecordSequenceIDstring 18 流号，与OrderRelationUpdateNotifyReq的流号同ResultCode integer 4 码0: 1. 64.2定购关系同步接口4.2.1接口描述接口用”VAC与SP每增 订购关系 定购和 订 VAC 每增 文件VAC为SPcurrency1 的文件 的 录 方通过文件 现接口 文件定 对应 录 取 的用 VAC为SP 写文件 的用 和密码 系统”每 1： 进行文件 同步 同步 期应 据新规定进行可 的 文件 用GB 编码GB 编码 式文件 定长，文件 性间 用 t ， 记录时 应的性 为空，直接用 ， 间 号 文件 中 行作为 记录， 记录 间用换行 n 作为 文件中写 文件头定长， 性间 文件 定长 文件的 由VAC 4.2.2发起方系统VAC 4.2.3接受方系统SP 4.2.4接口协议TP 文件 4.2.5接口内容文件 录录 VAC SubscribeInfo SPID 文件名 SubscribeInfoSPIDyyyyMMddmmxxxnnnn.txtSPID ， 足 ， 文件产 的时间（1 yyyyMMddmm 月日时）xxx为码 nnnn 4 号，每从 1 ， 从 1 4.2.5.1请求文件头（定长）号 性名 长度 备注1 文件 号(流号) CHAR(4) 0001 ， 满9999 新 环2 版本信息 CHAR(5) ：000003 文件产 时间 CHAR(14) yyyymmddhhmmss4 文件 方系统码 CHAR(3) 9025 记录 日期时间 CHAR(14) yyyymmddhhmmss6 记录 束日期时间 CHAR(14) yyyymmddhhmmss7 记录数 CHAR(10)8 备用 CHAR(40)9 换行 CHAR(1)4.2.5.2文件体数名 currency1 “ 描述RecordSequen string 18 流号, 7ceIDUserIdType integer 4 用 IDcurrency11: MSISDN2: PsedoCodeUserId string 36 用 手机号码 码UserIdType填1 为手机号码UserIdType填2 为码ServiceType String 2 currency1,fi录A7SpId string 21 SP ProductId string 21 产品 （ 为SPPRMfl 请的SP_Productid）UpdateType integer 4 更新操作的currency1 ：1：订购2：取消订购3：点 UpdateTime string 14 更新时间UpdateDesc string 100 更新操作的细描述，认为空LinkID string 20 关联ID，用”点 的时定购关系关联，由平台产 式 ：MMDDHHMMSS+10机 号 为空 用 点 时 用 Content string 140 内容EffectiveDate string 14 订购关系 时间 式：yyyyMMddhhmmssExpireDate string 14 订购关系 时间 式：yyyyMMddhhmmssTime_Stamp string 10 时间”由VAC 式 MMDDMMSS，月日时 EncodeStr string 32 用3 的MD5加密 SP 定购关系 的 性 MD5 加密 EncodeStrserId密 ProductId TimeStamp密由SP 时间”由VAC备 ， 式 ：MMDDMMSS，月日时 密的定义BSS与VAC接口规范SP性接口Order eySP的Order ey为空VAC 加密4.2.6过渡阶段定制关系变更通知SP通用流程信通知SP方式8VAC SPSMG-DeliverDeli