中国联通电子渠道MINI电子营业厅终端接口技术规范V1.0

中国联通公司企业标准
QB/CU 168-2010
中国联通电子渠道MINI电子营业厅终端接口技术规范
China Unicom Electronic Channel Terminal Interface Specification of Mini
Electronic Business Hall Platform
(V1.0)
2010-12-22发布2010-12-22实施
目录
前言 (II)
1 范围 (1)
2 规范性引用文件 (1)
3 缩略语 (1)
4 Mini电子营业厅系统概述 (1)
4.1 Mini电子营业厅系统概述 (1)
4.2 Mini电子营业厅平台概述 (1)
4.3 Mini电子营业厅终端概述 (2)
5 接口位置 (2)
6 接口要求 (2)
6.1 通信协议数据交互方式 (2)
6.2 通信协议数据传输方式 (3)
6.2.1 通信接口 (3)
6.2.2 TCP/IP协议通信 (3)
6.2.3 MODEM短消息通信 (3)
6.3 通信业务交互流程 (4)
6.4 通信异常处理 (5)
6.4.1 接收超时异常处理 (5)
6.4.2 扣款类的交易流程 (6)
6.4.3 扣款交易异常原因 (7)
6.4.4 扣款类交易异常处理 (7)
6.5 数据安全传输协议 (7)
6.5.1 终端加密基本说明 (7)
6.5.2 数据传输加密原则 (8)
6.5.3 终端接入鉴权 (8)
6.6 接口报文协议 (8)
6.6.1 物理通信标识协议约定 (8)
6.6.2 通信定时器 (8)
6.6.3 通信报文协议 (9)
6.6.3.1 基本说明 (9)
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 业务层接收定时器参数 (38)
前言
中国联通已经建成一级架构的电子渠道系统，包括网上营业厅、手机营业厅、短信营业厅、自助终端等应用系统，具备了WEB、WAP、SMS等多种客户接触渠道，涵盖了信息提供、产品销售、客户服务和业务受理等4大服务职能，累计建设了约18个应用系统。

随着市场竞争日趋激烈，电子渠道系统需要进一步扩大业务范围，迅速扩展系统容量，应对业务量的迅速增长。

中国联通电子渠道MINI电子营业厅作为2010年电子渠道终端类系统支撑平台项目之一，大大丰富客户服务的渠道。

中国联通电子渠道Mini电子营业厅规范共有五册如下：
1、QB/CU 166-2010 中国联通电子渠道MINI电子营业厅业务规范V1.0
2、QB/CU 167-2010 中国联通电子渠道MINI电子营业厅平台技术规范V1.0
3、QB/CU 168-2010 中国联通电子渠道Mini营业厅平台终端接口技术规范V1.0
4、QB/CU 169-2010 中国联通MiNi电子营业厅终端规范V1.0
5、QB/CU 170-2010 中国联通Mini电子营业厅终端测试规范V1.0
本册为中国联通电子渠道Mini营业厅平台终端接口技术规范。

本规范规定了Mini平台与Mini终端之间的通信协议数据交互方式、传输方式、业务交互流程、异常处理、数据加密等要求。

本规范是在中国联通开展Mini电子营业厅业务中，根据业务规范编制而成。

随着中国联通Mini电子营业厅业务开展的实际需求及相关技术的发展要求，本规范的内容将不断的更新和完善。

本规范由中国联通电子渠道中心提出。

本规范由中国联通技术部归口管理。

本规范主要起草单位：中国联通电子渠道中心。

本规范主要起草人：宗新华、李宛菁、林剑峰、刘海舟、那涛、付涛、董宁、杨晓锋、杨磊、向全万、丘仲权、胡崟春、柯宇等。

本规范的修改和解释权属中国联通公司。

1 范围
本规范规定了中国联通Mini电子营业厅平台与Mini电子营业厅终端的接口要求，包括Mini 平台与Mini终端之间的通信协议数据交互方式、传输方式、业务交互流程、异常处理、
数据加密等要求。

是接入中国联通Mini电子营业厅平台的终端的设计、开发和测试的依据。

2 规范性引用文件
本规范以 QB/CU 166-2010-《中国联通电子渠道Mini电子营业厅业务规范V1.0》为依据。

3 缩略语
PSAM Pilot Symbol Assisted Modulation 终端安全控制模
(U)SIM Subscriber Identity Module 用户身份识别卡
RS232 Recommended Standard 232 由电子工业协会(EIA)所制定的异步传输标准接口
LCD Liquid Crystal Display 液晶显示器CRC Cyclical Redundancy Check 循环冗余码
ASCII American Standard Code for Information
Interchange
美国信息互换标准代码
3GPP The 3rd Generation Partnership Project 第三代合作组织项目
3GPP TS23.040 Technical realization of the Short Message
Service (SMS) Point-to-Point (PP)
短消息服务技术实现
GGSN Gateway GPRS Support Node 网关GPRS支持节点
4 Mini电子营业厅系统概述
4.1 Mini电子营业厅系统概述
Mini电子营业厅系统是中国联通电子渠道网上营业厅已有业务功能的拓展，将网上营业厅的功能通过Mini电子营业厅系统进行直接、有效、快速的推广；Mini电子营业厅系统的业务功能与中国联通网上营业厅的功能保持一致，并可依据中国联通网上营业厅功能的完善进行升级。

