中国联通电子渠道MINI电子营业厅终端接口技术规范V1.0.doc
- 文档编号:7394653
- 上传时间:2023-05-11
- 格式:DOC
- 页数:41
- 大小:936KB
中国联通电子渠道MINI电子营业厅终端接口技术规范V1.0.doc
《中国联通电子渠道MINI电子营业厅终端接口技术规范V1.0.doc》由会员分享,可在线阅读,更多相关《中国联通电子渠道MINI电子营业厅终端接口技术规范V1.0.doc(41页珍藏版)》请在冰点文库上搜索。
中国联通公司发布
2010-12-22实施
2010-12-22发布
中国联通电子渠道MINI电子营业厅终端接口技术规范
ChinaUnicomElectronicChannelTerminalInterfaceSpecificationofMiniElectronicBusinessHallPlatform
(V1.0)
QB/CU168-2010
中国联通公司企业标准
中国联通电子渠道Mini电子营业厅平台终端接口技术规范
目录
前言 II
1范围 1
2规范性引用文件 1
3缩略语 1
4Mini电子营业厅系统概述 1
4.1Mini电子营业厅系统概述 1
4.2Mini电子营业厅平台概述 1
4.3Mini电子营业厅终端概述 2
5接口位置 2
6接口要求 2
6.1通信协议数据交互方式 2
6.2通信协议数据传输方式 3
6.2.1通信接口 3
6.2.2TCP/IP协议通信 3
6.2.3MODEM短消息通信 3
6.3通信业务交互流程 4
6.4通信异常处理 5
6.4.1接收超时异常处理 5
6.4.2扣款类的交易流程 5
6.4.3扣款交易异常原因 6
6.4.4扣款类交易异常处理 7
6.5数据安全传输协议 7
6.5.1终端加密基本说明 7
6.5.2数据传输加密原则 7
6.5.3终端接入鉴权 8
6.6接口报文协议 8
6.6.1物理通信标识协议约定 8
6.6.2通信定时器 8
6.6.3通信报文协议 8
6.6.3.1基本说明 8
6.6.3.2协议格式 9
6.6.3.3基本协议框架 9
6.6.3.4命令体单元组成 13
6.6.3.5传输算法约定 14
6.6.3.6命令标识与业务数据单元 15
6.6.3.7命令单元列表 20
附 录 1业务层接收定时器参数 37
前言
中国联通已经建成一级架构的电子渠道系统,包括网上营业厅、手机营业厅、短信营业厅、自助终端等应用系统,具备了WEB、WAP、SMS等多种客户接触渠道,涵盖了信息提供、产品销售、客户服务和业务受理等4大服务职能,累计建设了约18个应用系统。
随着市场竞争日趋激烈,电子渠道系统需要进一步扩大业务范围,迅速扩展系统容量,应对业务量的迅速增长。
中国联通电子渠道MINI电子营业厅作为2010年电子渠道终端类系统支撑平台项目之一,大大丰富客户服务的渠道。
中国联通电子渠道Mini电子营业厅规范共有五册如下:
1、QB/CU166-2010中国联通电子渠道MINI电子营业厅业务规范V1.0
2、QB/CU167-2010中国联通电子渠道MINI电子营业厅平台技术规范V1.0
3、QB/CU168-2010中国联通电子渠道Mini营业厅平台终端接口技术规范V1.0
4、QB/CU169-2010中国联通MiNi电子营业厅终端规范V1.0
5、QB/CU170-2010中国联通Mini电子营业厅终端测试规范V1.0
本册为中国联通电子渠道Mini营业厅平台终端接口技术规范。
本规范规定了Mini平台与Mini终端之间的通信协议数据交互方式、传输方式、业务交互流程、异常处理、数据加密等要求。
本规范是在中国联通开展Mini电子营业厅业务中,根据业务规范编制而成。
随着中国联通Mini电子营业厅业务开展的实际需求及相关技术的发展要求,本规范的内容将不断的更新和完善。
本规范由中国联通电子渠道中心提出。
本规范由中国联通技术部归口管理。
本规范主要起草单位:
中国联通电子渠道中心。
本规范主要起草人:
宗新华、李宛菁、林剑峰、刘海舟、那涛、付涛、董宁、杨晓锋、杨磊、向全万、丘仲权、胡崟春、柯宇等。
本规范的修改和解释权属中国联通公司。
II
1 范围
本规范规定了中国联通Mini电子营业厅平台与Mini电子营业厅终端的接口要求,包括Mini平台与Mini终端之间的通信协议数据交互方式、传输方式、业务交互流程、异常处理、数据加密等要求。
是接入中国联通Mini电子营业厅平台的终端的设计、开发和测试的依据。
2 规范性引用文件
本规范以QB/CU166-2010-《中国联通电子渠道Mini电子营业厅业务规范V1.0》为依据。
3 缩略语
PSAM
PilotSymbolAssistedModulation
终端安全控制模
(U)SIM
SubscriberIdentityModule
用户身份识别卡
RS232
RecommendedStandard232
由电子工业协会(EIA)所制定的异步传输标准接口
LCD
LiquidCrystalDisplay
液晶显示器
CRC
CyclicalRedundancyCheck
循环冗余码
ASCII
AmericanStandardCodeforInformationInterchange
美国信息互换标准代码
3GPP
The3rdGenerationPartnershipProject
第三代合作组织项目
3GPPTS23.040
TechnicalrealizationoftheShortMessageService(SMS)PointtoPoint(PP)
短消息服务技术实现
GGSN
GatewayGPRSSupportNode
网关GPRS支持节点
4 Mini电子营业厅系统概述
4.1 Mini电子营业厅系统概述
Mini电子营业厅系统是中国联通电子渠道网上营业厅已有业务功能的拓展,将网上营业厅的功能通过Mini电子营业厅系统进行直接、有效、快速的推广;Mini电子营业厅系统的业务功能与中国联通网上营业厅的功能保持一致,并可依据中国联通网上营业厅功能的完善进行升级。
根据目前中国联通网上营业厅的主要功能,目前Mini电子营业厅系统主要包括:
号卡销售、充值交费、话费查询、购买电子卡、交易对账以及代理商相关的管理功能。
4.2 Mini电子营业厅平台概述
Mini电子营业厅平台是中国联通电子渠道Mini电子营业厅的接入以及管理平台,允许多种传输方式的接入,支持大批量的Mini电子营业厅终端接入,并对接入终端进行管理以及控制;通过与各种业务接口的数据交互,实现号卡销售、充值交费、话费查询等业务的办理。
4.3 Mini电子营业厅终端概述
Mini电子营业厅终端是一种便携式的业务办理终端,通过无线、有线方式接入Mini电子营业厅系统平台,支持城市、农村、边远地区等网点办理Mini电子营业厅各项业务,并与已有的渠道相互配合,实现全渠道的无缝覆盖。
5 接口位置
终端通过不同的传输网络连接到平台通信接口上,通过与平台通信接口的数据交互,从而实现各种业务的办理。
图1平台与终端接口位置示意图
如图1所示,终端与平台通信接口的物理通信链路包括有:
MODEM(GPRS)、MODEM(SMS)等,接口两端的通信协议有:
TCP/IP、3GPPTS23.040。
6 接口要求
6.1 通信协议数据交互方式
本协议的应用数据传输,支持两种通信传输格式:
一种是基于简单报文格式的数据交互,另外一种是基于文件传输格式的数据交互。
简单报文方式的数据交互主要应用于短数据量通信的交互流程中,数据安全性要求较高。
终端开机上报、终端重登陆、终端参数查询、设备参数更新、业务参数更新、终端业务交易、终端心跳上报、终端异常交易上报、终端远程软件升级均须采用简单报文方式进行数据交互。
文件传输方式的数据交互主要应用于长数据量通信的交互流程中,数据安全性要求不高。
如终端软件远程升级,同时可选支持基于文件传输格式的数据交互。
终端与平台之间的通信交互均采用“单消息”的方式进行通信,即:
每次数据发起方的正常数据请求,在正常情况下,接收方有且只有一个数据应答。
由于通信数据包过长而引起的数据拆分传输,该种数据传输方式,依然被认为属于“单消息”方式。
6.2 通信协议数据传输方式
6.2.1 通信接口
目前所涉及到的终端与平台通信接口的物理通信链路包括有:
MODEM(SMS)、MODEM(GPRS)等。
其中,MODEM(2GGPRS)、MODEM(SMS)、MODEM(3GGPRS)可选用其中的一种或者几种。
MODEM(GPRS)通信方式,包含2G和3G的通信制式下的无线数据传输。
其中,GPRS通信方式支持长连接或短连接的连接方式,具体的连接方式由平台根据各省、地区需求进行配置,当平台配置完成后,对应的终端开机登录或者进行业务时获取到平台下推的连接配置,则后续的业务操作都以该连接方式进行连接。
MODEM(SMS)通信方式,由于物理通信链路的限制,只支持特定的几种数据通信交互流程,不支持大数据量的数据通信交互。
如:
不支持终端远程软件升级。
6.2.2 TCP/IP协议通信
本协议规定,TCP/IP方式采用GPRS长连接或者短连接方式,只要终端开机启动,终端软件立即进行通信模块初始化操作,直至建立通信链路。
以后长连接方式双方互传消息时不再进行呼叫和建立链路,直接发送即可;短连接方式每次业务前需重新进行呼叫和建立链路,方可传递信息。
长连接方式为了保持GPRS通信链路,终端发起通信心跳包,并以接入平台的返回信息来获得通信链路状态。
本协议约定心跳包间隔时间为5分钟。
长连接方式终端在运行过程中,如果检测到TCP/IP数据通信链路断开,需要自动发起重登陆连接。
6.2.3 MODEM短消息通信
无线MODEM模块在一般情况下,必须优先使用GPRS通信方式与接入平台进行数据通信。
当终端无法使用GPRS通信方式与接入平台建立连接,需要切换到MODEM短消息通信方式。
MODEM短信通信方式下,只支持交费充值、话费查询、购买电子充值卡、号卡销售、日对帐、银行卡余额查询等业务,不支持终端远程升级业务。
切换成MODEM短信息通信方式的终端,应具备有在特定时间内尝试重新建立GPRS通信方式的内部处理。
6.3 通信业务交互流程
终端支持的主要业务类型包括:
交费充值、话费查询、购买电子充值卡、号卡销售、业务受理、日对帐、银行卡余额查询等。
终端与平台通信业务交互流程包括:
终端开机请求、终端重登陆、终端参数查询、设备参数更新、业务参数更新、终端业务交易、终端软件升级、终端心跳上报等。
由于部分通信业务需调用后方平台方可进行业务办理,因此通信业务交互流程分为两种基本路程:
需要调用第三方接口平台进行数据处理,再进行平台业务层数据应答,命名为基本数据通信流程一;不需要调用第三方接口平台的业务处理,直接进行平台业务层数据应答。
命名为基本数据通信流程二。
在一些业务交互流程中,通信发起方发起的业务请求,接收方需要调用第三方接口平台进行数据处理,方能返回处理结果。
基本通信流程如下:
步骤一:
通信发起方发起业务请求
步骤二:
接收方接收到合法数据请求后,判断业务类型:
(1)、需要调用第三方接口平台进行数据处理,进行链路层数据应答后再进行调用处理后进行业务层数据应答。
命名为基本数据通信流程一。
见下图:
基本数据通信流程一示意图1
(2)、不需要调用第三方接口平台的业务处理,直接进行业务层数据应答。
命名为基本数据通信流程二。
基本数据通信流程二示意图2
步骤三:
通信发起方接收到业务层数据应答,判定此次交互成功;接收到链路层数据应答,继续等待业务层的数据应答。
交费充值、话费查询、购买电子充值卡、号卡销售、日对帐、银行卡余额查询等业务采用基本通信业务流程一,其他业务类型支持基本通信业务流程二。
6.4 通信异常处理
6.4.1 接收超时异常处理
由于通信链路上可能存在发送时延导致应答包的先后到达顺序不一致,本协议规定:
基本数据通信流程一的数据交互过程中,接收方如果先接收到对应的业务数据链路层的数据应答,可认为此次通信交互完成,退出接收等待,且本次通信过程的链路层数据应答信息不再处理。
6.4.2 扣款类的交易流程
涉及到终端业务交易处理的数据请求只能由终端主动发起。
涉及到金融扣款相关的业务交易,在终端和接入平台的数据通信过程中,每笔交易过程必须要有唯一的交易标识号。
交易标识号由终端首先生成日期以及业务类型编号,再由接入平台补充随机码生成。
基本通信交互流程中,终端须先进行索取交易标识号的通信请求,方能进行正式的业务交易处理,且该交易标识号将作为后续这笔交易的异常处理依据。
基本交易通信流程示意图见下图:
扣款类业务通信交互流程示意图
交易标识号只用于终端与接入平台的内部约定使用,可以不受交易流水号的接口变更的影响。
6.4.3 扣款交易异常原因
本协议定义扣款类产生的异常原因以及对应的业务处理原则,列表如下:
失败原因
具体描述
编码
业务处理原则
终端发送失败
包括物理通信链路异常、通信模块故障等
11
终端直接认为交易失败,如果发生扣款,需要返销处理
交易结果未知终端接收超时
在约定时间内未接收到接入平台业务处理的应答返回
12
终端直接认为交易失败,如果发生扣款,需要返销处理
交易结果已知终端通信异常
终端成功接收接入平台的业务处理信息,确认交易成功,但返回确认成功的过程中出现通信故障
13
终端判断交易成功,平台记录该笔交易正常
交易结果未知终端设备故障
终端交易过程发生掉电、死机、重启等异常故障
14
终端直接认为交易失败,如果发生扣款,需要返销处理
后台处理失败
后台返回的异常交易原因
20
终端与后台的交易状态一致,与后台的接入通信正常,该笔交易失败记录,不保存在终端本地的交易异常记录中,由后台保存和确认
其他交易异常
其他暂未定义到的交易过程失败原因
255
根据具体原因再做处理
6.4.4 扣款类交易异常处理
终端记录的交易异常记录,通信链路建立成功后,须终端主动发起,发起的异常记录信息内容包括交易标识号、交易内容CRC值、交易异常原因等内容,接入平台接收成功后,回复确认信息,终端将不再上报该异常记录。
接入平台再根据终端上传的失败原因进行相应的处理。
扣款类的异常交易记录,终端应至少记录最近100笔的交易数据在非易失性的数据存储器中,且支持本地查询浏览。
异常交易信息记录的数据应至少包括:
交易类型、交易标识号、交易内容CRC值、交易异常原因。
6.5 数据安全传输协议
6.5.1 终端加密基本说明
基于简单报文格式的数据交互,涉及到与接入平台进行数据通信的加密主要有以下两种类型:
随机加密:
平台与每个接入的终端厂家分别约定唯一的随机加密算法,随机加密根据数据明文的部分固定数据域进行加密。
随机加密的算法将由平台厂家提供固化的加密芯片进行加密运算。
固定加密:
密钥保存在PSAM卡中,终端通过操作PSAM卡生成密文。
涉及到扣款类的业务类型,金融交易信息的数据域须采用DES、3DES的固定加密。
6.5.2 数据传输加密原则
基于简单报文格式的交互数据传输均不能以通信明文的方式出现,根据业务类型,采用随机密钥和工作密钥相结合的方式:
任何数据传输最终须采用随机密钥进行加密后再进行传输。
涉及到金融交易信息等内容,相应的交易数据域中需使用工作密钥加密后传输。
终端在扣款业务交易过程中,连续出现密钥加密错误,平台应终止该终端的业务办理权限。
6.5.3 终端接入鉴权
终端每次开机、重登陆须先进行接入鉴权,进行终端接入的合法性校验。
对于非法接入的终端设备,平台必须禁用此终端的后续业务请求直至其合法性校验通过。
6.6 接口报文协议
6.6.1 物理通信标识协议约定
终端在发起数据请求时,应在通信报文中表明当前物理通信方式,接入平台在返回应答时,以同样的物理标识信息返回。
若是接入平台主动发起的数据通信请求,应以对应终端在平台上最后一次记录的通信方式作为基本通信方式发起请求。
6.6.2 通信定时器
发送间隔定时器:
用于控制发送方连续发送多条通信包的时间间隔。
发送方每发送完一个通信包就复位并运行该定时器。
链路层接收定时器:
用于接收方等待接收时使用。
当发送方发送完链路层数据通信包,就启动该定时器,等待接收方的链路层数据应答。
不同物理通信链路,通信接收端应根据实际网络情况设置有不同的链路层接收定时器。
业务层接收定时器:
用于接收方等待接收时使用。
当发送方发送完业务层数据通信包,就启动该定时器,等待接收方的业务层数据应答。
通信接收端应根据实际逻辑业务设置有不同的业务层接收定时器。
具体业务层接收定时器参数请参见本规范的附录1业务层接收定时器参数。
6.6.3 通信报文协议
6.6.3.1 基本说明
为了提高通信协议的可扩展性,本协议采用分层结构,各个层之间的功能彼此独立。
协议共分为两个层,从底至上分别为:
承载接入层、应用数据层。
两层的功能和用途如下:
承载接入层
描述出当前数据通信物理链路以及接入的设备基本信息描述,该层可以向应用数据层提供面向字节流的数据包。
该层协议简称为TAP。
应用数据层
承载应用数据协议包,实现监控控制层与通信链路、网络结构的隔离。
提供数据包寻址处理和分组功能。
该层协议简称为ADP。
6.6.3.2 协议格式
为支持不同通信方式的数据传输,定义以下两种数据传输格式的通信协议:
十六进制数据传输:
支持RS232、MODEM(GPRS)等对传输数据格式无限制的通信信道。
下文简称TAPA协议。
字节拆分数据传输:
对只能够传输ASCII码格式数据的通信信道采用该方式的数据传输,如MODEM(SMS)。
下文简称TAPB协议。
不同的物理通信模块,由于各自的接口特性不同,其数据传输的长度有对应的限制。
6.6.3.3 基本协议框架
TAPA协议
字段组成
字段
传输接口
字节长度
说明
起始标志
必选
1byte
完整数据包的开始。
固定为0x7E
承载接入层
必选
14bytes
描述设备的接入信息
应用数据层
必选
长度不定
传输业务交互数据
校验单元
必选
2bytes
见下文“检验算法”描述
结束标志
必选
1byte
完整数据包的结束。
固定为0x7F
转义规则
见下文的“字节转义”中的描述。
字节拆分
不进行字节拆分。
协议包长度
1200Bytes。
从“承载协议层”开始到“校验单元”结束,在字符转义前。
TAPB协议
字段组成
字段
传输接口
字节长度
说明
起始标志
必选
1byte
完整数据包的开始。
固定为ASCII码0x21
承载接入层
必选
14bytes
描述设备的接入信息
应用数据层
必选
长度不定
传输业务交互数据
校验单元
必选
2bytes
见下文“检验算法”描述
结束标志
必选
1byte
完整数据包的结束。
固定为ASCII码0x21
转义规则
不进行转义。
字节拆分
见下文的“字节拆分”描述。
协议包长度
140Bytes。
从“承载协议层”开始到“校验单元”结束,字节拆分之后。
承载接入层
字段组成
字段
传输接口
字节长度
说明
物理通信标志
必选
1byte
可表示范围从0x01~0xFF
协议版本标志
必选
1byte
当前通信协议的版本号。
用一个字节的BCD码表示,高4位表示主版编号,低4位表示子版本编码。
例如0x10的表示协议版本号为1.0。
本协议版本为1.0版本。
厂家标识码
必选
1byte
设备厂家的编码
终端标识码
必选
8bytes
终端设备的唯一标识号,可用于鉴权终端的合法性。
终端接收到非本PSAM卡号的数据,应于丢弃处理。
传输顺序:
按数字串自身的顺序,由左向右逐个字节传输。
数据状态码
必选
1byte
当前应用数据层的数据状态
安全数据码
必选
2bytes
接入分配给各厂家随机密钥随机加密的生成值。
未分配的默认为0x0000
物理通信标志编码
通信标志
物理通信方式
备注
0x00
——
禁止使用
0x01
RS232
由厂家本地调试、测试使用
0x02
USB
由厂家本地调试、测试使用
0x03
MODEM(SMS)
包括2G、3G的短信通信
0x04
MODEM(GPRS)
包括2G、3G的数据传输
0x05
MODEM(DATA)
包括2G、3G的语音数传
0x06
Ethernet
0x07
ADSLMODEM
ADSL宽带数据传输
0x09~0xFF
预留使用
厂家标识码
厂家编码
厂家说明
0x00
无效,禁止使用
0x01
厂家一
0x02
厂家二
0x03
厂家三
0x04~…0xF0
其它厂家
0xF1…0xFE
预留使用
0xFF
未知厂家
数据状态码
偏移位置
表示意义
数据说明
低4位
数据压缩算法
0:
未压缩1:
Huffman算法2~7:
未定义
高4位
数据加密算法
0:
未加密1:
DES加密2:
3DES加密
3:
RSA公钥加密4:
RSA私钥加密
5~7:
未定义,保留
安全数据码
各厂家根据系统分配的唯一的随机加密算法,进行随机加密后生成的16位加密值。
错误的数据状态码将被系统丢弃,并被监控。
应用数据层
字段组成
字段
传输接口
字节长度
说明
终端通信包标识
必选
1bytes
终端主动发起的随机开始,之后顺序递增。
平台回复需带回给终端。
低字节传输在前,高字节传输在后。
通信包总数
必选
1byte
每次通信交互流程中,发起端发送的数据量超过协议约定的最大长度,需拆分为多包时使用。
多包的数据传输,“通信包标识号”均保持一致。
单条数据包的“通信包总数”固定为0x01。
通信包序号
必选
1byte
多包数据传输,从0x01开始到“通信包总数”顺序编号。
单条数据包的包序号固定为0x01。
平台通信包标识
必选
2byte
终端发起填充0xFFFF,平台回复填充数据给终端,在同个业务内终端一直保留该数据,直到业务终结或者另起一个业务时再次填充0xFFFF
开机随机验证
必选
1byte
由平台填充,终端本次开机后都需带着这个值
命令标识
必选
2byte
通信交互的唯一标识码。
第1个字节为业务号,第2个字节为业务下具体的命令编号。
应答标识
必选
1byte
应答方处理返回的标志,发起方该处固定填写0xFF。
命令体单元
非必选
不定长
由多个命令单元组成业务交互数据。
组成部分见下文。
应答标识码
偏移位置
表示意义
数据说明
0x00
成功
操作请求执行成功
0x01
数据校验失败
只用于本地调试,正式平台不返回
0x02
无效通信链路
通信标志出错
0x03
无效协议版本
协议版本不存在或不支持
0x04
无效厂家编码
不合法厂家
0x05
无效算法
压缩算法、加密算法不存在
0x06
无效的命令请求
命令标识不存在或者未定义
0x07
数据长度错
实际长度与数据包中描述的不符
0x08
非法PSAM卡请求
非法PSAM卡接入
0x09
时间戳超时
时间戳超时,无效命令
0x0A
系统忙
系统正忙,无法响应请求
0x0B
后台系统升级
后台系统升级,暂停响应请求
0x0C
第三方系统异常
第三方系统异常,暂停响应
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 中国联通 电子 渠道 MINI 营业厅 终端 接口 技术规范 V1
![提示](https://static.bingdoc.com/images/bang_tan.gif)