中国联通集团客户管理系统与省分BSS系统接口规范_系统.docx

中国联通集团客户管理系统与省分BSS系统接口规范
系统分册

V1.7.3修订版
修改历史
版本
时间
内容描述
1.0
2012/5/9
文档创建
1.6
2012/8/20
新增关于托收信息，详情见变更记录
1.6.2
2012/9/7
集团客户资料同步接口新增企业类型、集团地址和管理级别，并修改部门节点参数
1.6.3
2012/9/11
集团客户资料同步接口修改部分节点中文名称
1.6.5
2012/11/23
1、 业务工单服务和工单处理服务启用，内容全部更新；
2、 集团客户资料同步新增节点；
3、 集团用户资料服务新增省分业务规则校验、用户打标信息同步接口，原集团用户资料同步接口做修改；
1.6.6
2012/11/24
1、 业务工单服务和工单处理服务内容大量更新；
2、 集团账户资料同步新增节点BILLING_CYCLE
3、 用户打标信息同步修改输入参数中删除了SERIAL_NUMBER和SERVICE_OFFER0_ID字段，并将smlEnterTag字段的约束改成了1；
1.6.7
2012/11/26
本版本系统分册未变动
1.7
2012/11/28
1. 工单提交服务增加TERMINAL_LABEL标签和USER_ID标签;
2. 工单提交服务SERVICE_ID和SERVICE_ACT修改为可选类型。
1.7.1
2012/12/4
1. 7.1工单提交接口增加挂起通知、解挂通知、补录通知、删除通知四种工单类型，其他未变化。
1.7.2
2012/12/12
1. 7.5.4省分业务规则校验入参修改部分节点参数；
2. 7.3集团客户资料服务下新增7.3.4客户合户接口；
3. 新增与ERP接口；
1.7.3
2012/12/28
1. 7.3.3客户资料同步信息增加服务等级；
2. 7.5集团用户资料服务删除成员用户打标操作，改为文件接口
3. 7.5.3用户资料同步接口新增合同信息；
1.7.3修订版
2013/01/14

1. 7.7.3 付费关系同步接口 输入参数 LIMIT 限定值 修改备注 单位为“元”改为单位为“分”； ACCT_PRIORITY 账户优先级增加备注：
2. 修改客户合户接口入参、操作说明及开发要点；
3. 修改省分业务规则校验修改开发要点；

* 变更详情见《中国联通集团客户管理系统与省分BSS系统接口规范_系统分册 _变更记录.xls》

目录
1. 范围 5
2. 缩略语和术语定义 5
2.1 缩略语 5
2.2 术语 6
3. 业务分类及系统边界说明 8
4. 业务场景描述 10
4.1 集团客户开户 10
4.2 集团账户开户 11
4.3 普通基础业务 12
4.4 数据专线业务 15
4.5 宝视通业务 18
4.6 省内聚类IVPN业务 21
4.7 组合业务 24
5. 异常处理说明 26
6. 服务目录 26
7. 集客系统与省分实时接口 26
7.1. 业务工单服务 26
7.1.1. 服务描述 26
7.1.2. 服务属性 26
7.1.3. 工单提交 27
7.1.4. 工单进度查询 33
7.2. 工单处理服务 36
7.2.1. 服务描述 36
7.2.2. 服务属性 36
工单反馈 36
7.3. 集团客户资料服务 39
7.3.1. 服务描述 39
7.3.2. 服务属性 39
7.3.3. 集团客户资料同步 39
7.3.4. 客户合户接口 43
7.4. 集团账户资料服务 45
7.4.1. 服务描述 45
7.4.2. 服务属性 45
7.4.3. 集团账户资料同步 45
7.5. 集团用户资料服务 49
7.5.1. 服务描述 49
7.5.2. 服务属性 49
7.5.3. 集团用户资料同步 49
7.5.4. 省分业务规则校验 54
7.6. 集团成员服务 56
7.6.1. 服务描述 56
7.6.2. 服务属性 56
7.6.3. 集团成员关系同步 56
7.6.4. 成员用户信息查询 59
7.7. 付费关系服务 61
7.7.1. 服务描述 61
7.7.2. 服务属性 61
7.7.3. 付费关系同步 62
7.8. 欠费查询（含呆坏账查询、立即结账查询） 64
8. 集客系统与ESS接口 64
8.1. 集团信息推送 64
8.1.1. 服务描述 64
8.1.2. 服务属性 64
8.1.3. 集团信息推送 65
9. 集客系统与ERP接口 67
9.1. 合同关系更新 67
9.1.1. 服务描述 67
9.1.2. 服务属性 67
9.1.3. 合同关系更新接口 67
附录一：欠费查询（含呆坏账查询、立即结账查询） 70
1.1 服务描述 70
1.2 服务属性 70
1.3 欠费查询 70
1.3.1. 操作描述 70
1.3.2. 操作属性 70
1.3.3. 输入参数 70
1.3.4. 输入参数说明 71
1.3.5. 输出参数 72
1.3.6. 输出参数说明 74
1.3.7. 功能开发要点 75
1.3.8. 返回代码 77
附录二：接口开发优先级 78
附录三：接口负责人 79

