2022年中国联通增值业务鉴权中心接口规范-VAC与增值系统接口.doc

中国联通公司发布2008-0X-XX施行2008-0X-XX发布中国联通增值业务鉴权中心接口标准VAC与增值业务系统接口分册（V1.1）China Unicom （Version 1.0）QB/CUxxx—2008中国联通公司企业标准目 次修正记录 III前 言 VIII1 范围 92 标准性援用文件 93 缩略语和术语 93.1 缩略语 93.2 术语 24 VAC和增值业务系统间的接口 24.1 实时鉴权计费接口 24.1.1 接口描绘 24.1.2 Command ID （命令字）定义 34.1.3 根本数据类型 44.1.4 PDU 概述 44.1.4.1 连接音讯 54.1.4.2 去连接音讯 64.1.4.3 链路握手音讯 64.1.4.4 鉴权批价 64.1.4.5 鉴权批价确认 124.1.4.6 流量计费音讯 134.2 统一配置接口 164.2.1 接口描绘 164.2.2 SP根本信息FTP文件同步接口 164.2.3 SP才能信息FTP文件同步接口 164.2.4 业务信息FTP文件同步接口 164.2.5 业务才能信息FTP文件同步接口 164.2.6 产品信息FTP文件同步接口 164.2.7 订购关系FTP文件同步接口（WAP门户） 164.2.8 CP根本信息FTP文件同步接口 164.3 查询用户定购关系接口 164.4 查询用户信息接口 194.4.1 接口描绘 194.4.2 发起方系统 194.4.3 接受方系统 194.4.4 接口协议 194.4.5 接口内容 194.4.5.1 用户信息查询恳求（UserIdRequest） 194.4.5.2 用户信息查询响应（UserInfoResponse） 194.4.5.3 用户信息构造 204.5 用户信息同步接口 204.5.1 接口方式 204.5.2 文件目录 204.5.3 文件格式 214.6 用户号段同步接口 214.6.1 接口描绘 214.6.2 接口协议 214.6.3 接口内容 214.7 测试用户同步接口 214.7.1 接口描绘 214.7.2 接口协议 224.7.3 接口内容 22附　录　A （标准性附录） 可选参数标识定义 24附　录　B （标准性附录） 数据类型定义 25附　录　C （标准性附录） 鉴权批价接口返回错误结果码定义 27附　录　D （标准性附录） 门户结果码定义 30附　录　E （标准性附录） wsdl 31修正记录文件编号版本号拟制人/修正人拟制/修正日期更改理由主要更改内容（写要点即可）V1.02008-11-4假如可信任门户能知晓用户使用的是详细的产品构成，增加SPID+SPEC_Productid方式4.1.4.4节修订部分2008-11-18新增fee TLV，应对过渡阶段部分业务系统本人批价，如炫铃4.1.4.4节注释2008-11-20设备类型SPMS填SMS Portal附录B2008-11-23Operation Type 增加了 “6、定购关系鉴权(用于检查用户是否订购了此业务)”便于SPMS定购和WAP访征询确认URL做定购关系鉴权4.1.4.4节2008-12-03增加定购渠道和计费类型4.1.4.4节2008-12-3增加” 鉴权批价接口返回错误结果码定义”附录C2008-12-5流量计费增加了linkId4.1.4.62008-12-14增加了wap门户查询用户所有定购关系接口4.3节2008-12-15增加用户信息查询接口4.4节封面V1.12008-12-18版本号修正从1.0改为1.14.42008-12-18修正小节格式2009-1-15修正ServiceType字段备注4.1节2009-1-15Service_updown_Type字段，增加P TO E类型4.1.4.42009-1-20更新成12-24日期的wsdl附录E2009-2-13增加ContentID增加响应中CC-Time等4字段取值描绘4.1.4.6　流量计费音讯2009-2-13增加用户效劳类型4.4.5.32009-2-13增加3G业务设备类型附录B2009-2-14增加发端设备类型4.4.5.1　用户信息查询恳求（UserIdRequest）2009-2-14LinkID生成规则调整，习惯现网在信业务4.1.4.4　鉴权批价4.1.4.6　流量计费音讯2009-2-14WSDL文件更新附录E2009-06-19中国联通增值业务鉴权中心接口标准-VAC与增值系统全国VAC接口分册”改为“中国联通增值业务鉴权中心接口标准-VAC与增值系统接口分册名称修正2009-06-19名称由“WAP门户查询用户所有定购关系接口”修正为“查询用户定购关系接口”；接口方向：“Portal->VAC”改为“增值系统->VAC”；删除触发条件、约束；输入参数中，srcDeviceType字段注释“02：WAP PORTAL ；”改为“填写发端设备的详细类型，见附录B”；srcDeviceID字段注释“02：WAP PORTAL ；”改为“联通指定，可配置”各字段长度以WSDL文件为准expireTime字段备注，删除“，自动续订的不填”，改为必填4.3　WAP门户查询用户所有定购关系接口2009-06-19名称由“WAP门户查询用户信息接口”修正为“查询用户信息接口；发起方系统“门户”改为“增值系统”；用户信息查询恳求（UserIdRequest）中srcDeviceType字段描绘“02：WAP PORTAL ；”改为“填写发端设备的详细类型，见附录B”；srcDeviceID字段 “02：WAP PORTAL ；”改为“联通指定，可配置”4.4　WAP门户查询用户信息接口2009-06-19ResentTimes字段，增加“默认取值0”fee字段，增加“增值系统不批价的不带fee字段，同时VAC侧支持按照业务类型进展配置是否批价处理。

