087-2008中国联通IT系统BSS系统域在线计费系统接口规范第一分册充值系统接口V10

中国联通IT系统BSS系统域在线计费系统接口规范第一分册：充值系统接口（V1.0）2008-12-15发布2008-12-15实施中国联通公司发布中国联通公司企业标准QB/CU087-2008中国联通IT系统BSS系统域在线计费系统接口规范第一分册：充值系统接口1目次1.范围.............................................................................................................................................................12.规范性引用文件.........................................................................................................................................13.缩略语定义.................................................................................................................................................14.总体概述.....................................................................................................................................................24.1.组网图.................................................................................................................................................24.2.接口协议.............................................................................................................................................25.业务接口流程.............................................................................................................................................35.1.消息处理时序.....................................................................................................................................35.2.流程说明.............................................................................................................................................36.消息格式定义.............................................................................................................................................36.1.业务消息接口.....................................................................................................................................36.1.1.消息头定义..................................................................................................................................................46.1.2.消息体定义..................................................................................................................................................46.2.心跳消息格式定义.............................................................................................................................87.日对账接口.................................................................................................................................................87.1.对账文件格式.....................................................................................................................................9中国联通IT系统BSS系统域在线计费系统接口规范第一分册：充值系统接口I前言本规范对在线计费系统和省分一卡充系统之间的接口协议，交互流程以及完成充值操作必须的业务信息等方面进行了规定。本规范是在线计费系统和省分一卡充系统之间接口开发基本依据。本文件是《中国联通IT系统BSS系统域在线计费系统接口规范》中，关于充值部分的分册。本标准由中国联通公司信息化部提出本标准由中国联通公司技术部归口本标准主要起草单位：中讯邮电咨询设计院、联通公司信息化部本标准主要起草人：杜志涛、宋齐军、曹进武、熊光伟本标准的修改和解释权属中国联通公司。中国联通IT系统BSS系统域在线计费系统接口规范第一分册：充值系统接口1中国联通IT系统BSS系统域在线计费系统（OCS）接口第一分册：充值系统接口1.范围本规范对在线计费系统和省分一卡充系统之间的接口协议，交互流程以及完成充值操作必须的业务信息等方面进行了规定。本规范适用于中国联通在线计费系统（OCS）和一卡充系统接口的开发联调、生产运行。2.规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。QB/CU031-2007《中国联通IT系统总体技术体制》QB/CU043-2007《中国联通IT系统BSS系统域综合计费帐务系统数据模型规范》QB/CU040-2007《中国联通IT系统BSS系统域综合计费帐务系统业务规范》QB/CU036-2007《中国联通IT系统BSS系统域客户关系管理系统业务规范》QB/CU011-2001《中国联通GSM数字蜂窝移动通信网短消息系统技术体制》QB/CU100-2007《中国联通综合增值业务平台技术体制》3.缩略语定义本文档所涉及的缩略语解释请参见下表。缩略语英文中文解释OCSOnlineChargingSystem在线计费系统SCPServiceControlPoint服务控制点VPNVirtualPrivateNetwork虚拟专用网WAPWirelessApplicationProtocol无线应用协议中国联通IT系统BSS系统域在线计费系统接口规范第一分册：充值系统接口24.总体概述联通OCS系统支持用户通过固定电话和手机使用一卡充平台为联通的各种业务账户充值。用户拨打充值特服号码，进入联通充值流程，输入一卡充卡号、密码、充值手机号码以及充值金额等，并传送给OCS充值接口，由该接口处理后发送给相应帐务处理，最终实现充值功能。本接口定义了联通OCS系统和一卡充平台之间充值协议。4.1.组网图省分的一卡充平台，与省内的SCP和Billing系统相连接，完成预付费和后付费用户的充值操作。建设了OCS系统后，一卡充将增加和OCS的充值接口。在SCP存续期间仍然需保留与原SCP的通路，一卡充系统可以根据用户信息将充值请求路由到对应系统。一卡充平台OCS系统SCPBilling4.2.接口协议一卡充平台以客户端方式连接OCS，采用TCP/IP的SOCKET方式进行通信，采用长连接方式。链接建立后一卡充平台可以发送充值消息给OCS。为避免在TCP链接建立后，长时间没有业务消息时，服务端和客户端无法及时发现链路异常情况。在一卡充系统和OCS之间增加了心跳消息。心跳消息用于进行链路异常检测，以降低消息被发送到无法响应的对端的可能性。如果心跳请求没有应答，客户端节点会认为和服务端节点连接故障，或者尝试恢复建立连接，或者将请求转换到备用的服务端节点上，或者采取相应的应急处理流程。服务端和客户端收到业务消息请求和应答时也等同于收到了心跳消息。当TCP层连接已建立，但信道上没有数据传输时，通信双方每隔时间C发送心跳消息以维持此连接，当心跳消息发出，超过时间T后未收到响应，立即再发送心跳消息，再连续发送N-1次后仍未得到响应则断开此连接(应用层连接)。参数C、T、N原则上应可配置，目前取值为：C=60秒，T=60秒，N=3。充值结束后，由于一卡充平台和各帐务的处理可能存在不一致情况，此时由OCS系统将一卡充系统的对账文件取过来进行平帐处理，以一卡充平台结果为准。中国联通IT系统BSS系统域在线计费系统接口规范第一分册：充值系统接口35.业务接口流程5.1.消息处理时序一卡充平台和OCS系统之间的长连接建立以后，一卡充平台可以向OCS发送充值消息。消息时序如下图：一卡充平台OCS1充值鉴权4充值鉴权响应5充值请求8充值请求响应9充正请求12充正请求响应5.2.流程说明1）一卡充平台收到用户的充值请求。2）一卡充平台发送充值鉴权请求消息给OCS，OCS将鉴权结果返回给一卡充系统。若成功，鉴权结果中包含用户的金额和有效期及归属省分、地市编码，基本业务类型，归属系统编码，归属业务品牌等信息。3）充值鉴权成功后，一卡充平台发送充值请求消息给OCS，OCS进行充值处理后将结果返回给一卡充平台。4）一卡充根据充值通知响应，对充值卡进行相关操作。6.消息格式定义6.1.业务消息接口消息格式：消息头+消息体中国联通IT系统BSS系统域在线计费系统接口规范第一分册：充值系统接口4业务消息全部为定长消息.一卡充系统和OCS系统之间的业务消息类型如下表消息消息类型说明充值鉴权消息01一卡充平台-OCS充值鉴权响应消息11一卡充平台-OCS充值请求消息02一卡充平台-OCS充值请求响应消息12一卡充平台-OCS充正请求消息03一卡充平台-OCS充正请求响应消息13一卡充平台-OCS6.1.1.消息头定义消息头定义.（总共：48字节）字段长度（字节）类型说明msgLength4Integer整个消息包的长度（包括该字段长度）msgType4Integer请求消息为0，响应消息为1Service