联通SP在信业务开发规范标准

1、 . . 29/29联通SP在信业务开发规 日期：联通在信业务开发规V3.0中国联合通信公司2006年1月23日目 录 TOC o 1-3 h z 1.说明31.1.原则31.2.容32.总则42.1.背景42.2.文档容42.3.适用围42.4.解释权与修订权52.5.术语与缩略语52.6.参考文献53.修改说明64.系统边界和接口设计74.1.系统边界74.2.接口原则74.3.接口约束85.与SP的接口85.1.SP接入规85.1.1 SP与业务资料导入规85.1.2 SP业务接入规105.2.SP基本资料同步接口125.3.SP业务资料同步接口145.4.用户业务定购资料同步接口165

2、.5.SP业务定购WEB调用接口175.6.SP业务点播用户确认接口18说明原则本资料所有权属于中国联合通信，任何其他公司、个人无论以任何形式获取了本资料，在使用本资料都应遵守以下原则：在未经中国联合通信授权许可下，不得以任何形式使用本资料；不得传播本资料信息；不得恶意复制、散发本资料。但是不限制合作公司或个人在双方协议基础上，即中国联合通信授权许可下，正常的使用本资料，包括在授权许可下，在公司部其他部门阅取、复制、使用本资料信息，或者是和第三方公司、个人共同享用本资料信息。容本资料的容包括：在双方协议的基础上，中国联合通信提供的资料，包括在正式场合下提供的资料，以与在特定场合下提供的正式和非

3、正式资料和信息；在中国联合通信许可下，从中国联合通信获取的资料和信息；从其他途径获取，但未经中国联合通信授权许可的本资料信息。本资料的容不包括：中国联合通信已经公开或者即将公开的资料信息；经中国联合通信授权许可后，可以传播的资料信息；在未知本资料信息的情况，自主开发的信息；在接受本协议前已经获取的信息。总则背景目前联通在信网络与SP在信业务管理平台基本运行正常，业务发展前景良好，各服务提供商和容提供商经过一段时间的整合，业务已经开始大幅回升。现在联通业务进一步好转，新增SP/CP越来越多，为了更好的服务各SP/CP,对全国性联通在信业务部分流程进行优化，实现对SP的有效管理，提高用户服务质量，

4、促进联通在信的良性发展。文档容本文主要规定了中国联合通信的全国性联通在信业务SP管理系统（以下简称SPMS）录入SP资料的接口规。适用围本文主要用于中国联合通信全国性联通在信业务SP管理系统的建设与管理。用于指导联通总部、分公司和联通在信业务提供商业务建设的研制、开发和实施。本文适用于SP/CP、SPMS系统建设厂家和联通公司的管理与技术人员等。解释权与修订权本文由中国联通制定、审核并发布，起草单位为中国联通增值业务部。本文将根据市场发展需要适时进行修改，其修改权和解释权属于中国联通增值业务部。术语与缩略语缩略语全称说明SPService Provider业务提供者SMGShort Messa

5、ge Gateway短消息网关SMSCShort Message Service Center短消息中心SMPPShort Message Peer to Peer短消息点对点协议SGIPShort message Gateway Interface Protocol短消息网关接口协议MOMobile Original移动用户发送短消息MTMobile Terminal移动用户接收短消息SPSMGSP SMG联通在信全国性SP集中网关参考文献短消息业务联网协议1.2版短消息业务联网规1.2版点对点短消息协议 SMPP3.4中国联通SP管理系统业务鉴权协议中国联合通信全国性联通在信业务SP管理系

6、统外部接口规修改说明序号版本号修改人修改日期修改容13.02006-1-17在定制短信通知中增加：定制确认短信中应向用户明示下发条数和收费方式；接口设计接口原则为了保证SPMS系统与其它相关系统方便、可靠地通过接口进行数据交换与业务处理，接口规应满足如下原则：接口具有普遍的适应性；使用简单、快捷的方式实现SPMS与其它相关系统的接口；接口应充分考虑SPMS与其它相关系统的应用扩展情况；保证接口数据在SPMS与其它相关系统的一致性；接口数据能够方便的形成，并能在被接口方顺利地导入；在接口数据交互过程中，应具有数据传送和接收传送后的确认过程；在满足功能要求的前提下，使接口数据量最少；接口数据传输控