1. 范围
中国联通集中集客系统服务集规范，基于中国联通集中集客系统用户需求书以及省分现有需求编制，为前台系统提供全业务（移动、固网、组合、融合）、全渠道（营业前台、自助终端、自助网站等）的销售服务核心支撑能力。
总册重点介绍服务集规范的整体概况，阐述服务设计的原则与思路，对服务设计中遇到的公共、重要、疑难的问题进行说明，详细规定服务的底层通信协议，并提供了一个完整的服务目录。
各分册提供各自功能域的服务目录，每个服务的定义包括服务描述、服务属性和服务下多个操作的描述，每个操作的定义包括操作描述、操作属性、输入参数、输入参数说明、输出参数、输出参数说明、省分功能开发要点等内容。
2. 缩略语和术语定义
1
2
2.1 缩略语
本文档所涉及的缩略语解释请参见下表。
缩略语
英文全称
中文全称
SOA
Service Oriented Architecture
面向服务的体系架构
3G
Third Generation
第三代
BSS
Business Support System
业务支撑系统
CRM
Customer Relationship Management
客户关系管理
eTOM
Enhanced Telecom Operations Map
增强的电信运营图
HLR
Home Location Register
归属位置寄存器
IMSI
International Mobile Subscriber Identity
国际移动用户识别码
IOM
Integration Order Management
集成定单管理
IP
Internet Protocol
互联网协议
MSS
Management Support System
管理支撑系统
OSS
Operation Support System
运营支撑系统
PRM
Partner Relationship Management
合作伙伴关系管理
PSTN
Public Switched Telephone Network
公共交换电话网
QoS
Quality Of Service
服务质量
SIM
Subscriber Identity Model
用户识别模块
SLA
Service Level Agreement
服务水平协议
SMS
Short Message Service
短信
SP
Service Provider
服务提供商
SSO
Single Sign On
单点登录
USIM
UMTS Subscriber Identity Model
UMTS 用户识别模块
VIP
Very Important Person
贵宾
VPDN
Virtual Private Dialup Networks
虚拟专用拨号网
WAP
Wireless Application Protocol
无线应用协议
2.2 术语
本文档所涉及的术语定义请参见下表。
名词
解释
服务
定义了一个与业务功能或业务数据相关的接口，以及约束这个接口的契约，如服务质量要求、业务规则、安全性要求、法律法规的遵循、关键业绩指标 （Key Performance Indicator，KPI）等。接口和契约采用中立、基于标准的方式进行定义，它独立于实现服务的硬件平台、操作系统和编程语言。
操作
服务所支持的具体处理逻辑
产品
产品是指中国联通运用营销手段，将业务或业务组合附加上销售对象、销售地域、资费计划、销售渠道、服务水平及配套资源属性后的产物，是向客户最终交付的、客户可以购买的业务或业务组合实例。
产品目录
产品目录是指中国联通面向客户销售的产品列表，产品目录中的产品包括中国联通自有产品及第三方合作伙伴产品。产品目录按照树状分级结构对产品进行组织，便于中国联通对所有可供销售的产品进行统一管理。
基本产品
直接可以独立销售的、无需以订购其它产品为销售前提的产品。
附加产品
不可以直接独立销售的，必须以用户已经订购了基本产品为销售前提。
组合产品
组合产品由不少于两个的基本产品和附加产品组合而成，组合产品具有本身资费计划属性，组合产品不允许多重组合即组合产品中不允许包含组合产品。
订单
订单是指客户对中国联通产品的订购信息，订购信息包括各种业务申请/变更/取消信息、产品申请/变更/取消信息、解决方案申请/变更/取消信息。
订购实例
订购实例是客户能够购买或使用业务的逻辑表现，订购实例对应着业务开通后的实体，是客户订购产品实例化后的体现。
定单
定单是服务开通和服务配置过程中的信息载体。
工单
工单是指派发给相应人工工位或网元设备的一组业务处理单元的信息载体。
合同
合同是中国联通与其他方之间为了办理业务所明确的关于各方权利和义务关系的具有法律效力的书面协议。
客户
客户是指可以成为中国联通及其合作伙伴所提供电信产品的所有者、支付者、使用者的人或组织。潜在客户也在客户管理范围之内。
业务
业务是指中国联通根据客户的通信需求，利用自身或第三方资源向客户提供的具有市场价值的通信服务内容。
集团客户
指以非自然人身份与中国联通签订产品或服务协议的客户，以及以自然人身份登记办理业务，但具有明显商业特征或使用中国联通集团客户产品的中小商户。
集团帐户
集团客户使用业务产品的付费实体。
集团用户
集团客户订购中国联通产品的订购实例。
集团成员客户
集团客户中使用中国联通集团产品的工作人员及其家属等。
集团成员帐户
集团成员客户使用中国联通集团业务的付费实体。
集团成员用户
集团成员客户订购中国联通集团产品的订购实例。

