中国联通公司企业标准QB/CU088-2008中国联通IT系统BSS系统域在线计费系统接口规范第二分册:话单接口(V1.0)2008-12-15发布2008-12-15实施中国联通公司发布中国联通IT系统BSS系统域在线计费系统接口规范第二分册:话单接口I目次目次..............................................................................I前言..............................................................................I1.范围..............................................................................12.范性引用文件......................................................................13.缩略语............................................................................24.话单文件格式......................................................................34.1.文件目录........................................................................34.2.文件名格式......................................................................34.3.ASCII话单内容信息...............................................................4中国联通IT系统BSS系统域在线计费系统接口规范第二分册:话单接口I前言本规范结合中国联通在线计费系统(OCS)的业务规范和技术规范要求,对OCS输出的话单格式和详细信息进行了规定。本标准由中国联通公司信息化部提出本标准由中国联通公司技术部归口本标准主要起草单位:中讯邮电咨询设计院、联通公司信息化部本标准主要起草人:刘晓亮、杜志涛、王君珂、张建峥、宋齐军、牛保同、曲金豹、解彦良本标准的修改和解释权属中国联通公司。中国联通IT系统BSS系统域在线计费系统接口规范第二分册:话单接口1中国联通IT系统BSS系统域在线计费系统接口规范第二分册:话单接口1.范围本规范主要规定了中国联通在线计费系统的话单接口标准。本规范适用于OCS系统和Billing系统之间针对话单采集接口的开发和实施。2.范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。QB/CU031-2007《中国联通IT系统总体技术规范》QB/CU043-2007《中国联通IT系统BSS系统域综合计费帐务系统数据模型规范v1.0》QB/CU040-2007《中国联通IT系统BSS系统域综合计费帐务系统业务规范v1.0》IETFRFC3588:DiameterBaseProtocolIETFRFC4006:DiameterCredit-ControlApplication3GPP32.296:OnlineChargingSystem(OCS)applicationsandinterfaces3GPP32.299:Diameterchargingapplication中国联通IT系统BSS系统域在线计费系统接口规范第二分册:话单接口23.缩略语缩略语英文中文解释AoCAdviceofCharge计费通知BSSBusinessSupportSystem业务支撑系统CDRCallDetailRecord话单CRMCustomerRealtionshipManagement客户关系管理系统DCCDiameterCreditControlDiameter信控协议GGSNGatewayGPRSSupportNodesGPRS网关支持点GPRSGeneralPacketRadioService通用无线分组业务LCSLocationServices位置服务MMSMultimediaMessagingService多媒体消息服务MSMobileStation移动台MSCMobileSwitchingCentre移动交换中心MSISDNMobileStationISDNnumber移动设备ISDN号码OCSOnlineChargingSystem在线计费系统OSSOperateSupportSystem运营支撑系统PDUProtocolDataUnit协议数据单元QoSQualityofService服务质量SACPServiceAccessControlPoint业务接入控制点SCPServiceControlPoint服务控制点SMSCShortMessageServiceCentre短信息中心SMPPShortMessagePeertoPeerProtocol短消息点对点协议SMPP+ShortMessagePeertoPeerProtocolPlus扩展的短消息点对点协议SPServiceProvider服务提供商SSPServiceSwitchPoint业务交换点URLUniformResourceLocator统一资源定位符VASPValue-addServicePlatform综合增值业务平台VPNVirtualPrivateNetwork虚拟专用网WAPWirelessApplicationProtocol无线应用协议中国联通IT系统BSS系统域在线计费系统接口规范第二分册:话单接口34.话单文件格式4.1.文件目录所有的话单文件存放在统一指定的目录下,如$OCSCDRHOME。文件目录采取规则:$OCSCDRHOME/业务类型/话单类型/业务类型的定义如下:业务类型业务类型说明Voice语音业务Data数据业务SmsP2PSMS业务Vas增值业务pocPoC业务Cycle周期性费用Recharge充值业务Other其他类型话单类型的定义如下:话单类型话单类型说明NORMAL_FILE_OUTPUT正常话单ABNORMAL_FILE_OUTPUT异常话单REFUND_FILE_OUTPUT补款话单ERR_FILE_OUTPUT入库失败话单4.2.文件名格式文件命名规则:主机标识+”_”+接口标识+”_”+序列号+”_”+日期+”.”+文件后缀。主机标识OCS主机名标识接口标识语音业务:cdr100数据业务:cdr200P2PSMS业务:cdr300中国联通IT系统BSS系统域在线计费系统接口规范第二分册:话单接口4增值业务:cdr400周期性费用:cdr500PoC业务:cdr600充值业务:cdr700其他类型:cdr900序列号表示文件序列号,从0001开始,最小4位数,达到最大值9999。重新从0001开始循环。日期格式为:YYYYMMDD文件后缀ASCII话单输出格式:r4.3.ASCII话单内容信息OCSASCII话单文件说明如下:1)话单可由多条记录组成,每条记录占一行;2)话单由各字段按顺序组成,每条记录最后添加回车(CR,1字节)、换行(LF,1字节);3)文本格式采用“|”作为字段间的分隔符。如果字段内容中出现“|”,则用\|,表示;如果字段内容中出现“\”,则用\\,表示。4)话单字段类型包括整型Integer和字符串型Char[N]。Char[N]表示此字段内容最长的可能为N个字符,可变长度,字段内容不够长时不填填充符。5)OCS话单文件应包含以下信息,公共部分必须出现,当出现相应特殊部分的业务时,相应的内容字段应出现在话单中,公共部分和特殊部分组成一条记录。6)话单中字段信息不存在时候,填空。序号字段名类型说明公共部分0SerialNoInteger流水号,唯一标志该话单中的记录。1VersionInteger话单版本号2TicketTypeInteger话单类型网元触发:0OCS产生:13TimeStampChar[14]话单产生时间:YYYYMMDDHHmmSS4HostIDChar[64]OCS主机名,记录OCS的标识5ServiceScenariousInteger业务类型语音:MOC:100,MTC:101,CFW:102GPRS:200P2PSMS:MO:300,MT:301补款:302VASP:扣费:400,补款:401周期性费用:500中国联通IT系统BSS系统域在线计费系统接口规范第二分册:话单接口5Poc业务:600充值RECHARGE:700其他类型:9006ChargedPartyChar[20]计费方号码:国内移动电话:国家码+电话号码,如8618818736475固定电话:国家码+区号+电话号码,如8621445566777CallingPartyChar[20]规整后的主叫号码(i.e.长号,去掉接入号等)国际来话:采用00+国家码+电话号码,如003022335788国内移动电话:国家码+电话号码,如8618818736475固定电话:国家码+区号+电话号码,如8621445566778CalledPartyChar[20]规整后的被叫号码(i.e.长号,去掉接入号等)国际来话:采用00+国家码+电话号码,如003022335788国内移动电话:国家码+电话号码,如8613918736475固定电话:国家码+区号+电话号码,如8621445566779OrignialCallingPartyChar[20]原始主叫号码10OrignialCalledPartyChar[20]原始被叫号码11PayFlagInteger主叫或被叫付费标识1.主叫付费2.被叫付费3.其他付费方式12ServIDInteger用户编号13CustIDInteger客户编号14BrandChar[20]用户品牌:00世界风01新势力02如意通15SessionIdChar[64]会话标识:同DCC的Session-ID16SessionTerminatedTimeChar[14]会话结束时间YYYYMMDDHHmmSS17TerminatedCauseInteger终止原因同DCC中的Result-code18OrignialHostChar[64]orignialhostSCP,VASP/VAC,SMSC等的标识,参考Diameterorignalhost19BalanceinfoChar[512]本次事件中改变的账本信息,格式:BalanceID01:BalanceType01,Delta01,Balance01;BalanceID02:BalanceType02,Delta02,Balance02;……该字段表示本次事件中的所有涉及的到变更的账本信息.balanceID01为主账本,不管有没有变更必须填。如涉及到中国联通IT系统BSS系统域在线计费系统接口规范第二分册:话单接口6其他变更的帐本信息则依据规则一一列出。20AccumlatorinfoChar[512]本次事件中改变的累计量信息,格式:AccumulatorID01:AccumulatorType01,Delta01,Accumulator01;AccumulatorID02:AccumulatorType02,Delta02,Accumulator02;……该字段表示本次事件中的所有涉及的到变更的累计量信息.21TariffInfoChar[512]费用项组:本次扣除