YD/T 2788-2015
基本信息
标准号： YD/T 2788-2015
中文名称：移动转售企业与基础电信企业互联业务接口技术要求
标准类别：通信行业标准(YD)
标准状态：现行
出版语种：简体中文
下载格式：.zip .pdf
标准分类号
关联标准
出版信息
相关单位信息
标准简介
YD/T 2788-2015.Technical requirements of the interface between mobile virtual network operator and mobile network operator.
1范围
YD/T 2788规定了移动转售企业与基础电信企业业务支撑系统之间互联互通采用的接口协议、消息格式以及处理程序等内容。
YD/T 2788适用于移动转售企业业务支撑系统与基础电信企业相关业务平台系统的互联接口。
2术语、定义和缩略语
2.1术语和定义
下列术语和定义适用于本文件:
移动转售 Mobile Virtual Network Operator
我国在《移动通信转售业务试点方案》(以下简称《试点方案》)中定义:移动通信转售业务是指从拥有移动网络的基础电信业务经营者购买移动通信服务，重新包装成自有品牌并销售给用户的移动通信服务。移动转售商不自建无线网、核心网、传输网等移动通信网络基础设施，应建立客服系统，可依据需要建立业务管理平台以及计费、营账等业务支撑系统。移动通信转售业务不包括卫星移动通信业务的转售。
2.2缩略语
下列缩略语适用于本文件:
CRM Customer Relationship Management 客户关系管理
CELL-ID CELL Identity 小区识别码
ICCID Integrate Circuit Card Identity 集成电路卡识别码
IMEI International Mobile Equipment Identity number 国际移动设备身份码
IMSI International Mobile Subscriber ldentity 国际移动用户识别码
LAC Location Area Code 位置区码
1范围
YD/T 2788规定了移动转售企业与基础电信企业业务支撑系统之间互联互通采用的接口协议、消息格式以及处理程序等内容。
YD/T 2788适用于移动转售企业业务支撑系统与基础电信企业相关业务平台系统的互联接口。
2术语、定义和缩略语
2.1术语和定义
下列术语和定义适用于本文件:
移动转售 Mobile Virtual Network Operator
我国在《移动通信转售业务试点方案》(以下简称《试点方案》)中定义:移动通信转售业务是指从拥有移动网络的基础电信业务经营者购买移动通信服务，重新包装成自有品牌并销售给用户的移动通信服务。移动转售商不自建无线网、核心网、传输网等移动通信网络基础设施，应建立客服系统，可依据需要建立业务管理平台以及计费、营账等业务支撑系统。移动通信转售业务不包括卫星移动通信业务的转售。
2.2缩略语
下列缩略语适用于本文件:
CRM Customer Relationship Management 客户关系管理
CELL-ID CELL Identity 小区识别码
ICCID Integrate Circuit Card Identity 集成电路卡识别码
IMEI International Mobile Equipment Identity number 国际移动设备身份码
IMSI International Mobile Subscriber ldentity 国际移动用户识别码
LAC Location Area Code 位置区码
标准图片预览
标准内容
ICS33.040.01
M10/29
中华人民共和国通信行业标准
YD/T2788-2015
移动转售企业与基础电信企业
互联业务接口技术要求
Technical reguirements of theinterface betweenmobilevirtualnetworkoperatorandmobilenetworkoperaton2015-04-30发布免费标准下载网bzxz
2015-04-30实施
中华人民共和国工业和信息化部发布前
2术语、定义和缩略语
3接口总体说明
4接口安全机制*
5实时业务接口消息·
6协议中各种ID号的用法：
实时业务接口流程·
8文件数据接口
9定时器定义及超时的处理要求·附录A（规范性附录）参数表
附录B（规范性附录）定时器：
附录C（资料性附录）SOAP消息示例目
附录D（规范性附录）SOAP消息命名与CommandCode对照表参考文献
YD/T2788-2015
YD/T2788-2015
本标准按照GB/T1.1-2009给出的规则起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本标准是移动转售企业与基础电信企业互联系列标准之一，该系列标准包括以下部分：一《移动转售企业与基础电信企业互联业务功能要求》一《移动转售企业与基础电信企业互联业务接口技术要求》一《移动转售企业与基础电信企业互连网关设备技术要求》一《移动转售业务监管平台功能要求》一《移动转售企业与基础电信企业互联业务功能测试规范》一《移动转售企业与基础电信企业互联业务接口测试规范》一《移动转售企业与基础电信企业互连网关设备测试规范》一《移动转售业务监管平台功能测试规范》随着移动转售业务的发展，还将制定后续相关标准。本标准由中国通信标准化协会提出并归口。本标准起草单位：工业和信息化部电信研究院、中国电信集团公司、中国移动通信集团公司、中国联合通信有限公司，北京分在线网络技术有限公司，远特（北京）通信技术有限公司，中期集团有限公司、浙江连连科技有限公司、话机世界数码连锁集团股份有限公司、长江时代通信股份有限公司、天音通信有限公司、苏州蜗牛数字科技股份有限公司、深圳爱施德股份有限公司、厦门三五互联科技股份有限公司、北京万网志成科技有限公司、北京乐语世纪通讯设备连锁有限公司、北京国美电器有限公司、北京迪信通通信服务有限公司、北京北纬通信科技股份有限公司、巴士在线控股有限公司、苏宁云商集团股份有限公司，北京华翔联信科技有限公司。本标准的主要起草人：龚双瑾、孟然、黄荷仙、王铸、史景烨、宁宇、程宇、徐鹏、孙晓丹、王崇鲁、李娜、沈彬。I
1范围
YD/T2788-2015
移动转售企业与基础电信企业互联业务接口技术要求本标准规定了移动转售企业与基础电信企业业务支撑系统之间互联互通采用的接口协议、消息格式以及处理程序等内容。
本标准适用于移动转售企业业务支撑系统与基础电信企业相关业务平台系统的互联接口。2术语、定义和缩略语
2.1术语和定义
下列术语和定义适用手本文件：移动转售MobileVirtualNetworkOperator我国在《移动通信转售业务试点方案》（以下简称《试点方案》）中定义：移动通信转售业务是指从拥有移动网络的基础电信业务经营者购买移动通信服务，重新包装成自有品牌并销售给用户的移动通信服务。移动转售商不自建无线网、核心网、传输网等移动通信网络基础设施，应建立客服系统，可依据需要建立业务管理平台以及计费、营账等业务支撑系统。移动通信转售业务不包括卫星移动通信业务的转售。
2.2缩略语
下列缩略语适用于本文件：
CELL-ID
MSISDN
CustomerRelationshipManagementCELLIdentity
Integrate Circuit Card IdentityInternational MobileEquipmentIdentitynumberInternational Mobile Subscriber IdentityLocation Area Code
MobileNetwork Operator
Mobile Station international ISDN numberMobile Station Roaming NumberMobileVirtualNetworkOperatorPersonal Identification NumberPersonal Unlock Key
Subscriber Identity Module
UMTS Subscriber Identity ModuleWireless Fidelity
客户关系管理
小区识别码
集成电路卡识别码
国际移动设备身份码
国际移动用户识别码
位置区码
移动基础运营商
移动台国际ISDN号码
移动台漫游号
移动虚拟运营商
SIM卡个人识别码
用户解锁码
用户身份模块
用于UMTS终端的身份模块
基于IEEE802.11b标准的无线局域网1
YD/T2788-2015
3接口总体说明
3.1接口网络架构
移动转售企业、基础电信企业与业务监管平台系统互联组网情况如图1所示。业务主管部门
业务监管平台
基础电信企业(0)
业务支
撑系统
/网元
图1移动转售互联组网示意图
如图1所示，移动转售企业与基础电信企业通过互联网关实现业务消息的接口传递。业务监管平台通过移动转售企业与基础电信企业的互联网关平台互联，实现业务监管消息数据的接口传递。互联网关具体要求如下：
1．移动转售企业同基础电信企业相关网元、系统和业务平台不直接进行对接，需通过双方互联网关平台进行互联。
2.互联网关平台实现业务运营、计费结算、服务保障、卡号资源的信息交互，互联网关平台与本企业内部系统、网元之间的数据信息交互方式由各企业自行确定。3.主管部门业务监管平台通过双方互联网关平台获取用户、业务相关数据，满足业务监管需求。3.2接口协议
移动转售企业与基础电信企业互联网关之间的接口包括实时调用接口和文件传送接口。移动转售企业与基础电信企业互联网关之间的实时接口采用SOAP1.2版本协议，通过HTTPS进行调用，以POST提交整个XML信息，字符集采用UTF-8。文件接口采用SFTP协议，通过二进制传输方式上传/下载文本。3.2.1实时接口协议框架
实时接口调用消息分为请求消息、应答消息。请求消息用于发送接口调用的请求参数，应答消息用于发送方和接收方之间进行应答结果返回，即接收方系统收到每一条请求类消息，都应返回一条应答消息，请求消息和应答消息为一一对应关系。接口调用方法包括两类参数，系统参数（TcpCont）和业务参数(SvcCont)，其中系统参数用于交互请求和应答的控制数据；业务参数用于交互请求、应答的业务数据。（1）请求消息
请求消息协议请求报文为XML格式。请求消息的内容包含MnoID、MvnoID、服务类型、消息命令码、交易流水、鉴权令牌，接口版本号、具体业务内容。详细见表1。2
元素名称
系统参数
TepCont
业务参数
SveCont
参数名称
MvnoID
ServiceType
CommandCode
MessageID
ReqTime
Version
（2）应答消息
字段类型
定长字符串
定长字符串
可变字符串
可变字符串
定长字符串
可变字符串
定长字符串
表1请求消息内容
字段长度
最大20位
最大25位
字段描述
基础企业标识，定义参见6.1节
转售企业标识，定义参见6.2节
YD/T2788-2015
是否必选
服务类型，见5.1节表5
标识本消息包的消息类型，见5.1节表5
唯一交易流水号，定义参见6.3节请求时间，格式
YYYYMMDDHHMMSS
鉴权令牌，见4.1
版本号，如V1.0
详细见5章各节请求参数定义
C（移动转售企
业调用基础企
业接口必填）
应答消息协议请求报文为XML格式。应答消息的内容包含交易流水、应答时间、应答类型、应答代码和应答描述，对于需要返回结果的应答还需包括具体的业务处理结果内容。详细见表2。表2应答消息内容
元素名称
系统参数
TepCont
业务参数
SveCont
参数名称
MessageID
RspTime
RspType
RspCode
RspDesc
3.2.2文件接口协议框架
字段类型
定长字符串
定长字符串
可变字符串
可变字符串
字段长度
最大512位
字段描述
唯一交易流水号，定义参见6.3节请求时间，格式
YYYYMMDDHHMMSS
会话应答类型，见附录A.6
会话应答代码，见附录A.6
应答描述
详细见5章各节返回参数定义
是否必选
M（返回结果类
应答必选）
基础运营企业为每个合作移动转售企业创建一个FTP账户，分配独立的用户名和密码，针对转售企业设置专门的访问目录。
下载文件目录命名：/FTPHOME/移动转售企业标识（MvnoID）/业务类型（编码）/DoWnload/files上传文件目录命名：/FTPHOME/移动转售企业标识（MvnoID）/业务类型（编码）/Upload/files每个转售企业的Download目录存放供移动转售企业下载的文件，具有读权限；Upload目录存放移动转售企业上载的文件，具有读写权限。业务类型用于区分不同类型的文件，业务类型编码及对应目录存放的文件类型见表3。3
YD/T2788-2015
业务类型编码
3.3接口调用方式
3.3.1实时调用接口
话单文件
表3业务类型编码
业务类型说明
卡号资源文件
局数据文件
语音话单
短信话单
MO话单
MT话单
数据话单
Wi-Fi话单
增值业务话单
存放文件类型
用户号码资源分配文件
IMSI资源分配文件
写卡数据文件
短消息中心文件
实时调用接口根据业务处理方式部分分为同步调用接口和异步调用接口。（1）同步接口
同步接口指接口被调用方互联网关接收调用请求后，内部系统立即处理请求报文中的业务要求。并向请求发起方互联网关返回业务处理结果。同步接口调用流程示例如图2所示。转售企业互联网关
请求调用
结果返回
基础企业互联网关
业务处理
图2同步接口调用流程示例
采用同步接口调用方式传递消息的包括：业务状态查询、网络状态查询、位置信息查询、业务影响通知。
（2）异步接口
异步接口指接口被调用方互联网关接收调用请求后，立刻反馈接收成功应答给请求发起方互联网关。应答后接口被调用方内部系统异步处理请求报文中的业务要求，完成后向请求发起方互联网关报峻业务处理结果。异步接口调用流程示例如图3所示。采用异步接口调用方式传递消息的包括：开户、销户、停复机、补换卡、远程写卡、业务变更、增值服务订购、位置信息服务开通、集团V网设置、申告处理、申告单撤销。3.3.2文件接口
转售企业互联网关
请求调用
接收响应
返回结果调用
接收到响应
基础企业互联网关
业务处理
图3异步接口调用流程示例
YD/T2788-2015
基础电信企业与移动转售企业之间通过文件接口实现文件上传、下载流程如图4所示。移动转售企业
互联网关（V)
文件接口流程说明：
定期下载文件
文件处理
文件上传
FTP服务器
基础企业
互联网关平台（0）
上传文件
>根据转售企业分发文件
》分发到不同目录
>文件下载
文件汇总
下载转售企业上传文件
文件下载
图4文件传递流程图
）文件处理
文件处理
1）互联网关平台（O）负责对提供给移动转售企业的文件进行统一格式转换，转换完成后把文件上传至FTP服务器。
2）移动转售企业互联网关平台（V）根据相关业务系统的需求，定期从FTP服务器约定目录获取文件，文件成功获取后主动删除文件。为了避免频繁连接，文件获取程序扫描间隔时间大于30秒。3）移动转售企业将需要向基础电信企业申请的文件资料上传至FTP服务器约定目录，基础电信企业相关业务系统通过互联网关平台（O）下载文件并处理。根据不同的文件类型，基础电信企业与移动转售企业之间文件生成存在不同的频率，具体见表4。YD/T2788-2015
文件类型
话单文件
卡号资源文件
局数据文件
4接口安全机制
表4文件传送要求
操作方式
转售企业下载
转售企业上传、下载
转售企业下载
文件传送要求
话单的采集周期依据话单类型而定由转售企业发起卡号资源申请，基础企业返回卡号资源分配结果
当局数据发生变化时，基础企业提供最新局数据文件或局数据变化文件
移动转售企业与基础电信企业互联网关之间互联需要安全认证机制，只有被授权的、通过鉴权认证的互联网关才进行相互之间的接口调用和文件互通。4.1接入安全控制
4.1.1访问控制
4.1.1.1IP地址鉴权
移动转售企业需要提前向基础电信企业提交调用系统IP地址列表以及IP范围。转售商企业系统每次接口调用时，基础电信企业互联网关平台会对移动转售企业调用请求进行IP地址验证。4.1.1.2数字证书鉴权
基础电信企业向移动转售企业颁发数字证书，移动转售企业调用基础电信企业互联网关接口时需要提供数字证书。数字证书认证与IP地址鉴权可任选其一。4.1.2权限控制
4.1.2.1API权限鉴权
基础电信企业互联网关对移动转售企业可调用的API进行授权控制。移动转售企业在每次调用API时，基础电信企业互联网关进行API权限鉴权。移动转售企业只能调用被授权使用的API。4.1.2.2数字密钥
基础电信企业为移动转售企业互联网关平台分配SecretKey，移动转售企业定期更新SecretKey。移动转售企业互联网关平台每次调用基础电信企业互联网网关平台同步/异步接口时，使用系统SecretKey进行鉴权。4.1.2.3鉴权令牌Token
移动转售企业互联网关平台需要用请求基础运营企业鉴权接口获得鉴权令牌，每次进行接口调用时将该令牌放在TcpCont/Token字段。4.1.2.4用户名、密码鉴权
移动转售企业互联网关平他调用基础电信企业互联网关平台文件接口时，需要向基础电信企业申请，基础电信企业分配用户名/密码，移动转售企业系统通过分配的用户名/密码进行文件的上传/下载操作。
4.2接口连接可靠性控制
移动转售企业与基础电信企业互联网关之间网络层应具备心跳机制检测网络状态。心跳中断期间应暂停发送消息，心跳恢复后自动重新发送所有未处理完成的消息。6
实时业务接口消息
业务接口消息见表5。
业务大类
业务子类
（Servicelype）
基本业务运营
Basic_Service
扩展业务运营
Extend_Service
补换卡
远程写卡
业务变更
用户业务状态查询
用户网络状态查询
增值服务正向订购
位置信息服务
位置信息查询
集团V网设置
表5业务接口消息列表
消息名称
开户请求
开户结果
销户请求
销户结果
停机请求
停机结果
开机请求
开机结果
补换卡请求
补换卡结果
远程写卡请求
制卡数据返回
业务变更请求
业务变更结果
业务状态查询请求
业务状态查询结果
网络状态查询请求
网络状态查询结果
单个/批量用户订购请求
单个/批量用户订购结果
个人/企业位置信息服务
开通/取消请求
个人/企业位置信息服务
开通/取消结果
个人/企业位置信息服务变
更请求
个人/企业位置信息服务变更
位置信息查询
位置信息查询结果
集团V网新增/删除请求
集团V网新增/删除结果
集团V网修改请求
集团V网修改结果
消息命令码
(CommandCode
RegisterAccount Req
RegisterAccount_Result
RemoveAccount Req
RemoveAccount_Result
SuspendAccount_Req
SuspendAccount_Result
ActiveAccount_Req
ActiveAccount Result
RemarkCard Req
RemarkCard_Result
RemoteCard_Req
RemoteCard_Result
ModifyService Req
ModifyService_Result
BussStatus_Query
BussStatus Result
NetStatus Query
NetStatus Result
VsaOrderFw_Req
M_VsaOrderFw_Req
VasOrderFw_Result
M_VsaOrderFw_Result
PositionServiceConf_Req
YD/T2788-2015
是香可选
E_PositionServiceConf Reg
PositionServiceConf_Result
E PositionServiceConf ResultPositionServiceModify_Req
E PositionServiceModify Req
PositionServiceModify_ResultE PositionServiceModify ResultPosition_Query
Position Result
VPNConf Req
VPNConf Result
ModifyVPNConf Req
ModifyVPNConf Result
YD/T2788-2015
业务大类
(ServiceType)
服务保障
Service_Assurance
5.1开户接口
业务子类
业务影响通知
申告处理
5.1.1开户请求（请求类消息）
表5（续）
消息名称
业务影响通知
业务恢复通知
申告单发送
申告单处理结果
申告单取消请求
申告单取消结果
开户指移动转售企业为用户办理入网的业务过程。消息命令码
(CommandCode)
AffectBuss_Notify
RecoverBuss _Notify
ClaimTicket_Commit
ClaimTicketResult
ClaimTicket Cancel
ClaimTicket_CancelResult
是否可选
开户请求接口支持移动转售企业（V）向基础电信企业（O），发送单个或批量用户开户请求，批量用户属于同一省份，批量开户的用户数量最大限制为20个。开户请求消息在流程中的使用见第7.1节。消息命令码：RegisterAccountReq：接口提供方：互联网关平台（O）：调用方式：互联网关平台（V）→互联网关平台（O）。接口消息内容见表6、7。
开户请求业务参数
字段名称
申请单号
所属省份
开户信息
字段名称
订单号
用户号码
IMSI号码
ICCID号
开通业务
订购套餐
字段简称
ApplyOrderID
ProvienceID
Registerlnfos
Remark
字段简称
OrderID
MSISDN
Services
Products
字段类型
定长字符串
定长字符串
可变字符串
字段长度
最大128
字段措述
申请单唯一标识，定义见第
省份定义见附录A.2
数组值为RegisterInfo结构，
定义见表7。
批量开户包括多条开户信息
表7开户信息（Registerlnfo）元素定义字段类型
定长字符串
定长字符串
定长字符串
定长字符串
字段长度
最大512位
最大512位
字段描述
订单唯一标识，定义见第6.5节
数组值为Service结构，定义见
附录A.3
数组值为Product结构，对象定
义见附录A.4
注1：套餐指经基础电信企业包装提供给移动转售企业选择的产品资源。5.1.2开户结果（请求类消息）
是否必选
（批量开户请求）
是否必选
基础电信企业完成用户开户后通过互联网关（O）返回开户结果。对于批量开户请求，可逐条、批量返回开户结果。开户结果告知消息在流程中的使用见第7.1节。8
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。
M10/29
中华人民共和国通信行业标准
YD/T2788-2015
移动转售企业与基础电信企业
互联业务接口技术要求
Technical reguirements of theinterface betweenmobilevirtualnetworkoperatorandmobilenetworkoperaton2015-04-30发布免费标准下载网bzxz
2015-04-30实施
中华人民共和国工业和信息化部发布前
2术语、定义和缩略语
3接口总体说明
4接口安全机制*
5实时业务接口消息·
6协议中各种ID号的用法：
实时业务接口流程·
8文件数据接口
9定时器定义及超时的处理要求·附录A（规范性附录）参数表
附录B（规范性附录）定时器：
附录C（资料性附录）SOAP消息示例目
附录D（规范性附录）SOAP消息命名与CommandCode对照表参考文献
YD/T2788-2015
YD/T2788-2015
本标准按照GB/T1.1-2009给出的规则起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本标准是移动转售企业与基础电信企业互联系列标准之一，该系列标准包括以下部分：一《移动转售企业与基础电信企业互联业务功能要求》一《移动转售企业与基础电信企业互联业务接口技术要求》一《移动转售企业与基础电信企业互连网关设备技术要求》一《移动转售业务监管平台功能要求》一《移动转售企业与基础电信企业互联业务功能测试规范》一《移动转售企业与基础电信企业互联业务接口测试规范》一《移动转售企业与基础电信企业互连网关设备测试规范》一《移动转售业务监管平台功能测试规范》随着移动转售业务的发展，还将制定后续相关标准。本标准由中国通信标准化协会提出并归口。本标准起草单位：工业和信息化部电信研究院、中国电信集团公司、中国移动通信集团公司、中国联合通信有限公司，北京分在线网络技术有限公司，远特（北京）通信技术有限公司，中期集团有限公司、浙江连连科技有限公司、话机世界数码连锁集团股份有限公司、长江时代通信股份有限公司、天音通信有限公司、苏州蜗牛数字科技股份有限公司、深圳爱施德股份有限公司、厦门三五互联科技股份有限公司、北京万网志成科技有限公司、北京乐语世纪通讯设备连锁有限公司、北京国美电器有限公司、北京迪信通通信服务有限公司、北京北纬通信科技股份有限公司、巴士在线控股有限公司、苏宁云商集团股份有限公司，北京华翔联信科技有限公司。本标准的主要起草人：龚双瑾、孟然、黄荷仙、王铸、史景烨、宁宇、程宇、徐鹏、孙晓丹、王崇鲁、李娜、沈彬。I
1范围
YD/T2788-2015
移动转售企业与基础电信企业互联业务接口技术要求本标准规定了移动转售企业与基础电信企业业务支撑系统之间互联互通采用的接口协议、消息格式以及处理程序等内容。
本标准适用于移动转售企业业务支撑系统与基础电信企业相关业务平台系统的互联接口。2术语、定义和缩略语
2.1术语和定义
下列术语和定义适用手本文件：移动转售MobileVirtualNetworkOperator我国在《移动通信转售业务试点方案》（以下简称《试点方案》）中定义：移动通信转售业务是指从拥有移动网络的基础电信业务经营者购买移动通信服务，重新包装成自有品牌并销售给用户的移动通信服务。移动转售商不自建无线网、核心网、传输网等移动通信网络基础设施，应建立客服系统，可依据需要建立业务管理平台以及计费、营账等业务支撑系统。移动通信转售业务不包括卫星移动通信业务的转售。
2.2缩略语
下列缩略语适用于本文件：
CELL-ID
MSISDN
CustomerRelationshipManagementCELLIdentity
Integrate Circuit Card IdentityInternational MobileEquipmentIdentitynumberInternational Mobile Subscriber IdentityLocation Area Code
MobileNetwork Operator
Mobile Station international ISDN numberMobile Station Roaming NumberMobileVirtualNetworkOperatorPersonal Identification NumberPersonal Unlock Key
Subscriber Identity Module
UMTS Subscriber Identity ModuleWireless Fidelity
客户关系管理
小区识别码
集成电路卡识别码
国际移动设备身份码
国际移动用户识别码
位置区码
移动基础运营商
移动台国际ISDN号码
移动台漫游号
移动虚拟运营商
SIM卡个人识别码
用户解锁码
用户身份模块
用于UMTS终端的身份模块
基于IEEE802.11b标准的无线局域网1
YD/T2788-2015
3接口总体说明
3.1接口网络架构
移动转售企业、基础电信企业与业务监管平台系统互联组网情况如图1所示。业务主管部门
业务监管平台
基础电信企业(0)
业务支
撑系统
/网元
图1移动转售互联组网示意图
如图1所示，移动转售企业与基础电信企业通过互联网关实现业务消息的接口传递。业务监管平台通过移动转售企业与基础电信企业的互联网关平台互联，实现业务监管消息数据的接口传递。互联网关具体要求如下：
1．移动转售企业同基础电信企业相关网元、系统和业务平台不直接进行对接，需通过双方互联网关平台进行互联。
2.互联网关平台实现业务运营、计费结算、服务保障、卡号资源的信息交互，互联网关平台与本企业内部系统、网元之间的数据信息交互方式由各企业自行确定。3.主管部门业务监管平台通过双方互联网关平台获取用户、业务相关数据，满足业务监管需求。3.2接口协议
移动转售企业与基础电信企业互联网关之间的接口包括实时调用接口和文件传送接口。移动转售企业与基础电信企业互联网关之间的实时接口采用SOAP1.2版本协议，通过HTTPS进行调用，以POST提交整个XML信息，字符集采用UTF-8。文件接口采用SFTP协议，通过二进制传输方式上传/下载文本。3.2.1实时接口协议框架
实时接口调用消息分为请求消息、应答消息。请求消息用于发送接口调用的请求参数，应答消息用于发送方和接收方之间进行应答结果返回，即接收方系统收到每一条请求类消息，都应返回一条应答消息，请求消息和应答消息为一一对应关系。接口调用方法包括两类参数，系统参数（TcpCont）和业务参数(SvcCont)，其中系统参数用于交互请求和应答的控制数据；业务参数用于交互请求、应答的业务数据。（1）请求消息
请求消息协议请求报文为XML格式。请求消息的内容包含MnoID、MvnoID、服务类型、消息命令码、交易流水、鉴权令牌，接口版本号、具体业务内容。详细见表1。2
元素名称
系统参数
TepCont
业务参数
SveCont
参数名称
MvnoID
ServiceType
CommandCode
MessageID
ReqTime
Version
（2）应答消息
字段类型
定长字符串
定长字符串
可变字符串
可变字符串
定长字符串
可变字符串
定长字符串
表1请求消息内容
字段长度
最大20位
最大25位
字段描述
基础企业标识，定义参见6.1节
转售企业标识，定义参见6.2节
YD/T2788-2015
是否必选
服务类型，见5.1节表5
标识本消息包的消息类型，见5.1节表5
唯一交易流水号，定义参见6.3节请求时间，格式
YYYYMMDDHHMMSS
鉴权令牌，见4.1
版本号，如V1.0
详细见5章各节请求参数定义
C（移动转售企
业调用基础企
业接口必填）
应答消息协议请求报文为XML格式。应答消息的内容包含交易流水、应答时间、应答类型、应答代码和应答描述，对于需要返回结果的应答还需包括具体的业务处理结果内容。详细见表2。表2应答消息内容
元素名称
系统参数
TepCont
业务参数
SveCont
参数名称
MessageID
RspTime
RspType
RspCode
RspDesc
3.2.2文件接口协议框架
字段类型
定长字符串
定长字符串
可变字符串
可变字符串
字段长度
最大512位
字段描述
唯一交易流水号，定义参见6.3节请求时间，格式
YYYYMMDDHHMMSS
会话应答类型，见附录A.6
会话应答代码，见附录A.6
应答描述
详细见5章各节返回参数定义
是否必选
M（返回结果类
应答必选）
基础运营企业为每个合作移动转售企业创建一个FTP账户，分配独立的用户名和密码，针对转售企业设置专门的访问目录。
下载文件目录命名：/FTPHOME/移动转售企业标识（MvnoID）/业务类型（编码）/DoWnload/files上传文件目录命名：/FTPHOME/移动转售企业标识（MvnoID）/业务类型（编码）/Upload/files每个转售企业的Download目录存放供移动转售企业下载的文件，具有读权限；Upload目录存放移动转售企业上载的文件，具有读写权限。业务类型用于区分不同类型的文件，业务类型编码及对应目录存放的文件类型见表3。3
YD/T2788-2015
业务类型编码
3.3接口调用方式
3.3.1实时调用接口
话单文件
表3业务类型编码
业务类型说明
卡号资源文件
局数据文件
语音话单
短信话单
MO话单
MT话单
数据话单
Wi-Fi话单
增值业务话单
存放文件类型
用户号码资源分配文件
IMSI资源分配文件
写卡数据文件
短消息中心文件
实时调用接口根据业务处理方式部分分为同步调用接口和异步调用接口。（1）同步接口
同步接口指接口被调用方互联网关接收调用请求后，内部系统立即处理请求报文中的业务要求。并向请求发起方互联网关返回业务处理结果。同步接口调用流程示例如图2所示。转售企业互联网关
请求调用
结果返回
基础企业互联网关
业务处理
图2同步接口调用流程示例
采用同步接口调用方式传递消息的包括：业务状态查询、网络状态查询、位置信息查询、业务影响通知。
（2）异步接口
异步接口指接口被调用方互联网关接收调用请求后，立刻反馈接收成功应答给请求发起方互联网关。应答后接口被调用方内部系统异步处理请求报文中的业务要求，完成后向请求发起方互联网关报峻业务处理结果。异步接口调用流程示例如图3所示。采用异步接口调用方式传递消息的包括：开户、销户、停复机、补换卡、远程写卡、业务变更、增值服务订购、位置信息服务开通、集团V网设置、申告处理、申告单撤销。3.3.2文件接口
转售企业互联网关
请求调用
接收响应
返回结果调用
接收到响应
基础企业互联网关
业务处理
图3异步接口调用流程示例
YD/T2788-2015
基础电信企业与移动转售企业之间通过文件接口实现文件上传、下载流程如图4所示。移动转售企业
互联网关（V)
文件接口流程说明：
定期下载文件
文件处理
文件上传
FTP服务器
基础企业
互联网关平台（0）
上传文件
>根据转售企业分发文件
》分发到不同目录
>文件下载
文件汇总
下载转售企业上传文件
文件下载
图4文件传递流程图
）文件处理
文件处理
1）互联网关平台（O）负责对提供给移动转售企业的文件进行统一格式转换，转换完成后把文件上传至FTP服务器。
2）移动转售企业互联网关平台（V）根据相关业务系统的需求，定期从FTP服务器约定目录获取文件，文件成功获取后主动删除文件。为了避免频繁连接，文件获取程序扫描间隔时间大于30秒。3）移动转售企业将需要向基础电信企业申请的文件资料上传至FTP服务器约定目录，基础电信企业相关业务系统通过互联网关平台（O）下载文件并处理。根据不同的文件类型，基础电信企业与移动转售企业之间文件生成存在不同的频率，具体见表4。YD/T2788-2015
文件类型
话单文件
卡号资源文件
局数据文件
4接口安全机制
表4文件传送要求
操作方式
转售企业下载
转售企业上传、下载
转售企业下载
文件传送要求
话单的采集周期依据话单类型而定由转售企业发起卡号资源申请，基础企业返回卡号资源分配结果
当局数据发生变化时，基础企业提供最新局数据文件或局数据变化文件
移动转售企业与基础电信企业互联网关之间互联需要安全认证机制，只有被授权的、通过鉴权认证的互联网关才进行相互之间的接口调用和文件互通。4.1接入安全控制
4.1.1访问控制
4.1.1.1IP地址鉴权
移动转售企业需要提前向基础电信企业提交调用系统IP地址列表以及IP范围。转售商企业系统每次接口调用时，基础电信企业互联网关平台会对移动转售企业调用请求进行IP地址验证。4.1.1.2数字证书鉴权
基础电信企业向移动转售企业颁发数字证书，移动转售企业调用基础电信企业互联网关接口时需要提供数字证书。数字证书认证与IP地址鉴权可任选其一。4.1.2权限控制
4.1.2.1API权限鉴权
基础电信企业互联网关对移动转售企业可调用的API进行授权控制。移动转售企业在每次调用API时，基础电信企业互联网关进行API权限鉴权。移动转售企业只能调用被授权使用的API。4.1.2.2数字密钥
基础电信企业为移动转售企业互联网关平台分配SecretKey，移动转售企业定期更新SecretKey。移动转售企业互联网关平台每次调用基础电信企业互联网网关平台同步/异步接口时，使用系统SecretKey进行鉴权。4.1.2.3鉴权令牌Token
移动转售企业互联网关平台需要用请求基础运营企业鉴权接口获得鉴权令牌，每次进行接口调用时将该令牌放在TcpCont/Token字段。4.1.2.4用户名、密码鉴权
移动转售企业互联网关平他调用基础电信企业互联网关平台文件接口时，需要向基础电信企业申请，基础电信企业分配用户名/密码，移动转售企业系统通过分配的用户名/密码进行文件的上传/下载操作。
4.2接口连接可靠性控制
移动转售企业与基础电信企业互联网关之间网络层应具备心跳机制检测网络状态。心跳中断期间应暂停发送消息，心跳恢复后自动重新发送所有未处理完成的消息。6
实时业务接口消息
业务接口消息见表5。
业务大类
业务子类
（Servicelype）
基本业务运营
Basic_Service
扩展业务运营
Extend_Service
补换卡
远程写卡
业务变更
用户业务状态查询
用户网络状态查询
增值服务正向订购
位置信息服务
位置信息查询
集团V网设置
表5业务接口消息列表
消息名称
开户请求
开户结果
销户请求
销户结果
停机请求
停机结果
开机请求
开机结果
补换卡请求
补换卡结果
远程写卡请求
制卡数据返回
业务变更请求
业务变更结果
业务状态查询请求
业务状态查询结果
网络状态查询请求
网络状态查询结果
单个/批量用户订购请求
单个/批量用户订购结果
个人/企业位置信息服务
开通/取消请求
个人/企业位置信息服务
开通/取消结果
个人/企业位置信息服务变
更请求
个人/企业位置信息服务变更
位置信息查询
位置信息查询结果
集团V网新增/删除请求
集团V网新增/删除结果
集团V网修改请求
集团V网修改结果
消息命令码
(CommandCode
RegisterAccount Req
RegisterAccount_Result
RemoveAccount Req
RemoveAccount_Result
SuspendAccount_Req
SuspendAccount_Result
ActiveAccount_Req
ActiveAccount Result
RemarkCard Req
RemarkCard_Result
RemoteCard_Req
RemoteCard_Result
ModifyService Req
ModifyService_Result
BussStatus_Query
BussStatus Result
NetStatus Query
NetStatus Result
VsaOrderFw_Req
M_VsaOrderFw_Req
VasOrderFw_Result
M_VsaOrderFw_Result
PositionServiceConf_Req
YD/T2788-2015
是香可选
E_PositionServiceConf Reg
PositionServiceConf_Result
E PositionServiceConf ResultPositionServiceModify_Req
E PositionServiceModify Req
PositionServiceModify_ResultE PositionServiceModify ResultPosition_Query
Position Result
VPNConf Req
VPNConf Result
ModifyVPNConf Req
ModifyVPNConf Result
YD/T2788-2015
业务大类
(ServiceType)
服务保障
Service_Assurance
5.1开户接口
业务子类
业务影响通知
申告处理
5.1.1开户请求（请求类消息）
表5（续）
消息名称
业务影响通知
业务恢复通知
申告单发送
申告单处理结果
申告单取消请求
申告单取消结果
开户指移动转售企业为用户办理入网的业务过程。消息命令码
(CommandCode)
AffectBuss_Notify
RecoverBuss _Notify
ClaimTicket_Commit
ClaimTicketResult
ClaimTicket Cancel
ClaimTicket_CancelResult
是否可选
开户请求接口支持移动转售企业（V）向基础电信企业（O），发送单个或批量用户开户请求，批量用户属于同一省份，批量开户的用户数量最大限制为20个。开户请求消息在流程中的使用见第7.1节。消息命令码：RegisterAccountReq：接口提供方：互联网关平台（O）：调用方式：互联网关平台（V）→互联网关平台（O）。接口消息内容见表6、7。
开户请求业务参数
字段名称
申请单号
所属省份
开户信息
字段名称
订单号
用户号码
IMSI号码
ICCID号
开通业务
订购套餐
字段简称
ApplyOrderID
ProvienceID
Registerlnfos
Remark
字段简称
OrderID
MSISDN
Services
Products
字段类型
定长字符串
定长字符串
可变字符串
字段长度
最大128
字段措述
申请单唯一标识，定义见第
省份定义见附录A.2
数组值为RegisterInfo结构，
定义见表7。
批量开户包括多条开户信息
表7开户信息（Registerlnfo）元素定义字段类型
定长字符串
定长字符串
定长字符串
定长字符串
字段长度
最大512位
最大512位
字段描述
订单唯一标识，定义见第6.5节
数组值为Service结构，定义见
附录A.3
数组值为Product结构，对象定
义见附录A.4
注1：套餐指经基础电信企业包装提供给移动转售企业选择的产品资源。5.1.2开户结果（请求类消息）
是否必选
（批量开户请求）
是否必选
基础电信企业完成用户开户后通过互联网关（O）返回开户结果。对于批量开户请求，可逐条、批量返回开户结果。开户结果告知消息在流程中的使用见第7.1节。8
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。