3. 业务分类及系统边界说明
集客相关的业务可以划分为三大种类，集团基础业务，集团扩展业务，面向集团客户销售的普通基础业务。
业务大类
业务类型
业务范围
普通基础业务
2G业务
2G
3G业务
3G
固话
普通电话、NGN、Centrex ，数字中继，模拟中继
宽带
XDSL、小区宽带、165拨号、IPTV、165VPDN、WLAN
集团基础业务
数据专线
管道出租、光纤出租、通信设备出租、DDN、FR、ATM、SDH(数字电路)、以太网专线(MSTP)、MPLS-VPN、互联网普通接入、XSDL专线、LAN专线、IDC主机托管、IDC虚拟主机、IDC资源出租产品
400/800业务
400业务、800业务
电话导航
电话导航
宝视通
宝视通业务
集团扩展业务
组合产品
沃商务、普通组合产品、离散组合产品
聚类
IVPN、WVPN、VPDN、营帐集团、集团炫铃、军网、收入归集、账务优惠
行业应用
定位管家、手机办公、手机办公助理 、移动办公、政府执法、汽车信息化、监测监控、股票机/专用卡、手机办公、校园一卡通、手机银行,集团短信、企业短信

集中集客系统的目标是实现上述全业务的支持。上述业务的支撑需要集中集客系统和省分BSS等系统共同协作才能完成。针对不同的业务，支撑的方案有所不同，遵循如下原则进行集中集客系统与省分BSS的边界划分：
l 三户资料
1) 集团客户资料、集团账户资料、集团用户资料、成员用户与集团的归属关系以集中集客系统为主，由集中集客系统创建通过实时同步的方式下发到省分BSS
2) 集团成员用户资料以省分BSS为主，同步到集中集客系统
3) 集团客户、集团用户的界定以集客系统为准，即所有集团客户、集团用户资料必须以集中集客系统为准，没有纳入系统管理的不视为集团客户。
l 业务受理
由于集团产品的多样性，一事一议的特点，各省分的情况相对较复杂，因此集中集客系统业务受理的范围圈定原则为：除了省分业务量较小、个性化较强的集客业务在省分受理，其余业务均在集中集客系统受理。在集中集客受理的业务，按照不同的业务特点采用不同的方式：
1) 普通基础类业务采用界面集成的方式，由集客系统嵌入ESS、省分BSS页面
2) 集团基础类和集团扩展类业务均由集中集客系统提供受理页面进行受理，涉及到省分开通的环节由集中集客通过实时开通工单服务与省分BSS交互，省分BSS完成开通。若省分不具备实时开通条件的，集中集客系统可以生成省分人工工单，进行省分人工干预的处理流程。
l 计费帐务
对于集中集客系统中管理的所有集团用户，成员用户的帐务和收入情况要实现一点看全是集客系统的关键需求之一。因此需要省分计费系统和集客系统的充分互动才能实现该需求的支撑。
1) 涉及到总部平台计费的和跨域计费以及一点账单要求的由总部集中集客系统实现，并将处理后的账单下发省分
2) 充分利用现有省分BSS的计费帐务能力，省内业务计费尽可能由省分BSS系统完成
3) 集中集客系统管理的业务账单由集中集客系统支撑，省分BSS管理的业务账单由省分BSS支撑，但省分必须将与集客相关账单上传至集中集客系统
l 收费
1) 集中集客系统负责对业务办理时产生的一次性费用进行支撑，其他费用的收取均在省分BSS完成，由集中集客系统下发账单给省分BSS
2) 在完成缴费后，省分BSS需要将集客相关的缴费文件上传至集中集客系统，以便集客系统统计实收等信息

