云南联通外围接口业务梳理 1 概述 本文档所涉及业务均为 H2 实时业务。 2 H2 接口 2.1 [关于 H 接口的说明] H 参考点是客服系统与其他外部系统之间的接口。该接口分为与全国客服中心系统之间的接 口 H1 和与其他相关运营系统之间的接口 H2，数据接口 H3。 [接口定义原则] 遵循软件工程及制定协议标准的基本思想，本着接口易用、易理解、易交流的原则，为实现 客服系统的规范性、开放性、扩展性、业务独立性提供保证。 [业务类型编码原则] 编码总则一：中国联通客服 H 接口编码标准规则满足唯一标识客服 H 接口中的实体及其属性 的需求。编码采用十进制编码。 编码总则二：编码主要采用分层的方式，共分为四层，每层对应若干位编码。编码位的具体 值参见相应的映射表。 编码总则三：编码的第 1 位代表是 H 的信息类别。，编码格式和每个字节所代表的具体含义 可以参考后面的各个章节的具体描述。 编码总则四：编码长度为 12 个字节，至左向右编码位从低到高。用下面的表来表示每个字 节的数据对应关系。 X1 X2 X3 X4 X5 X6 X7 X8 X9 X10 X11 X12 [H2 接口方式] 采用事务交易设计，以保证传输数据的安全正确。 采用中间件技术，使接口定义简单明晰。 根据交易的类型，决定交易回应的时限。 [数据包协议] 包头数据内容为一定长 ASCII 字符串（86 位），具体内容如下： 字段名称 A0 版本号信息 A1 数据包大小 A2 流水号 长度 （2 位） （5 位） （20 位） 说明 标识当前使用的协议版本号 以字节为单位，不足右补空格 业务流水号，标志每笔具体交易。数据校 1 

云南联通外围接口业务梳理 字段名称 长度 A3 标志 A4 服务类型 A5 业务号码 A6 业务号码类型 A7 营业点 A8 营业员 A9 包编号 （1 位） （12 位） （20 位） （1 位） （6 位） （8 位） （5 位） A10 最后一包标志 （1 位） A11 错误码 （5 位） 说明 验包可以无流水号 1 表示成功 0 表示失败，仅适用于响应包 编码规则参见《中国联通客服中心 H2 接 口编码规则》 移动电话号码 1 电话号码；2 帐号；3 其他 业务受理地点 业务受理人 标志该笔流水的第几包数据 在进行多包发送的情况下，该标志用以标 明是否为最后一数据包。1 最后一包数据， 无后续包；0 非最后一包数据，有后续包， 连接错误，I/O 错误等 在标志为失败时需要检查该错误码。错误 码包括系统操作错误和业务处理错误 包体定义如下：一个数据包总长度不可大于 4K。对存在多条返回记录的业务，一数据包可 含多条记录。长度如超过 4K，就以多包数据发送。每字段之间用“TAB 键 0x09”分隔，每 记录之间用“回车键 0x0d,0x0a”分隔，包结束用“0x1a”。对于不同的服务类型，其请求 包和应答包的包体具有不同的内容。 [常见错误] 错误编码 00000-00499 为固定编码，不做变动，错误代码表也存在。 错误编码 00500-99999 为非固定编码，需要通过错误代码表提取错误信息。 固定编码 00400-00499 为系统错误。如网络连接错误，I/O 错误等。 2.2 活动订购 功能描述  根据用户选择的活动，为用户订购此活动。 模块内外部接口 接口名称: 990000000001 请求包体 名称 活动 ID 终端型号 终端串号 长度 （10） （32） （20） 格式 2 

云南联通外围接口业务梳理 名称 订购/取消 生效模式 长度 （1） （1） 格式 1 订购；0 取消 0：立即生效；1 下月生效 应答包体 无 2.3 终端串号修改 功能描述  修改用户终端串号 模块内外部接口 接口名称: 990000000002 请求包体 名称 老的终端串号 新终端型号 新终端串号 应答包体 无 长度 （20） （32） （20） 格式 3