联通在信业务开发规范.docx

联通在信业务开发规范

V1.1

中国联合通信公司
2005年4月2日

目 录

1. 保密说明 3
1.1. 保密原则 3
1.2. 保密内容 3
2. 总则 4
2.1. 背景 4
2.2. 文档内容 4
2.3. 适用范围 4
2.4. 解释权与修订权 5
2.5. 术语与缩略语 5
2.6. 参考文献 5
3. 修改说明 6
4. 系统边界和接口设计 7
4.1. 系统边界 7
4.2. 接口原则 7
4.3. 接口约束 8
5. 与SP的接口 8
5.1. SP接入规范 8
5.1.1 SP及业务资料导入规范 8
5.1.2 SP业务接入规范 10
5.2. SP基本资料同步接口 12
5.3. SP业务资料同步接口 14
5.4. 用户业务定购资料同步接口 16
5.5. SP业务定购WEB调用接口 17
5.6. SP业务点播用户确认接口 一八

1. 保密说明
1.1. 保密原则
本资料所有权属于中国联合通信有限公司，任何其他公司、个人无论以任何形式获取了本资料，在使用本资料都应遵守以下保密原则：
1) 在未经中国联合通信有限公司授权许可下，不得以任何形式使用本资料；
2) 不得传播本资料信息；
3) 不得恶意复制、散发本资料。
4) 但是不限制合作公司或个人在双方协议基础上，即中国联合通信有限公司授权许可下，正常的使用本资料，包括在授权许可下，在公司内部其他部门阅取、复制、使用本资料信息，或者是和第三方公司、个人共同享用本资料信息。
1.2. 保密内容
本资料的保密内容包括：
1) 在双方协议的基础上，中国联合通信有限公司提供的资料，包括在正式场合下提供的资料，以及在特定场合下提供的正式和非正式资料和信息；
2) 在中国联合通信有限公司许可下，从中国联合通信有限公司获取的资料和信息；
3) 从其他途径获取，但未经中国联合通信有限公司授权许可的本资料信息。

本资料的保密内容不包括：
1) 中国联合通信有限公司已经公开或者即将公开的资料信息；
2) 经中国联合通信有限公司授权许可后，可以传播的资料信息；
3) 在未知本资料信息的情况，自主开发的信息；
4) 在接受本协议前已经获取的信息。

2. 总则
2.1. 背景
目前联通在信网络及SP在信业务管理平台基本运行正常，业务发展前景良好，各服务提供商和内容提供商经过一段时间的整合，业务已经开始大幅回升。现在联通业务进一步好转，新增SP/CP越来越多，为了更好的服务各SP/CP,对全国性联通在信业务部分流程进行优化，实现对SP的有效管理，提高用户服务质量，促进联通在信的良性发展。

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

2.3. 适用范围
本文主要用于中国联合通信有限公司全国性联通在信业务SP管理系统的建设与管理。用于指导联通总部、分公司和联通在信业务提供商业务建设的研制、开发和实施。本文适用于SP/CP、SPMS系统建设厂家和联通公司的管理及技术人员等。

2.4. 解释权与修订权
本文由中国联通制定、审核并发布，起草单位为中国联通增值业务部。
本文将根据市场发展需要适时进行修改，其修改权和解释权属于中国联通增值业务部。

2.5. 术语与缩略语
缩略语
全称
说明
SP
Service Provider
业务提供者
SMG
Short Message Gateway
短消息网关
SMSC
Short Message Service Center
短消息中心
SMPP
Short Message Peer to Peer
短消息点对点协议
SGIP
Short message Gateway Interface Protocol
短消息网关接口协议
MO
Mobile Original
移动用户发送短消息
MT
Mobile Terminal
移动用户接收短消息
SPSMG
SP SMG
联通在信全国性SP集中网关

2.6. 参考文献
n 《短消息业务联网协议1.2版》
n 《短消息业务联网规范1.2版》
n 《点对点短消息协议 SMPP3.4》
n 《中国联通SP管理系统业务鉴权协议》
n 《中国联合通信有限公司全国性联通在信业务SP管理系统外部接口规范》

3. 修改说明
序号
版本号
修改人
修改日期
修改内容

4. 接口设计
4.1. 接口原则
为了保证SPMS系统与其它相关系统方便、可靠地通过接口进行数据交换与业务处理，接口规范应满足如下原则：
Ø 接口具有普遍的适应性；
Ø 使用简单、快捷的方式实现SPMS与其它相关系统的接口；
Ø 接口应充分考虑SPMS与其它相关系统的应用扩展情况；
Ø 保证接口数据在SPMS与其它相关系统的一致性；
Ø 接口数据能够方便的形成，并能在被接口方顺利地导入；
Ø 在接口数据交互过程中，应具有数据传送和接收传送后的确认过程；
Ø 在满足功能要求的前提下，使接口数据量最少；
Ø 接口数据传输控制策略可靠且完善；
Ø 具有可靠的接口数据出错处理机制。