7、制策略可靠且完善；具有可靠的接口数据出错处理机制。接口约束XML文件中，编码方式为UTF-8；FTP传输ASCII文件时，编码方式为GB-2312；SP资料导入接口SP接入规5.1.1 SP与业务资料导入规已接入到“联通在信”的SP已接入到“联通在信”平台并向用户提供短信业务的SP，需要以文件形式一次性将SP的基本资料与全部业务资料同步到联通SP管理平台，SP管理平台鉴权中心根据同步过来的基本信息和业务信息对MO/MT消息进行鉴权，未同步过来的业务将不能通过业务鉴权，由此造成的业务损失由SP自行负责。SP基本资料同步接口参见5.2节。SP业务资料同步接口参见5.3节。新接入到“联通在信”的SP

8、新申请接入到“联通在信”到SP，通过SP管理门户提供的SP自服务门户进行电子化接入，主要流程如下：SP预约联通业务部门，提交业务申请与资质审查表。联通业务部门初审SP资料，给SP分配SP自服务门户登陆和密码。SP用联通分配的用户名和密码登陆自服务门户。SP在自服务门户填写接入资料，提交接入申请。联通业务操作人员在系统管理门户查询SP接入申请，检查、审核SP接入资料，也可通过其它途径对SP进行审核，对符合条件的SP设置为“初审通过”，给SP分配企业代码、接入号、密钥等资源。联通业务主管人员在系统管理门户查询状态为“初审通过”的SP接入资料，对SP进行终审，审核通过后该SP即为接入状态。SP通过自

9、服务门户添加业务信息，提交业务接入申请。SP接入后，SP可在自服务门户暂停本SP的接入，接入暂停后该SP提供的所有服务均被停止；SP自行暂停后，可在自服务门户进行恢复。SP接入后，如SP业务不规、投诉严重等原因，联通业务管理人员可通过系统管理门户暂停该SP的接入，SP不能自行进行恢复。SP可在自服务门户申请接入注销，从SP提交申请注销开始，该SP提供的所有服务均停止。联通业务管理人员确认SP注销后，该SP的信息接入被删除，SP要开通业务需要按接入流程重新进行申请。SP接入后，如SP业务不规、投诉严重等原因，联通业务管理人员可通过系统管理门户注销该SP的接入，注销后不能恢复，SP要开通业务需要按

10、接入流程重新进行申请。SP新申请开通的业务SP接入成功后，可登陆自服务门户进行业务接入。SP操作员在自服务门户中录入业务信息，包括命令字、业务代码、资费方式、业务介绍、操作说明等信息。业务信息录入后，提交业务接入申请（一次可提交多个业务接入申请）。联通业务管理人员在系统管理门户审核SP的业务接入申请信息，联系SP进行业务测试，业务测试通过后可同意业务的接入申请，审核通过后的业务进行正常状态；审核或测试不通过的业务拒绝接入。SP可在自服务门户进行业务的暂停/恢复操作，也可注销业务。联通业务管理人员可在自服务门户对SP的业务进行暂停、恢复或注销操作，联通业务管理人员暂停SP业务后，SP不能在自服务

11、门户自行恢复业务。5.1.2 SP业务接入规接入到“联通在信”平台的SP，可向用户提供基于短信的点播和定制服务，不得随意向用户发送广告信息，业务接入必须遵循如下规：所有业务的接入均需通过联通的审批，SP必须向联通提供正确的业务点播/定制/退订命令字、业务代码、资费信息、操作说明等信息，业务测试与审批通过后方可向用户提供服务。SP需遵守国家法律，不得提供任何反动、封建、迷信等容的服务，一旦违例将被吊销服务资格并追究法律责任。SP不得随意向用户发送广告或其它形式的垃圾短信，不得进行大规模的短信群发，违例将被降低信用等级，严重违例的SP将被注销其服务资格。SP可通过短信点播/定制的方式或网上点播/定