根据目前中国联通网上营业厅的主要功能，目前Mini电子营业厅系统主要包括：号卡销售、充值交费、话费查询、购买电子卡、交易对账以及代理商相关的管理功能。

4.2 Mini电子营业厅平台概述
Mini 电子营业厅平台是中国联通电子渠道Mini 电子营业厅的接入以及管理平台，允许多种传输方式的接入，支持大批量的Mini 电子营业厅终端接入，并对接入终端进行管理以及控制；通过与各种业务接口的数据交互，实现号卡销售、充值交费、话费查询等业务的办理。

4.3 Mini 电子营业厅终端概述
Mini 电子营业厅终端是一种便携式的业务办理终端，通过无线、有线方式接入Mini 电子营业厅系统平台，支持城市、农村、边远地区等网点办理Mini 电子营业厅各项业务，并与已有的渠道相互配合，实现全渠道的无缝覆盖。

5 接口位置
终端通过不同的传输网络连接到平台通信接口上，通过与平台通信接口的数据交互，从而实现各种业务的办理。

GGSN
在信网关GPRS 方式
SMS 方式
终端
终端
平台
图1 平台与终端接口位置示意图
如图1所示，终端与平台通信接口的物理通信链路包括有：MODEM(GPRS)、MODEM(SMS)等，接口两端的通信协议有：TCP/IP 、3GPP TS23.040。

6 接口要求
6.1 通信协议数据交互方式
本协议的应用数据传输，支持两种通信传输格式：一种是基于简单报文格式的数据交互，另外一种是基于文件传输格式的数据交互。

简单报文方式的数据交互主要应用于短数据量通信的交互流程中，数据安全性要求较高。

终端开机上报、终端重登陆、终端参数查询、设备参数更新、业务参数更新、终端业务交易、终端心跳上报、终端异常交易上报、终端远程软件升级均须采用简单报文方式进行数据交互。

文件传输方式的数据交互主要应用于长数据量通信的交互流程中，数据安全性要求不高。

如终端软件远程升级，同时可选支持基于文件传输格式的数据交互。

终端与平台之间的通信交互均采用“单消息”的方式进行通信，即：每次数据发起方的正常数据请求，在正常情况下，接收方有且只有一个数据应答。

由于通信数据包过长而引起的数据拆分传输，该种数据传输方式，依然被认为属于“单消息”方式。

6.2 通信协议数据传输方式
6.2.1 通信接口
目前所涉及到的终端与平台通信接口的物理通信链路包括有：MODEM(SMS)、MODEM(GPRS)等。

其中，MODEM(2G GPRS)、MODEM(SMS)、MODEM(3G GPRS)可选用其中的一种或者几种。

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 完整数据包的结束。

固定为ASCI I码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 ADSL MODEM 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 第三方系统异常第三方系统异常，暂停响应请求0x0D~0xFD 未定义保留
0xFE 其他错误上述未列出的错误
0xFF 通信方发起方填写
6.6.3.4 命令体单元组成
由多个命令单元组成业务交互数据
命令单元组成
命令单元1 命令单元2 ……命令单元N-1 命令单元N
命令体单元数据域组成
字段传输接口字节长度说明
标识本命令单元的数据长度，指的是从“命命令体长度必选2bytes
令体长度”到“命令值”的所有字节总数，
单位是字节。

小于4为不合法的命令单元长度。

传输顺序：低字节传输在前，高字节传输在后。

命令编码必选2bytes 通信交互数据的统一标识号，在固定的模式下，每个标识号都是唯一的。

低字节传输在前，高字节传输在后。

命令值非必选不定长
平台查询终端时可以不填写。

可以是字符
串、数值、数字串等数据。

6.6.3.5 传输算法约定
校验算法
承载接入层和应用数据层的全部数据内容，按传输顺序进行校验。

本协议规定：
发送方发送的数据，采用CRC校验算法，生成多项式为16位的x16+x12+x5+1（0x11021）。

发送方根据通信包生成2字节的检验码；同样，接收方收到完整的数据包后，根据通信包以及校验算法生成检验值。

如果所计算出的校验值和收到的校验值相同，则表明该数据包有效，否则认为该包在传输的过程中产生了差错。

在正式产品中，对校验出错的命令，接收方不处理也不返回任何应答。

校验单元的传输顺序为：低字节传输在前，高字节传输在后。

字节转义
TAPA协议由于使用16进制方式传输数据，为防止数据中出现与通信包起始标志、结束标志相同的数据而影响这两个标志的判断。

在发送和接收时必须进行数据的转义。

在本层协议中，对除起始标志和结束标志外的所有数据。

转义规则：用0x5E，0x5D来代替0x5E；用0x5E，0x7D来代替0x7E；用0x5E，0x5F 来代替0x7F。

对于需要进行转义后发送的情况，要按照如下的顺序进行操作：发送数据包之前，先生成校验值，再进行转义处理；接收到数据包后，先进行转义处理，再进行校验。

字节拆分
TAPB协议中对所有数据统一采用“ASCII码拆分处理”，具体说明如下：。