中国移动网状网系统接口规范---SOAP模块-v2.0.3汇编

('中国移动通信企业标准中国移动网状网规范总册版本号：2.0.3QB-J-XXX-2010QQB-J-001-2009ii中国移动通信有限公司发布2014-xx-xx发布2014-xx-xx实施网状网规范总册文档变更记录序号变更内容说明版本号版本日期执笔人1添加5.3.1.3消息头中MsgSender和MsgReceiver说明7.1.10细化说明了加解密和SoapFault及业务失败时处理的问题1.0.42013-8-29王伟2细化5.4.1机构状态检测的规定和说明1.0.52013-9-13王伟3更新5.6.1.4管理类交易中密钥更新请求部分1.0.62013-9-23王伟4修正5.6.1.4管理类交易中密钥更新请求部分1.0.72013-9-23王伟5更新2.0版本，对应报文头version字段为0200的所有报文请求。2.x版本和1.x版本的变更内容列表请参见5.4章节的接口规范变更。2.0.02014-4-14王伟61.增加5.1对外接口；2.原“接口规范变更”更名为“5.5.2.x版本与1.x版本差异”；3.“接口描述”增加“同步模式和异步模式接口差异”，同时分为“交易模式”和“交易流程”；4.调整“接口描述”下面的章节顺序；5.“接口描述”增加“SOAPfault结构”、“系统错误报文样例”和“业务错误报文样例”；6.增加“SOAP错误编码”；7.去掉重复的“SN-S模块”内容。2.0.12014-6-10王伟孙慧云7修正5.6.4“SOAPFault”的结构，使用Subcode以符合W3C规范标准。2.0.22014-10-27王伟8更新5.8.3部分节点加密的样例，更加清晰的反应了加密的部分；补充说明部分节点加密中，默认使用节点值加密方式。2.0.32014-12-22王伟910中国移动通信公司3网状网规范总册序号变更内容说明版本号版本日期执笔人11中国移动通信公司4网状网规范总册目录1.适用范围....................................................................................................................................82.引用标准....................................................................................................................................83.总体说明....................................................................................................................................93.1.设计原则............................................................................................................................103.2.规范体系............................................................................................................................114.网状网系统总体架构................................................................................................................124.1.网状网逻辑架构................................................................................................................124.2.接入基础层描述................................................................................................................134.3.业务管理层........................................................................................................................134.3.1.BMC（BusinessManagementCenter）....................................................................134.4.传输服务层........................................................................................................................134.4.1.控制子层MC（ManagementCenter）................................................................144.4.2.传输子层....................................................................................................................145.SN－S模块............................................................................................................................165.1.对外接口............................................................................................................................165.2.适用范围............................................................................................................................165.3.基础概念............................................................................................................................175.3.1.交易参与方................................................................................................................175.3.2.服务编码规则............................................................................................................185.3.3.服务描述文件WSDL文件的取得............................................................................185.3.4.交易模式....................................................................................................................195.3.5.交易流程....................................................................................................................205.3.6.SOAP错误（SOAPFault）....................................................................................255.4.接口协议............................................................................................................................255.5.2.x版本与1.x版本差异....................................................................................................255.6.接口描述............................................................................................................................265.6.1.SOAP命名空间说明................................................................................................265.6.2.消息头........................................................................................................................295.6.3.消息体........................................................................................................................32中国移动通信公司5网状网规范总册5.6.4.SOAPfault结构........................................................................................................325.6.5.正常请求报文样例....................................................................................................335.6.6.正常应答报文样例....................................................................................................345.6.7.系统错误报文样例....................................................................................................355.6.8.业务错误报文样例....................................................................................................365.7.交易管控............................................................................................................................385.7.1.对机构的检测与控制................................................................................................385.7.2.机构间的传输控制....................................................................................................405.7.3.拥塞控制....................................................................................................................405.8.安全....................................................................................................................................415.8.1.报文加密....................................................................................................................415.8.2.全体报文加密样例....................................................................................................425.8.3.部分节点加密样例....................................................................................................435.9.服务管理............................................................................................................................445.9.1.服务开通....................................................................................................................445.9.2.服务的调用................................................................................................................455.9.3.密钥更新请求............................................................................................................475.9.4.服务查询....................................................................................................................506.统一管理....................................................................................................................................506.1.S模块系统管理................................................................................................................506.1.1.管理交易服务............................................................................................................506.1.2.BMC................................................................................................................................506.1.3.MC................................................................................................................................506.1.4.交换节点....................................................................................................................506.1.5.DOMAIN编码............................................................................................................516.1.6.机构系统编码............................................................................................................526.1.7.路由类型编码............................................................................................................536.1.8.省代码........................................................................................................................536.1.9.SOAP错误编码........................................................................................................537.名词与术语................................................................................................................................548.接口常用词词典........................................................................................................................58中国移动通信公司6网状网规范总册8.1.目标....................................................................................................................................588.2.编写原则............................................................................................................................588.3.命名规则............................................................................................................................588.4.业务名词主要关系............................................................................................................598.5.XML业务名词....................................................................................................................598.5.1.客户信息....................................................................................................................598.5.2.用户信息....................................................................................................................608.5.3.账户信息....................................................................................................................608.5.4.集团客户信息............................................................................................................618.5.5.集团客户订购信息....................................................................................................618.5.6.成员信息....................................................................................................................628.5.7.SI信息........................................................................................................................62中国移动通信公司7网状网规范总册前言本规范由中国移动通信有限公司业务支撑系统部提出并归口。本规范起草单位：中国移动通信有限公司业务支撑系统部。本规范解释单位：中国移动通信有限公司业务支撑系统部。中国移动通信公司8网状网规范总册1.适用范围《中国移动通信网状网规范总册》（以下简称“总册”）描述了中国移动网状网系统（以下简称网状网）的体系结构、应用软件结构、系统边界和外部接口、系统功能等。本规范是中国移动网状网系统一期目标规划和建设的基本依据；本规范适用于指导中国移动一级业务系统、各省（直辖市、自治区）移动公司（以下简称“省公司”）、各全网业务管理平台接入网状网系统的建设。原有的《中国移动有限公司一级BOSS接口规范_总体架构和系统管理分册v1.4.5》将由本规范取代。网状网规范适用于所有的省BOSS间业务和与省BOSS相关的全网数据业务。2.引用标准本规范引用如下标准以及中国移动通信制定的规范。T模块引用标准：[1]W3CHTTP1.1：http://www.w3.org/Protocols/D模块引用标准：[1]省级业务运营支撑系统（BOSS）业务技术规范欠费风险控制分册（3.0版）[2]IETFRFC3588－DiameterBasedProtocol[3]IETFRFC4006－DiameterCredit-ControlApplication[4]3GPPTS32.299Telecommunicationmanagement;Chargingmanagement;DiameterchargingapplicationsS模块引用标准：[1]W3CSOAP1.2：http://www.w3.org/TR/SOAP/中国移动通信公司9网状网规范总册3.总体说明中国移动网状网系统是基于计算机应用技术、用以支持中国移动全网数据业务运营的信息系统。网状网负责连接总部系统、31个省BOSS系统和全网全网业务平台，实现BOSS与BOSS，BOSS与全网全网业务平台、全网全网业务平台与全网全网业务平台之间的交易通信、数据同步。目标中国移动网状网系统的建设目标是构建一个信息资源充分共享的一体化业务数据传输网络，通过传输基础层实现全网业务的承载，通过业务层实现全网产品的陈设、订购、开通、结算、业务的统一管理及流程支持，为未来的全网一体化运营支撑能力打下基础：1.建设网状结构的业务交换网络，实现中国移动省级业务支撑系统、总部业务系统和全网业务平台间的互联互通。2.建设统一的管理中心（MC），实现全网路由管理、数据发布、系统和业务监控等功能。3.建设一级业务管理中心（BMC），实现业务数据采集、产品管理、业务的横向及纵向调度及业务结算支撑。4.重构HTTP模块，实现基于HTTP+XML格式的联机交易。包含系统大圈类交易，业务大圈类交易和通知类交易。5.新建DCC模块，支撑实时计费类的DCC协议。建设全业务的欠费控制网络。6.重构FTP模块，实现文件类业务的FTP传输。提高整个文件传输的安全性，时效性和管控。7.新建SOAP模块，实现对SOAP协议的支撑。方便接入实现SOAP协议的机构的交易。编写原则本次网状网规范总册的编写原则如下：1、本规范明确中国移动全国网状网系统总体建设要求。2、本规范就网状网系统体系架构、系统结构、系统边界等予以定位。3、本规范不包含具体业务接口。4、本规范描述网状网系统各模块的功能、运作流程、管理方式，不涉及网状网系统本身的技术实现。中国移动通信公司10网状网规范总册3.1.设计原则网状网系统的主要设计原则：−业务与传输的分离：通过分层设计降低系统复杂性和提高系统适应性是一个通用的设计原则。网状网由接入层、传输服务层和业务管理层构成，接入层是网络层，传输服务层负责接口的数据交换和相关配置管理工作，业务管理层负责业务数据采集、业务调度、结算，报表等业务管理功能（由BMC模块实现）。原有的一级BOSS枢纽系统功能高度集成在交换中心，只支持HTTP协议，没有清晰的层次概念，从整体框架上无法支撑多协议传输和未来的业务需求（例如全网产品管理、业务流程调度等）。网状网分离业务和传输，使业务和传输的关系由紧耦合变为松耦合，可以任意调整各个层次的功能而不互相影响，弹性强，适应性好，大大地提升了整体支撑能力，即满足现有业务需求，也为未来打下基础；−传输与控制的分离：原有的一级BOSS枢纽系统是星形拓扑结构，传输服务和传输的控制管理是一体的，紧凑高效。网状网为了消除交换中心一点故障即全网瘫痪的缺陷，提高整体稳定性和传输效率，将星形结构改为网状结构，变集中交换为分散交换，将原有的交换功能从交换枢纽分散到各交换节点，架构的改变必然导致系统管理模式的改变。因此网状网将传输与传输控制分离。传输服务层由传输子层和控制子层构成，传输子层由管理模块（M模块）和各协议交换模块（T、D、F、S）组成。控制子层由MC模块构成，MC模块负责传输子层各协议模块的状态管控、配置数据发布，传输子层M模块上传协议模块的状态信息，接受控制子层发布的命令，实时变更配置数据。此种设计不但轻便灵活，既满足分层设计的原则，又提高了各协议模块的吞吐能力；−标准化:使用基于标准构件和流程以简化IT资产的使用方式；−模块化：利用分布式技术将简单的模块组合，实现复杂的系统功能；−集成化：通过一致的系统间集成来方便地管理和修改环境；另外，系统的设计还遵循以下原则：−先进性选用先进的应用系统架构模型，以及先进的硬、软件平台，以保证系统的先进性。中国移动通信公司11网状网规范总册−可扩展性系统架构支持未来系统的扩展需求，支持新业务快速上线。−系统的安全性采取数据保密和安全措施，进行权限与加密管理，以保证系统和数据的安全。3.2.规范体系网状网规范体系包括网状网规范总册、业务用词词典、网状网省间业务接口规范分册、网状网全网数据业务接口规范分册。共同为网状网的建设提供统一的规范和标准。网状网规范总册从总体上阐述了网状网的逻辑结构、技术架构、功能、基础概念、关键流程，所有接入网状网的机构必须遵循总册的要求方能达到接入的目的。网状网规范总册最终将替代原有的《中国移动有限公司一级BOSS接口规范_总体架构和系统管理分册v1.4.5》。网状网业务规范单行本针对特定业务，详细说明相关业务场景、系统接口、接入要求，直接指导业务关联系统间的对接建设。今后按照网状网总册的接入要求修改原有的一级BOSS枢纽业务单行本。中国移动通信公司12网状网规范总册4.网状网系统总体架构网状网从总体上分为3个层次，基础网络层（IP承载网）、传输服务层、业务管理层。4.1.网状网逻辑架构图表4-1网状网逻辑架构整个系统逻辑上分为两层：业务管理层和传输服务层。通过这两层的划分，实现了传输与业务的分离。另外传输服务层内部又分成两个子层：控制子层和传输子层。实现了传输和控制的分离。SN在实现上包括管理模块（M）和T、D、F、S部分。协议模块是核心部分。中国移动通信公司13网状网规范总册4.2.接入基础层描述图表4-2接入基础层如上图所示，基础网络层使用IP承载网，实现各省接入网络设备的互联互通，各服务节点SN接入到本地的接入网络设备连接至IP承载网中，实现各省节点的可连通性。IP承载网采用双平面设计，任何2个节点之间有多个冗余路由，实现网路的接入安全。4.3.业务管理层4.3.1.BMC（BusinessManagementCenter）业务管理中心。物理上部署在总部。作为网状网的管理中心，业务管理平台负责产品管理、业务的跨省（平台）调度、平台日终处理、业务对账、结算管理等。并且对未来的全网一体化运营提供技术支撑。业务管理层与传输服务层通过各种协议交互。中国移动通信公司14网状网规范总册4.4.传输服务层在传输服务层（TSN）通过对管理中心（MC）子层与传输子层（SN）的划分，实现了传输与控制的分离，管理中心与传输子层通过各种协议交互。如下图所示，传输服务层由各省（总部）的交换节点SN和管理中心MC组成。各省服务节点面向各省业务系统，实现业务的接入及业务传输，总部服务节点面向总部的业务平台，实现总部业务平台的接入以及业务的传输。整个传输服务层基于底层IP承载网提供可靠的点对点传输服务，具备路由选择、流量控制、压缩加密、鉴权管理、业务传输、数据采集等功能。管理中心完成TSN的管理控制功能，包括路由管理、局数据管理、数据采集、数据发布、作业调度、服务管理、SLA管理等。图表4-3传输服务层中国移动通信公司15网状网规范总册4.4.1.控制子层MC（ManagementCenter）管理中心。物理上部署在总部。作为一个系统的中枢，负责整个系统的配置管理，规则定义，系统和业务监控，对外系统接口，和任务分派等。逻辑上只有一个MC，可以通过在南北中心各建一个达到容灾的能力。4.4.2.传输子层4.4.2.1.M（Management）模块管理模块。物理上该模块部署在交换节点SN上。每一个SN部署一个M模块。作为MC定义规则的执行者，MC下发配置，规则数据和相应的指令。M模块负责协调自己管辖的T，F，D，S模块按照规则来进行交易。4.4.2.2.T（Transaction）模块HTTP交易管理模块。物理上部署在SN节点，可以有一个或多个点，而且能够实现平滑的水平扩展。主要负责实时报文交易的传输。包含大圈和通知等交易类型。具有交易路由，完整性校验，消息可靠性传输，加解密，报文格式校验，交易冲正等功能。4.4.2.3.F（File）模块文件传输的管理模块。物理上部署在SN节点，可以有一个或者多个，能够实现平滑扩展。主要负责文件类业务的传输。包含文件路由，压缩，加解密，完整性校验等功能。4.4.2.4.D（DCC）模块DCC协议管理模块。物理上部署在SN节点，可以有一个或者多个，可以平滑扩展。主要负责DCC协议交易的路由，报文校验和转发功能。4.4.2.5.S（SOAP）模块SOAP协议管理模块。物理上部署在SN节点，可以有一个或者多个，可以平滑扩展。主要负责SOAP协议交易的路由，加解密，报文校验和转发功能。中国移动通信公司16网状网规范总册5.SN－S模块5.1.对外接口S模块主要和发起方机构（省BOSS或全网业务平台），M模块，MC模块有接口，如下图所示：图表5-1S模块对外接口示意图5.2.适用范围随着SOA和WebService标准的推广，SOAP协议越来越成为一种数据业务平台对外的标准协议，考虑到未来枢纽支撑协议的多样性，网状网本次新部署了一个SOAP模块，专门处理SOAP协议的转发。中国移动通信公司17网状网规范总册图表5-2SOAP模块示意图S模块为网状网支持SOAP协议的模块，是网状网系统的关键模块之一，负责所有基于SOAP的交易的管控。它继承并拓展了T模块的联机交易功能，适用于基于SOAP协议的服务的接入和服务的提供。5.3.基础概念5.3.1.交易参与方5.3.1.1.SN(ServiceNode)节点每个省的SN都部署一个SOAP模块，作为SOAP协议的中继。负责机构间交易报文的转发，并且进行报文格式转换、校验、加解密、传输控制、交易冲正和必要的协议转换工作。机构在接入网状网时需要明确自己要接入的交换节点，在整个交换系统内每个交换节点具有自己的唯一标识（称为DUNS）。中国移动通信公司18网状网规范总册5.3.1.2.机构（SP（ServieProvider））真正的服务提供方，每个机构都有自己唯一的ID，作为路由标识，同时机构接入网状网必须要实现心跳，签到/签退，加解密等管理接口。5.3.1.3.SC（ServiceConsumer）服务使用者是调用服务的一方。调用方也都有自己的唯一ID，作为路由标识，同时作为身份的鉴别标志。5.3.2.服务编码规则为了更好的管理服务，每个服务都要遵循一定的编码规则：服务编码组成格式为：SVC_【DOMAIN】【DUNS】_【FUNCTION】包含四个部分：1、固定头“SVC”表示服务（Service）；2、4位【DOMAIN】表示SP的域编码，比如BOSS标识省BOSS,MUSC标识音乐基地；3、4位【DUNS】表示SN的编码，比如2800标识四川省SN；3、4位【FUNCTION】表示业务功能,比如鉴权用AUTH；例如，四川音乐平台的鉴权服务的编码为：SVC_MUSC2800_AUTH5.3.3.服务描述文件WSDL文件的取得服务注册之后，服务调用方可以通过以下的方式取得WSDL文件，查看服务，或者调用服务，调用服务地址为:http://sn的s模块IP地址:端口/services/服务编码形如:http://localhost:8080/SoapServices/services/Math查看wsdl链接为：http://sn的s模块IP地址:端口/services/服务编码?wsdl形如:http://localhost:8080/SoapServices/services/Math?wsdl中国移动通信公司19网状网规范总册5.3.4.交易模式5.3.4.1.模式说明按照不同的交易模式，SOAP的交易可以分为三种。同步模式（IN-OUT）：服务调用方必须要等到服务提供方返回响应消息才认为服务调用完成。否则认为超时。该模式类似于T模块的大圈类交易。异步模式（IN-ONLY）:服务调用方只管发送请求，不需要服务提供方的返回。该模式类似T模块的通知类交易。订购-发布模式（SUB-PUB）:服务调用方注册服务，服务有结果时进行广播。类似于T模块的中心落地大圈。5.3.4.2.同步模式和异步模式接口差异同步模式和异步模式的发起请求报文规则完全相同；但是对于发起请求报文后收到的应答报文，这两种模式不相同，差异如下：对于同步模式，发起一个请求报文后，会一直等到收到应答报文，此应答报文详见5.4章节的接口协议中应答报文说明。对于异步模式，发起一个请求报文后，会立即收到网状网系统返回的应答报文。应答报文分两种：1.正常应答报文：网状网收到请求报文后，存储报文并立即返回应答报文，网状网后续将该请求转发给落地方。应答报文样例参见5.6.6正常应答报文样例中“2.异步模式交易应答报文样例”。2.异常应答报文：请求报文格式错误或其他类型错误（例如：无权限、路由不正确、落地方已经注销等错误）时，网状网系统会立即返回给发起方一个应答报文，该应答报文的SoapBody中只包含SoapFault节点，SoapFault节点中描述了错误的原因和详细信息。网状网系统依然会尝试存储该异常请求报文但不会转发此报文。应答报文样例参见5.6.7系统错误报文样例。5.3.5.交易流程5.3.5.1.同步模式5.3.5.1.1.适用范围各种和用户体验相关的业务场景，具有小数据量、低时延等特点。中国移动通信公司20网状网规范总册5.3.5.1.2.流程系统类大圈指的是发起方与OSN以及落地方与HSN间采用同步类通信机制（采用连接堵塞等待应答消息、SN负责超时控制），OSN与HSN之间以异步通信实现业务的交易模式。系统大圈的正常流程如下：图表5-4系统类大圈流程示意图本类交易可以冲正。在传递本类交易的请求时，OSN必须进行超时控制（超时时限在交易属性中描述）。若OSN发现一笔系统大圈类交易超时（HSN不参与交易控制，只负责转发），则向上游节点返回交易超时失败（OSN已发起冲正，若需要冲正）的应答，同时向下游节点发起冲正（若需要冲正的话）；若发起端机构发现一笔本类交易超时（若需要冲正的话），则向OSN发送冲正请求。以下各图为处理过程中的异常流程，分别是：1、发起方机构向OSN发送交易请求失败：向用户发送受理失败信息。中国移动通信公司21网状网规范总册2、OSN发现发起方机构发送的交易请求有错：告知发起方机构出错信息，发起方机构向用户发送受理失败信息。3、OSN向落地方机构转发请求信息失败：告知发起方机构出错信息，由发起方机构向用户发送受理失败信息。4、OSN等待落地方机构应答超时：告知发起方机构出错信息，发起方机构告知用户受理失败信息；如果此交易具有“需要冲正”属性，则OSN向落地方机构发送冲正业务，直到收到落地方机构的确认应答为止；落地方机构在收到冲正请求后给予OSN以确认应答并回退已完成的交易。此时如果OSN在向业务平台发送完出错信息后又收到了落地方的迟到应答，则丢弃。5、发起方机构等待OSN的应答超时：发起方机构向用户发送受理失败信息；如果此交易具有“需要冲正”属性，则发起方机构向OSN发送冲正请求，直到收到OSN的确认应答为止；OSN在收到冲正业务请求后，给与发起方机构确认应答，并向HSN转发冲正请求，直到收到HSN确认应答为止；HSN转发冲正请求，直到收到落地方机构确认应答为止；落地方机构在收到冲正请求后给予HSN以确认应答并回退已完成的需要被冲正的交易；如果发起方机构在产生冲正请求后又收到了OSN的迟到应答，则丢弃。经发起方机构受理的业务异常流程1：发起方机构向OSN发送交易请求信息失败中国移动通信公司22网状网规范总册经发起方机构受理的业务异常流程2：发起方机构向一级BOSS枢纽发送的消息有错经发起方机构受理的业务异常流程3：OSN向落地方机构转发信息失败中国移动通信公司23网状网规范总册经发起方机构受理的业务异常流程4：OSN等待落地方机构应答超时中国移动通信公司24网状网规范总册经发起方机构受理的业务异常流程5：发起方机构等待OSN应答超时5.3.5.2.异步模式由于参与交易各方之间为广域网联接，而且各参与方系统是独立管理，交易是否可以正常送达有一定的不可预见性。为了保证请求消息能够到达，我们采用存储转发方式。中国移动通信公司25网状网规范总册存储转发是指当下游节点不可及或者未正常应答时，上游节点将消息报文存储起来，定时发送，直到下游节点返回确认应答的机制。因此，作为上游节点的发起方机构或SN都要实现存储转发功能。存储转发类流程包括通知和冲正流程两类。发起方机构和发起方SN都会向下游节点发起通知或冲正交易，具体流程参见流程图。SN收到发起方的通知或冲正请求后，将标记当前逻辑交易日。在逻辑交易日日切之后，SN将不再发送前一逻辑交易日的存储转发交易，对于未能转发的交易，可以通过对帐和核对流水等机制保证各参与方的一致性。对于冲正交易，要求不能冲前一逻辑交易日的交易。中国移动通信公司26网状网规范总册图表5-5通知类交易流程图1)机构发起交易请求，OSN得到请求后进行格式校验。然后立即返回响应。机构认为交易发送完毕。2)OSN得到请求后，首先得到路由信息后，立即转发。如果发送成功，则在内存中保留log记录和报文体记录。如果转发不成功，则先将交易报文头保存到数据库，报文体保存到文件中，然后等待重发程序进行重发。如果重发依然不成功，则将下次重发时间增加，等待继续重发。如果多次发送不成功，则置为失败（每个交易的重发次数不一定）。3)HSN得到请求后，也是得到路由信息后，立即转发。如果发送成功，则在内存中保中国移动通信公司27网状网规范总册留log记录和报文体记录。如果转发不成功，则先将交易报文头保存到数据库，报文体保存到文件中，然后等待重发程序进行重发。如果重发依然不成功，则将下次重发时间增加，等待继续重发。如果多次发送不成功，则置为失败（每个交易的重发次数不一定）。4)落地方得到交易请求后，解析报文体，进行业务处理。不用返回业务响应。5.3.6.SOAP错误（SOAPFault）SOAPFault是SOAP标准的错误信息节点，是位于SOAPBody的根节点的可选子节点。在网状网S模块中，SOAPFault节点用于描述交易处理的错误信息，主要两类异常：报文传输失败时的异常信息（系统错误）和落地方业务处理失败时的异常信息（业务错误）。系统错误：SN节点或者落地方节点应按照下面的SOAPFault规范组织SOAPFault节点返回给发起方。此时返回报文的SOAPBody应当只有SOAPFault这一个子节点。业务错误：SN节点或落地方节点也应该组织SOAPFault返回给发起方。此时返回报文的SOAPBody除了包含必需的SOAPFault节点外，还可以（非强制）根据业务需求选择是否包含响应子节点，如果包含响应子节点则此时业务响应子节点和SOAPFault节点都是SOAPBody节点的子节点。网状网S模块的SOAPFault错误编码规则采用SOAP1.2的编码规则，错误代码为命名空间http://cmcc.trans下的5位数字组成，第一位数字以1或者2开头：1开头的为系统错误代码，2开头的为业务失败错误代码，详细参见6.1.9SOAP错误编码。注意：对于加密业务，SOAPFault节点本身不应做任何加密处理，而其余节点可按照业务需求选择加密或者不加密。5.4.接口协议S模块遵循SOAP1.2的规范，具体见http://www.w3.org/TR/soap12/。WSDL遵循WSDL2.0规范，具体见http://www.w3.org/TR/wsdl20/。5.5.2.x版本与1.x版本差异SOAP模块接口规范2.0版本相比于1.x版本有较大的变化。相关信息如下：中国移动通信公司28网状网规范总册5.5.1.1.变更原因随着业务的发展，沿用网状网Trans模块的SOAP模块1.x的规范无法满足新增业务的要求（例如多加密，统一错误代码等），同时为了更好的对业务报文规范化并使之更符合SOAP规范，故更新SOAP模块2.0规范。5.5.1.2.变更内容说明SOAP模块2.x版本规范和SOAP模块1.x版本规范主要差异说明：1.修改报文头中version字段为0200，对应匹配SOAP2.x版本规范的报文。（参见5.6接口描述）2.扩展了S模块加密规则，支持报文体应答节点全体加密和部分节点加密两种方式，同时不再强制要求DataReference的URI（亦即id）与节点名称一致。（参见5.8.1报文加密）3.去掉报文头中的一级应答码（Response节点）和应答报文中的二级应答码，改为标准的SOAPFaultCode表示，faultcode的subcode扩展为5位，涵盖业务错误和系统错误的信息。（参见5.6.4SOAPFault结构和6.1.9SOAP错误编码）5.6.接口描述网状网的S模块严格遵循SOAP的1.2版本的规范，同时对SOAP-ENV：header进行了扩展，对交易的路由和QOS进行管控。5.6.1.SOAP命名空间说明\uf06cSOAPEnvelope请严格使用soap1.2标准命名空间:http://www.w3.org/2003/05/soap-envelope\uf06c对于所有报文的报文头内InterBOSS节点的命名空间请严格使用:http://cmcc.trans\uf06c非加密报文体的命名空间请根据具体的业务wsdl文件定义的命名空间为准.\uf06c对于加密报文的命名空间请参见加密部分说明.\uf06c命名空间要求:s12请使用http://www.w3.org/2003/05/soap-envelopeds请使用http://www.w3.org/2000/09/xmldsig#中国移动通信公司29网状网规范总册wsse请使用http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsdwsse11请使用http://docs.oasis-open.org/wss/oasis-wsswssecurity-secext-1.1.xsdwsu请使用http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsdxenc请使用http://www.w3.org/2001/04/xmlenc#具体报文参见下例:02001BOSS00BOSS25012120302023881950P26011212yyt2150848S396356201203021518141234返回复杂对象的报文:中国移动通信公司30网状网规范总册02001BOSS00BOSS25012120302023881950P26011212yyt2150848S39635620120302151814TransIDH@trans.cmcc.Math2013070116004110002100201307011605328500000011d8ac8b6-3370-4f44-9aea-aba777821d3020120703201307011605321000280002352801customIDstatusidentCodeidentCodeLevelidentCodeType中国移动通信公司31网状网规范总册resultCodebrandcustomIDmSISDNprovincestatus5.6.2.消息头消息头中是各类交易控制信息、路由信息。根据XML的定义，每个XML文件需要有特定的RootTag（根标记），MessageHeader的RootTag为“InterBOSS”。各个字段解释如下表，各机构在实现时可使用枢纽定义下发的XSD文件。表1：SN与机构之间交互的统一消息头格式中国移动通信公司32网状网规范总册序号父元素名称元素名称约束类型长度描述取值说明1InterBOSSVersion1StringF4报文版本号0200，对于同一交易应答与请求版本号始终一致，0200表明使用SOAP2.x版本的规范（对于SOAP1.x版本规范的报文应version字段使用0100）2InterBOSSTestFlag1StringF1测试标记发起方填写0：非测试交易1：测试交易4InterBOSSRoutingInfo1交易路由信息4.1RoutingInfoOrigDomain1StringF4发起方应用域代码参见应用域编码表4.2RoutingInfoRouteType1StringF2路由类型参见路由类型编码，如按手机号码路由等4.3RoutingInfoRouting+路由信息4.3.1RoutingHomeDomain1StringF4归属方应用域代码参见应用域编码表4.3.2RoutingRouteValue1StringV20路由关键值路由类型对应的关键值，参见路由类型说明5InterBOSSTransInfo1交易流水信息5.1TransInfoSessionID1StringV30业务流水号发起方填写的包含此交易业务的流水号5.2TransInfoTransIDO1StringV30发起方交易流水号在发起方唯一标识一个交易的流水号，系统内唯一5.3TransInfoTransIDOTime1StringF14处理时间发起方发起请求的时间YYYYMMDDHHMMSS5.4TransInfoTransIDH?StringV30由落地方填写，落地方交易流水号在落地方唯一标识一个交易的流水号，系统内唯一5.5TransInfoTransIDHTime?StringF14由落地方填写，处理时间落地方处理请求的时间YYYYMMDDHHMMSS6InterBOSSSNReserve?机构不填，SN保留信息落地方在接到请求时、发起方在接到应答时读取6.1SNReserveTransIDC1StringV60SN交易流水号由网状网发起方SN填写6.2SNReserveConvID1StringV60SN处理标识只有发起方SN使用6.3SNReserveCutOffDay1StringF8日切点格式：yyyymmdd，清分对帐用6.4SNReserveOSNTime1StringF14处理时间发起方SN接到请求的时间YYYYMMDDHHMMSS6.5SNReserveOSNDUNS1StringF4发起方交换节点代码参见全国交换节点编码表6.6SNReserveHSNDUNS1StringF4归属方交换节点代码参见全国交换节点编码表6.7SNReserveMsgSender1StringF4发起方节点短代码参见全国交换节点编码表6.8SNReserveMsgReceiver1StringF4落地方节点短代码参见全国交换节点编码表中国移动通信公司33网状网规范总册5.6.3.消息体消息体为具体的服务请求的内容。对于报文体的格式，以具体的业务分册规范和相应的wsdl为准。S模块的强制性要求是任何情况下请求和应答报文体均不能为空。具体报文体格式不做强制性要求，一般性的建议如下：表2：SN与机构之间交互的一个请求消息的报文体格式的范例序号父元素名称元素名称约束类型长度描述取值说明1Body方法名(例如addUser)1String-请求报文体节点-2方法名(例如addUser)具体的请求报文内容---请求报文体节点请求报文体内容表3：SN与机构之间交互的一个应答消息的报文体格式的范例序号父元素名称元素名称约束类型长度描述取值说明1Body方法名+Response(例如addUserResponse)1String-方法名+Response节点-2方法名+Response(例如addUserResponse)return1String-return节点-3return具体的应答报文内容---应答报文体节点应答报文体内容5.6.4.SOAPfault结构网状网S模块中的SOAPFault采用SOAP1.2的SOAPFault规范，结构如下：序号父元素名称元素名称约束类型长度描述取值说明1BodyFault1String--SOAPFault根节点（命名空间为http://www.w3.org/2003/05/soap-envelope）1.1FaultCode1---Code节点（命名空间为http://www.w3.org/2003/05/soap-envelope）1.1.1CodeValue1String-SOAP标准异常代码（非S模块异常代码）SOAP标准错误代码，W3C规范规定，在网状网中使用两种值：env:Reciever：系统异常或落地方异常env:Sender：发起方异常其中env代表命名空间为http://www.w3.org/2003/05/soap-envelope1.1.2CodeSubcode1--S模块错误Subcode节点（命名空间为http://www.w3.org/2003/05/soap-envelope）中国移动通信公司34网状网规范总册1.1.2.1SubcodeValue1String-SOAP错误代码（参见系统错误编码规范和业务错误代码规范）发生异常的时候填写，五位数字，1开头为系统错误，2开头为业务错误（具体取值参见7.1.9错误编码）注意应为命名空间http://cmcc.trans下1.2FaultReason1String--Reason节点（命名空间为http://www.w3.org/2003/05/soap-envelope）1.2.1ReasonText1+String-S模块异常信息发生异常的时候填写，字符串，支持多语言，默认为xml:lang="zh-CN"，因此至少应填写xml:lang="zh-CN"下的异常信息。5.6.5.正常请求报文样例同步模式交易和异步模式交易的请求报文样例：02001BOSS00BOSS25012120302023881950P26011212yyt2150848S3963562012030215181412345.6.6.正常应答报文样例1.同步模式交易应答报文样例：中国移动通信公司35网状网规范总册02001BOSS00BOSS28012120302023881950P26011212yyt2150848S39635620120302151814TransIDH@trans.cmcc.Math2013070116004110002100201307011605328500000011d8ac8b6-3370-4f44-9aea-aba777821d3020120703201307011605321000280002352801462.异步模式交易应答报文样例：02001BOSS00BOSS28012120302023881950P26011212yyt2150848S39635620120302151814TransIDH@trans.cmcc.Math2013070116004110002100201307011605328500000011d8ac8b6-3370-4f44-9aea-aba777821d30中国移动通信公司36网状网规范总册201207032013070116053210002800023528015.6.7.系统错误报文样例系统错误时，错误报文样例（以密钥更新为例）：02001BOSS00MGMT99912120302023881950xnsi293jk0x20120302151814NeDF114FSmPifBZNAWwMpS7mJ5201308221849459980808020130822184942570000003102a2a52-35b5-48b0-b6f3-5813736b244820120703201308221849423110999031119991soapenv:Receiverb:10300Executionerrorsforupdatekeyservice.中国移动通信公司37网状网规范总册5.6.8.业务错误报文样例业务失败时，错误报文样例（以查询用户信息失败，用户id不存在为例，此时响应报文包含不包含响应节点queryUserInfoResponse）：02001BOSS00MMKF311112120302023881382xnsi293jx6v20120302152114NeDF114FSmPifBZNAWwMpS2335201308221812459980808020130822184941370000003102a2a52-35b5-48b0-b6f3-5813736b244820120703201308221849423110999031119991soapenv:Receiverb:20036InvaliduserId,cannotgetanyuserinfo.中国移动通信公司38网状网规范总册业务失败时，错误报文样例（以查询用户信息失败，用户已注销为例，此时响应报文包含响应节点queryUserInfoResponse）：02001BOSS00MMKF311112120302023881382xnsi293jx6v20120302152114NeDF114FSmPifBZNAWwMpS2335201308221812459980808020130822184941370000003102a2a52-35b5-48b0-b6f3-5813736b24482012070320130822184942311099903111999113612345678inactivesoapenv:Receiverb:20032InactiveuserId,cannotgetuserdetailinfo.中国移动通信公司39网状网规范总册5.7.交易管控一个成熟完善的传输系统，拥有流量检测与拥塞控制机制，将有助于提高系统整体的伸缩性和稳定性。就网状网整体考虑：1.SN需要自我保护，避免被接入机构的高并发交易量所瘫痪；2.上游SN需要考虑下游SN的承受能力，如果下游SN处于过载的状态，发起方SN应及时避免向其持续发送高并发交易，避免将下游SN压死；3.如果下游节点或机构不工作，上游SN需要及时发现并隔离，以免故障向上蔓延影响到上游节点的正常运行。5.7.1.对机构的检测与控制S模块每30秒通过Echo服务的echo方法来侦测所有的接入机构的状态是否可用，并由BMC模块收集被检测机构的状态告，并通知所有SN，相应的做出短信告警等提醒。如果连通测试异常，所有知晓该机构异常的SN都会拒收与该机构有关的交易，在SN资源允许的情况下，异步交易照常接受。Echo服务echo方法的定义：请按照中心下发的Echo.wsdl来实现，需要注意的是：由于echo交易是由SN定时发送的，所以echo的发起报文不包含报文头，只有简单的报文体。相应的，各落地机构处理和应答echo报文时，不需要处理任何报文头，不需要对报文头进行加解密判定和处理；之后做出的应答报文也只需要是一个简单的不含报文头的SOAP1.2报文即可，无需添加报文头内任何节点，亦无需加解密处理。Echo服务报文举例：请求报文：应答报文：OK中国移动通信公司40网状网规范总册Echo服务地址的定义：由于SOAP服务的特殊性，出于对服务的可管理性（确保不同服务部署不同的地址都可以被检测到）和一致性考虑，网状网S模块对于机构检测地址（Echo服务地址）的要求如下：对于所有已经在中心注册的soap服务，都需要在相应的服务地址（除去本身服务名称/wsdl名称）下，实现并部署一个Echo服务。举例如下：Echo服务地址的定义举例：某省在中心注册了5个SOAP服务http://10.109.1.42:8600/common/services/SVC_CSVC0000_AbilityOpenhttp://10.109.1.42:8600/common/services/SVC_UACP9980_RealTimeInterfacehttp://10.109.1.42:8600/common/services/SVC_CSVC4567_NewServicehttp://10.109.1.42:8999/common/services/SVC_CSVC8326_AnotherServicehttp://10.109.1.42:8600/special/services/SVC_CSVC8293_AnotherNewService那么这5个服务的前缀分别是：http://10.109.1.42:8600/common/services/http://10.109.1.42:8600/common/services/http://10.109.1.42:8600/common/services/http://10.109.1.42:8999/common/services/http://10.109.1.42:8600/special/services/前三个只需要实现一个Echo，后面两个由于端口跟地址不同，另外需要实现Echo，故该省需要部署3个Echo服务：http://10.109.1.42:8600/common/services/Echohttp://10.109.1.42:8999/common/services/Echohttp://10.109.1.42:8600/special/services/Echo补充说明：由上述说明，建议（非强制性）各省在实现SoapService时，尽量考虑将所有Service部署到同一个地址下。例如如果上省部署地址前缀统一为：http://10.109.1.42:8600/common/services/则该省只需要部署一个检测地址：http://10.109.1.42:8600/common/services/Echo5.7.2.机构间的传输控制由于接入网状网的机构是异构系统，处理能力各不相同，为了调和这些差异，网状网对机构的通知交易传输进行了控制：中国移动通信公司41网状网规范总册图表5-6机构间传输控制机制1.每个机构初次接入的时候，会依照经验和业务繁忙预测事先在SN上定义它的传输队列大小和转发速度。多个机构可以共用一个队列。2.如果发送速度超出了设定的转发速度，则队列会很快被占满，那么新的交易会被直接返回错误。5.7.3.拥塞控制SN具有流量检测和拥塞控制的能力，当判断自身过载时能自我保护，当判断下游节点拥塞或故障时，能及时减少或停止向下游节点发送交易，减轻下游节点负荷。网状网系统的拥塞控制仅作用于系统内的交换节点之间，暂时无法控制系统外的接入机构的行为。对于拥塞控制，有三个关键阀值：拥塞、舍弃、恢复。恢复阀值<拥塞阀值<舍弃阀值。当检测到流量超过拥塞阀值的时候，SN将自身的状态设置为拥塞，仍继续处理交易。上游交换结点，将减少向其发送的交易量，避免其过载而瘫痪。当检测到流量超过舍弃阀值，SN采取自我保护措施，拒绝处理新收到的交易报文，避免由于处理能力下降造成瘫痪。上游结点知道下游节点处于舍弃的状态，将不再向其发送交易。当检测到流量低于恢复阀值，SN将自身的状态恢复为正常，并正常处理交易请求。上游结点知道其恢复正常状态后，向其正常发送交易并恢复原有交易量。因此，对于实时性要求较高的大圈类请求交易，需经过拥塞控制模块的管理再转发。业务大圈类应答交易报文不通过拥塞控制模块的管理，直接透传。通知类交易的报文由于只要求绝对送达即可，对时效要求相对低，因此通知类交易报文不经过拥塞控制模块的管理。拥塞控制功能通过一系列的方法来尽可能避免控制拥塞的发生，也可以在拥塞严重积压消息达到阈值或者落地方不可用的情况下，拒绝发起方机构向落地方机构发起请求。拥塞控制功能通过以下方式实现：发起方SN和落地方SN均在缓存中保留一份所有接入交易枢纽机构的拥塞控制信息，大圈类请求报文到达时，将通过拥塞控制模块查询该落地机构的拥塞控制信息；如果拥塞控制信息显示该落地机构无拥塞（判断条件为发送到落地方SN后收到的HTTPResponseStatus为200），则按正常流程对落地方SN转发报文。如果拥塞控制信息显示该落地机构已经拥塞（判断条件为发送到落地方SN后收到的HTTPResponseStatus为900），则按系统配置的拥塞控制策略向落地方SN转发报文。如果拥塞控制信息中国移动通信公司42网状网规范总册显示该落地机构已经不可用（判断条件为发送到落地方SN后收到的HTTPResponseStatus为非200及900），则停止向落地方SN转发报文，并拒绝新进入的发送到该落地机构的交易请求。5.8.安全5.8.1.报文加密S模块的加密采用WebServicesSecurity:SOAPMessageSecurity1.1(WS-Security2004)标准(wss1.1)进行加密；加密机方式沿用T模块的加密构架和流程。S模块加密是针对报文体内需要加密的节点进行加密，实现方式参见wss标准。加密的对象按照具体业务需求分为两种：一种是报文体整体加密，即加密SOAPBody中的响应主体节点（例如addUser节点）。注意：此种整体加密的情况下,按照网状网的要求,请务必保证加密节点的Id属性(不包含#的部分)与加密前节点名称保持一致。另外一种是只加密需要加密的字段（例如对于addUser的请求报文，只加密其中的userPassword和userBalance节点）。注意：此种部分加密的情况下,加密节点Id属性与加密前节点名称不需要保持一致。加密方式:加密的报文在原始报文的报文头中添加wsse的Security节点,由Security节点内的ReferenceList中的DataReference节点的URI来定义SOAP报文体中已进行加密部分(EncryptedData)的Id.具体方式参见下面两个例子:5.8.2.全体报文加密样例原始报文:02001BOSS00BOSS25012120302023881950P26011212yyt2150848S39635620120302151814中国移动通信公司43网状网规范总册1234其中红色为需要加密的部分,加密后的报文为:02001BOSS00BOSS25012120302023881950P26011212yyt2150848S39635620120302151814...加密后的密文...注:整体报文加密后,加密节点Id属性与加密前节点名称保持一致,本例中都为sum5.8.3.部分节点加密样例原始报文:02001BOSS00BOSS中国移动通信公司44网状网规范总册25012120302023881950P26011212yyt2150848S396356201203021518141234其中红色为需要加密的部分,需要加密的是a节点整个节点和b节点的值34,加密后的报文为:02001BOSS00BOSS25012120302023881950P26011212yyt2150848S39635620120302151814...原文12加密后的密文......原文34加密后的密文...中国移动通信公司45网状网规范总册注:报文部分节点加密后,加密节点Id属性无需与加密前节点名称保持一致,本例中a节点和b节点分别对应加密后的节点的Id是node1和node2特别说明：在上面部分节点加密的样例中，a节点（节点12）和b节点（值34）分别对应整个节点加密和节点值加密；默认情况下，网状网中的业务只使用节点值加密的方式加密部分节点，即对于形如34的节点，只加密其中的值（34）部分。特殊情况下，如果业务需要对包含节点标签和结构的整个节点进行加密，需在业务分册中着重的做出详细的特别说明，并提前知会中心和相关省BOSS/平台。5.9.服务管理5.9.1.服务开通机构与服务的开通需要经过以下两个步骤：5.9.1.1.机构（服务提供方SP）申请开通当SP具备接入网状网系统条件(已实现包括心跳、签到/签退等必要的管理类交易)时，机构向网状网管理部门提出书面申请，由网状网系统管理员进行添加机构操作，此后机构便可以签到，具备提供服务的能力。5.9.1.2.服务的注册，发布1)服务提供方准备好服务描述WSDL文件，通过服务调用SN的服务发布接口向MC发送服务注册申请。MC收到请求之后，回复收到确认消息。2)MC收到服务注册之后，进入审批流程，进行服务的审核确认。3)服务通过审核之后，向所有的SN发布服务。每个接入机构可以查询服务。5.9.2.服务的调用1)服务调用方首先通过SN的标准服务查询接口查询具体的服务描述。开发自己标准的SOAP服务调用程序。2)然后向自己接入的SN发起SOAP服务调用申请。3)枢纽负责relaysoap的服务调用，并最终转发到服务提供方。4)最后网状网负责把服务调用的结果返回给服务的发起方。中国移动通信公司46网状网规范总册5.9.3.密钥更新请求5.9.3.1.说明1)密钥更新请求，由中心提供服务，由各省根据中心提供的中心提供的SVC_MGMT9990_KEYMANAGE.wsdl来实现客户端访问。2)请求的落地地址信息如下，路由信息为：MGMT999报文发送地址形如：http://10.1.251.25:1130/TransSoap/Services/SCV_MGMT9990_KEYMANAGE其中蓝色部分以具体的OSN服务地址为准。3)请求报文应答规范说明：密钥更新成功时，在应答报文体节点中返回256位密钥字符串，同时应答报文头中的Response节点为000000标识业务成功；密钥更新失败时，在应答报文体节点中为空或者几位字符串的失败代码供查找失败原因，同时应答报文头中的Response节点为22998及描述信息标识业务失败；若系统故障，则按照S模块规范返回SoapFault报文。5.9.3.2.请求报文样例02001BOSS00MGMT99912120302023881950xnsi293jk0x201203021518145.9.3.3.应答报文样例更新密钥成功应答报文样例：中国移动通信有限公司47网状网规范总册02001BOSS00MGMT99912120302023881950xnsi293jk0x20120302151814NeDF114FSmPifBZNAWwMpS7mJ5201308221849459980808020130822184942570000003102a2a52-35b5-48b0-b6f3-5813736b244820120703201308221849423110999031119991c85224bf62f5d3b86c6b46b2600ee40a240d3ba2f6aad4c90baa55da97ec3c476185ff6e7b776dd9cce75d9de44569332d6638635ef423b7d0d6b3d3fcdc5c47f0db9c8618a10f254b254f465c2d327ab2179c929e0d01d19fee9aa984a1f2d0c564ccdd07ad987c4fb8fd74fb14aeb5b33ccf77c8bf63835dcf0ab14df48e425.9.3.4.更新密钥失败应答报文样例02001BOSS00MGMT99912120302023881950xnsi293jk0x20120302151814中国移动通信有限公司48网状网规范总册NeDF114FSmPifBZNAWwMpS7mJ5201308221849459980808020130822184942570000003102a2a52-35b5-48b0-b6f3-5813736b244820120703201308221849423110999031119991soapenv:Receiverb:10300Executionerrorsforupdatekeyservice.中国移动通信有限公司49网状网规范总册5.9.4.服务查询所有的机构都通过SN的标准服务查询接口进行SOAP服务定义的查询，然后进行服务的接口开发。6.统一管理6.1.S模块系统管理6.1.1.管理交易服务待定6.1.2.BMCBMC在对帐时需要以业务管理中心的身份与发起方机构和落地方机构进行分别对帐，BMC的属性编码为：DUNS（编码）：9980以省代码路由时的路由值：998DOMAIN：MGMTPARTY_ID：99816.1.3.MCMC在管理类交易时需要以管理中心的身份参与交易，MC的属性编码为：DUNS（编码）：9990以省代码路由时的路由值：999DOMAIN：MGMTPARTY_ID：99916.1.4.交换节点交换节点负责对机构的接入工作，各个机构在接入时应明确自己需要接入的交换节点用于发送的报文中标明，使交换系统正常处理，其中枢纽交换节点具有特殊的交换节点编码，编码列表如下：编码（DUNS）交换节点位置接入的DOMAIN9980枢纽交换节点一级系统、业务平台4710内蒙古BOSS、业务平台1000北京BOSS、业务平台2200天津BOSS、业务平台5310山东BOSS、业务平台3110河北BOSS、业务平台中国移动通信有限公司50网状网规范总册3510山西BOSS、业务平台5510安徽BOSS、业务平台2100上海BOSS、业务平台2500江苏BOSS、业务平台5710浙江BOSS、业务平台5910福建BOSS、业务平台8980海南BOSS、业务平台2000广东BOSS、业务平台7710广西BOSS、业务平台9710青海BOSS、业务平台2700湖北BOSS、业务平台7310湖南BOSS、业务平台7910江西BOSS、业务平台3710河南BOSS、业务平台8910西藏BOSS、业务平台2800四川BOSS、业务平台2300重庆BOSS、业务平台2900陕西BOSS、业务平台8510贵州BOSS、业务平台8710云南BOSS、业务平台9310甘肃BOSS、业务平台9510宁夏BOSS、业务平台9910新疆BOSS、业务平台4310吉林BOSS、业务平台2400辽宁BOSS、业务平台4510黑龙江BOSS、业务平台6.1.5.DOMAIN编码当前接入的应用域类型以及编码如下：DOMAINID描述接入交换节点BOSSBOSS系统各个省以及枢纽交换节点其它机构域名，如RADIRadius平台各个省以及枢纽交换节点BOSS以外应用域的定义在各业务单行本中。6.1.6.机构系统编码各个机构系统实现具有较强的差异性，为了使加入网状网后对各个机构系统造成较小的影响，一个机构可以有多个系统接入枢纽提供的交换节点，如有的BOSS机构的客服以及帐务系统非别为不同的主机系统，此时需要作为落地方的交换节点能够根据交易编码定位到系统主机系统确定其URL以完成交易，需要给接入机构的各个系统进行编码，编码由各个机构提出申请，由枢纽审核后下发，当前枢纽认为每个机构只有一个主机系统和交换节点相连实现机构被要求的所有业务；在流水文件和其他业务文件的名称中使用此代码来指定某个机构，此时如果一个机构由多个系统构成，则选第一个，当前为一个机构只有系统编码，编码如下：中国移动通信有限公司51网状网规范总册系统编码机构DOMAIN机构交换节点描述中国移动通信有限公司52网状网规范总册0001RADI0000Radius业务平台0002DSMP0000DSMP业务平台0003CMSS0000全成平台CMSS0004GIVR0000高阳平台GIVR0005PIMM0000PIM业务平台0006MCAS0000内容计费系统4711BOSS4710内蒙古BOSS系统1001BOSS1000北京BOSS系统2201BOSS2200天津BOSS系统5311BOSS5310山东BOSS系统3111BOSS3110河北BOSS系统3511BOSS3510山西BOSS系统5511BOSS5510安徽BOSS系统2101BOSS2100上海BOSS系统2501BOSS2500江苏BOSS系统5711BOSS5710浙江BOSS系统5911BOSS5910福建BOSS系统8981BOSS8980海南BOSS系统2001BOSS2000广东BOSS系统7711BOSS7710广西BOSS系统9711BOSS9710青海BOSS系统2701BOSS2700湖北BOSS系统7311BOSS7310湖南BOSS系统7911BOSS7910江西BOSS系统3711BOSS3710河南BOSS系统8911BOSS8910西藏BOSS系统2801BOSS2800四川BOSS系统2301BOSS2300重庆BOSS系统2901BOSS2900陕西BOSS系统8511BOSS8510贵州BOSS系统8711BOSS8710云南BOSS系统9311BOSS9310甘肃BOSS系统9511BOSS9510宁夏BOSS系统9911BOSS9910新疆BOSS系统4311BOSS4310吉林BOSS系统2401BOSS2400辽宁BOSS系统4511BOSS4510黑龙江BOSS系统6.1.7.路由类型编码路由类型体现在联机交易发起方的MessageHeader中，用于发起方SN找到确定落地方SN的方法，之后根据路由数据确定落地方SN，具体某种交易类型可以使用哪种类型数据进行路由在交易属性中描述，类型编码如下：编码名称备注00按省（位置）代码路由需要到达枢纽交换节点使用00001按手机号码路由根据局数据中国移动通信有限公司53网状网规范总册6.1.8.省代码用于路由关键值的省代码取交换节点代码的前三位，如内蒙古为“471”，北京为“100”。6.1.9.SOAP错误编码系统错误（包含管理类交易）错误代码：错误代码描述适用交易应答描述内容上游节点错误处理原则10101OSN发现超时，根据交易属性已发冲正。系统大圈类需要冲正的交易。无10102OSN发现超时，根据交易属性不发冲正。系统大圈类不需要冲正的交易。无10103OSN发现具有重复发起方交易流水号的交易。所有交易无10104OSN无法根据请求报文找到落地方交换节点。所有交易。无10105OSN发现MessageHeader格式错误所有交易无10106OSN发现MessageBody格式错误。所有交易无10110OSN超时，冲正失败所有交易无根据交易属性自行判断是否发冲正10111OSN内部错误所有交易无10113HSN内部错误系统大圈交易无10118OPARTY未签到此交易无10119HPARTY未签到此交易无10126请求报文的BIPcode和ACTIVITYCODE不一致无10127BMC缺少对应的对帐记录对帐结果上发无10128对帐结果报文中的数量字段与报文中实际的记录数不同对帐结果上发无10129OSN拒绝发起方与落地方相同的业务无10130发起方节点拒绝请求无10131发起方节点已拥塞无10132落地方机构拥塞无10133落地方机构故障无10134落地方机构超时无10300MC密钥产生失败密钥更新无10301OSN密码重加密失败密钥更新无10310签到失败签到签退无10311签退失败签到签退无业务失败,错误代码（2xxxx）请参加业务规范分册的错误代码说明；通知和冲正交易只能返回成功应答。中国移动通信有限公司54网状网规范总册7.名词与术语术语和缩略语描述BOSS业务支撑运营系统NGBOSS下一代业务支撑运营系统TSN网状网MC管理控制中心BMC业务管理中心T-Module交易传输模块F-Module文件传输模块D-ModuleDCC交易传输模块S-ModuleSOAP服务传输模块DOMAIN应用域。一级BOSS对接入机构的应用系统按其特性进行类别划分，分别称其为BOSS、RADIUS、MIS/OA、WEB等应用域，每个应用域均有其唯一标识。应用域接入系统也就是指该应用域的应用软件系统。交换节点(SN)连接机构和网状网的子系统，对机构发出的或发往机构的消息做预处理，简称为SN(SwitchNode)。机构Party连接到网状网的各应用系统(也称为应用域接入系统)，可以是各省BOSS、各种业务平台、全国性合作伙伴的应用系统等。发起端机构Oparty发出某交易请求的机构；不只是省级BOSS系统，也包括参与交易的业务平台域。落地端机构HParty执行交易请求的机构，它执行某交易的请求并给出应答；不只是省级BOSS系统，也包括参与交易的业务平台域。业务平台为中国移动提供一点接入的业务管理系统，如中央音乐平台、手机邮箱，VGOP、DSMP等。SPServiceProvider，服务供应商。交易一次由发起方机构发起，由网状网转接，并由落地方机构接受并处理的业务操作。联机交易交易的请求与应答采用联机消息的方式在网状网与机构之间传递，实时性强。系统大圈类交易此类交易由发起方发起，网状网收到后转发给落地方，由落地方机构给出业务应答，网状网收到该应答后再转发给发起方。业务类大圈交易此类交易由发起方发起，网状网收到后转发给落地方，由落地方机构首先给出确认应答，然后落地方机构在业务处理完毕之后，重新发起业务应答交易，网状网收到该应答后再转发给发起方。通知类交易此类交易由发起方发起，网状网收到后直接给出应答，若交易成功，由网状网负责向落地方发送，落地方收到后只能返回成功应答，不能拒绝。可疑交易对于通知类的交易，以网状网产生的应答为准，若落地方给出失败的应答，或没有给出应答，则日切时将此通知类交易视为可疑交易。若一笔冲正为可疑交易，则其原交易也视为可疑交易。冲正由交易发起方或OSN发送给落地端机构，旨在要求落地端机构对某原交易执行逆操作的联机交易；冲正是一种特殊的通知类交易；落地端机构处理冲正请求后，可以应答成功或失败。冲正是指由应用软件系统自动发起的交易。中国移动通信有限公司55网状网规范总册人工冲正人工冲正相对于由应用软件系统自动发起的冲正，它由发起方机构的操作员发起，处理过程与自动冲正相同。人工冲正的发起需要特殊授权(如只有营业厅经理才可发起人工冲正)。BIPBOSSInterfaceProcess，描述机构之间通过网状网完成一次业务处理所经过的过程。一个BIP会包含一个或多个连续的交易。为完成此交易过程，接入系统和一级BOSS之间的消息（报文）叫做InterBoss，一个交易过程可能需要在机构之间往复传递多个BIPdocument。一个BIP中只包含一个非查询类的关键交易。SAF存储转发交易表，用于存放需要存储转发的交易记录。中心逻辑交易日期网状网对每一笔其经手的交易都赋予一个逻辑交易日期，用于在清算及对帐时圈定要处理的交易的范围。日期切换（日切）MC在每天的规定时刻进行逻辑交易日期的更新，使逻辑交易日期切换到下一天。清分将特定时间范围（一般是一个逻辑交易日）之内的每一笔交易所涉及的本金、手续费进行计算并在交易参与各方之间进行摊分的处理过程。清分处理由BMC在日切时执行；结算结算周期期末，BMC将在该结算周期内，各个机构的应收、应付金额进行冲销，并按冲消后金额打印帐单的过程叫作结算；对帐网状网和与其发生交易关系的每个机构，对特定时间范围内（一个逻辑交易日）发生的，每一种需要对帐的交易类型进行笔数和金额（本金总额）的核对的过程称为对帐。对帐操作是网状网和机构之间发生的，各个机构之间不直接进行对帐。签到/签退接入机构在初次接入的时候发出签到请求进行注册，表明开始正式接入一级BOSS网状网。接入机构有计划的切断与一级BOSS网状网的连接时，应发出签退请求，表明暂不能受理各类业务。待再次接入时，重新进行签到注册。手续费指向客户收取的办理某项业务的人工费用。当收取手续费时，一般是在客户归属地帐户上作为一次性营业费用记帐PIN码特指客服密码、帐户密码等密码类数据。关键交易一个业务往往会涉及到多个交易，关键交易是指这些交易中的唯一一个涉及客户资料或用户状态改变的交易。关键交易的行为代表了该业务的行为，关键交易的处理结果代表了该业务的处理结果。辅助交易一个业务往往会涉及到多个交易，除关键交易之外的其它交易均称为辅助交易。辅助交易不会涉及客户资料或用户状态改变，不会有冲正、人工冲正、对帐等行为。超时时间发起方机构在发出交易请求后，最长等待网状网应答的时间间隔。重试间隔时间通知和冲正交易的两次重新发送之间的时间间隔。上游节点对一个交易的某个参与方，交易消息的直接发送方称为上游节点。下游节点对一个交易的某个参与方，交易消息的直接接收方称为下游节点。交易动作指该交易是请求还是应答。中国移动通信有限公司56网状网规范总册路由、路由类型、路由关键字网状网判断交易的落地方是谁的过程。路由类型是指以什么标准来判断落地方。路由关键值是指用来判断落地方的数据。业务流水号是指对一项业务处理过程的统一序号。一个业务中的多个交易具有相同的业务流水号。交易流水号是指一个交易的序号。一个业务中如果有多个交易，则各个交易的流水号不同。处理时间对发起方是指交易请求的发起时间，对落地方是指处理该请求的时间。测试标记由交易的发起方填写的、用于标识该笔交易是测试还是非测试状态。测试标记是业务级的，也应是说，如果一个业务是测试状态，则其所包含的所有交易均应是测试状态。标识类型是指客户的唯一标识类型，客户标识用于落地方定位该客户。目前通过手机号码或VIP卡号来标识客户。应缴总金额是指客户在缴费时计算出的客户欠费总金额，包括业务使用费用、营业费用、频率占用费、滞纳金等费用的总和。预存总余额是指客户尚未被扣帐的预存款总余额。VIP客户即大客户。业务注册即用户申请开户，且在业务平台或BOSS系统进行登记的过程。业务变更即对用户已注册的业务进行改变的过程。主体服务状态即用户手机的状态，如开机、停机、预销户、销户等。中国移动通信有限公司57网状网规范总册8.接口常用词词典本词典是按BOSS规范的三户模型次序编列语词。8.1.目标本词典是用来明确传输服务网接口报文中所有业务词汇的英文全称或简写，及其类型、长度、约束、取值范围等的业务词汇总编。词典分为两部分，第一部分为使用表格方式描述的word文档，是词汇全集。总册发布后本部分独立成册，保持易读性，便于讨论修订，为相关接口规范编写者提供依据和标准；第二部分是按业务定义的标准XSD文件，由管理中心统一在业务上线时向相关机构下发，作为各机构传输服务网T、S模块接口的Schema。统一的业务词典利于提高沟通效率、消除不规范命名的歧义、便于统一管理。8.2.编写原则1.从原有业务接口单行本的已有词汇中提炼汇总，尽量保持继承性；2.统一词组命名规则和风格；3.命名时遵循中移动企业标准、习惯用法；8.3.命名规则英文命名规则：首字母大写，联合词组中各单词的首字母大写1.有现成单词，且单词长度小于8，则使用完整的单词，如级别－Level；2.有现成单词，但单词长度大于8，尽量使用标准缩写，如果缩写易引起歧义或没有缩写，可以用完整单词或自创缩写，自创缩写因发音相近或有其它关联，如业务－Business的缩写为bus易引起歧义，可以使用Biz；3.合成词汇同样遵守上面的约定，尽量不使用分隔符，如证件类型－IDCardType。中国移动通信有限公司58网状网规范总册8.4.业务名词主要关系客户是指一个使用或可能使用中国移动（或第三方合作伙伴）提供的产品和服务的个人、家庭、集团或者其他团体。用户是主体产品实例，是进行服务和计费的载体，包括资源占用、订购信息、用户价值等。帐户是指客户使用移动服务的付费实体。8.5.XML业务名词8.5.1.客户信息序号统一名词英文缩写类型位长中文描述备注1客户姓名UserNameStringV32客户姓名2证件类型IDCardTypeStringF2参见客户证件类型编码00身份证件01VIP卡02护照04军官证05武装警察身份证99其他证件3证件号码IDCardNumStringV32证件号码4收件人姓名RecipientsStringV48收件人姓名5联系电话UserNumStringV32联系电话6联系地址UserAddStringV128联系地址7客户状态StatusStringF200：正常；01：单向停机；02：停机；03：预销户；8客户级别LevelStringF10－普通用户（动感地带用户为普通用户）1－银卡2－金卡3－钻石卡9客户级别有效截至日期LevelDateStringF8YYYYMMDD客户级别是VIP（钻石卡，金卡，银卡）时填写10客服密码CCPasswdStringV64对于客户申请的查询，无此项时必须有客户证件中国移动通信有限公司59网状网规范总册11寄送地址AddressStringV128寄送地址12寄送地邮政编码PostCodeStringF6寄送地邮政编码8.5.2.用户信息序号统一名词英文缩写类型位长中文描述备注1手机号码MSISDNStringV3211位手机号码2用户品牌BrandStringF201：全球通（含VIP等级）02：神州行03：动感地带09：其他品牌3入网时间OprTimeStringF14入网时间YYYYMMDD24HHMISS：YYYY年，MM月，DD日，HH时，MI分，SS秒4归属地HomeProvStringV64归属省+地市名称5该号码的归属省省代码HomeProvStringF43位省代码+0，如北京填写10006备卡SIM卡号NewSIMnumStringV32备卡SIM卡号7SMSP的摘要SMSP_MACStringV128SMSP的摘要8SMSPSMSPStringV32需生成数字摘要9IMSI的摘要IMSI_MACStringV128IMSI的摘要10IMSIIMSIStringV32需生成数字摘要11ICCID的摘要ICCID_MACStringV128ICCID的摘要12ICCIDICCIDStringV256需加密13经理姓名UserMgrStringV32VIP客户（含集团客户）填写14经理电话UserMgrNumStringV32VIP客户（含集团客户）填写8.5.3.账户信息序号统一名词英文缩写类型位长中文描述备注1帐号AcntNumStringV32帐号2帐户名称AcntNameStringV64帐户名称3帐户预存余额(厘)AcntBalanceNumV12.0帐户预存余额4帐户应缴金额(厘)AcntPayAmountNumV12.0帐户应缴金额(厘)5预存总余额(厘)BalanceNumV12.0若有分帐户数据，则此总金额是各帐户之和6应缴总金额(厘)PayAmountNumV12.0若有分帐户数据，则此总金额是各帐户之和7客户余额(厘)BalanceNumV12.0客户余额(厘)8欠费金额(厘)DebtBalanceNumV12.0欠费金额(厘)9信誉额度CreditStringV32信誉额度10总消费积分（M值）AllConScoreStringV811年消费积分(M值)YearConScoreStringV8年消费积分(M值)12已兑换积分(M值)UseScoreStringV8已兑换积分(M值)中国移动通信有限公司60网状网规范总册13可兑换积分(或M值)PointBalanceNumV12.0可兑换积分(或M值)14奖励积分（M值）AwardScoreStringV8奖励积分（M值）8.5.4.集团客户信息序号统一名词英文缩写类型位长中文描述备注1EC集团客户编码ECIDStringV30EC集团客户编码2集团客户名称ECNameStringV256集团客户名称3集团客户所属行业ECIndustryStringF2集团客户所属行业4集团客户地址ECAddressStringV256集团客户地址5邮政编码PostcodeStringF6邮政编码6集团客户联系电话ECTelStringV64集团客户联系电话7EC企业代码SPIDStringV12EC企业代码8.5.5.集团客户订购信息序号统一名词英文缩写类型位长中文描述备注1产品订单号ProductOrderNumberStringV19产品订单2产品规格编号ProductSpecNumberStringV7产品规格编号3业务开展模式BizModeStringF1业务开展模式1-有限公司一点受理，一点支付。2-有限公司一点受理，分省支付。3-主办省一点受理，一点支付4-主办省一点受理，分省支付5-本省处理，本省支付4业务接入号BizServCodeStringV128业务接入号例如：EC基本接入号是10657500，如是短信业务则业务接入号可以是10657500或106575001234，或是106575001234001如是彩信则业务接入号与EC基本接入号必须相同是106575005业务代码BizCodeStringV10业务代码6业务名称BizNameStringV256业务名称7业务状态BizStatusStringF1业务状态A-正常商用S-内部测试T-测试待审R-试商用8生效时间EffDateStringF8生效时间8.5.6.成员信息序号统一名词英文缩写类型位长中文描述备注中国移动通信有限公司61网状网规范总册1成员号码MSISDNStringV13成员号码2成员类型MemberTypeIDStringF1成员类型1-签约成员2-白名单0-黑名单8.5.7.SI信息序号统一名词英文缩写类型位长中文描述备注1SI编码SICodeStringV20SI编码2SI企业名称SINameStringV128SI企业名称中国移动通信有限公司62',)