中国电信CRMPFRM接口规范试行稿V08.docx
《中国电信CRMPFRM接口规范试行稿V08.docx》由会员分享，可在线阅读，更多相关《中国电信CRMPFRM接口规范试行稿V08.docx（100页珍藏版）》请在冰豆网上搜索。
中国电信CRMPFRM接口规范试行稿V08
中国电信
CRM、服务开通系统、网络资源管理系统
接口规范
（试行稿V0.8）
目录
1概述7
1.1项目背景7
1.2项目目标7
1.3接口规范范围7
2基础协议9
2.1阻塞方式9
2.1.1通讯端口9
2.1.2通讯包格式10
2.1.3XML数据包格式10
3公共数据模型11
3.1概念模型11
3.1.1CRM11
3.1.2PF11
3.1.3RM12
3.1.4模型说明12
3.2逻辑模型13
3.2.1客户13
3.2.2产品17
3.2.3服务定单20
3.2.4工单26
3.2.5产品实例28
3.2.6资源实例（RES_INST）30
3.2.7割接33
3.2.8方案设计36
4系统功能边界38
4.1资源确认38
4.2定单处理38
4.3竣工处理38
4.4流程查询38
4.5改单处理39
4.6撤单处理39
4.7待装处理39
4.8待装开装39
4.9客户缓装39
4.10取消缓装40
4.11工程割接40
5接口描述41
5.1接口清单41
5.2产品资源确认44
5.2.1资源确认时序图44
5.2.2接口列表44
5.3方案设计47
5.3.1方案设计时序图47
5.3.2接口列表47
5.4预留资源/释放资源51
5.4.1预留资源/释放资源时序图51
5.4.2接口列表51
5.5定单处理53
5.5.1定单时序图54
5.5.2接口列表56
5.6流程查询64
5.6.1流程查询时序图64
5.6.2接口列表64
5.7改单处理66
5.7.1改单处理时序图66
5.7.2接口列表66
5.8撤单处理67
5.8.1撤单处理时序图68
5.8.2接口列表68
5.9待装处理69
5.9.1待装处理时序图70
5.9.2接口列表70
5.10待装开装72
5.10.1待装开装时序图73
5.10.2接口列表73
5.11客户申请缓装75
5.11.1客户申请缓装时序图76
5.11.2接口列表76
5.12客户取消缓装77
5.12.1客户取消缓装时序图78
5.12.2接口列表78
5.13锁单和取消锁单79
5.13.1资源预留和回收时序图80
5.13.2接口列表80
5.14工程割接82
5.14.1工程割接时序图83
5.14.2接口列表85
1概述
1.1项目背景
中国电信集团公司及下属省（市）电信公司正在进行九七系统升级改造的规划和建设，同时集团对资源系统建设提出了下一步的指导意见。
指导意见中，将建设统一的全资源管理系统和统一资源管理系统版本作为资源建设的目标。
在这样的前提下，如何规范新的业务环境下各系统（CRM系统、业务开通、资源管理系统等）之间的关系，形成适合新业务环境的全程全网的开通流程将成为集团和相关软件厂商的近期工作重点。
其中，确定CRM系统、业务开通、资源管理系统三个系统间的功能边界、接口规范，制定合理的工作计划和工作方式将至关重要。
1.2项目目标
为了支撑中国电信提出的“以客户为中心，以市场为导向，以效益为目标”的企业运营战略，支持现有业务以及新业务的发展需求，提升响应未来市场和业务变化的能力，本次规划建设将重点支撑以下业务目标的实现：
1.根据资源管理思路的调整，BSS/OSS厂商共同研究，确定CRM系统、服务开通系统、资源管理系统之间的接口定义和功能划分。
2.确定资源管理系统面向外部的接口规范（如CRM、服务开通等），并在规范的指导下完成接口联合开发及接口试点工作。
3.集团公司引入多家厂商进行联合开发。
各厂商可以基于97（BSS）改造的经验对资源管理系统提出要求及建议，以使集团公司进一步明确资源管理系统改进及完善发展方向。
在统一资源管理系统版本基础上，研究联合开发模式和有效的管控模式。
1.3接口规范范围
本次接口规范范围如下图所示：
图1-1接口范围
●规范所涉及三个接口分别为：
⏹A接口：
业务开通系统与资源管理系统之间的接口。
⏹B接口：
CRM系统与业务开通系统之间的接口。
⏹C接口：
CRM系统与资源管理系统之间接口。
●接口规范包括如下内容：
⏹接口形式
⏹接口处理时序图和功能边界
⏹接口功能描述
⏹接口消息格式
2基础协议
在CRM、PF、RM之间存在大量的同步，在减轻系统资源和提高同步效率的基础上，系统之间采用实时的TCP/IP常连接，为了保证系统业务的正常运转，要求双方的接口监控部分能够提供相应的机制确保接口的通讯不中断。
图2-1基础协议
双方的接口采用的是专门的接口模块来完成，因此双方的数据库资源互不开放，业务事务的处理各自独立。
双方的通讯包完全采用XML格式数据，每次接收到的数据包，在解析该包之后，可以同时得到操作的动作指令和相关参数信息。
2.1阻塞方式
各方将数据包发过去之后，必须等待对方返回回应数据包，在Timeout之内不得发送其它数据包。
Timeout应该支持参数设定。
双方应该自身提供相应的数据队列和日志处理机制来保证数据的一致性。
2.1.1通讯端口
自定义。
2.1.2通讯包格式
采用TCP/IP传xml格式文本的方式实现，所有的向外部系统的服务请求，首先在接口服务请求组件打包为xml格式文本之后，然后以如下格式打包为TCP/IP包，传递到接口服务代理模块。
图2-2通讯包格式
项目
长度（bytes）
说明
包头
2
内容恒定为”\0x01\0x02”
发送系统ID
2
待定
接受系统ID
2
待定
认证密码
8
定长为8位，不足在后以”\0”补足8位
保留
2
暂时不用
XML文本长度
4
后续的XML文本长度，采用网络字节顺序
XML文本
xml文本的内容
包尾
2
内容恒定为”\0xfe\0xff”
2.1.3XML数据包格式
通过SOCKET连接交换的数据包全部采用XML格式，XML是当今事实上的工业标准，这样的话就不需双方定义自己的专用数据构成格式，关心的只有业务逻辑部分。
XML数据包中所有字符均为大小写敏感。
XML数据包采用”GBK”编码格式。
3公共数据模型
3.1概念模型
3.1.1CRM
图3-1CRM概念模型
3.1.2PF
图3-2PF概念模型
3.1.3RM
图3-3RM概念模型
3.1.4模型说明
Ø对于未加解释的模型参照EDM2.0说明，以下表格只定义了在本规范中新出现的概念
Ø绿色部分实体表示归属关系，此系统负责创建，红色表示需要使用该部分实体数据
Ø实体数字表示实体出现的次数，如“资源实例：
1”等同于“资源实例”
实体
所属系统
定义
资源实例
PF/RM
产品实例占用的资源实体的集合
3.2逻辑模型
3.2.1客户
图3-4客户
3.2.1.1客户（CUST）
编号
字段名
英文名
类型/长度
是否可空
枚举值
说明
1
客户标识
CUST_ID
NUMBER（9）
N
2
客户编码
CUST_CODE
VARCHAR2（60）
Y
3
客户名称
CUST_NAME
VARCHAR2（255）
N
4
客户等级标识
CUST_GRADE_ID
NUMBER（3）
N
5
客户类型标识
CUST_TYPE
VARCHAR2（3）
N
6
EMAIL
EMAIL
VARCHAR2（120）
Y
7
邮政编码
ZIPCODE
VARCHAR2（60）
Y
8
地址
ADDRESS
VARCHAR2（255）
Y
9
创建日期
CREATED_DATE
DATE
N
10
客户修改时间
UPDATE_DATE
DATE
N
11
状态
STATE
VARCHAR2（3）
N
1有效,
0失效
12
状态时间
STATE_DATE
DATE
N
13
地区编码
AREA_ID
VARCHAR2（8）
N
14
证件类型
CERT_TYPE
VARCHAR2（3）
Y
15
证件号码
CERT_NBR
VARCHAR2（120）
Y
16
社区经理标识
CUST_MANAGE_ID
NUMBER（9）
Y
3.2.1.2客户联系信息（LINKMAN）
编号
字段名
英文名
类型/长度
是否可空
枚举值
说明
1
客户标识
CUST_ID
NUMBER（9）
N
2
联系信息标识
LINK_ID
NUMBER（9）
N
3
名称
LINKMAN_NAME
VARCHAR2（120）
N
4
性别
SEX
CHAR
（1）
N
1男
0女
5
办公电话
OFFICE_PHONE
VARCHAR2（60）
Y
6
住宅电话
HOME_PHONE
VARCHAR2（60）
Y
7
移动电话
MOBILE_PHONE
VARCHAR2（60）
Y
8
传真号码
FAX
VARCHAR2（60）
Y
9
邮政编码
ZIPCODE
VARCHAR2（60）
Y
10
通讯地址
MAIL_ADDR
VARCHAR2（120）
Y
11
EMAIL
EMAIL
VARCHAR2（120）
Y
12
首选联系方式
MAIN_COMM
VARCHAR2（60）
Y
13
说明
COMMENTS
VARCHAR2（4000）
Y
14
创建日期
CREATED_DATE
DATE
N
15
联系人修改时间
UPDATE_DATE
DATE
N
16
状态
STATE
VARCHAR2（3）
N
1有效,
0失效
17
状态时间
STATE_DATE
DATE
N
3.2.1.3客户类型（CUST_TYPE）
编号
字段名
英文名
类型/长度
是否可空
枚举值
说明
1
客户类型标识
CUST_TYPE
VARCHAR2（3）
N
大客户/商业客户/公众客户等由省公司统一制定分级规则
2
客户类型名称
CUST_TYPE_NAME
VARCHAR2（60）
N
3
说明
COMMENTS
VARCHAR2（120）
Y
3.2.1.4客户等级（CUST_GRADE）
编号
字段名
英文名
类型/长度
是否可空
枚举值
说明
1
客户等级标识
CUST_GRADE_ID
NUMBER（3）
N
砖石/黄金等由省公司统一制定分级规则
2
名称
GRADE_NAME
VARCHAR2（60）
N
3
说明
COMMENTS
VARCHAR2（120）
Y
3.2.1.5社区经理（CUST_MANAGER）
编号
字段名
英文名
类型/长度
是否可空
枚举值
说明
1
社区经理标识
CUST_MANAGER_ID
NUMBER（9）
N
2
名称
NAME
VARCHAR2（120）
N
3
性别
SEX
CHAR
（1）
N
1男,
0女
4
办公电话
OFFICE_PHONE
VARCHAR2（60）
Y
5
住宅电话
HOME_PHONE
VARCHAR2（60）
Y
6
移动电话
MOBILE_PHONE
VARCHAR2（60）
Y
7
传真号码
FAX
VARCHAR2（60）
Y
8
邮政编码
ZIPCODE
VARCHAR2（60）
Y
9
通讯地址
MAIL_ADDR
VARCHAR2（120）
Y
10
EMAIL
EMAIL
VARCHAR2（120）
Y
3.2.2产品
图3-5产品
3.2.2.1产品（PROD）
编号
字段名
英文名
类型/长度
是否可空
枚举值
说明
1
产品标识
PROD_ID
NUMBER（9）
N
2
产品名称
PROD_NAME
VARCHAR2（30）
N
3
产品类型
PROD_TYPE
VARCHAR2（6）
Y
实施商统一约定
4
产品分类标识
PROD_CAT_ID
NUMBER（9）
N
实施商统一约定
5
产品编码
PROD_CODE
VARCHAR2（20）
N
6
产品外部编码
PROD_EX_CODE
VARCHAR2（20）
Y
7
产品外部类型
PROD_EX_TYPE
VARCHAR2（6）
Y
实施商统一约定
8
生效日期
EFF_DATE
DATE
Y
9
失效日期
EXP_DATE
DATE
Y
10
状态
STATE
VARCHAR2（3）
1有效,
0失效
11
状态变动日期
STATE_DATE
DATE
N
12
修改日期
MODI_DATE
DATE
Y
13
备注
REMARK
VARCHAR2（255）
Y
3.2.2.2产品目录（PROD_CATALOG）
编号
字段名
英文名
类型/长度
是否可空
枚举值
说明
1
产品目录标识
PROD_CAT_ID
NUMBER（9）
N
2
产品目录编码
PROD_CAT_CODE
VARCHAR2（20）
N
3
产品目录名称
PROD_CAT_NAME
VARCHAR2（30）
N
4
产品目录类型
PROD_CAT_TYPE
VARCHAR2（6）
N
实施时约定
5
上级产品目录标识
PARENT_CAT_ID
NUMBER（9）
N
6
状态
STATE
VARCHAR2（6）
N
1有效,
0失效
7
状态变动日期
STATE_DATE
DATE
N
8
修改日期
MODI_DATE
DATE
N
9
备注
REMARK
VARCHAR2（4000）
Y
3.2.2.3产品-特性关系（PROD_ATTR）
编号
字段名
英文名
类型/长度
是否可空
枚举值
说明
1
产品标识
PROD_ID
NUMBER（9）
N
2
特性标识
ATTR_ID
NUMBER（9）
N
4
状态
STATE
VARCHAR2（6）
N
1有效
0失效
5
状态变动日期
STATE_DATE
DATE
N
6
修改日期
MOD_DATE
DATE
Y
7
备注
REMARK
VARCHAR2（100）
Y
3.2.2.4特性（ATTR）
编号
字段名
英文名
类型/长度
是否可空
枚举值
说明
1
特性标识
ATTR_ID
NUMBER（9）
N
2
特性编码
ATTR_CODE
VARCHAR2（20）
N
3
特性名称
ATTR_NAME
VARCHAR2（30）
N
4
特性值长度
ATTR_LENGTH
NUMBER（9）
N
5
状态
STATE
VARCHAR2（6）
N
1有效,
0失效
6
状态变动日期
STATE_DATE
DATE
N
7
修改日期
MOD_DATE
DATE
Y
8
备注
REMARK
VARCHAR2（100）
Y
3.2.2.5操作（ACTION_TYPE）
编号
字段名
英文名
类型/长度
是否可空
枚举值
说明
1
操作
ACTION_TYPE
VARCHAR2（3）
N
包括：
装机/拆机/单停/双停/用户报停等；实施再根据省公司规则配置
2
操作名称
ACTION_TYPE_NAME
VARCHAR2（60）
N
3
操作说明
COMMENTS
VARCHAR2（255）
Y
3.2.3服务定单
图3-6服务定单－主体
图3-7服务定单－资源相关
3.2.3.1群组类型（PROD_GROUP_TYPE）
编号
字段名
英文名
类型/长度
是否可空
枚举值
说明
1
群组类型
PROD_GROUP_TYPE
VARCHAR2（3）
N
1,CENTREX
2,中继
3,电话加装ADSL
4,
2
群组类型名称
PROD_GROUP_TYPE_NAME
VARCHAR2（60）
N
3
说明
COMMENTS
VARCHAR2（120）
N
3.2.3.2定单参与人关联（ORDER_PARTY）
编号
字段名
英文名
类型/长度
是否可空
枚举值
说明
1
服务定单标识
SERVICE_ORDER_ID
NUMBER（9）
N
2
角色类型
ROLE_TYPE
VARCHAR2（3）
N
1,使用者2,维护者
3
参与人类型
PARTY_TYPE
VARCHAR2（3）
N
1,客户
2,内部员工
4
参与人标识
PARTY_ID
VARCHAR2（60）
N
5
参与人名称
PARTY_NAME
VARCHAR2（255）
N
6
原参与人标识
OLD_PARTY_ID
VARCHAR2（60）
Y
7
原参与人名称
OLD_PARTY_NAME
VARCHAR2（255）
Y
3.2.3.3定单组（GROUP_ORDER）
编号
字段名
英文名
类型/长度
是否可空
枚举值
说明
1
定单组标识
GROUP_ORDER_ID
NUMBER（9）
N
2
定单组编号
GROUP_ORDER_CODE
VARCHAR2（255）
N
3
主服务定单标识
MAIN_ORDER_ID
NUMBER（9）
Y
4
产品实例组标识
PROD_INST_GROUP_ID
NUMBER（9）
N
5
群组类型
PROD_GROUP_TYPE
VARCHAR2（3）
N
同“群组类型”定义
6
备注
REMARKS
VARCHAR2（4000）
Y
7
定单数量
ORDER_NUM
NUMBER（6）
N
8
同步标志
SYNCH_FLAG
CHAR
（1）
Y
1同步
0不同步
3.2.3.4服务定单（SERVICE_ORDER）
编号
字段名
英文名
类型/长度
是否可空
枚举值
说明
1
服务定单标识
SERVICE_ORDER_ID
NUMBER（9）
N
2
定单编码
PROD_ORDER_ID
VARCHAR2（12）
N
3
定单类型
ORDER_TYPE
CHAR
（1）
N
1预定单
2倒装机
3正常定单
4
接入信息标识
ACCESS_ID
NUMBER（9）
Y
5
对端接入信息标识
Z_ACCESS_ID
NUMBER（9）
Y
6
定单优先级
PRIO_GRADE
NUMBER
（2）
Y
实施时再定义
7
操作类型
ACTION_TYPE
VARCHAR2（3）
N
新装/拆机等
实施时再定义
8
产品标识
PROD_ID
VARCHAR2（11）
N
9
产品实例编码
PROD_INST_ID
VARCHAR2（11）
Y
10
联系人
CONTACT_NAME
VARCHAR2（120）
Y
11
联系电话
CONTACT_TEL
VARCHAR2（120）
Y
12
地区编码
AREA_ID
NUMBER（9）
N
13
受理员工
APPL_STAFF_ID
VARCHAR2（11）
Y
14
受理日期
APPL_DATE
DATE
N
15
受理来源
ACCEPT_TYPE
CHAR
（1）
N
CRM
PF
RM
16
备注
REMARKS
VARCHAR2（120）
3.2.3.5定单特性（ORDER_ATTR）
编号
字段名
英文名
类型/长度
是否可空
枚举值
说明
1
服务定单标识
SERVICE_ORDER_ID
NUMBER（9）
N
2
特性编码
ATTR_ID
VARCHAR2（9）
N
3
特性值
ATTR_VALUE
VARCHAR2（255）
N
4
操作类型
ACTION_TYPE
VARCHAR2（3）
N
新增A
删除R
3.2.3.6定单群组关联（GROUP_ORDER_RELA）
编号
字段名
英文名
类型/长度
是否可空
枚举值
说明
1
定单组标识
GROUP_ORDER_ID
NUMBER（9）
N
2
服务定单标识
SERVICE_ORDER_ID
NUMBER（9）
N
升级会员 