广东电信ibss(crm)与绿色上网平台接口规范v.docx

广东电信 旧SS(CRM)与绿色上网平台
接口规范
(版本:)
广东省电信有限公司
2009年7月
修订号
修订日期
修订内容简述
修订人
版本号
1
2009-7-22
新建
夏勇

2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
目录
修订控制页 2
概述 4
编写目的 4
缩略语 4
文档约定 4
接口约定 4
接口模型 5
交互说明 5
接口通信方式 5
同步接口 5
接口数据包头格式 6
接口数据包体 7
包体结^^定义 7
包体公共参数定义 7
开通接口包体参数定义 8
接收工单包体 8
参数 key 值说明 8
回复包包体 9
业务所需参数说明 9
开户 9
销户 9
资料变更 10
帐号变更 10
静态数据定义 10
产品类型 10
业务类型 10
系统 ID 11
工单类型 11
返回值 11
1概述
编写目的
本分册主要是用来规范：IBSS 与绿色上网平台系统之间，进行传递绿色 上网相应业务的工单数据，并包括消息包包体参数以及静态数据的定义。
缩略语
? 旧SS:综合业务支撑系统
? CRM客户关系管理系统
文档约定
接口约定
? 需要绿色上网平台有工单唯一的处理机制，即同一条工单网络开通
不会重复处理，工单号的唯一性由 旧SS来保证。要求绿色上网平台 具备重复工单的处理功能，对重复工单，将原处理结果回单给 IBSS(CRM)
?绿色上网平台需要根据超时机制，同步接口链接超时则断开连接。
? 超时重新发送工单的时间间隔和接口方式有紧密的关联：要求超时 间隔时间设置较短；超时重发时间间隔暂定为 15秒；如有异议，可 进一步和各接口侧协商。
? IBSS与绿色上网平台协商一致的失败原因代码表。
? 产品功能变动时，要求旧SS系统将所有的产品最新功能发送给绿色 上网平台，绿色上网平台来决定是否需要处理。
? 对于同步连接中断的情况，原来发送过来的单需要查询历史库，可
以厂家自己考虑历史跨度，建议跨度一个月即可。如果原来已处理 则直接回单，否则可以正常施工。
?目前的工单号为：旧SS内部工单号+流水号，重新派发的工单，此号 码不能重复。对于同步连接中断的情况不能改变此号码。
2接口模型
绿色上网和前端业务系统的接口通信基于 TCP/IP。TCP/IP底层连接为
长连接。由绿色上网平台侧建立服务进行监听，前端业务系统发送请求前必 须先建立连接，然后发送工单请求包。
在绿色上网平台处理完毕工单请求包后，需要对前端业务系统进行回复。 回复方式分为:直接以socket方式回复。
接口通信方式根据业务的需求，采用同步的方式，分别在不同的端口上 进行实例化。
3交互说明
同步接口：旧SS/CRM向绿色上网平台发送开通请求，平台收到请求后 同步返回处理结果给旧SS/CRM 。
4接口通信方式

该种接口方式适合对实时性要求高的接口平台和业务类型。下图给出了 实现模型。
同步接口方式
业务.
回
同步接口要求定义相应的错误码， 哪些需要 旧SS处理、哪些需要绿色上
网平台开通处理需要区分开来。
同步接口采用全双工模式，即收发单可以同时进行，但是 一个链接上发送与接收工单。
5接口数据包头格式
项目
长度(BYTES)
说明
包开始标志
4
内容恒定为“ ffff
包的标识号
10
流水号，由数字转换成字符 串，长度不足在左边补字符 串‘0'
包的类型
2
01:旧SS发去绿色上网平 台的施工数据
03:绿色上网平台发送给 IBSS的施工结果
包长度
6
包长度为整个包长度，数字 转换成字符串，长度不足在 左边补字符串’0'
参数个数
4
数字转换成字符串，左补字 符串’0'
发送系统ID
2
见静态数据
接收系统ID
2
见静态数据
认证密码
6
IBSS01
预留空间
10
备用
包体
可受长度
结构参见卜面的描述
注：IBSS 发送包头示例：FFFF000840217901000**********IBSS01
绿色上网平台回复包头示例： FFFF0008402179030001390005
6接口数据包体
包体结构定义
包体