《中国移动一级局数据系统与省级局数据系统接口分册.doc》由会员分享，可在线阅读，更多相关《中国移动一级局数据系统与省级局数据系统接口分册.doc（102页珍藏版）》请在三一办公上搜索。
1、中国移动通信有限公司一级局数据系统与省级局数据系统接口分册 (V0.1)中国移动通信有限公司二一年四月文档变更记录序号变更内容说明版本号版本日期执笔人1讨论稿0.12010/4/6目 录文档变更记录21. 综述71.1. 文档概述71.2. 参考文档72. 术语、定义和缩略语73. 接口定义说明93.1. 接口实现方式93.1.1. 实时消息实现方式93.1.2. 非实时消息实现方式13 实时接口详述134.134.1. SP(AP)信息同步134.1.1. 业务功能134.1.2. 业务流程144.1.3. 业务约束164.1.4. 交易单元164.1.4.1. 交易属性164.1.4.2.
2、 交易报文174.1.4.3. 返回码214.2. 业务信息同步224.2.1. 业务功能224.2.2. 业务流程224.2.3. 业务约束244.2.4. 交易单元244.2.4.1. 交易属性244.2.4.2. 交易报文244.2.4.3. 返回码294.3. 音乐类SP信息同步294.3.1. 业务功能294.3.2. 业务流程304.3.3. 业务约束324.3.4. 交易单元324.3.4.1. 交易属性324.3.4.2. 交易报文324.3.4.3. 返回码344.4. 音乐类业务数据同步344.4.1. 业务功能344.4.2. 业务流程344.4.3. 业务约束364.4
3、.4. 交易单元364.4.4.1. 交易属性364.4.4.2. 交易报文364.4.4.3. 返回码384.5. 业务个性化提示语同步394.5.1. 业务功能394.5.2. 业务流程394.5.3. 业务约束414.5.4. 交易单元414.5.4.1. 交易属性414.5.4.2. 交易报文414.5.4.3. 返回码424.6. 提示语模板同步434.6.1. 业务功能434.6.2. 业务流程434.6.3. 业务约束454.6.4. 交易单元454.6.4.1. 交易属性454.6.4.2. 交易报文454.6.4.3. 返回码474.7. 处罚数据同步474.7.1. 业务功
4、能474.7.2. 业务流程484.7.3. 业务约束504.7.4. 交易单元504.7.4.1. 交易属性504.7.4.2. 交易报文504.7.4.3. 返回码534.8. 状态信息同步534.8.1. 业务功能534.8.2. 业务流程544.8.3. 业务约束564.8.4. 交易单元564.8.4.1. 交易属性564.8.4.2. 交易报文574.8.4.3. 返回码594.9. 局数据状态信息查询594.9.1. 业务功能594.9.2. 业务流程594.9.3. 业务约束614.9.4. 交易单元614.9.4.1. 交易属性614.9.4.2. 交易报文614.9.4.3
5、. 返回码634.10. 公告信息同步644.10.1. 业务功能644.10.2. 业务流程644.10.3. 业务约束664.10.4. 交易单元664.10.4.1. 交易属性664.10.4.2. 交易报文674.10.4.3. 返回码694.11. 公告反馈信息同步694.11.1. 业务功能694.11.2. 业务流程704.11.3. 业务约束724.11.4. 交易单元724.11.4.1. 交易属性724.11.4.2. 交易报文724.11.4.3. 返回码744.12. 国际GSM漫游出访数据744.12.1. 业务功能744.12.2. 业务约束744.12.3. 业务
6、流程754.12.4. 交易单元764.12.4.1. 交易属性764.12.4.2. 交易报文764.12.4.3. 返回码784.13. 国际GSM漫游来访数据784.13.1. 业务功能784.13.2. 业务约束784.13.3. 业务流程794.13.4. 交易单元804.13.4.1. 交易属性804.13.4.2. 交易报文814.13.4.3. 返回码824.14. GPRS可漫游APN局数据824.14.1. 业务功能824.14.2. 业务约束824.14.3. 业务流程834.14.4. 交易单元844.14.4.1. 交易属性844.14.4.2. 交易报文844.14
7、.4.3. 返回码854.15. 特殊号码归属地到特殊通话类型映射874.15.1. 业务功能874.15.2. 业务约束874.15.3. 业务流程884.15.4. 交易单元894.15.4.1. 交易属性894.15.4.2. 交易报文894.15.4.3. 返回码914.16. 内容计费业务代码映射914.16.1. 业务功能914.16.2. 业务约束924.16.3. 业务流程934.16.4. 交易单元944.16.4.1. 交易属性944.16.4.2. 交易报文944.16.4.3. 返回码964.17. 中国移动BOSS、中国联通、中国电信账户号码964.17.1. 业务功
8、能964.17.2. 业务约束964.17.3. 业务流程974.17.4. 交易单元984.17.4.1. 交易属性984.17.4.2. 交易报文984.17.4.3. 返回码1004.18. 中国移动智能网账户号码1004.18.1. 业务功能1004.18.2. 业务约束1004.18.3. 业务流程1014.18.4. 交易单元1024.18.4.1. 交易属性1024.18.4.2. 交易报文1024.18.4.3. 返回码1044.19. 网内端局/关口局型MSC SERVER、软交换设备号码1044.19.1. 业务功能1044.19.2. 业务约束1044.19.3. 业务流
9、程1054.19.4. 交易单元1064.19.4.1. 交易属性1064.19.4.2. 交易报文1064.19.4.3. 返回码1085. 文件接口1095.1. 公告信息附件同步接口1095.1.1. 接口说明1095.1.2. 文件命名规则1095.1.3. 文件的获取1105.1.4. 文件校验1106. 统一编码1116.1. 国家或地区编码1116.2. BOSS省代码1186.3. 局数据系统省编码1201. 综述1.1. 文档概述随着中国移动全业务的迅速发展，业务形态多样化且越来越复杂。这就导致业务局数据类型增多且局数据的制作需要在多个系统、多个部门之间进行流转，已经制约了业
10、务的快速部署。为了支撑业务的快速上线，局数据快速、准确的发布成为其中的一个重要环节。这就迫切需要对各类局数据提供统一的管理与发布，以实现局数据发布流程的电子化、各系统之间局数据的自动同步，实现局数据数据来源的统一归口、闭环的局数据制作、发布、反馈流程，以提高局数据的一致性、提升局数据发布效率且能够跟踪局数据发布历史。本文档主要完成一级局数据系统与省级数据管理系统的接口定义，并且只说明非DSMP局数据同步接口，与DSMP相关的局数据同步接口见DSMP系统相关的局数据管理与发布接口分册。1.2. 参考文档NG2_BOSS3.0局数据管理与发布分册DSMP系统相关的局数据管理与发布接口分册SIMS与
11、局数据管理与发布系统接口分册.doc2. 术语、定义和缩略语下列术语和定义适用于本规范：编号缩略语/术语全 称说 明1.SPService Provider服务供应商2.APApplication Provider应用提供商3.HTTPHyper Text Transfer Protocol超文本传输协议4.XMLeXtensible Markup Language可扩展标记语言5.SOAPSimple Object Access Protocol简单对象访问协议6.WSDLWeb Service Definition LanguageWeb服务定义语言7.DSMPData Service M
12、anagement Platform数据业务管理平台8.EOMSElectric Operation Maintenance System电子运维管理系统9.BOSSBusiness Operation Support System泛指NG1-BOSS中BOSS其他功能域10.CRMCustomer Relationship Management客户关系管理3. 接口定义说明3.1. 接口实现方式3.1.1. 实时消息实现方式接口协议使用HTTP协议，落地方为发起方提供访问的URL，发起方使用HTTP POST方法发送请求报文并得到应答报文，发起方作为落地方的HTTP客户端，落地方作为发起方的
13、HTTP服务器。因此，各个参与方需要同时实现HTTP客户端以及服务器的功能。系统间要满足如下约束：1. 应答方在收到消息后必须同步应答。2. 基于HTTP协议传输，HTTP的版本为1.1以上。3. 在双方约定的超时时间内未收到应答，可视为通信失败，这种情况下调用者须提供技术方案保证消息不会丢失，并最终发送成功。4. 对于POST方式，双方采用XML字符流方式进行消息交互。在应用层都采用GBK方式编码，在传输层采用UTF-8编码方式传递。5. 时间格式统一采用 “yyyyMMddHHmmss”的方式，例如：20080911123050 日期格式统一采用 “YYYYMMdd”的方式，例如：2008
14、0911。字段定义。6. 字符的大小写是敏感的，必须严格遵循接口的字段定义。7. 一级局数据系统与省级局数据系统涉及DSMP系统的数据接口，请参考局数据系统与DSMP接口分册实现。接口内容是以XML格式表达的。在本文档中以表格的形式表示XML格式；以下为表格中对元素约束（出现次数）的表示方法的描述：元素的约束条件使用以下符号表示符号含义?0.1，可选项，表示可有可无,*0.n，可以没有，也可以有多项+1.n，至少有1项，也可以有多项1数字1，代表必须且只能填1项注:节点的含义是指它下面包含一个到多个元素。POST中的消息样例：0011boss0011sims9200901070002395re
15、quest10011.0.0.0DISN1231318393362领导审批业务变更等待审批2701827018其中head部分的格式对所有实时消息格式固定，定义如下：序号父元素名称元素名称约束类型长度描述取值说明1ROOThead1-消息头1.1headdestination1String10消息目标网元4位省局数据系统编码+目标网元ID0011disn必填1.2headsource1String10消息发送来源网元来源网元名称1.3headreplyTo1String10处理后应答给哪个网元应答目标网元名称，空值则默认和Source一样1.4headdeliveryMode1int1是否是业
16、务消息0- NON_PERSISTENT，消息不存储在本地，如心跳消息；1- PERSISTENT，消息需要存储在本地默认为 11.5headmessageId1String25发起方消息号；在发起方唯一标识一个消息的流水号，系统内唯一，全网内也必须唯一定义规则 网元名称+网元 ID+YYYYMMDD+NNNNNNN其中：YYYY为年，MM为月，DD为日NNNNNNN为0000001到9999999的数字串，从小到大，循环使用注：双方都要保存该消息号，在业务处理回复以及稽核中要用到。1.6headcorrelationId1String25消息关联号，用于消息返回时候确认和之前request消
17、息关联消息关联号，用于消息返回时候确认和之前request消息关联1.7headtimeStamp1String14发送时间，业务调用发送框架的时间 yyyyMMddHHmmss 24小时制1.8headexpectSendTime1String14期望发送时间，默认为当前时间yyyyMMddHHmmss 24小时制1.9headtimeToLive1long8消息的存活时间，单位为秒，到期后自动失效(TimeStamp+TimeToLive)不填表示一直保存1.10headbizKey1String100业务的关键字信息，可用于查询可为空1.11headsecurityType1String
18、5Body加密方式AESRSA3DES不填表示不加密，默认不填1.12headsignature1String128消息签名不填表示不需要签名，默认不填1.13headversion1String5消息版本号1.0.0.01.14headmsgType1String8消息类型request- 请求消息response-响应消息1.15headotherHeaderInfo？String200其他头部元素定义，可扩展；格式为name=value方式，以;号分割；若value包含;号，需要以;进行转义；如Key1=value1;key2=value2可为空其他头部元素定义，可扩展；格式为name=
19、value方式，以;号分割；若value包含;号，需要以;进行转义；如Key1=value1;key2=value21.16headbizType1String20和业务相关的消息类型,进行业务处理2010 同步违约处罚局数据2017全网SP(AP)局数据2018全网业务局数据2050个性化提示语2051提示语模板2052音乐类SP信息2053 音乐类业务信息9013状态信息同步(省级系统至一级系统)9014状态信息查询9015公告信息同步9016公告反馈信息3017国际GSM漫游出访数据3018国际GSM漫游来访数据3019 GPRS可漫游APN局数据3020特殊号码归属地到特殊通话类型映射
20、3021内容计费业务代码映射3022中国移动BOSS、中国联通、中国电信账户号码3023中国移动智能网账户号码3024网内端局/关口局型MSC SERVER、软交换设备号码4. 实时接口详述4.1. 局数据发布接口4.1.1. 全网SP(AP)信息同步4.1.1.1. 业务功能一级局数据系统与省级局数据系统的SP(AP)信息同步接口，主要完成全网SP(AP)信息的同步。4.1.1.2. 业务流程说明：1、业务管理员在一级局数据系统制作，审批SP(AP)业务局数据； 2、一级局数据管理与发布系统发送给省级局数据管理与发布系统； 3、省级局数据管理与发布系统对制作的业务局数据进行校验并入库，并同时
21、给一级局数据返回状态信息同步请求。4.1.1.3. 业务约束无。4.1.1.4. 交易单元4.1.1.4.1. 交易属性一级局数据系统向省局数据系统发起SP(AP)信息同步：名称取值安全性：密码加密安全性：防篡改交易发起方代码一级局数据系统交易落地方代码省级局数据系统4.1.1.4.2. 交易报文报文分为报文头(head)和报文体(body)两部分，关于报文头的内容及格式参见3.1.1节中公共报文头的描述。在此只描述报文体部分一级局数据系统向省级局数据系统发起SP(AP)信息同步： (1)请求body：序号父元素名称元素名称约束类型长度描述取值说明1ROOTbody1报文体节点1.1bodym
22、sgType1int消息类型消息类型：1: 申请2：变更3：退出1.2bodyoperationType1int操作类型操作类型：1:测试2：商用3:变更4:网络测试5:计费测试6:网络商用7:计费商用8:网络变更9:计费变更10：终止合作注：当消息类型为“申请”时，操作类型为“测试类”或者“商用类”；当消息类型为“变更”时，操作类型为“变更类”1.3bodyspCode1String12企业代码企业代码1.4bodystartTime？String14预退出时间预退出时间yyyyMMddHHmmss1.5bodyquitTime？String14正式退出时间正式退出时间yyyyMMddHHm
23、mss1.6bodyspInfo1Sp信息节点Sp信息节点1.6.1spInfospTypeID1String2SP业务种类SP业务种类1分省结算短信2 一点结算梦网短信3Wap 4彩信5Kjava 6mail 7Location（定位） 8WWW9IVR（本地）10移动沙龙11PDA 12手机动画13彩铃(本地) 14 通用下载15 手机支付 1.6.2spInfospName1String100SP中文名称SP中文名称1.6.3spInfospShortName1String12SP中文简称SP中文简称1.6.4spInfocompanyCode1String100SP公司编码SP公司编码
24、1.6.5spInfoserverCode？String12服务代码服务代码当SP业务种类为分省结算短信、一点结算梦网短信、梦网彩信业务时，该字段必填，为全数字的服务代码；WAP、手机动画、通用下载业务填空。1.6.6spInfoconnectProvince？String200接入省代码接入省代码(见7.3章节)1.6.7spInfosettlementProvince1String4结算省代码结算省代码(见7.3章节)1.6.8spInfoplatformCode1String12平台代码平台代码。当SP业务种类为分省结算短信、一点结算梦网短信、梦网彩信业务时，该字段必填，其他业务种类填空
25、。分省结算短信：填写短信网关代码一点结算梦网短信：填写短信网关代码梦网彩信：填写彩信中心ID1.6.9spInfovalidDate？String 8生效日期生效日期（格式YYYYMMDD）：该字段在SP申请，SP变更时可以不填，SP退出时必填。1.6.10spInfoexpireDate？String 8失效日期失效日期（格式YYYYMMDD）如果没有，默认为209912311.6.11spInfospDesc1String50SP描述SP描述（没有就填空）1.6.12spInfospAttr？String2SP属性SP属性：G 全网SPL 本地SP1.6.13spInfospAddress
26、 1String100SP所在地址SP所在地址1.6.14spInfospPrincipal1String40SP业务联系人SP业务联系人1.6.15spInfospPrincipalTel？String20SP业务联系人电话SP业务联系人电话1.6.16spInfospPrincipalMail？String100SP业务联系人邮箱SP业务联系人邮箱1.6.17spInfoiPAddress ？String19主机IP主机IP1.6.18spInfospEName 1String300SP英文名称SP英文名称1.6.19spInfoareaCode1String100SP可服务的地市区号SP
27、可服务的地市区号，多个用半角字符逗号“,”分隔开。为空表示可以服务所有地市如果没有这个值，就传“7.3局数据系统省编码”，全网SP传空1.6.20spInfoapplyDate？String8申请时间申请时间（格式：YYYYMMDD）消息类型为申请，填写SP申请的申请时间消息类型为变更，填写SP变更的申请时间消息类型为退出、终止合作，填写SP退出、终止合作的申请时间如果SIMS、UNIOMS没有此时间，需要用消息通过接口发送时间代替。针对FTP接口SIMS填写当前时间1.6.21spInfodivideScale1String8分成比例分成比例。没有就填写85:15 (2)应答报文：序号父元素
28、名称元素名称约束类型长度描述取值说明1ROOTbody1返回消息报文体节点返回消息报文体节点1.1bodyreturnCode1String5返回码返回码， 参见返回码定义1.2bodyreturnDesc1String128应答/错误描述应答/错误描述,成功时填空，失败必须填写错误描述4.1.1.4.3. 返回码编码描述0000成功-1000.-1999协议接口错误代码范围-1001协议解析错误-2000.-3999业务应用逻辑错误代码范围-2001重复请求包-2012请求包非法-2013未知请求包4.1.2. 全网业务信息同步4.1.2.1. 业务功能一级局数据系统与省级局数据系统的业务信
29、息同步接口，主要完成全网业务信息的同步。4.1.2.2. 业务流程说明：1、业务管理员在一级局数据系统制作，审批业务信息局数据； 2、一级局数据管理与发布系统发送给省级局数据管理与发布系统； 3、省级局数据管理与发布系统对制作的业务局数据进行校验并入库，并同时给一级局数据返回状态信息同步请求。4.1.2.3. 业务约束无。4.1.2.4. 交易单元4.1.2.4.1. 交易属性一级局数据系统向省局数据系统发起业务信息同步：名称取值安全性：密码加密安全性：防篡改交易发起方代码一级局数据系统交易落地方代码省级局数据系统4.1.2.4.2. 交易报文报文分为报文头(head)和报文体(body)两部
30、分，关于报文头的内容及格式参见3.1.1节中公共报文头的描述。在此只描述报文体部分一级局数据系统向省级局数据系统发起业务信息同步：(1) 请求body：序号父元素名称元素名称约束类型长度描述取值说明1ROOTbody1报文体根节点报文体根节点1.1bodymsgType1int消息类型消息类型：1:申请2：变更3：下线1.2bodyoperationType1int操作类型操作类型：1:测试2:商用3:变更4:网络测试5:计费测试6:网络商用7:计费商用8:网络变更9:计费变更10：下线注：当消息类型为“申请”时，操作类型为“测试类”或者“商用类”；当消息类型为“变更”时，操作类型为“变更类”
31、当消息类型为下线时操作类型为：1:下线2：考核下线/处罚下线1.3bodyspCode1String12企业代码企业代码1.4bodyserviceCode1String10业务代码业务代码1.5bodyservType1String10业务类型业务类型 001102: 分省结算短信, 001103:一点结算梦网短信, 000103:梦网彩信, 000104:WAP, 000105:手机动画, 000005:通用下载， 000009：IVR 1.6bodystartTime1String14预下线时间预下线时间yyyyMMddHHmmss1.7bodyquitTime1String14正式下线
32、时间正式下线时间yyyyMMddHHmmss1.8bodymemo？String200业务说明业务说明1.9bodyserviceInfo1业务信息节点业务信息节点1.9.1serviceInfoserviceName1String64业务名称业务名称;局数据系统负责处理半角问题；1.9.2serviceInfobalanceSideOne？String100结算方1结算方1（没有就填空）1.9.3serviceInfobalanceSideTwo？String100结算方2结算方2（没有就填空）1.9.4serviceInfobillFlag1String2计费类型计费类型00核减不均衡下行
33、通信费01免费02按条03包月04包月（首次使用计费）05SP自收费06按次封顶07按金额封顶08 按时长计费12 包周13 包天1.9.5serviceInfofee1long信息费信息费（单位：厘）1.9.6serviceInfovalidDate？String 8生效日期生效日期（格式YYYYMMDD）：该字段在业务申请，业务变更时可以不填，业务下线时必填。1.9.7serviceInfoexpireDate1String 8失效日期失效日期（格式YYYYMMDD）如果没有，默认为209912311.9.8serviceInfosettlementScale1String11结算比例结算
34、比例填写格式：:（以半角“:”分割），PROP1, PROP2, PROP3为0100的数字，该字段代表了三个结入方的结算比例，三个结入方参见表格后的注释。举例如下：彩信业务，85:0:0表示SP结算省结入85WAP业务，50:0:0表示SP结入50手机动画业务，45:20:0表示SP结入45，技术平台提供商结入201.9.9serviceInfocount1int包次次数/包天天数包次次数/包天天数只对通用下载业务下的包次、包天计费方式下适用。其他业务填01.9.10serviceInfoserviceAttr1String1业务属性业务属性G全局服务L本地服务1.9.11serviceIn
35、foconfirmToThirdParty1String1是否向业务平台做第三方确认是否向业务平台做第三方确认0：不需要1：需要没有就填不需要1.9.12serviceInforeConfirm1String1二次确认标志二次确认标志1:需要2：不需要默认为11.9.13serviceInfoserviceSpeciality？int业务特性业务特性：1手机点播类2手机定制类3网站定制类4网站点播类5STK点播类6STK定制类7帮助信息类8点播类9定制类10上行计费类注：该字段只针对彩信、短信有效，其他业务填空1.9.14serviceInfoareaCode？String100SP可服务的地
36、市区号，多个用半角字符逗号“,”分隔开。为空表示可以服务所有地市1.9.15serviceInfoconnectGateway？String20接入网关接入网关1.9.16serviceInfoapplyDate1String8申请时间申请时间（格式：YYYYMMDD）消息类型为申请，填写业务申请的申请时间消息类型为变更，填写业务变更的申请时间消息类型为下线、处罚下线，填写下线、处罚下线的申请时间如果SIMS、UNIOMS没有此时间，需要用消息通过接口发送时间代替；针对FTP接口SIMS填写当前时间(2)应答报文：序号父元素名称元素名称约束类型长度描述取值说明1ROOTbody1报文体根节点报
37、文体根节点1.1bodyreturnCode1String5返回码， 参见返回码定义返回码， 参见返回码定义1.2bodyreturnDesc1String128应答/错误描述,成功时填空，失败必须填写错误描述应答/错误描述,成功时填空，失败必须填写错误描述4.1.2.4.3. 返回码编码描述0000成功-1000.-1999协议接口错误代码范围-1001协议解析错误-2000.-3999业务应用逻辑错误代码范围-2001重复请求包-2012请求包非法-2013未知请求包4.1.3. 音乐类SP信息同步4.1.3.1. 业务功能一级局数据系统与省级局数据系统的音乐类SP信息同步接口，主要完成音
38、乐类SP信息的同步。4.1.3.2. 业务流程说明：1、业务管理员在一级局数据系统制作，审批音乐类SP信息局数据； 2、一级局数据管理与发布系统发送给省级局数据管理与发布系统； 3、省级局数据管理与发布系统对制作的局数据进行校验并入库，并同时给一级局数据返回状态信息同步请求。4.1.3.3. 业务约束无。4.1.3.4. 交易单元4.1.3.4.1. 交易属性一级局数据系统向省局数据系统发起音乐类SP数据同步：名称取值安全性：密码加密安全性：防篡改交易发起方代码一级局数据系统交易落地方代码省级局数据系统4.1.3.4.2. 交易报文报文分为报文头(head)和报文体(body)两部分，关于报文头的内容及格式参见3.1.1节中公共报文头的描述。在此只描述报文体部
