联通SP在信业务开发规范doc 31页.docx

资源描述

联通SP在信业务开发规范doc 31页.docx

《联通SP在信业务开发规范doc 31页.docx》由会员分享，可在线阅读，更多相关《联通SP在信业务开发规范doc 31页.docx（36页珍藏版）》请在冰豆网上搜索。

联通SP在信业务开发规范doc 31页.docx

联通SP在信业务开发规范doc31页

联通SP在信业务开发规范（doc31页）

联通在信业务开发规范

V3.0

中国联合通信公司

2006年1月23日

在未知本资料信息的情况，自主开发的信息；

1）在接受本协议前已经获取的信息。

1.总则

1.1.背景

目前联通在信网络及SP在信业务管理平台基本运行正常，业务发展前景良好，各服务提供商和内容提供商经过一段时间的整合，业务已经开始大幅回升。

现在联通业务进一步好转，新增SP/CP越来越多，为了更好的服务各SP/CP,对全国性联通在信业务部分流程进行优化，实现对SP的有效管理，提高用户服务质量，促进联通在信的良性发展。

1.2.文档内容

本文主要规定了中国联合通信有限公司的全国性联通在信业务SP管理系统（以下简称SPMS）录入SP资料的接口规范。

1.3.适用范围

本文主要用于中国联合通信有限公司全国性联通在信业务SP管理系统的建设与管理。

用于指导联通总部、分公司和联通在信业务提供商业务建设的研制、开发和实施。

本文适用于SP/CP、SPMS系统建设厂家和联通公司的管理及技术人员等。

1.4.解释权与修订权

本文由中国联通制定、审核并发布，起草单位为中国联通增值业务部。

本文将根据市场发展需要适时进行修改，其修改权和解释权属于中国联通增值业务部。

1.5.术语与缩略语

缩略语

全称

说明

ServiceProvider

业务提供者

SMG

ShortMessageGateway

短消息网关

SMSC

ShortMessageServiceCenter

短消息中心

SMPP

ShortMessagePeertoPeer

短消息点对点协议

SGIP

ShortmessageGatewayInterfaceProtocol

短消息网关接口协议

MobileOriginal

移动用户发送短消息

MobileTerminal

移动用户接收短消息

SPSMG

联通在信全国性SP集中网关

1.6.参考文献

⏹《短消息业务联网协议1.2版》

⏹《短消息业务联网规范1.2版》

⏹《点对点短消息协议SMPP3.4》

⏹《中国联通SP管理系统业务鉴权协议》

⏹《中国联合通信有限公司全国性联通在信业务SP管理系统外部接口规范》

2.修改说明

序号

版本号

修改人

修改日期

修改内容

3.0

2006-1-17

在定制短信通知中增加：

定制确认短信中应向用户明示下发条数和收费方式；

3.接口设计

3.1.接口原则

为了保证SPMS系统与其它相关系统方便、可靠地通过接口进行数据交换与业务处理，接口规范应满足如下原则：

Ø接口具有普遍的适应性；

Ø使用简单、快捷的方式实现SPMS与其它相关系统的接口；

Ø接口应充分考虑SPMS与其它相关系统的应用扩展情况；

Ø保证接口数据在SPMS与其它相关系统的一致性；

Ø接口数据能够方便的形成，并能在被接口方顺利地导入；

Ø在接口数据交互过程中，应具有数据传送和接收传送后的确认过程；

Ø在满足功能要求的前提下，使接口数据量最少；

Ø接口数据传输控制策略可靠且完善；

Ø具有可靠的接口数据出错处理机制。

3.2.接口约束

⏹XML文件中，编码方式为UTF-8；

⏹FTP传输ASCII文件时，编码方式为GB-2312；

4.SP资料导入接口

4.1.SP接入规范

5.1.1SP及业务资料导入规范

A.已接入到“联通在信”的SP

已接入到“联通在信”平台并向用户提供短信业务的SP，需要以文件形式一次性将SP的基本资料及全部业务资料同步到联通SP管理平台，SP管理平台鉴权中心根据同步过来的基本信息和业务信息对MO/MT消息进行鉴权，未同步过来的业务将不能通过业务鉴权，由此造成的业务损失由SP自行负责。

SP基本资料同步接口参见5.2节。

SP业务资料同步接口参见5.3节。

B.新接入到“联通在信”的SP

新申请接入到“联通在信”到SP，通过SP管理门户提供的SP自服务门户进行电子化接入，主要流程如下：

1）SP预约联通业务部门，提交业务申请及资质审查表。

2）联通业务部门初审SP资料，给SP分配SP自服务门户登陆帐号和密码。

3）SP用联通分配的用户名和密码登陆自服务门户。

4）SP在自服务门户填写接入资料，提交接入申请。

