086 中国联通IT系统 BSS系统域 在线计费系统接口规范 总册V1

QB/CU 086-2008中国联通公司企业标准中国联通IT系统 BSS系统域在线计费系统接口规范总册 （V1.0）中国联通公司发布2008-12-15实施2008-12-15发布中国联通IT系统 BSS系统域 在线计费系统接口规范 总册目 次1.范围12.规范性引用文件13.缩略语定义14.接口组成24.1.OCS与网元接口24.2.OCS与充值系统接口34.3.OCS与网管系统接口34.4.OCS与Billing系统接口35.接口协议35.1.SMPP+协议概述35.1.1.中国联通 SMPP+ 协议的现状45.1.2.SMPP+协议的选择45.2.DCC协议45.2.1.概述45.2.2.DCC消息头45.2.3.AVP头格式65.2.4.AVP数据类型65.2.5.消息分类75.2.6.消息定义75.2.7.Result-Code定义175.3.SNMP协议195.3.1.概述195.3.2.SNMP基本原理205.3.3.管理信息库MIB205.3.4.SNMP五种消息205.4.WEBService协议215.4.1.概述215.4.2.Web Service特点215.4.3.Web Service体系结构215.4.4.简单对象访问协议SOAP225.4.5.统一描述、发现和集成协议UDDI225.4.6.Web服务描述语言WSDL225.5.文件接口231前言为了指导中国联通在线计费系统（OCS）和关联系统进行信息交互，共同完成在线计费功能，指导OCS和关联系统进行开发，制定本规范。本规范是中国联通在线计费系统（OCS）和关联系统进行信息交互的基本依据，同时也是编制中国联通在线计费系统（OCS）设备规范的基本依据。本规范结合中国联通在线计费系统（OCS）业务规范和技术规范的要求，对OCS系统和关联系统的接口方式、交互内容和交互流程进行了规定，其中采纳了相关国际标准和行业标准的有关规定。本规范由以下规范文件共同组成：中国联通IT系统BSS系统域在线计费系统（OCS）接口规范总册中国联通IT系统BSS系统域在线计费系统（OCS）接口规范Billing分册中国联通IT系统BSS系统域在线计费系统（OCS）接口规范GGSN分册中国联通IT系统BSS系统域在线计费系统（OCS）接口规范SACP分册中国联通IT系统BSS系统域在线计费系统（OCS）接口规范VASP/VAC分册中国联通IT系统BSS系统域在线计费系统（OCS）接口规范IMS分册中国联通IT系统BSS系统域在线计费系统（OCS）接口规范充值分册中国联通IT系统BSS系统域在线计费系统（OCS）接口规范话单分册中国联通IT系统BSS系统域在线计费系统（OCS）接口规范网管分册本文件为中国联通在线计费系统（OCS）接口规范总册。本标准由中国联通公司信息化部提出本标准由中国联通公司技术部归口本标准主要起草单位：中讯邮电咨询设计院、联通公司信息化部本标准主要起草人：刘晓亮、杜志涛、宋齐军、刘四奎本标准的修改和解释权属中国联通公司。I中国联通IT系统 BSS系统域 在线计费系统（OCS）接口规范 总册1. 范围本规范主要规定了中国联通在线计费系统（OCS）的接口标准，包括接口规范的组成，采用的接口协议介绍，每个外部系统对应的具体接口规范分册。本规范适用于中国联通在线计费系统（OCS）和周边系统接口的开发联调、生产运行，以及周边系统设备采购、工程设计。2. 规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。QB/CU 031-2007 中国联通IT系统总体技术体制QB/CU 043-2007 中国联通IT系统 BSS系统域 综合计费帐务系统数据模型规范QB/CU 040-2007 中国联通IT系统 BSS系统域 综合计费帐务系统业务规范QB/CU 036-2007 中国联通IT系统 BSS系统域客户关系管理系统业务规范QB/CU 011-2001 中国联通GSM数字蜂窝移动通信网短消息系统技术体制QB/CU 100-2007 中国联通综合增值业务平台技术体制中国联通预付费用户点到点短消息实时计费实现技术规范(v1.2)IETF RFC 1157: Simple Network Management Protocol (SNMP)IETF RFC 14411452: Simple Network Management Protocol (SNMPv2)IETF RFC 3588: Diameter Base ProtocolIETF RFC 4006: Diameter Credit-Control Application3GPP 32.296:Online Charging System (OCS) applications and interfaces3GPP 32.299:Diameter charging applicationShort Message Peer to Peer Protocol Specification v3.43. 缩略语定义本文档所涉及的缩略语解释请参见下表。缩略语英文中文解释AoCAdvice of Charge计费通知BSSBusiness Support System业务支撑系统BCFBearer Charging Function承载计费功能CAPSCall Attempt Per Second每秒试呼数CDRCall Detail Record话单CRMCustomer Realtionship Management客户关系管理系统DCCDiameter Credit ControlDiameter信控协议ECFEvent Charging Function事件计费功能CTFCharging Trigger Function计费触发功能ESMEExternal Short Message Entity扩展短消息实体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服务控制点SDFService Data Point业务数据点SMEShort Message Entity短消息实体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无线应用协议4. 接口组成OCS系统的外部接口，按照对接系统的不同，可以分为OCS与网元接口、OCS与充值系统接口、OCS与支撑系统的接口、OCS与网管系统的接口。4.1. OCS与网元接口网络侧的业务控制网元配合OCS完成实时计费控制功能。业务控制网元作为客户端，主要负责根据OCS授权的额度接续或中断用户服务。OCS作为服务端，主要负责批价和余额管理。在系统正常的情况下，业务控制网元通过实时计费接口与OCS对接，对接的协议包括SMPP+、DCC等实时计费协议。在系统异常情况下，业务控制网元出离线话单，通过话单接口与OCS对接。OCS根据离线话单进行准实时的批价和扣费。具体OCS与各个网元的接口规范，参见如下分册：中国联通IT系统 BSS系统域 在线计费系统接口规范GGSN分册中国联通IT系统 BSS系统域 在线计费系统接口规范SACP分册中国联通IT系统 BSS系统域 在线计费系统接口规范VASPVAC分册中国联通IT系统 BSS系统域 在线计费系统接口规范IMS分册4.2. OCS与充值系统接口充值系统配合OCS完成充值功能。充值系统作为客户端，主要负责充值信息的管理、鉴权和置位的功能。OCS作为服务端，主要负责接收充值系统的充值信息更新余额。充值系统通过实时充值Socket协议与OCS对接。具体OCS与充值系统接口规范，参见如下分册：中国联通IT系统 BSS系统域 在线计费系统接口规范 充值分册4.3. OCS与网管系统接口OCS配合网管系统完成集中的网管功能。OCS作为服务端通过SNMP协议或信息点文件提供网管信息，网管系统作为服务端到OCS采集网管信息。具体OCS与网管系统接口规范，参见如下分册：中国联通IT系统 BSS系统域 在线计费系统接口规范 网管分册4.4. OCS与Billing系统接口Billing系统到OCS的数据同步接口。Billing系统通过文件接口、接口表或实时同步接口将用户数据、订购数据、计费基础数据等信息同步到OCS系统。OCS到Billing系统的话单输出接口。OCS通过文件接口将话单输出到Billing系统。具体OCS与Billing系统接口规范，参见如下分册：中国联通IT系统 BSS系统域 在线计费系统接口规范 Billing分册中国联通IT系统 BSS系统域 在线计费系统接口规范 话单分册5. 接口协议5.1. SMPP+协议概述接口协议最初由收录在.规范中，描述了短消息中心与短消息实体之间通信交互的协议关系及数据传输格式，本规范对接口协议的描述主要面向简单的通信交互，制定规范的厂家将其协议版本号定为.；后由开发者论坛将协议版本向前演进为.，.协议规范完全兼容.协议标准。协议可以以或.作为底层通讯承载。SMPP+协议是在SMPP协议的基础上，制定了预付费用户点到点短消息实时计费业务规范及预付费增值业务实时计费平台与短消息中心的通信技术协议。OCS与SMSC之间的接口协议采用中国联通的SMPP+协议。5.1.1. 中国联通 SMPP+ 协议的现状基于智能网的预付费（PDSCP）与SMSC之间的接口采用中国联通SMPP+协议。现网在用的SMPP+的协议版本包括V1.0，V1.2，以及V1.22。其中，较多省分采用的SMPP+协议为：中国联通预付费用户点到点短消息实时计费实现技术规范(1.2)。5.1.2. SMPP+协议的选择各省分根据实际应用情况，OCS需要支持现网的SMPP+协议版本。对于今后SMSC和OCS同时升级支持新的SMPP+协议版本，本规范不做规定。5.2. DCC协议5.2.1. 概述传统的用于完成计费功能的Radius协议，以其简单安全，易于管理，扩展性好，而得到广泛应用。但是由于协议本身的缺陷，比如基于UDP的传输、简单的丢包机制、没有关于重传的规定和集中式计费服务，都使得它不太适应当前网络的发展，需要进一步改进。随着新的接入技术的引入和移动网络的快速扩容，对AAA协议提出了新的要求，使得传统的RADIUS结构的缺点日益明显。目前3G网络正逐步向全IP网络演进，不仅在核心网络使用支持IP的网络实体，在接入网络也使用基于IP的技术，而且移动终端也成为可激活的IP客户端。这就需要采用新一代的AAA协议Diameter。Diameter基础协议为各种认证、授权和计费业务提供了安全、可靠、易于扩展的框架。以此为基础定义Diameter应用，只需要定义应用协议的应用标识、参与通信的网络功能实体、相互通信的功能实体间的消息内容以及协议过程，就可以完全依赖Diameter基础协议完成特定的接入和应用业务。Diameter协议具有如下特性： (1)拥有良好的失败机制，支持失败替代(failover)和失败回溯(faiback)；(2)拥有快速检测到对端不可达的能力； (3)拥有更好的包丢弃处理机制，Diameter协议要求对每个消息进行确认；(4)可以保证数据体的完整性和机密性； (5)支持端到端安全，支持TLS和IPSec； (6)为每个会话进行认证/授权，以保证安全性； 在Diameter基础协议上扩展的应用协议Diameter Credit Control Application，定义了针对预付费用户的计费机制，采用信用额度控制实现了基于会话及事件的计费，解决了对于预付费的计费需求。5.2.2. DCC消息头DiameterCC协议的消息结构如下，这些字段是以网络字节顺序传送的。0123012345670123456701234567012345671VersionMessage Length2Command flagsCommand-Code3Application-ID4Hop-by-Hop Identifier5End-to-End Identifier6AVPs.NAVPsq Version协议版本号，当前置为1q Message Length消息长度，由3个字节组成，该长度包括消息头。q Command Flags命令标记，8位长度，目前已分配的内容如下： 0 1 2 3 4 5 6 7 +-+-+-+-+-+-+-+-+ |R P E T r r r r| +-+-+-+-+-+-+-+-+l R(equest)-置1时表示是请求消息，置0表示是应答消息l P(roxiable)-置1时表示该消息可以被代理、中继或者重定向，置0表示该消息需要本地处理l E(rror)-置1时表示该消息包含了协议错误，消息内容与该消息命令的ABNF语法描述不一致，通常通过设置E位来说明这是一个错误消息。但该位不可在请求消息中设置。l T(Potentially re-transmitted message)- 该标记在链路失败过程后被设置，以帮助去除重复的请求。当重发请求还没有被确认时，需要设置该比特，以作为链路失败而造成的可能的重复包的指示。当第一次发送一个请求时，该比特必须被清零，否则发送者必须设置该比特。Diameter代理仅需要关心它们发送的同一请求消息的遍数；其它实体进行的重传不须考虑。Diameter代理接收到一个T比特设置为1的请求，必须在前转该请求时保持T标记的设置。如果接收到一个以前消息的差错消息（例如协议差错），则不可以设置该标记。该标记只有在没有接收到任何来自服务器的该请求的应答、且该请求再次被发送的情况下，才能被设置。该标记不能在应答消息中设置l r(eserved)- 这些标记比特为将来使用预留，必须设置为0，接收者应当忽略q Command Code命令代码，由3个字节组成，指明该消息所对应的命令码值，该24位地址空间由IETF的IANA负责分配管理。命令码值16，777，214和16，777，215（16进制的FFFFFEFFFFFF）被预留为实验使用。q Application-ID应用ID，由4个字节组成，指明该消息适用于什么应用。对于CER/CEA、DWR/DWA、DPR/DPA基础消息，消息头中的application_id均为0；对于CCR/CCA、ASR/ASA、RAR/RAA会话控制相关消息，消息头中的application_id均为4。5.2.3. AVP头格式0123012345670123456701234567012345671AVP Code2VMPrrrrrAVP Length3Vendor-ID (opt)4Data.NData说明：在消息体定义中，类型域中的OctetStringN（N为整数），由基本类型OctetString派生出来，限制长度不大于N；必选属性域“M”表示该AVP在消息中必选，“C”表示该AVP在消息中条件可选。AVP名称前面的*表示该AVP是可重复的。AVP的M位标志表示该AVP是否为消息接收和发送方必须识别和进行校验。本规范中对于AVP Code大于20000的为联通自定义AVP，Vendor-ID取值为46001，M位标志默认不设置，如果发送方设置了M位标志，则必须保证该AVP是规范中已经定义的，而且取值是合法有效的。消息定义中定义了AVP的Vendor-ID的，AVP的V位标志应当设置。5.2.4. AVP数据类型每个AVP“Data”段的数据格式必须是基本数据类型或者由基本数据类型生成的其它数据类型，数据段的长度由自身的“AVP Code”和“AVP Length”来决定。详细参考RFC-35885.2.5. 消息分类中国联通DCC协议包含了CCR/CCA，RAR/RAA，CER/CEA，DWR/DWA，DPR/DPA，ASA/ASA消息，用于OCS与SACP，VASP/VAC，GGSN，IMS之间的接口。CCR/CCA消息与各网元具体的接口定义，参见各接口规范分册。RAR/RAA，CER/CEA，DWR/DWA，DPR/DPA，ASA/ASA等基础消息更详细的内容可以参考RFC-3588和RFC-4006。说明：在消息定义中： 符号表示必选而且位置必须是在消息的开头， 符号表示必选， 符号表示可选，* 符号表示可重复的可选项。命令名命令代码消息源消息目的缩略语Credit-Control-Request272CTFOCSCCRCredit-Control-Answer272OCSCTFCCARe-Auth-Request258OCSCTFRARRe-Auth-Answer258CTFOCSRAACapabilities-Exchange-Request257CTFOCSCERCapabilities Exchange Answer257OCSCTFCEADevice-Watchdog-Request280CTF/OCSOCS/CTFDWRDevice-Watchdog-Answer280OCS/CTFCTF/OCSDWADisconnect-Peer-Request282OCS/CTFCTF/OCSDPRDisconnect-Peer-Anwser282CTF/OCSOCS/CTFDPAAbort-Session-Request274OCSCTFASRAbort-Session-Answer274CTFOCSASA5.2.6. 消息定义5.2.6.1. CCR := Origin-Host Origin-Realm Destination-Realm Auth-Application-Id Service-Context-Id CC-Request-Type CC-Request-Number Destination-Host User-Name Origin-State-Id Event-Timestamp * Subscription-Id Termination-Cause Requested-Action Multiple-Services-Indicator Multiple-Services-Credit-Control Service-Information * AVP CCR-AVP名称AVP代码数据类型SACP消息中必选属性VAC/VASP消息中必选属性GGSN消息中必选属性VendorIDAVP M位标志263UTF8StringMMMMOrigin-Host264DiameterIdentityMMMMOrigin-Realm296DiameterIdentityMMMMDestination-Host293DiameterIdentityCCCMDestination-Realm283DiameterIdentityMMMMAuth-Application-Id258Unsigned32MMMMService-Context-Id461UTF8StringMMMMCC-Request-Type416EnumeratedMMMMCC-Request-Number415Unsigned32MMMMUser-Name1UTF8StringCCCMOrigin-State-Id278Unsigned32CCCMEvent-Timestamp55TimeCCCM*Subscription-Id443GroupedMMMM Subscription-Id-Type450EnumeratedMMMM Subscription-Id-Data444UTF8StringMMMMTermination-Cause295EnumeratedCCCMRequested-Action436EmumeratedCMMultiple-Services-Indicator455EnumeratedCCCM*Multiple-Services-Credit-Control456GroupedCCCM *Requested-Service-Unit437GroupedCCM CC-Time420Unsigned32CCM CC-Money413GroupedC Unit-Value445GroupedMM Value-Digits447Integer64MM Exponent429Integer32CM Currency-Code425Unsigned32CM CC-Total-Octets421Unsigned64CCM CC-Input-Octets412Unsigned64CC CC-Output-Octets414Unsigned64CCM CC-Service-Specific-Units417Unsigned64CCM *Used-Service-Unit446GroupedCCCM Reporting-Reason872EnumeratedCCC10415M Tariff-Change-Usage452EnumeratedCCCM CC-Time420Unsigned32CCCM CC-Total-Octets421Unsigned64CCCM CC-Input-Octets412Unsigned64CCC CC-Output-Octets414Unsigned64CCCM CC-Service-Specific-Units417Unsigned64CCCM *Service-Identifier439Unsigned32CCCM Rating-Group432Unsigned32CM Reporting-Reason872EnumeratedCCC10415M Trigger1264GroupedCCC10415M *Trigger-Type870EnumeratedCCC10415MService-Information873GroupedCCC10415M IN-Information20300GroupedC46001 Calling-Party-Address20336UTF8StringM46001 Called-Party-Address20337UTF8StringM46001 SSP-Time20386TimeC46001 Real-Called-Number20327UTF8StringC46001 Connect-Called-Number20373UTF8StringC46001 Called-Short-Number20338UTF8StringC46001 Access-Code20358OctetStringC46001 Charge-Flow-Type20339Unsigned32M46001 Calling-Partys-Category20301Unsigned32C46001 Calling-Vlr-Number20302UTF8StringM46001 Calling-CellID-Or-SAI20303UTF8StringC46001 Calling-LAI20304UTF8StringC46001 Called-Vlr-Number20305UTF8StringC46001 Called-CellID-Or-SAI20306UTF8StringC46001 Called-LAI20307UTF8StringC46001 Called-IMEI20308UTF8StringC46001 Calling-IMEI20309UTF8StringC46001 Oiginal-Called-Party-Id20310UTF8StringC46001 High-Layer-Compatibility20311UTF8StringC46001 Additional-Calling-Party-Number20312UTF8StringC46001 Bearer-Capability20313OctetStringC46001 Bearer-Capability220314OctetStringC46001 EventType-BCSM20315Unsigned32C46001 Redirecting-Party-Id20316UTF8StringC46001 Redirection-Reason20363Unsigned32C46001 UE-IMSI20318UTF8StringC46001 Tele-Service-Code20319OctetStringC46001 Bearer-Service-Code20320OctetStringC46001 Call-Reference-Number20321OctetStringC46001 MSC-Address20322UTF8StringM46001 GMSC-Address20323UTF8StringC46001 Time-Zone20324Unsigned32C46001 IN-Service-Indicator20325Unsigned32C46001 ServiceKey20326Unsigned32M46001 Called-Party-Address-Nature20328Unsigned32C46001 VASP-Information20500GroupedC46001 Message-Id20501OctetStringM46001 ChargingType20502Unsigned32C46001 Charge-Party-Type20503EnumeratedC46001 OA-Subscription-Id20506GroupedC46001 Subscription-Id-Type450EnumeratedMM Subscription-Id-Data444UTF8StringMM DA-Subscription-Id20507GroupedC46001 Subscription-Id-Type450EnumeratedMM Subscription-Id-Data444UTF8StringMM FA-Subscription-Id20508GroupedC46001 Subscription-Id-Type450EnumeratedMM Subscription-Id-Data444UTF8StringMM Service-Id20509OctetStringM46001 SP-Id20510OctetStringM46001 Product-Id20511OctetStringM46001 SPC_ProductID20521OctetStringM46001 SP_ProductID20522OctetStringM46001 ContentID20512OctetStringC46001 OrderMethod-ID20524OctetStringM46001 Push-ID20525OctetStringC46001 CP-ID20526OctetStringC46001 Service-Type20513Integer64M46001 Service-BeginTime20514OctetStringC46001 Service-Enabler-Type20515Integer64M46001 ClientIP20517OctetStringC46001 PS-Information874GroupedC10415M 3GPP-Charging-Id2OctetStringM10415 3GPP-PDP-Type3EnumeratedC10415 PDP-Address1227AddressC10415M 3GPP-GPRS-Negotiated-QoS-Profile5UTF8StringC10415 SGSN-Address1228AddressC10415M GGSN-Address847AddressC10415M CG-Address846AddressC10415M 3GPP-IMSI-MCC-MNC8UTF8StringC10415 3GPP-GGSN- MCC-MNC9UTF8StringC10415 3GPP-NSAPI10UTF8StringC10415 Called-Station-Id30UTF8StringCM 3GPP-Session-Stop-Indicator11OctetStringC10415 3GPP-Selection-Mode12UTF8StringC10415 3GPP-Charging-Characteristics13UTF8StringC10415 3GPP-SGSN-MCC-MNC18UTF8StringC10415 3GPP-MS-TimeZone23UTF8StringC10415 Charging-Rule-Base-Name1004UTF8StringC10415 3GPP-User-Location-Info22OctetStringC10415 3GPP-RAT-Type21OctetStringC104155.2.6.2. CCA := Result-Code Origin-Host Origin-Realm Auth-Application-Id CC-Request-Type CC-Request-Number CC-Session-Failover * Multiple-Services-Credit-Control Cost-Information Credit-Control-Failure-Handling Direct-Debiting-Failure-Handling * Redirect-Host Redirect-Host-Usage Redirect-Max-Cache-Time * Failed-AVP Service-Information * AVP CCA-AVP名称AVP代码数据类型SACP消息中必选属性VAC/VASP消息中必选属性GGSN消息中必选属性VendorIDAVP M位标志263UTF8StringMMMMResult-Code268Unsigned32MMMMOrigin-Host264DiameterIdentityMMMMOrigin-Realm296DiameterIdentityMMMMAuth-Application-Id258Unsigned32MMMMCC-Request-Type416EnumeratedMMMMCC-Request-Number415Unsigned32MMMMCC-Session-Failover418EnumeratedCCCM*Multiple-Services-Credit-Control456GroupedCCCM Granted-Service-Unit431GroupedCCCM Tariff-Time-Change451TimeCCCM CC-Time420Unsigned32CCCM CC-Total-Octets421Unsigned64CCCM CC-Input-Octets412Unsigned64CCC CC-Output-Octets414Unsigned64CCCM CC-Service-Specific-Units417Unsigned64CCCM *Service-Identifier439Unsigned32CCCM Rating-Group432Unsigned32CM Validity-Time448Unsigned32CCCM Result-Code268Unsigned32CCCM Final-Unit-Indication430GroupedCCCM Final-Unit-Action449EnumeratedCCCM Redirect-Server434GroupedCCCM Redirect-Address-Type433EmumeratedMMCM Redirect-Server-Address435UTF8StringMMCM Time-Quota-Threshold868Unsigned32CCC10415M Volume-Quota