对代收费业务fee、FeeType必须正确填写FeeType只能填2、3）删除“部分业务系统在过渡阶段可本人批价,如炫铃等,”ServiceIDType字段，删除5取值SP_ID/AccessNo字段，名称改为“SP_ID”，描绘改为“填写企业代码”ServiceID/FeatureString字段，删除2,5取值描绘Operation Type，描绘中删除“ServiceIDType=3或4时，产品类型必须为点播类生成LinkID，上行计费的产品同时进展计费同一LinkID只计费一次是否删除“ServiceIDType=1时，”4.1.4.4　鉴权批价2009-06-19删除本章，相关内容放在总部VAC接口标准分册中5　VAC和全网VAC系统间的接口2009-06-19设备类型（SourceDevice_Type）增加：47：中央音乐平台48：邮箱增加“对用户数据，除接口中已经明确填写格式的，VAC作为接受方，支持用户号码前加或不加86；其他接收方在接受VAC数据时，也应习惯用户号码前加或不加86附录B 2009-06-19（2）OrderMethod字段增加“，在定购时业务系统必须填写”（3）ServiceType字段，增加“当Operation Type=1、2、3、4时，VAC不对鉴权发起方的业务类型与产品的业务类型进展比拟鉴权”（4）Service_updown_Type字段，增加“vac对彩信p to e、sp彩信、在信、wap push业务需要推断详细取值，对其他业务不鉴权本字段”（5）oa、da,删除“或业务平台编号”，删除“依照Service_updown_type字段，”（6）CheckPriceResp鉴权批价应对中feetype字段,增加“对会话类计费，5或6必须返回”（7）增加AccessNo字段4.1.4.4　鉴权批价2009-06-19srcDeviceID改为string类型Userbrand改为STRING 5，增加“，采纳编码方式表示，详细编码取值对应的品牌由需要本字段的系统保存静态表，自行维护。

4.4　查询用户信息接口2009-06-19Volume-Quota-Threshold备注补充Validity-Time增加备注“当采纳流量计费时，客户端在本次分配配额已使用时长到达Validity-Time表示值时，向效劳器端发起重新受权申请新的配额4.1.4.6　流量计费音讯2009-7-9（1）Operation Type增加“7、屏蔽业务才能 8、恢复业务才能”（2）Operation Type=3，“退定所有业务”改为“退订ServiceType对应的所有业务（终端侧不能单独退订业务除外）”，说明放入备注中（3）增加“注……”4.1.4.4　鉴权批价2009-7-9userServiceType说明改为“，详细取值见VAC与BSS接口标准附录A.26”4.4.5.3　用户信息构造2009-7-9从3G补充标准中移入4.2.7　CP根本信息FTP文件同步接口4.5　用户信息同步接口4.6　用户号段同步接口4.7　测试用户同步接口2009-7-16增加错误码1006 此业务才能已被屏蔽1007 用户无法屏蔽/恢复业务才能附录C2009-7-16SequencNumber增加说明“和CheckPrice中SequenceNumber编码方式一致”4.1.4.6　流量计费音讯2009-7-16增加注：（4）针对点对点彩信，业务代码、产品代码等按照以下方式分配，彩信中心按照以下规则填写后发起到vac的国内点对点彩信业务鉴权，彩信国际互通网关按照以下规则填写后发起到vac的国际彩信业务鉴权：u CPID：不需要规定，不使用 u SPID ：99999u 国际彩信业务代码 ： 32000001，其中32 彩信中心编码，00 全国业务，0001 业务编号；国际彩信产品代码：3200000101u 国内点对点彩信代码：32xx0002，其中32 彩信中心编码，xx 分公司业务（xx为省分代码），0002 业务编号；国内点对点彩信产品代码 32xx000201u 国内点到mail彩信代码：32xx0003，其中32 彩信中心编码，xx 分公司业务（xx为省分代码），0003 业务编号；国内点对点彩信产品代码 32xx000301 （5）针对业务代码等信息，增值系统、vac、业务支撑系统必须都是。