中国联通综合营帐系统接口规范

中国联通综合营帐系统接口规范
中国联合通信有限公司
2001年6月
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. 软件体系结构
投资，必须保证业务逻辑在多个层次上得以实现，保证消息和数据能够得到及时、有序的传递，保证统一客户资料与各专业系统数据的映射对应关系，应用软件体系采用三层客户/服务器体系结构，如下图所示：
软件体系结构图
软件应遵循三层体系结构，分述如下：
1．表示层：实现用户交互和数据表示，为下面的处理收集数据，向第二层业务逻辑层发出请求，并显示处理结果。

这一层功能的实现可以采用 GUI
（即图形用户界面）、浏览器等方式实现。

向业务逻辑层发起的请求还可
以来自于客服系统、银行缴费系统等。

2．业务逻辑层：实现软件的业务逻辑处理，这一层又由两部分组成：
1综合部分：即本次新建部分。

根据《中国联通综合营帐系统总体方案》的规定，综合营帐系统共有五大功能模块：综合营业，综合帐务，缴费，
信用/防欺诈管理，统一客户资料；
2各专业系统业务逻辑：包括现有业务GSM、165数据、VOIP、193长途、市话、寻呼等业务系统的业务逻辑部分；
业务逻辑层通过接口响应表示层发起的请求，完成相应的业务处理并通过相应的接口完成对数据的操作。

在本系统中，专业系统业务逻辑不直接响应表示层的请求，专业系统业务逻辑的请求只能来自于综合业务逻辑层。

3．数据层：该层包括各专业系统的数据和本期新建的统一客户资料。

图中的阴影部分表示原有各专业业务系统，这些专业业务系统对综合营帐系统来说是一种特殊的数据资源。

表示层不能直接对各种数据资源进行直接的操作，必须通过业务逻辑层。

综合业务逻辑对原有各专业子系统数据的访问必须通过专业子系统的业务逻辑层，而不能直接操作。

其接口通信形式可以采用同步调用、异步调用、队列、文件形式、数据库表形式等实现。

2.2. 接口总体描述
综合营帐系统提供，实现三种类型的接口，如下图所示：
1.内部接口
综合营帐系统所包含几个模块之间，某个模块对其他模块所要求调用及提供的接口关系。

2.外部接口
综合营帐系统与外部其它系统的接口，是综合营帐系统与其它系统的连接并透明地进行数据交换和程序调用的逻辑层面。

综合营帐系统主要与以下外部系统存在接口：
✧专业计费系统
✧综合结算系统
✧综合客服系统
✧大客户系统
✧银行、邮政等代缴费系统
✧网管系统
✧OA、财务等其他系统
3.与现有专业营帐系统接口
综合营帐系统与现有各专业营帐系统的接口，以实现系统各项功能、任务的分派和调度。

本接口规范就是要对此接口进行具体、详尽的描述与规定。

2.3. 接口实现原则
关于第三类接口——综合营帐系统与各专业营帐子系统之间的接口的实现原则，如下图所示：
在具体实现时，应该在综合营帐系统与各专业营帐子系统通过适配器实现双方的互连。

考虑到综合营帐系统为一个新建系统，投资大，设计灵活，实现方便，故综合营帐一方的适配器功能应该比各专业营帐子系统一方的适配器功能强，做的工作多。

总的原则就是综合营帐系统应该尽量向各现有专业营帐子系统靠拢，同时对各专业营帐子系统的操作最好是增加而不是修改，而且对现有系统的改动
要做到最小。

2.4. 接口参考点
根据综合营帐的体系结构，标准化参考点主要分为三个系列F(fulfillment)系列、A(assurance)系列、B(billing)系列。

根据实际的完成的功能，规范参考点如图为：
1F1——综合营业受理实现资源配置和业务配置时与专业营业之间的参考点；
2F2——专业营帐为实现开通/关闭与网络层的接口（本规范对此暂不做描述）。

3A1——综合营帐信用/防欺诈与专业信用/防欺诈之间的参考点
4A2——综合营帐的统一客户资料与各专业客户资料之间的参考点
5B1——综合帐务与各专业帐务之间的参考点。

6B2——综合缴费与各专业缴费之间的参考点。

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.基于消息中间件
基于消息中间件的接口机制主要通过消息传递来完成系统之间的协作和通信。

◆通讯方式
根据具体业务接口服务单元的定义，综合营帐系统与各专业子系统分别定义为客户端或服务端。

客户端向服务端发送业务接口服务申请消息包，服务端向客户端返回业务接口服务处理结果消息包。

消息中间件应保证消息包传输过程的正确、可靠和及时。

消息中间件的应提供以下基本功能：消息队列、触发器功能、传递消息、数据格式翻译、安全性（对队列存取进行权限控制）、数据广播、错误恢复、在网络中定位资源、基于成本的路由功能、消息及请求的优先级设定、扩展的调试功能。

◆通讯协议
接口应主要采用TCP/IP标准协议。

接口应既支持同步、又支持异步通信方式。

◆通讯过程
接口的通讯过程为：客户端向服务端发送接口服务请求消息包，服务端实时监听客户端的业务接口请求消息包并作出响应，根据消息包头中的接口服务类型代码，进行不同的业务逻辑处理，然后向客户端发送处理结果消息包；客户端实时监听服务端的接口服务处理结果消息包并作出响应，进行业务后继处理。

消息包由可打印的ASCII码组成，分为包头和包体两部分。

包头内容主要包括各种消息包的共同的基本信息，包体内容主要包括各种消息包的特有信息。

消息包头定义格式如下：
3.1.3.基于过程调用和共享数据表
基于过程调用和共享数据表的接口机制主要通过数据库中过程调用和共享数据表来完成系统之间的协作和通信。