5）联通业务操作人员在系统管理门户查询SP接入申请，检查、审核SP接入资料，也可通过其它途径对SP进行审核，对符合条件的SP设置为“初审通过”，给SP分配企业代码、接入号、密钥等资源。

6）联通业务主管人员在系统管理门户查询状态为“初审通过”的SP接入资料，对SP进行终审，审核通过后该SP即为接入状态。

7）SP通过自服务门户添加业务信息，提交业务接入申请。

8）SP接入后，SP可在自服务门户暂停本SP的接入，接入暂停后该SP提供的所有服务均被停止；SP自行暂停后，可在自服务门户进行恢复。

9）SP接入后，如SP业务不规范、投诉严重等原因，联通业务管理人员可通过系统管理门户暂停该SP的接入，SP不能自行进行恢复。

10）SP可在自服务门户申请接入注销，从SP提交申请注销开始，该SP提供的所有服务均停止。

联通业务管理人员确认SP注销后，该SP的信息接入被删除，SP要开通业务需要按接入流程重新进行申请。

11）SP接入后，如SP业务不规范、投诉严重等原因，联通业务管理人员可通过系统管理门户注销该SP的接入，注销后不能恢复，SP要开通业务需要按接入流程重新进行申请。

C.SP新申请开通的业务

1）SP接入成功后，可登陆自服务门户进行业务接入。

2）SP操作员在自服务门户中录入业务信息，包括命令字、业务代码、资费方式、业务介绍、操作说明等信息。

3）业务信息录入后，提交业务接入申请（一次可提交多个业务接入申请）。

4）联通业务管理人员在系统管理门户审核SP的业务接入申请信息，联系SP进行业务测试，业务测试通过后可同意业务的接入申请，审核通过后的业务进行正常状态；审核或测试不通过的业务拒绝接入。

5）SP可在自服务门户进行业务的暂停/恢复操作，也可注销业务。

6）联通业务管理人员可在自服务门户对SP的业务进行暂停、恢复或注销操作，联通业务管理人员暂停SP业务后，SP不能在自服务门户自行恢复业务。

5.1.2SP业务接入规范

接入到“联通在信”平台的SP，可向用户提供基于短信的点播和定制服务，不得随意向用户发送广告信息，业务接入必须遵循如下规范：

◆所有业务的接入均需通过联通的审批，SP必须向联通提供正确的业务点播/定制/退订命令字、业务代码、资费信息、操作说明等信息，业务测试及审批通过后方可向用户提供服务。

◆SP需遵守国家法律，不得提供任何反动、色情、封建、迷信等内容的服务，一旦违例将被吊销服务资格并追究法律责任。

◆SP不得随意向用户发送广告或其它形式的垃圾短信，不得进行大规模的短信群发，违例将被降低信用等级，严重违例的SP将被注销其服务资格。

◆SP可通过短信点播/定制的方式或网上点播/定制的方式向用户提供服务。

◆SP提供的任何定制服务，必须向用户同时提供明确的退订界面，方便用户进行业务退订，不提供退订功能的业务不能接入到“联通在信”平台。

◆SP在网上提供的点播、定制服务，必须先使用户进行手机注册或绑定，注册或绑定成功后，下发密码通知短信给用户，用户使用注册密码登录网上社区后方能进行点播或定制业务，即SP必须先确定用户身份后才能提供服务。

A．命令字与业务代码的关系

命令字与业务代码由SP自行制定，在一个SP内，业务代码是唯一的，一个点播类业务唯一对应一个点播命令字，一个订制类业务唯一对应一个订制命令字和一个退订命令字，退订服务不收费。

对同一种业务，如短信新闻，SP可同时提供点播和定制服务，两种服务资费标准不一样，这种情况下，SP需提供如下所示命令字与业务代码：

业务

命令字

业务代码

业务类型

退订命令字

资费

说明

新闻

DBXW

XW0001

点播

0.1元/条

新闻

DZXW

XW0002

订制

TDXW

5元/月

每天2条

B．订制通知短信

对于订制类业务，无论用户通过手机短信发起订制，还是在网上进行订制，订制关系都同时保存在SP管理系统和SP系统。

订制流程如下：

◆用户发起业务订制请求；

◆鉴权中心收到订制消息鉴权请求，生成预定购关系，向用户下发订制确认短信。

定制确认短信中应向用户明示下发条数和收费方式；

◆用户回复确认短信，鉴权中心将用户订制请求发给SP；

◆SP处理成功用户订制请求后，向用户下发订制通知短信；

◆鉴权中心根据SP的订制成功通知短信生成正式的用户订制记录，将通知短信下发给用户。

根据以上订制流程可知，最后的订制成功通知短信至关重要，是鉴权中心生成正式订制关系的依据，所以SP必须在用户订制成功后，及时下发订制成功通知短信。

