中国联通增值业务鉴权中心接口规范-VAC与SP接口规范-1212.doc

6目 次 修改记录 II 前 言 III 1 范围 4 2 规范性引用文件 4 3 定义与缩略语 4 3.1 定义 4 3.2 缩略语 4 3.3 信息更新时机定义 5 4 VAC和SP间的接口 5 4.1 定购通知接口 5 4.1.1 接口描述 5 4.1.2 发起方系统 5 4.1.3 接受方系统 5 4.1.4 接口协议 5 4.1.5 接口内容 5 订购关系通知SP请求（OrderRelationUpdateNotifyReq） 5 订购关系通知SP响应（OrderRelationUpdateNotifyRsp） 6 4.2 定购关系同步接口 6 4.2.1 接口描述 6 4.2.2 发起方系统 7 4.2.3 接受方系统 7 4.2.4 接口协议 7 4.2.5 接口内容 7 请求文件头（定长） 7 文件体 7 4.2.6 过渡阶段定制关系变更通知SP通用流程 8 修改记录 文件编号 版本号 拟制人/ 修改人 拟制/修改日期 更改理由 主要更改内容 （写要点即可） 封面 V1.1 2008-12-18 版本号修改 从1.0改为1.1 4.1.3 增加本节 2009-2-14 增加Time_Stamp、EncodeStr，对订购关系进行加密，保持数据安全性 　订购关系通知SP请求（OrderRelationUpdateNotifyReq） 　请求文件头（定长） 2009-2-14 增加接口约束 4.2.1　接口描述 2009-6-19 ResultCode字段描述，增加“当vac通知sp订购关系，但SP发现已经存在该订购关系时，SP返回VAC成功” 2009-6-19 1、UpdateType字段 增加“对全量同步文件，忽略本字段取值” 删除3值； 取值2，“取消订购”改为“退订” 2、ProductId改为SP_ProductId 增加：5：改号 3、LinkID编码“MMDDHHMMSS+10位随机序列号”改为“8位随机序列号” 增加“注：UpdateType=5时，表示用户改号后的订购关系迁移操作，sp将Content字段表示的用户的所有订购关系、绑定的附属信息均迁移到UserId字段用户。此时按照sp或业务信息中SPOrderUrl字段通知SP。 ” 　文件体 2009-6-19 增加方案二 4.2.6　过渡阶段定制关系变更通知SP通用流程 2009-11-11 （1）UpdateType，取值2，“取消订购”改为“退订”；增加“4：定购关系变更(一般是修改有效期)（保留，暂不用） 5：改号” （2）Content字段增加“，当UpdateType=5时，本字段填原用户手机号码或伪码，具体填写方式由UserIdType字段决定” （3）UpdateDesc字段，“，默认为空”改为“联通在信、彩信等定购、点播接入号，和CheckPrice请求中AccessNo字段一致；对crm侧订购、退订由vac根据产品填写；对其他业务填空” 　订购关系通知SP请求（OrderRelationUpdateNotifyReq） 2009-11-11 （1）增加回执文件目录 （2）增加sp全量稽核多余文件目录 （3）调整文件后缀，“req表示请求, rsp表示请求结果” （4）增加节 （5）增加节 （6）增加节 4.2.5　接口内容 2009-11-11 （1）小节名由“文件体”改为“请求文件体” （2）UpdateDesc字段，“，默认为空”改为“联通在信、彩信等定购、点播接入号，和CheckPrice请求中AccessNo字段一致； 对crm侧订购、退订由vac根据产品填写；对其他业务填空” 　请求文件体 2009-12-11 增加“对CRM增量、全量文件形式的订购、退订数据，VAC仅以文件方式通知SP，不以实时方式通知。” 对增量接口增加“VAC每个小时（可配置）生成1个文件，10万条以内只能是1个文件，超过10万条另起1个文件，不能出现跨天的情况。 VAC在某时刻生成的实时数据包含在当天增量数据中及当月全量数据中。对增量文件稽核接口，VAC只把对定购关系的最后一次操作记录传递给SP，不传递中间过程，例如当用户某天定购某产品、接着又退订该产品后，增量同步时VAC只把最后一次退订操作记录传递给SP，不传递前一次的定购操作。” 增加全量同步接口和说明 明确，增量文件：根目录/VAC/SubscribeInfo/SPID/add/ 全量文件：根目录/VAC/SubscribeInfo/SPID/all/ 4.2　定购关系同步接口 WSDL文件更新 附录A 注1：每次更改归档文件时，