12、制的方式向用户提供服务。SP提供的任何定制服务，必须向用户同时提供明确的退订界面，方便用户进行业务退订，不提供退订功能的业务不能接入到“联通在信”平台。SP在网上提供的点播、定制服务，必须先使用户进行手机注册或绑定，注册或绑定成功后，下发密码通知短信给用户，用户使用注册密码登录网上社区后方能进行点播或定制业务，即SP必须先确定用户身份后才能提供服务。A命令字与业务代码的关系命令字与业务代码由SP自行制定，在一个SP，业务代码是唯一的，一个点播类业务唯一对应一个点播命令字，一个订制类业务唯一对应一个订制命令字和一个退订命令字，退订服务不收费。对同一种业务，如短信新闻，SP可同时提供点播和定制服务

13、，两种服务资费标准不一样，这种情况下，SP需提供如下所示命令字与业务代码：业务命令字业务代码业务类型退订命令字资费说明新闻DBXWXW0001点播0.1元/条新闻DZXWXW0002订制TDXW5元/月每天2条B订制通知短信对于订制类业务，无论用户通过手机短信发起订制，还是在网上进行订制，订制关系都同时保存在SP管理系统和SP系统。订制流程如下：用户发起业务订制请求；鉴权中心收到订制消息鉴权请求，生成预定购关系，向用户下发订制确认短信。定制确认短信中应向用户明示下发条数和收费方式；用户回复确认短信，鉴权中心将用户订制请求发给SP；SP处理成功用户订制请求后，向用户下发订制通知短信；鉴权中心根据

14、SP的订制成功通知短信生成正式的用户订制记录，将通知短信下发给用户。根据以上订制流程可知，最后的订制成功通知短信至关重要，是鉴权中心生成正式订制关系的依据，所以SP必须在用户订制成功后，与时下发订制成功通知短信。订制类业务的计费以SP管理系统中的订制关系为准，如包月业务，SP定时下发包月计费短信，SP管理系统鉴权中心根据本地的订制关系对消息进行鉴权，鉴权失败的消息被拦截。C用户在SP网上社区注册或进行手机绑定SP在网上提供的点播、定制服务，必须先使用户进行手机注册或绑定，注册或绑定成功后，下发密码通知短信给用户，用户使用注册密码登录网上社区后方能进行点播或定制业务，即SP必须先确定用户身份后才

15、能提供服务。使用手机进行网上社区注册或手机绑定时，为了SPMS端确认用户身份和进行密码通知短信的鉴权，要求SP对用户注册采用与业务点播一致的处理流程，即使用点播确认码的用户，参见接口5.6。D手机短信点播SP业务用户使用手机短信点播SP业务，鉴权中心截获MO消息，生成唯一的LinkID，将LinkID加到SGIP Deliver包的Reserve字段后转发给SP，SP下发对应的MT消息时必须将这个LinkID带到Submit包的Reserve字段，鉴权中心根据LinkID对点播产生的MT消息进行鉴权，LinkID不能匹配的消息认为是非法消息而被拦截。E网上点播SP业务为了SPMS端确认用户身份

16、和进行点播消息进行鉴权，SP必须调用SPMS提供的点播调用接口机制，点播确认码由SPMS生成通过短信下发给网上点播的用户手机，参见接口5.6。F手机短信订制/退订业务用户通过手机短信进行业务订制，采用确认短信的机制，由鉴权中心向用户下发确认短信，用户回复确认后，SPMS和SP系统处理订制订请求，SPMS和SP系统的用户订制关系保存同步。用户通过手机短信进行业务退订，不采用确认短信机制。鉴权中心收到退订业务请求后，将该用户的订制关系解除，然后将退订请求转发给SP，SP可向用户下发退订成功通知短信。G网上订制/退订SP业务用户在网上订制业务，采用确认短信的方式，由鉴权中心向用户下发订制确认短信，用

17、户回复后，SPMS和SP系统处理订制订请求，SPMS和SP系统的用户订制关系保存同步，参见接口5.5。用户通过在上进行业务退订，不采用确认短信机制。鉴权中心收到退订业务请求后，将该用户的订制关系解除，然后将退订请求转发给SP，SP可向用户下发退订成功通知短信。H用户订制业务短信的鉴权用户订制成功SP业务后，SP根据业务规则向用户下发MT业务消息，鉴权中心根据该用户在SPMS端的订制关系对MT消息进行鉴权，订制关系不正确的MT消息将被拦截。SP基本资料导入接口发起方：SP(一个SP一条记录)接收方：SPMS接口协议：FTP/ FTP/EMAIL接口形式：XML文件同步时间：已经接入到联通在信的S