订制类业务的计费以SP管理系统中的订制关系为准，如包月业务，SP定时下发包月计费短信，SP管理系统鉴权中心根据本地的订制关系对消息进行鉴权，鉴权失败的消息被拦截。

C．用户在SP网上社区注册或进行手机绑定

SP在网上提供的点播、定制服务，必须先使用户进行手机注册或绑定，注册或绑定成功后，下发密码通知短信给用户，用户使用注册密码登录网上社区后方能进行点播或定制业务，即SP必须先确定用户身份后才能提供服务。

使用手机进行网上社区注册或手机绑定时，为了SPMS端确认用户身份和进行密码通知短信的鉴权，要求SP对用户注册采用与业务点播一致的处理流程，即使用点播确认码的用户，参见接口5.6。

D．手机短信点播SP业务

用户使用手机短信点播SP业务，鉴权中心截获MO消息，生成唯一的LinkID，将LinkID加到SGIPDeliver包的Reserve字段后转发给SP，SP下发对应的MT消息时必须将这个LinkID带到Submit包的Reserve字段，鉴权中心根据LinkID对点播产生的MT消息进行鉴权，LinkID不能匹配的消息认为是非法消息而被拦截。

E．网上点播SP业务

为了SPMS端确认用户身份和进行点播消息进行鉴权，SP必须调用SPMS提供的点播调用接口机制，点播确认码由SPMS生成通过短信下发给网上点播的用户手机，参见接口5.6。

F．手机短信订制/退订业务

用户通过手机短信进行业务订制，采用确认短信的机制，由鉴权中心向用户下发确认短信，用户回复确认后，SPMS和SP系统处理订制订请求，SPMS和SP系统的用户订制关系保存同步。

用户通过手机短信进行业务退订，不采用确认短信机制。

鉴权中心收到退订业务请求后，将该用户的订制关系解除，然后将退订请求转发给SP，SP可向用户下发退订成功通知短信。

G．网上订制/退订SP业务

用户在网上订制业务，采用确认短信的方式，由鉴权中心向用户下发订制确认短信，用户回复后，SPMS和SP系统处理订制订请求，SPMS和SP系统的用户订制关系保存同步，参见接口5.5。

用户通过在网站上进行业务退订，不采用确认短信机制。

鉴权中心收到退订业务请求后，将该用户的订制关系解除，然后将退订请求转发给SP，SP可向用户下发退订成功通知短信。

H．用户订制业务短信的鉴权

用户订制成功SP业务后，SP根据业务规则向用户下发MT业务消息，鉴权中心根据该用户在SPMS端的订制关系对MT消息进行鉴权，订制关系不正确的MT消息将被拦截。

4.2.SP基本资料导入接口

◆发起方：

SP（一个SP一条记录）

◆接收方：

SPMS

◆接口协议：

FTP/HTTPFTP/EMAIL

◆接口形式：

XML文件

◆同步时间：

已经接入到联通在信的SP，可通过XML文件形式一次性将SP的基本信息同步给SP管理系统。

（SP也可不使用该接口，而直接登录SP管理系统的SP自服务门户，以手工录入的方法将SP基本信息提交给SP管理系统。

）

◆文件命名：

SPBI+5位SP企业代码+8位时间+4位序号.XML

如：

SPBI30165200401010001.XML

◆文件内容：

文件以XML格式存储，XML文件中所有字段的类型定义为String型，XML文件属性定义如下：

序号

字段名

最大长度

（字节）

字段含义

说明

CorpID

SP的企业代码

不能为空

SpNumber

SP的接入号码

不能为空,一个SP最多可有4个接入号，多接入号情况下以该字段值逗号分隔，如9771,9772,9773（目前只开放一个接入号）

ShortName

SP简称

不能为空

SpChName

100

SP中文名称

不能为空

SpEnName

100

SP英文名称

不能为空

CorpType

公司类型

不能为空

0-国营1-集体

2-民营3-私营

4-中外合资

5-外商独资

CreateDate

公司成立时间

不能为空，格式：

YYYY-MM-DD

StockFlag

是否上市

0-NO1-YES

ArtificialPerson

法人代表名

不能为空

ChiefOfficer

公司总经理/总裁名

不能为空

TotalMember

公司员工数

不能为空

RegisterFund

注册资金（元人民币）

不能为空

Introduction

120

SP介绍

不能为空

WebAddress

SP网站地址

可填空

ServiceDesc

120

SP主营业务介绍

不能为空

ProvinceCode

SP接入省份省代码

不能为空，参考6.1

AreaCode

SP接入城市

不能为空,参考6.2

TeleSvcLicense

电信信息服务许可证编号

可填空

TeleSvcLicensedBy

100

电信信息服务许可证颁发单位