4. 业务场景描述
本规范定义的服务集旨在支撑集客全业务范围的总部与省分交互，在理想情况下做到不改动服务集实现新业务的加载和支撑。但由于业务的复杂性和项目的渐进性，本章节仅对集客项目近期需要支撑的重点业务给出了流程场景和使用说明。
业务分类
业务
总部集中集客系统
省分BSS
受理
开通
计费
账务
收费
受理
开通
计费
账务
收费
普通基础业务
2G/3G业务
√*

√
√
√
√
集团基础业务
数据专线
√
√　
√
√

√

√
宝视通
√
√
√
√

√

√
集团扩展业务
—聚类业务
wvpn/vpdn
√
√
√

√

√
√
ivpn
√

√
√
√
√
√
集团扩展业务
—组合产品

√*

√
√
√
√
√
带*标示为总部集成省分BSS的界面，从使用者的感知来看还是从总部集中集客系统进行的受理。
上表是根据集客与省分BSS边界划分原则以及近期集客系统支撑的业务，列出的业务支撑能力归属及分布矩阵，帮助读者更好的理解本章给出的业务流程场景。
1
2
3
4
4.1 集团客户开户

【流程说明】
1. 集客系统创建集团客户资料，并实时同步给省分BSS系统。
【补充说明】
ü 若集团客户资料由于业务受理或者其他原因变更时，集中集客系统均会触发相应的信息同步接口，向省分更新该集团客户的最新数据
4.2 集团账户开户

【流程说明】
1. 集客系统查询集团客户；
2. 集客系统创建集团账户资料，并实时同步给省分BSS系统。
【补充说明】
ü 若集团账户资料由于业务受理或者其他原因变更时，集中集客系统均会触发相应的信息同步接口，向省分更新该集团账户的最新数据
4.3 普通基础业务

【流程说明】
1. 集客系统集成省分BSS系统的客户认证选择界面，选择同步到省分的集团客户；
2. 集客系统集成省分BSS系统的账户选择界面，选择同步到省分的集团账户；
3. 集客系统集成省分BSS系统的普通基础业务开户或变更界面，进行订单受理，受理过程中涉及到集团客户/帐户资料的须以总部同步到省分BSS的资料为准，不得在省分BSS侧单独创建集团客户/帐户资料；
4. 省分BSS系统完成订单的开通和竣工操作；
5. 省分BSS系统操作成功后，需将用户资料定时同步给集客系统。
【补充说明】
ü 省分上传用户资料采用定时增量的方式，将规定时间段内的所有变更的用户资料上传至总部
ü 此流程只针对集团客户在省分BSS系统订购的普通基础业务，对于非集团客户订购的普通基础业务，保持省分现有模式（即：通过个人客户受理时选择集团客户、账户完成集客标识的设置）

