文档VIP

积分充值

消息

昵称未设置
文档VIP

未开通
文档积分

0

已下载文档

我的文档

我的专题

订单查询

积分变动

推介奖励

优惠券

收藏

账号安全
后台管理 退出登录
搜索历史
    智库文档 所有分类

    业务管理中国联通增值业务鉴权中心接口规范VAC与BSS接口规范.doc

    下载

    卓越管理  |  2020-08-04 10:30 
    152页   |   2.83MB   |   0次下载 |  
    0.0
    (0人评价)
    我要评价：
    用手机看文档

    扫一扫,手机看文档

    下载
    开通VIP
    QB/CUXXX-200X ××××—×××× I （业务管理）中国联通增值 业务鉴权中心接口规范 VAC 与 BSS接口规范 QB/CUXXX-200X ××××—×××× II 6 中 国 联 通 公 司 企 业 标 准 QB/CU ×××—×××× 中国联通 VAC平台接口技术要求： VAC与 BSS 接口规范 （暂定名） （） ××××-××-××发布 ××××-××-××实施 中国联通公司发布 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） I 目 次 修改记录................................................................................V 前 言................................................................................X 1 范围.................................................................................11 2 规范性引用文件.......................................................................11 3 定义与缩略语.........................................................................11 定义...............................................................................11 缩略语.............................................................................11 系统边界...........................................................................12 接口原则...........................................................................12 接口约束...........................................................................12 信息更新时机定义...................................................................12 CP/SP信息 .......................................................................12 业务/产品信息....................................................................13 4 VAC与 PRM系统的接口要求 .............................................................13 SP管理信息同步接口 ................................................................13 接口描述.........................................................................13 发起方系统.......................................................................13 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） II 接收方系统.......................................................................13 接口协议.........................................................................13 接口内容.........................................................................13 Web Service接口 ...............................................................13 FTP接口 .......................................................................14 SP业务能力信息同步接口 ............................................................17 接口描述.........................................................................17 发起方系统.......................................................................17 接收方系统.......................................................................17 接口协议.........................................................................17 接口内容.........................................................................18 Web Service接口 ...............................................................18 SP业务能力信息同步请求 ........................................................18 业务能力签约结构...............................................................19 FTP接口 .......................................................................23 业务信息同步接口...................................................................25 接口描述.........................................................................25 发起方系统.......................................................................25 接收方系统.......................................................................25 接口协议.........................................................................25 接口内容.........................................................................26 Web Service接口 ...............................................................26 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） III FTP接口 .......................................................................28 5 VAC与 CRM系统的接口要求 .............................................................31 产品信息同步接口...................................................................31 接口描述.........................................................................31 发起方系统.......................................................................31 接收方系统.......................................................................31 接口协议.........................................................................31 接口内容.........................................................................31 Web Service接口 ...............................................................31 FTP接口 .......................................................................35 用户开户接口(用户级业务能力).......................................................39 接口描述.........................................................................39 发起方系统.......................................................................39 接收方系统.......................................................................39 接口协议.........................................................................39 接口内容.........................................................................40 用户开户请求（UserRegistReq）..................................................40 用户开户响应（UserRegistRsp）..................................................40 UserRegistReq用户开户请求 FTP 接口 .............................................41 用户号段信息同步接口...............................................................43 接口描述.........................................................................43 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） IV 发起发系统.......................................................................43 接收方系统.......................................................................43 接口协议.........................................................................43 接口内容.........................................................................43 文件目录.......................................................................43 文件命名.......................................................................43 请求文件头（定长）.............................................................43 回执文件头（定长）.............................................................44 请求文件体.....................................................................44 回执文件体（变长）.............................................................45 用户信息同步接口...................................................................45 Socket接口 ......................................................................45 发起方系统.....................................................................45 接收方系统.....................................................................45 接口方式.......................................................................45 连接方式.......................................................................45 包头流水号规则.................................................................45 消息定义.......................................................................46 数据类型.......................................................................46 消息头.........................................................................46 消息体说明.....................................................................46 Bind操作 .....................................................................46 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） V Bind命令的语法 ...............................................................47 Bind_Resp应答的语法 ..........................................................47 Unbind操作 ...................................................................47 Unbind命令的语法 .............................................................47 Unbind_Resp应答的语法 ........................................................47 User_Info操作 ................................................................47 User_Info语法 ................................................................47 User_Info_Resp语法 ...........................................................49 链路检测包 KeepAlive与 KeepAlive _Resp ........................................50 文件方案.........................................................................50 文件目录.......................................................................50 文件命名.......................................................................50 文件格式.......................................................................51 产品订购关系同步接口...............................................................53 概述.............................................................................53 CRM发起的业务订购接口 ...........................................................53 接口描述.......................................................................53 发起方系统.....................................................................53 接收方系统.....................................................................53 接口协议.......................................................................53 接口内容.......................................................................54 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） VI VAC发起的业务订购接口 ...........................................................58 接口描述.......................................................................58 发起发系统.....................................................................58 接收方系统.....................................................................58 接口协议.......................................................................58 接口内容.......................................................................58 资费模型同步接口...................................................................60 接口描述.........................................................................60 发起方系统.......................................................................60 接收方系统.......................................................................60 接口协议.........................................................................60 接口内容.........................................................................60 Web Service接口 ...............................................................60 FTP接口 .......................................................................61 优惠规则模型同步接口...............................................................67 接口描述.........................................................................67 发起方系统.......................................................................67 接收方系统.......................................................................67 接口协议.........................................................................67 接口内容.........................................................................67 Web Service接口 ...............................................................67 FTP接口 .......................................................................68 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） VII 6 VAC与 billing系统的接口要求 .........................................................74 业务话单同步接口...................................................................74 接口描述.........................................................................74 发起方系统.......................................................................74 接收方系统.......................................................................74 接口协议.........................................................................74 接口形式.........................................................................74 详细约定.........................................................................74 原始话单文件采集...............................................................74 核对机制.......................................................................74 具体约定.......................................................................74 7 VAC与 OCS系统的接口要求 .............................................................78 附　录　A （规范性附录） 信息编码......................................................79 SP/CP企业代码（SPID:X1X2X3X4X5X6X7X8，X6X7X8三位预留） ...............................79 SP/CP归属地域（XXXXXYYY） .........................................................79 SP接入码（accessNo:X1X2X3X4X5X6X7X8）................................................80 SP状态（X） .......................................................................80 业务代码（ServiceID:X1X2X3X4X5X6X7X8X9X10，X9X10：预留） ...............................80 合作伙伴产品代码（ProductID:X1X2X3X4X5X6X7X8X9X10X11X12） ..............................81 业务类型代码（X1X2） ...............................................................81 业务状态编码（X）..................................................................82 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） VIII 产品状态编码（X）..................................................................82 计费单位（X）.....................................................................83 计费类型（X）.....................................................................83 费率描述代码(X1X2X3X4X5X6X7X8X9X10 X11X12X13X14X15 X16 X17 X18 X19 X20) .....................83 优惠描述代码（X1X2X3X4X5X6X7X8X9X10 X11X12X13X14X15X16X17X18X19X20） ........................84 定购渠道（X1X2） ..................................................................84 系统编码（X1X2X3）.................................................................85 联通省分代码（X1X2X3）.............................................................85 联通地市代码（X1X2X3）.............................................................86 国家/地区编码（X1X2X3X4X5） ........................................................95 SP接口 URL规范 ...................................................................97 文件类型（X1X2） ..................................................................98 SOAP消息错误代码表 ...............................................................99 记录级错误代码定义（3位） .......................................................101 文件级错误代码定义（3位） .......................................................102 SP信用等级 ......................................................................103 业务能力状态编码.................................................................103 业务类别.........................................................................104 附　录　B 规范性附录 CRM发起定购 VAC返回给 CRM错误码 .................................104 附　录　C 规范性附录 用户状态编码.....................................................106 附　录　D 规范性附录 用户状态接口错误代码.............................................106 附　录　E 规范性附录 WSDL文件 ........................................................107 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） IX 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） X 修改记录 文 件 编 号 版 本 号 拟 制 人 / 修 改 人 拟制/修改日 期 更改理由 主要更改内容 （写要点即可） VXX 2008-11-12 增加资费和优惠规则 产品接口 2008-11-16 大部分省 PDSCP不会按业务类型 来区分，不必每个号段分业务同步 业务类型增加 00表示此省 PDSCP 不分业务类 型,完全按号段 2008-11-17 产品信息的 MaxUseTime长度改为 整形 4,可选 节 2008-11-18 定义文件接口实现机制，VAC产生 文件放在 VAC的 FTP上，其他系统 来取,其他系统产生的文件，主动 放到 VAC的 FTP上 所有文件接口 2008-11-18 要求 CRM改号:先退定旧号码定购 关系 再发改号消息 再发新号码定购 用户信息接口 2008-11-18 用户信息文件接口缺少营帐最后 更新时间 节 2008-11-18 产 品 接 口 maxUseTimes和 maxUseTime这两字段在接口里作 为保留字段，暂不用 节 2008-11-22 包周期计费增加参数 天 节 2008-11-22 ServiceType是业务类型不是类别 节 2008-11-25 VAC与 CRM用 户 状 态 接 口 ” Old_SubscrbStat”应该是 2位， 原文有笔误 　User_Info语法 2008-11-26 增加扣租开始时间(不同用户免费 期不一定一样) 2008-11-27 Sequence Number整形长度改为 4 位 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） XI 2008-11-27 SubscrbStat长度 5位，类型改为 text型 2008-11-28 上行和下行流量改成以字节为单 位 2008-12-2 增加 UpdateType更新类型 和 2008-12-3 删除附录 E,移到<<中国联通增值 业务鉴权中心接口规范-VAC与增 值系统&全国 VAC接口分册-1203 >> 附录 E 2008-12-4 订购关系同步接口增加变更接口， 支持修改订购关系有效期 2008-12-4 文件采集方系统代码长度应为 3, 文中是笔误 2008-12-4 增加” CRM发起定购 VAC返回给 CRM错误码” 附录 B 2008-12-7 单位费率,改为按计费单元计费,增 加计费单元长度，封顶费用，保底 费用参数定义 后的资费模型， 2008-12-7 增加价格促销,15日后定购半价, 费用封顶优惠,按定购天收费,首 月免月租，免 2….12 月租 后的优惠模型， 2008-12-7 同步 SP文件不足以区分文件，增 加省份代码和流水号 节 2008-12-16 增加 WAPServiceType 节 封 面 2008-12-18 版本号修改 从 改为 7 删除本章，另建文档 9 删除本章 附 件 E 2008-12-18 增加 WSDL 接口文件 2008-12-25 更新成 12-24日期的 wsdl 附录 E 2009-01-13 附录 A5, 更改业务代码编码规则, 去掉以字母开头的硬规定，业务类 型代码为 2位数字，具体含义见 。 附录 A 5 2009-1-13 VACSub更新，增加 SCP预付费产 品 2009-1-13 原始话单增加第8字段AccessNo， 增加第 21字段 UserType 2009-1-15 修改 ServiceCapabilityType 字段备注 、 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） XII 2009-1-15 将部分 string类型改为 integer 4类型，并增加取值范围 2009-1-19 修改部分类型，增加 3G业务类型 2009-1-19 Sms能 力 中 增 加 表 述 和 NEWaccessNo字段，允许 1个 企业代码对应多个 sp 接入号 2009-1-19 SMSCapabilityInfo等 信 息 同 "　业务能力签约结构" 2009-1-19 增加 NotifyType字段取值 增加 ProductCity字段 2009-1-19 增加 NotifyType字段取值 增加 ProductCity字段 对 3、4取值含义进行明确 对 3取值含义进行明确 2009-1-20 更新成最新的 1月 19 日 wsdl 附录 E 2009-2-10 将文件生成方系统代码改为 104 　请求文件头（定长） 　请求文件头（定长） 2009-2-10 文件生成方系统代码 902 　回执文件头（定长） 　回执文件头（定长） 2009-2-13 删除“为兼容现网企业代码长度最 长 8位(如在信，最长 5位)” 增加“PRM具体生成企业代码时， X6X7X8不分配，只生成 5位企业 代码传递给 VAC，并由 vac传递给 增值系统处理。” ，企业代码 2009-2-13 标题中增加“，X9X10：预留” 删除“对现网业务，VAC、PRM支 持代码长度不足 10位情况，适应 现网业务开展。” ，业务代码 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） XIII 增加“PRM具体生成业务代码时， PRM按照 8位分配，X9X10不分配； PRM将生成的 8位代码传递给 vac， 并由 vac传递给增值系统处理。” 2009-2-13 标题中增加“合作伙伴” 合法的字符包括数字（0~9），删除 字符 删除“产品代码长度要适应现网， 如在信产品代码最长 10位” 增加“CRM具体生成产品代码时， 按照“业务代码+ 2位产品顺序编 码”方式生成；即实际产品代码为 10位（8位业务代码+ 2位产品顺 序编码），CRM将生成的 10位代码 传递给 vac，并由 vac传递给增值 系统处理。” 　合 作 伙 伴 产 品 代 码 （ProductID:X1X2X3X4X5X6X7X8X9X10X11X12） 2009-2-13 删除 xml描述 增加对文件头、文件头约束条件总 体说明 　接口约束 2009-2-13 删除文件体、文件头、文件格式的 描述，统一在 接口约束中体现 　FTP接口 　FTP接口 　FTP接口 　FTP接口 　UserRegistReq 用户开户请求 FTP 接口 　用户号段信息同步接口 　文件格式 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） XIV 　FTP接口 　FTP 接口 　FTP接口 　接口形式 2009-2-13 增加有效值描述“，合法字符为 数字” 产品信息同步接口，Billing_Id 　资费模型同步接口，Billing_Id 2009-2-13 增加用户服务类型，以提供给 增值业务系统。 User_Info语法 2009-2-13 增加 M/T资费模型描述 资费模型 2009-2-13 增加 12、13、14渠道 附录 补充 2009-2-13 增加 组合业务，99 2009-2-14 增加定购关系共享密钥 　SP/CP信息同步请求（SPInfoReq） 2009-2-14 补充测试状态 2009-2-14 增加 SP业务能力信息中的短信 能力信息和彩信能力信息的 spRevId， spRevPassword， SMSURL,MMSURL,spStatusUrl,以 上字段用与 parlayx 网关 把 用 户发送消息转发给 SP 2009-2-14 SPOrderUrl长度修改 　SP/CP信息同步请求（SPInfoReq） 　请求文件体（变长） 2009-2-14 Enterurl、freeurl长度修改 　业务信息同步请求（ServiceInfoReq） 　请求文件体（变长） 2009-2-14 增加包月计费＋单位费率+分档计 费 　资费模型同步接口，资费模型 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） XV 注 1：每次更改归档文件时，需填写此表。 注 2：文件第一次归档时，“更改理由”、“主要更改内容”栏写“无”。 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） XVI 前 言 本标准是中国联通增值业务鉴权中心系列标准之一，本系列标准的预期结构如下： 《中国联通增值业务鉴权中心（VAC）技术体制》 本标准将根据业务的开展情况与市场需求，适时进行修改。 本标准由中国联通公司增值业务部提出。 本标准由中国联通公司技术部归口。 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） XVII 本标准主要起草单位：中讯邮电咨询设计院，中国联通增值业务部 本标准主要起草人：××× 本标准的修改和解释权属中国联通公司。 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 18 中国联通增值业务鉴权中心接口技术要求：VAC平台与 BSS接口规范（） 1　范围 1　 本标准规定了中国联通VAC与信息化部业务支撑系统（BSS）之间的接口，包括VAC与BSS 之间的接口、省分VAC与省分BSS之间的接口。适用于联通、省分公司和厂家进行VAC和BSS系 统建设的研制、开发和实施，是中国联通VAC、BSS规划和建设的基本依据。 2　规范性引用文件 2　 下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其 随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标 准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新 版本适用于本标准。 3　定义与缩略语 3　 　定义 　 本标准采用以下定义： 1) 业务：业务是一定的内容和/或服务能力的聚合。业务名称是用户用以识别不同的 增值业务的标识。在管理上，业务是服务提供商与运营商进行审核管理和分成结算 的对象。如“新浪酷图”业务。 1) 2) 业务能力：指基础增值服务，例如：邮件、消息、浏览、流媒体等，可以使用这些 业务能力进行组合，构造出特定的业务，满足细分市场后的用户需求。 2) 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 19 3) 业务引擎：指实现各个业务能力的物理实体。 3) 4) 产品：产品是对业务的标价，是用户购买业务的方式，即用户使用业务所需要支付 的价钱、支付的方式、以及其能够获得的使用额度。在VAC系统中，产品是订购、 鉴权、和计费的对象，如“包月5元”。一个业务对应多个产品，一个产品唯一对应 一个业务。 4) 5) 内容：内容是用户真正使用的对象，是在业务中提供的一个个实体，如“手机酷图” 业务中的一个图片。 5) 6) 门户：指直接面对用户的界面。增值业务鉴权中心通过多种承载形式提供给用户多 样化的操作能力，如业务订购、取消、查询、导购、帮助等。基于不同的承载形式， 门户可以包括WAP门户、WEB门户、短信门户和语音门户。 6) 　缩略语 　 本标准采用以下缩略语： VAC Value-added service Authentication Center 增值业务鉴权中 心 AAA Authentication Authorization Account 认证授权计费 Brew Binary Runtime Environment for Wireless 无线二进制运行环境 CDMA Code Division Multiple Access 码分多址 DM Device Management 设备管理 DRM Digital Right Management 数字版权管理 IM Instant Massage 即时消息 GSM Global System for Mobile communication 全球移动通信系统 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 20 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 服务提供商 SSG Service Select Gateway 业务选择网关 TTS Text-To-Speech 文本语音转换 WAP Wireless Application Protocol 无线应用协议 　系统边界 　 　接口原则 　 为了保证VAC与BSS系统方便、可靠地接口，接口规范应满足如下原则：  接口具有普遍的适应性；   使用简单、快捷的方式实现VAC与BSS系统的接口；   接口应充分考虑VAC与BSS系统的应用扩展情况；   保证接口数据在VAC与BSS系统的一致性；   接口数据能够方便的形成，并能在被接口方顺利地导入；   在接口数据交互过程中，应具有数据传送和接收传送后的确认过程；   在满足功能要求的前提下，使接口数据量最少； 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 21   接口数据传输控制策略可靠且完善；   具有可靠的接口数据出错处理机制。  　接口约束 　  XML文件中，编码方式为UTF-8； FTP传输ASCII文件时：   编码方式为GBK；   文件头，其中：   各字段属性定长，各属性之间不采用分隔符；   数字：右对齐、左补0；   字符：左对齐、右补空格；   文件头中“总记录数”不含文件头记录；   文件体，其中   各字段不定长；   文件体中每条记录的属性值按顺序排列，各属性间使用‘\t’分隔，在生 成记录时若相应的属性值为空，直接用分隔符隔开，分隔符之间无其他符 号。   文件体中一行作为一条记录，各条记录之间用换行符作为分隔并在文件中 连续书写。  每个文件大小可定义，每个文件不超过10万条记录  VAC与BSS间FTP文件接口除用户开户接口、用户定购关系接口、用户信息同步接口外，其 他均采用全量同步接口，接口描述中的增量接口主要用于VAC与增值系统接口。  特定对象文件由读取方负责读取完成后删除； 　信息更新时机定义 　 　CP/SP信息 　 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 22 - 对于新增的 CP/SP，当第一次转为测试状态，第一次转为商用状态时，分别需要更新 一次； - 对于已有 CP/SP，信息发生变化时，需要更新； 除以上两种情况外，BSS不能向VAC传递CP/SP信息。 　业务/产品信息 　 - 对于新增的业务/产品，当第一次转为测试状态，第一次转为商用状态时，分别需要 更新一次； - 对于已有的业务/产品，当该业务/产品/套餐信息发生变化时，需要更新； 除以上两种情况外，BSS不能向VAC传递业务/产品信息。 4　VAC与 PRM系统的接口要求 4　 　SP管理信息同步接口 　 　接口描述 　 目前PRM系统负责管理SP及业务的接入，并将SP的基本信息同步到VAC。 　发起方系统 　 PRM系统（Webservice客户端） 　接收方系统 　 VAC（Webservice服务器端） 　接口协议 　 PRM与VAC之间的SP信息同步接口采用下列两种实现方式： 1．Web Service方式：PRM通过Web Service方式将SP增量信息实时地同步给VAC。 1． 2．文件方式：PRM通过FTP文件方式将SP信息定时全量同步给VAC。 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 23 2． 　接口内容 　 　Web Service接口 　 　SP/CP 信息同步请求（SPInfoReq） 　 方向：PRM －> VAC 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号，格式为时间戳+ 序列号： YYYYMMDDHHMMSSxxxx， 其中 xxxx为序列号，从 0001开始，排满 9999 后 重新循环 string 18 M 2 UPDATEType 更新类型 1：增加 2：修改 3：删 除 integer 1 M 3 SPID SP标识 string 8 M 4 SPName SP名称 string 40 M 5 SPPsedoFlag 是否送 SP伪码 0:不给 1:给 integer 1 M 6 SPStatus SP状态，取值见附录 A integer 1 M 7 SPAreaID SP归属地域代码 取值见附录 A string 8 M 8 SPCity SP服务的地市范围，地 市代码固定 3位，中间 由“，”分隔，如此字段 为空表示服务全省，取 值见附录 A string 256 O 9 SPSrvPhone SP投诉电话 string 40 M 10 isTrust 是否是可信任 SP,见附 录 A 24 integer 1 M 11 SPOrderUrl SP订购 URL string 60256 O 12 OrderKey 定购关系共享密钥, 定 string 40 O 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 24 序号 参数名 说明 参数类型 最大长度 是否 必填 购关系同步时,VAC 用它 组合其他属性给出加密 串让 SP验证定购关系的 合法性,如果此串填 空,VAC就不产生加密串 1213 SynOrderFunc 定购关系同步方式(在信 SP可保留现有方式,对 于具备多种业务能力的 SP，建议采用 webservice接口) 0:webservice 接口 1:SGIP接口 integer 1 M 1314 EffDate 生效时间 string 14 O 1415 ExpDate 失效时间 string 14 O 1516 Reserve1 保留 string 40 O 1617 Reserve2 保留 string 40 O　 　SP/CP 信息同步响应（SPInfoRsp） 　 方向：VAC －> PRM 序号 参数名 说明 参数类型 最大 长度 是否 必填 1 RecordSequenc eID 流水号，格式为 时间戳+序列号： YYYYMMDDHHMMSS xxxx，其中xxxx 为序列号，从0001 开始，排满9999 后重新循环 string 18 M 2 ResultCode 结果标识 0：正确 1：其他错误 integer 4 M 　FTP接口 　 使用FTP接口情况： 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 25 1）需要定期全量的方式，对PRM和VAC的SP信息进行核查。PRM定期生成全量核查文件， VAC以PRM同步信息为准更新VAC的SP信息； PRM系统将SP的基本信息资料存放到VAC系统中文件服务器的指定目录下，由VAC主动获 取。双方通过文件传输实现接口。文件服务器上设定具有对相应目录存取权限的用户。VAC 系统为PRM分配具有存取文件权限的用户。 文件采用ASCII文本格式，文件体中每条记录的属性值按顺序排列，各属性间使用‘\t’ 分隔，在生成记录时若相应的属性值为空，直接用分隔符隔开，分隔符之间无其他符号。 文件体中一行作为一条记录，各条记录之间用换行符作为分隔并在文件中连续书写。 文件头定长，文件体不定长。 文件的维护由PRM（FTP Client）系统负责，VAC（FTP Server）采集后对文件进行删除 操作。 　文件目录和文件命名 　 PRM系统将请求文件放到VAC指定目录下，VAC将执行结果放回相应目录下,由PRM主动获 取, 获取后删除。批文件名按如下规则命名： yyyymmddhhmm为批文件产生的年月日时分。xxx为省分代码。nnnn 是4位序列号，每天 从“0001”开始，到达”9999”后又从“0001”开始。tttt表示文件类型，rreq表示准实时 请求, rrsp表示准实时请求结果。每一个rreq文件都应该有一个rrsp文件与其对应, areq表 示全量请求，arsp表示全量请求结果。每一个areq文件都应该有一个arsp文件与其对应。 具体对应关系如下： 文件类型 后缀 文件目录() 即时处理（准实 时） 请求文件：rreq， 响应文件：rrsp 存 放 请 求 文 件 工 作 目 录 ： <根 目 录 >/VAC/SPInfo/request /real 存放正确回执文件工作目录：<根目录>/VAC/spinfo /response/right/real 存放完全错误回执文件工作目录： <根目录 >/VAC/spinfo /response/bad，文件级错误代码参见附录 存放部分错误回执文件工作目录：<根目录>/VAC/spinfo /response/semiwrong，记录级错误代码参见附录 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 26 全量 请求文件：areq， 响应文件：arsp 存 放 请 求 文 件 工 作 目 录 ： <根 目 录 >/VAC/spinfo/request /all 存放正确回执文件工作目录：<根目录>/VAC/spinfo /response/right/all 存放完全错误回执文件工作目录： <根目录 >/VAC/spinfo /response/bad，文件级错误代码参见附录 存放部分错误回执文件工作目录：<根目录>/VAC/spinfo /response/semiwrong，记录级错误代码参见附录 　请求文件头(定长) 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 0001开始，排满 9999后重新循环 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR(14) Yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 104 5 记录开始日期时间 CHAR(14) Yyyymmddhhmmss 6 记录结束日期时间 CHAR(14) Yyyymmddhhmmss 7 总记录数 CHAR(10) 8 备用 CHAR(40) 9 换行 CHAR(1) 　回执文件头（定长） 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 从 0001 开始，排满 9999 后重新循环。 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR (14) Yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 902 5 总记录数 CHAR(10) 同请求文件 6 正确处理记录数 CHAR(10) 7 备用 CHAR(40) 文件级错误代码 8 换行 CHAR(1) 　请求文件体（变长） 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号，格式为时间戳+ string 18 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 27 序号 参数名 说明 参数类型 最大长度 是否 必填 序列号： YYYYMMDDHHMMSSxxxx， 其中 xxxx为序列号，从 0001开始，排满 9999 后 重新循环 2 UPDATEType 更新类型 1：增加 2：修改 3：删 除 integer 1 M 3 SPID SP标识 string 8 M 4 SPName SP名称 string 40 M 5 SPPsedoFlag 是否送 SP伪码 0:不给 1:给 integer 1 M 6 SPStatus SP状态，取值见附录 A integer 1 M 7 SPAreaID SP归属地域代码 取值见附录 A string 8 M 8 SPCity SP服务的地市范围，地 市代码固定 3位，中间 由“，”分隔，如此字段 为空表示服务全省，取 值见附录 A string 256 O 9 SPSrvPhone SP投诉电话 string 40 M 10 isTrust 是否是可信任 SP,见附 录 A 24 integer 1 M 11 SPOrderUrl SP订购 URL string 60256 O 12 SynOrderFunc 定购关系同步方式(在信 SP可保留现有方式,对 于具备多种业务能力的 SP，建议采用 webservice接口) 0:webservice 接口 1:SGIP接口 integer 1 M 13 EffDate 生效时间 string 14 O 14 ExpDate 失效时间 string 14 O 15 Reserve1 保留 string 40 O 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 28 序号 参数名 说明 参数类型 最大长度 是否 必填 16 Reserve2 保留 string 40 O　 　回执文件体（变长） 　 对于完全正确和完全错误的回执文件，只有文件头没有文件体；对于记录级错误的回执 文件，在文件体中列出错误的结果代码。 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号，格式为时 间戳+序列号： YYYYMMDDHHMMSSx xxx，其中xxxx为 序列号，从0001开 始，排满9999后重 新循环 String 18 M 2 ResultCode 结果标识 0：正确 1：错误 integer 4 M 　SP业务能力信息同步接口 　 　接口描述 　 VAC从PRM系统获取SP的业务能力信息。 　发起方系统 　 PRM系统（Webservice客户端）。 　接收方系统 　 VAC（Webservice服务器端）。 　接口协议 　 PRM与VAC之间的业务能力信息同步接口采用下列实现方式： 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 29 1．Web Service方式：PRM通过Web Service方式将业务能力信息实时地同步给VAC。 1． 2．业务能力签约策略信息：业务能力签约主要指 SP 能够基于哪些业务能力提供增值 业务、以及使用该业务能力情况，由VAC将其配置到业务系统，由业务系统控制；一 个SP对于一个业务能力仅可以申请一个 SP 业务能力签约 。运营商自己做自营SP也 需要进行业务能力签约。 同一个SP各种业务能力的接入鉴权帐号及密码相同。 2． 　接口内容 　 　Web Service接口 　 　SP业务能力信息同步请求 　 方向：PRM->VAC 序号 参数名 说明 参数类型 最大长 度 是否必 填 1 RecordSequence ID 流水号，格式为时间戳+序列号： YYYYMMDDHHMMSSxxxx，其中 xxxx 为序列号，从 0001开始，排满 9999 后重新循环 string 18 M 2 updateType 更新类型 1：增加 2：修改 3：删除 integer 1 M 3 SPID SP标识 String 8 M 4 ServiceType 业务类型代码，取值见附录 A 7 String 2 M 5 ServiceCapabil ityStatus 业务能力状态 取值见附录 A 25 String 2 M 6 startDate 签约生效时间 yyyyMMddhhmmss String 14 M 7 endDate 签约失效时间 yyyyMMddhhmmss String 14 M 8 ServiceCapabil ityInfo 业务能力签约信息: SMSCapabilityInfo MMSCapabilityInfo WAPCapabilityInfo StreamingCapabilityInfo Capability Info M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 30 LBSCapabilityInfo DownloadCapabilityInfo IVRCapabilityInfo 　业务信息同步响应（ServiceCapabilityInfoRsp） 　 方向：VAC －> PRM 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号，格式为时 间 戳 +序 列 号 ： YYYYMMDDHHMMSSx xxx，其中 xxxx 为 序列号，从 0001 开始，排满 9999 后重新循环 String 18 M 2 ResultCode 结果标识 0：正确 1：错误 integer 4 M 　业务能力签约结构 　 　业务能力签约信息(CapabilityInfo) 　  SMS业务签约信息(SMSCapabilityInfo)，允许一个在信SP有多个接入号,系统可多 次调用此接口传送 序号 参数名 说明 参数类型 最大长度 是否必填 1 account SP登陆网关帐号 string 10 M 2 password SP登陆网关密码 string 10 M 3 SPIP SP 服务端的 IP地址 string 15 M 4 SP_Port SP服务端的端口 string 6 M 5 accessNo SP接入号 string 12 M 6 accountPriorit y 帐号优先级别属性： 1：最高 2：高 integer 1 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 31 3：中 4：低 7 flow 最大流量，（单位为：条/秒）， 取值从 0到 4294967296 integer 4 M 8 NEWaccessNo 修改后 SP接入号，如果为空， 表示不修改；updateType为 1、 3时，本字段填空 string 12 O 7 flow 最大流量，（单位为：条/秒） String 10 M 9 spRevId 当 SP提供回调接口时，分配的 回调用户名 string 20 O 10 spRevPassword 当 SP提供回调接口时，分配的 回调密码 string 20 O 11 SMSURL 回调地址，用于短信上行短接 入码的情况 string 255 O 12 spStatusUrl 状态通知回调地址 string 255 O  MMS业务签约信息(MMSCapabilityInfo) 序号 参数名 说明 参数类型 最大长 度 是否必 填 1 accessNo SP接入号 string 12 M 2 SPIP SP 的 ip 地址 string 15 M 3 URL SP收消息的 URL,(以'http://'开 头的标准 URL) string 200 M 4 account 帐号 string 10 M 5 password 密码 string 10 M 6 auth_type 对 SP的鉴权类型: 0不鉴权; 1只鉴 IP; 2只鉴帐号密码; 3-IP与帐号密码都鉴权 integer 1 M 7 flowNum 给 SP提供的最大流量（单位为： 条/秒），取值从 0到 4294967296 integerStr ing 4 M 8 spRevId 当 SP提供回调接口时，分配的回 调用户名 string 20 O 9 spRevPassword 当 SP提供回调接口时，分配的回 调密码 string 20 O 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 32 10 MMSURL 回调地址，用于彩信上行短接入码 的情况 string 255 O 11 spStatusUrl 状态通知回调地址 string 255 O  WAP业务签约信息(WAPCapabilityInfo) 序号 参数名 说明 参数类型 最大长 度 是否必 填 1 account 帐号, pi认证标识 string 10 M 2 password 密码, pi认证密码 string 10 M 3 PIIP pi的 ip地址 string 15 M 4 isInBwl 是否在黑名单中： 0：是 1：否 integer 1 M 5 Url 用户请求的 URL，从头开始的部分 匹配 string 300 O 6 Headers 用户请求访问地址与前一个字段 的 URL匹配时，给此 URL传递的 Header列 表 ， 取 值 为 x-up-calling-line-id/ encryptMDN / user-agent 如果 取值为多个中间采用“；”进行分 割 string 100 O 7 is_group 该 SP是否可以群发 integer 1 M 8 max_receiver 群发时的最大接受者数目，取值从 0到 999999 integerStr ing 64 M 9 max_number 最大条数（每秒条数），取值从 0 到 99999999 integerStr ing 84 M 10 push_priority 该 Push的 优 先 级 High, medium,low 0代表 High 1代表 Medium 2代表 Low integer 1 M 11 push_method Push允许使用的承载方式, 采用 SMS PUSH或 IP方式的 PUSH 0代表 SMS PUSH integer 1 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 33 1代表 IP PUSH 12 confirmed_push 是否允许 Confirmed_Push方式 1标识可以 0标识不允许 integer 1 M 13 unconfirmed_pu sh 是否允许 Unconfirmed_Push 方式 1标识可以 0标识不允许 integer 1 M  LBS业务签约信息(LBSCapabilityInfo) 序号 参数名 说明 参数类型 最大长 度 是否必 填 1 password 密码, pi认证密码 string 10 M 2 SPIP sp的 ip地址 string 10 M 3 coordinate 默认的地理测量数据/坐标系 string 10 M 4 pushAddr SP的默认push的URL,只用于NI-LR string 50 M 5 SPProperty SP的属性值配置默认：“000101” 每个char 代表一个配置内容，具 体对应关系如下： SP 查询权限（ sppurview ） ： char[1] 0：一般权限； 1：超越权限； 其它：保留 默认值：“0”； SP 类型(SpCat) ：char[3] 0:普通SP 1:行业SP string 6 M Commented [z1]: char[2]没有说明 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 34 默认值：“0”； 是否提供立即定位（ SLIRFlag ） ：char[4] 0：不提供 1：提供 默认值：“1”； 是否提供紧急定位（ ELIRFlag ） ：char[5] 0：不提供 1：提供 默认值：“0” ； 是否提供触发定位（ TLIRFlag ） ：char[6] 0:不提供 1:提供 默认值：“1” 6 isInBwl 是否在黑名单中： 0：是 1：否 integer 1 M 7 type 业务类型范围分为三种： 0：经纬度 integer 1 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 35 1：地址 2：地址＋经纬度 8 maxQueryNumber L1请求最大被叫个数,允许SP发送 的 L1定位请求最大被叫个数，取 值从 0到 4294967296 integerStr ing 104 M  Download业务签约信息(DownloadCapabilityInfo) 序号 参数名 说明 参数类型 最大长 度 是否必 填 1 SPIP SP 的 ip 地址 string 15 M 2 nameCN SP名称 string 50 M  Streaming业务签约信息(StreamingCapabilityInfo) 序号 参数名 说明 参数类型 最大长 度 是否必 填 3 FTPIP 默认 FTP服务器 IP地址，流媒体 服务器从 SP服务器上分发或者 pull内容时使用 string 15 M 4 FTPPort 默认 FTP服务器端口，流媒体服务 器从 SP服务器上分发或者 pull内 容时使用 string 6 M 5 account 登录 FTP服务器的帐号，流媒体服 务器从 SP服务器上分发或者 pull 内容时使用 string 10 M 6 password 登录 FTP服务器的密码，流媒体服 务器从 SP服务器上分发或者 pull 内容时使用 string 10 M 7 is_audited 政审信息，取值范围： 0 不政审 1 政审 integer 1 M 8 is_vcdn 是否需要申请，取值范围 0 不申请 1 申请 integer 1 M 9 is_mandatory 是否申请主机托管，取值范围： 0 不托管 integer 1 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 36 1 托管 10 band_width_lim it 最 大 使 用 带 宽 ， 取 值 从 0到 4294967296 integerStr ing 104 M 11 deliver_count_ one_day 每日最大发布次数，取值从 0 到 999999 integerStr ing 46 M 12 user_limit 最大在线用户数，取值从 0 到 99999999 integerStr ing 48 M  IVR业务签约信息(IVRCapabilityInfo) 序号 参数名 说明 参数类型 最大长 度 是否必 填 1 HavePlatform 是否自带 IVR 0:是 1:否 integer 1 M 2 IVRAccNo IVR接入号(HavePlatform为 0 有 效) string 20 O 3 verifyCode 校验码 string 8 M 4 changeOA 是否变换主叫号码 0:不变 1:变 integer 1 M 5 number 变换的号码(SP外呼给用户显示的 号码) string 20 O 　FTP接口 　 使用FTP接口情况： 1）需要定期用全量的方式，对PRM和VAC的SP业务能力信息进行核查。PRM定期生成全量 核查文件，VAC以PRM同步信息为准更新VAC的SP业务能力信息； PRM系统将SP的基本信息资料存放到VAC系统文件服务器的指定目录下，由VAC主动获取。 双方通过文件传输实现接口。文件服务器上设定具有对相应目录存取权限的用户。VAC系统 为BSS分配具有存取文件权限的用户。 文件采用ASCII文本格式，文件体中每条记录的属性值按顺序排列，各属性间使用‘\t’ 分隔，在生成记录时若相应的属性值为空，直接用分隔符隔开，分隔符之间无其他符号。 文件体中一行作为一条记录，各条记录之间用换行符作为分隔并在文件中连续书写。 文件头定长，文件体不定长。 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 37 文件的维护由PRM(FTP Client）系统负责，VAC(FTP Server)采集后对文件进行删除操 作。 PRM系统于定期凌晨1：00进行全量资料同步，VAC于定期凌晨2：00后可进行资料读取。 　文件目录和文件命名 　 PRM系统将请求文件放到VAC指定目录下，VAC将执行结果放回VAC相应目录下,由PRM获取， 获取后删除。批文件名按如下规则命名： yyyymmddhhmm为批文件产生的年月日时分。xxx为省分代码。nnnn 是4位序列号，每天 从“0001”开始，到达”9999”后又从“0001”开始。tttt表示文件类型，rreq表示准实时 请求, rrsp表示准实时请求结果。每一个rreq文件都应该有一个rrsp文件与其对应, areq表 示全量请求，arsp表示全量请求结果。每一个areq文件都应该有一个arsp文件与其对应。 具体对应关系如下： 文件类型 后缀 文件目录() 即时处理（准 实时） 请 求 文 件 ： rreq，响应文 件：rrsp 存放请求文件工作目录：<根目录>/VAC/spsrvcapinfo /request/real 存 放 正 确 回 执 文 件 工 作 目 录 ： <根 目 录 >/VAC/spsrvcapinfo /response/right/real 存放完全错误回执文件工作目录：<根目录>/VAC/ spsrvcapinfo/response/bad，文件级错误代码参见附录 存 放 部 分 错 误 回 执 文 件 工 作 目 录 ： <根 目 录 >/VAC/spsrvcapinfo /response/semiwrong，记录级错误代 码参见附录 全量 请 求 文 件 ： rreq，响应文 件：rrsp 存放请求文件工作目录：<根目录>/VAC/spsrvcapinfo /request/all 存 放 正 确 回 执 文 件 工 作 目 录 ： <根 目 录 >/VAC/spsrvcapinfo/response/right/all 存放完全错误回执文件工作目录：<根目录>/VAC/ spsrvcapinfo/response/bad，文件级错误代码参见附录 存放部分错误回执文件工作目录： <根目录 >/VAC/ 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 38 spsrvcapinfo/response/semiwrong，记录级错误代码参见 附录 　请求文件头(定长) 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 0001开始，排满 9999后重新循环 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR(14) Yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 104 5 记录开始日期时间 CHAR(14) Yyyymmddhhmmss 6 记录结束日期时间 CHAR(14) Yyyymmddhhmmss 7 总记录数 CHAR(10) 8 备用 CHAR(40) 9 换行 CHAR(1) 　回执文件头（定长） 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 从 0001 开始，排满 9999 后重新循环。 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR (14) Yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 902 5 总记录数 CHAR(10) 同请求文件 6 正确处理记录数 CHAR(10) 7 备用 CHAR(40) 文件级错误代码 8 换行 CHAR(1) 　请求文件体（变长） 序号 参数名 说明 参数类型 最大长 度 是否必 填 1 RecordSequence ID 流水号，格式为时间戳+序列号： YYYYMMDDHHMMSSxxxx，其中 xxxx 为序列号，从 0001开始，排满 9999 后重新循环 string 18 M 2 updateType 更新类型 1：增加 2：修改 3：删除 integer 1 M 3 SPID SP标识 String 8 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 39 4 ServiceType 业务类型代码，取值见附录 A 7 String 2 M 5 ServiceCapabil ityStatus 业务能力状态 取值见附录 A 25 String 2 M 6 startDate 签约生效时间 yyyyMMddhhmmss String 14 M 7 endDate 签约失效时间 yyyyMMddhhmmss String 14 M 8 ServiceCapabil ityInfo 业务能力签约信息: SMSCapabilityInfo MMSCapabilityInfo WAPCapabilityInfo StreamingCapabilityInfo LBSCapabilityInfo DownloadCapabilityInfo IVRCapabilityInfo Capability Info M SMSCapabilityInfo等信息同"　业务能力签约结构" PRM每次只发一个业务能力 VAC根据 ServiceType决定下面取哪种业务信息 　回执文件体（变长） 　 对于完全正确和完全错误的回执文件，只有文件头没有文件体；对于记录级错误的回执 文件，在文件体中列出错误的结果代码。 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号，格式为时 间戳+序列号： YYYYMMDDHHMMSSx xxx，其中xxxx为 序列号，从0001开 始，排满9999后重 新循环 String 18 M 2 ResultCode 结果标识 integer 4 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 40 0：正确 1：错误代码 : N: 错误代码 　业务信息同步接口 　 　接口描述 　 VAC从PRM系统获取SP的业务信息。 　发起方系统 　 PRM系统（Webservice客户端）。 　接收方系统 　 VAC（Webservice服务器端）。 　接口协议 　 PRM与VAC之间的业务信息同步接口采用下列两种实现方式： 3．Web Service方式：PRM通过Web Service方式将业务信息实时地同步给VAC。 3． 4．文件方式：PRM通过FTP文件方式将业务信息定时全量同步给VAC。 4． 　接口内容 　 　Web Service接口 　 　业务信息同步请求（ServiceInfoReq） 　 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 41 方向：PRM->VAC 序号 参数名 说明 参数类型 最大长 度 是否必 填 1 RecordSequence ID 流水号，格式为时间戳+序列号： YYYYMMDDHHMMSSxxxx，其中 xxxx 为序列号，从 0001开始，排满 9999 后重新循环 string 18 M 2 UpdateType 更新类型 1：增加 2：修改 3：删除 integer 1 M 3 SPID SP标识 String 8 M 4 SPName SP名称 string 40 M 5 ServiceType 业务类型代码，取值见附录 A。如 果该业务是由多个业务能力组合 而成，则每个业务能力之间用“,” 分隔。最后一个业务能力作为该组 合业务的计费点。 string 30 M 6 GroupService 业务打包标识(保留字段) 0：打包业务，1：非打包业务 integer 1 O 7 ServiceCompose 如果该业务是由多个业务打包而 成，该字段为打包业务所包含的 ServiceID，可以由多个业务打包 而成，每个 ServiceID 之间用“,” 分隔(保留字段) string 55 O 8 ServiceID 业务代码 string 10 M 9 ServiceName 业务名称 string 40 M 10 ServiceCredit 业务信任等级: 0:普通(正常需要定购) 1:高信用度(无定购关系，可使用， 不收费) integer 1 M 11 ServiceStatus 业务状态 取值见附录 A integer 2 M 12 IntroURL 业务介绍信息 string 255 O 13 wapintropic Wap介绍图片 string 20 O 14 servicecolumn 业务类别,编码方式见附件 A String 2 M 15 Enterurl 业务入口 URL(wap) 业务的入口 URL，一般为业务首页 面，供业务上线时链接使用 String 30500 O 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 42 16 Confirmurl 确认 URL，多个确认 url以“，”分 隔。 表示访问该 URL时，如果用户未定 制该 URL对应的业务，则平台系统 会弹出计计费提示信息和订购方 式供用户查看和选择 String 500 O 17 Priceurl 计费 URL，多个确认 url以“，”分 隔。 收费服务标识对应收费 URL，如果 用户访问此 URL，平台系统结合用 户对此业务的订购策略进行对应 计费处理 String 500 O 18 freeurl 免费 URL String 30500 O 19 NeedConfmBack 标识业务是否需要返回确认消息 （wap） 0：是 1：不是 integer 1 O 20 CheckType 监控类型：(保留字段) 0：不监控 1：实时比对监控 2：事后监控 integer 1 M 21 EffDate 生效时间 String 14 O 22 ExpDate 失效时间 String 14 O 23 WAPServiceType Wap业务类型: 1：代理方式 2：直通方式 3：重定向 4：自营新闻 5：自营铃声 6：自营音乐 integer 2 O 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 43 7：自营视频 8：自营游戏 9：自营图片 24 Resv1 系统保留 1 String 10 O 25 Resv2 系统保留 2 string 10 O 　业务信息同步响应（ServiceInfoRsp） 　 方向：VAC －> PRM 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号，格式为时 间戳+序列号： YYYYMMDDHHMMSSx xxx，其中xxxx为 序列号，从0001开 始，排满9999后重 新循环 string 18 M 2 ResultCode 结果标识 0：正确 1：错误 integer 4 M 　FTP接口 　 使用FTP接口情况： 1）需要定期用全量的方式，对PRM和VAC的业务信息进行核查。PRM每天生成全量核查文 件，VAC以PRM同步信息为准更新VAC的业务信息； PRM系统将SP的基本信息资料存放到VAC统中文件服务器的指定目录下，由VAC主动获取。 双方通过文件传输实现接口。文件服务器上设定具有对相应目录存取权限的用户。VAC系统 为PRM分配具有存取文件权限的用户。 文件采用ASCII文本格式，文件体中每条记录的属性值按顺序排列，各属性间使用‘\t’ 分隔，在生成记录时若相应的属性值为空，直接用分隔符隔开，分隔符之间无其他符号。 文件体中一行作为一条记录，各条记录之间用换行符作为分隔并在文件中连续书写。 文件头定长，文件体不定长。 文件的维护由PRM（FTP Client）系统负责，VAC（FTP Server）采集后对文件进行删除 操作。 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 44 PRM系统于定期凌晨1：00进行全量资料同步，VAC于定期凌晨2：00后可进行资料读取。 　文件目录和文件命名 　 PRM系统将请求文件放到VAC指定目录下，VAC将执行结果放回VAC相应目录下。批文件名 按如下规则命名： yyyymmddhhmm为批文件产生的年月日时分。xxx为省分代码。nnnn 是4位序列号，每天 从“0001”开始，到达”9999”后又从“0001”开始。tttt表示文件类型，rreq表示准实时 请求, rrsp表示准实时请求结果。每一个rreq文件都应该有一个rrsp文件与其对应, areq表 示全量请求，arsp表示全量请求结果。每一个areq文件都应该有一个arsp文件与其对应。 具体对应关系如下： 文件类型 后缀 文件目录() 即时处理（准实 时） 请求文件：rreq， 响应文件：rrsp 存 放 请 求 文 件 工 作 目 录 ： <根 目 录 >/VAC/srvinfo/request /real 存放正确回执文件工作目录：<根目录>/VAC/srvinfo /response/right/real 存放完全错误回执文件工作目录： <根目录 >/VAC/srvinfo /response/bad，文件级错误代码参见附 录 存放部分错误回执文件工作目录：<根目录>/VAC/srvinfo /response/semiwrong，记录级错误代码参见附录 全量 请求文件：areq， 响应文件：arsp 存 放 请 求 文 件 工 作 目 录 ： <根 目 录 >/VAC/srvinfo/request /all 存放正确回执文件工作目录：<根目录>/VAC/srvinfo /response/right/all 存放完全错误回执文件工作目录： <根目录 >/VAC/srvinfo /response/bad，文件级错误代码参见附 录 存放部分错误回执文件工作目录：<根目录>/VAC/srvinfo /response/semiwrong，记录级错误代码参见附录 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 45 　请求文件头（定长） 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 0001 开始，排满 9999 后重新循环 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR(14) yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 104 5 记录开始日期时间 CHAR(14) yyyymmddhhmmss 6 记录结束日期时间 CHAR(14) yyyymmddhhmmss 7 总记录数 CHAR(10) 8 备用 CHAR(40) 9 换行 CHAR(1) 　回执文件头（定长） 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 0001 开始，排满 9999 后重新循环 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR(14) yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 902 5 总记录数 CHAR(10) 6 正确处理记录数 CHAR(10) 7 备用 CHAR(40) 文件级错误代码 8 换行 CHAR(1) 　请求文件体（变长） 序号 参数名 说明 参数类型 最大长 度 是否必 填 1 RecordSequence ID 流水号，格式为时间戳+序列号： YYYYMMDDHHMMSSxxxx，其中 xxxx 为序列号，从 0001开始，排满 9999 后重新循环 string 18 M 2 UpdateType 更新类型 1：增加 2：修改 3：删除 integer 1 M 3 SPID SP标识 String 8 M 4 SPName SP名称 string 40 M 5 ServiceType 业务类型代码，取值见附录 A。如 果该业务是由多个业务能力组合 而成，则每个业务能力之间用“,” 分隔。最后一个业务能力作为该组 string 30 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 46 合业务的计费点。 6 GroupService 业务打包标识(保留字段) 0：打包业务，1：非打包业务 integer 1 O 7 ServiceCompose 如果该业务是由多个业务打包而 成，该字段为打包业务所包含的 ServiceID，可以由多个业务打包 而成，每个 ServiceID 之间用“,” 分隔(保留字段) string 55 O 8 ServiceID 业务代码 string 10 M 9 ServiceName 业务名称 string 40 M 10 ServiceCredit 业务信任等级: 0:普通(正常需要定购) 1:高信用度(无定购关系，可使用， 不收费) integer 1 M 11 ServiceStatus 业务状态 取值见附录 A integer 2 M 12 IntroURL 业务介绍信息 string 255 O 13 wapintropic Wap介绍图片 string 20 O 14 servicecolumn 业务类别,编码方式见附件 A String 2 M 15 Enterurl 业务入口 URL(wap) 业务的入口 URL，一般为业务首页 面，供业务上线时链接使用 String 30500 O 16 Confirmurl 确认 URL，多个确认 url以“，”分 隔。 表示访问该 URL时，如果用户未定 制该 URL对应的业务，则平台系统 会弹出计计费提示信息和订购方 式供用户查看和选择 String 500 O 17 Priceurl 计费 URL，多个确认 url以“，”分 隔。 收费服务标识对应收费 URL，如果 用户访问此 URL，平台系统结合用 户对此业务的订购策略进行对应 计费处理 String 500 O 18 freeurl 免费 URL String 30500 O 19 NeedConfmBack 标识业务是否需要返回确认消息 integer 1 O 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 47 （wap） 0：是 1：不是 20 CheckType 监控类型：(保留字段) 0：不监控 1：实时比对监控 2：事后监控 integer 1 M 21 EffDate 生效时间 String 14 O 22 ExpDate 失效时间 String 14 O 23 WAPServiceType Wap业务类型: 1：代理方式 2：直通方式 3：重定向 4：自营新闻 5：自营铃声 6：自营音乐 7：自营视频 8：自营游戏 9：自营图片 integer 2 O 24 Resv1 系统保留 1 String 10 O 25 Resv2 系统保留 2 string 10 O 　回执文件体（变长） 　 对于完全正确和完全错误的回执文件，只有文件头没有文件体；对于记录级错误的回执 文件，在文件体中列出错误的结果代码。 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 48 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号，格式为时 间戳+序列号： YYYYMMDDHHMMSSx xxx，其中xxxx为 序列号，从0001开 始，排满9999后重 新循环 String 18 M 2 ResultCode 结果标识 0：正确 1：错误 integer 4 M 5　VAC与 CRM系统的接口要求 5　 　产品信息同步接口 　 　接口描述 　 VAC从CRM系统获取SP的产品信息。 对于同一产品有多个构成，需要一条一条记录同步给VAC 　发起方系统 　 CRM系统（Webservice客户端）。 　接收方系统 　 VAC（Webservice服务器端）。 　接口协议 　 CRM与VAC之间的产品信息同步接口采用下列两种实现方式： 1．Web Service方式：CRM通过Web Service方式将产品信息实时地同步给VAC。 1． 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 49 2．文件方式：CRM通过FTP文件方式将产品信息定时全量同步给VAC。 2． 　接口内容 　 　Web Service接口 　 　产品信息同步请求（ProductInfoReq） 　 方向：CRM －> VAC 序号 参数名 说明 参数类型 最大长 度 是否必 填 1 RecordSequence ID 流水号，格式为时间 戳+序列号： YYYYMMDDHHMMSSxxxx， 其中 xxxx为序列号， 从 0001开始，排满 9999后重新循环 String 18 M 2 UpdateType 更新类型 1：增加 2：修改 3： 删除 integer 1 M 3 ProductID CRM 产品 ID String 8 M 4 SPEC_ProductID CRM构成产品标识 String 12 M 5 SP_ProductID PRM产生的合作伙伴 产品 ID String 12 M 6 ServiceID 产品对应的业务标识， 一个产品对应一个 ServiceID String 10 M 7 SPID SP标识 String 8 M 8 ProductStatus 产品状态 取值见附录 A Integer 2 M 9 ProductType 产品类型 1 定购类 2 有点播关系的点播 类 3 无点播关系的点播 Integer 1 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 50 类 10 ProductName 产品名称 String 255 O 11 confirm 订购或者点播时是否 要二次确认资费明示 0:确认，1:不确认 integer 1 O 12 presenter 是否可赠送 0:不可赠送 1:可赠送 integer 1 M 13 ConfirmPrompt 二次确认提示语 String 400 O 14 SuccessPrompt 订购成功提示语 String 400 O 15 CancelPrompt 退定成功提示语 String 400 O 16 popularizestar t 推广期开始时间 String 14 O 17 popularizestop 推广期结束时间 String 14 O 18 FreeUseFlag 免费体验标识 0：不支持免费体验 1：按次免费体验 2：按天免费体验 integer 1 M 19 FreeUseTime 免费体验次数/时长， 如果FreeFlag取值为： 0 则该字段不填 1 则标识免费体验次 数 2则标识免费体验天 数 integer 2 O 20 chargeDes 资费描述 String 400 O 21 Billing_Id 计费规则 ID，合法字 符为数字 string 20 O 22 Discount_des 优惠描述 String 400 O 23 DiscountId 优惠规则 ID(目前只 同步一种优惠规则) string 20 O 24 NeedConfm 是否需要 checkPriceConfirm 消息 integer 1 O 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 51 0：是 1：不是 25 MaxUseTimes 最大使用次数(保留字 段) integer 2 OM 26 MaxUseTime 最大使用时长（秒）(保 留字段) integer 4 O 27 sendnum 点播 MO对应最大 MT 条数(sms/mms) integer 2 O 28 ordercommand 定制指令 String 20 O 29 orderCmdmatch 定制命令字匹配 0模糊匹配 1精确匹配 integer 1 O 30 orderAcc 定制业务接入码 String 20 O 31 orderAccmatch 定制接入号匹配 0模糊匹配(左向最大 匹配) 1精确匹配 integer 1 O 32 cancelcommand 退订指令 string 20 O 33 cancelCmdmatch 退订命令字匹配 0模糊匹配 1精确匹配 integer 1 O 34 cancelAcc 退订业务接入码 String 20 O 35 cancelAccmatch 退订接入号匹配 0模糊匹配 1精确匹配 Integer 1 O 36 requestcmd 点播指令 String 20 O 37 requestCmdmatc h 点播命令字匹配 0模糊匹配 1精确匹配 Integer 1 O 38 requestAcc 点播业务接入码 String 20 O 39 requestAccmatc 点播接入号匹配 integer 1 O 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 52 h 0模糊匹配 1精确匹配 40 EffDate 生效时间 String 14 O 41 ExpDate 失效时间 String 14 O 42 VACSub 是否可以在 VAC上单 独定购(合作伙伴产品 能否点播) 0 不可以单独定购/退 定 1 可以单独定购/退定 2 后付费(含 OCS)用 户不可以单独定购/退 定 3 后付费(含 OCS)用 户可以单独定购/退定 4 SCP用户不可以单 独定购/退定 5 SCP用户可以单独 定购/退定 integer 1 M 43 NotifyType 定购/点播关系是否通 知 SP 0 不通知 1 通知 SP前定购成功, 如果 SP失败，VAC不 回滚 2 收到 SP成功定购 后，VAC生成定购关系， 如果 SP返回失败，VAC 不生成定购关系 integer 1 M 44 ProductCity 产品服务的地市范围， 地市代码固定 3位， 中间由“，”分隔，如 string 256 O 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 53 此字段为空表示服务 全省，取值见附录 A 4445 Resv1 保留字段 String 40 O 4546 Resv2 保留字段 String 40 O 　产品信息同步响应（ProductInfoRsp） 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号，格式为时 间戳+序列号： YYYYMMDDHHMMSSx xxx，其中xxxx为 序列号，从0001开 始，排满9999后重 新循环 String 10 M 2 ResultCode 结果标识 0：正确 1：错误 integer 4 M 　FTP接口 　 使用FTP接口情况： 需要定期用全量的方式，对CRM和VAC的产品信息进行核查。CRM定期生成全量核查文件， VAC以CRM同步信息为准更新VAC的产品信息； CRM系统将SP的基本信息资料存放到VAC系统中文件服务器的指定目录下，由VAC主动获 取。双方通过文件传输实现接口。文件服务器上设定具有对相应目录存取权限的用户。VAC 系统为CRM分配具有存取文件权限的用户。 文件采用ASCII文本格式，文件体中每条记录的属性值按顺序排列，各属性间使用‘\t’ 分隔，在生成记录时若相应的属性值为空，直接用分隔符隔开，分隔符之间无其他符号。 文件体中一行作为一条记录，各条记录之间用换行符作为分隔并在文件中连续书写。 文件头定长，文件体不定长。 文件的维护由CRM（FTP Client）系统负责，VAC（FTP Server）采集后对文件进行删除 操作。 CRM系统于定期凌晨1：00进行全量资料同步，VAC于定期凌晨2：00后可进行资料读取。 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 54 　文件目录和文件命名 　 CRM系统将请求文件放到VAC指定目录下，VAC将执行结果放回VAC相应目录下由CRM获取。 批文件名按如下规则命名： yyyymmddhhmm为批文件产生的年月日时分。xxx为省分代码。nnnn 是4位序列号，每天 从“0001”开始，到达”9999”后又从“0001”开始。tttt表示文件类型，rreq表示准实时 请求, rrsp表示准实时请求结果。每一个rreq文件都应该有一个rrsp文件与其对应, areq表 示全量请求，arsp表示全量请求结果。每一个areq文件都应该有一个arsp文件与其对应。 具体对应关系如下： 文件类型 后缀 文件目录() 即时处理（准实 时） 请求文件：rreq， 响应文件：rrsp 存放请求文件工作目录：<根目录>/VAC/ proinfo /request /real 存放正确回执文件工作目录： <根目录 >/VAC/ proinfo /response/right/real 存放完全错误回执文件工作目录：<根目录>/VAC/ proinfo /response/bad，文件级错误代码参见附录 存放部分错误回执文件工作目录： <根目录 >/VAC/ proinfo /response/semiwrong，记录级错误代码参见附 录 全量 请求文件：areq， 响应文件：arsp 存放请求文件工作目录：<根目录>/VAC/ proinfo /request /all 存放正确回执文件工作目录： <根目录 >/VAC/ proinfo /response/right/all 存放完全错误回执文件工作目录：<根目录>/VAC/ proinfo /response/bad，文件级错误代码参见附录 存放部分错误回执文件工作目录： <根目录 >/VAC/ proinfo /response/semiwrong，记录级错误代码参见附 录 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 55 　请求文件头（定长） 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 0001 开始，排满 9999 后重新循环 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR(14) yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 104 5 记录开始日期时间 CHAR(14) yyyymmddhhmmss 6 记录结束日期时间 CHAR(14) yyyymmddhhmmss 7 总记录数 CHAR(10) 8 备用 CHAR(40) 9 换行 CHAR(1) 　回执文件头（定长） 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 从 0001 开始，排满 9999 后重新循环。 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR (14) Yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 902 5 总记录数 CHAR(10) 6 正确处理记录数 CHAR(10) 7 备用 CHAR(40) 文件级错误代码 8 换行 CHAR(1) 　请求文件体（变长） 序号 参数名 说明 参数类型 最大长 度 是否必 填 1 RecordSequence ID 流水号，格式为时间 戳+序列号： YYYYMMDDHHMMSSxxxx， 其中 xxxx为序列号， 从 0001开始，排满 9999后重新循环 String 18 M 2 UpdateType 更新类型 1：增加 2：修改 3： 删除 integer 1 M 3 ProductID CRM 产品 ID String 8 M 4 SPEC_ProductID CRM构成产品标识 String 12 M 5 SP_ProductID PRM产生的合作伙伴 产品 ID String 12 M 6 ServiceID 产品对应的业务标识， String 10 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 56 一个产品对应一个 ServiceID 7 SPID SP标识 String 8 M 8 ProductStatus 产品状态 取值见附录 A Integer 2 M 9 ProductType 产品类型 1 定购类 2 有点播关系的点播 类 3 无点播关系的点播 类 Integer 1 M 10 ProductName 产品名称 String 255 O 11 confirm 订购或者点播时是否 要二次确认资费明示 0:确认，1:不确认 integer 1 O 12 presenter 是否可赠送 0:不可赠送 1:可赠送 integer 1 M 13 ConfirmPrompt 二次确认提示语 String 400 O 14 SuccessPrompt 订购成功提示语 String 400 O 15 CancelPrompt 退定成功提示语 String 400 O 16 popularizestar t 推广期开始时间 String 14 O 17 popularizestop 推广期结束时间 String 14 O 18 FreeUseFlag 免费体验标识 0：不支持免费体验 1：按次免费体验 2：按天免费体验 integer 1 M 19 FreeUseTime 免费体验次数/时长， 如果FreeFlag取值为： 0 则该字段不填 integer 2 O 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 57 1 则标识免费体验次 数 2则标识免费体验天 数 20 chargeDes 资费描述 String 400 O 21 BillingId 计费规则 ID，合法字 符为数字 string 20 O 22 Discount_des 优惠描述 String 400 O 23 DiscountId 优惠规则 ID(目前只 同步一种优惠规则) string 20 O 24 NeedConfm 是否需要 checkPriceConfirm 消息 0：是 1：不是 integer 1 O 25 MaxUseTimes 最大使用次数(保留字 段) integer 2 M 26 MaxUseTime 最大使用时长（秒）(保 留字段) integer 4 O 27 sendnum 点播 MO对应最大 MT 条数(sms/mms) integer 2 O 28 ordercommand 定制指令 String 20 O 29 orderCmdmatch 定制命令字匹配 0模糊匹配 1精确匹配 integer 1 O 30 orderAcc 定制业务接入码 String 20 O 31 orderAccmatch 定制接入号匹配 0模糊匹配(左向最大 匹配) 1精确匹配 integer 1 O 32 cancelcommand 退订指令 string 20 O 33 cancelCmdmatch 退订命令字匹配 0模糊匹配 1精确匹配 integer 1 O 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 58 34 cancelAcc 退订业务接入码 String 20 O 35 cancelAccmatch 退订接入号匹配 0模糊匹配 1精确匹配 Integer 1 O 36 requestcmd 点播指令 String 20 O 37 requestCmdmatc h 点播命令字匹配 0模糊匹配 1精确匹配 Integer 1 O 38 requestAcc 点播业务接入码 String 20 O 39 requestAccmatc h 点播接入号匹配 0模糊匹配 1精确匹配 integer 1 O 40 EffDate 生效时间 String 14 O 41 ExpDate 失效时间 String 14 O 42 VACSub 是否可以在 VAC上单 独定购(合作伙伴产品 能否点播) 0 不可以单独定购/退 定 1 可以单独定购/退定 2 后付费用户不可以 单独定购/退定 3 后付费用户可以单 独定购/退定 4 SCP用户不可以单 独定购/退定 5 SCP用户可以单独 定购/退定 integer 1 M 43 NotifyType 定购/点播关系是否通 知 SP integer 1 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 59 0 不通知 1 通知 SP前定购成功, 如果 SP失败，VAC不 回滚 2 收到 SP成功定购 后，VAC生成定购关系， 如果 SP返回失败，VAC 不生成定购关系 44 ProductCity 产品服务的地市范围， 地市代码固定 3位， 中间由“，”分隔，如 此字段为空表示服务 全省，取值见附录 A string 256 O 4445 Resv1 保留字段 String 40 O 4546 Resv2 保留字段 String 40 O 　回执文件体（变长） 　 对于完全正确和完全错误的回执文件，只有文件头没有文件体；对于记录级错误的回执 文件，在文件体中列出错误的结果代码。 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号，格式为时 间戳+序列号： YYYYMMDDHHMMSSx xxx，其中xxxx为 序列号，从0001开 始，排满9999后重 新循环 string 10 M 2 ResultCode 结果标识 0：正确 1：错误 integer 4 M 　用户开户接口(用户级业务能力) 　 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 60 　接口描述 　 CRM系统向VAC发送增值业务用户开户请求，等待VAC将用户开户信息写入数据库后向CRM 系统返回开户成功或失败的信息。 　发起方系统 　 CRM系统（Webservice客户端）。 　接收方系统 　 VAC（Webservice服务器端）。 　接口协议 　 该接口采用Web Service方式：CRM系统通过Web Service方式将用户开户请求信息发送 给VAC，请求VAC进行用户开户的确认。VAC通过Web Service方式将处理结果返回给CRM系统。 　接口内容 　 　用户开户请求（UserRegistReq） 　 方向：CRM－>VAC 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号，格式为时间 戳+序列号： YYYYMMDDHHMMSSxxxx， 其中 xxxx为序列号， 从 0001开始，排满 9999后重新循环 string 18 M 2 MDN 开户MDN号(不带86) string 20 M 3 operateType 0:开通 1:暂停 2:恢复 3:关闭 4：销户关闭 integer 1 M 4 ServiceCapabilit yType 用户开户业务类型,见 VAC与BSS接口规范附 integer 2 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 61 录A 79 7 EffectiveDate 生效时间 格式： yyyyMMddhhmmss 如果为-1表示立即生 效 string 14 M 8 ExpireDate 失效时间 格式： yyyyMMddhhmmss 如果为-1表示永不失 效 string 14 O 备注： 1. 当用户销户时，CRM发送本消息给VAC，operateType＝4；VAC收到后关闭用户的所有 业务能力 1. 　用户开户响应（UserRegistRsp） 　 方向：VAC－>CRM 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号，格式为时间戳+ 序列号： YYYYMMDDHHMMSSxxxx，其 中xxxx为序列号，从0001 开始，排满9999后重新循 环 string 18 M 2 ResultCode 0：成功 1：失败 2：用户不存在 3：用户状态不正确 integer 4 M 　UserRegistReq用户开户请求 FTP 接口 　 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 62 使用FTP接口情况： 对于批量开户的情况，需要用文件接口进行开户的同步。文件结构和处理同上 CRM系统将开户信息资料存放到VAC系统中文件服务器的指定目录下。CRM主动上传VAC系 统中。文件服务器上设定具有对相应目录存取权限的用户。VAC系统为CRM分配具有存取文件 权限的用户。 文件采用ASCII文本格式，文件体中每条记录的属性值按顺序排列，各属性间使用‘\t’ 分隔，在生成记录时若相应的属性值为空，直接用分隔符隔开，分隔符之间无其他符号。 文件体中一行作为一条记录，各条记录之间用换行符作为分隔并在文件中连续书写。 文件头定长，文件体不定长。 每个文件大小可定义，每个文件不超过10万条记录 文件的维护由CRM系统负责，VAC采集后对文件进行删除操作。 　文件目录和文件命名 　 CRM系统将请求文件放到VAC指定目录下，VAC将执行结果放回VAC相应目录下,由CRM获取。 批文件名按如下规则命名： yyyymmddhhmm为批文件产生的年月日时分。xxx为省分代码。nnnn 是4位序列号，每天 从“0001”开始，到达”9999”后又从“0001”开始。tttt表示文件类型，rreq表示准实时 请求, rrsp表示准实时请求结果。每一个rreq文件都应该有一个rrsp文件与其对应, areq表 示全量请求，arsp表示全量请求结果。每一个areq文件都应该有一个arsp文件与其对应。 具体对应关系如下： 文件类型 后缀 文件目录() 即时处理（准 实时） 请求文件：rreq， 响应文件：rrsp 存 放 请 求 文 件 工 作 目 录 ： <根 目 录 >/VAC/userRegist/request /real 存 放 正 确 回 执 文 件 工 作 目 录 ： <根 目 录 >/VAC/userRegist /response VACVAC 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 63 　请求文件头（定长） 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 0001 开始，排满 9999 后重新循环 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR(14) yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 104 5 记录开始日期时间 CHAR(14) yyyymmddhhmmss 6 记录结束日期时间 CHAR(14) yyyymmddhhmmss 7 总记录数 CHAR(10) 8 备用 CHAR(40) 9 换行 CHAR(1) 　回执文件头（定长） 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 从 0001 开始，排满 9999 后重新循环。 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR (14) Yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 902 5 总记录数 CHAR(10) 6 正确处理记录数 CHAR(10) 7 备用 CHAR(40) 文件级错误代码 8 换行 CHAR(1) 　请求文件体（变长） 　 方向：CRM－>VAC 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号，格式为时间 戳+序列号： YYYYMMDDHHMMSSxxxx， 其中 xxxx为序列号， 从 0001开始，排满 9999后重新循环 string 18 M 2 MDN 开户MDN号(不带86) string 20 M 3 operateType 0:开通 1:暂停 integer 1 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 64 2:恢复 3:关闭 4：销户关闭 4 ServiceCapabilit yType 用户开户业务类型,见 VAC与BSS接口规范附 录A 7附录A 9 integer 2 M 7 EffectiveDate 生效时间 格式： yyyyMMddhhmmss 如果为-1表示立即生 效 string 14 M 8 ExpireDate 失效时间 格式： yyyyMMddhhmmss 如果为-1表示永不失 效 string 14 O 　回执文件体（变长） 　 方向：VAC－>CRM 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号，格式为时间 戳+序列号： YYYYMMDDHHMMSSxxxx， 其中 xxxx为序列号， 从 0001开始，排满 9999后重新循环 CHAR 10 M 2 ResultCode 0：成功 1:炫铃失败 2:在线失败 3:SP同步失败 CHAR 14 M 3 \n 换行 CHAR 1 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 65 　用户号段信息同步接口 　 　接口描述 　 VAC需要获得用户的号段信息，用来进行业务请求的路由。用户号段信息由CRM统一配置， 同步给VAC。 CRM系统将本省用户号段信息存放到VAC系统中文件服务器的指定目录下，双方通过文件 传输实现接口。文件服务器上设定具有对相应目录存取权限的用户。VAC系统为CRM分配具有 存取文件权限的用户。 文件采用ASCII文本格式，文件体中每条记录的属性值按顺序排列，各属性间使用‘\t’ 分隔，在生成记录时若相应的属性值为空，直接用分隔符隔开，分隔符之间无其他符号。 文件体中一行作为一条记录，各条记录之间用换行符作为分隔并在文件中连续书写。 文件头定长，文件体不定长。 文件的维护由CRM系统负责。 CRM系统于定期凌晨1：00进行资料同步，VAC于定期凌晨2：00后可进行资料读取。 　发起发系统 　 CRM系统 　接收方系统 　 VAC 　接口协议 　 FTP文件方式 　接口内容 　 　文件目录 　 CRM系统将请求文件放到VAC指定目录下，VAC将执行结果放回VAC相应目录下。 存放请求文件工作目录：<根目录>/<VAC>/<NumToGWMapInfo>/request 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 66 存放正确回执文件工作目录：<根目录>/<VAC>/<NumToGWMapInfo>/response/right 存放完全错误回执文件工作目录：<根目录>/<VAC>/<NumToGWMapInfo>/response/bad， 文件级错误代码参见附录 存 放 部 分 错 误 回 执 文 件 工 作 目 录 ： <根 目 录 >/<VAC>/<NumToGWMapInfo>/response/semiwrong，记录级错误代码参见附录A。 　文件命名 　 批文件名按如下规则命名： yyyymmddhhmm为批文件产生的年月日时分。xxx为省分代码。nnnn 是4位序列号，每天 从“0001”开始，到达”9999”后又从“0001”开始。ttt表示文件类型，req表示请求，res 表示请求结果。每一个req文件都应该有一个res文件与其对应。 　请求文件头（定长） 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 0001开始，排满 9999后重新循环 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR(14) Yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 104 5 记录开始日期时间 CHAR(14) Yyyymmddhhmmss 6 记录结束日期时间 CHAR(14) Yyyymmddhhmmss 7 总记录数 CHAR(10) 8 备用 CHAR(40) 9 换行 CHAR(1) 　回执文件头（定长） 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 从 0001 开始，排满 9999 后重新循环。 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR (14) Yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 902 5 总记录数 CHAR(10) 6 正确处理记录数 CHAR(10) 7 备用 CHAR(40) 文件级错误代码 8 换行 CHAR(1) 　请求文件体 序 字段名 描述 字 段 类 最 大 是 否 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 67 号 型 长度 必填 1 RecordSequenceID 流水号，格式为时间戳+序列号： YYYYMMDDHHMMSSxxxx， 其 中 xxxx为序列号，从 0001开始， 排满 9999后重新循环 CHAR 18 M 2 BeginNumber 起始号段：用户标识码(不带 86) CHAR 16 M 3 EndNumber 结束号段：用户标识码(不带 86),必须是全长，如手机 11位 CHAR 16 M 4 CUINSTNUM 联通地市代码，见附录 A CHAR 3 M 5 ServiceType 业务类型,填00表示SCP不区分 业务类型 CHAR 2 O 6 SCP 号段归属 SCP编号 CHAR 10 O 7 \n 换行 CHAR 1 M CRM只给VAC传递本省号段信息 每次全量同步 号段表是全省号段信息，主要有两个作用，1.号段归属地市，2.号段归属SCP设备编号， 但要注意的是，此号码可能已转OCS,所以要先从用户属性表看此号码是否归属OCS,后付费号 段此字段无意义 　回执文件体（变长） 　 对于完全正确和完全错误的回执文件，只有文件头没有文件体；对于记录级错误的回执 文件，在文件体中列出错误的结果代码。 　用户信息同步接口 　 　Socket接口 　 VAC需要获得相关用户资料，目前主要包括MDN、IMSI、用户类型、用户状态等，因此需 要在CRM与VAC之间存在用户信息同步接口，以保证业务完整性、准确性。 　发起方系统 　 CRM系统。 　接收方系统 　 Commented [xl2]: 如果是后付费号段，此字段无意义 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 68 VAC。 　接口方式 　 CRM与VAC之间的用户信息同步接口采用下列两种实现方式： 1．Socket方式：CRM通过Socket方式将用户的状态信息实时地同步给VAC。 1． 2．文件方式：CRM通过FTP文件方式将用户信息定期全量同步给VAC做核对。 2．  接口数据要求对后付付费和预付费实时、全量都给出全部状态的数据。全量 同步中，CRM系统给出的是倒出数据那个时刻，数据库中所有用户的状态信息。 但因为智能网系统不保留已删除的用户号码，故全量中预付费用户没有当月 变成“删除”状态的用户数据。但是，综合营帐只要号码没有被回收，数据 库中就会一直保留处于“销户”状态的用户数据，故每次全量中，后付费用 户都会同步当月（甚至前几个月）变成“销户”状态的用户数据，直到该号 码被回收。  　连接方式 　 各省 CRM与 VAC之间采用长连接方式，CRM作为客户端，VAC作为服务器端，由客户端 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 69 主动发起建立连接并通过连接保持消息包，维护连接。 当客户端要发送命令时，主动向服务器端建立连接，然后向服务器端发送命令，并接收 应答；服务器端从客户端接收命令，返回应答。 客户端可以同时向服务器端建立多个连接（暂定 8 条，可配置）；命令及其应答之间的 时间间隔最大不能超过 3秒（默认，可配置），超时需要重发（重发 3 次，可配置）；双方在 没有消息传递时发送消息维持包保持通讯状态。 　包头流水号规则 　 各省 CRM与 VAC之间传输的每一条命令都有一个流水号，流水号由发起方产生并唯一标 记一条命令；也就是说，各省 CRM与 VAC中任何两个命令的流水号都不相同。需要注意的是， 一条命令在发送过程中重试的不同副本，应视为一条命令，使用相同的流水号。 流水号由 0开始，循环进位，直到进位满了之后再清零，重新开始计数。接收方在返回 应答时，应答的流水号必须和相对应的命令的流水号相同。 　消息定义 　 接口协议中定义的消息由消息头和消息体组成。 项目 说明 消息头 消息头部分 消息体 消息体部分 　数据类型 　 消息中利用到如下数据类型 类型 说明 Integer 无符号整数 Text 定长字符串，左对齐存储，空余位置补“\0” 　消息头 字段 类型 长度（字节）定长 说明 Message Length Integer 4 消息的总长度(字节) Command ID Integer 4 命令 ID Sequence Number Integer 4 流水号 Commented [xl3]: 整形应该是 4 位 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 70 其中 Command ID定义如下： Command ID名称 Command ID取值 BIND 0x1 BIND_RESP 0x80000001 UNBIND 0x2 UNBIND_RESP 0x80000002 USER_Info 0x3 USER_Info_RESP 0x80000003 KeepAlive 0x4 KeepAlive_RESP 0x80000004 　消息体说明 　 一个数据包总长度不可大于 10k。 对存在多条返回记录的业务，一数据包可含多条记录。长度如超过 10K，应以多包数据 发送。 　Bind操作 　 Bind操作用于在客户端和服务器之间建立连接。Bind 操作由 Bind命令和 Bind_Resp应 答组成。客户端首先发送 Bind命令，服务器端收到 Bind 命令后，对命令发送方进行验证， 然后返回 Bind_Resp应答。 　Bind命令的语法 字段 类型 长度（字节） 说明 Login Name Text 16 服务器端给客户端分配的登录名 Login Password Text 16 服务器端和 Login Name 对应的密码 Reserve Text 8 保留，扩展用 　Bind_Resp应答的语法 字段 类型 长度（字节） 说明 Result Integer 1 Bind执行命令是否成功。 0：执行成功 执行失败时填写错误代码(详见 ) Reserve Text 8 保留，扩展用 　Unbind操作 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 71 　 Unbind操作由 Unbind命令和 Unbind_Resp 应答组成。通信连接建立以后，客户端如果 要停止通信，需要发送 Unbind命令；服务器端收到 Unbind命令后，向客户端发送 Unbind_Resp 相应，然后双方断开连接。 　Unbind命令的语法 　 Unbind命令没有消息体。 　Unbind_Resp应答的语法 　 Unbind_Resp应答没有消息体。 　User_Info操作 　 User_Info操作由 User_Info 命令和 User_Info_Resp 应答组成。通信连接建立以后， User_Info命令用于客户端 CRM系统向本省 VAC系统传送用户状态有新变化的记录，可以 1 次传送多条记录； 本省 VAC系统服务器收到 User_Info命令数据后，进行用户数据处理，处理完成后，向 客户端发送 User_Info_Resp信息，包含记录处理结果和出错原因代码信息。 本省 VAC系统服务器收到 User_Info命令数据后，也可以进行用户数据后处理，即先回 响应，表示正确接收 CRM的命令，再做数据处理，VAC会无条件执行 CRM 指令。此规则为了 应对因处理消息缓慢造成的状态变更消息阻塞。 　User_Info语法 　 User_Info消息体包含 n条记录(n>=0)。 字段 说明 字段 类型 长度 （字节） 备注 Count 记录数 Integer 4 本消息包中包含的记录总数，取值>=1， 该字段只出现在首记录中。从第二条 记录开始，只包含第 2 个字段以后的 各字段。 SequenceId 记录流水号 Integer 4 命令内流水 MessageID 工单号 Text 18 由综合营帐系统生成 SubscrbStat 用户状态操作 Text 5 用户状态改变类型： 91001-新建用户， 91002-改号， Commented [xl4]: 要求 CRM 按下面次序执行: 先退定旧号码定购关系 再发改号消息 再发新号码定购 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 72 91003-销户， 91004-预约销户， 91005-取消预约销户， 91009-开机， 91010-营业停机， 91011-欠费停机, 91020-过户, 91030-修改用户信息, 91090-其他，备用 OptrAreaID 营业员地域编码 Text 8 OptrID 营业员工号 Text 20 AcptSiteID 受理点代码 Text 20 ChangeTime 用户状态改变时 间 Text 14 Yyyymmddhhmmss MDN MDN Text 21 IMSI IMSI Text 15 Old_MDN 旧 MDN Text 21 用户改号时为用户旧 MDN，其他情况 为 0 Old_SubscrbSta t 用户原有状态 Text 2 用户状态变更时为用户原有状态，其 他情况为 0 UserStat 用户状态 Text 2 CRM侧用户状态 UserType 用户付费类型 Text 1 用户付费类型 0 后付费 1 预付费 Userbrand 用户品牌 Text 5 用户品牌 userSCPType SCP或 OCS用户 Text 1 预用户付费 SCP 或 OCS 属性 0 SCP 1 OCS UserPrepaidID 用 户 归 属 的 SCP/OCSID Text 16 用户归属的 OCSID Commented [xl5]: 应为 2 位 Commented [xl6]: 如果用户归属 SCP，此字段无意 义,SCP 用户以号段表为准 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 73 userServiceTyp e 用户服务类型 Integer 1 0：3G用户 1：2G用户 2：PSTN用户 3：宽带用户 4：NGN（软交换）用户 5：PHS用户 6：大灵通用户 7：IPTV用户 其他预留 Reserve1 保留 Text 40 保留，扩展用 Reserve2 保留 Text 40 保留，扩展用 　User_Info_Resp语法 　 User_Info_Resp消息体包含 n条记录(n>=0) 字段 说明 字段类型 长度 （字节） 备注 Count 记录数 Integer 4 本消息包中包含的记录总数，取 值>=1，该字段只出现在首记录 中。从第二条记录开始，只包含 第 2 个字段以后的各字段。 SequenceId 记录流水号 Integer 4 命令内流水 State_Flag 记录处理状态 Integer 1 十进制数字，0成功，1 失败 Error_Reason 错误代码 Integer 3 State_Flag=1时有效,填写错误 代码(详见 ) Reserve 保留字段 Text 8 保留，扩展用 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 74 　链路检测包 KeepAlive与 KeepAlive _Resp 　 按照本接口规定，客户端主动向服务器端成功建立连接之后，如果服务器端检测出连接 长时间空闲(默认 60秒，可配置)，可以主动断开该连接。因此，客户端如果在 60 秒之内没 有数据发送，可以发送 keepalive包，服务器端收到 keepalive 包后返回相应的 keepalive 响应包，从而维持了连接。 KeepAlive与 KeepAlive_Resp 只有包头，没有包体。 　文件方案 　  发起方系统：省分 CRM系统   接收方系统：本省 VAC   接口协议：FTP  　文件目录 　 CRM系统将请求文件放到本省 VAC的指定目录下，VAC 接收文件并处理后，根据处理情 况将回执放到 VAC相应回执目录下由 CRM 获取。  存放批量请求文件工作目录：<根目录>/<lianji_SupportSys>/request/add   存放全量核对文件工作目录：<根目录>/<lianji_SupportSys>/request/all   存放正确回执文件工作目录：<根目录>/<lianji_SupportSys>/response/right/add   存放全量正确回执文件工作目录：<根目录>/<lianji_SupportSys>/response/right/all   存放文件级错误回执文件工作目录：<根目录>/<lianji_SupportSys>/response/bad/add   存放全量文件级错误回执文件工作目录：<根目录 >/<lianji_SupportSys>/response/bad/all   存放记录级错误回执文件工作目录：  <根目录>/<lianji_SupportSys>/response/semiwrong 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 75  其中/right和/bad目录下只有文件头，没有文件体；/semiwrong 目录下既有文件头， 也有文件体，文件体表示错误记录。  　文件命名 　  批量文件名按如下规则命名：   yyyymmddhhmm为文件产生的年月日时分。xxx 为省分代码。nnnn 是 4位序列号，每天 从“0001”开始，到达“9999”后又从“0001”开始。ttt表示文件类型，req表示请 求，res表示请求结果。每一个 req文件都应该有一个 res文件与其对应。res类型的 文件中包含与 req类型文件中每一个请求对应的联机指令的执行结果。   全量文件名按如下规则命名：  　文件格式 　 文件采用 ASCII文本格式，联机命令文件体中每条记录的属性值按顺序排列， 各属性间使用‘\t’分隔，在生成记录时若相应的属性值为空，直接用分隔符隔 开，分隔符之间无其他符号。 文件体中一行作为一条联机命令记录，各条记录之间用换行符作为分隔并在 文件中连续书写，文件体不定长。 文件的删除与备份由 VAC负责。  请求文件头  序 号 属性名 长度 备注 1. 文件序列号 CHAR(4) 从 0001 开始，排满 9999 后重新循环。 2. 版本信息 CHAR(5) 缺省：00000 3. 文件产生时间 CHAR (14) yyyymmddhhmmss 4. 文件生成方系统代码 CHAR(3) 104 5. 文件采集方系统代码 CHAR(3) 902 6. 用户归属地代码 CHAR(3) 省分代码 7. 总记录数 CHAR(10) 一个文件中的记录数最大为100,000。 右对齐，左补 0 8. 备用 CHAR(40) 9. 换行 CHAR(1) 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 76  回执文件头 序 号 属性名 长度 备注  文件序列号 CHAR(4) 回执所对应的请求文件的序列号  版本信息 CHAR(5) 缺省：00000  文件产生时间 CHAR (14) yyyymmddhhmmss  文件生成方系统代码 CHAR(3) 902  文件采集方系统代码 CHAR(3) 104  用户归属地代码 CHAR(3) 省分代码  总记录数 CHAR(10) 一个文件中的记录数最大为100,000。 右对齐，左补 0  错误记录数 CHAR(10) 文件级错误填全 0。 记录级错误填错误记录数,右对齐，左 补 0  反馈结果代码 CHAR(3) 文件级错误填错误代码(详见 ) 记录级错误填全 0  正确记录数 CHAR(10) 右对齐，左补 0  备用 CHAR(40)  换行 CHAR(1)  请求文件体 序号 参数名 说明 参数类型 最大长度 是否必 填 1 SequenceI d 流水号 CHAR 12 M 2 MDN 用户 MDN号，加 86 CHAR 20 M 3 IMSI 用户 IMSI号 CHAR 15 M 4 UserType 用户类型 0 后付费 1 预付费 CHAR 1 M 5 UserStat 用户状态 CHAR 2 M 6 Userbrand 用户品牌 CHAR 5 M 7 userSCPTy pe 预用户付费 SCP或 OCS 属性: 0 SCP 1 OCS CHAR 1 O 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 77 8 UserPrepa idID 用户归属的 SCP/OCSID CHAR 20 O 9 UpdateDat e 营帐最后更新时间 CHAR 14 M 10 userServi ceType 用户服务类型， 0：3G用户 1：2G用户 2：PSTN用户 3：宽带用户 4：NGN（软交换）用户 5：PHS用户 6：大灵通用户 7：IPTV用户 其他预留 Integer 1 M 1011 backup 备用 CHAR 40 O 1112 \n 换行 CHAR 1 M  回执文件体  对于完全正确的文件和有文件级错误的回执文件，只有文件头没有文件体；对于记录级 错误的回执文件，在文件体中列出错误的请求流水号及反馈结果代码。 序 号 参数名 说明 参数类型 最大 长度 备注 1. SequenceId 记录流水号 CHAR 12 与请求文件体中对应记录的流 水号相同 2. SubscrbStat 反馈结果代码 CHAR 3 记录级错误代码(详见 ) 3. Enter 换行 CHAR 1 ‘\n’ 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 78 　产品订购关系同步接口 　 　概述 　 CRM系统完成用户对业务的最终订购行为，用户的订购以CRM系统所维护的为准（这里不 包括按次点播类的业务订购）。因此，CRM系统应实时将用户的订购/退订信息通知到VAC。 为此，VAC平台与CRM平台之间应就产品订购关系同步定义产品订购关系同步接口。 　CRM发起的业务订购接口 　 　接口描述 　 用户订购关系发生变化时，VAC通过此接口实时通知SP。 批开、批退时不采用此接口通知SP，通过FTP订购关系同步接口通知SP。 通知失败时，CRM可通过FTP订购关系同步接口进行同步。 　发起方系统 　 CRM（Webservice客户端）。 　接收方系统 　 VAC（Webservice服务器端）。 　接口协议 　 CRM与VAC之间的业务购信息同步接口采用下列实现方式： 1．Web Service方式：CRM通过Web Service方式将业务订购信息实时地同步给VAC。 1． 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 79 2．文件方式：对于批量订购的情况，需要用文件接口进行订购关系的同步。 2． 　接口内容 　 　Web Service 接口 　 　订购关系同步请求（OrderRelationNotityReq） 　 方向：CRM －> VAC 序号 参数名 说明 参数类 型 最 大 长 度 是 否 必 填 1 RecordSequenceID 流水号，格式为时间戳+序列号： YYYYMMDDHHMMSSxxxx，其中 xxxx为序列号，从 0001开始， 排满 9999后重新循环 string 18 M 2 OrderID 订购关系 ID，用来唯一标识订 购关系,CRM产生 string 10 M 3 UpdateType 更新类型: 1：定购 2：取消定购 3: 定购关系变更(一般是修改 有效期) intege r 1 M 4 SubscribeType 1:个人定购 2:他人赠送 3:运营商代定购 4:销户退订 5:由 VAC发起,CRM异步处理失 败引起 intege r 1 M 5 OrderMethod 订购渠道，取值见附录 A string 4 M 6 PushId 推荐人(发展人)ID string 20 O 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 80 7 servicetype 业务类型,见附录 A string 2 M 8 MDN 定购关系拥有者用户号码 string 20 M 9 PayMDN 付费方号码 string 20 O 10 ProductID 产品代码 string 8 M 11 SPEC_ProductID CRM构成产品标识 string 12 M 12 SP_ProductID PRM产生的合作伙伴产品 ID string 12 M 13 SPID SP代码 string 8 M 14 SubscriptionTime 定购/退定时间 格式：yyyyMMddhhmmss string 14 M 15 rentDate 扣租开始时间(不同用户免费期 不一定一样) yyyyMMddhhmmss string 14 M 16 EffectiveDate 生效时间 格式：yyyyMMddhhmmss string 14 M 17 ExpireDate 失效时间 格式：yyyyMMddhhmmss string 14 M 　订购关系同步响应（OrderRelationNotityRsp） 　 方向：VASP －> BSS 序号 参数名 说明 参数类型 最大长度 是否必 填 1 RecordSequenc eID 流水号，格式为时间戳+序列 号：YYYYMMDDHHMMSSxxxx， 其中xxxx为序列号，从0001 开始，排满9999后重新循环 string 18 M 2 ResultCode 结果标识 0：成功 其它错误信息见附录B integer 4 M 　FTP接口 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 81 　 对于批量订购的情况，需要用文件接口进行订购关系的同步。 CRM系统将订购关系信息资料存放到VAC系统中文件服务器的指定目录下。VAC为FTP服务 器端，CRM为FTP客户端，双方通过文件传输实现接口。文件服务器上设定具有对相应目录存 取权限的用户。VAC系统为CRM分配具有存取文件权限的用户。 文件采用ASCII码方式，文件体中每条记录的属性值按顺序排列，各属性间使用‘\t’ 分隔，在生成记录时若相应的属性值为空，直接用分隔符隔开，分隔符之间无其他符号。 文件体中一行作为一条记录，各条记录之间用换行符作为分隔并在文件中连续书写。 文件头定长，文件体不定长。 文件的维护由CRM系统负责，VAC采集后对文件进行删除操作。 对于全量同步的文件，CRM系统于定期凌晨1：00将全量资料放在CRM的指定目录下，VAC 定期资料读取。 　文件目录 　 CRM系统将请求文件放到VAC指定目录下，VAC将执行结果放回VAC相应目录下。CRM需要 将批量定购的文件和非批量定购文件存放在不同目录中。 存放请求文件工作目录：<根目录>/<VAC>/<OrderInfo>/request 存放全量请求文件工作目录：<根目录>/<VAC>/<OrderInfo>/request/all 存放正确回执文件工作目录：<根目录>/<VAC>/<OrderInfo>/response/right 存放全量正确回执文件工作目录：<根目录>/<VAC>/<OrderInfo>/response/right/all 存放错误回执文件工作目录：<根目录>/<VAC>/<OrderInfo>/response/bad，文件级错 误代码参见附录 存放全量错误回执文件工作目录：<根目录>/<VAC>/<OrderInfo>/response/bad/all， 文件级错误代码参见附录 存放部分错误回执文件工作目录：<根目录>/<VAC>/<OrderInfo>/response/semiwrong， 记录级错误代码参见附录。 存 放 全 量 错 误 回 执 文 件 工 作 目 录 ： <根 目 录 >/<VAC>/<OrderInfo>/response/semiwrong/all，记录级错误代码参见附录。 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 82 　文件命名 　 批文件名按如下规则命名： yyyymmddhhmm为批文件产生的年月日时分。xxx为省分代码。nnnn 是4位序列号，每天 从“0001”开始，到达”9999”后又从“0001”开始。ttt表示文件类型，req表示请求，res 表示请求结果。每一个req文件都应该有一个res文件与其对应。 　请求文件头（定长） 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 0001 开始，排满 9999 后重新循环 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR(14) yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 104 5 记录开始日期时间 CHAR(14) yyyymmddhhmmss 6 记录结束日期时间 CHAR(14) yyyymmddhhmmss 7 总记录数 CHAR(10) 8 备用 CHAR(40) 9 换行 CHAR(1) 　回执文件头（定长） 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 从 0001 开始，排满 9999 后重新循环。 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR (14) Yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 902 5 总记录数 CHAR(10) 6 正确处理记录数 CHAR(10) 7 备用 CHAR(40) 8 换行 CHAR(1) 　请求文件体（变长） 序号 参数名 说明 参数类 型 最 大 长 度 是 否 必 填 1 RecordSequenceID 流水号，格式为时间戳+序列号： YYYYMMDDHHMMSSxxxx，其中 xxxx为序列号，从 0001开始， 排满 9999后重新循环 string 18 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 83 2 OrderID 订购关系 ID，用来唯一标识订 购关系,CRM产生 string 10 M 3 UpdateType 更新类型: 1：定购 2：取消定购 3: 定购关系变更(一般是修改 有效期) intege r 1 M 4 SubscribeType 1:个人定购 2:他人赠送 3:运营商代定购 4:销户退订 5:由 VAC发起,CRM异步处理失 败引起 intege r 1 M 5 OrderMethod 订购渠道，取值见附录 A string 4 M 6 PushId 推荐人(发展人)ID string 20 O 7 servicetype 业务类型,见附录 A string 2 M 8 MDN 定购关系拥有者用户号码 string 20 M 9 PayMDN 付费方号码 string 20 O 10 ProductID 产品代码 string 8 M 11 SPEC_ProductID CRM构成产品标识 string 12 M 12 SP_ProductID PRM产生的合作伙伴产品 ID string 12 M 13 SPID SP代码 string 8 O 14 SubscriptionTime 定购/退定时间 格式：yyyyMMddhhmmss string 14 M 15 rentDate 扣租开始时间(不同用户免费期 不一定一样) yyyyMMddhhmmss string 14 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 84 16 EffectiveDate 生效时间 格式：yyyyMMddhhmmss string 14 M 17 ExpireDate 失效时间 格式：yyyyMMddhhmmss string 14 M 　回执文件体（变长） 　 对于完全正确和完全错误的回执文件，只有文件头没有文件体；对于记录级错误的回执 文件，在文件体中列出错误的结果代码，错误回执的文件体格式如下： 序号 参数名 说明 参数类型 最大长度 是否 必填 1 流水号 流水号，格式为时间戳 +序列号： YYYYMMDDHHMMSSxxxx， 其中 xxxx为序列号， 从 0001开始，排满 9999后重新循环 string 18 M 2 ErrCode 错误代码，见附录 B integer 4 M 3 \n 换行 CHAR 1 M 如某条记录有多个错误，只填写出现的第一个错误代码。 　VAC发起的业务订购接口 　 　接口描述 　 由业务平台侧发起的订购关系，如短信在线订购的包月产品，需要先由业务系统向用户 进行二次确认，得到用户的确认消息后，VAC再向CRM发送订购关系确认请求消息，请求CRM 进行一系列鉴权，并生成最终的订购关系。生成订购关系后，CRM最终返回给VAC最终的订购 关系确认。流程如下图所示： 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 85 3.订购关系确认响 应 2．订购关系鉴权， 并生成订购关系 1.订购关系确认请 求 VAC CRM BSS 图1　VAC 侧发起的订购关系流程 图1　 　发起发系统 　 VAC（Webservice客户端）。 　接收方系统 　 CRM（Webservice服务器端）。 　接口协议 　 CRM与VAC之间的业务订购关系确认请求接口采用Web Service方式：VAC通过Web Service方式将业务订购关系结果发送给CRM，请求CRM进行订购关系的最终确认。 　接口内容 　 　订购关系确认请求（OrderConfirmReq） 　 方向：VAC－>CRM 序号 参数名 说明 参数类型 最大长 度 是否必 填 1 RecordSeque nceID 流水号，格式为时间戳+序列号： YYYYMMDDHHMMSSxxxx，其中 xxxx为序列号，从0001开始， 排满9999后重新循环 string 18 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 86 2 UpdateType 更新类型 1：定购 2：取消定购 6：退定(如: 00000退定) integer 1 M 3 SubscribeTyp e 1:个人定购 2:他人赠送 3:运营商代定购 4:销户退订 5:由VAC发起,CRM异步处理失 败引起 integer 1 M 4 OrderMethod 订购渠道，取值见附录A CHAR 4 M 5 PushId 推荐的营销方式,推荐方ID CHAR 20 O 6 servicetype 业务类型,见附录A CHAR 2 M 7 MDN 定购关系拥有者用户号码 CHAR 20 M 8 PayMDN 付费方号码 CHAR 20 O 9 ProductID CRM产品代码 CHAR 8 M 10 SPEC_Produc tID CRM构成产品标识 CHAR 12 M 11 SP_ProductI D PRM产生的合作伙伴产品 ID CHAR 12 M 12 SPID SP代码 CHAR 8 O 13 Subscriptio nTime 定购/退定时间格式： yyyyMMddhhmmss CHAR 14 M 备注： 1.对于VAC发起的定购,立刻生效 2.对于VAC发起的退定,按帐期定失效实现 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 87 3.用户退定某个SP的全部定购关系：updateType取6、spid取退定的sp代码、productid 取00000, servicetype不用管 4.用户退定全部定购关系： updateType取 6、 spid取 00000、 productid取 00000, servicetype不用管 注释:定购关系每天增量由CRM同步给VAC核对 　订购关系确认响应（OrderConfirmRsp） 　 方向：CRM->VAC 序号 参数名 说明 参数类型 最大长度 是否必 填 1 RecordSequ enceID 流水号，格式为时间戳+ 序 列 号 ： YYYYMMDDHHMMSSxxxx，其 中xxxx为序列号，从0001 开始，排满9999后重新循 环 CHAR 18 M 2 ResultCode 结果标识 0：成功 1：失败 10：用户鉴权失败 11：用户不存在 12：用户状态非正常 13：用户属性有误 20：业务鉴权失败 21：业务不存在 22：业务状态非正常 integer 4 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 88 23：业务属性有误 30：CP/SP鉴权失败 31：CP/SP不存在 32：CP/SP状态非正常 33：CP/SP属性有误 40：产品鉴权失败 41：产品不存在 42：产品状态非正常 43：产品属性有误 50：其他原因失败 51:业务已定购 　资费模型同步接口 　 　接口描述 　 VAC从CRM系统获取资费信息。 　发起方系统 　 CRM系统（Webservice客户端）。 　接收方系统 　 VAC（Webservice服务器端）。 　接口协议 　 VAC与CRM之间的资费信息同步接口采用下列实现方式： 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 89 Web Service方式：CRM通过Web Service方式将资费信息实时地同步给VAC。 　接口内容 　 　Web Service接口 　 　资费信息同步请求（BillingInfoReq） 　 方向：CRM －> VAC 序号 参数名 说明 参数类型 最大长 度 是否必 填 1 RecordSequence ID 流水号，格式为时间 戳 +序 列 号 ： YYYYMMDDHHMMSSxxxx， 其中 xxxx为序列号， 从 0001开始，排满 9999后重新循环 string 18 M 2 UpdateType 更新类型 1：增加 2：修改 3： 删除 integer 1 M 3 Billing_Id 计费规则 ID，计费规 则唯一标识，合法字 符为数字 string 20 M 4 Billing_des 计费规则名称 例如：10元包月 string 200 O 5 Billing_status 计费规则当前状态 0：有效 1：无效 integer 2 M 6 billing_code 资费模型代码 String 20 M 7 Parameter_num 参数个数 integer 2 M 8 Parameter_form at 字符串格式（以分号 为分隔符）： <参数 1 代码 >=string1;<参数 2代 码>=string2…… String 500 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 90 9 EffDate 生效时间 String 14 O 10 ExpDate 失效时间 String 14 O 11 Resv2 保留 String 20 O 12 Resv3 保留 string 40 O 　资费信息同步响应（BillingInfoRsp） 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号 string 18 M 2 ResultCode 结果标识 0：正确 1：错误 integer 4 M 　FTP接口 　 使用FTP接口情况： 1）需要定期用全量的方式，对CRM和VAC的资费信息进行核查。CRM定期生成全量核查文 件，以CRM同步信息为准更新VAC的资费信息； CRM系统将资费信息资料存放到VAC系统中文件服务器的指定目录下，由VAC主动获取。 双方通过文件传输实现接口。文件服务器上设定具有对相应目录存取权限的用户。VAC系统 为CRM分配具有存取文件权限的用户。 文件的维护由CRM（FTP Client）系统负责，VAC（FTP Server）采集后对文件进行删除 操作。 CRM系统于定期凌晨1：00进行全量资料同步，VAC于定期凌晨2：00后可进行资料读取。 (时间可配) 　文件目录和文件命名 　 CRM系统将请求文件放到VAC指定目录下，VAC将执行结果放回VAC相应目录下。批文件名 按如下规则命名： yyyymmddhhmm为批文件产生的年月日时分。xxx为省分代码。nnnn 是4位序列号，每天 从“0001”开始，到达”9999”后又从“0001”开始。tttt表示文件类型，rreq表示准实时 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 91 请求, rrsp表示准实时请求结果。每一个rreq文件都应该有一个rrsp文件与其对应, areq表 示全量请求，arsp表示全量请求结果。每一个areq文件都应该有一个arsp文件与其对应。 具体对应关系如下： 文件类型 后缀 文件目录() 即时处理（准 实时） 请求文件：rreq， 响应文件：rrsp 存 放 请 求 文 件 工 作 目 录 ： <根 目 录 >/VAC/ billinginfo /request /real 存放正确回执文件工作目录： <根目录 >/VAC/ billinginfo /response/right/real 存放完全错误回执文件工作目录：<根目录>/VAC/ billinginfo/response/bad，文件级错误代码参见附录 存放部分错误回执文件工作目录： <根目录 >/VAC/ billinginfo /response/semiwrong，记录级错误代码参 见附录 全量 请求文件：areq， 响应文件：arsp 存 放 请 求 文 件 工 作 目 录 ： <根 目 录 >/VAC/ billinginfo /request /all 存放正确回执文件工作目录： <根目录 >/VAC/ billinginfo /response/right/all 存放完全错误回执文件工作目录：<根目录>/VAC/ billinginfo /response/bad，文件级错误代码参见附录 存放部分错误回执文件工作目录： <根目录 >/VAC/ billinginfo /response/semiwrong，记录级错误代码参 见附录 　请求文件头（定长） 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 0001 开始，排满 9999 后重新循环 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR(14) yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 104902 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 92 5 记录开始日期时间 CHAR(14) yyyymmddhhmmss 6 记录结束日期时间 CHAR(14) yyyymmddhhmmss 7 总记录数 CHAR(10) 8 备用 CHAR(40) 9 换行 CHAR(1) 　回执文件头（定长） 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 从 0001 开始，排满 9999 后重新循环。 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR (14) Yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 902104 5 总记录数 CHAR(10) 6 正确处理记录数 CHAR(10) 7 备用 CHAR(40) 文件级错误代码 8 换行 CHAR(1) 　请求文件体（变长） 序号 参数名 说明 参数类型 最大长 度 是否必 填 1 RecordSequence ID 流水号，格式为时间 戳 +序 列 号 ： YYYYMMDDHHMMSSxxxx， 其中 xxxx为序列号， 从 0001开始，排满 9999后重新循环 string 18 M 2 UpdateType 更新类型 1：增加 2：修改 3： 删除 integer 1 M 3 Billing_Id 计费规则 ID，计费规 则唯一标识，合法字 符为数字 string 20 M 4 Billing_des 计费规则名称 例如：10元包月 string 200 O 5 Billing_status 计费规则当前状态 0：有效 1：无效 integer 2 M 6 billing_code 资费模型代码 String 20 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 93 7 Parameter_num 参数个数 integer 2 M 8 Parameter_form at 字符串格式（以分号 为分隔符）： <参数 1 代码 >=string1;<参数 2代 码>=string2…… String 500 M 9 EffDate 生效时间 String 14 O 10 ExpDate 失效时间 String 14 O 11 Resv2 保留 String 20 O 12 Resv3 保留 string 40 O 　回执文件体（变长） 　 对于完全正确和完全错误的回执文件，只有文件头没有文件体；对于记录级错误的回执 文件，在文件体中列出错误的结果代码。 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号，格式为时 间 戳 +序 列 号 ： YYYYMMDDHHMMSSx xxx，其中 xxxx 为 序列号，从 0001 开始，排满 9999 后重新循环 string 18 M 2 ResultCode 结果标识 0：正确 1：错误 integer 4 M 资费模型：  免费：产品无定价，用户免费使用 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 94  资费模型代码：Free，参数个数：1。 模型参数： 参数 1（Fee）：资费（为 0分） Free 1 Fee=0  单位费率：按计费单元进行计费的计费方式。计费单元可以非单位长度。  资费模型代码：PerTime，参数个数：5。 模型参数： 参数 1（Fee）：计费单元资费（nM/T+n￥） 参数 2（feeType）：计费类型（2，按次；6，按时长；5，按流量） 参数 3（billingUnit）：计费单元长度 参数 4（maxfee）：封顶费用（nM/T+n￥）,如果填零,不封顶 参数 5（minfee）：保底费用（nM/T+n￥）如果填零,不保底 参数 1（Fee）：计费单元资费（分） 参数 2（feeType）：计费类型（2，按次；6，按时长；5，按流量） 参数 3（billingUnit）：计费单元长度 参数 4（maxfee）：封顶费用（分）,如果填零,不封顶 参数 5（minfee）：保底费用（分）如果填零,不保底 例 1： 定义计费规则：fee=10分、 feeType=6、 BiillingUnit=60 秒 用户使用时长：2400秒 则： 金额=2400/60*10=400分 例 2： 定义计费规则：fee=1分、 feeType=5、 BiillingUnit=1024 字节 用户使用流量：200K 则： 金额=200*1024/1024*1=200分 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 95 例 3： 定义计费规则：fee=1M+10分、 feeType=2、 BiillingUnit=1 次 用户使用次数：10次 则： 金额=10/1*（1M+10）=10M+100分  包周期计费：以周期为单位进行收费，用户在周期内使用该业务收取且仅收取一次性费 用，不限使用业务的次数。  资费模型代码：OrderDay，参数个数：2 模型参数： 参数 1（Fee）：包周期资费（分） 参数 2（days）：自然天  包月计费：包月计费是按月收取用户使用业务的费用。在计费月中用户使用某包月服务 时，一次性收取包月价格费用。如用户使用某价格为 30 元的包月服务，每月初收取用 户 30 元后用户即可无限制的使用该包月业务。包月计费月份计量方式分为自然月方式、 整月方式，收费方式分为日租、月租方式。  资费模型代码：OrderMonth，参数个数：4 包月模型参数： 参数 1（Fee）：包月资费（分） 参数 2（MonthType）：月份计量方式（0，自然月；1，整月；“整月方式”话单规 则有联通业务规范规定。目前默认值 0） 参数 3（ChargeMode）：收费方式（0月租，1日租；“日租”的话单规则由联通业 务规范规定，目前默认值为 0；） 参数 4（IfAutoOrder）：是否自动续订（0，是；1，否；默认值为 0）自动是 0 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 96  包月计费＋单位费率：包月计费是按月收取用户使用业务的费用。每次使用还按照单位 费率收费  资费模型代码：OrderMonth1，参数个数：8 包月模型参数： 参数 1（Fee）：包月资费（分） 参数 2（MonthType）：月份计量方式（0，自然月；1，整月；“整月方式”话单规 则有联通业务规范规定。目前默认值 0） 参数 3（ChargeMode）：收费方式（0月租，1日租；“日租”的话单规则由联通业 务规范规定，目前默认值为 0；） 参数 4（IfAutoOrder）：是否自动续订（0，是；1，否；默认值为 0）自动是 0 参数 5（Fee1）：计费单元资费（分） 参数 6（feeType）：计费类型（2，按次；6，按时长；5，按流量） 参数 7：（billingUnit）：计费单元长度 参数 8：（maxfee）：封顶费用（分）  包月计费＋单位费率+分档计费：包月计费是按月收取用户使用业务的费用。每次使用 还按照单位费率收费，费用可以分档。例如：彩信包月费 5元 ，可以使用 100 条彩信， 100条使用完毕后按照 1毛/条计费 ；如果用户没有订购，则按照 5毛/条计费。  资费模型代码：OrderMonthlevel，参数个数：11 包月模型参数： 参数 1（Fee）：包月资费（分） 参数 2（MonthType）：月份计量方式（0，自然月；1，整月；“整月方式”话单规 则有联通业务规范规定。目前默认值 0） 参数 3（ChargeMode）：收费方式（0月租，1日租；“日租”的话单规则由联通业 务规范规定，目前默认值为 0；） 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 97 参数 4（IfAutoOrder）：是否自动续订（0，是；1，否；默认值为 0）自动是 0 参数 5（feeType）：计费类型（2，按次；6，按时长；5，按流量） 参数 6：（billingUnit）：计费单元长度（如果按次计费则单位为次数，按时长为 秒，按流量则为 字节） 参数 7：（maxfee）：封顶费用（分） 参数 8（Fee1evel1）：第一档计费单元资费（分） 参数 9（Secondlevelstar）：第二档起点（以计费单元为单位，例如，一个计费单 元为 5K，则此起点为 10 则代表第二档起点为 4*5 = 20K ） 参数 11（Fee1evel2）：第二档计费单元资费（分） 资费模型样例: OrderMonth 4 Fee=600;MonthType=0;ChargeMode=0;IfAutoOrder=0 　优惠规则模型同步接口 　 　接口描述 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 98 　 VAC从CRM系统获取优惠信息。 　发起方系统 　 CRM系统（Webservice客户端）。 　接收方系统 　 VAC（Webservice服务器端）。 　接口协议 　 CRM与VAC之间的优惠信息同步接口采用下列两种实现方式： Web Service方式：CRM通过Web Service方式将优惠信息实时地同步给VAC。 　接口内容 　 　Web Service接口 　 　优惠规则同步请求（DiscountPolicyInfoReq） 　 方向：CRM －> VAC 序号 参数名 说明 参数类型 最大长 度 是否必 填 1 RecordSequence ID 流水号，格式为时间 戳 +序 列 号 ： YYYYMMDDHHMMSSxxxx， 其中 xxxx为序列号， 从 0001开始，排满 9999后重新循环 string 18 M 2 UpdateType 更新类型 1：增加 2：修改 3： 删除 integer 1 M 3 Discount_Id 优惠规则 ID，优惠规 则唯一标识 string 20 M 4 Discount_des 优惠规则名称 string 200 O 5 Discount_statu s 优惠规则当前状态 Integer 2 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 99 0：有效 1：无效 6 Discount_code 优惠规则代码 string 20 M 7 Parameter_num 参数个数 Integer 2 M 8 Parameter_form at 字符串格式（以分号 为分隔符）： <参数 1 代码 >=string1;<参数 2代 码>=string2…… string 500 M 9 EffDate 生效时间 string 14 O 10 ExpDate 失效时间 string 14 O 11 Resv1 保留 string 20 O 12 Resv2 保留 string 40 O 　优惠规则同步响应（DiscountPolicyInfoRsp） 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号，格式为时 间 戳 +序 列 号 ： YYYYMMDDHHMMSSx xxx，其中 xxxx 为 序列号，从 0001 开始，排满 9999 后重新循环 string 18 M 2 ResultCode 结果标识 0：正确 1：错误 integer 4 M 　FTP接口 　 使用FTP接口情况： 1）需要定期用全量的方式，对CRM和VAC的资费信息进行核查。CRM定期生成全量核查文 件，VAC以CRM同步信息为准更新VAC的资费信息； 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 100 CRM系统将资费信息资料存放到VAC系统中文件服务器的指定目录下，由VAC获取。双方 通过文件传输实现接口。文件服务器上设定具有对相应目录存取权限的用户。VAC系统为CRM 分配具有存取文件权限的用户。 文件采用ASCII文本格式，文件体中每条记录的属性值按顺序排列，各属性间使用‘\t’ 分隔，在生成记录时若相应的属性值为空，直接用分隔符隔开，分隔符之间无其他符号。 文件体中一行作为一条记录，各条记录之间用换行符作为分隔并在文件中连续书写。 文件头定长，文件体不定长。 文件的维护由CRM（FTP Client）系统负责，VAC（FTP Server）采集后对文件进行删除 操作。 CRM系统于定期凌晨1：00进行全量资料同步，VAC于定期凌晨2：00后可进行资料读取。 (时间可配) 　文件目录和文件命名 　 CRM系统将请求文件放到VAC指定目录下，VAC将执行结果放回相应目录下。批文件名按 如下规则命名： yyyymmddhhmm为批文件产生的年月日时分。xxx为省分代码。nnnn 是4位序列号，每天 从“0001”开始，到达”9999”后又从“0001”开始。tttt表示文件类型，rreq表示准实时 请求, rrsp表示准实时请求结果。每一个rreq文件都应该有一个rrsp文件与其对应, areq表 示全量请求，arsp表示全量请求结果。每一个areq文件都应该有一个arsp文件与其对应。 具体对应关系如下： 文件类型 后缀 文件目录() 即时处理（准实 时） 请求文件：rreq， 响应文件：rrsp 存 放 请 求 文 件 工 作 目 录 ： <根 目 录 >/VAC/ discountinfo /request /real 存放正确回执文件工作目录： <根目录 >/VAC/ discountinfo /response/right/real 存放完全错误回执文件工作目录：<根目录>/VAC/ discountinfo /response/bad，文件级错误代码参见附 录 存放部分错误回执文件工作目录： <根目录 >/VAC/ discountinfo /response/semiwrong，记录级错误代码 参见附录 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 101 全量 请求文件：areq， 响应文件：arsp 存 放 请 求 文 件 工 作 目 录 ： <根 目 录 >/VAC/ discountinfo /request /all 存放正确回执文件工作目录： <根目录 >/VAC/ discountinfo /response/right/all 存放完全错误回执文件工作目录：<根目录>/VAC/ discountinfo /response/bad，文件级错误代码参见附 录 存放部分错误回执文件工作目录： <根目录 >/VAC/ discountinfo /response/semiwrong，记录级错误代码 参见附录 　请求文件头（定长） 序号 属性名 长度 备注 1 文件序列号(流水号) CHAR(4) 0001 开始，排满 9999 后重新循环 2 版本信息 CHAR(5) 缺省：00000 3 文件产生时间 CHAR(14) Yyyymmddhhmmss 4 文件生成方系统代码 CHAR(3) 104902 5 记录开始日期时间 CHAR(14) Yyyymmddhhmmss 6 记录结束日期时间 CHAR(14) yyyymmddhhmmss 7 总记录数 CHAR(10) 8 备用 CHAR(40) 9 换行 CHAR(1) 　回执文件头（定长） 序号 属性名 长度 备注 9 文件序列号(流水号) CHAR(4) 从 0001 开始，排满 9999 后重新循环。 10 版本信息 CHAR(5) 缺省：00000 11 文件产生时间 CHAR (14) Yyyymmddhhmmss 12 文件生成方系统代码 CHAR(3) 902104 13 总记录数 CHAR(10) 14 正确处理记录数 CHAR(10) 15 备用 CHAR(40) 文件级错误代码 16 换行 CHAR(1) 　请求文件体（变长） 序号 参数名 说明 参数类型 最大长 是否必 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 102 度 填 1 RecordSequence ID 流水号，格式为时间 戳 +序 列 号 ： YYYYMMDDHHMMSSxxxx， 其中 xxxx为序列号， 从 0001开始，排满 9999后重新循环 string 18 M 2 UpdateType 更新类型 1：增加 2：修改 3： 删除 integer 1 M 3 Discount_Id 优惠规则 ID，优惠规 则唯一标识 string 20 M 4 Discount_des 优惠规则名称 string 200 O 5 Discount_statu s 优惠规则当前状态 0：有效 1：无效 Integer 2 M 6 Discount_code 优惠规则代码 string 20 M 7 Parameter_num 参数个数 Integer 2 M 8 Parameter_form at 字符串格式（以分号 为分隔符）： <参数 1 代码 >=string1;<参数 2代 码>=string2…… string 500 M 9 EffDate 生效时间 string 14 O 10 ExpDate 失效时间 string 14 O 11 Resv1 保留 string 20 O 12 Resv2 保留 string 40 O 　回执文件体（变长） 　 对于完全正确和完全错误的回执文件，只有文件头没有文件体；对于记录级错误的回执 文件，在文件体中列出错误的结果代码。 序号 参数名 说明 参数类型 最大长度 是否 必填 1 RecordSequenceID 流水号，格式为时 间 戳 +序 列 号 ： YYYYMMDDHHMMSSx xxx，其中 xxxx 为 string 18 M 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 103 序列号，从 0001 开始，排满 9999 后重新循环 2 ResultCode 结果标识 0：正确 1：错误 integer 4 M 优惠类型： 3、折扣促销： 代码：PromotionRebate 参数个数：3 参数 1（StartDate）：开始时间， YYYYMMDDHH（24）MMSS 参数 2（EndDate）：结束时间，YYYYMMDDHH（24）MMSS 参数 3（Rebate）：折扣，小数 例：2005年 10月-12月期间 8折优惠 StartTime=20051001000101；EndTime=20051231235959；Rebate= 4、价格促销 代码：PromotionPrice 参数个数：3 参数 1（StartDate）：开始时间， YYYYMMDDHH（24）MMSS 参数 2（EndDate）：结束时间，YYYYMMDDHH（24）MMSS 参数 3（NewPrice）：优惠后价格（分） 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 104 例：某产品原价 10元包月，2005年 10月-12 月期间订购 8 元优惠 StartTime=20051001000101；EndTime=20051231235959；NewPrice=800 5、 周末折扣： 代码：WeekDayDiscount 参数个数：2 参数 1（WeekDay）：星期几， 取值范围：1：星期一；2：星期二；3：星期三；4：星期四；5：星期五；6：星期 六；7：星期日； 参数 2（Rebate）：折扣，小数值 6、 节假日折扣： 代码：FestivalDiscount 参数个数：3 参数 1（StartDate）：开始时间， MMDDHH（24）MMSS 参数 2（EndDate）：结束时间，MMDDHH（24）MMSS 参数 3（Rebate）：折扣，小数值 例：十一期间 8折优惠 StartTime=1001000101；EndTime=1007235959；Rebate= 7、 时段折扣： 代码：TimeDiscount 参数个数：3 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 105 参数 1（StartTime）：开始时间，HH（24）MMSS 参数 2（EndTime）：结束时间，HH（24）MMSS 参数 3（Rebate）：折扣，小数值 例：23：00—5：00，8折优惠 StartTime=230101；EndTime=045959；Rebate= 8、 15日后订购半价 代码：HalfMonthDiscount 参数个数：0 9、费用封顶优惠 代码：FixedFee 参数个数：1 参数 1（FixedFee）：封顶费用值（分） 10、按订购天收费 代码：OrderDayCharge 参数个数：0 （说明：这是丽音平台存在的一种收费方式，当用户订购包月业务时，先算出当月每天的平 均费用，然后以当天到月末的实际天数来计算用户用户应付的费用） 11、首月免月租 代码：FreeFirstMonth 参数个数：0 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 106 12、免 2个月月租 代码：FreeTwoMonth 参数个数：0 13、免 3个月月租 代码：FreeThreeMonth 参数个数：0 14、免 4个月月租 代码：FreeFourMonth 参数个数：0 15、免 5个月月租 代码：FreeFiveMonth 参数个数：0 16、免 6个月月租 代码：FreeSixMonth 参数个数：0 17、免 7个月月租 代码：FreeSevenMonth 参数个数：0 18、免 8个月月租 代码：FreeEightMonth 参数个数：0 19、免 9个月月租 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 107 代码：FreeNineMonth 参数个数：0 20、免 10个月月租 代码：FreeTenMonth 参数个数：0 21、免 11个月月租 代码：FreeElevenMonth 参数个数：0 22、免 12个月月租 代码：FreeTwelveMonth 参数个数：0 6　VAC与 billing系统的接口要求 6　 　业务话单同步接口 　 　接口描述 　 用于VAC向Billing同步用户业务访问的原始话单信息。 　发起方系统 　 VAC。 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 108 　接收方系统 　 Billing。 　接口协议 　 支持FTP协议。 　接口形式 　 文件。 VAC将业务用户使用原始话单存放到VAC中文件服务器的指定目录下，由Billing系统主 动获取。双方通过文件传输实现接口。文件服务器上设定具有对相应目录存取权限的用户。 VAC为Billing系统分配具有存取文件权限的用户。 文件采用ASCII码方式，文件体中每条记录的属性值按顺序排列，各属性间使用‘\t’ 分隔，在生成记录时若相应的属性值为空，直接用分隔符隔开，分隔符之间无其他符号。 文件体中一行作为一条记录，各条记录之间用换行符作为分隔并在文件中连续书写。 文件头定长，文件体不定长。 文件的维护由VAC负责,Billing系统采集后对文件进行删除操作。 　详细约定 　 本接口的详细约定如下： 　原始话单文件采集 　 VAC每隔15分钟产生一次原始话单文件，并传送至文件传输服务器的指定目录下。 账务周期采用自然月账务周期，VAC应以月末最后一天24时作为帐期分界点，文件名中 需标明账务周期月份。Billing系统原则上以文件名中的帐务周期作为区分账务周期月份的 标志，将原始话单文件计入文件名中标明的账务周期月份。 话单超期时间为30天，即隔月话单将被作为超期话单拒收。 　核对机制 　 Billing系统与VAC间需确保双方的原始话单文件完全一致，因此需要以下的核对机制： 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 109 Billing系统需在采集到VAC的每一个原始话单文件后回送给VAC一个回执文件，回执文 件中包括了原文件总记录数、正确接收的记录数、正确接收记录的总金额、错误记录等。VAC 手工处理。根据话单的错误原因对系统问题定位。 　具体约定 　 　话单采集目录 　 <根目录> /<VSP>/< SSID>/<CDR>/<request|response>。其中，“SSID”为VAC标识码（3 位）。 <request|response> request：存放原始详单文件 response：/bad 存放完全错误文件的回执 /right存放完全正确文件的回执 /semiwrong 存放部分错误文件的回执 其中/bad与/right下仅存放文件头；/semiwrong下存放文件头与文件体，文 件体为错误记录。 　话单文件命名 　 　普通详单文件 　 文件类型（2位）+文件标志（1位）+帐务周期月份（2位）+文件产生的时间（精确到年 月日时分）+SSID（3位）+序列号（4位）＋.后缀。 （1）文件类型 取值：20 （2）后缀 在<根目录>/<VSP>/<SSID（3位）> /<CDR>/<request >下为req； 在<根目录>/<VSP>/< SSID（3位）> /<CDR>/< response >为res。 （3）序列号 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 110 以帐期为循环单位，每帐期从0001开始，同一帐期内连续进行累加。 （4）文件标志 取值：N－表示正常文件；T－表示测试文件。 　原始话单文件头 序号 名称 长度 备注 1 文件序列号(流水号) CHAR(4) 以帐期为单位，从 0001 开始，排满 9999后重新循环 2 文件版本号 CHAR(2) 取值：02 3 文件产生时间 CHAR(14) Yyyymmddhhmmss 4 文件生成方系统代码 CHAR(8) 902 5 文件接收方系统代码 CHAR(3) 104 6 记录开始日期时间 CHAR(14) Yyyymmddhhmmss 7 记录结束日期时间 CHAR(14) Yyyymmddhhmmss 8 总记录数 CHAR(10) 右对齐，左补 0 9 备注 CHAR(40) 10 换行 CHAR(1) 　回执文件头 　原始话单文件体 序号 属性名 字段类型 最大长度 是 否 备注 序号 名称 长度 备注 1 文件序列号 CHAR (4) 从 0001开始排序，排满 9999后重 新循环2 文件版本号 CHAR (2) 取值：02 3 文件产生时间 CHAR (14) Yyyymmddhhmmss 4 文件生成方系统代码 CHAR (3) 902 5 文件接收方系统代码 CHAR (8) 104 6 总记录数 CHAR (10) 右对齐，左补 0 7 正确处理记录数 CHAR (10) 右对齐，左补 0 8 备注 CHAR(40) 9 换行 CHAR (1) 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 111 必填 1 流水号 CHAR 18 M 流水号，格式为时间戳+序列号： YYYYMMDDHHMMSSxxxx，其中 xxxx为序 列号，从 0001 开始，排满 9999后重新 循环 2 Time CHAR 20 M 本话单记录产生的时间戳 3 MessageID CHAR 20 O VAC生成的唯一识别标识。标识多个请 求是属于同一个事务。 对于点播使用话单填写 LinkID 其他话单填空 4 SPID CHAR 8 M SP代码,做三方结算用 5 ServiceID CHAR 12 M SP的 SrvID， 对 应 原 SGIP+协 议 的 ServiceType 6 CPID CHAR 8 O CP代码，做结算用，当 CPID、SPID 字 段均存在时，以 CPID 进行结算；当 CPID 为空时，以 SPID 进行结算 7 ContentID CHAR 30 O 填写中国联通已分配了 ContentID的内 容 ID 8 AccessNo CHAR 21 O 联通在信、彩信产品接入号,业务使用 时的接入号 89 ServiceType CHAR 2 O 取值见附录 A7（业务类型） 910 SourceDevice_Type CHAR 4 O 发送端设备类型 1011 SourceDevice_ID CHAR 20 O 发送端设备标识 1112 CDRType integer 4 M CDR类型，如点到点、点到应用等 1：MOAT（移动用户始发、应用终止） 2：AOMT（应用始发、移动用户终止） 3：MOMT（移动用户始发、移动用户终 止） 4：MOET（移动用户始发、Email 终止） 5：EOMT（Email 始发、移动用户终止） 9：Other（其他） 1213 ProductID CHAR 8 M CRM侧产品 ID 1314 SPC_ProductID CHAR 12 M CRM侧构成产品代码 1415 SP_ ProductID CHAR 12 M PRM侧 SP 产品代码 1516 OrderMethod CHAR 4 M 订购渠道，取值见附录 A 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 112 1617 PushId CHAR 20 O 推荐人(发展人)ID 1718 OAMDN CHAR 21 O 发起方手机号码,无手机号填空 1819 DAMDN CHAR 21 O 接收方手机号码,无手机号填空 1920 FAMDN CHAR 21 M 付费方手机号码。 对于赠送业务与使用方手机号码不同； 对于自用业务付费方号码与使用方号 码一致 21 UserType CHAR 1 M 用户付费类型 0 后付费 1 预付费 2022 StartTime CHAR 14 M 会话开始时间，Yyyymmddhhmmss 2123 EndTime CHAR 14 M 会话结束时间，Yyyymmddhhmmss 2224 TimeSec integer 6 O 时长（秒） 2325 InputOctets integer 10 O 上行流量（字节） 2426 OutputOctets integer 10 O 下行流量（字节） 2527 FeePoint integer 1 O 点播的计费点(点播按次，第一条 MT扣 费,按条，每条都扣费) 0：不是计费点 1：是计费点 2628 计费类型 CHAR 10 O 计费类型，该字段不能为空。 0：不计费，仅用于核减SP对称的信 道费； 1：免费； 2：按条/次计费； 3：按包月收取； 4：封顶计费 5：按流量计费 6：按时长计费 7：包多月计费 2729 费用 CHAR 10 O 业务信息费(分) 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 113 2830 系统保留 1 CHAR 10 O Resv1 2931 系统保留 2 CHAR 10 O Resv2 3032 换行 CHAR 1 M \n 　回执文件体 　 <根目录> /<VSP>/<SSID（3位）>/<CDR>/<response>/<bad>：没有回执文件体 <根目录>/<VSP>/<SSID（3位）>/<CDR>/<response>/<right>：没有回执文件体 <根目录> /<VSP>/<SSID（3位）>/<CDR>/<response>/<semiwrong>：回执文件体如下 序号 属性 长度 备注 1 首错误字段位置 CHAR（2） 首次出现错误的字段在本记录中的序号 2 分隔符 CHAR（2） :: 3 原文件记录体 CHAE 4 分隔符 CHAR（2） :: 5 错误代码 CHAR (3) 6 换行 1 \n 　回执文件错误代码 错误代码 说明 001 流水号异常 100 字段值超范围定义 120 话单类型超范围定义 130 业务类型超范围定义 140 业务代码超范围定义 150 内容代码超范围定义 160 SP代码不存在 170 用户不存在 200 字段个数不符 300 非法字符 400 字段类型错误 500 对应关系不存在 600 金额有异议 700 该条记录为重单 701 详单的“起始时间”超出时间限制 800 “备注”信息含义不清晰 900 系统异常 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 114 7　VAC与 OCS系统的接口要求 7　 参见<<045-中国联通IT系统 BSS系统域 在线计费系统接口规范-VASP／VAC分册 _20081117>> 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 115 附　录　A 附　录　B（规范性附录） 附　录　A信息编码 附　录　C 　SP/CP企业代码（SPID:X1X2X3X4X5X6X7X8，X6X7X8三位预留） 　 企业代码用于在中国联通移动数据业务中唯一标识企业，用以接入数据业务平台，并作 为计费、结算等的依据，由数字组成。为兼容现网企业代码长度最长8位(如在信，最长5位) 其中：  X1X2为地区位，由按地区分配给各个省分公司及，其数值为“10～99” ；   X3X4X5为顺序位，由各省分公司和按CP/SP接入次序分配，其数值为“000～999”。  表1　和各省分公司 CP/SP 企业代码分配号段 大区 省分公司 企业代码 大区 省分公司 企业代码 90 000～ 99 999 山东 41 000～ 41 999 北京 北京 11 000～ 11 999 华中 河南 42 000～ 42 999 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 116 天津 12 000～ 12 999 湖南 43 000～ 43 999 山西 13 000～ 13 999 湖北 44 000～ 44 999 河北 14 000～ 14 999 辽宁 51 000～ 51 999 内蒙古 15 000～ 15 999 吉林 52 000～ 52 999 上海 21 000～ 21 999 东北 黑龙江 53 000～ 53 999 安徽 22 000～ 22 999 四川 71 000～ 71 999 福建 23 000～ 23 999 云南 72 000～ 72 999 上海 江西 24 000～ 24 999 贵州 73 000～ 73 999 深圳 31 000～ 31 999 西南 重庆 74 000～ 74 999 广东 32 000～ 32 999 陕西 81 000～ 81 999 广西 33 000～ 33 999 新疆 82 000～ 82 999 海南 34 000～ 34 999 甘肃 83 000～ 83 999 华南 澳门 35 000～35999 江苏 61 000～ 61 999 青海 84 000～ 84 999 江浙 浙江 62 000～ 62 999 西北 宁夏 85 000～ 85 999 SP/CP企业代码必须在接入时由联通统一分配。 PRM具体生成企业代码时，X6X7X8不分配，只生成5位企业代码传递给VAC，并由vac传递 给增值系统处理。 　SP/CP归属地域（XXXXXYYY） 　 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 117 SP/CP归属地域编码规则为XXXXXYYY，其中XXXXX为国家代码（见节国家/地区编码）， YYY为省份/洲代码（其中如果XXXXX为00086时，YYY为省份代码，见中国联通省分代码； XXXXX为其他值时，YYY没有确认时默认000）。 　SP接入码（accessNo:X1X2X3X4X5X6X7X8） 　 SP接入码按照信部电[2006]393号《信息产业部关于调整和统一短消息类服务接入代码 的通告》的规则进行编码。 　　SP状态（X） 编码 说明 0 待审批 1 测试中 2 正常 3 暂停；(SP不能申请业务,用户不能订购和点播此 SP业务, 老用户可继续使用, 但下免费话单[即停止为 SP/CP代收 费])暂停；(SP不能申请业务,用户不能订购此 SP业务) 4 冻结；(以前订购的业务都不能使用, 不扣费)冻结；(以 前订购的业务都不能使用) 5 注销；(SP彻底下线,业务彻底不能用) 　业务代码（ServiceID:X1X2X3X4X5X6X7X8X9X10，X9X10：预留） 　 联通公司对所有增值业务实行统一管理，所有向用户提供的业务由联通公司统一制订业 务代码。 为了对这些业务进行区分，联通公司为每个SP提供的业务分配一个业务代码。业务代码 需要全局唯一。一个业务代码唯一对应一个SP企业代码。 业务代码采用最长10位字符表示，合法的字符包括数字（0～9）或混合大写字母（A～Z）。 系统需要根据不同的业务平台决定是否产生不同长度带字母的业务代码(如彩信产品代码长 度是10位，业务代码长度必须是小于8位) 业务代码的格式： X1X2：各个业务平台的代码 X3X4：省分代码 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 118 X5X6X7X8X9X10：服务码 X9X10：预留 其中，业务平台类型代码为2位个数字，每个代表的含义如下：具体含义见。 10：预留 11：10155 12：10156 13：10157 14：WAP PULL 15：WAP PUSH 16：预留 17：下载 18：预留 19：定位 20：炫铃 21：流媒体 22：预留 23：在信 24：10158 25：10159 26：预留 27：彩信业务 28：彩信点对点 30：EMP 40：USSD 省分代码：为2位长的数字串，具体取值见下表（实际上，此处省分代码取的是联通省 分代码中编码值的后两位，只有中国联通的取值是特殊的） 编码值 对应省分名称 00 中国联通 10 内蒙古 11 北京 13 天津 17 山东 18 河北 19 山西 30 安徽 31 上海 34 江苏 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 119 编码值 对应省分名称 36 浙江 38 福建 50 海南 51 广东 59 广西 70 青海 71 湖北 74 湖南 75 江西 76 河南 79 西藏 81 四川 83 重庆 84 陕西 85 贵州 86 云南 87 甘肃 88 宁夏 89 新疆 90 吉林 91 辽宁 97 黑龙江 PRM具体生成业务代码时，PRM按照8位分配，X9X10不分配；PRM将生成的8位代码传递给 vac，并由vac传递给增值系统处理。 　合作伙伴产品代码（ProductID:X1X2X3X4X5X6X7X8X9X10X11X12） 　 产品代码为12位代码，合法的字符包括数字（0~9）和或混合大写字母（A~Z），其中X1～ X10为节描述的业务代码。X11X12按顺序编码。 产品代码保证全局唯一。一个产品代码唯一对应一个业务代码，一个业务代码下可以有 多个产品代码。产品代码长度要适应现网，如彩信产品代码最长10位 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 120 CRM具体生成产品代码时，按照“业务代码+ 2位产品顺序编码”方式生成；即实际产品 代码为10位（8位业务代码+ 2位产品顺序编码），CRM将生成的10位代码传递给vac，并由vac 传递给增值系统处理。 　　业务类型代码（X1X2） 编码 说明 01 业务（C网） 02 业务（C网） 04 WAP PUSH 05 G网 WAP业务（PULL） 10 手机报 20 JAVA业务（C网） 21 G网 JAVA业务 30 IMAP4业务（C网） 31 SP彩信 MMS业务 32 点对点彩信业务 40 精定位业务 41 GIS 42 粗定位业务 50 IVVR业务 51 视频上传分享 52 视频监控 53 手机搜索 54-69 3G业务预留 70 CRBT（炫铃） 75 上网卡 80 流媒体 81 UWEB（视讯新干线） 90 SMS（联通在信） 91 短信卡业务 92 UEC（证券电子商务） 93 IVR业务 94 EMP 95 USSD 99 组合业务 95 USSD 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 121 　　业务状态编码（X） 编码 说明 0 待审批 1 测试中 2 正常商用 3 暂停代收费(业务不能再订购和点播，但已经订购该业务 的用户还可以继续使用该业务, 下免费话单)暂停代收费 (业务不能再订购，但已经订购该业务的用户还可以继续 使用该业务) 4 暂停端口(新老用户都不能订购和使用,不得扣费) 5 下线 　　产品状态编码（X） 编码 说明 1 审核通过，待测试 2 预发布、测试，测试用户可用， 3 发布 4 生效 5 暂停代收费 (产品的老用户可继续使用,下免费话单（即 停止为 SP/CP代收费），同时不允许新用户订购或使用) 6 暂停端口 (SP/CP产品在暂停期间新老用户都不能订购和 使用,不得扣费) 7 下线（清理老用户订购关系,新用户不能订购或使用） 　　计费单位（X） 编码 说明 0 其它，需在“详单备注”中加以说明。 1 按时长（秒） 2 按次数（次） 3 按流量（字节） 4 按栏目 5 栏目与时长组合 6 栏目与次数组合 7 栏目与流量组合 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 122 　　计费类型（X） 编码 说明 0 其它，需在“详单备注”中加以说明。 1 普通 2 免费 3 包月 4 包天 　费率描述代码(X1X2X3X4X5X6X7X8X9X10 X11X12X13X14X15 X16 X17 X18 X19 X20) 　 费率描述代码为变长，最大长度为20位，由数字串组成。 其中X1X2X3X4X5表示产生代码系统，为变长，具体取值如下表： X1X2X3X4X5编码 说明 901 增值业务结算平台 902 接入管理平台 903 WAP 业务平台 904 业务平台 905 业务平台 906 BREW业务平台 907 JAVA业务平台 908 IMAP4业务平台 909 LBS业务平台 大中 SP/CP企业代 码的 X1X2X3X4X5 大中 SP/CP自己计费时的企业代码 其中： X6表示计费单位，取值见节《计费单位》； X7X8X9X10 X11X12X13X14X15 X16 X17 X18 X19 X20表示费率代码，为定长14位。 　优惠描述代码（X1X2X3X4X5X6X7X8X9X10 X11X12X13X14X15X16X17X18X19X20） 　 优惠描述代码为变长，最大长度为20位，由数字串组成。 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 123 其中X1X2X3X4X5表示代码产生系统，为变长，具体取值如下表： X1X2X3X4X5编码 说明 901 增值业务结算平台 902 接入管理平台 903 WAP 业务平台 904 业务平台 905 业务平台 906 BREW业务平台 907 JAVA业务平台 908 IMAP4业务平台 909 LBS业务平台 大中 SP/CP企业代 码的 X1X2X3X4X5 大中 SP/CP自己计费时的企业代码 其中： X6表示优惠类别，X6＝0 表示详单级优惠，X6＝1 表示帐务级优惠； X7X8X9X10 X11X12X13X14X15 X16X17X18X19X20，表示优惠代码，为定长 14位。 　　定购渠道（X1X2） 编码 说明 00 不确定 01 营业厅面对面 02 客服电话 03 短信 04 Web网站 05 WAP门户 06 IVR 07 Brew保留 08 Java 09 SP门户 10 营销渠道批量操作 11 营销渠道单个操作 12 移动互联网门户 13 手机客户端 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 124 14 视频 IVR 51 USSD 52 电话营销 　　系统编码（X1X2X3） 编码 说明 000 保留 104 综合营业系统 105 综合帐务系统 301 客服系统 400 综合结算系统 450 统一经营信息服务系统 900 增值业务综合管理平台 901 增值业务 SP结算平台 902 VAC 903 WAP业务平台 904 业务平台 905 业务平台 906 BREW业务平台 907 JAVA业务平台 908 IMAP4业务平台 909 LBS业务平台 910 总部 BSS 　　联通省分代码（X1X2X3） 省分公司编码 省分公司名称 001 中国联通 010 内蒙古 011 北京 013 天津 017 山东 018 河北 019 山西 022 澳门 030 安徽 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 125 省分公司编码 省分公司名称 031 上海 034 江苏 036 浙江 038 福建 050 海南 051 广东 059 广西 070 青海 071 湖北 074 湖南 075 江西 076 河南 079 西藏 081 四川 083 重庆 084 陕西 085 贵州 086 云南 087 甘肃 088 宁夏 089 新疆 090 吉林 091 辽宁 097 黑龙江 　　联通地市代码（X1X2X3） 省分编码 地市编码 地市名称 010 101 呼和浩特 010 102 包头 010 103 乌兰察布盟 010 104 伊克昭盟 010 105 巴延卓尔盟 010 106 乌海 010 107 赤峰 010 108 海拉尔 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 126 省分编码 地市编码 地市名称 010 109 通辽 010 111 锡林浩特 010 112 哲里木盟 010 113 兴安盟 010 114 阿盟 010 115 呼盟 011 110 北京 013 130 天津 017 150 淄博 017 151 滨州 017 152 威海 017 153 临沂 017 154 日照 017 155 潍纺 017 156 东营 017 157 枣庄 017 158 济宁 017 159 荷泽 017 160 莱芜 017 161 烟台 017 166 青岛 017 170 济南 017 172 泰安 017 173 德州 017 174 聊城 018 180 沧州 018 181 唐山 018 182 秦皇岛 018 183 廊坊 018 184 张家口 018 185 邢台 018 186 邯郸 018 187 保定 018 188 石家庄 018 189 承德 018 720 衡水 019 190 太原 019 191 晋中 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 127 省分编码 地市编码 地市名称 019 192 阳泉 019 193 大同 019 194 晋城 019 195 长治 019 196 运城 019 197 临汾 019 198 忻州 019 199 朔州 019 200 离石 022 220 澳门 030 300 马鞍山 030 301 蚌埠 030 302 安庆 030 303 芜湖 030 304 六安 030 305 合肥 030 306 阜阳 030 307 淮南 030 308 铜陵 030 309 巢湖 030 311 宣城 030 312 滁州 030 313 宿州 030 314 淮北 030 316 黄山 030 317 池州 031 310 上海 034 330 无锡 034 334 常熟 034 340 南京 034 343 镇江 034 346 连云港 034 348 盐城 034 349 宿迁 034 350 徐州 034 354 淮阴 034 358 南通 034 430 扬州 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 128 省分编码 地市编码 地市名称 034 440 常州 034 445 泰州 034 450 苏州 036 360 杭州 036 362 湖州 036 363 嘉兴 036 364 舟山 036 365 绍兴 036 367 金华 036 370 宁波 036 468 衢州 036 469 丽水 036 470 温州 036 476 台州 038 380 福州 038 384 龙岩 038 385 莆田 038 386 宁德 038 387 南平 038 389 三明 038 390 厦门 038 395 漳州 038 480 泉州 050 501 海口 050 502 三亚 050 503 儋州 051 510 广州 051 520 湛江 051 525 汕尾 051 526 揭阳 051 528 梅州 051 530 佛山 051 531 潮州 051 533 潮阳 051 535 清远 051 536 肇庆 051 538 云浮 051 540 深圳 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 129 省分编码 地市编码 地市名称 051 550 江门 051 556 中山 051 558 韶关 051 560 汕头 051 565 阳江 051 568 茂名 051 570 惠州 051 580 东莞 051 620 珠海 051 670 河源 051 678 顺德 059 588 贺州 059 589 贵港 059 590 防城港 059 591 南宁 059 592 桂林 059 593 柳州 059 594 梧州 059 595 玉林 059 596 百色 059 597 钦州 059 598 河池 059 599 北海 070 700 西宁 070 701 海东 070 702 格尔木 070 703 德令哈 070 704 海西洲 070 705 海南洲 070 706 海北洲 071 710 武汉 071 711 宜昌 071 712 荆州 071 713 仙桃 071 714 黄冈 071 715 黄石 071 716 襄樊 071 717 孝感 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 130 省分编码 地市编码 地市名称 071 718 鄂州 071 719 咸宁 071 721 十堰 071 722 神农架 071 723 随州 071 724 荆门 071 725 天门 071 726 潜江 071 727 恩施 074 741 长沙 074 742 株州 074 743 湘潭 074 744 衡阳 074 745 岳阳 074 746 浏阳 074 747 益阳 074 748 郴州 074 749 常德 074 791 娄底 074 792 邵阳 074 793 吉首 074 794 张家界 074 795 怀化 074 796 永州 075 740 景德镇 075 750 南昌 075 751 吉安 075 752 赣州 075 753 新余 075 754 鹰潭 075 755 九江 075 756 宜春 075 757 上饶 075 758 萍乡 075 759 抚州 076 760 郑州 076 761 洛阳 076 762 开封 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 131 省分编码 地市编码 地市名称 076 763 焦作 076 764 新乡 076 765 许昌 076 766 漯河 076 767 安阳 076 768 商丘 076 769 平顶山 076 770 周口 076 771 驻马店 076 772 三门峡 076 773 濮阳 076 774 鹤壁 076 775 济源 076 776 信阳 076 777 南阳 076 778 潢川 079 790 拉萨 081 810 成都 081 811 雅安 081 812 西昌 081 813 攀枝花 081 814 乐山 081 815 泸州 081 816 内江 081 817 宜宾 081 818 自贡 081 819 眉山 081 820 达川 081 821 遂宁 081 822 南充 081 823 广安 081 824 绵阳 081 825 德阳 081 826 广元 081 827 巴中 081 828 康定 081 829 马尔康 081 830 资阳 中国联通 VAC 平台接口技术要求：VAC 与 BSS 接口规范（） 132 省分编码 地市编码 地市名称 083 831 重庆 083 832 涪陵 083 833 万县 083 834 黔江 083 835 巫山 084 840 宝鸡 084 841 西安 084 842 延安 084 843 渭南 084 844 咸阳 084 845 榆林 084 846 铜川 084 847 商洛 084 848 安康 084 849 汉中 085 785 铜仁 085 786 凯里 085 787 遵义 085 788 都匀 085 789 安顺 085 850 贵阳 085 851 毕节 085 852 兴义 085 853 六盘水 086 730 德宏 086 731 保山 086 732 文山 086 733 临沧 086 734 怒江 086 735 迪庆 086 736 西双版纳 086 860 昆明 086 861 红河 086

    合作伙伴

    卓越管理

    关注 进入主页

    标签

    通讯埠 业务管理 增值业务 业务支持 中国联通公司
    未登录

    联系我们

    智库文档公众号

    客服微信

    ©2026 MBAlib.com, All rights reserved.

    闽公网安备 35020302032707号

    分享
    分享至
    微信扫码
    QQ
    微博
    加入专题
    收藏
    用手机看文档

    扫一扫,手机看文档

    TOP
    全屏
    放大
    缩小
    /152
    下载
    开通VIP
    下载即可得无水印文档
    ×
    加入专题
    + 创建新的文档专题
    确定
    开通
    VIP
    微信客服

    微信扫码联系客服
    微信
    服务号
    用户反馈
    下载APP