可填空

License

营业执照号

不能为空

LicensedBy

100

主管登记机关

不能为空

DealInScope

120

业务经营范围

不能为空

BankName

SP开户银行

可填空

BankAccount

银行帐号

可填空

Address

公司地址

不能为空

ZipCode

邮编

不能为空

PhoneNum

SP公司电话

不能为空

FaxNum

SP传真号码

不能为空

DisputationNum

SP投诉电话

不能为空

EffectiveDate

合约起始时间

不能为空，格式：

YYYY-MM-DD

ExpireDate

合约终止时间

不能为空，格式：

YYYY-MM-DD

ChargeUser

负责人姓名

不能为空

ChargeUserDesc

负责人职务

不能为空

ChargeTelNumber

负责人固定电话

不能为空

ChargeMobilePhone

负责人移动电话

不能为空

ChargeEmail

负责人EMAIL

不能为空

ContactName

联系人姓名

不能为空

ContactUserDesc

联系人职务

不能为空

ContactTelNumber

联系人固定电话

不能为空

ContactMobilePhone

联系人移动电话

不能为空（必须为联通）

ContactEmail

联系人EMAIL

不能为空（必须如意邮箱，由联通分配）

RegisterDate

注册时间

不能为空，格式：

YYYY-MM-DD

AccesssDate

接入时间

不能为空，格式：

YYYY-MM-DD

XSD文件定义如下：

xmlversion="1.0"encoding="UTF-8"?

elementname="SPMS">

complexType>

sequence>

elementref="SpBasicInfo"maxOccurs="100000"/>

sequence>

complexType>

element>

elementname="SpBasicInfo">

complexType>

sequence>

elementref="CorpID"minOccurs="1"maxOccurs="1"/>

elementref="SpNumber"minOccurs="1"maxOccurs="1"/>

elementref="ShortName"minOccurs="1"maxOccurs="1"/>

elementref="SpChName"minOccurs="1"maxOccurs="1"/>

elementref="SpEnName"minOccurs="1"maxOccurs="1"/>

elementref="CorpType"minOccurs="1"maxOccurs="1"/>

elementref="CreateDate"minOccurs="1"maxOccurs="1"/>

elementref="StockFlag"minOccurs="1"maxOccurs="1"/>

elementref="ArtificialPerson"minOccurs="1"maxOccurs="1"/>

elementref="ChiefOfficer"minOccurs="1"maxOccurs="1"/>

elementref="TotalMember"minOccurs="1"maxOccurs="1"/>

elementref="RegisterFund"minOccurs="1"maxOccurs="1"/>

elementref="Introduction"minOccurs="1"maxOccurs="1"/>

elementref="WebAddress"minOccurs="0"maxOccurs="1"/>

elementref="ServiceDesc"minOccurs="1"maxOccurs="1"/>

elementref="ProvinceCode"minOccurs="1"maxOccurs="1"/>

elementref="AreaCode"minOccurs="0"maxOccurs="1"/>

elementref="TeleSvcLicense"minOccurs="0"maxOccurs="1"/>

elementref="TeleSvcLicensedBy"minOccurs="0"maxOccurs="1"/>

elementref="License"minOccurs="1"maxOccurs="1"/>

elementref="LicensedBy"minOccurs="1"maxOccurs="1"/>

elementref="DealInScope"minOccurs="1"maxOccurs="1"/>

elementref="BankName"minOccurs="0"maxOccurs="1"/>

elementref="BankAccount"minOccurs="0"maxOccurs="1"/>

elementref="Address"minOccurs="1"maxOccurs="1"/>

elementref="ZipCode"minOccurs="1"maxOccurs="1"/>

elementref="PhoneNum"minOccurs="1"maxOccurs="1"/>

elementref="FaxNum"minOccurs="1"maxOccurs="1"/>

elementref="DisputationNum"minOccurs="1"maxOccurs="1"/>

elementref="EffectiveDate"minOccurs="1"maxOccurs="1"/>

elementref="ExpireDate"minOccurs="1"maxOccurs="1"/>

elementref="ChargeUser"minOccurs="1"maxOccurs="1"/>

elementref="ChargeUserDesc"minOccurs="1"maxOccurs="1"/>

elementref="ChargeTelNumber"minOccurs="1"maxOccurs="1"/>

elementref="ChargeMobilePhone"minOccurs="1"maxOccurs="1"/>

elementref="ChargeEmail"minOccurs="1"maxOccurs="1"/>

elementref="ContactName"minOccurs="1"maxOccurs="1"/>

elementref="ContactUserDesc"minOccurs="1"maxOccurs="1"/>

elementref="ContactTelNumber"minOccurs="1"maxOccurs="1"/>

elementref="ContactMobilePhone"minOccurs="1"m

展开阅读全文