附加情况

【流程说明】
1. 2G/3G成员用户的计费账务缴费等处理都在省份BSS中进行。
2. 集客BBSS月底根据成员归属关系，下发成员列表文件。
3. 省分BSS根据成员列表信息，进行出账后的成员账单文件上传。
(附加)集客BBSS接受到省分账单后，进行二次集团优惠操作，将集团优惠文件以专属销账文件形式下发给省份BSS，省份BBS进行优惠处理。
4. 省分BSS进行销账，将成员销账文件上传，同时月底上传全量销账对账信息给集中集客系统

4.4 数据专线业务

【流程说明】
1. 集客系统认证选择集团客户；
2. 集客系统选择集团账户；
3. 集客系统提供订单受理功能，包括开户和变更等；
4. 在开通等涉及省分施工的环节，由集客系统生成人工工单，省分业务处理人员登录集客系统查看和处理工单，完成开通调度后提交回单；
5. 工单完成后，集客系统进行业务竣工，并将集团用户资料同步给省分BSS系统。
【补充说明】
ü 集客系统中一条专线只生成一个用户，如果省分BSS是对A、Z端各生成一个用户的模式，那么省分BSS需要根据集客用户资料的A、Z端信息生成对应的用户
ü 针对跨省的数据专线，如果A端为集团用户归属省，那么用户资料只同步到A端省分，Z端省分不同步用户资料

【流程说明】
1. 数据专线业务由集客系统进行批价计费账务处理，月底出账。
2. 集客系统每月向省分BSS进行月租下发
3. 集客系统月底向省分BSS进行出账账单下发。
4. 省分BSS接受账单进行二次出账。同时将二次出账后的账单上次给集客系统
5. 省分BSS进行每月销账, 同时将销账文件上传给集客系统, 同时月底上传全量销账信息给集客系统
6. 集客系统出具应收,实收等收入统计报表.
4.5 宝视通业务

【流程说明】
1. 集客系统认证选择集团客户；
2. 集客系统选择集团账户；
3. 集客系统做订单受理，包括开户和变更；
4. 集客系统进行总部平台的订单开通处理；
5. 集客系统通过人工工单方式，省分业务处理人员登录集客系统完成省分侧的开通调度；
6. 集客系统进行业务竣工，并将集团用户资料同步给受理省分BSS系统。
【补充说明】
ü 由于宝视通业务为一点受理多方参与的情况，三户资料只发送给受理省，参与省进行施工时，如果需要集团客户和账户资料，需要由省分受理人员登录集客系统创建本省的集团客户和集团账户资料，待该资料同步至省分后再进行流转开通

【流程说明】
1. 宝视通业务在集客系统进行批价计费帐务处理,月底出帐.
2. 省份BSS月底接受集客系统出帐后账单,进行销账.
3. 省份上传销账文件给集客系统.
4. 集客系统将结算数据提供给固网结算进行结算处理.
【补充说明】
ü 集客系统提供自服务功能，供用户详单查询.
4.6 总部WVPN、VPDN等集团业务
【流程说明】
1. 集客系统认证选择集团客户；
2. 集客系统选择集团账户；
3. 集客系统做订单受理，包括开户和变更；
4. 集客系统通过实时工单接口，由省分完成平台开通处理；
5. 集客系统进行业务竣工，并将集团用户资料同步给省分BSS系统。

