中国联通电子渠道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 实施 中国联通公司发布 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 I 目目 录录 前 言 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 扣款类的交易流程 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 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 II 前 言 中国联通已经建成一级架构的电子渠道系统 包括网上营业厅 手机营业厅 短信营业 厅 自助终端等应用系统 具备了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电子营业厅业务开展的实际需求及相关技术的发展要求 本规范的 内容将不断的更新和完善 本规范由中国联通电子渠道中心提出 本规范由中国联通技术部归口管理 本规范主要起草单位 中国联通电子渠道中心 本规范主要起草人 宗新华 李宛菁 林剑峰 刘海舟 那涛 付涛 董宁 杨晓锋 杨磊 向全万 丘仲权 胡崟春 柯宇等 本规范的修改和解释权属中国联通公司 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 1 1 范围 本规范规定了中国联通Mini电子营业厅平台与Mini电子营业厅终端的接口要求 包括Mini 平台与Mini终端之间的通信协议数据交互方式 传输方式 业务交互流程 异常处理 数据加密 等要求 是接入中国联通Mini电子营业厅平台的终端的设计 开发和测试的依据 2 规范性引用文件 本规范以 QB CU 166 2010 中国联通电子渠道Mini电子营业厅业务规范V1 0 为依据 3 缩略语 PSAMPilot Symbol Assisted Modulation终端安全控制模 U SIMSubscriber Identity Module用户身份识别卡 RS232Recommended Standard 232 由电子工业协会 EIA 所制定的异步传输标准 接口 LCDLiquid Crystal Display 液晶显示器 CRCCyclical Redundancy Check循环冗余码 ASCII American Standard Code for Information Interchange 美国信息互换标准代码 3GPPThe 3rd Generation Partnership Project第三代合作组织项目 3GPP TS23 040 Technical realization of the Short Message Service SMS Point to Point PP 短消息服务技术实现 GGSNGateway GPRS Support Node网关GPRS支持节点 4 Mini 电子营业厅系统概述 4 1 Mini 电子营业厅系统概述 Mini电子营业厅系统是中国联通电子渠道网上营业厅已有业务功能的拓展 将网上营业厅的 功能通过Mini电子营业厅系统进行直接 有效 快速的推广 Mini电子营业厅系统的业务功能与中 国联通网上营业厅的功能保持一致 并可依据中国联通网上营业厅功能的完善进行升级 根据目前中国联通网上营业厅的主要功能 目前Mini电子营业厅系统主要包括 号卡销售 充值交费 话费查询 购买电子卡 交易对账以及代理商相关的管理功能 4 2 Mini 电子营业厅平台概述 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 2 Mini电子营业厅平台是中国联通电子渠道Mini电子营业厅的接入以及管理平台 允许多种 传输方式的接入 支持大批量的Mini电子营业厅终端接入 并对接入终端进行管理以及控制 通过与各种业务接口的数据交互 实现号卡销售 充值交费 话费查询等业务的办理 4 3 Mini 电子营业厅终端概述 Mini电子营业厅终端是一种便携式的业务办理终端 通过无线 有线方式接入Mini电子营业 厅系统平台 支持城市 农村 边远地区等网点办理Mini电子营业厅各项业务 并与已有的渠道相 互配合 实现全渠道的无缝覆盖 5 接口位置 终端通过不同的传输网络连接到平台通信接口上 通过与平台通信接口的数据交互 从而 实现各种业务的办理 G GG GS SN N 在在信信网网关关 G GP PR RS S方方式式 S SM MS S方方式式 终终端端 终终端端 平平台台 图1 平台与终端接口位置示意图 如图1所示 终端与平台通信接口的物理通信链路包括有 MODEM GPRS MODEM SMS 等 接口两端的通信协议有 TCP IP 3GPP TS23 040 6 接口要求 6 1 通信协议数据交互方式 本协议的应用数据传输 支持两种通信传输格式 一种是基于简单报文格式的数据交互 另外一种是基于文件传输格式的数据交互 简单报文方式的数据交互主要应用于短数据量通信的交互流程中 数据安全性要求较高 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 3 终端开机上报 终端重登陆 终端参数查询 设备参数更新 业务参数更新 终端业务交 易 终端心跳上报 终端异常交易上报 终端远程软件升级均须采用简单报文方式进行数据交 互 文件传输方式的数据交互主要应用于长数据量通信的交互流程中 数据安全性要求不高 如终端软件远程升级 同时可选支持基于文件传输格式的数据交互 终端与平台之间的通信交互均采用 单消息 的方式进行通信 即 每次数据发起方的正常 数据请求 在正常情况下 接收方有且只有一个数据应答 由于通信数据包过长而引起的数据拆分传输 该种数据传输方式 依然被认为属于 单消息 方式 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 短消息通信 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 4 无线MODEM模块在一般情况下 必须优先使用GPRS通信方式与接入平台进行数据通信 当终端无法使用GPRS通信方式与接入平台建立连接 需要切换到MODEM短消息通信方式 MODEM短信通信方式下 只支持交费充值 话费查询 购买电子充值卡 号卡销售 日对 帐 银行卡余额查询等业务 不支持终端远程升级业务 切换成MODEM短信息通信方式的终端 应具备有在特定时间内尝试重新建立GPRS通信方 式的内部处理 6 3 通信业务交互流程 终端支持的主要业务类型包括 交费充值 话费查询 购买电子充值卡 号卡销售 业务 受理 日对帐 银行卡余额查询等 终端与平台通信业务交互流程包括 终端开机请求 终端重登陆 终端参数查询 设备参 数更新 业务参数更新 终端业务交易 终端软件升级 终端心跳上报等 由于部分通信业务需调用后方平台方可进行业务办理 因此通信业务交互流程分为两种基 本路程 需要调用第三方接口平台进行数据处理 再进行平台业务层数据应答 命名为基本数 据通信流程一 不需要调用第三方接口平台的业务处理 直接进行平台业务层数据应答 命名 为基本数据通信流程二 在一些业务交互流程中 通信发起方发起的业务请求 接收方需要调用第三方接口平台进 行数据处理 方能返回处理结果 基本通信流程如下 步骤一 通信发起方发起业务请求 步骤二 接收方接收到合法数据请求后 判断业务类型 1 需要调用第三方接口平台进行数据处理 进行链路层数据应答后再进行调用处理后 进行业务层数据应答 命名为基本数据通信流程一 见下图 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 5 基本数据通信流程一示意图1 2 不需要调用第三方接口平台的业务处理 直接进行业务层数据应答 命名为基本数 据通信流程二 基本数据通信流程二示意图2 步骤三 通信发起方接收到业务层数据应答 判定此次交互成功 接收到链路层数据应答 继续等待业务层的数据应答 交费充值 话费查询 购买电子充值卡 号卡销售 日对帐 银行卡余额查询等业务采用 基本通信业务流程一 其他业务类型支持基本通信业务流程二 6 4 通信异常处理 6 4 1 接收超时异常处理 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 6 由于通信链路上可能存在发送时延导致应答包的先后到达顺序不一致 本协议规定 基本数据通信流程一的数据交互过程中 接收方如果先接收到对应的业务数据链路层的数 据应答 可认为此次通信交互完成 退出接收等待 且本次通信过程的链路层数据应答信息不 再处理 6 4 2 扣款类的交易流程 涉及到终端业务交易处理的数据请求只能由终端主动发起 涉及到金融扣款相关的业务交易 在终端和接入平台的数据通信过程中 每笔交易过程必 须要有唯一的交易标识号 交易标识号由终端首先生成日期以及业务类型编号 再由接入平台补充随机码生成 基本通 信交互流程中 终端须先进行索取交易标识号的通信请求 方能进行正式的业务交易处理 且 该交易标识号将作为后续这笔交易的异常处理依据 基本交易通信流程示意图见下图 扣款类业务通信交互流程示意图扣款类业务通信交互流程示意图 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 7 交易标识号只用于终端与接入平台的内部约定使用 可以不受交易流水号的接口变更的影 响 6 4 3 扣款交易异常原因 本协议定义扣款类产生的异常原因以及对应的业务处理原则 列表如下 失败原因具体描述编码业务处理原则 终端发送失败 包括物理通信链路异常 通信 模块故障等 11 终端直接认为交易失败 如果发生扣 款 需要返销处理 交易结果未知 终端接收超时 在约定时间内未接收到接入平 台业务处理的应答返回 12 终端直接认为交易失败 如果发生扣 款 需要返销处理 交易结果已知 终端通信异常 终端成功接收接入平台的业务 处理信息 确认交易成功 但 返回确认成功的过程中出现通 信故障 13 终端判断交易成功 平台记录该笔交 易正常 交易结果未知 终端设备故障 终端交易过程发生掉电 死机 重启等异常故障 14 终端直接认为交易失败 如果发生扣 款 需要返销处理 后台处理失败后台返回的异常交易原因20 终端与后台的交易状态一致 与后台 的接入通信正常 该笔交易失败记录 不保存在终端本地的交易异常记录中 由后台保存和确认 其他交易异常 其他暂未定义到的交易过程失 败原因 255根据具体原因再做处理 6 4 4 扣款类交易异常处理 终端记录的交易异常记录 通信链路建立成功后 须终端主动发起 发起的异常记录信息 内容包括交易标识号 交易内容CRC值 交易异常原因等内容 接入平台接收成功后 回复确 认信息 终端将不再上报该异常记录 接入平台再根据终端上传的失败原因进行相应的处理 扣款类的异常交易记录 终端应至少记录最近100笔的交易数据在非易失性的数据存储器中 且支持本地查询浏览 异常交易信息记录的数据应至少包括 交易类型 交易标识号 交易内容CRC值 交易异 常原因 6 5 数据安全传输协议 6 5 1 终端加密基本说明 基于简单报文格式的数据交互 涉及到与接入平台进行数据通信的加密主要有以下两种类 型 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 8 随机加密 平台与每个接入的终端厂家分别约定唯一的随机加密算法 随机加密根据数据 明文的部分固定数据域进行加密 随机加密的算法将由平台厂家提供固化的加密芯片进行加密 运算 固定加密 密钥保存在 PSAM 卡中 终端通过操作 PSAM 卡生成密文 涉及到扣款类的业 务类型 金融交易信息的数据域须采用 DES 3DES 的固定加密 6 5 2 数据传输加密原则 基于简单报文格式的交互数据传输均不能以通信明文的方式出现 根据业务类型 采用随 机密钥和工作密钥相结合的方式 任何数据传输最终须采用随机密钥进行加密后再进行传输 涉及到金融交易信息等内容 相应的交易数据域中需使用工作密钥加密后传输 终端在扣 款业务交易过程中 连续出现密钥加密错误 平台应终止该终端的业务办理权限 6 5 3 终端接入鉴权 终端每次开机 重登陆须先进行接入鉴权 进行终端接入的合法性校验 对于非法接入的 终端设备 平台必须禁用此终端的后续业务请求直至其合法性校验通过 6 6 接口报文协议 6 6 1 物理通信标识协议约定 终端在发起数据请求时 应在通信报文中表明当前物理通信方式 接入平台在返回应答时 以同样的物理标识信息返回 若是接入平台主动发起的数据通信请求 应以对应终端在平台上 最后一次记录的通信方式作为基本通信方式发起请求 6 6 2 通信定时器 发送间隔定时器 用于控制发送方连续发送多条通信包的时间间隔 发送方每发送完一个 通信包就复位并运行该定时器 链路层接收定时器 用于接收方等待接收时使用 当发送方发送完链路层数据通信包 就 启动该定时器 等待接收方的链路层数据应答 不同物理通信链路 通信接收端应根据实际网络情况设置有不同的链路层接收定时器 业务层接收定时器 用于接收方等待接收时使用 当发送方发送完业务层数据通信包 就 启动该定时器 等待接收方的业务层数据应答 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 9 通信接收端应根据实际逻辑业务设置有不同的业务层接收定时器 具体业务层接收定时器 参数请参见本规范的附录 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 基本协议框架 TAPATAPA 协议协议 字段组成字段组成 字段传输接口字节长度说明 起始标志必选 1byte 完整数据包的开始 固定为 0 x7E 承载接入层必选 14bytes 描述设备的接入信息 应用数据层必选长度不定传输业务交互数据 校验单元必选 2bytes 见下文 检验算法 描述 结束标志必选 1byte 完整数据包的结束 固定为 0 x7F 转义规则转义规则 见下文的 字节转义 中的描述 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 10 字节拆分字节拆分 不进行字节拆分 协议包长度协议包长度 1200Bytes 从 承载协议层 开始到 校验单元 结束 在字符转义前 TAPB 协议协议 字段组成字段组成 字段传输接口字节长度说明 起始标志必选 1byte 完整数据包的开始 固定为 ASCII 码 0 x21 承载接入层必选 14bytes 描述设备的接入信息 应用数据层必选长度不定传输业务交互数据 校验单元必选 2bytes 见下文 检验算法 描述 结束标志必选 1byte 完整数据包的结束 固定为 ASCII 码 0 x21 转义规则转义规则 不进行转义 字节拆分字节拆分 见下文的 字节拆分 描述 协议包长度协议包长度 140Bytes 从 承载协议层 开始到 校验单元 结束 字节拆分之后 承载接入层承载接入层 字段组成字段组成 字段传输接口字节长度说明 物理通信标志必选 1byte 可表示范围从 0 x01 0 xFF 协议版本标志必选 1byte 当前通信协议的版本号 用一个字节的 BCD 码表示 高 4 位表示主版编号 低 4 位表示子版本编码 例如 0 x10 的表示协 议版本号为 1 0 本协议版本为 1 0 版本 厂家标识码必选 1byte 设备厂家的编码 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 11 终端标识码必选 8bytes 终端设备的唯一标识号 可用于鉴权终端 的合法性 终端接收到非本 PSAM 卡号 的数据 应于丢弃处理 传输顺序 按数 字串自身的顺序 由左向右逐个字节传输 数据状态码必选 1byte 当前应用数据层的数据状态 安全数据码必选 2bytes 接入分配给各厂家随机密钥随机加密的生 成值 未分配的默认为 0 x0000 物理通信标志编码物理通信标志编码 通信标志物理通信方式备注 0 x00 禁止使用 0 x01RS232 由厂家本地调试 测试使用 0 x02USB 由厂家本地调试 测试使用 0 x03MODEM SMS 包括 2G 3G 的短信通信 0 x04MODEM GPRS 包括 2G 3G 的数据传输 0 x05MODEM DATA 包括 2G 3G 的语音数传 0 x06Ethernet 0 x07ADSL MODEM ADSL 宽带数据传输 0 x09 0 xFF 预留使用 厂家标识码厂家标识码 厂家编码厂家说明 0 x00 无效 禁止使用 0 x01 厂家一 0 x02 厂家二 0 x03 厂家三 0 x04 0 xF0 其它厂家 0 xF1 0 xFE 预留使用 0 xFF 未知厂家 数据状态码数据状态码 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 12 偏移位置表示意义数据说明 低 4 位数据压缩算法0 未压缩 1 Huffman 算法 2 7 未定义 高 4 位数据加密算法 0 未加密 1 DES 加密 2 3DES 加密 3 RSA 公钥加密 4 RSA 私钥加密 5 7 未定义 保留 安全数据码安全数据码 各厂家根据系统分配的唯一的随机加密算法 进行随机加密后生成的 16 位加密值 错误的数据状态码将被系统丢弃 并被监控 应用数据层应用数据层 字段组成字段组成 字段传输接口字节长度说明 终端通信包标识必选 1bytes 终端主动发起的随机开始 之后顺序递增 平台回复需带回给终端 低字节传输在前 高字节传输在后 通信包总数必选 1byte 每次通信交互流程中 发起端发送的数据 量超过协议约定的最大长度 需拆分为多 包时使用 多包的数据传输 通信包标 识号 均保持一致 单条数据包的 通信 包总数 固定为 0 x01 通信包序号必选 1byte 多包数据传输 从 0 x01 开始到 通信包 总数 顺序编号 单条数据包的包序号固 定为 0 x01 平台通信包标识必选 2byte 终端发起填充 0 xFFFF 平台回复填充数 据给终端 在同个业务内终端一直保留该 数据 直到业务终结或者另起一个业务时 再次填充 0 xFFFF 开机随机验证必选 1byte 由平台填充 终端本次开机后都需带着这 个值 命令标识必选 2byte 通信交互的唯一标识码 第 1 个字节为业 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 13 务号 第 2 个字节为业务下具体的命令编 号 应答标识必选 1byte 应答方处理返回的标志 发起方该处固定 填写 0 xFF 命令体单元非必选不定长 由多个命令单元组成业务交互数据 组成 部分见下文 应答标识码应答标识码 偏移位置表示意义数据说明 0 x00 成功操作请求执行成功 0 x01 数据校验失败只用于本地调试 正式平台不返回 0 x02 无效通信链路通信标志出错 0 x03 无效协议版本协议版本不存在或不支持 0 x04 无效厂家编码不合法厂家 0 x05 无效算法压缩算法 加密算法不存在 0 x06 无效的命令请求命令标识不存在或者未定义 0 x07 数据长度错实际长度与数据包中描述的不符 0 x08 非法 PSAM 卡请求非法 PSAM 卡接入 0 x09 时间戳超时时间戳超时 无效命令 0 x0A 系统忙系统正忙 无法响应请求 0 x0B 后台系统升级后台系统升级 暂停响应请求 0 x0C 第三方系统异常第三方系统异常 暂停响应请求 0 x0D 0 xFD 未定义保留 0 xFE 其他错误上述未列出的错误 0 xFF 通信方发起方填写 6 6 3 4 命令体单元组成 由多个命令单元组成业务交互数据 命令单元组成命令单元组成 命令体单元数据域组成命令体单元数据域组成 命令单元 1命令单元 2 命令单元 N 1命令单元 N 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 14 字段传输接口字节长度说明 命令体长度必选 2bytes 标识本命令单元的数据长度 指的是从 命令体长度 到 命令值 的所有字节 总数 单位是字节 小于 4 为不合法的命 令单元长度 传输顺序 低字节传输在前 高字节传输在后 命令编码必选 2bytes 通信交互数据的统一标识号 在固定的模 式下 每个标识号都是唯一的 低字节传 输在前 高字节传输在后 命令值非必选不定长 平台查询终端时可以不填写 可以是字符 串 数值 数字串等数据 6 6 3 5 传输算法约定 校验算法校验算法 承载接入层和应用数据层的全部数据内容 按传输顺序进行校验 本协议规定 发送方发送的数据 采用 CRC 校验算法 生成多项式为 16 位的 x16 x12 x5 1 0 x11021 发送方根据通信包生成 2 字节的检验码 同样 接收方收到完整的数据包后 根据通 信包以及校验算法生成检验值 如果所计算出的校验值和收到的校验值相同 则表明该数 据包有效 否则认为该包在传输的过程中产生了差错 在正式产品中 对校验出错的命令 接收方不处理也不返回任何应答 校验单元的传输顺序为 低字节传输在前 高字节传输在后 字节转义字节转义 TAPA 协议由于使用 16 进制方式传输数据 为防止数据中出现与通信包起始标志 结 束标志相同的数据而影响这两个标志的判断 在发送和接收时必须进行数据的转义 在本 层协议中 对除起始标志和结束标志外的所有数据 转义规则 用 0 x5E 0 x5D 来代替 0 x5E 用 0 x5E 0 x7D 来代替 0 x7E 用 0 x5E 0 x5F 来代替 0 x7F 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 15 对于需要进行转义后发送的情况 要按照如下的顺序进行操作 发送数据包之前 先 生成校验值 再进行转义处理 接收到数据包后 先进行转义处理 再进行校验 字节拆分字节拆分 TAPB 协议中对所有数据统一采用 ASCII 码拆分处理 具体说明如下 8 比特的 16 进制数被划分为高 4bits 和低 4bits 对于高 4bits 和低 4bits 若其数值为 0 x00 0 x09 则加上 0 x30 传输 若其数值为 0 x0A 0 x0F 则加上 0 x37 传输 这样得到的结 果就转换为 ASCII 码 举例如下 对于数据 0 x2B 按照上述划分原则 高字节变成 0 x32 低字节变成 0 x42 采用 ASCII 码拆分处理 后 协议中定义的数据 如 1 字节的 16 进制 数 0 x2B 在实际传输中为 ASCII 码字符串 2B 传输顺序是 高 4bits 转换的字符在前 低 4bits 转换的字符在后 ASCII 码拆分处理 适用于协议中除起始标志 结束标志外的所有字符 包括校验 单元 对于需要进行拆分处理后发送的情况 要按照如下的顺序进行操作 发送数据包之前 先生成校验值 再采用 ASCII 码拆分处理 在接收到数据包后 先进行 ASCII 码拆分 处理 的反向处理 再进行校验 6 6 3 6 命令标识与业务数据单元 命令标识列表命令标识列表 命令标识业务消息域数据描述备注说明 0 x0000 错误标识 禁止使用 终端接入管理命令 0 x0001 终端开机登录终端开机上报本身状态 0 x0002 终端重连登录 通信链路断开后 终端进行重新登录 TCP IP 通信方式下有效 0 x0003 终端心跳连接 终端发送心跳包上报 用于 TCP IP 长连接通 信方式 0 x0004 终端接入鉴权 终端发送获取绑定业务号码命令 平台进行 合法性接入鉴权 只支持 SMS 短信方式 0 x0005 终端密钥重制 终端密钥重制均使用此命令 包括终端自动 索取以及平台主动发起 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 16 0 x0006 终端用户密码重制终端用户重制密码 0 x0007 0 x000F 系统保留 终端参数管理命令 0 x0010 终端参数查询平台查询终端数据 0 x0011 终端参数设置平台设置终端数据 0 x0012 终端程序升级终端程序升级交互过程均使用该命令 0 x0013 0 x0020 系统保留 业务交互参数命令 0 x0021 业务参数更新 包括业务菜单 套餐类型 增值业务列表 选号规则列表等业务数据更新均用此命令 0 x0022 收件箱信息交互平台与终端的收件箱功能信息交互使用 0 x0023 0 x0029 系统保留 金融信息参数 0 x002A 日对帐信息交互获取日对帐信息的数据交互所使用 0 x002B SIM 卡销存信息交互获取 SIM 卡销存信息的数据交互所使用 0 x002C 号码销存信息交互获取号码销存信息的数据交互所使用 0 x002D 0 x002F 系统保留 异常处理参数 0 x0041 终端异常交易记录上报终端记录到异常交易记录上报命令 0 x0042 终端异常交易清除清楚终端异常交易命令 0 x0043 0 x004F 系统保留 查询类业务 0 x0101 获取随机密码短信索取随机密码短信均使用此命令 0 x0102 验证随机密码短信终端发送随机密码等待平台验证 0 x0103 手机话费查询用于查询手机话费类型所使用 0 x0104 银行卡余额查询查询银行卡的余额信息使用 0 x0105 手机用户查询用于充值时查询手机账户名 0 x0106 套餐查询用于查询套餐详情 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 17 0 x0107 增值业务查询用于查询手机开通的增值业务 0 x0108 银行卡卡号查询用于查询银行卡卡号号码 0 x0109 上笔电子卡查询用于查询上笔电子卡业务查询 0 x010A 0 x01FF 系统保留 缴费类业务 0 x0201 索取交易标识码 0 x0202 缴费充值缴费充值均使用此命令进行交互 0 x0203 终端成功交易回复确认终端成功交易记录确认命令 0 x0204 缴费终端成功交易回复 确认结束 缴费终端成功交易回复确认结束符 0 x0205 缴费充值成功短信通知终端发起交易成功的短信通知请求 0 x0206 0 x02FF 系统保留 购买电子卡业务 0 x0301 索取交易标识码 0 x0302 购买电子充值卡购买电子充值卡请求使用此命令 0 x0303 终端成功交易回复确认终端成功交易记录确认命令 0 x0304 购买电子卡终端成功交 易回复确认结束 购买电子卡终端成功交易回复确认结束符 0 x0305 0 x03FF 系统保留 号卡销售类业务 0 x0401 获取号源信息 号卡销售过程中 终端使用此命令获取号源 信息交互 0 x0402 品牌信息交互 号卡销售过程中 终端使用此命令获取品牌 信息交互 0 x0403 选号规则上传 号卡销售过程中 终端使用此命令发起符合 选号规则的手机号码请求 平台回复时 使 用此命令下发符合规则的手机号码列表 0 x0404 预占号码请求号卡销售过程中 终端使用此命令发起选定 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 18 的手机号码准备预占请求 平台回复时 使 用此命令回复预占成功与否 0 x0405 获取产品包列表 号卡销售过程中 终端使用此命令获取手机 号可选的产品包列表 0 x0406 获取各类详情 号卡销售过程中 终端使用此命令上传用户 选定的各类编码 平台则回复该编码对应的 详细信息 0 x0407 获取产品包费用详情 号卡销售过程中 终端使用此命令上传用户 选定的产品包编码 平台则回复该产品包以 及号码对应的费用信息 0 x0408 号卡销售退出命令号卡销售流程开户之前退出操作时告知平台 0 x0409 号卡销售心跳命令 号卡销售流程开户之前告知平台还处在流程 过程中 0 x040A 索取交易标识码 0 x040B 发送开户请求 号卡销售过程中 终端使用此命令上传开户 信息 包含选定号码 SIM 卡号 客户证件 类型 证件号码 客户姓名 客户地址 客 户联系电话等 0 x040C 终端成功交易回复确认终端成功交易记录确认命令 0 x040D 终端成功交易回复确认 结束符 终端成功交易记录确认命令结束符 0 x040E 自定义 sim 卡查询用于号卡销售时查询 sim 卡号码 0 x040F 身份证信息验证用于号卡销售时身份证信息验证 0 x0410 默认客户信息用于号卡销售时默认客户信息查询 0 x0411 0 x04FF 系统保留 其他增值类业务 0 x0501 获取当前帐号套餐类型套餐变更交互使用 0 x0502 获取系统套餐信息套餐变更交互使用 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 19 0 x0503 变更当前帐号套餐类型套餐变更交互使用 0 x0504 增值业务受理增值业务受理过程中使用 0 x0505 特殊服务受理特殊服务受理过程中使用 0 x0506 手机帐户服务密码更改手机帐户服务密码更改使用 0 x0507 获取开户状态查询手机号码 SIM 卡号的开户成功与否 0 x0508 0 x05FF 系统保留 其他业务参数 0 x0601 0 xEFEF 系统保留厂家不得占用 厂家自定义参数 0 xF001 0 xFFFE 厂家自定义命令段 业务数据单元定义业务数据单元定义 命令值数据格式说明命令值数据格式说明 数字串数字串 记为 str 型 由多个 ASCII 码组成 长度由各个命令单元进行限定 但不能够超过协议对通信包长度的要求 str12 中 的 12 表示表示该数据串的固定长度 当实际数据不足 12 位时 需要用空格 0 x20 补齐 下文中的 strN 表示 str 为可变的数据长度 最大数据长度为 N Max Max 表示该命令 编码支持的最大数据长度 实际数据长度不足最大长度时 不需要补充 传输要求 按数字串自身的顺序 由左向右逐个字节传输 对于 str 数据串类型 以实际字符串长度进行传输 数据通信过程不再添加传输结束符 0 x0A 用途 同时传输多个相关的内容 比如时间等 BCD 码码 记为 bcd 型 可由多个 16 进制的数据码组成 长度由各个命令单元进行限定 但不能够超过协议对通信包长度的要求 bcd12 中 的 12 表示表示该 bcd 串的固定长度 当实际数据不足 12 位时 需要用 0 x00 补齐 下 文中的 bcdN 表示 bcd 为可变的数据长度 最大数据长度为 N Max Max 表示该命令 编码支持的最大数据长度 实际数据长度不足最大长度时 不需要补充 传输要求 按 BCD 串自身的顺序 由左向右逐个字节传输 用途 同时传输多个相关的内容 比如压缩的时间信息等 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 20 数值数值 1 个字节的无符号整数 记为 uint1 型 占用 1 个字节 为无符号整型数 可表示的范围 0 255 传输要求 整个字节传输 用途 传输范围比较小的数值 2 个字节的有符号整数 记为 sint2 型 占用 2 个字节 为用补码表示的有符号整型数 可表示的范围 32767 32767 传输要求 低字节先传输 用途 传输范围比较大的数值 2 个字节的无符号整数 记为 uint2 型 占用 2 个字节 为无符号整型数 可表示的范围 0 65535 传输要求 低字节先传输 用途 传输范围比较大的数值 4 个字节的无符号整数 记为 uint4 型 占用 4 个字节 为无符号整型数 可表示的范围 0 传输要求 低字节先传输 用途 传输范围非常大的数值 4 个字节的有符号整数 记为 sint4 型 占用 4 个字节 为有符号整型数 可表示的范围 传输要求 低字节先传输 用途 传输范围非常大的数值 比如银行卡余额等 传输比例传输比例 对表示物理量的数值而言 往往具有小数 为能够表示小数点位置 在传输时 可以定义一个比例 比如 当定义比例为 100 时 传输值 12345 就表示 123 45 本规 范中 对于定义了传输比例的监控数据 会在数据标识的编号表中明确指出 凡是未 指出比例的命令标识数据 可以认为比例为 1 6 6 3 7 命令单元列表 命令编码数据类型标识含义命令值描述 终端信息参数 只读 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 21 0 x0000 无效标识禁止使用 0 x0001uint2 终端设备类型设备类型 厂家自定义 0 x0002 strN N 20 终端设备型号终端型号简要描述 厂家自定义 0 x0003 strN N 20 终端设备序列号终端生产序列号 IMEI 号 0 x0004 strN N 20 终端硬件版本号终端设备硬件版本信息 0 x0005 strN N 20 终端软件版本号终端设备软件版本信息 0 x0006 strN N 20 终端用户工号用户工号 0 x0007str20 终端用户密码用户密码 0 x0008 strN N 20 终端绑定的业务号码 终端与 PSAM 卡绑定的电话号码 包 括手机号码和固定电话号码 0 x0009 0 x007F 保留参数 终端远程软件升级 可读写 0 x0080uint1 终端程序升级文件传 输方式 0 x01 报文传输 0 x02 FTP 文件传输 0 x0081uint1 终端程序升级状态 0 x00 升级成功 出厂设置默认 0 x01 升级文件传输暂停 停止升 级 0 x02 升级文件传输错误 升级失 败 0 x03 升级文件保存失败 升级失 败 0 x04 升级文件内容错误 升级失 败 0 x05 升级过程发生异常 升级失 败 0 xFD 终端程序升级就绪 应答平台 主动升级时使用 0 xFE 终端请求进行程序升级 终端 主动请求升级时使用 0 xFF 终端不支持程序升级 0 x06 0 xFC 保留 0 x0082uint2 终端支持的最大数据 块长度 终端主动上报 uint1 终端程序升级文件标 识码 文件状态 0 x00 文件不存在 0 x01 有文件存在 uint2 终端程序升级文件标 识码 文件索引值 文件 CRC16 值 文件状态为 0 x00 时 填写为 0 x0000 0 x0083 str17 终端程序升级文件标由厂家自定义 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 22 识码 文件描述信息头 6 个为软件发布日期 BCD 码 后 11 个为软件文件名 bcd2 终端程序升级预约时 间 开始时间 24 进制值传输 0 x0084 bcd2 终端程序升级预约时 间 结束时间 24 进制值传输 uint2 终端程序文件传输 数据域有效标志开关 从 bit0 bit15 分别表示下属数据域 的有效性 0 当前无此数据域 1 当前有此数据域 uint2 终端程序文件传输 当前文件块序号 终端程序文件分块序号 从 0 x0000 开始编起 平台根据终端支持的最 大数据块长度进行分块 0 x0085 strN N 1024 终端程序文件传输 文件块内容 数据长度受终端支持的最大数据块 长度限制 0 x0086uint1 终端程序文件传输 传输控制状态 0 x00 无升级文件传输 终止升级 0 x01 升级文件传输进行中 0 x02 升级文件传输结束 请检查 0 x03 平台准备开始发送数据 0 x04 平台主动发起更新命令 0 x05 0 xFF 保留 0 x0087 0 x00FF 保留参数 终端连接参数 读 写 0 x0101str20 业务中心电话号码业务交易的拨号中心号码 0 x0102str20 业务中心短信号码业务交易的短信中心号码 0 x0103uint1 无线接入传输协议类 型 0 x01 TCP IP 协议 0 x02 UDP IP 协议 uint4 业务中心服务器信息 IP 地址 IPv4 业务中心服务器 IP 地址 传输顺序 按照 192 168 2 19 的顺序传输 uint2 业务中心服务器信息 发送端口 业务中心服务器发送端口 0 x0104 uint2 业务中心服务器信息 接收端口 UDP 业务中心服务器接收端口 uint4 升级中心服务器信息 IP 地址 IPv4 升级中心服务器 IP 地址 传输顺序 按照 192 168 2 19 的顺序传输 uint2 升级中心服务器信息 发送端口 升级中心服务器发送端口 0 x0105 uint2 升级中心服务器信息 接收端口 UDP 升级中心服务器接收端口 0 x0106 strN N 20 无线接入点名称接入点名称 0 x0107strN 无线接入用户标识接入的用户标识 中国联通电子渠道 Mini 电子营业厅平台终端接口技术规范 23 N 20 0 x0108 strN N 20 无线接入用户口令接入的用户口令 uint4 FTP 服务器信息 IP 地址 IPv4 FTP 服务器 IP 地址 传输顺序 按 照 192 168 2 19 的顺序传输 0 x0109 uint2 FTP 服务器信息 端 口 FTP 服务器发送端口 0 x010A strN N 20 FTP 服务器升级操作 用户名 FTP 服务器登录用户名 0 x010B strN N 20 FTP 服务器升级操作 用户口令 FTP 服务器登录用户口令 0 x010C strN N 40 FTP 服务器升级文件 相对路径 FTP 服务器升级文件相对路径 0 x010D strN N 40 FTP 服务器升级文件 名 FTP 服务器升级文件名 0 x010Euint1 FTP 文件传输控制 1 开始升级 重新开始升级 2 从上次断点处恢复升级 3 表示接入平台取消升级 并且保存 已下载数据 断点 4 表示接入平台取消升级 不保存已 下载数据 断点 其他为系统保留值 0 x010Fuint1 GPRS 模式链路连接 方式 0 x00 无 0 x01 长连接方式 0 x02 短连接方式 0 x0110 0 x0140 终端配置参数 只写 0 x0141str14 设备当前时间 YYYYMMDDHHMMSS uint1 设备当前状态 状态 标志 0 x01 设备正常 可发起交易 0 x02 设备被停用 无法远程连接 0 x03 设备被注销 无法远程连接 0 x04 密码 密钥连续输入异常被锁 定 禁止交易 0 x0142 strN N 50 设备当前状态 描述 信息 当设备状态为停用和注销时有效 0 x0143 strN N 72 终端开机欢迎语 平台下发时 填写终端开机