18、P，可通过XML文件形式一次性将SP的基本信息同步给SP管理系统。（SP也可不使用该接口，而直接登录SP管理系统的SP自服务门户，以手工录入的方法将SP基本信息提交给SP管理系统。）文件命名：SPBI + 5位SP企业代码 + 8位时间 + 4位序号.XML 如：SPBI.XML文件容：文件以XML格式存储，XML文件中所有字段的类型定义为String型，XML文件属性定义如下：序号字段名最大长度（字节）字段含义说明1CorpID10SP的企业代码不能为空2SpNumber21SP的接入不能为空, 一个SP最多可有4个接入号，多接入号情况下以该字段值逗号分隔，如9771,9772,9773（目

19、前只开放一个接入号）3ShortName32SP简称不能为空4SpChName100SP中文名称不能为空5SpEnName100SP英文名称不能为空6CorpType2公司类型不能为空0-国营 1-集体2-民营 3-私营4-中外合资5-外商独资7CreateDate10公司成立时间不能为空，格式：YYYY-MM-DD8StockFlag2是否上市0-NO 1-YES9ArtificialPerson32法人代表名不能为空10ChiefOfficer32公司总经理/总裁名不能为空11TotalMember10公司员工数不能为空12RegisterFund10注册资金（元人民币）不能为空13Int

20、roduction120SP介绍不能为空14WebAddress80SP地址可填空15ServiceDesc120SP主营业务介绍不能为空16ProvinceCode3SP接入省份省代码不能为空，参考6.117AreaCode32SP接入城市不能为空,参考6.218TeleSvcLicense64电信信息服务许可证编号可填空19TeleSvcLicensedBy100电信信息服务许可证颁发单位可填空20License64营业执照号不能为空21LicensedBy100主管登记机关不能为空22DealInScope120业务经营围不能为空23BankName64SP开户银行可填空24BankAc

21、count32银行可填空25Address64公司地址不能为空26ZipCode10 不能为空27PhoneNum20SP公司不能为空28FaxNum20SP 不能为空29DisputationNum20SP投诉不能为空30EffectiveDate10合约起始时间不能为空，格式：YYYY-MM-DD31ExpireDate10合约终止时间不能为空，格式：YYYY-MM-DD32ChargeUser16负责人不能为空33ChargeUserDesc32负责人职务不能为空34ChargeTelNumber20负责人固定不能为空35ChargeMobilePhone20负责人移动不能为空36Cha

22、rgeEmail80负责人EMAIL不能为空37ContactName16联系人不能为空38ContactUserDesc32联系人职务不能为空39ContactTelNumber20联系人固定不能为空40ContactMobilePhone20联系人移动不能为空（必须为联通）41ContactEmail80联系人EMAIL不能为空（必须如意，由联通分配）42RegisterDate10注册时间不能为空，格式：YYYY-MM-DD43AccesssDate10接入时间不能为空，格式：YYYY-MM-DDXSD文件定义如下：SP业务资料同步接口发起方：SP接收方：SPMS接口协议：FTP/EMA

23、IL接口形式：文本文件同步时间：已经接入到联通在信的SP，需通过文件形式将SP已开通的业务信息同步给SP管理系统，SP管理系统根据已接入的业务资料对MO/MT消息进行鉴权。文件命名：SPST 5位SP企业代码 + 8位时间 + 4位序号.TXT如：SPST.TXT文件容：文件采用ASCII文本格式，文件体中一行作为一条记录，每一条记录代表sp的一个业务，记录的属性值按顺序排列，各属性间使用t分隔。各条记录之间用换行符作为分隔。序号字段名最大长度（字节）字段含义说明1SpNumber21SP的接入不能为空2ServiceType12业务代码不能填空3ServiceTag12业务代码对应的命令字不