【流程说明】
1. 集客系统进行聚类集团用户的开户或变更；
2. 对于省内聚类业务，集客系统仅进行集团和成员关系的管理，如果是成员其他变更业务，则集成省分BSS系统界面进行受理；
3. 集客系统通过实时工单提交接口，由省分BSS系统进行开通处理；
4. 集客系统进行业务竣工，并将集团成员关系同步给省分BSS系统。
【补充说明】
ü 在工单提交的实时接口中会包含集团用户资料的部分信息，省分BSS接受到该资料后可以创建对应的用户以便完成工单的后继处理，但在工单竣工后集中集客系统还是会将完整集客用户资料传递给省分BSS（集团标识不变），届时省分BSS应该以用户资料同步接口接受的信息更新前期的用户资料。

【流程说明】
1. 省份聚类IVPN业务在省份BSS中进行批价,月租计费扣取出帐等操作.
2. 集客系统根据集团成员关系,下发成员用户列表.
3. 省份BSS根据成员用户列表,进行出帐后账单的上传.集客系统接受数据
4. 省份BSS进行销账操作,上传销账文件到集客系统.集客系统接受数据, 同时月底上传全量销账信息给集客系统
5. 集客系统出具应收,实收等收入统计报表.
4.7 组合业务

【流程说明】
1. 集客系统集成省分BSS系统的客户认证选择界面，选择同步到省分的集团客户；
2. 集客系统集成省分BSS系统的账户选择界面，选择同步到省分的集团账户；
3. 集客系统集成省分BSS系统的组合业务开户或变更界面，进行订单受理；
4. 省分BSS系统完成订单的开通和竣工操作；
5. 省分BSS系统操作成功后，需将组合产品资料定时同步给集客系统。

【流程说明】
1. 组合业务在省份BSS中进行 批价,月租计费扣取出帐等操作.
2. 集客系统根据集团成员关系,下发成员用户列表.
3. 省份BSS根据成员用户列表,进行出帐后账单的上传.集客系统接受数据
4. 省份BSS进行销账操作,上传销账文件到集客系统.集客系统接受数据,同时月底上传全量销账信息给集客系统
5. 集客系统出具应收,实收等收入统计报表.
客户合户

【流程说明】
如果目标客户不存在，则创建目标集团客户；
创建的新客户通过全业务平台下发到省分BSS和ERP系统；
选择源客户；
进行在省分受理的用户能否进行合户的判断，若未通过校验则退出流程（省分业务规则校验接口）；
进行客户合并，将所有源客户下所有的账户、用户、合同、项目、商机信息迁移到目标客户下；
若合户出错，则回滚所有操作，解锁客户，退出流程；
合户成功，下发新的用户归属关系到省分BSS系统（客户合户接口）；
下发新的合同归属关系到ERP系统。
5. 异常处理说明
在与省分BSS交互过程中可能出现网络中断、系统故障、进程失效等异常情况。这种异常情况返回的是不确定错误，如：网络中断或者其他原因导致的超时。对于上述异常，本规范涉及的服务均采用由发起系统按原流水重发进行补偿，落地方系统要能够识别重发请求，并进行合理的处理（若原请求已经成功处理，则直接返回成功；若原请求失败或未收到，则根据重发请求进行正常的处理）。若当日重发一直失败，不再进行隔日重发，而是采用人工干预的方式（由发起方系统提供界面查看未发送成功的交易，进行人工处理）。

6. 服务目录
服务名
服务名
(英文)
发起系统
目标系统
集团客户资料服务
GrpCustInfoSer
B-BSS
BSS
集团账户资料服务
GrpAcctInfoSer
B-BSS
BSS
集团用户资料服务
GrpUserInfoSer
B-BSS
BSS
集团成员服务
GrpMemInfoSer
B-BSS
BSS
付费关系服务
PayRelInfoSer
B-BSS
BSS
欠费查询
QryOweFeeSer
B-BSS
BSS
I

3
4
5
6
7. 集客系统与省分实时接口
1.
2.
3.
4.
5.
6.
7.
7.1. 业务工单服务
7.1.1. 服务描述
  集中系统发起的工单处理相关的服务。
7.1.2. 服务属性

  服务编码
  WorksheetSer
  关联服务编码

