我国联通综合营帐系统接口规范d.doc

中国中国联联通通综综合合营帐营帐系系统统接口接口规规范范 中国中国联联合通信有限公司合通信有限公司 2001 年年 6 月月 1 概述 10 1 1 接口定义原则 10 1 2 接口使用要求 11 1 2 1 综合营帐系统管理者 11 1 2 2 系统集成商 12 1 3 参考文献 12 2 接口总体描述 14 2 1 软件体系结构 14 2 2 接口总体描述 15 2 3 接口实现原则 17 2 4 接口参考点 18 2 4 1 F1 接口 19 2 4 2 A1 接口 19 2 4 3 A2 接口 20 2 4 4 B1 接口 20 2 4 5 B2 接口 21 3 接口实现机制 22 3 1 工单流转接口实现机制 22 3 1 1 基于交易中间件 22 3 1 2 基于消息中间件 23 3 1 3 基于过程调用和共享数据表 25 3 2 批量数据接口实现机制 25 3 2 1 传输方式 25 3 2 2 传输协议 26 3 2 3 传输过程 26 4 与 GSM CDMA 营帐系统接口 27 4 1 营业受理 27 4 1 1 新装业务接口具体实现 27 4 1 2 过户业务接口具体实现 44 4 1 3 停 开机业务接口具体实现 50 4 1 4 退网申请业务接口具体实现 53 4 1 5 退网业务接口具体实现 56 4 1 6 取消退网申请业务接口具体实现 60 4 1 7 业务变更业务接口具体实现 64 4 1 8 客户资料变更业务接口具体实现 67 4 1 9 改号业务接口具体实现 72 4 1 10 预约选号业务接口具体实现 76 4 1 11 换卡补卡业务接口具体实现 77 4 1 12 租用业务接口具体实现 81 4 1 13 详单查询业务接口具体实现 88 4 1 14 帐务查询业务接口具体实现 91 4 1 15 合并客户业务接口具体实现 95 4 1 16 拆分客户业务接口具体实现 98 4 1 17 工单查询业务接口具体实现 98 4 2 信用管理 防欺诈 101 4 2 1 信用度与黑红名单评定业务接口具体实现 101 4 2 2 信用控制业务接口具体实现 107 4 3 综合帐务 112 4 3 1 优惠套餐上传接口具体实现 112 4 3 2 帐单上传接口具体实现 115 4 3 3 调帐数据下传接口具体实现 119 4 3 4 销帐 122 4 3 5 返销帐 125 4 3 6 呆坏帐处理业务接口具体实现 128 4 3 7 无主话单查询业务接口具体实现 133 4 4 缴费 136 4 4 1 缴款业务接口具体实现 136 4 4 2 退款业务接口具体实现 140 4 4 3 滞纳金管理业务接口具体实现 141 4 5 基于智能网的 GSM 预付费系统接口 144 4 5 1 用户资料查询业务接口具体实现 144 4 5 2 消息序列图 144 4 5 3 用户月结帐单查询接口具体实现 148 4 5 4 用户实时话费查询接口具体实现 151 4 5 5 用户详细话单查询接口具体实现 154 4 5 6 用户帐户余额查询接口具体实现 157 4 5 7 预付费卡充值业务接口具体实现 160 5 与 BP 业务接口 164 5 1 入网业务接口具体实现 164 5 1 1 消息序列图 164 5 1 2 工单流转说明 164 5 1 3 号码资源查询接口服务单元 165 5 1 4 号码选占操作接口服务单元 167 5 1 5 入网业务接口服务单元 169 5 1 6 业务完工业务接口服务单元 173 5 2 停 开机业务接口具体实现 176 5 2 1 消息序列图 176 5 2 2 工单流转说明 176 5 2 3 销帐接口服务单元 176 5 2 4 停 开机接口服务单元 177 5 2 5 业务完工接口服务单元 179 5 3 退网业务接口具体实现 179 5 3 1 消息序列图 179 5 3 2 工单流转说明 180 5 3 3 销帐接口服务单元 180 5 3 4 退网接口服务单元 181 5 3 5 业务完工接口服务单元 183 5 4 业务变更业务接口具体实现 183 5 4 1 消息序列图 183 5 4 2 工单流转说明 184 5 4 3 业务变更接口服务单元 184 5 4 4 业务完工接口服务单元 186 5 5 客户资料变更业务接口具体实现 187 5 5 1 消息序列图 187 5 5 2 工单流转说明 187 5 5 3 客户资料变更接口服务单元 187 5 6 租用业务接口具体实现 192 5 6 1 消息序列图 192 5 6 2 工单流转说明 192 5 6 3 号码资源查询接口服务单元 193 5 6 4 号码选占接口服务单元 193 5 6 5 租用业务接口服务单元 193 5 6 6 业务完工接口服务单元 197 6 与长话营帐系统接口 198 6 1 联机工单接口具体实现 198 6 1 1 消息序列图 198 6 1 2 消息序列说明 198 6 1 3 联机工单接口服务单元 199 6 2 用户资料变更接口具体实现 202 6 2 1 消息序列图 202 6 2 2 消息序列说明 202 6 2 3 用户资料变更接口服务单元 202 6 3 帐户资料变更接口具体实现 206 6 3 1 消息序列图 206 6 3 2 消息序列说明 206 6 3 3 帐户资料变更接口服务单元 207 6 4 客户资料变更接口具体实现 210 6 4 1 消息序列图 210 6 4 2 消息序列说明 210 6 4 3 客户资料变更接口服务单元 211 6 5 新建客户接口具体实现 214 6 5 1 消息序列图 214 6 5 2 消息序列说明 214 6 5 3 新建客户接口服务单元 214 6 6 合并客户业务接口具体实现 218 6 6 1 消息序列图 218 6 6 2 消息序列说明 218 6 6 3 客户合并接口服务单元 218 6 7 拆分客户业务接口具体实现 221 6 7 1 消息序列图 221 6 7 2 消息序列说明 221 6 7 3 拆分客户接口服务单元 222 6 8 用户资料查询接口具体实现 226 6 8 1 消息序列图 226 6 8 2 消息序列说明 226 6 8 3 用户资料查询接口服务单元 226 6 9 帐户资料查询接口具体实现 230 6 9 1 消息序列图 230 6 9 2 消息序列说明 230 6 9 3 帐户资料查询接口服务单元 230 6 10 客户资料查询接口具体实现 234 6 10 1 消息序列图 234 6 10 2 消息序列说明 234 6 10 3 客户资料查询接口服务单元 235 6 11 详单查询业务接口具体实现 238 6 11 1 消息序列图 238 6 11 2 消息序列说明 238 6 11 3 详单查询接口服务单元 238 6 12 帐务资料查询接口具体实现 242 6 12 1 消息序列图 242 6 12 2 消息序列说明 242 6 12 3 帐务查询接口服务单元 242 6 13 合并帐户业务接口具体实现 246 6 13 1 消息序列图 246 6 13 2 消息序列说明 246 6 13 3 申请合并帐户接口服务单元 247 6 14 拆分帐户业务接口具体实现 249 6 14 1 消息序列图 249 6 14 2 消息序列说明 249 6 14 3 申请拆分帐户接口服务单元 250 6 15 新建帐户业务接口具体实现 252 6 15 1 消息序列图 252 6 15 2 消息序列说明 253 6 15 3 申请新建帐户接口服务单元 253 6 16 缴费业务接口具体实现 256 6 16 1 消息序列图 256 6 16 2 消息序列说明 256 6 16 3 缴费接口服务单元 257 6 17 销帐业务接口具体实现 259 6 17 1 消息序列图 259 6 17 2 消息序列说明 260 6 17 3 申请销帐接口服务单元 260 6 18 返销业务接口具体实现 263 6 18 1 消息序列图 263 6 18 2 消息序列说明 263 6 18 3 返销业务接口服务单元 263 6 19 退款业务接口具体实现 266 6 19 1 消息序列图 266 6 19 2 消息序列说明 266 6 19 3 退款接口服务单元 266 6 20 信用管理接口具体实现 269 6 20 1 消息序列图 269 6 20 2 消息序列说明 269 6 20 3 高额状况接口服务单元 270 6 20 4 费用分担接口服务单元 272 6 21 业务停开接口具体实现 275 6 21 1 消息序列图 275 6 21 2 消息序列说明 275 6 21 3 业务停开接口服务单元 275 6 22 申请新业务接口具体实现 278 6 22 1 消息序列图 278 6 22 2 消息序列说明 278 6 22 3 申请新业务接口服务单元 279 6 23 客户过户接口具体实现 283 6 23 1 消息序列图 283 6 23 2 消息序列说明 283 6 23 3 申请业务过户接口服务单元 283 6 24 业务过户接口具体实现 287 6 24 1 消息序列图 287 6 24 2 消息序列说明 288 6 24 3 申请业务过户接口服务单元 288 6 25 改号业务接口具体实现 291 6 25 1 消息序列图 291 6 25 2 消息序列说明 291 6 25 3 客户设备号码变更接口服务单元 292 6 26 业务变更接口具体实现 294 6 26 1 消息序列图 294 6 26 2 消息序列说明 294 6 26 3 业务变更接口服务单元 295 6 27 业务注销申请接口具体实现 298 6 27 1 消息序列图 298 6 27 2 消息序列说明 298 6 27 3 业务注销申请接口服务单元 298 6 28 业务注销接口具体实现 301 6 28 1 消息序列图 301 6 28 2 消息序列说明 302 6 28 3 业务注销接口服务单元 302 6 29 取消业务注销申请接口具体实现 305 6 29 1 消息序列图 305 6 29 2 消息序列说明 305 6 29 3 取消业务注销申请接口服务单元 305 6 30 客户注销申请接口具体实现 308 6 30 1 消息序列图 308 6 30 2 消息序列说明 308 6 30 3 客户注销申请接口服务单元 309 6 31 客户注销接口具体实现 312 6 31 1 消息序列图 312 6 31 2 消息序列说明 312 6 31 3 客户注销接口服务单元 312 6 31 4 帐户注销接口服务单元 315 6 32 取消客户注销申请接口具体实现 318 6 32 1 消息序列图 318 6 32 2 消息序列说明 318 6 32 3 取消客户注销申请接口服务单元 318 6 33 信用度变更接口具体实现 321 6 33 1 消息序列图 321 6 33 2 消息序列说明 321 6 33 3 信用度变更接口服务单元 322 7 与 IP 营帐系统接口 326 7 1 自动开户业务接口具体实现 326 7 1 1 消息序列图 326 7 1 2 工单流转说明 326 7 1 3 自动开户户接口服务单元 326 7 2 专线 或 VPN 开户接口具体实现 331 7 2 1 消息序列图 331 7 2 2 工单流转说明 331 7 2 3 IP 资源查询接口单元 332 7 2 4 开户接口服务单元 334 7 3 工单查询接口具体实现 338 7 3 1 消息序列图 338 7 3 2 工单流转说明 338 7 3 3 工单查询接口服务单元 339 7 4 回单接口具体实现 341 7 4 1 消息序列图 341 7 4 2 工单流转说明 341 7 5 密码修改接口具体实现 343 7 5 1 消息序列图 343 7 5 2 工单流转说明 343 7 6 客户基本信息变更接口具体实现 346 7 6 1 消息序列图 346 7 6 2 工单流转说明 346 7 7 资费上传接口具体实现 350 7 7 1 消息序列图 350 7 7 2 工单流转说明 350 7 8 服务更换接口具体实现 352 7 8 1 消息序列图 352 7 8 2 工单流转说明 352 7 9 用户状态变更接口具体实现 356 7 9 1 消息序列图 356 7 9 2 工单流转说明 356 7 10 卡激活接口具体实现 358 7 10 1 消息序列图 358 7 10 2 工单流转说明 359 7 11 卡号查询接口具体实现 361 7 11 1 消息序列图 361 7 11 2 工单流转说明 361 7 12 卡充值接口具体实现 364 7 12 1 消息序列图 364 7 12 2 工单流转说明 364 7 13 详单查询接口具体实现 366 7 13 1 消息序列图 366 7 13 2 工单流转说明 366 7 13 3 详单查询接口服务单元 367 7 14 帐单传递接口具体实现 370 7 14 1 消息序列图 370 7 14 2 工单流转说明 370 7 14 3 帐单传递接口服务单元 370 7 15 销帐接口具体实现 374 7 15 1 消息序列图 374 7 15 2 工单流转说明 374 7 15 3 销帐接口服务单元 374 7 16 反销帐接口具体实现 376 7 16 1 消息序列图 376 7 16 2 工单流转说明 377 7 16 3 反销帐接口服务单元 377 7 17 预付用户余额查询接口具体实现 379 7 17 1 消息序列图 379 7 17 2 工单流转说明 379 7 17 3 预付用户余额查询接口服务单元 379 7 18 卡残值转移的接口具体实现 382 7 18 1 消息序列图 382 7 18 2 工单流转说明 382 7 18 3 卡余额查询接口服务单元 382 7 18 4 卡残值转移接口服务单元 382 8 附录 中国联通综合营帐系统接口信息编码规则 385 8 1 概述 385 8 1 1 编码范围 385 8 1 2 编码原则 385 8 1 3 编码使用方法 385 8 2 第一段 X1X2 编码映射表 386 8 3 第二段 X3X4X5 编码映射表 386 8 4 第三段 X6X7X8 编码映射表 388 1 概述概述 中国联通作为国内唯一一家对所有电信业务拥有经营权的电信运营商 拥有全国范围 内相当规模的公用电信网 经营多种基础电信业务和增值电信业务 形成移动 长途 国 际 数据 165 IP 电话 电子商务 寻呼 增值业务 市话等多种业务并存共同发展的 格局 为了充分发挥综合优势 实现灵活多变的营销策略 实现多种业务 一台清 一单 清 为客户提供统一的 综合的 规范化的高质量服务 中国联通推出了综合营帐系统 由于目前中国联通已建和在建的营业及帐务系统基本上是分专业独立建设 管理机制上采用分项管理 加之各业务已有的营帐系统建设厂家多 数据量大 系统结构复杂 因此综合营帐系统的建设将是一个复杂而艰巨的任务 为了充 分保证系统的规范性和开放性 特提出综合营帐系统接口规范 本接口规范以 中国联通综合营帐系统总体方案 中国联通综合营帐系统业务规范 和 中国联通综合营帐系统技术规范 为依据 在充分采纳广大厂家和分公司建议的基础 上 经过联通信息系统部综合营帐系统接口规范小组的反复讨论制定 接口规范将作为 中国联通综合营帐系统技术规范 的附件推出 和 中国联通综合 营帐系统总体方案 中国联通综合营帐系统业务规范 中国联通综合营帐系统技术规 范 一起对综合营帐系统的建设起到约束和指导作用 1 1 接口定义原则接口定义原则 本规范所规定的接口是综合营帐子系统与各专业计费子系统之间的接口 以实现系统间的工单调度 考虑到综合营帐子系统应该是消除各业务处理差别 的环节 同时要求现有各专业计费子系统修改其与帐务接口的数据格式的工作 量非常巨大 因此综合营帐子系统与各专业计费子系统之间的接口标准应尽量 适应现有专业计费子系统 综合营帐系统与个专业系统接口应达到如下目标 接口简单明了 便于形成 操作和传输 并尽量满足现在和将 来的需求 接口能灵活地支撑综合营帐系统和各专业系统的业务需求 综合营帐系统与各专业系统的接口应充分考虑安全性 适用性 不影响综合营帐系统和专业系统的安全性能和业务性能 为了保证综合营帐系统与各专业子系统方便 可靠地接口 实现综合营帐 系统的规范性 开放性 扩展性 业务独立性 接口定义应满足如下原则 使用简单 快捷的方式实现综合营帐系统与各专业子系统的接口 接口规范应充分考虑综合营帐系统与各专业子系统的应用扩展情况 保证接口数据在综合营帐系统与各专业子系统的一致性 接口数据能够方便的形成 并能在被接口方顺利地倒入 在接口数据交互过程中 应具有数据传送和接收传送后的确认过程 在满足要求的前提下 使接口数据量最少 接口数据传输控制策略可靠且完善 具有可靠的接口数据出错处理机制 此外 为方便对联通各省综合营帐系统进行统一管理与集中监控 省级综 合营帐系统在具体建设过程中 应该考虑向上级管理与监控中心提供所需系统 软硬件运行状况等必要信息 并开放相应管理接口 1 2 接口使用要求接口使用要求 综合营帐系统接口规范适用于中国联合通信有限公司运营的所有业务建设 指导 包括 GSM CDMA 长途 互联网 IP 市话 寻呼及各种业务的增值 业务 也包括以后出现的新业务 本接口规范的使用者为中国联通综合营帐系统管理者 综合营帐系统集成 商和各专业营帐系统集成商 1 2 1 综合营帐系统管理者综合营帐系统管理者 各联通分公司应严格按照接口规范对试点和试验系统进行验收 对严 重违反规范的 特别是在体系结构上与规范相差较大的系统 将不予 验收 各联通分公司综合营帐系统建设部门在与其他业务部门协调过程中 如遇到业务部门无法提供的接口内容 需要以正式文本的方式提交总 部信息系统部 各联通分公司在综合营帐系统建设过程中 可以根据实际情况就接口 规范中存在的问题 以 E mail 传真或正式文本的方式向总部提交建 议 1 2 2 系统集成商系统集成商 各厂家必须严格按照接口规范进行系统的开发 在开发过程中 如有和规范不一致的地方 各厂家需要以正式文本的 方式写出不一致的地方 为什么不同以及自己是怎样实现的 同时还 要明确写出可能对其他系统的影响 通过 E MAIL 传真或快递信函 的方式提交联通总部信息系统部 1 3 参考文献参考文献 中国联通综合营帐系统总体方案 中国联通综合营帐系统业务规范 中国联通综合营帐系统技术规范 中国联通 CDMA 专业计费子系统总体方案 中国联通 CDMA 专业计费子系统业务规范 中国联通 CDMA 专业计费子系统技术规范 中国联通客户服务系统技术规范 试行 中国联通企业内部网 IP 地址规划 草案 中国联通客户服务系统接口规范 T1 接口标准 V1 1 中国联通客户服务系统接口规范 T2 接口标准 V1 1 中国联通客户服务系统接口规范 S1 接口标准 V1 1 中国联通客户服务系统接口规范 S3 接口标准 V1 1 中国联通客户服务系统接口规范 H1 接口标准 V1 1 中国联通客户服务系统接口规范 H2 接口标准 V1 1 中国联通客户服务系统接口规范 H3 接口标准 V1 1 中国联通客户服务系统接口规范 H 接口编码参考规范 V1 1 中国联通全国客服中心客户服务信息库信息模型 完整版 中国联通全国客服中心客户服务信息库信息模型 不含座席接入版本 2 接口总体描述接口总体描述 2 1 软件体系结构软件体系结构 投资 必须保证业务逻辑在多个层次上得以实现 保证消息和数据能够得 到及时 有序的传递 保证统一客户资料与各专业系统数据的映射对应关系 应用软件体系采用三层客户 服务器体系结构 如下图所示 综合业务逻辑 统一客户资料 等数据 GSM客户 资料等数 据 193子系统 业务逻辑 GSM子系统 业务逻辑 GUI 表 示 层 业 务 逻 辑 层 数 据 层 浏览器 综合营业 业务逻辑 综合帐务 业务逻辑 信用 防欺诈管理 业务逻辑 缴费 业务逻辑 GSM客户 资料等数 据 193客户 资料等数 据 软件体系结构图 软件应遵循三层体系结构 分述如下 1 表示层 实现用户交互和数据表示 为下面的处理收集数据 向第 二层业务逻辑层发出请求 并显示处理结果 这一层功能的实现可以采 用 GUI 即图形用户界面 浏览器等方式实现 向业务逻辑层发起的 请求还可以来自于客服系统 银行缴费系统等 2 业务逻辑层 实现软件的业务逻辑处理 这一层又由两部分组成 1综合部分 即本次新建部分 根据 中国联通综合营帐系统总体方案 的规定 综合营帐系统共有五大功能模块 综合营业 综合帐务 缴费 信用 防欺诈管理 统一客户资料 2各专业系统业务逻辑 包括现有业务 GSM 165 数据 VOIP 193 长途 市话 寻呼等业务系统的业务逻辑部分 业务逻辑层通过接口响应表示层发起的请求 完成相应的业务处理并通过 相应的接口完成对数据的操作 在本系统中 专业系统业务逻辑不直接响应表 示层的请求 专业系统业务逻辑的请求只能来自于综合业务逻辑层 3 数据层 该层包括各专业系统的数据和本期新建的统一客户资料 图中的阴影部分表示原有各专业业务系统 这些专业业务系统对综合营帐 系统来说是一种特殊的数据资源 表示层不能直接对各种数据资源进行直接的操作 必须通过业务逻辑层 综合业务逻辑对原有各专业子系统数据的访问必须通过专业子系统的业务 逻辑层 而不能直接操作 其接口通信形式可以采用同步调用 异步调用 队 列 文件形式 数据库表形式等实现 2 2 接口接口总体描述总体描述 综合营帐系统提供 实现三种类型的接口 如下图所示 综合营帐 数据采集联机指令 专 业 计 费 综 合 结 算 综 合 营 业 综合帐务 信用 防欺 诈管理 缴费 统 一 客 户 资 料 客 户 客服 系统 大客户 系统 银行 邮政 客户关系管理 办公 自动 化 网管 专业营帐 GSM CDMA市话长途VoIP数据互联网SMS寻呼 综合营帐与专业营帐的接口 综合营帐与其它系统之间的接口 注 综合营帐的内部接口未在图中描述 详情请参见 综合营帐总体方案 1 内部接口 综合营帐系统所包含几个模块之间 某个模块对其他模块所要求调用及提 供的接口关系 2 外部接口 综合营帐系统与外部其它系统的接口 是综合营帐系统与其它系统的连接 并透明地进行数据交换和程序调用的逻辑层面 综合营帐系统主要与以下外部 系统存在接口 专业计费系统 综合结算系统 综合客服系统 大客户系统 银行 邮政等代缴费系统 网管系统 OA 财务等其他系统 3 与现有专业营帐系统接口 综合营帐系统与现有各专业营帐系统的接口 以实现系统各项功能 任务 的分派和调度 本接口规范就是要对此接口进行具体 详尽的描述与规定 2 3 接口实现原则接口实现原则 关于第三类接口 综合营帐系统与各专业营帐子系统之间的接口的实现 原则 如下图所示 综 合 营 帐 系 统 专 业 营 帐 子 系 统 193 市话 寻呼 VOIP 165 GSM 适 配 器 适 配 器 在具体实现时 应该在综合营帐系统与各专业营帐子系统通过适配器实现 双方的互连 考虑到综合营帐系统为一个新建系统 投资大 设计灵活 实现 方便 故综合营帐一方的适配器功能应该比各专业营帐子系统一方的适配器功 能强 做的工作多 总的原则就是综合营帐系统应该尽量向各现有专业营帐子 系统靠拢 同时对各专业营帐子系统的操作最好是增加而不是修改 而且对现 有系统的改动要做到最小 2 4 接口参考点接口参考点 根据综合营帐的体系结构 标准化参考点主要分为三个系列 F fulfillment 系列 A assurance 系列 B billing 系列 根据实际的完成的功能 规范参考点 如图为 F F1 1 专业计费 客 户 层 业 务 层 业务开通业务保障业务计量 网管层 网络 网元层 交换机 HLR等 资源层 联机处理指令 数据采集 综合 缴费 工单流转 专业业 务配置 统一客户资料 专业客户 资料 专业 信用 管理 防欺 诈 综合 信用 管理 防欺 诈 综合帐 务处理 综合业务受理 A A2 2 B B1 1B B2 2A A1 1 F F2 2 B B3 3 专业帐务处理 专业 缴费 3F1 综合营业受理实现资源配置和业务配置时与专业营业之间的参考 点 4F2 专业营帐为实现开通 关闭与网络层的接口 本规范对此暂不做 描述 5A1 综合营帐信用 防欺诈与专业信用 防欺诈之间的参考点 6A2 综合营帐的统一客户资料与各专业客户资料之间的参考点 7B1 综合帐务与各专业帐务之间的参考点 8B2 综合缴费与各专业缴费之间的参考点 2 4 1 F1 接口接口 F 接口是为实现业务开通功能 综合营业与专业营业之间交互的接口 参 考点 F1 是综合营帐进行业务开发和业务配置需要专业营业支撑的接口 接口功能和方式接口功能和方式 F1 接口是综合营帐和专业业务配置间的消息接口 F1 接口的消息或信息的传递基于 TCP IP 协议 或者基于通信 消息 中间件及 API 对于批量的业务可考虑采用文件 F1 接口的消息传递要求保证准确性和实时性 通过参考点 F1 综合营帐将业务逻辑映射成对各专业系统的业务开通控制 过程请求 交由各专业营帐控制功能实现对业务的配置与开通 消息类型消息类型 业务新建消息 业务变更消息 业务取消消息 业务关闭消息 业务查询消息 2 4 2 A1 接口接口 A 参考点是综合营帐进行业务保障与专业营帐之间的接口 A1 是综合营帐 信用 防欺诈与专业信用 防欺诈之间的参考点 接口功能和方式接口功能和方式 A1 接口是综合营帐和专业营帐信用防欺诈控制之间的接口 实现综合营帐 与专业营帐之间的信用同步 一致 并完成正确的信用控制 A1 接口的消息或 信息的传递基于 TCP IP 协议 或者基于通信 消息 中间件及数据库表和 API A1 接口的消息传递要求保证准确性和实时性 消息类型消息类型 同步信用信息消息 同步行为信息消息 防欺诈控制消息 信用 行为查询消息 防欺诈控制行为查询消息 2 4 3 A2 接口接口 A 参考点是综合营帐进行业务保障与专业营帐之间的接口 A2 是综合营帐 的统一客户资料与各专业客户资料之间的参考点 接口功能和方式接口功能和方式 A2 接口是综合客户资料与专业客户资料之间的接口 目前 综合客户资料 的管理功能实际分布在综合营业 综合帐务 信用 防欺诈 缴费各各自功能当 中 故目前的 A2 接口实际业是分布在各个功能当中 但考虑到建设综合营帐 的 最终目标 逻辑上应将客户资料的管理部分的接口统一在一起 A2 接口的 消息或信息的传递基于 TCP IP 协议 或者基于通信 消息 中间件及数据库表 文件和 API A2 接口的消息传递要求保证准确性和实时性 消息类型消息类型 新建客户资料 含帐户 用户 业务 信息 变更客户资料 含帐户 用户 业务 信息 同步客户资料 含帐户 用户 业务 信息 客户资料查询信息 2 4 4 B1 接口接口 B 参考点是综合营帐进行业务计量与专业营帐之间的接口 B1 是综合帐务 与各专业帐务之间的参考点 接口功能和方式接口功能和方式 B1 接口是综合营帐和专业营帐帐务处理之间的接口 实现综合营帐与专业 营帐之间的帐务数据同步 一致 并完成正确的帐务处理 B1 接口的消息或信 息的传递基于 TCP IP 协议 或者基于通信 消息 中间件及数据库表 文件和 API B1 接口的消息传递要求保证准确性和实时性 消息类型消息类型 业务使用数据消息 二次批价形成的详单 各业务累帐数据 各业务 出帐数据 业务控制消息 销帐 反销帐 调帐 呆坏帐管理 业务 数据查询消息 2 4 5 B2 接口接口 B 参考点是综合营帐进行业务计量与专业营帐之间的接口 B2 是综合缴费 与各专业缴费之间的参考点 接口功能和方式接口功能和方式 B2 接口是综合缴费与专业营帐之间的接口 以实现面向客户收缴费 B2 接口的消息或信息的传递基于 TCP IP 协议 或者基于通信 消息 中间件及数 据库表 文件和 API B2 接口的消息传递要求保证准确性和一定的实时性 消息类型消息类型 客户缴费消息 客户缴费查询消息 3 接口实现机制接口实现机制 3 1 工单流转接口实现机制工单流转接口实现机制 综合营帐系统与各专业子系统之间工单流转接口的实现主要采用 客户请 求 服务应答 的机制 通过同步或异步的通讯方式 具体实现机制主要包 括 基于交易中间件 基于消息中间件 基于过程调用和共享数据表 3 1 1 基于交易中间件基于交易中间件 基于交易中间件的接口 主要通过在中间件基础结构框架上实现的接口服 务调用来完成系统之间的协作和通信 通讯方式通讯方式 根据具体业务接口服务单元的定义 综合营帐系统与各专业子系统分别定 义为客户端或服务端 客户端与服务器端之间的通讯是透明的 底层的通讯实 现和各种传输的可靠性都是由交易中间件来保证的 域网关 域网关 应用域 工作站 工作站 事务管 理器 可靠队 列服务 应用域 事务管 理器 可靠队 列服务 系统之间的接口由交易中间件的应用域网关来实现 可以实现跨应用域的 全局事务控制 通讯协议通讯协议 接口应支持以下通讯协议 同步 异步 会话 通讯过程通讯过程 接口的通讯过程为 客户端申请调用服务端提供的接口服务 输入相关参 数 并等待服务端返回信息 服务端响应客户端的接口服务申请 进行业务逻 辑处理 返回业务处理结果 3 1 2 基于消息中间件基于消息中间件 基于消息中间件的接口机制主要通过消息传递来完成系统之间的协作和通 信 通讯方式通讯方式 根据具体业务接口服务单元的定义 综合营帐系统与各专业子系统分别定 义为客户端或服务端 客户端向服务端发送业务接口服务申请消息包 服务端 向客户端返回业务接口服务处理结果消息包 消息中间件应保证消息包传输过程的正确 可靠和及时 Sender Receiver Messagin g System Messagin g System Messaging System Store and 消息中间件的应提供以下基本功能 消息队列 触发器功能 传递消息 数据格式翻译 安全性 对队列存取进行权限控制 数据广播 错误恢复 在 网络中定位资源 基于成本的路由功能 消息及请求的优先级设定 扩展的调 试功能 通讯协议通讯协议 接口应主要采用 TCP IP 标准协议 接口应既支持同步 又支持异步通信方式 通讯过程通讯过程 接口的通讯过程为 客户端向服务端发送接口服务请求消息包 服务端实 时监听客户端的业务接口请求消息包并作出响应 根据消息包头中的接口服务 类型代码 进行不同的业务逻辑处理 然后向客户端发送处理结果消息包 客 户端实时监听服务端的接口服务处理结果消息包并作出响应 进行业务后继处 理 消息包由可打印的 ASCII 码组成 分为包头和包体两部分 包头内容主要 包括各种消息包的共同的基本信息 包体内容主要包括各种消息包的特有信息 消息包头定义格式如下 字段长度 字节 内容类型说明 序列号 流水号 16yyyymmddx xxxxxxx 字符串Yyyymmdd 表示包请求 应答 的日期 xxxxxxxx 由专业系 统自动唯一生成 版本信息 5 字符串 包类型 1 字符串0 请求包 1 应答包 发起方系统代码 8ssxxxxxx 字符串Ss 系统代码 Xxxxxx 各系统内部处理 受 理者代码 接收方系统代码 8ssxxxxxx 字符串Ss 系统代码 Xxxxxx 各系统内部处理 受 理者代码 请求的日期时间 14yyyymmddh hmmss 字符串 功能 6 字符串 操作 2 数字串 请求优先级 2 数字串 信息体长度 4 数字串 3 1 3 基于过程基于过程调用和共享数据表调用和共享数据表 基于过程调用和共享数据表的接口机制主要通过数据库中过程调用和共享 数据表来完成系统之间的协作和通信 通讯方式通讯方式 根据具体业务接口服务单元的定义 综合营帐系统与各专业子系统分别定 义为客户端或服务端 服务端向客户端开放可直接调用的过程和可直接进行读 写操作的共享数据表 客户端直接调用服务端过程和对共享数据表进行读写操 作 共享数据表可置于综合营帐系统或专业营帐系统或第三方系统的数据库中 通讯协议通讯协议 接口支持各种数据库连接方式 Login DB Link 等 通讯过程通讯过程 接口的通讯过程包括两种 客户端直接调用服务端开放的过程或对服务端开放的共享数据表进行增 删 改和查询操作 完成业务处理 客户端向开放的共享数据表中写入服务请求数据 服务端定时扫描共享 数据表并作出响应 根据服务请求数据中的接口服务类型代码 进行不 同的业务逻辑处理 然后向共享数据表中写入处理结果数据 客户端定 时扫描共享数据表 根据处理结果数据并作出响应 进行业务后继处理 3 2 批量数据接口实现机制批量数据接口实现机制 综合营帐系统与各专业子系统之间批量数据接口主要通过文件方式实现 3 2 1 传输方式传输方式 通过文件传输传送到指定的位置或直接存放到指定的位置 具体要求包括 9支持同一主机内对指定设备存储目录位置的文件获取 10 支持网络模式传输 可以实现跨越局域网络 广域网络 拨号网络等平台 的文件获取 并支持文件重传功能 11 网络传输方式应支持对通信机的 IP 地址 帐户 口令 存取目录的验证 3 2 2 传输协议传输协议 接口应支持以下主流网络协议 FTP TCP IP 等 3 2 3 传输过程传输过程 12 数据传输应支持 12 1 实时 高效和安全可靠地传送批量数据 12 2 断点续传功能 12 3 数据压缩传输 13 在数据传输中发生的错误由数据传输程序负责控制并重新传输 14 同一机器之间不需要采用传输程序进行传输 15 文件读取 15 1 综合营帐系统主动到相关目录读取所需文件 并校验是否成功获取 15 2 若成功 则对文件名进行标示并存放在相应目录 15 3 若失败 则对文件名进行读取失败标示 并存放在相应目录 发送回执给 专业子系统 16 记录级校验 综合营帐系统对主动获得的文件进行记录级校验 对有问题记录 通过发 送回执给相应子系统 由专业子系统重新处理 供综合营帐系统再次处理 4 与与 GSM CDMA 营帐系统接口营帐系统接口 4 1 营业营业受理受理 4 1 1 新装业务接口具体实现新装业务接口具体实现 4 1 1 1 消息序列图消息序列图 升 4 1 1 2 工单流转说明工单流转说明 1 在新装业务工单流转接口 由以下接口服务单元构成 a 号码资源查询接口服务单元 b SIM 卡资源查询接口服务单元 c 号码选占接口服务单元 d SIM 卡选占接口服务单元 e 新装业务接口服务单元 f 业务完工接口服务单元 2 在新装业务工单流转过程中 除业务完工接口服务是 GSM 专业营帐系统是接口服务 申请发起者 Client 综合营帐系统是接口服务响应者 Server 其余服务综合营帐 系统是接口服务申请发起者 Client GSM CDMA 专业营帐系统是接口服务响应者 Server 4 1 1 3 号码资源查询接口服务单元号码资源查询接口服务单元 说明说明 定义定义 完成用户号码资源查询的服务接口单元 编码编码 10101146 通讯方式通讯方式 同步 实现机制实现机制 建议采用存储过程的实现机制 功能约定功能约定 综合营帐系统综合营帐系统 1 向 GSM 专业营帐系统申请进行号码查询接口服务 提供相关消息 参数 并等待 GSM 专业营帐系统返回信息 2 接收和分析 GSM 专业营帐系统返回信息 进行处理 若收到成功信息 则进行后继处理和提交本方事务 若收到失败信息 则回滚本方事务 进行业务失败处理 如显示业务失败提 示信息 3 若等待超时 则按照收到失败信息进行处理 并生成一个异常处理告警工单 专业营帐系统专业营帐系统 1 响应综合营帐系统的号码查询接口服务申请 接收和分析相关消息 参数 2 进行号码资源查询业务处理 3 返回号码资源的状态 号码资源的费用以及业务处理成功或失败信息 消息消息 参数定义参数定义 输入消息输入消息 参数参数 序号序号参数名参数名说明说明参数类型参数类型长度长度备注备注 1 SVRCODE服务编码CHAR4 2 CITYCODE地市编码CHAR1 3 DEPARTCOD E 营业点编码CHAR7 4 STAFFCODE营业员编码CHAR7 5 PHONE NUM BER 移动电话号码CHAR15 6 REMARK备注CHAR100 输出消息输出消息 参数参数 序号序号参数名参数名说明说明参数类型参数类型长度长度备注备注 1 ERRNO返回编码CHAR5 2 ERRINFO错误描述CHAR300 3 PHONE NUM BER 号码资源CHAR15 4 MPHONESTA号码资源状态CHAR10 未用 TE1 在用 2 占用 5 NUMCHARGE号码资源费用NUM10 2 代码说明代码说明 返回编码返回编码 序号序号代码值代码值说明说明备注备注 1 00000服务成功 2 00001号码资源查询失败 3 00002无可用的号码资源 4 1 1 4 SIM 卡资源查询接口服务单元卡资源查询接口服务单元 说明说明 定义定义 完成 SIM 卡资源查询的服务接口单元 编码编码 10101147 通讯方式通讯方式 同步 实现机制实现机制 建议采用存储过程的实现机制 功能约定功能约定 综合营帐系统综合营帐系统 1 向 GSM 专业营帐系统申请进行 SIM 卡资源查询接口服务 提供相关消息 参数 并等待 GSM 专业营帐系统返回信息 2 接收和分析 GSM 专业营帐系统返回信息 进行处理 若收到成功信息 则进行后继处理和提交本方事务 若收到失败信息 则回滚本方事务 进行业务失败处理 如显示业务失败提 示信息 3 若等待超时 则按照收到失败信息进行处理 并生成一个异常处理告警工单 专业营帐系统专业营帐系统 1 响应综合营帐系统的 SIM 卡资源查询接口服务申请 接收和分析相关消息 参数 2 进行 SIM 卡资源查询业务处理 3 返回 SIM 卡资源的状态 SIM 卡资源的费用以及业务处理成功或失败信息 消息消息 参数定义参数定义 输入消息输入消息 参数参数 序号序号参数名参数名说明说明参数类型参数类型长度长度备注备注 1 SVRCODE服务编码CHAR4 2 CITYCODE地市编码CHAR1 3 DEPARTCOD E 营业点编码CHAR7 4 STAFFCODE营业员编码CHAR7 5 PHONENUMB ER 电话号码CHAR20 6 SIMCARDNOSIM 卡号码CHAR20 7 REMARK备注CHAR100 输出消息输出消息 参数参数 序号序号参数名参数名说明说明参数类型参数类型长度长度备注备注 1 ERRNO返回编码CHAR5 2 ERRINFO错误描述CHAR300 3 PHONENUMB ER 号码VARCHAR 2 20 4 SIMCARDNOSIM 卡VARCHAR 2 20 5 MPHONESTA TE SIM 卡状态CHAR10 未用 1 在用 2 占用 6 CARDCHARG E SIM 卡费用NUMBER10 2 代码说明代码说明 返回编码返回编码 序号序号代码值代码值说明说明备注备注 1 00000服务成功 2 00001SIM 卡资源查询失败 3 00002无可用的 SIM 卡资源 4 1 1 5 号码选占操作接口服务单元号码选占操作接口服务单元 说明说明 定义定义 完成号码选占业务的接口服务单元 编码编码 10101148 通讯方式通讯方式 同步 实现机制实现机制 建议采用中间表 存储过程的实现机制 功能约定功能约定 综合营帐系统综合营帐系统 1 向 GSM 专业营帐系统申请号码占用的接口服务 提供相关消息 参数 并等待 GSM 专业营帐系统返回信息 2 接收和分析 GSM 专业营帐系统返回信息 进行处理 若收到成功信息 则进行后继处理 若收到失败信息 进行业务失败处理 如显示业务失败提示信息 3 若等待超时 则按照收到失败信息进行处理 并生成一个异常处理告警工单 专业营帐系统专业营帐系统 1 响应综合营帐系统的号码占用的服务申请 接收和分析相关消息 参数 2 进行本方号码占用的业务处理 修改号码资源状态 记录业务信息 3 返回业务处理成功或失败信息 消息消息 参数定义参数定义 输入消息输入消息 参数参数 序号序号参数名参数名说明说明参数类型参数类型长度长度备注备注 1 SVRCODE服务编码CHAR4 2 CITYCODE地市编码CHAR1 3 DEPARTCOD E 营业点编码CHAR7 4 STAFFCODE营业员编码CHAR7 5 PHONE NUM BER 移动电话号码CHAR15 6 STATE号码占用CHAR11 占用 2 不占用 7 REMARK备注CHAR100 8 BTRADETIME交易开始时间CHAR14yyyymmddhhmiss 输出消息输出消息 参数参数 序号序号参数名参数名说明说明参数类型参数类型长度长度备注备注 1 ERRNO返回编码CHAR5 2 ERRINFO错误描述CHAR300 3 CITYCODE地市编码CHAR2 4 MTRADEIDGSM 专业营帐交 易流水号 CHAR16 5 MTRADETIM E GSM 专业营帐交 易结束时间 CHAR14Yyyymmddhhmiss 代码说明代码说明 返回编码返回编码 序号序号代码值代码值说明说明备注备注 1 00000服务成功 2 00001号码资源占用失败 4 1 1 6 SIM 卡资源选占操作接口服务单元卡资源选占操作接口服务单元 说明说明 定义定义 完成 SIM 卡资源选占业务的接口服务单元 编码编码 10101149 通讯方式通讯方式 同步 实现机制实现机制 建议采用中间接口表的实现机制 功能约定功能约定 综合营帐系统综合营帐系统 1 向 GSM 专业营帐系统申请 SIM 卡资源占用的接口服务 提供相关消息 参数 并 等待 GSM 专业营帐系统返回信息 2 接收和分析 GSM 专业营帐系统返回信息 进行处理 若收到成功信息 则进行后继处理 若收到失败信息 进行业务失败处理 如显示业务失败提示信息 3 若等待超时 则按照收到失败信息进行处理 并生成一个异常处理告警工单 专业营帐系统专业营帐系统 1 响应综合营帐系统的卡资源占用的服务申请 接收和分析相关消息 参数 2 进行本方卡资源占用的业务处理 修改卡资源状态 记录业务信息 3 返回业务处理成功或失败信息 消息消息 参数定义参数定义 输入消息输入消息 参数参数 序号序号参数名参数名说明说明参数类型参数类型长度长度备注备注 1 SVRCODE服务编码CHAR4 2 CITYCODE地市编码CHAR4 3 DEPARTCOD E 营业点