中国联通IT系统 BSS系统域 在线计费系统接口规范 第二分册：话单接口V10-20081124

QB/CQ中国联通公司 发布2008-12-15实施2008-12-15发布中国联通IT系统 BSS系统域在线计费系统接口规范第二分册：话单接口（V1.0）QB/CU 088-2008中国联通公司企业标准1中国联通IT系统 BSS系统域 在线计费系统接口规范 第二分册：话单接口目 次目 次I前 言I1.范围12.范性引用文件13.缩略语24.话单文件格式34.1.文件目录34.2.文件名格式34.3.ASCII话单内容信息4I前 言本规范结合中国联通在线计费系统（OCS）的业务规范和技术规范要求，对OCS输出的话单格式和详细信息进行了规定。本标准由中国联通公司信息化部提出本标准由中国联通公司技术部归口本标准主要起草单位：中讯邮电咨询设计院、联通公司信息化部本标准主要起草人：刘晓亮、杜志涛、王君珂、张建峥、宋齐军、牛保同、曲金豹、解彦良本标准的修改和解释权属中国联通公司。中国联通IT系统 BSS系统域 在线计费系统接口规范 第二分册：话单接口1. 范围本规范主要规定了中国联通在线计费系统的话单接口标准。本规范适用于OCS系统和Billing系统之间针对话单采集接口的开发和实施。2. 范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。QB/CU 031-2007 中国联通IT系统总体技术规范QB/CU 043-2007 中国联通IT系统 BSS系统域 综合计费帐务系统 数据模型规范v1.0QB/CU 040-2007 中国联通IT系统 BSS系统域 综合计费帐务系统 业务规范v1.0IETF RFC 3588: Diameter Base ProtocolIETF RFC 4006: Diameter Credit-Control Application3GPP 32.296:Online Charging System (OCS) applications and interfaces3GPP 32.299:Diameter charging application3. 缩略语缩略语英文中文解释AoCAdvice of Charge计费通知BSSBusiness Support System业务支撑系统CDRCall Detail Record话单CRMCustomer Realtionship Management客户关系管理系统DCCDiameter Credit ControlDiameter信控协议GGSNGateway GPRS Support NodesGPRS 网关支持点GPRSGeneral Packet Radio Service通用无线分组业务LCSLocation Services位置服务MMSMultimedia Messaging Service多媒体消息服务MSMobile Station移动台MSCMobile Switching Centre移动交换中心MSISDNMobile Station ISDN number移动设备ISDN号码OCSOnline Charging System在线计费系统OSSOperate Support System运营支撑系统PDUProtocol Data Unit协议数据单元QoSQuality of Service服务质量SACPService Access Control Point业务接入控制点SCPService Control Point服务控制点SMSCShort Message Service Centre短信息中心SMPPShort Message Peer to Peer Protocol短消息点对点协议SMPP+Short Message Peer to Peer Protocol Plus扩展的短消息点对点协议SPService Provider服务提供商SSPService Switch Point业务交换点URLUniform Resource Locator统一资源定位符VASPValue-add Service Platform综合增值业务平台VPNVirtual Private Network虚拟专用网WAPWireless Application Protocol无线应用协议134. 话单文件格式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增值业务： cdr400周期性费用：cdr500PoC业务： cdr600充值业务： cdr700其他类型： cdr900序列号表示文件序列号，从0001开始，最小4位数，达到最大值9999。重新从0001开始循环。日期格式为：YYYYMMDD文件后缀ASCII话单输出格式： r4.3. ASCII话单内容信息OCS ASCII话单文件说明如下：1） 话单可由多条记录组成，每条记录占一行；2） 话单由各字段按顺序组成，每条记录最后添加回车（CR，1字节）、换行(LF，1字节)；3） 文本格式采用 “|” 作为字段间的分隔符。如果字段内容中出现“|”，则用|,表示；如果字段内容中出现“”，则用,表示。4） 话单字段类型包括整型Integer和字符串型CharN。CharN表示此字段内容最长的可能为N个字符，可变长度，字段内容不够长时不填填充符。5） OCS话单文件应包含以下信息，公共部分必须出现，当出现相应特殊部分的业务时，相应的内容字段应出现在话单中，公共部分和特殊部分组成一条记录。6） 话单中字段信息不存在时候，填空。序号字段名类型说明公共部分0SerialNoInteger流水号，唯一标志该话单中的记录。1VersionInteger话单版本号2TicketTypeInteger话单类型网元触发:0OCS产生:13TimeStampChar14话单产生时间：YYYYMMDDHHmmSS4HostIDChar64OCS主机名，记录OCS的标识5ServiceScenariousInteger业务类型语音: MOC: 100, MTC:101, CFW:102GPRS: 200P2PSMS: MO: 300，MT: 301 补款: 302VASP: 扣费: 400, 补款: 401周期性费用： 500Poc业务: 600充值RECHARGE: 700其他类型： 9006ChargedPartyChar20计费方号码：国内移动电话：国家码电话号码， 如8618818736475固定电话：国家码区号电话号码， 如8621445566777CallingParty Char20规整后的主叫号码(i.e. 长号，去掉接入号等)国际来话：采用 00国家码电话号码， 如003022335788国内移动电话：国家码电话号码， 如8618818736475固定电话：国家码区号电话号码， 如8621445566778CalledParty Char20规整后的被叫号码(i.e. 长号，去掉接入号等)国际来话：采用 00国家码电话号码， 如003022335788国内移动电话：国家码电话号码， 如8613918736475固定电话：国家码区号电话号码， 如8621445566779OrignialCallingParty Char20原始主叫号码10OrignialCalledParty Char20原始被叫号码11PayFlagInteger主叫或被叫付费标识1. 主叫付费2. 被叫付费3. 其他付费方式12ServIDInteger用户编号13CustIDInteger客户编号14BrandChar20用户品牌：00 世界风01 新势力02 如意通15SessionIdChar64会话标识：同DCC的Session-ID16SessionTerminatedTimeChar14会话结束时间YYYYMMDDHHmmSS17TerminatedCauseInteger终止原因同DCC中的Result-code18OrignialHostChar64orignial hostSCP ,VASP/VAC,SMSC等的标识,参考Diameter orignal host19BalanceinfoChar512本次事件中改变的账本信息，格式: BalanceID01:BalanceType01,Delta01,Balance01;BalanceID02:BalanceType02,Delta02,Balance02;该字段表示本次事件中的所有涉及的到变更的账本信息.balanceID01为主账本,不管有没有变更必须填。如涉及到其他变更的帐本信息则依据规则一一列出。20AccumlatorinfoChar512本次事件中改变的累计量信息，格式: AccumulatorID01:AccumulatorType01,Delta01,Accumulator01;AccumulatorID02:AccumulatorType02,Delta02,Accumulator02;该字段表示本次事件中的所有涉及的到变更的累计量信息.21TariffInfoChar512费用项组：本次扣除费用项列表，可扩展；无论扣费还是补款费用均为正值。格式：TariffId1:fee1; TariffId2:fee2;.举例：下面的例子中10001代表本地话费，10002代表国内长途话费。例子说明本次费用使用了1元本地话费，2元国内长途话费。（具体代码参照省分业务代码规定）10001:100;10002:200;22MasterProductIDChar20主产品标识23BearerCapabilityChar8用户连接的承载能力普通语音：0 Speech,可视电话：8 Unrestricted digital information特殊部分1: 语音业务0VioceChargingmodeInteger此次电话是按时长还是按次计费：1. 时长2. 按次计费1CallingPartyCellIdChar4主叫蜂窝号码2CallingPartyVLRChar20主叫VLR位置，DCC协议透传3CallingPartyHLRChar20主叫HLR位置，DCC协议透传4CallingPartyLocationPrvocinceChar4主叫归属省5CallingPartyLocationCityChar4主叫归属地6CallingPartyVisitedCityChar4主叫漫游地7CalledPartyCellIdChar4被叫蜂窝号码8CalledPartyVLRChar20被叫VLR位置9CalledPartyHLRChar20被叫HLR位置10CalledPartyLocationPrvocinceChar6被叫归属省i.e 浙江 571， 如果被叫为国际号码，则为国家代码11CalledPartyLocationCityChar6被叫归属地12CalledPartyVisitedCityChar6被叫漫游地13IMSIChar15IMSI号码(不分主被叫)14CallDuriationInteger通话时长，单位为秒15LongDistanceTypeChar2长途类型：1市话；2省内长途；3国内长途；4港澳台长途；5国际长途16RoamingTypeChar2漫游类型：1非漫游，2省内漫游，3国内漫游，4港澳台漫游，5国际漫游17IPMocFlagChar2IP电话标志，主叫是否使用IP业务:1: 不使用IP业务2. 使用IP业务18ForwardingFlagChar2前转类型1：遇忙前转2: 无应答前转3：无条件前转6:用户不可及前转19FowardingNumberChar20前转号码。(假设：A呼叫B, B 前转到C)A的MOC话单：calling party number：Acalled party number：BFowardingNumber：nullB的前转(CFW)话单：calling party number：Acalled party number：BFowardingNumber：CC的MTC话单：calling party number：Bcalled party number：CFowardingNumber：null20CallingGroupIdChar20主叫集团Id21CalledGroupIdChar20被叫所属集团Id22VPNTypeChar1VPN类型0. 网内1. 网间.2. 非VPN23FnFFlagChar1被叫是否属于亲情号码标识0:不是亲情号码1.属于亲情号码2.属于超级亲情号码特殊部分2: 数据业务0GGSNIPAddressChar20计费方拜访的GGSN IP Address1SGSNIPAddressChar20计费方拜访的SGSN IP Address2Calling_Number_Home_AreaChar20主叫归属地3ApnNIChar20所使用的APN4PDPTypeChar10PDP类型5ServedPdpAddressChar20PDP地址6Rating-GroupChar256Rating-Group使用信息：RatingGroup01:duration, used Uplink volume,used down link Volume;RatingGroup02:duration, used Uplink volume,used down link Volume;如果一个GPRS 会话中涉及到多个Rating-Group的多业务信息.,则写入所有涉及到的Rating-Group的使用信息.7RoamingTypeChar20漫游类型1非漫游，2省内漫游，3国内漫游，4港澳台漫游，5国际漫游8Charging-IdChar30计费标识符。3GPP-Charging-Id和GGSN-Address组合在一起可以识别和一个PDP context 相关的所有 SGSN 和 GGSN 产生的计费记录。9QoSChar8协商的QoS10ChargingTypeChar2用户计费类型2：按时长计费3：按流量计费特殊部分3: 点到点短信业务0SMS-CaddressChar20短信中心地址1MessageIdChar32Message Id 2SMLengthInteger短信长度特殊部分4: 增值业务0ProductIdChar16产品ID1SPC_ProductIDChar16产品构成ID2SP_ProductIDChar16SP产品ID3ServiceIDChar16业务ID4ContentIDChar16内容ID5OrderMethodIDChar16渠道ID6PushIDChar16推荐人（发展人）ID7CP_IDChar16内容提供商ID8SpIDChar16SP ID9MessageIdChar16消息标识10ServiceCapacityInteger业务能力0：SMS1：MMS2：WAP3：STREAM4：炫铃11ChargingTypeChar2用户计费类型0：一次性收费，例如收包月费1：一次使用收费（按次）2：按时长计费3：按流量计费12NotesChar100扣费原因，可以是业务地址（url大于100字节则取前100字节，后面内容舍弃）或其他13ValueAddServiceTypeChar4增值业务记录类型14Charging-IdChar30计费标识符。15ApnNIChar20所使用的APN16ClientIPChar20用于标识彩信业务中客户端的IP地址17QoSChar8协商的QoS特殊部分5: 周期性费用0EventCauseChar32周期性费用扣费类型: 1001 月租费在月初扣除成功2001 月租费在月初扣除失败1002 月租费在月末扣除成功2002 月租费在月末扣除失败1003 累计量月末清零成功2003 累计量月末清零失败1004 日租费扣除成功2004 日租费扣除失败1005 半月租费扣除成功2005 半月租费扣除失败1006语音月租费扣除成功2006语音月租费扣除失败1007数据月租费扣除成功2007数据月租费扣除失败1008 点对点短信月租费扣除成功2008 点对点短信月租费扣除失败1009 增值月租费扣除成功2009 增值月租费扣除失败1010保底费在月初扣除成功2010保底费在月初扣除失败1011保底费在月末扣除成功2011保底费在月末扣除失败1CycleBeginTimeChar14周期开始时间YYYYMMDDHHmmSS2CycleEndTimeChar14周期结束时间YYYYMMDDHHmmSS3CycleTypeInteger周期为：0：日1：星期2：单月3：多月4UserStateChar10用户生命周期状态：0：未激活期1：有效期2：充值期3：锁定期特殊部分6: POC业务0serviceIdentifierInteger业务标识1pocSessionIdChar(16)PoC会话标识2pocServerRoleChar(4)PoC服务器角色3pocSessionTypeChar(2)PoC会话类型4numberOfParticipantsInteger会话参与者人数5pocGroupNameChar(16)PoC群组标识6ChargingTypeChar2用户计费类型2：按时长计费3：按流量计费7pocUsageChar256ServiceIdentifier使用信息：ServiceIdentifier01:duration, used Uplink volume,used down link Volume,used total volume, times; ServiceIdentifier02:duration, used Uplink volume,used down link Volume, used total volume, times;Duration：使用时长。used Uplink volume：使用的上行流量。used down link Volume：使用的下行流量。used total volume：使用的总流量。特殊部分7: 充值业务0ServiceKeyInteger业务键 (固定填1004)1MSISDNChar(24)被充值用户手机号码2AccountInteger交易金额(不包含奖励金额)，可以为负值，单位：分3BOSSSEQChar(24)交易序列号4OCSSEQChar(24)响应序列号5TradeTimeChar(14)交易时间6TradeTypeChar交易类型0：充值通知1：充值回滚2：通过一卡通充值接口预置金额7AccountLeftInteger交易开始时主资金帐户余额8CallServiceStopChar(8)交易开始时的有效期9AccountStopChar(8)交易开始时的保留期结束日期10ErrorTypeChar错误类型0：操作成功1：数据库操作失败2：超过最大充值金额，充值失败3：指定交易号不存在，回滚失败4：指定交易是失败操作，无法回滚5：用户余额小于取消金额，不能回滚，回滚失败6：指定交易号已被回滚，不能重复回滚7：充值金额为负，余额不足，充值失败8：超过最大充值次数，充值不成功9：激活后用户不允许回滚激活前的充值，回滚失败11TradeSeqChar(24)充值通知时填为0。回滚时填写为指定要回滚的充值交易序列号12AccountNumberChar(36)接收到的充值卡信息13HomePLMNChar(4)主叫归属地区号，对国际号码,该值为国家码14AddedactivedaysInteger充值金额对应的有效期天数(不包含充值奖励增加的天数，可以为负值)，单位：天15OSSOperatorIDChar(36)营业操作员ID注：现金充值时填写营业操作员ID(SMAP界面的现金充值话单营业操作员ID固定填写为“INOPR”，营帐调用MML实现的现金充值营业操作员ID填写的是营帐传过来的参数，BILL充值对帐成功后固定填写“INCHECKOPR”)16OSSOperatorAreaChar(36)营业操作员地区注：现金充值时填写营业操作员地区(SMAP界面的现金充值话单营业操作员地区固定填写为“INAREA”，营帐调用MML实现的现金充值营业操作员地区填写的是营帐传过来的参数，BILL充值对帐成功后固定填写“INCHECKAREA”)17OSSBHIDChar(36)营业厅ID注：现金充值时填写营业厅ID (SMAP界面的现金充值话单营业厅ID固定填写为“INBHID”，营帐调用MML实现的现金充值营业厅ID填写的是营帐传过来的参数，BILL充值对帐成功后固定填写“INCHECKBHID”)18OverFirstChargeChar首次充值标志注：首次充值时为1，其余为2此字段只对现金一卡充充值有效，其余填写为空充值回滚时，此字段无意义注：通过一卡通接口充值不激活时填写为空19MsgSrcChar充值消息来源注：1：CRM/Billing 2: 一卡充平台此字段只对现金一卡充充值有效，其余填写为空20ControlflagChar(20)话单控制字注：第一位标识本次充值是否需要分月结转(0：不分月结转；1：分月结转)，其他位保留，默认值为“00000000000000000000”此字段只对现金一卡通充值有效，其余填写为空21String1Char(64)保留，以便扩展22String2Char(64)保留，以便扩展23String3Char(64)保留，以便扩展24String4Char(64)保留，以便扩展25String5Char(64)保留，以便扩展26Int1Integer保留，以便扩展27Int2Integer保留，以便扩展28Int3Integer保留，以便扩展29Int4Integer保留，以便扩展30Int5Integer保留，以便扩展特殊部分8: 其他业务0ReasontypeInteger业务发生原因：1：外部调帐2：外部扣费3：外部优惠4：小额减免99：其他1TradeTimeChar(14)业务发生时间2String1Char(64)保留，以便扩展3String2Char(64)保留，以便扩展4String3Char(64)保留，以便扩展5String4Char(64)保留，以便扩展6String5Char(64)保留，以便扩展7Int1Integer保留，以便扩展8Int2Integer保留，以便扩展9Int3Integer保留，以便扩展10Int4Integer保留，以便扩展11Int5Integer保留，以便扩展