4.2. 接口约束
n XML文件中，编码方式为UTF-8；
n FTP传输ASCII文件时，编码方式为GB-2312；

5. SP资料导入接口
5.1. SP接入规范
5.1.1 SP及业务资料导入规范
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.2 SP业务接入规范
接入到“联通在信”平台的SP，可向用户提供基于短信的点播和定制服务，不得随意向用户发送广告信息，业务接入必须遵循如下规范：
u 所有业务的接入均需通过联通的审批，SP必须向联通提供正确的业务点播/定制/退订命令字、业务代码、资费信息、操作说明等信息，业务测试及审批通过后方可向用户提供服务。
u SP需遵守国家法律，不得提供任何反动、色情、封建、迷信等内容的服务，一旦违例将被吊销服务资格并追究法律责任。
u SP不得随意向用户发送广告或其它形式的垃圾短信，不得进行大规模的短信群发，违例将被降低信用等级，严重违例的SP将被注销其服务资格。
u SP可通过短信点播/定制的方式或网上点播/定制的方式向用户提供服务。
u SP提供的任何定制服务，必须向用户同时提供明确的退订界面，方便用户进行业务退订，不提供退订功能的业务不能接入到“联通在信”平台。
u SP在网上提供的点播、定制服务，必须先使用户进行手机注册或绑定，注册或绑定成功后，下发密码通知短信给用户，用户使用注册密码登录网上社区后方能进行点播或定制业务，即SP必须先确定用户身份后才能提供服务。

A．命令字与业务代码的关系
命令字与业务代码由SP自行制定，在一个SP内，业务代码是唯一的，一个点播类业务唯一对应一个点播命令字，一个订制类业务唯一对应一个订制命令字和一个退订命令字，退订服务不收费。
对同一种业务，如短信新闻，SP可同时提供点播和定制服务，两种服务资费标准不一样，这种情况下，SP需提供如下所示命令字与业务代码：
业务
命令字
业务代码
业务类型
退订命令字
资费
说明
新闻
DBXW
XW0001
点播

0.1元/条

新闻
DZXW
XW0002
订制
TDXW
5元/月
每天2条
B．订制通知短信
对于订制类业务，无论用户通过手机短信发起订制，还是在网上进行订制，订制关系都同时保存在SP管理系统和SP系统。订制流程如下：
u 用户发起业务订制请求；
u 鉴权中心收到订制消息鉴权请求，生成预定购关系，向用户下发订制确认短信，用户回复确认短信，鉴权中心将用户订制请求发给SP；
u SP处理成功用户订制请求后，向用户下发订制通知短信；
u 鉴权中心根据SP的订制成功通知短信生成正式的用户订制记录，将通知短信下发给用户。
根据以上订制流程可知，最后的订制成功通知短信至关重要，是鉴权中心生成正式订制关系的依据，所以SP必须在用户订制成功后，及时下发订制成功通知短信。
订制类业务的计费以SP管理系统中的订制关系为准，如包月业务，SP定时下发包月计费短信，SP管理系统鉴权中心根据本地的订制关系对消息进行鉴权，鉴权失败的消息被拦截。
C．用户在SP网上社区注册或进行手机绑定
SP在网上提供的点播、定制服务，必须先使用户进行手机注册或绑定，注册或绑定成功后，下发密码通知短信给用户，用户使用注册密码登录网上社区后方能进行点播或定制业务，即SP必须先确定用户身份后才能提供服务。
使用手机进行网上社区注册或手机绑定时，为了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端确认用户身份和进行点播消息进行鉴权，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消息将被拦截。