7.1.3. 工单提交
7.1.3.1. 操作描述
  集中系统提交工单信息到省分BSS进行业务开通。
7.1.3.2. 操作属性

  对应操作编码
  submitWorksheet
  需要冲正
  0:不需要冲正
  对账标记
  0:不参与对账
  是否允许用原交易流水号重发
  0:不允许
  路由类型
  00:省(位置)代码
  是否加密
  0:不加密
  是否压缩
  0:不压缩

7.1.3.3. 输入参数
节点名称
父节点名称
约束
类型
长度
节点中文名
说明　
ORDER_ID
SUBMITWORKSHEET_REQ
1
String
V60
总部客户订单号
工单所属客户订单标识，为总部的流水编号。退单重提时保持不变。追单、加急、延期、撤单时为新的编号。　
RELA_ORDER_ID
SUBMITWORKSHEET_REQ
?
String
V60
关联客户订单
追单、加急、延期、撤单时关联老的客户订单号。　
WS_TYPE
SUBMITWORKSHEET_REQ
1
String
F4
总部工单类型
1001：正常提交 1002：退单重提 1003：追单审批 1004：追单通知 1005：加急审批 1006：加急通知 1007：延期审批 1008：延期通知 1009：撤单审批 1010：撤单通知 1011：挂起通知1012：解挂通知1013：补录通知 1014：删除通知业务层面上，资源核查流程有二次核查功能，所以，在核查结束后可能还会以原来的客户订单号、业务订单号重发工单，接收方请特别注意　
WS_LIST
SUBMITWORKSHEET_REQ
1

工单列表

WORKSHEET
WS_LIST
+

工单
根据BSS厂商反馈，一次只能传递一个工单　
WS_ID
WORKSHEET
1
String
V60
总部工单流水号
追单、加急、延期、撤单、退单重提时使用新的工单ID　
RELA_WS_ID
WORKSHEET
?
String
V60
关联工单流水号
追单、加急、延期、撤单、退单重提时关联被加急、延期、撤单、重提的工单流水号。　
CREATOR
WORKSHEET
1
String
V60
发起人

CREATOR_TEL
WORKSHEET
?
String
V60
发起人联系电话

CREATOR_EMAIL
WORKSHEET
?
String
V100
发起人电子邮箱

CUST_MANAGER
WORKSHEET
?
String
V60
客户经理姓名

CUST_MANAGER_TEL
WORKSHEET
?
String
V60
客户经理联系电话

CUST_MANAGER_EMAIL
WORKSHEET
?
String
V100
客户经理EMAIL

SUBMIT_TIME
WORKSHEET
1
String
F14
工单生成时间

CUST_NO
WORKSHEET
1
String
V60
集团客户编码

CUST_NAME
WORKSHEET
1
String
V200
集团客户名称

USER_ID
WORKSHEET
?
String
V60
集团用户标识

SERVICE_NUMBER
WORKSHEET
?
String
V60
集团用户业务号码

GRP_BEL_PROVINCE
WORKSHEET
?
String
F2
集团用户归属省（参见编码规范SHO_000009）

GRP_BEL_CITY
WORKSHEET
?
String
V10
集团用户归属地市（参见编码规范SHO_000010）

WS_REMARK
WORKSHEET
?
String
V4000
工单说明
追单、加急、延期、撤单时，传递相应的原因说明。　
WS_ATTR_LIST
WORKSHEET
?

工单属性列表

WS_ATTR
WS_ATTR_LIST
+

工单属性

ATTR_CODE
WS_ATTR
1
String
V60
工单属性编码（参见工单编码目录“业务属性编码-xxx集团业务属性编码”）

ATTR_VALUE
WS_ATTR
1
String
V500
属性值

ATTACH_LIST
WORKSHEET
?

附件列表

ATTACH
ATTACH_LIST
+

附件

ATTACH_CODE
ATTACH
1
String
V30
附件位置

ATTACH_NAME
ATTACH
1
String
V200
附件名称

WS_MEMBER_LIST
WORKSHEET
+