◆通讯方式
根据具体业务接口服务单元的定义，综合营帐系统与各专业子系统分别定义为客户端或服务端。

服务端向客户端开放可直接调用的过程和可直接进行读写操作的共享数据表；客户端直接调用服务端过程和对共享数据表进行读写操作。

共享数据表可置于综合营帐系统或专业营帐系统或第三方系统的数据库中。

◆通讯协议
接口支持各种数据库连接方式：Login、DB Link等。

◆通讯过程
接口的通讯过程包括两种：
✧客户端直接调用服务端开放的过程或对服务端开放的共享数据表进行
增、删、改和查询操作，完成业务处理。

✧客户端向开放的共享数据表中写入服务请求数据，服务端定时扫描共享
数据表并作出响应，根据服务请求数据中的接口服务类型代码，进行不
同的业务逻辑处理，然后向共享数据表中写入处理结果数据；客户端定
时扫描共享数据表，根据处理结果数据并作出响应，进行业务后继处理。

3.2. 批量数据接口实现机制
综合营帐系统与各专业子系统之间批量数据接口主要通过文件方式实现。

3.2.1.传输方式
通过文件传输传送到指定的位置或直接存放到指定的位置。

具体要求包括：1支持同一主机内对指定设备存储目录位置的文件获取。

2支持网络模式传输，可以实现跨越局域网络、广域网络、拨号网络等平台的文件获取，并支持文件重传功能。

3网络传输方式应支持对通信机的IP地址、帐户、口令、存取目录的验证。

3.2.2.传输协议
接口应支持以下主流网络协议：FTP、TCP/IP等。

3.2.3.传输过程
4数据传输应支持：
4.1实时、高效和安全可靠地传送批量数据；
4.2断点续传功能;
4.3数据压缩传输;
5在数据传输中发生的错误由数据传输程序负责控制并重新传输。

6同一机器之间不需要采用传输程序进行传输。

7文件读取
7.1综合营帐系统主动到相关目录读取所需文件，并校验是否成功获取。

7.2若成功，则对文件名进行标示并存放在相应目录。

7.3若失败，则对文件名进行读取失败标示，并存放在相应目录。

发送回执给专
业子系统。

8记录级校验
综合营帐系统对主动获得的文件进行记录级校验，对有问题记录，通过发送
回执给相应子系统。

由专业子系统重新处理，供综合营帐系统再次处理。

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. 号码资源查询接口服务单元
说明
◆定义
完成用户号码资源查询的服务接口单元
◆编码
◆通讯方式
同步
◆实现机制
建议采用存储过程的实现机制。

功能约定
◆综合营帐系统
1.向GSM专业营帐系统申请进行号码查询接口服务，提供相关消息/参数，并等待GSM
专业营帐系统返回信息。

2.接收和分析GSM专业营帐系统返回信息，进行处理：
◆若收到成功信息，则进行后继处理和提交本方事务。

◆若收到失败信息，则回滚本方事务，进行业务失败处理（如显示业务失败提示信
息）。

3.若等待超时，则按照收到失败信息进行处理，并生成一个异常处理告警工单。

◆专业营帐系统
1.响应综合营帐系统的号码查询接口服务申请，接收和分析相关消息/参数。

2.进行号码资源查询业务处理。

3.返回号码资源的状态、号码资源的费用以及业务处理成功或失败信息。

消息/参数定义
◆输入消息/参数
◆输出消息/参数
代码说明
◆返回编码
4.1.1.4. SIM卡资源查询接口服务单元说明
◆定义
完成SIM卡资源查询的服务接口单元。

◆编码
◆通讯方式
同步
◆实现机制
建议采用存储过程的实现机制。

功能约定
◆综合营帐系统
1.向GSM专业营帐系统申请进行SIM卡资源查询接口服务，提供相关消息/参数，并等
待GSM专业营帐系统返回信息。

2.接收和分析GSM专业营帐系统返回信息，进行处理：
◆若收到成功信息，则进行后继处理和提交本方事务。

◆若收到失败信息，则回滚本方事务，进行业务失败处理（如显示业务失败提示信
息）。

3.若等待超时，则按照收到失败信息进行处理，并生成一个异常处理告警工单。

◆专业营帐系统
1.响应综合营帐系统的SIM卡资源查询接口服务申请，接收和分析相关消息/参数。

2.进行SIM卡资源查询业务处理。

3.返回SIM卡资源的状态、SIM卡资源的费用以及业务处理成功或失败信息。

消息/参数定义
◆输入消息/参数
◆输出消息/参数
代码说明
◆返回编码
4.1.1.
5. 号码选占操作接口服务单元说明
◆定义
完成号码选占业务的接口服务单元。

◆编码
◆通讯方式
同步。

◆实现机制
建议采用中间表/存储过程的实现机制。

功能约定
◆综合营帐系统
1.向GSM专业营帐系统申请号码占用的接口服务，提供相关消息/参数，并等待GSM专
业营帐系统返回信息。

2.接收和分析GSM专业营帐系统返回信息，进行处理：
◆若收到成功信息，则进行后继处理。

◆若收到失败信息，进行业务失败处理（如显示业务失败提示信息）。

3.若等待超时，则按照收到失败信息进行处理，并生成一个异常处理告警工单。

◆专业营帐系统
1.响应综合营帐系统的号码占用的服务申请，接收和分析相关消息/参数。

2.进行本方号码占用的业务处理：修改号码资源状态，记录业务信息。

3.返回业务处理成功或失败信息。

消息/参数定义
◆输入消息/参数
◆输出消息/参数。