5.2. SP基本资料导入接口
u 发起方：SP(一个SP一条记录)
u 接收方：SPMS
u 接口协议：FTP/HTTP FTP/EMAIL
u 接口形式：XML文件
u 同步时间：已经接入到联通在信的SP，可通过XML文件形式一次性将SP的基本信息同步给SP管理系统。（SP也可不使用该接口，而直接登录SP管理系统的SP自服务门户，以手工录入的方法将SP基本信息提交给SP管理系统。）
u 文件命名：SPBI + 5位SP企业代码 + 8位时间 + 4位序号.XML
如：SPBI30165200401010001.XML
u 文件内容：文件以XML格式存储，XML文件中所有字段的类型定义为String型，XML文件属性定义如下：
序号
字段名
最大长度
（字节）
字段含义
说明
1
CorpID
10
SP的企业代码
不能为空
2
SpNumber
21
SP的接入号码
不能为空, 一个SP最多可有4个接入号，多接入号情况下以该字段值逗号分隔，如9771,9772,9773（目前只开放一个接入号）
3
ShortName
32
SP简称
不能为空
4
SpChName
100
SP中文名称
不能为空
5
SpEnName
100
SP英文名称
不能为空
6
CorpType
2
公司类型
不能为空
0-国营 1-集体
2-民营 3-私营
4-中外合资
5-外商独资
7
CreateDate
10
公司成立时间
不能为空，格式：
YYYY-MM-DD
8
StockFlag
2
是否上市
0-NO 1-YES
9
ArtificialPerson
32
法人代表名
不能为空
10
ChiefOfficer
32
公司总经理/总裁名
不能为空
11
TotalMember
10
公司员工数
不能为空
12
RegisterFund
10
注册资金（元人民币）
不能为空
一三
Introduction
120
SP介绍
不能为空
14
WebAddress
80
SP网站地址
可填空
一五
ServiceDesc
120
SP主营业务介绍
不能为空
16
ProvinceCode
3
SP接入省份省代码
不能为空，参考6.1
17
AreaCode
32
SP接入城市
不能为空,参考6.2
一八
TeleSvcLicense
64
电信信息服务许可证编号
可填空
19
TeleSvcLicensedBy
100
电信信息服务许可证颁发单位
可填空
20
License
64
营业执照号
不能为空
21
LicensedBy
100
主管登记机关
不能为空
22
DealInScope
120
业务经营范围
不能为空
23
BankName
64
SP开户银行
可填空
24
BankAccount
32
银行帐号
可填空
25
Address
64
公司地址
不能为空
26
ZipCode
10
邮编
不能为空
27
PhoneNum
20
SP公司电话
不能为空
28
FaxNum
20
SP传真号码
不能为空
29
DisputationNum
20
SP投诉电话
不能为空
30
EffectiveDate
10
合约起始时间
不能为空，格式：
YYYY-MM-DD
31
ExpireDate
10
合约终止时间
不能为空，格式：
YYYY-MM-DD
32
ChargeUser
16
负责人姓名
不能为空
33
ChargeUserDesc
32
负责人职务
不能为空
34
ChargeTelNumber
20
负责人固定电话
不能为空
35
ChargeMobilePhone
20
负责人移动电话
不能为空
36
ChargeEmail
80
负责人EMAIL
不能为空
37
ContactName
16
联系人姓名
不能为空
38
ContactUserDesc
32
联系人职务
不能为空
39
ContactTelNumber
20
联系人固定电话
不能为空
40
ContactMobilePhone
20
联系人移动电话
不能为空（必须为联通）
41
ContactEmail
80
联系人EMAIL
不能为空（必须如意邮箱，由联通分配）
42
RegisterDate
10
注册时间
不能为空，格式：
YYYY-MM-DD
43
AccesssDate
10
接入时间
不能为空，格式：
YYYY-MM-DD

XSD文件定义如下：

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

inOccurs="1" maxOccurs="1" />

ent ref="ZipCode" minOccurs="1" maxOccurs="1" />

rs="1" />

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

rs="1" maxOccurs="1" />

e="MDNType">

/>

name="SpEnName" type="xs:string">

ent>

"xs:string">

me="TeleSvcLicensedBy" type="xs:string">

>

ment>

ype="xs:string">

s:element name="ContactUserDesc" type="xs:string">

type="timeType">

5.3. SP业务资料同步接口
u 发起方：SP
u 接收方：SPMS
u 接口协议：FTP/EMAIL
u 接口形式：文本文件
u 同步时间：已经接入到联通在信的SP，需通过文件形式将SP已开通的业务信息同步给SP管理系统，SP管理系统根据已接入的业务资料对MO/MT消息进行鉴权。
u 文件命名：SPST ＋ 5位SP企业代码 + 8位时间 + 4位序号.TXT
如：SPST30165200401010001.TXT
u 文件内容：文件采用ASCII文本格式，文件体中一行作为一条记录，每一条记录代表sp的一个业务，记录的属性值按顺序排列，各属性间使用‘\t’分隔。各条记录之间用换行符作为分隔。
序号
字段名
最大长度
（字节）
字段含义
说明
1
SpNumber
21
SP的接入号码
不能为空
2
ServiceType
12
业务代码
不能填空
3
ServiceTag
12
业务代码对应的命令字
不能填空
定制业务命令字与业务代码之间一一对应。
点播业务填写点播的命令字（若某个业务代码下，