成员列表

WS_MEMBER
WS_MEMBER_LIST
+

成员信息
根据BSS厂商反馈，一次只能传递一个成员工单　
WS_MEMBER_ID
WS_MEMBER
1
String
V60
总部成员工单流水号（总部工单成员主键，省分保存并原样返回）
追单、加急、延期、撤单、退单重提时会发生变化。做为反馈的依据。　
RELA_WS_MEMBER_ID
WS_MEMBER
?
String
V60
关联成员工单流水号
追单、加急、延期、撤单、退单重提时关联被追单、加急、延期、撤单、退单的成员工单流水号。　
TRADE_ID
WS_MEMBER
1
String
V60
业务订单号
追单、加急、延期、撤单使用新的业务订单号。退单重提时保持不变。　
RELA_TRADE_ID
WS_MEMBER
?
String
V60
关联业务订单号
追单、加急、延期、撤单时关联被追单、加急、延期、撤单的业务订单号。　
FINISH_DATE
WS_MEMBER
?
String
F14
要求完成时间

TERMINAL_LABEL
WS_MEMBER
1
String
V2
成员工单关联标记
用于关联此成员工单是关于电路那端的标记。可选值包括：0：整条电路；1：A端；2：Z端；3：网管端。
USER_ID
WS_MEMBER
?
String
V60
成员用户ID

SERVICE_NUMBER
WS_MEMBER
?
String
V60
业务号码

SERVICE_ID
WS_MEMBER
?
String
V30
集团业务编码（参见工单编码目录“集团业务编码”）

SERVICE_ACT
WS_MEMBER
?
String
V30
业务动作（参见工单编码目录BBSS_00002）

MEMBER_ATTR_LIST
WS_MEMBER
?

工单成员属性列表

MEMBER_ATTR
MEMBER_ATTR_LIST
+

工单成员属性

ATTR_CODE
MEMBER_ATTR
1
String
V60
属性编码（参见工单编码目录“业务属性编码-xxx成员业务属性编码”）

ATTR_VALUE
MEMBER_ATTR
1
String
V500
属性值

ATTACH_LIST
WS_MEMBER
?

附件列表

ATTACH
ATTACH_LIST
+

附件

ATTACH_CODE
ATTACH
1
String
V30
附件位置

ATTACH_NAME
ATTACH
1
String
V200
附件名称

PARA
SUBMITWORKSHEET_REQ
*

保留字段

PARA_ID
PARA
1
String
V60
保留字段ID

PARA_VALUE
PARA
1
String
V500
保留字段值

7.1.3.4. 输入参数说明
  1.ATTACH_CODE 用于文件编码名，保证附件在服务器上不会重复，需要后缀名。 例如： AF_20121112_00020.xls 2.ATTACH_NAME 附件的实际名称，需要后缀名。 3.附件编码规则 格式：AF_NO_YYYYMMDD_SEQ.xxx 其中，AF_为附件名前缀； NO为总部编码，根据编码规范目前取值为09. SEQ为5位流水号，以日为单位轮询，每日从00001开始，到99999结束； YYYYMMDD为年月日数值； xxx为文件后缀，根据实际文件后缀设置。 4.附件存储路径： /总部编码/ incoming /submit/attach/ 注：总部编码参见《中国联通BSS域服务集规范_集中集客系统分册_编码规范》的省编码SHO_000009，根据规范总部编码是09。 5.附件大小约束：10M/个 6.附件获取方式： 附件要在服务调用前上传到服务器，保证接收方可以正确获取附件。
7.1.3.5. 输出参数
节点名称
父节点名称
约束
类型
长度
节点中文名
说明　
IS_REAL_TIME_RSP
SUBMITWORKSHEET_RSP
?
String
F2
是否实时反馈结果：00:是01:否

RESP_CODE
SUBMITWORKSHEET_RSP
1
String
F4
应答码： 0000 接收成功 0001 正在处理 8888 其他错误
表示工单接收的结果　
RESP_DESC
SUBMITWORKSHEET_RSP
1
String