24、能填空定制业务命令字与业务代码之间一一对应。点播业务填写点播的命令字（若某个业务代码下，点播命令字过多，可填写#）非命令字业务填写#（4个#仅适用于点播类）4RequestType1业务类别不能填空：1-点播 2-订制 （4-6目前保留，未使用）4-单边MT（聊天类） 5-通知MT 6-广告MT5SvcTypeCode16业务编码不能填空，定义如下：YX：游戏TP：图片LS：铃声YJ：XW：新闻资讯LT：聊天交友YM：幽默笑话SH：生活休闲ZH：综合QT：其它6ServiceName64业务名称不能为空7FeeType2信息费计费类型不能为空1-免费 2-按条计费 3-包月计费 4-SP自计费

25、8FeeValue10信息费，单位分不能为空9MTCount5MO对应MT最大条数不能为空10ServiceDesc120业务描述不能为空11MTSendDesc120发送频率说明不能为空12OperateDesc120操作说明不能为空13RegisterDate10业务注册时间不能为空，格式：YYYY-MM-DD14AccesssDate10业务接入时间不能为空，格式：YYYY-MM-DD15CancelSvcTag12短信方式退订命令字点播（或非订制）业务该字段可填空。订制业务必须有退订命令字。16SubscriptionUrl80WEB方式点播/订制/退订地址可填空17换行1n用户业务定

26、购资料同步接口发起方：SP接收方：SPMS接口协议：FTP/EMAIL接口形式：文本文件同步时间：已经接入到联通在信的SP，需通过文件形式将已定购SP业务的用户信息同步给SP管理系统。文件命名：SPUS + 5位SP企业代码 + 8位时间 + 4位序号.TXT如：SPUS.TXT文件采用ASCII文本格式，文件体中一行作为一条记录，每一条记录代表手机用户订购的一个业务，每条记录的属性值按顺序排列，各属性间使用t分隔，一个手机订购多项业务需要多条记录，各条记录之间用换行符作为分隔。每个文件最大记录数为10万条，超过的需要按照文件序列号递增的方式生成新的文件。（要求：UserNumber必须和Ch

27、argeNumber一致；对于不一致的用户业务订购关系，SPMS系统将强制一致性，以ChargeNumber为准）序号字段名最大长度(字节)含义说明1SpNumber21SP接入号不能填空2UserNumber21使用服务用户手机不能填空3ChargeNumber21付费用户手机不能填空4ServiceType12业务代码不能填空5ServiceTag12定制命令字不能填空6CancelTag12退订命令字不能填空7AccessTime20订购（/退订）时间不能填空；格式YYYYMMDDHH24MISS8Mode11:表示定制或订购；0：表示退订或取消不能填空9换行1n6联通省份、地市列表6.

28、1.联通省分代码（X1X2X3）省分公司编码省分公司名称001中国联通总部0100110130170180190300310340360380500510590700710740750760790810830840850860870880890900910976.2.联通地市代码（X1X2X3）省分编码地市编码地市名称010101呼和浩特010102010103乌兰察布盟010104伊克昭盟010105巴延卓尔盟010106010107010108海拉尔010109010111锡林浩特010112哲里木盟010113兴安盟010114阿盟010115呼盟01111001313001715001

29、7151滨州017152威海017153017154日照017155潍纺017156东营017157枣庄017158017159荷泽017160莱芜017161017166017170017172017173017174聊城018180018181018182018183018184018185018186018187018188018189018720019190019191晋中019192019193019194019195019196019197019198019199朔州019200030300马030301030302030303030304030305030306030307030

30、308030309030311030312030313030314030316030317池州031310034330034334常熟034340034343034346034348034349宿迁034350034354034358034430034440034445034450036360036362036363036364036365036367036370036468036469036470036476038380038384038385038386038387038389038390038395038480050501050502050503051510051520051525051

31、526揭阳051528051530051531051533051535051536051538051540051550江门051556051558051560051565051568051570051580051620051670051678059588贺州059589贵港059590059591059592059593059594059595059596059597059598059599070700070701070702格尔木070703德令哈070704海西洲070705洲070706海北洲071710071711071712荆州071713仙桃071714黄冈071715071716襄樊071717071718071719071721071722神农架071723随州071724071725天门071726潜江071727074741074742074743074744074745074746浏阳074747074748074749074791074792074793074794074795074796永州0757400757500757510