Download Broadband Connectivity Service (BBCS) Fulfillment

B2B BBCS Fulfillment Interface Specification
C2 - Internal
Broadband Connectivity Service (BBCS)
Fulfillment Interface Specification
Version
Issue date
Replaces version
Valid from
Valid until
Classification
Status
Swisscom (Schweiz) AG
CH-3050 Bern
44
22.05.2015
43 or previous
08.06.2015
recalled or replaced by new version
Technical Support Documentation (BBCS)
released
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
1/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Contents
1
Introduction ....................................................................................................................................7
1.1 General......................................................................................................................................7
1.2 References ................................................................................................................................7
1.3 Document updates ....................................................................................................................7
2 Business Processes .........................................................................................................................8
2.1 Overview ..................................................................................................................................8
2.2 Qualification: srvQualifByXxxx ..............................................................................................9
2.2.1 srvQualifByNumber ...........................................................................................................9
2.2.2 srvQualifByAddress .........................................................................................................10
2.2.3 srvQualifByLlid ...............................................................................................................11
2.2.4 srvQualifByStartPoint ......................................................................................................11
2.2.5 srvQualifBySocket ...........................................................................................................12
2.2.6 srvQualifByBinding .........................................................................................................13
2.2.7 srvQualifByBindingResponse ..........................................................................................14
2.2.8 Common Request Elements for all Copper srvQualif-Operations: srvQualifType .........14
2.2.9 Response Elements for all srvQualif-Operations .............................................................16
2.3 getQualifHistory .....................................................................................................................28
2.3.1 REQUEST: getQualifHistoryRequestType......................................................................28
2.3.2 RESPONSE: getQualifHistoryAckType .........................................................................28
2.4 getSrvStatus ............................................................................................................................35
2.4.1 REQUEST: getServiceStatusRequestType ......................................................................35
2.4.2 RESPONSE: getServiceStatusResponseType ..................................................................35
2.5 createCustomerOrder ..............................................................................................................40
2.5.1 REQUEST: customerOrderRequestType .........................................................................40
2.5.2 RESPONSE: customerOrderAckType .............................................................................51
2.6 getTransactionOverview .........................................................................................................52
2.6.1 REQUEST: getTransactionOverviewRequestType .........................................................52
2.6.2 RESPONSE: getTransactionOverviewAckType .............................................................53
2.7 getOrderDetail ........................................................................................................................54
2.7.1 REQUEST: getDetailRequestType ..................................................................................54
2.7.2 RESPONSE: getDetailAckType ......................................................................................55
2.8 getInstallationTicketDetail .....................................................................................................73
2.8.1 REQUEST: getInstallationTicketDetailRequestType .......................................73
2.8.2 RESPONSE: getInstallationTicketDetailAckType ..............................................73
2.9 getTdmMsgDetail ...................................................................................................................79
2.9.1 REQUEST: getTdmMessageDetailRequestType ...............................................79
2.9.2 RESPONSE: getTdmMessageDetailAckType ......................................................79
2.10 getOrderGroupNr..................................................................................................................82
2.10.1 REQUEST: getOrderGroupNrRequestType.......................................................83
2.10.2 RESPONSE: customerOrderAckType customerOrderAckType ..................83
2.11 cancelPendingOrder..............................................................................................................84
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
2/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
2.11.1 REQUEST: cancelPendingRequestType .............................................................84
2.11.2 RESPONSE: cancelPendingAckType ....................................................................84
2.12 createInstallationTicket ........................................................................................................84
2.12.1 REQUEST: createInstallationTicketRequestType ..........................................84
2.12.2 RESPONSE: createInstallationTicketAckType .................................................86
2.13 modifyPendingInstallationTicket .........................................................................................86
2.13.1 REQUEST: modifyPendingInstallationTicketRequestType .........................86
2.13.2 RESPONSE: modifyPendingInstallationTicketAckType ................................88
2.14 cancelPendingInstallationTicket ...........................................................................................88
2.14.1 REQUEST: cancelPendingInstallationTicketRequestType ..........................88
2.14.2 RESPONSE: cancelPendingInstallationTicketAckType .................................89
2.15 getBusinessLines ..................................................................................................................89
2.15.1 REQUEST: getBusinessLinesRequestType .......................................................89
2.15.2 RESPONSE: getBusinessLinesAckType ..............................................................89
2.16 createChangeTicket ..............................................................................................................90
2.16.1 Request createChangeTicketRequestType .....................................................................90
2.16.2 Response createChangeTicketResponseType ................................................................92
2.17 modifyPendingChangeTicket ...............................................................................................92
2.17.1 Request modifyPendingChangeTicketRequestType ......................................................93
2.17.2 Response modifyPendingChangeTicketResponseType .................................................93
2.18 cancelPendingChangeTicket ................................................................................................94
2.18.1 Request createChangeTicketRequestType .....................................................................94
2.18.2 Response ........................................................................................................................94
2.19 getChangeTicketOverview ...................................................................................................94
2.19.1 Request getChangeTicketOverviewRequestType ..........................................................94
2.19.2 Response getChangeTicketOverviewResponseType .....................................................95
2.20 getChangeTicketDetail .........................................................................................................97
2.20.1 Request getChangeTicketDetailRequestType ................................................................97
2.20.2 Response getChangeTicketDetailResponseType ...........................................................97
2.21 getCpeReport ......................................................................................................................100
2.21.1 Request getCpeReportRequestType.............................................................................100
2.21.2 Response getCpeReportResponseType ........................................................................101
3 List of Values (LOVs) ...............................................................................................................103
4 TDM Message types ..................................................................................................................103
4.1 Principles ..............................................................................................................................103
4.2 GV01 / Neuanschluss ...........................................................................................................104
4.3 GV14 / Kündigung ...............................................................................................................105
4.4 GV16 / Nummerwechsel ......................................................................................................107
4.5 GV25 / Sistierung Aktivierung .............................................................................................110
4.6 GV12 / Übernahme ...............................................................................................................112
4.7 GV17 / Nummerntypwechsel Deaktivierung .....................................................................112
4.8 GV03 / 04 / 15 Umzug Deaktivierung..................................................................................115
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
3/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
4.9 05 / 06 : Zeitweiliger Anschluss ...........................................................................................119
4.10 37 Änderung .......................................................................................................................120
4.11 GV11 Korrektur Voice .......................................................................................................121
5 Web Service Interface ................................................................................................................123
5.1 Security .................................................................................................................................123
5.1.1 Encryption ......................................................................................................................123
5.1.2 Authentication, Authorization, and Accounting (AAA) ................................................123
5.2 Model: WSDL and XML Schemas ......................................................................................124
5.2.1 Overview ........................................................................................................................124
5.2.2 Overview of supported Versions ....................................................................................124
5.2.3 The WSG BB Outbound Web Service ...........................................................................124
5.2.4 The WSG LQS Service Availability Qualification (SAQ) ............................................124
5.2.5 Deprecated Versions ......................................................................................................125
5.2.6 Multiple Versions ...........................................................................................................125
5.2.7 Correlation from request to response .............................................................................126
6 General Qualification Information .............................................................................................127
6.1 Purpose of the xDSL check facility ......................................................................................127
6.2 Qualification .........................................................................................................................128
6.2.1 ADSL .............................................................................................................................128
6.2.2 SDSL ..............................................................................................................................128
6.2.3 VDSL .............................................................................................................................128
6.2.4 BX ..................................................................................................................................128
6.2.5 Qualification with Address.............................................................................................129
6.3 General Response Description..............................................................................................130
6.3.1 Speed profiles in case of positive response ....................................................................130
6.4 Possible reasons for a negative response ..............................................................................130
7 Appendix A ................................................................................................................................131
7.1 Securing a WEB-Service with Powergate ............................................................................131
7.2 Setting up a new WEB-Service ............................................................................................131
7.3 Sample Client with wss4j .....................................................................................................131
7.4 Errors ....................................................................................................................................133
7.5 Login from the user point of view ........................................................................................135
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
4/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Checklist of changes
int.Version
Date
Changed by
Comments / nature of the change
30
21.02.2011
HP
Version WSG-8.3 / Mar11
- BB Schema update:
- ISP_CHANGE_DONOR order with new attributes;
- some enumerations eliminated
- LoV Doc updated
31
27.04.2011
HP
Version WSG-8.4 / Jun11
- BB Schema update:
- Ordertypes with new attributes;
- LoV Doc updated
32
20.10.2011
HP
Version WSG-8.6 / Nov11
- (SSH)Filetransfer description removed
- BB Schema update:
- srvQualifType with new elements
- plannedEndPoint new type
- serviceOrderType with new elements
33
26.03.2012
Roland Staub
Version WSG-9.0 / Mai12
- BB Schema update:
- firstInHouse added for fiberQualifAnswer
- added termination, sessionType to
customerOrderType
- Added dslamName to element endPoint in method
getSrvServiceStatus
34
17.09.2012
Roland Staub
Version 9.2 / Oct12
- BB Schema update:
- Create/modify/get/cancel changeTicket
- getCpeReports
- added
cpeInfo
in
getServiceStatusResponseType
35
25.09.2012
Roland Staub
Updated password policy in Chapter 7.5
36
24.04.2012
Roland Staub
Version 9.4 / Mai13
qualifAnswer,
-BB Schema update.
-added Vectoring info
-Added addtribute processWithLowPrio to all operations
-reorganized endPoint (added instead of dnOffice,
bbDeviceLocation,
siteCategory
in
(qualifHistResponseResData)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
5/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
37
27.05.2013
Roland Staub
Updated, hasFreecapacity was still present, but was
deleted on interfacedefinition
38
15.07.2013
Roland Staub
Version 9.5 Aug13
39
15.07.2013
Roland Staub
Version 9.6 Nov13
40
15.07.2013
Roland Staub
Version 9.7 Feb14
41
25.04.2014
Roland Staub
Version 9.8 Mai14
42
08.08.2014
Roland Staub
Version 9.9 Mai14
43
21.01.2015
Roland Staub
Version 9.11 März15
44
19.05.2015
Roland Staub
Version 9.12 June15
int.Version
Date
Released by
Comments / nature of the change
10
20.07.2007
R. Seltmann
Released for WSG-6.6 (June 2007)
17
06.12.2007
R. Seltmann
Released for BBCS Contract Version 12.21
18
11.12.2007
R. Seltmann
Released for BBCS Contract Version 12.3
19
12.02.2008
R. Seltmann
Released for BBCS Contract Version 12.4
20
21.04.2008
R. Seltmann
Released for BBCS Contract Version 13
21
20.10.2008
R. Seltmann
Released for BBCS Contract Version 13-2
22
26.02.2009
R. Seltmann
Released for BBCS Contract Version 13-3
23
26.10.2009
R. Seltmann
Released for BBCS Contract Version 13-31
24
03.03.2010
R. Seltmann
Released for BBCS Contract Version 13-31
25
17.03.2010
Ch. Wäger
Released for BBCS Contract Version 13-31
28
11.05.2010
R. Seltmann
Released for BBCS Contract Version 13-4
29
12.10.2010
H. Künzi
Released for WSG-8.2 (Nov 2010)
30
21.02.2011
A. Studerus (iarope1)
Released for WSG-8.3 (Mar 2011)
31
03.05.2011
H. Künzi
Released for WSG-8.4 (Jun 2011)
32
25.10.2011
H.Künzi
Released for WSG-8.6 (Nov 2011)
33
27.03.2012
H.Künzi
Released for WSG-9.0 (Mai 2012)
35
25.09.2012
H.Künzi
Released for WSG-9.2 (Oct 2012)
36
14.05.2013
H.Künzi
Released for WSG-9.4 (Mai 2013)
37
28.05.2013
H.Künzi
Document update
38
16.07..2013
H.Künzi
Released for WSG-9.5 (Aug2013)
39
28.10.2013
H.Künzi
40
10.02.2014
H.Künzi
Released for WSG-9.6 (Nov2013)
Released for WSG-9.7 (Nov2014)
Release
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
6/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
41
01.05.2014
H.Künzi
Released for WSG-9.8 (Mai2014)
42
08.08.2014
H.Künzi
Released for WSG-9.9 (Aug 2014)
43
17.02.2015
H.Künzi
Released for WSG-9.11 (Mar 2015)
44
26.05.2015
H.Künzi
Released for WSG-9.12 (June 2015)
1
Introduction
1.1
General
This document describes the business-to-business interface for broadband services of
the WSG application: it contains detailed technical specification for the
implementation of web service (using the SOAP protocol) processes to execute orders,
tickets or information requests.
1.2
References
[1]
[2]
[3]
[4]
[5]
[6]
WSG Messages
B2B BB Assurance Interface Specification
ISP BBCS Fulfillment User Manual
B2B Speed Profiles
Actual interface definition wsgBb_v26.0.0.zip
LOV document (LOV_ID_Definitions.XLS, included in the " Actual interface
definition ZIP-file")
The actual documents are downloadable as PDF files from the WSG application.
The format of the file names is: <document-name>_V<nn>.pdf
1.3
Document updates
In case of changes of this interface Swisscom will provide the ISPs with the latest update of this
document at least three weeks before the changes becomes effective.
As soon as the CUG mentioned above is available, updates of this document will be communicated via
the CUG.
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
7/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
2
Business Processes
2.1
Overview
This business processes provided by this interface are described by WSDL and XSD files.
These files are packed in the ZIP-File
wsgBb_v26.0.0.zip [5]
This ZIP-File contains:
 Readme.txt
general information on this file (contents)
 ChangeLog.txt
the details of the changes per released version (changehistory).
 schema/*
the schema definition as well as the web-service
definition
o wsgBbOutbound.wsdl Web Service Definition for WSG Outbound (B2B
Interface)
o wsgLqsSaq.wsdl
Web Service Definition for LQS Outbound (SAQ Interface)
 doc/
o WsgWebOutbound.html
a HTML-based documentation of the B2B Interface
o ServiceAvailabilityQualification.html
a HTML-based documentation of the
SAQ Interface
How to use samples can be found in the B2B_Web_Service_Tutorial.doc
The XML schemas are shared by two Web Service Definitions (WSDL):

wsgBbOutbound.wsdl: Defines the B2B services. This services provides the The
server implementation of this services is deployed on WSG Outbound
(URL: https://webservices.swisscom.com/wsg/prod/bb/WsgBbVxxx)

wsgLqsSaq.wsdl: Defines the Service Availability Services (SAQ) The SAQ
provides a quick Qualification of a possible broadband connections. The SAQ gives
a first overview. The server implementation of this services is deployed on LQS
Outbound
(URL: https://webservices.swisscom.com/wsg/prod/lqs/LqsQualiVxxx)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
8/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
The following table provides an overview of the available business processes (operations) for B2BFulfillment and there deployment as web services:
Business Process / Operation
srvQualifByNumber
srvQualifByAddress
srvQualifByLlid
srvQualifByStartPoint
srvQualifBySocket
srvQualifByBindingId
getQualifHistory
getSrvStatus
createCustomerOrder
getTransactionOverview
getOrderDetail
getTdmMsgDetail
getOrderGroupNr
cancelPendingOrder
getInstallationTicketDetail
createInstallationTicket
modifyPendingInstallationTicket
cancelPendingInstallationTicket
getBusinessLines
createChangeTicket
modifyPendingChangeTicket
cancelPendingChangeTicket
getChangeTicketOverview
getChangeTicketDetail
getCpeReport
2.2
2.2.1
B2B Web Service
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
SAQ Web Service
X
X
X
X
X
X
Qualification: srvQualifByXxxx
srvQualifByNumber
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
9/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Purpose: Gets information on possible broadband connections to a given destination by
DN/VN/NSN.
2.2.1.1 REQUEST: srvQualifByNumber
Element Type
Occ Comment
srvQualifType
1..1
dnVnNsn xs:string (pattern:0[1-9]\d{8}) 1..1 A DN/VN/NSN phone number.
2.2.1.2 Response: srvQualifByNumberResponse
Element Type
Occ Comment
The acknowledge message returned after
response qualifAcknowledgeType 1..1
processing a qualification request.
2.2.2 srvQualifByAddress
Purpose: Gets information on possible broadband connections to a given destination by address
2.2.2.1 REQUEST: srvQualifByAddress
Element Type
srvQualifType
address subjectAddressType
Occ Comment
1..1
1..1 A subject's postal address.
subjectAddressType
Element
Type
xs:string (minLength:1,
street
maxLength:30)
xs:string (minLength:1,
houseNr
maxLength:12)
xs:string (minLength:1,
building
maxLength:30)
xs:int (minInclusive:1000,
zip
maxInclusive:999999)
xs:string (minLength:1,
city
maxLength:25)
xs:string (minLength:1,
additionalCity
maxLength:25)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
The street name of an
0..1
address.
The house number of an
0..1
address.
The building infomation of
0..1
an address.
0..1 The zip of an address.
0..1 The city of an address.
0..1
The additional city
information of an
10/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
firstName
lastName
address.
A subject's first
0..1
name.
A subject's last
0..1
name.
xs:string (minLength:1,
maxLength:30)
xs:string (minLength:1,
maxLength:30)
2.2.2.2 RESPONSE: srvQualifByAddressResponse
Element Type
Occ Comment
The acknowledge message returned
response qualifAcknowledgeType 1..1 after processing a qualification
request.
2.2.3 srvQualifByLlid
Purpose: Gets information on possible broadband connections to a given destination by LLID
2.2.3.1 REQUEST: srvQualifByLlId
Element Type
srvQualifType
llId
xs:string (minLength:1, maxLength:13)
Occ Comment
1..1
1..1 The local loop ID.
2.2.3.2 RESPONSE: srvQualifByLlidResponse
Element Type
Occ Comment
The acknowledge message returned
response qualifAcknowledgeType 1..1 after processing a qualification
request.
2.2.4 srvQualifByStartPoint
Purpose: Gets information on possible broadband connections to a given destination by Start Point
2.2.4.1 REQUEST: srvQualifByStartPoint
Element
Type
srvQualifType
startPoint
startPoint
Occ
1..1
1..1
Comment
A start point.
startPoint
Element
Swisscom (Schweiz) AG
CH-3050 Bern
Type
Occ Comment
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
11/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
taxRegion
accessNet
unitType
unitNumber
sse
contactType
xs:int (totalDigits:3) 1..1
xs:string
(minLength:1,
maxLength:5)
xs:int
xs:int
xs:int
xs:int (totalDigits:3)
1..1
[LOV-ID: 1504] The tax region part of
a start- or end-point (e.g. "62").
The access net part of a start- or endpoint (e.g. "ALL").
1..1
1..1
1..1
0..1 [LOV-ID: 0115] The type of contact for
UP.
contactNr
xs:int (totalDigits:6) 0..4 The contact number for UP.
[LOV-ID: 1070] Copper minimal
upPreparation xs:int (totalDigits:3) 0..1 development (1 = Normal, 2 =Copper
minimal development, 3...5 = Reserve)
2.2.4.2 RESPONSE: srvQualifByStartPointResponse
Element Type
Occ Comment
The acknowledge message returned
response qualifAcknowledgeType 1..1 after processing a qualification
request.
2.2.5 srvQualifBySocket
Purpose: Gets information on possible broadband connections to a given destination by Start Point
2.2.5.1 REQUEST: srvQualifFiberType
Element
Type
ispId
xs:int (totalDigits:6)
basisContrEleId
xs:int (totalDigits:3)
contrEleId
xs:int (totalDigits:3)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
1..1 An ISP ID.
[LOV-ID: 0320] A
1..1 basis contract
element ID
[LOV-ID: 0320] A
0..n contract element
ID.
12/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
bbType
xs:int (totalDigits:3)
dnType
xs:int (totalDigits:3)
qualifExtRef
xs:string (minLength:1,
maxLength:80)
customerWishDate xs:date
sfSlaId
xs:int (totalDigits:3)
[LOV-ID: 0276]
The BB type.
[LOV-ID: 0109]
0..n
The DN type.
An external
reference
(assigned by the
0..1 ISP) for
identification of
the qualification
request.
0..1 The customer wish
date.
0..1 [LOV-ID: 0282]
The service
fulfillment SLA ID.
0..n
Element
choice
Type
Occ
xs:string
A socket id or a
socketId
(minLength:13,
1..1 1..1
coorporation Id
maxLength:19)
xs:string
cooperationId
1..1
(maxLength:100)
plugNr
xs:int (totalDigits:3)
businessType
xs:int (totalDigits:3)
A plug number
(1..4).
[LOV-ID: 1301]:
Business Type
0..1
(New, Relocation,
Product Change...)
0..1
2.2.5.2 RESPONSE: srvQualifBySocketResponse
Element Type
Occ Comment
The acknowledge message returned
response qualifAcknowledgeType 1..1 after processing a qualification
request.
2.2.6
srvQualifByBinding
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
13/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Description: This operation returns service qualification and resource availability statements for a
given request by Binding ID only.
2.2.6.1 REQUEST: srvQualifBySocket
Element
Type
basisContrEleId
xs:int (totalDigits:3)
contrEleId
xs:int (totalDigits:3)
bbType
xs:int (totalDigits:3)
dnType
xs:int (totalDigits:3)
qualifExtRef
xs:string (minLength:1,
maxLength:80)
customerWishDate xs:date
synchWithVoice
xs:boolean
lineState
xs:int (totalDigits:3)
newLoop
xs:boolean
sfSlaId
xs:int (totalDigits:3)
hasOnp
businessType
xs:boolean
xs:int (totalDigits:3)
bindingId
xs:string (maxLength:15)
Occ Comment
[LOV-ID: 0320] A basis
1..1
contract element ID
[LOV-ID: 0320] A
0..n
contract element ID.
[LOV-ID: 0276] The BB
0..n
type.
[LOV-ID: 0109] The DN
0..n
type.
An external reference
(assigned by the ISP) for
0..1
identification of the
qualification request.
0..1 The customer wish date.
0..1 Synchronize with voice.
[LOV-ID: 1052] The
0..1
copper line state.
0..1 Qualify for a new loop.
[LOV-ID: 0282] The
0..1
service fulfillment SLA ID.
0..1
0..1
The binding id (e.g.
1..1
AC1.222.333.444).
2.2.7 srvQualifByBindingResponse
Element Type
Occ Comment
The acknowledge message returned
response qualifAcknowledgeType 1..1 after processing a qualification
request.
2.2.8
Common Request Elements for all Copper srvQualif-Operations: srvQualifType
srvQualifType
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
14/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Element
ispId
Type
xs:int (totalDigits:6)
basisContrEleId
xs:int (totalDigits:3)
contrEleId
xs:int (totalDigits:3)
Occ Comment
1..1 An ISP ID.
[LOV-ID: 0320] A
1..1 basis contract
element ID
[LOV-ID: 0320] A
contract element
0..n ID.
Isn't evaluated by Service
Availability QualificationService
bbType
xs:int (totalDigits:3)
dnType
xs:int (totalDigits:3)
qualifExtRef
xs:string (minLength:1,
maxLength:80)
[LOV-ID: 0276]
The BB type.
[LOV-ID: 0109]
0..n
The DN type.
An external
reference (assigned
by the ISP) for
identification of the
0..1
qualification
request.
0..n
Isn't evaluated by Service
Availability QualificationService
customerWishDate xs:date
synchWithVoice
xs:boolean
lineState
xs:int (totalDigits:3)
newLoop
xs:boolean
sfSlaId
xs:int (totalDigits:3)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
The customers wish
date.
0..1 Isn't evaluated by
Service
Availability QualificationService
Synchronize with
voice.
0..1 Isn't evaluated by
Service
Availability QualificationService
[LOV-ID: 1052]
0..1 The copper line
state.
Qualify for a new
0..1
loop.
[LOV-ID: 0282]
0..1 The service
fulfillment SLA ID.
15/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Isn't evaluated by Service
Availability QualificationService
hasOnp
Has Operator
Number Portabilty
xs:boolean
businessType
0..1 Isn't evaluated by
Service
Availability QualificationService
[LOV-ID: 1301]:
Business Type
(New, Relocation,
0..1
Product Change...)
xs:int (totalDigits:3)
Isn't evaluated by Service
Availability QualificationService
Element
Occ Comment
Appointment ID
appointment xs:long
referencing an
1..1
Id
(totalDigits:10)
existing
agreement.
appointment
Type
appointment
xs:dateTime
DateTime
2.2.9
Isn't evaluated by Service
0..1 Availability QualificationService
Date and Time of
1..1
an Appointment
Response Elements for all srvQualif-Operations
qualifAcknowledgeType
Element
Type
success
xs:boolean
reason
reasonComment
dnStnr
xs:string
(pattern:[\dAZ]{3})
xs:string
(minLength:1,
maxLength:256)
xs:string
(pattern:0[19]\d{8})
qualificationResult qualificationResult
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
The result code for the transaction
1..1 ("true" if request was successful,
"false" otherwise).
A 3-letter error code (aka
0..1 messageId) where "000" means
"ok".
0..1
Some additional textual description
for the reason.
0..1 The DN "Stammnummer".
Represents a technology (bbType)
specific quali response. A list of
0..n
qualification answers for this
particular BB type and service mix
16/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
combination. LQS Service
Availability Qualification Interface:
qualifAnswer occurs only once
qualificationResult
Element Type
contrEleId xs:int
bbType
xs:int (totalDigits:3)
dnType
xs:int (totalDigits:3)
qualifNr
xs:long (totalDigits:10)
Occ Comment
0..n
[LOV-ID: 0276] The BB
0..1
type.
[LOV-ID: 0109] The DN
0..1
type.
0..1
[LOV-ID: 1052] The copper
0..1
line state.
lineState xs:int (totalDigits:3)
Choice
Element
Type
Occ Comment
qualifAnswer
qualifAnswer
1..n
1..1
fiberQualifAnswer fiberQualifAnswer 1..n
qualifAnswer
Element
Type
xs:string (Enumeration: ok, ok_stao,
quali
ResultState planned, nok)
Element Type
quali
ResultDetai
l
endPoint
xs:string
(minLength:1,
maxLength:4)
result
Code
result
xs:string
Commen (minLength:1,
t
maxLength:256)
Element
Type
taxRegion
xs:int
(totalDigits:3)
xs:string
accessNet (minLength:1,
maxLength:5)
xs:string
(maxLength:4)
site
siteCatego xs:int
ry
(totalDigits:3)
bbDevice
Location
Swisscom (Schweiz) AG
CH-3050 Bern
xs:string
(minLength:1,
maxLength:20)
Occ Comment
[LOV-ID: 1053] State
0..1 of the Qualification
Result.
Oc
Comment
c
1. Qualification Result
.1 Code
0..n
Some additional textual
1.
description for the
.1
result.
Oc
Comment
c
[LOV-ID: 1504] The tax
0.
region part of a start- or
.1
end-point (e.g. "62").
The access net part of a
0.
start- or end-point (e.g.
.1
"ALL").
0. Site of the Broad Band
.1 Device Location.
0. [LOV-ID: 9008] The site
.1 categorization.
An end point
(consisting of a DN
0..1
office and a BB device
location).
0. The broad band device
.1 location. (e.g. "AES")
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
17/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Element
Type
taxRegion
xs:int
(totalDigits:3)
xs:string
accessNet (minLength:1,
maxLength:5)
Oc
Comment
c
[LOV-ID: 1504] The tax
0.
region part of a start- or
.1
end-point (e.g. "62").
The access net part of a
0.
start- or end-point (e.g.
.1
"ALL").
site
xs:string
(maxLength:4)
0. Site of the Broad Band
.1 Device Location.
bbDevice
Location
xs:string
(minLength:1,
maxLength:20)
0. The broad band device
.1 location. (e.g. "AES")
equipped
Date
xs:string
(pattern:2[09]{3}(-[01][09](-[0-3][09])?)?)
PUS Date (Format: yyyy1.
mm-dd, yyyy-mm or
.1
yyyy)
xs:int
(totalDigits:3)
[There are different
building process.
Depending on which
phase it is, the equippe
date quality is different.
The target values are
(only for
1.
information):1:= 99.9%;
.1
2:= 99%; 3:= 97%; 4:=
95%; 5:= 75%; 9x:= are
exception cases; 99:=
abort of a building
process; 98:= end date is
over but it is not usable
at the moment
equipped
Date
Quality
planned
EndPoint
equipped
Date
xs:string
Comment
The equippedDate
1.
embedded in a comment
.1
string
planned
Speed
1. The planned bitrate
.1 (up/down).
duplexSpeedType
A planned end point
(plannedEndpoint wird
abgefüllt, wenn
bekannt ist, dass der
0..1
Startpunkt in Zukunft
von einem neuen
Breitbandziel bedient
wird.).
equippedD equippedDateHis 0. Equipped Date History:
ateHistory tory
.n list the last 3 changes (if
there are some) Sort
number: 1 (nearest) ... 3
(oldest) [LOV-ID: 1324]
LOV_EQUIPPED_DATE_E
VENT_TYPE
1=TargetDateChange;
2=ValidityClassException
If EventType = 1 TargetDateChange: Then
the format is:2[09]{3}((-[01][0-9]))((-[03][0-9])); If EventType =
2ValidityClassException:
Then the format is: string
max length 5, example:
from: GK4 to: GK98
extension xs:int
Swisscom (Schweiz) AG
CH-3050 Bern
1. [LOV-ID: 9023]
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
18/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Category
(totalDigits:3)
Element
cpeName
.1 LOV_EXTENSION_CATEG
ORY: Ausbau Kategorie:
1 = PUS Neubau; 2 =
FTTS/B Neubau; 3 =
Vectoring
Ausbau/Aktivierung
Type
Occ Comment
xs:string
CPE (Customer
(maxLengt 1..1
Modem) Name
h:100)
dslamTypeAllowed
DSLAM Type(s)
which are supported
dslamType
0..n from the cpe - only
Allowed
current Technolgoie
is in focus
vectoringCapability
[LOV-ID: 9009]
Vectoring Capability
xs:int
( 1 = vectoring
(totalDigits 0..1 capable (Ok); 2 =
:3)
friendly (Ok); 3 =
Alien (NOk); 4 unknown (alien) )
comment
xs:string
(minLengt
h:1,
0..1 A comment.
maxLength
:256)
cpeInfo
Element Type
max
AccessSpe
ed
speed
xs:int (totalDigits:3)
ProfileNr
xs:string
descripti
(minLength:1,
on
maxLength:60)
Oc
Comment
c
1. [LOV-ID: 1010] A
.1 speed profile number.
0.
.1
billingZone xs:int (totalDigits:3)
Element
Swisscom (Schweiz) AG
CH-3050 Bern
Type
The speed profile
identifying the
0..1
maximum possible
access speed.
[LOV-ID: 1050] The
average flag marking
the average answer
within a multi-answer
qualif response (0=The
non-average qualif
0..1
answer; 1=The
average qualif answer
(strict address qualif);
2=The average qualif
answer (fuzzy address
qualif)).
[LOV-ID: 1503] The
0..1
billing zone.
averageFla
xs:int (totalDigits:3)
g
fulfilment
0..1 Information about the
CPE.
Oc
Comment
c
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
0..n A list of fulfillment
19/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
TimeSlot
fulfillment
TimeSlot
QualifIndex
xs:long
(total
Digits:10)
The index identifying a
1.
profile within a
.1
qualification response.
fulfilment
TimeSlotStart
xs:
dateTime
1. Start Date Time of the
.1 Fullfillment Time Slot
fulfilment
TimeSlotEnd
xs:
dateTime
0. End Date Time of the
.1 Fullfillment Time Slot
time slots
Oc
Comment
c
[LOV-ID: 1504] The tax region
xs:int
1.
part of a start- or end-point
(totalDigits:3) .1
(e.g. "62").
Element Type
tax
Region
startPoint
access
Net
xs:string
1. The access net part of a start(minLength:1,
.1 or end-point (e.g. "ALL").
maxLength:5)
unit
Type
xs:int
1.
.1
unit
xs:int
Number
1.
.1
sse
1.
.1
xs:int
0..1 A start point.
contactT xs:int
0. [LOV-ID: 0115] The type of
ype
(totalDigits:3) .1 contact for UP.
contactN xs:int
0.
The contact number for UP.
r
(totalDigits:6) .4
[LOV-ID: 1070] Copper
upPrepa xs:int
0. minimal development (1 =
ration
(totalDigits:3) .1 Normal, 2 =Copper minimal
development, 3...5 = Reserve)
street
xs:string (minLength:1,
maxLength:30)
Oc
Comment
c
0. The street name of
.1 an address.
houseNr
xs:string (minLength:1,
maxLength:12)
0. The house number
.1 of an address.
building
xs:string (minLength:1,
maxLength:30)
The building
0.
infomation of an
.1
address.
zip
xs:int
(minInclusive:1000,
maxInclusive:999999)
0. The zip of an
.1 address.
city
xs:string (minLength:1,
maxLength:25)
0. The city of an
.1 address.
Element Type
address
addition xs:string (minLength:1,
alCity
maxLength:25)
resource
Availability
The address associated
with this start point.
The additional city
0.
information of an
.1
address.
Element
Type
Occ
Comment
available
xs:
boolean
1..1
true if the resource is
available, else false.
resource
Type
xs:int
(total
Digits:3)
1..1
[LOV-ID: 1055] Resource
Type (1 = Port; 2 =
Copper).
upgrade
xs: date
0..1
The planned upgrade
Swisscom (Schweiz) AG
CH-3050 Bern
0..1
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
A list of resource
availability statements.
true if the resource is
0..n
available, else false.
The planned upgrade
time if resource
20/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
PlanDate
Time
Element
qualif
Index
qualifProfil
e
current
DnType
llId
llDate
Oc
Comment
c
xs:long
The index identifying a profile
0.
(totalDigits:1
within a qualification
.1
0)
response.
Type
used
A speed profile type.
speedProfileTyp 0.
AccessSpe
(speedProfileNr +
e
.1
ed
description)
service
Speed
A speed profile type.
speedProfileTyp 1.
(speedProfileNr +
e
.1
description)
effective
Speed
duplexSpeedTyp 0. The effective speed. (up /
e
.1 down)
Type
speedProfile xs:int
Nr
(totalDigits:3)
xs:string
(minLength:1,
maxLength:60)
Oc
Comment
c
1. [LOV-ID: 1010] A
.1 speed profile number.
0..1
0.
.1
xs:string (minLength:1,
maxLength:13)
The current access
speed profile
0..1 The local loop ID.
Element
activationDate
Type
xs:date
Occ
0..1
disconnectionDate
xs:date
0..1
jumperActi
xs:boolean
on
bbr
Recommen xs:int (totalDigits:3)
dation
Swisscom (Schweiz) AG
CH-3050 Bern
Represents a speed
profile making up a
0..n
part of a qualification
result.
[LOV-ID: 0109] The
current DnType (only
0..1 set by the LQS Service
Availability
Qualification)
xs:int (totalDigits:3)
description
unavailable.
time if resource
unavailable.
xs:int
0. The number of wires (only
nrOfWires (totalDigits:2
.1 copper).
)
Element
current
AccessSpe
ed
Time
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Comment
0..1 Local Loop Date
Ueberfuehrungsrelevan
t (true/false).
[LOV-ID: 1051]
Broadband ready
recommendation of
Field Service (FS)
0..1 Installation: 0 = na (it
is not possible to give
a self install
recommendation); 1 =
BBR necessary (no self
0..1
21/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
potential
Available
xs:int (totalDigits:1)
reasonOfPo
reasonOfPotential
tential
0..1
0..1
technology
xs:int (totalDigits:3)
Type
0..1
lineState
xs:int (totalDigits:3)
0..1
vectorized
xs:boolean
0..1
install recommended);
2 = no BBR necessary
(selfinstall possible); 3
= no BBR necessary
(selfinstall possible); 4
= BBR necessary (no
self install
recommended); 5 =
BBR Socket installed;
6 = reserve; 7 =
reserve; 8 = reserve;
9 = reserve;
[LOV-ID 1054]
Potential available that
after a BBR an
upgrooming could be
started - so the access
speed will may be
higher and the quality
will not be worse.
Reason of Potential why is the Current
Access Speed lower
then the maximum
[LOV-ID 9025]
LOV_TECHNOLOGY_TY
PE: Which standard
was uesd for bitrate
calculation: 1 =
VDSL2; 2 = VDSL
Vectoring
[LOV-ID: 1052] The
copper line state.
true if line is currently
vectorized
reasonOfPotential
Element Type
Swisscom (Schweiz) AG
CH-3050 Bern
Occ Comment
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
22/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Description of Potential Potential Code negative value:
reason why the maximum speed is lower then the
current access profile. -1000: Pending downgrooming
without service impact -1001: Pending downgrooming
with service impact -1100: Pending devloc change
(lengthing order) -1200: The profile is set manually 1300: -1400: The access is unstable -1501: ICA
problem – impact on stability: BridgeTap -1502: ICA
problem – impact on stability: Degraded Contact -1503:
ICA problem – impact on speed: Missing Splitter -1504:
ICA problem – impact on stability: Missing Splitter on
alarm system (Business Decision) -1505: ICA problem –
impact on stability: External Interference detected 1506: ICA problem – impact on stability: Intermittent
contact -1507: ICA problem – impact on stability: Loop
unbalanced -1508: ICA problem – impact on stability:
Untwisted in-house wiring -1509: ICA problem – impact
on stability: Time varying noise (crosstalk and RFI) 1510: ICA problem – impact on stability: CPE
interoperability problem -1511: ICA problem – impact
potential potential 1..n
on stability: Black-listed CPE -1517: ICA problem –
impact on stability: Abnormal crosstalk -1518: ICA
problem – impact on stability: Defect switched power
supply -1519: ICA problem – impact on speed:
BridgeTap on overhead line -1600: Stability reached
with downgrade positive value: reason why the
maximum speed is higher then the current acccess
profile +1000: outstanding upgrooming +1100: pending
devloc change (short order) +1200: the profile is set
manually +1300: Old CPE hardware +1301: CPE
hardware doesn’t support Vectoring. +1302: CPE
firmware doesn’t support Vectoring Potential Code
negative value: reason why the maximum speed is
lower then the current access profile. -1000: Pending
downgrooming without service impact -1001: Pending
downgrooming with service impact -1100: Pending
devloc change (lengthing order) -1200: The profile is set
manually -1300: -1400: The access is unstable -1501:
ICA problem – impact on stability: BridgeTap -1502: ICA
problem – impact on stability: Degraded Contact -1503:
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
23/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
ICA problem – impact on speed: Missing Splitter -1504:
ICA problem – impact on stability: Missing Splitter on
alarm system (Business Decision) -1505: ICA problem –
impact on stability: External Interference detected 1506: ICA problem – impact on stability: Intermittent
contact -1507: ICA problem – impact on stability: Loop
unbalanced -1508: ICA problem – impact on stability:
Untwisted in-house wiring -1509: ICA problem – impact
on stability: Time varying noise (crosstalk and RFI) 1510: ICA problem – impact on stability: CPE
interoperability problem -1511: ICA problem – impact
on stability: Black-listed CPE -1517: ICA problem –
impact on stability: Abnormal crosstalk -1518: ICA
problem – impact on stability: Defect switched power
supply -1519: ICA problem – impact on speed:
BridgeTap on overhead line -1600: Stability reached
with downgrade positive value: reason why the
maximum speed is higher then the current acccess
profile +1000: outstanding upgrooming +1100: pending
devloc change (short order) +1200: the profile is set
manually +1300: Old CPE hardware +1301: CPE
hardware doesn’t support Vectoring. +1302: CPE
firmware doesn’t support Vectoring Potential Description
fiberQualifAnswer
Element
Type
qualiResultStat xs:string (Enumeration: ok, ok_stao, planned,
e
nok)
Element
Type
xs:string (minLength:1,
maxLength:4)
qualiResultDet
ail
result Code
result
Comment
xs:string (minLength:1,
maxLength:256)
endPoint
Element
taxRegion
Type
xs:int (totalDigits:3)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
[LOV-ID:
1053]
1.. State of
1 the
Qualificatio
n Result.
Occ Comment
1..1 Qualification Result Code
1..1
Some additional textual
description for the result.
Occ Comment
0..1 [LOV-ID: 1504] The tax
0..
n
0.. An end
1 point
24/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
region part of a start- or
end-point (e.g. "62").
accessNet
The access net part of a
xs:string (minLength:1,
0..1 start- or end-point (e.g.
maxLength:5)
"ALL").
site
xs:string
(maxLength:4)
siteCategory
xs:int (totalDigits:3)
bbDevice
Location
xs:string (minLength:1,
The broad band device
0..1
maxLength:20)
location. (e.g. "AES")
Element
locationId
houseNr
xs:string (minLength:1,
maxLength:12)
0..1
building
xs:string (minLength:1,
maxLength:30)
The building
0..1 infomation of an
address.
zip
xs:int (minInclusive:1000,
maxInclusive:999999)
0..1
The zip of an
address.
city
xs:string (minLength:1,
maxLength:25)
0..1
The city of an
address.
additionalCity
xs:string (minLength:1,
maxLength:25)
The additional city
0..1 information of an
address.
flatMemo
Swisscom (Schweiz) AG
CH-3050 Bern
The house number
of an address.
The
address
0..
associated
1
with this
start point.
0.. A location
1 id
xs:int
flatId
bep
0..1 [LOV-ID: 9008] The site
categorization.
Occ Comment
The street name of
0..1
an address.
Element
socket
Site of the Broad Band
Device Location.
Type
xs:string (minLength:1,
maxLength:30)
street
address
0..1
(consisting
of a DN
office and
a BB
device
location).
Type
Occ Comment
xs:string
0..1 A flat id (e.g. 02.01).
(maxLength:6 false)
xs:string
(maxLength:64)
0..1 flatMemo
socketId
xs:string
(minLength:13,
maxLength:19)
1..1
A socket id (e.g.
A.123.456.789).
cooperationId
xs:string
(maxLength:100)
0..1
A cooperation id (e.g.
FreeFormText).
State of fiber line. Populated
fiberLineState xs:int (totalDigits:3) 0..1 here, if no plug exists, else
under plug
otoState
xs:int (totalDigits:3) 0..1
The state of the OTO (optical
termination outlet).
Populated here, if no plug
exists, else under plug
firstInHouse
xs:boolean
Is this the first socket in the
house?
0..1
availabilityDate xs:date
0..1 an availability date
plug
0..n A list of plugs
plugType
Element
Type
Occ Comment
locationId
xs:int
1..
1
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
A location id.
0.. List of
n sockets
0.. Building
n Entry Point
25/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
xs:int
(totalDigits:3)
0..
1
The BEP State
(connected, available,
planned or not
connected)
availability
availability
0..
1
possible values are:
"GK1", "GK2", "GK3",
"GK4", "GK5",
"GK98", "GK99"
inHouseAllowed
xs:boolean
0..
1
In house installation
allowed
firstInHouse
xs:boolean
1..
1
maxAccessSpeedKbps
xs:int
1..
n
bepState
initialMountingShaftCapac xs:string
ity
(maxLength:3
2)
1..
1
possible values are:
"available", "not
available", "not
checked"
bepBuilder
xs:string
(maxLength:8
)
0..
1
possible values are:
"SCS", "KOPA"
siteCategory
xs:string
(maxLength:3
2)
0..
1
possible values are:
"standard",
"remote_fan_fibre_sp
ot"
events
events
0..
1
possible values are:
"1 TargetDateChange",
"2 ValidityClassException
", "99 - Reserve"
address
addressType
0..
1
An (geographical)
address entity.
The BEP
State
(connected
, available,
planned or
not
connected)
plugType
Element
Type
plugNr
xs:int (totalDigits:3)
fiberLineState
xs:int (totalDigits:3)
otoState
xs:int (totalDigits:3)
availabilityDate xs:date
remark
xs:string
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
1..
A plug number (1..4).
1
0.. The state for the whole
1 fiber line
The state of the OTO
0..
(optical termination
1
outlet)
0..
1
0.. a remark
26/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
1
maxAccessSpee
d
qualifProfile
jumperAction
Element
Type
Occ Comment
[LOV-ID:
1010] A
1..1
speed profile
number.
speedProfileNr
xs:int
(totalDigits:3)
description
xs:string
(minLength:1,
maxLength:60)
Element
Type
qualifIndex
xs:long
(totalDigits:10)
0..
access profiles
1
0..1
Occ Comment
The index
identifying
0.. a profile
1
within a
qualificatio
n response.
A speed
usedAccessSpee
0..
speedProfileType
profile
d
1
type.
0..
qualification profiles
n
A speed
1..
profile
1
type.
serviceSpeed
speedProfileType
effectiveSpeed
The
duplexSpeedTyp 0..
effective
e
1
speed.
0.. Ueberfuehrungsrelevan
1 t (true/false).
xs:boolean
equippedDateHistory
Element
Type
Occ Comment
sortNr
xs:int
1..1
changeDate
xs:string (pattern:2[09]{3}((-[01][0-9])?)((-[03][0-9])?))
1..1
eventType
xs:int (totalDigits:3)
1..1
[LOV-ID: 1324] LOV_EQUIPPED_DATE_EVENT_TYPE
1=TargetDateChange; 2=ValidityClassException
Sort number: 1 (nearest) ... 3 (oldest)
from
xs:string (maxLength:10)
1..1
If EventType = 1 - TargetDateChange: Then the format
is:2[0-9]{3}((-[01][0-9]))((-[0-3][0-9])); If EventType
= 2 - ValidityClassException: Then the format is: string
max length 5, example: from: GK4 to: GK98
to
xs:string (maxLength:10)
1..1
If EventType = 1 - TargetDateChange: Then the format
is:2[0-9]{3}((-[01][0-9]))((-[0-3][0-9])); If EventType
= 2 - ValidityClassException: Then the format is: string
max length 5, example: from: GK4 to: GK98
1..1
Example: [1] Technology change; [2] Port shortage;
[3] Missing material; [4] Veto major customer;[5] Veto
municipality; [6] Management re-priorisation; [7]
Acquisition delay; [8] Construction delay; [9] Changed
changeReasonId
Swisscom (Schweiz) AG
CH-3050 Bern
xs:int
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
27/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
in the planning phase; [10] Changed in the
construction phase; [11] Changed by cooperation
partner
changeReasonDescription xs:string (maxLength:100)
1..1
Events
Element Type
Element
eventType
event
Occ Comment
Type
Occ Comment
possible values are: "1 xs:string
TargetDateChange", "2 1..1
(maxLength:32)
ValidityClassException",
"99 - Reserve"
sequenceNumber xs:int
1..1
eventTimeStamp xs:dateTime
1..1
from
xs:string
0..1
(maxLength:10)
to
xs:string
0..1
(maxLength:10)
eventReason
xs:string
0..1
(maxLength:100)
possible values are: "1 TargetDateChange", "2 1..n
ValidityClassException", "99 Reserve"
Availability
Element
Occ
Comment
availabilityDate xs:date
0..1
Availability date and target date are synonyms.
Customers are able to order the service at this date.
validityClass
xs:string (minLength:1, maxLength:12)
1..1
Validity class and quality class are synonyms.
Possible values are: "GK1", "GK2", "GK3", "GK4",
"GK5", "GK98", "GK99"
reason
xs:string (minLength:1, maxLength:256) 0..1
2.3
2.3.1
Type
getQualifHistory
REQUEST: getQualifHistoryRequestType
Element Type
ispId
xs:int (totalDigits:6)
Occ
1..1
Comment
An ISP ID.
orderNr
1..1
The order ID.
2.3.2
xs:string (pattern:[1-9]\d{25})
RESPONSE: getQualifHistoryAckType
Element
Type
success
xs:boolean
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
The result code for the
1..1
transaction ("true" if
28/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
request was successful,
"false" otherwise).
A 3-letter error code (aka
xs:string (pattern:[\dAreason
0..1 messageId) where "000"
Z]{3})
means "ok".
xs:string (minLength:1,
Some additional textual
reasonComment
0..1
maxLength:256)
description for the reason.
qualifLogId
xs:long (totalDigits:10) 1..1 Qualification Log Id
transDateTime
xs:dateTime
1..1 The transition date/time.
xs:string (pattern:[1orderNr
0..1 The order ID.
9]\d{25})
A group Id of a TDM
groupId
xs:long (totalDigits:10) 0..1
message.
The qualification request
qualifHistoryRequest qualifHistoryReqDataType 1..1 from the history selected
time slot
The qualification response
qualifHistoryResponse qualifHistoryResDataType 1..1
from the history
qualifHistoryReqDataType
Element
Type
qualifNr
xs:long (totalDigits:10)
qualifIndex
xs:long (totalDigits:10)
fulfillmentTime
fulfillmentTimeSlot
Slot
ispId
xs:int (totalDigits:6)
contrEleId
xs:int (totalDigits:3)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
The
1..
qualificatio
1
n ID.
The index
identifying
a profile
0..
within a
1
qualificatio
n
response.
0..
1
1..
An ISP ID.
1
1.. [LOV-ID:
1 0320] A
29/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
bbType
xs:int (totalDigits:3)
dnType
xs:int (totalDigits:3)
Element Type
xs:string
dnVnNs
(pattern:0[1n
9]\d{8})
xs:string
llId
(minLength:1,
maxLength:13)
- choice:
qualifExtRef
Swisscom (Schweiz) AG
CH-3050 Bern
contract
element
ID.
[LOV-ID:
0..
0276] The
n
BB type.
[LOV-ID:
0..
0109] The
1
DN type.
Occ Comment
1.. A DN/VN/NSN
1 phone number.
1.. The local loop
1 ID.
The start point
associated with
this
1..
startPoi startPointRequestT 1.. qualification
1
nt
ype
1 result.
(example:
"79,TET,UP,2,1"
)
subjectAddressTyp 1.. A subject's
address
e
1 postal address.
bindingI xs:string
1.. The binding id
d
(maxLength:15)
1 (e.g.
AC1.222.333.44
4).
xs:string (minLength:1, maxLength:80)
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
An
external
reference
(assigned
0..
by the
1
ISP) for
identificati
on of the
qualificatio
30/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
customerWishD
xs:date
ate
0..
1
synchWithVoice xs:boolean
0..
1
lineState
xs:int (totalDigits:3)
0..
1
newLoop
xs:boolean
0..
1
sfSlaId
xs:int (totalDigits:3)
0..
1
hasOnp
xs:boolean
0..
1
businessType
xs:int (totalDigits:3)
0..
1
appointment
appointmentType
0..
1
n request.
The
customer
wish date.
Synchroni
ze with
voice.
[LOV-ID:
1052] The
copper
line state.
Qualify for
a new
loop.
[LOV-ID:
0282] The
service
fulfillment
SLA ID.
Has
Operator
Number
Portabilty
[LOV-ID:
1301]:
Business
Type
(New,
Relocation
, Product
Change...)
An
Appointme
nt
fulfillmentTimeSlot
Element
Type
fulfillmentTimeSlotQualifIndex xs:long
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
1..1 The index identifying a
31/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
(totalDigits:10)
fulfillmentTimeSlotStart
xs:dateTime
fulfillmentTimeSlotEnd
xs:dateTime
profile within a qualification
response.
Start Date Time of the
1..1
Fullfillment Time Slot
End Date Time of the
0..1
Fullfillment Time Slot
startPointRequestType
Element
Type
upPreparation
xs:int
(totalDigits:3)
taxRegion
accessNet
unitType
unitNumber
sse
contactType
contactNr
xs:int
(totalDigits:3)
xs:string
(minLength:1,
maxLength:5)
xs:int
(totalDigits:3)
xs:int
(totalDigits:6)
xs:int
(totalDigits:2)
xs:int
(totalDigits:3)
xs:int
(totalDigits:6)
Occ Comment
[LOV-ID: 1070] Copper minimal
0..1 development (1 = Normal, 2 =Copper
minimal development, 3...5 = Reserve)
[LOV-ID: 1504] The tax region part of a
1..1
start- or end-point (e.g. "62").
1..1
The access net part of a start- or end-point
(e.g. "ALL").
1..1 The type of unit for UP.
1..1 The number of unit for UP.
1..1 The 'sse' for UP.
0..1 [LOV-ID: 0115] The type of contact for UP.
0..4 The contact number for UP.
subjectAddressType
Element
firstName
lastName
street
Swisscom (Schweiz) AG
CH-3050 Bern
Type
xs:string (minLength:1,
maxLength:30)
xs:string (minLength:1,
maxLength:30)
xs:string (minLength:1,
maxLength:30)
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
0..1 A subject's first name.
0..1 A subject's last name.
0..1
The street name of an
address.
32/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
xs:string (minLength:1,
maxLength:12)
xs:string (minLength:1,
building
maxLength:30)
xs:int (minInclusive:1000,
zip
maxInclusive:999999)
xs:string (minLength:1,
city
maxLength:25)
xs:string (minLength:1,
additionalCity
maxLength:25)
The house number of an
address.
The building infomation of
0..1
an address.
houseNr
0..1
0..1 The zip of an address.
0..1 The city of an address.
0..1
The additional city
information of an address.
appointmentType
Element
Type
xs:long
(totalDigits:10)
appointmentId
appointmentDateTime
appointmentEndDateTime
xs:dateTime
xs:dateTime
Occ Comment
Appointment ID referencing
1..1
an existing agreement.
Date and Time of an
1..1
Appointment
End Date and Time of an
1..0
Appointment
2.3.2.1
qualifHistoryResDataType
Element
Type
qualifNr
xs:long (totalDigits:10)
dnStnr
xs:string (pattern:0[1-9]\d{8})
llId
xs:string (minLength:1,
maxLength:13)
Occ Comment
0..
The qualification ID.
1
0.. The DN
1 "Stammnummer".
0..
The local loop ID.
1
0.. [LOV-ID: 1010] A speed
1 profile number.
serviceProf
xs:int (totalDigits:3)
ile
Eleme
Type
Occ Comment
availableSe nt
0..
rviceProfile
1
xs:int
1.. [LOV-ID:
s
nr
(totalDigits: n 1010] A speed
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
33/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
3)
dnType
xs:int (totalDigits:3)
endPoint
endPointType
profile
number.
jumperActi
xs:boolean
on
xs:string (minLength:13,
socketId
maxLength:19)
plugNr
xs:int (totalDigits:3)
messageId
xs:string (pattern:[\dA-Z]{3})
Lqs
messageId
xs:string (pattern:[\dA-Z]{3})
Qualif
reasonCom xs:string (minLength:1,
ment
maxLength:256)
cpeInfo
cpeInfo
nrOfWires xs:int (totalDigits:2)
technologyTy xs:int (totalDigits:3)
pe
vectorized
xs:boolean
0.. [LOV-ID: 0109] The DN
1 type.
An end point (consisting
0.. of a DN office and a BB
1 device location) and port
information.
0.. Ueberfuehrungsrelevant
1 (true/false).
0..
1
0..
1
0.. An error code where
1 '000' indicates 'OK'.
0.. An error code where
1 '000' indicates 'OK'.
Some additional textual
0..
description for the
1
reason.
0.. Information about the
1 CPE.
0.. The number of wires
1 (only copper).
0..1 [LOV-ID: 9025]
LOV_TECHNOLOGY_TYPE:
Which standard was uesd for
bitrate calculation: 1 = VDSL2;
2 = VDSL Vectoring
0..1 true if line is currently
vectorized
endPointType
Element
Type
siteCategory xs:int (totalDigits:3)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
[LOV-ID: 9008] The site
0..1
categorization.
34/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
bbPortInfo
bbPortInfoType
0..1
Information about the
Port in the loop.
bbPortInfoType
Element
Type
dslamName
dslamType
bbPortNr
bbAdslEmulated
dslamVectoringCapable
Occ Comment
name of the DSLAM
xs:string (maxLength:30) 0..1 (e.g.: ipc-aar730-s-vd05)
[LOV-ID: 1064]: DSLAM
xs:int (totalDigits:3)
0..1
Type.
xs:string (minLength:1,
0..4 Splitter port
maxLength:15)
[LOV-ID: 0401]: ADSL
xs:int (totalDigits:3)
0..1
emulated flag.
xs:boolean
0..1 true if dslam is vectoring
capable
2.4
getSrvStatus
Purpose: Obtain status information on a currently installed product or service.
2.4.1 REQUEST: getServiceStatusRequestType
Element Type
Occ Comment
ispId
xs:int (totalDigits:6)
1..1 An ISP ID.
dnVnNsn xs:string (pattern:0[1-9]\d{8}) 1..1 A DN/VN/NSN phone number.
2.4.2
RESPONSE: getServiceStatusResponseType
Element Type
contrEleI
xs:int (totalDigits:3)
d
extRef
xs:string (minLength:1, maxLength:80)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Oc
Comment
c
[LOV-ID: 0320] A
0..
contract element
1
ID.
An external
0..
reference
1
provided by the
35/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
ISP.
sla
Elemen
Type
t
xs:int
sfSlaId
(totalDigits:3)
saSlaId
ispId
xs:int
(totalDigits:3)
Occ Comment
0.. [LOV-ID: 0282] The service
1
fulfillment SLA ID.
0.. [LOV-ID: 0283] The service
1
level assurance id
xs:int (totalDigits:6)
ispName xs:string (minLength:1, maxLength:30)
dnVnNsn xs:string (pattern:0[1-9]\d{8})
billingZo
xs:int (totalDigits:3)
ne
bbType
xs:int (totalDigits:3)
endPoint endPointBaseType
startPoin
t
Element
Type
taxRegion
xs:int
(totalDigits:3)
accessNet
xs:string
(minLength:1,
maxLength:5)
The access net part of a
1..
start- or end-point (e.g.
1
"ALL").
unitType
xs:int
1..
1
unitNumber
xs:int
1..
1
sse
xs:int
1..
1
contactType
xs:int
(totalDigits:3)
0.. [LOV-ID: 0115] The
1
type of contact for UP.
contactNr
xs:int
(totalDigits:6)
0.. The contact number for
4
UP.
upPreparatio xs:int
n
(totalDigits:3)
[LOV-ID: 1070] Copper
minimal development
0.. (1 = Normal, 2
1
=Copper minimal
development, 3...5 =
Reserve)
1..
1
0..
1
0..
1
0..
1
0..
1
0..
1
An ISP ID.
The name of the
ISP.
A DN/VN/NSN
phone number.
[LOV-ID: 1503]
The billing zone.
[LOV-ID: 0276]
The BB type.
Occ Comment
[LOV-ID: 1504] The tax
1.. region part of a start1
or end-point (e.g.
"62").
reasonOf
reasonOfPotentialType
Potential
Swisscom (Schweiz) AG
CH-3050 Bern
0..
1
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
0..
A start point.
1
Reason of
0..
Potential - why is
1
the Current
36/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Access Speed
lower then the
maximum
[LOV-ID: 0205]
0.. Info used in
1 manual exception
handling.
0.. [LOV-ID: 0109]
1 The DN type.
bbAccess xs:int (totalDigits:3)
dnType
xs:int (totalDigits:3)
Element
Type
xs:int
(totalDigits:6)
boardNr
Occ Comment
1..
UP Board Nr.
1
switchingPlaceN xs:int
r
(totalDigits:6)
cableBox
region
1..
UP Switching Place Nr.
1
contactType
xs:int
(totalDigits:3)
1.. [LOV-ID: 0115] The type of
1
contact for UP.
contactNr
xs:int
(totalDigits:6)
1..
The contact number for UP.
4
coordinateX
xs:int
(totalDigits:6)
0..
X coordinate of UP.
1
coordinateY
xs:int
(totalDigits:6)
0..
Y coordinate of UP.
1
0.. [LOV-ID: 1501]
1 The region.
The number of
0..
wires (only
1
copper).
xs:int (totalDigits:3)
nrOfWire
xs:int (totalDigits:2)
s
accessSp
eed
Element
Type
speedProfileN
xs:int (totalDigits:3)
r
description
Occ Comment
1.. [LOV-ID: 1010] A
1
speed profile number.
xs:string (minLength:1,
maxLength:60)
0..
1
Element
cpeName
Swisscom (Schweiz) AG
CH-3050 Bern
Type
xs:string
(maxLength:100)
0..
1
The DHCP PoolType (named
item) of the
subscriber (e.g.
0..
"pool2"); the
1
LOV-ID 1007
shows the
currently available
Pool-Type names.
poolType xs:string (minLength:1)
cpeInfo
The cable box
0.. (aka.
1 "Ueberfuehrungsp
unkt", "UP").
Occ Comment
0..
CPE (Customer Modem)
1..1
1
Name
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Information about
the CPE.
37/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
DSLAM Type(s) which
are supported from the
cpe - only current
Technolgoie is in focus
dslamTypeAllo
wed
0..n
vectoringCapability
xs:int
(totalDigits:3)
[LOV-ID: 9009]
Vectoring Capability ( 1
= vectoring capable
0..1
(Ok); 2 = friendly (Ok);
3 = Alien (NOk); 4 unknown (alien) )
comment
xs:string
(minLength:1,
maxLength:256)
0..1 A comment.
dslamTypeAllowed
[LOV-ID: 4006]
The CPE owner.
(aka "modem
owner")
[LOV-ID: 1005]
The session type.
[LOV-ID: 1008]
The interleave
mode.
[LOV-ID: 1006]
The termination
type.
cpeOwne
xs:int (totalDigits:3)
r
0..
1
sessionT
xs:int (totalDigits:3)
ype
0..
1
interleav
xs:int (totalDigits:3)
eMode
0..
1
terminati
xs:int (totalDigits:3)
on
0..
1
vectorized xs:boolean
technology xs:int (totalDigits:3)
Type
0..1
0..1 [LOV-ID: 9025]
LOV_TECHNOLOG
Y_TYPE: Which
standard was uesd for
bitrate calculation: 1 =
VDSL2; 2 = VDSL
Vectoring
0.. [LOV-ID: 1014]
1 The OP Status.
opStatus xs:int (totalDigits:3)
Element
socketId
Socket
Service
Type
xs:string (minLength:13,
maxLength:19)
Occ Comment
1.. A socket id (e.g.
1
A.123.456.789).
cooperationI xs:string
d
(maxLength:100)
0.. A cooperation id (e.g.
1
FreeFormText).
plug
1..
A list of plugs
n
Element
contrEleId
Swisscom (Schweiz) AG
CH-3050 Bern
plugSmallType
Type
xs:int
(totalDigits:3)
Occ Comment
1.. [LOV-ID: 0320] A
1
contract element ID.
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
0..
A socket (fiber)
1
0.. The service part
n of a service status
38/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
response.
sla
sla
0..
1
speedProfile
speedProfileType
0..
The speed profile.
1
speedProfileReq
speedProfileType
0..
A speed profile type.
1
effectiveSpeed
duplexSpeedType
0..
The effective speed.
1
bbQuality
xs:int
(totalDigits:3)
0.. [LOV-ID: 1009] The BB
1
quality.
classOfService
xs:int
(totalDigits:3)
0.. [LOV-ID: 1108] The
1
Class of Service.
fairUseSpeedProfileN xs:int
r
(totalDigits:3)
xs:string
(minLength:1,
maxLength:80)
extRef
[LOV-ID: 1109] The
requested fair use
0.. profile Nr (e.g. 0 :=
1
"Restore original Service
Speed Profile" 1, :=
"600 down / 100 up").
0.. An external reference
1
provided by the ISP.
endPointType
Element
Type
siteCategory xs:int (totalDigits:3)
bbPortInfo
bbPortInfoType
Occ Comment
[LOV-ID: 9008] The site
0..1
categorization.
Information about the
0..1
Port in the loop.
bbPortInfoType
Element
Type
dslamName
dslamType
bbPortNr
bbAdslEmulated
dslamVectoringCapable
Swisscom (Schweiz) AG
CH-3050 Bern
Occ Comment
name of the DSLAM
xs:string (maxLength:30) 0..1 (e.g.: ipc-aar730-s-vd05)
[LOV-ID: 1064]: DSLAM
xs:int (totalDigits:3)
0..1
Type.
xs:string (minLength:1,
0..4 Splitter port
maxLength:15)
[LOV-ID: 0401]: ADSL
xs:int (totalDigits:3)
0..1
emulated flag.
xs:boolean
0..1 true if dslam is vectoring
capable
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
39/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
2.5
createCustomerOrder
Purpose: Place a new customer order.
2.5.1 REQUEST: customerOrderRequestType
Element
Type
customer
xs:string (pattern:[1-9]\d{25})
OrderNr
Occ Comment
The customer
0..1
order ID.
The order group
orderGroupNr xs:long (totalDigits:12)
0..1
ID.
The work order
wosId
xs:string (maxLength:17)
0..1 synchronisation
ID.
Required if the
Element
Type
Occ Comment
base product is
The
xs:long
not BBCS on TDM
qualifNr
1..1 qualification
(totalDigits:10)
ID.
(Contract
The index
Element 110).
identifying a
xs:long
profile
The qualification
qualifIndex
1..1
(totalDigits:10)
within a
qualification
0..1
Nr is optional for
qualification
response.
a base product
The index
with Contract
identifying a
Element 110. The
xs:long
profile
fulfillmentTimeSlotQualifIndex
0..1
(totalDigits:10)
within a
qualification Nr
qualification
must be valid
response.
and not expired.
A DN/VN/NSN
dnVnNsn
xs:string (pattern:0[1-9]\d{8})
0..1
phone number.
[LOV-ID: 1003]
The so-called
creationType xs:int (totalDigits:3)
1..1
"kind of creation"
of an order.
delivery
Notification if x
xs:boolean
0..1
Notification
day before
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
40/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
planned
activation the
order isn't ready.
order
orderRequestType
Known extension of orderRequestType
are:
 createType
 disconnectType
 modifyType
 coCreateIntType
 ispChangeType
 addType
 changeType
 modifyPendingBaseOrdType
 modifyPendingSrvOrdType
 reduceType
1..n
A customer
order.
2.5.1.1 createType (Extension of orderRequestType)
Part of a customer order. Purpose: Create a BBCS connection as a base for
services.
Extension of orderRequestType
Element
Type
OccComment
[LOV-ID:
1.. 0320] A
contrEleId
xs:int (totalDigits:3)
1 contract
element ID.
An external
xs:string (minLength:1,
0.. reference
extRef
maxLength:80)
1 provided by
the ISP.
The
0..
customerWishDate
xs:date
customer
1
wish date.
The date of
0..
disconDate
xs:date
service
1
deactivation.
xs:string (minLength:1,
0..
comment
A comment.
maxLength:256)
1
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
41/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
appointmentId
xs:long (totalDigits:10)
selfInstall
xs:int (totalDigits:3)
Element
Type
xs:int
(totalDigits:3)
Occ Comment
[LOV-ID: 0276] The
1..1
BB type.
sessionType
xs:int
(totalDigits:3)
1..1
[LOV-ID: 1005] The
session type.
termination
xs:int
(totalDigits:3)
0..1
[LOV-ID: 1006] The
termination type.
poolType
xs:string
(minLength:1)
0..1
bbType
layer2
ElementType
xs:int
sfSlaId
(totalDigits:3)
sla
saSlaId
xs:int
(totalDigits:3)
Occ Comment
[LOV-ID: 0282] The service
0..1
fulfillment SLA ID.
0..1
[LOV-ID: 0283] The service
level assurance id
processWithLowPriorit
xs:boolean
y
inhouseInstallationRe
quest
Element
Type
Occ
ContactAddress
contactAddressType 1..1
InstallationNotice
xs:string (minLength:1,
0..1
maxLength:256)
Appointment
ID
0..
referencing
1
an existing
agreement.
[LOV-ID:
0.. 4005] Type
1 of Self
Installation.
A layer2
type with
some
required
1..
elements.
1
Required if
SESSION_T
YPE is
DHCP.
Service
0..
Level
1
Agreement
Process an
0..
order with
1
low priority
Information
Comment
Customer Contact
needed for a
Information
0..
fiber in
Comment 1
for
dispatching andhouse
service engineer
installation
contactAddressType
Element
Type
xs:string (minLength:1,
firstName
maxLength:30)
xs:string (minLength:1,
lastName
maxLength:30)
language xs:string
Swisscom (Schweiz) AG
CH-3050 Bern
Occ Comment
0..1 A subject's first name.
0..1 A subject's last name.
0..1 ISO 639-1 (Codes for the
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
42/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
representation of names of
languages) (de = german; fr =
french; it = italian)
xs:string (minLength:5,
maxLength:100)
xs:string (pattern:
phone
(\+)?([0-9]){7,15})
xs:string (minLength:1,
comment
maxLength:256)
Element
Type
eMail
0..1 An E-Mail address ([email protected])
0..1 phone number
a comment to this address
Informations
Occ Comment
0..1
2.5.1.2 disconnectType (Extension of orderRequestType)
Part of a customer order. Purpose: Disconnect all services and the base
product.
Extension of: orderRequestType
Element
Type
Occ Comment
xs:string (minLength:1,
An external reference
extRef
0..1
maxLength:80)
provided by the ISP.
The customers wish
customerWishDate
xs:date
0..1
date.
xs:string (minLength:1,
comment
0..1 A comment.
maxLength:256)
Process an order with
processWithLowPriority xs:boolean
0..1
low priority
2.5.1.3 modifyType (Extension of orderRequestType)
Part of a customer order. Purpose: Modify an installed BBCS base product.
Extension of: orderRequestType
Element
Type
Occ Comment
An external
xs:string (minLength:1,
extRef
0..1 reference provided
maxLength:80)
by the ISP.
The customer wish
customerWishDate
xs:date
0..1
date.
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
43/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
The date of service
deactivation.
disconDate
xs:date
0..1
comment
xs:string (minLength:1,
maxLength:256)
0..1 A comment.
appointmentId
xs:long (totalDigits:10)
selfInstall
xs:int (totalDigits:3)
Element
Occ Comment
[LOV-ID:
xs:int
1..1 0276] The BB
(totalDigits:3)
type.
Type
bbType
layer2
Appointment ID
referencing an
0..1
existing
agreement.
[LOV-ID: 4005]
0..1 Type of Self
Installation.
[LOV-ID:
xs:int
sessionType
1..1 1005] The
(totalDigits:3)
session type.
[LOV-ID:
xs:int
1006] The
termination
0..1
(totalDigits:3)
termination
type.
poolType
Layer2
information.
0..1 Required if
SESSION_TYPE is
DHCP.
xs:string
0..1
(minLength:1)
ElementType
sla
Occ Comment
[LOV-ID: 0282]
xs:int
sfSlaId
0..1 The service
(totalDigits:3)
fulfillment SLA ID.
saSlaId
xs:int
(totalDigits:3)
processWithLowPriority xs:boolean
[LOV-ID: 0283]
0..1 The service level
assurance id
0..1
Service Level
Agreement
0..1
Process an order
with low priority
2.5.1.4 coCreateIntType (Extension of orderRequestType)
Part of a customer order. Purpose: Create an onsite installation ticket as part
of the customer order. Note: The whole customer order will be aborted if a
CO_CREATE_INT detail order is submitted without a preceding order for a
BBCS service (within the same customer order).
Extension of: orderRequestType
Element
Type
Occ Comment
0..
onsiteSupport
xs:int (totalDigits:3)
1
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
44/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
xs:string (minLength:1,
maxLength:30)
ispItRef
Element Type
xs:string
name
(minLength:1,
maxLength:60)
endUser
phone
xs:string
(pattern:0[19]\d{8})
An external
reference (an ID
0.. assigned by the
1 ISP) identifying
the installation
ticket
Occ Comment
0..
A name.
1
A nomalized
phone number
1..
(e.g.
1
"0312223344"
)
xs:string
commen (minLength:1,
0..
t
maxLength:2048 1
)
Contact
information on
1..
the end user
1
(name, phone
numbers, etc)
holdFlag
xs:boolean
0..
1
hwDeliveryState
xs:int (totalDigits:3)
0..
1
hwDeliveryDate
xs:date
hwDeliveryLocation
hwType
hwExtRefReq
Swisscom (Schweiz) AG
CH-3050 Bern
xs:string (minLength:1,
maxLength:128)
xs:string (minLength:1,
maxLength:128)
xs:string (minLength:1,
maxLength:128)
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
If set to true the
Installation Ticket
is hold until
Hardware
Delivery Date.
[LOV-ID: 4007]
Hardware
Delivery State.
Hardware
Delivery Date.
Hardware
delivery location
0..
1
0..
1
0..
CPE Description
1
Additional
Information if
ONSITE_SUPPOR
T is not set to
0..
1="None": CPE
1
SAP OrderNumber of
equipment
requested
45/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
installDateTimeRange
installationType
Element
from
Type
xs:dateTime
Occ Comment
1..1
to
xs:dateTime
1..1
xs:string (minLength:1,
maxLength:30)
additionalInstallationRe
xs:int (totalDigits:3)
q
appointmentId
xs:long (totalDigits:10)
0.. Installation
1 frame.
Additional
0..
installation
1
description.
[LOV-ID: 4004]
The requested
0..
additional
n
installation
support.
Appointment ID
0.. referencing an
1 existing
agreement.
2.5.1.5 ispChangeType (Extension of orderRequestType)
Part of a customer order. Purpose: Let a recipient ISP order the take over of a
BBCS service currently operated by a donor ISP. Note: The ISP_CHANGE
detailorder is not sufficient for completing the ISP change operation. At least 1
SRV_ADD must follow within the context of the same logical customer order.
Extension of: orderRequestType
Element
Type
Occ Comment
An external
xs:string (minLength:1,
extRef
0..1 reference provided
maxLength:80)
by the ISP.
The customer wish
customerWishDate
xs:date
0..1
date.
xs:string (minLength:1,
comment
0..1 A comment.
maxLength:256)
Appointment ID
referencing an
appointmentId
xs:long (totalDigits:10)
0..1
existing
agreement.
[LOV-ID: 4005]
selfInstall
xs:int (totalDigits:3)
0..1 Type of Self
Installation.
layer2
Swisscom (Schweiz) AG
CH-3050 Bern
Element
bbType
Type
xs:int
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
1..1 [LOV-ID:
0..1 Layer2
46/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
(totalDigits:3)
sessionType
information.
Required if
SESSION_TYPE is
DHCP.
0276] The BB
type.
[LOV-ID:
xs:int
1..1 1005] The
(totalDigits:3)
session type.
[LOV-ID:
xs:int
1006] The
termination
0..1
(totalDigits:3)
termination
type.
poolType
xs:string
0..1
(minLength:1)
ElementType
sla
Occ Comment
[LOV-ID: 0282]
xs:int
sfSlaId
0..1 The service
(totalDigits:3)
fulfillment SLA ID.
saSlaId
xs:int
(totalDigits:3)
Service Level
Agreement
[LOV-ID: 0283]
0..1 The service level
assurance id
processWithLowPriority xs:boolean
0..1
Process an order
with low priority
2.5.1.6 addType (Extension of orderRequestType)
Part of a customer order. Purpose: Add a service to an existing BBCS
connection.
Extension of: orderRequestType
Element
Type
Occ Comment
[LOV-ID: 0320] A
contrEleId
xs:int (totalDigits:3)
1..1
contract element ID.
xs:string (minLength:1,
An external reference
extRef
0..1
maxLength:80)
provided by the ISP.
The customer wish
customerWishDate xs:date
0..1
date.
The date of service
disconDate
xs:date
0..1
deactivation.
xs:string (minLength:1,
comment
0..1 A comment.
maxLength:256)
[LOV-ID: 1010] The
speedProfileNrReq xs:int (totalDigits:3)
0..1 requested speed
profile number.
ElementType
sla
Swisscom (Schweiz) AG
CH-3050 Bern
Occ Comment
[LOV-ID: 0282]
xs:int
sfSlaId
0..1 The service
(totalDigits:3)
fulfillment SLA ID.
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
0..1
Service Level
Agreement
47/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
saSlaId
xs:int
(totalDigits:3)
[LOV-ID: 0283]
0..1 The service level
assurance id
appointmentId
xs:long (totalDigits:10)
classOfService
xs:int (totalDigits:3)
Appointment ID
0..1 referencing an existing
agreement.
[LOV-ID: 1108] The
0..1
Class of Service.
2.5.1.7 changeType (Extension of orderRequestType)
Part of a customer order. Purpose: Modify an existing service.
Extension of: orderRequestType
Element
Type
Occ Comment
[LOV-ID: 0320] A
contrEleId
xs:int (totalDigits:3)
1..1
contract element ID.
xs:string (minLength:1,
An external reference
extRef
0..1
maxLength:80)
provided by the ISP.
The customer wish
customerWishDate
xs:date
0..1
date.
The date of service
disconDate
xs:date
0..1
deactivation.
xs:string (minLength:1,
comment
0..1 A comment.
maxLength:256)
[LOV-ID: 1010] The
speedProfileNrReq
xs:int (totalDigits:3)
0..1 requested speed profile
number.
ElementType
sla
Occ Comment
[LOV-ID:
0282] The
xs:int
sfSlaId
0..1 service
(totalDigits:3)
fulfillment
SLA ID.
[LOV-ID:
xs:int
0283] The
saSlaId
0..1
(totalDigits:3)
service level
assurance id
appointmentId
xs:long (totalDigits:10)
classOfService
xs:int (totalDigits:3)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
0..1
Service Level
Agreement
Appointment ID
0..1 referencing an existing
agreement.
0..1 [LOV-ID: 1108] The
48/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
fairUseSpeedProfileNr xs:int (totalDigits:3)
Class of Service.
[LOV-ID: 1109] The
requested fair use
profile Nr (e.g. 0 :=
0..1 "Restore original
Service Speed Profile"
1, := "600 down / 100
up").
2.5.1.8 modifyPendingBaseOrdType (Extension of orderRequestType)
Part of a customer order. Purpose: Modify a pending BBCS base product order.
Extension of: orderRequestType
Element
Type
Occ Comment
xs:string (minLength:1,
An external reference
extRef
0..1
maxLength:80)
provided by the ISP.
The customer wish
customerWishDate xs:date
0..1
date.
The date of service
disconDate
xs:date
0..1
deactivation.
xs:string (minLength:1,
comment
0..1 A comment.
maxLength:256)
appointmentId
xs:long (totalDigits:10)
selfInstall
xs:int (totalDigits:3)
Element
Type
xs:int
(totalDigits:3)
Occ Comment
[LOV-ID: 0276]
1..1
The BB type.
sessionType
xs:int
(totalDigits:3)
[LOV-ID: 1005]
1..1 The session
type.
termination
xs:int
(totalDigits:3)
[LOV-ID: 1006]
0..1 The termination
type.
poolType
xs:string
(minLength:1)
0..1
bbType
layer2
sla
Swisscom (Schweiz) AG
CH-3050 Bern
ElementType
xs:int
sfSlaId
(totalDigits:3)
Occ Comment
[LOV-ID: 0282] The
0..1
service fulfillment
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Appointment ID
0..1 referencing an
existing agreement.
[LOV-ID: 4005] Type
0..1
of Self Installation.
Layer2 information.
Required if
0..1
SESSION_TYPE is
DHCP.
0..1
Service Level
Agreement
49/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
SLA ID.
saSlaId
xs:int
(totalDigits:3)
[LOV-ID: 0283] The
0..1 service level
assurance id
2.5.1.9 modifyPendingSrvOrdType (Extension of orderRequestType)
Part of a customer order. Purpose: Change an existing service related order.
Extension of: orderRequestType
Element
Type
Occ Comment
[LOV-ID: 0320] A
contrEleId
xs:int (totalDigits:3)
1..1
contract element ID.
xs:string (minLength:1,
An external reference
extRef
0..1
maxLength:80)
provided by the ISP.
The customer wish
customerWishDate
xs:date
0..1
date.
The date of service
disconDate
xs:date
0..1
deactivation.
xs:string (minLength:1,
comment
0..1 A comment.
maxLength:256)
[LOV-ID: 1010] The
speedProfileNrReq
xs:int (totalDigits:3)
0..1 requested speed
profile number.
ElementType
sla
Occ Comment
[LOV-ID:
0282] The
xs:int
sfSlaId
0..1 service
(totalDigits:3)
fulfillment
SLA ID.
0..1
[LOV-ID:
xs:int
0283] The
saSlaId
0..1
(totalDigits:3)
service level
assurance id
processWithLowPriority xs:boolean
appointmentId
xs:long (totalDigits:10)
classOfService
xs:int (totalDigits:3)
fairUseSpeedProfileNr xs:int (totalDigits:3)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Service Level
Agreement
Process an order with
low priority
Appointment ID
0..1 referencing an existing
agreement.
[LOV-ID: 1108] The
0..1
Class of Service.
[LOV-ID: 1109] The
0..1
requested fair use
0..1
50/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
profile Nr (e.g. 0 :=
"Restore original
Service Speed Profile"
1, := "600 down / 100
up").
2.5.1.10
reduceType (Extension of orderRequestType)
Part of a customer order. Purpose: Remove an installed service.
Extension of: orderRequestType
Element
Type
Occ Comment
[LOV-ID: 0320] A
contrEleId
xs:int (totalDigits:3)
1..1
contract element ID.
xs:string (minLength:1,
An external reference
extRef
0..1
maxLength:80)
provided by the ISP.
The customers wish
customerWishDate
xs:date
0..1
date.
xs:string (minLength:1,
comment
0..1 A comment.
maxLength:256)
Process an order with
processWithLowPriority xs:boolean
0..1
low priority
2.5.2 RESPONSE: customerOrderAckType
The acknowledge message returned after processing an customer order
request.
Element
Type
success
xs:boolean
reason
xs:string (pattern:[\dA-Z]{3})
reasonComment xs:string (minLength:1,
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
The result code for
the transaction
1..1 ("true" if request
was successful,
"false" otherwise).
A 3-letter error
code (aka
0..1
messageId) where
"000" means "ok".
0..1 Some additional
51/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
maxLength:256)
customerOrderNr xs:string (pattern:[1-9]\d{25})
orderGroupNr
xs:long (totalDigits:12)
nsn
xs:string (pattern:010\d{7})
orderItem
Element
Type
success
xs:boolean
reason
xs:string
(pattern:[\dAZ]{3})
xs:string
reason
(minLength:1,
Comment
maxLength:256)
orderNr
xs:string
(pattern:[19]\d{25})
Occ Comment
The result code for
the transaction
1..1 ("true" if request
was successful,
"false" otherwise).
A 3-letter error
code (aka
0..1
messageId) where
"000" means "ok".
Some additional
0..1 textual description
for the reason.
textual description
for the reason.
The customer order
0..1
ID.
0..1 The order group ID.
A Net Service
0..1
Number
The acknowledge
message returned
0..n
after processing an
order request.
0..1 The order ID.
2.6
getTransactionOverview
Purpose: Create a transaction overview over the various WSG transactions overtime
2.6.1 REQUEST: getTransactionOverviewRequestType
Purpose: List transactions.
Element
Type
Occ Comment
ispId
xs:int (totalDigits:6)
1..1 An ISP ID.
xs:string (pattern:0[1dnVnNsn
1..1 A DN/VN/NSN phone number.
9]\d{8})
[LOV-ID: 9001] The type of
transition. (1 =
WORK_ORDER; 2 =
transType1 xs:int (totalDigits:3)
0..n
VOICE_MESSAGE; 3 =
ACCESS_TICKET; 4 =
WORK_TICKET; 5 = ALARM)
Element
Choice
Type
transDate
TimeRange
Swisscom (Schweiz) AG
CH-3050 Bern
Occ Comment
A range of
dateTime
1..1 transition
RangeType
dates/times.
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
0..1
52/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
transDateTime xs:dateTime 1..1
The transition
date/time.
2.6.2 RESPONSE: getTransactionOverviewAckType
This class represents a response message returned by the
getTransactionOverview operation.
Element Type
Occ Comment
The result code for the
1.. transaction ("true" if
success xs:boolean
1 request was successful,
"false" otherwise).
A 3-letter error code (aka
0..
reason xs:string (pattern:[\dA-Z]{3})
messageId) where "000"
1
means "ok".
reason
Some additional textual
xs:string (minLength:1,
0..
Comme
description for the
maxLength:256)
1
nt
reason.
trans
action
Element
transDateTi
me
Type
userName
xs:string
transType1
xs:int
1..
(totalDigits:3) 1
transType2
xs:int
1..
(totalDigits:3) 1
transId
xs:integer
transState
xs:int
1..
(totalDigits:3) 1
Swisscom (Schweiz) AG
CH-3050 Bern
xs:dateTime
Occ Comment
1.. Timestamp of last
1 modification. (not null)
1..
1
1..
1
A list of selected
transaction records
The name of the user that
sorted descending by
performed the last
time. This class
modification. (not null)
represents a transaction
[LOV-ID: 9001] The type
of transition. (1 =
record documenting any
WORK_ORDER; 2 =
action on a
VOICE_MESSAGE; 3 =
ACCESS_TICKET; 4 =
WORK_ORDER, a
WORK_TICKET; 5 =
VOICE_MESSAGE, an
ALARM)
[LOV-ID: 9002] The
ACCESS_TICKET, a
transaction sub-type LOV.
0.. WORK_TICKET or an
(e.g. if
transType1=WORK_ORDE n
ALARM. Timestamp of
R then
last modification. (not
transType2:=ORDER_TYP
E hence transType2=1
null) The name of the
means 'ENTERED')
user that performed the
The transaction ID. (e.g.
last modification. (not
if
transType1:=WORK_ORD
null) [LOV-ID: 9002] The
ER then
transaction sub-type LOV.
transId:=ORDER_ID)
(not null)
(e.g. if
The transaction state.
transType1=WORK_ORDE
(e.g. if
transType1=WORK_ORDE
R then
R then
transType2:=ORDER_TYP
transType2:=ORDER_STA
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
53/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
TE hence transType2=2
means 'HOLDING') (not
null)
ispId1
The ID of the ISP
xs:int
1..
involved in the
(totalDigits:6) 1
transaction. (not null)
ispName1
xs:string
(minLength:1
The name of the ISP
1..
,
involved in the
1
maxLength:3
transaction. (not null)
0)
ispId2
The ID of a second ISP
xs:int
0..
involved in the
(totalDigits:6) 1
transaction.
ispName2
xs:string
(minLength:1
The name of a second ISP
0..
,
involved in the
1
maxLength:3
transaction.
0)
dnVnNsn1
xs:string
The DN/VN/NSN
1..
(pattern:0[1associated to that
1
9]\d{8})
transaction. (not null)
dnVnNsn2
xs:string
A second DN/VN/NSN
0..
(pattern:0[1associated to that
1
9]\d{8})
transaction.
response
xs:string
extRef
xs:string
(minLength:1
0.. An external reference
,
1 provided by the ISP.
maxLength:8
0)
0.. A transaction response
1 message.
E hence transType2=1
means 'ENTERED') The
transaction ID. (e.g. if
transType1:=WORK_ORD
ER then
transId:=ORDER_ID)
(not null) The transaction
state. (e.g. if
transType1=WORK_ORDE
R then
transType2:=ORDER_STA
TE hence transType2=2
means 'HOLDING') (not
null) The ID of the ISP
involved in the
transaction. (not null)
The name of the ISP
involved in the
transaction. (not null)
The ID of a second ISP
involved in the
transaction. The name of
a second ISP involved in
the transaction. The
DN/VN/NSN associated to
that transaction. (not
null) A second
DN/VN/NSN associated to
that transaction. A
transaction response
message.
2.7
getOrderDetail
Purpose: Lookup an order in the WSG DB
2.7.1 REQUEST: getDetailRequestType
Element Type
ispId
xs:int (totalDigits:6)
Choice
Element
orderNr
Swisscom (Schweiz) AG
CH-3050 Bern
Type
Occ Comment
xs:string (pattern:[1-9]\d{25}) 1..1 The order ID.
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
1..1 An ISP ID.
1..1 Choice
54/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
customerOrderNr xs:string (pattern:[1-9]\d{25}) 1..1 The customer order ID.
2.7.2 RESPONSE: getDetailAckType
Element
Type
Occ Comment
The result code for the
transaction ("true" if request
success
xs:boolean
1..1
was successful, "false"
otherwise).
A 3-letter error code (aka
xs:string (pattern:[\dAreason
0..1 messageId) where "000" means
Z]{3})
"ok".
xs:string (minLength:1,
Some additional textual
reasonComment
0..1
maxLength:256)
description for the reason.
The generic customer order
type. A list of orders extending
customerOrder customerOrderType
0..1
abstractOrderType (E.g. base or
service order).
customerOrderType:
Element
Type
ispId
xs:int (totalDigits:6)
ispName
xs:string (minLength:1, maxLength:30)
customerOrd
xs:string (pattern:[1-9]\d{25})
erNr
extRef
xs:string (minLength:1, maxLength:80)
dnVnNsn
xs:string (pattern:0[1-9]\d{8})
creationType xs:int (totalDigits:3)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Oc
c
1..
1
1..
1
1..
1
Comment
An ISP ID.
The name of
the ISP.
The customer
order ID.
An external
0.. reference
1 provided by
the ISP.
A DN/VN/NSN
0..
phone
1
number.
[LOV-ID:
0.. 1003] The so1 called "kind of
creation" of an
55/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
reason
xs:string (pattern:[\dA-Z]{3})
0..
1
reasonComm
xs:string (minLength:1, maxLength:256)
ent
0..
1
qualifNr
xs:long (totalDigits:10)
0..
1
qualifIndex
xs:long (totalDigits:10)
0..
1
fulfillmentTim
eSlotQualifIn xs:long (totalDigits:10)
dex
0..
1
billingZone
xs:int (totalDigits:3)
0..
1
wosId
xs:string (maxLength:17)
0..
1
wosIdReq
xs:string (maxLength:17)
0..
1
endPoint
endPointType
0..
1
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
order.
A 3-letter
error code
(aka
messageId)
where "000"
means "ok".
Some
additional
textual
description for
the reason.
The
qualification
ID.
The index
identifying a
profile within a
qualification
response.
The index
identifying a
profile within a
qualification
response.
[LOV-ID:
1503] The
billing zone.
The work
order
synchronisatio
n ID.
The requested
work order
synchronisatio
n ID.
An end point
(consisting of
a DN office
56/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
reasonOfPote
reasonOfPotential
ntial
cpeInfo
cpeInfo
socket
socketType
order
Element
baseProductOrder
Swisscom (Schweiz) AG
CH-3050 Bern
Type
Comment
An order for a base
baseProduct
0..1 product. In case of BBCS
OrderType
standalone
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ
and a BB
device
location) and
port
information.
Reason of
Potential why is the
0..
Current Access
1
Speed lower
then the
maximum
0.. Information
1 about the CPE.
Socket (Fiber)
A flat id (e.g.
02.01). State
of fiber line.
Populated
here, if no
plug exists,
else under
plug The state
of the OTO
0..
(optical
1
termination
outlet).
Populated
here, if no
plug exists,
else under
plug Is this
the first socket
in the house?
A list of plugs
A list of orders
extending
abstractOrder
Type (E.g.
base or
57/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
serviceOrder
serviceOrder
0..n An order for a service.
Type
service order).
An isp change donor order
that reports the new isp
ispChangeDo
receiver to the isp donor.
ispChangeDonorOrder norOrderTyp 0..1
The ISP ID of the new ISP
e
(receiver). The name of the
new ISP (receiver).
sessionType
xs:int (totalDigits:3)
termination
xs:int (totalDigits:3)
[LOV-ID:
0..
1005] The
1
session type.
[LOV-ID:
0.. 1006] The
1 termination
type.
0..1
0..1 [LOV-ID: 9025]
LOV_TECHNOL
OGY_TYPE:
Which standard
was uesd for
bitrate calculation:
1 = VDSL2; 2 =
VDSL Vectoring
vectorized
xs:boolean
technologyType xs:int (totalDigits:3)
baseOrderType
Element
Type
creationType
xs:int (totalDigits:3)
orderNr
xs:string (pattern:[19]\d{25})
1..1 The order ID.
contrEleId
xs:int (totalDigits:3)
0..1
orderType
xs:int (totalDigits:3)
orderState
xs:int (totalDigits:3)
customerWishDate
xs:date
estimatedDue
xs:dateTime
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
[LOV-ID: 1003] The
0..1 so-called "kind of
creation" of an order.
[LOV-ID: 0320] A
contract element ID.
[LOV-ID: 1001] The
1..1
order type.
[LOV-ID: 1002] The
1..1
order status.
The customers wish
0..1
date.
0..1 The estimated due
58/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
DateTimeStart
estimatedDue
DateTimeEnd
date and time start.
The estimated due
0..1
date and time end.
The transition
1..1
date/time.
xs:dateTime
transDateTime
xs:dateTime
comment
xs:string (minLength:1,
maxLength:256)
reason
xs:string (pattern:[\dAZ]{3})
reasonComment
xs:string (minLength:1,
maxLength:256)
extRef
xs:string (minLength:1,
maxLength:80)
A 3-letter error code
(aka messageId)
0..1
where "000" means
"ok".
Some additional
0..1 textual description for
the reason.
An external reference
0..1
provided by the ISP.
ElementType
sla
Occ Comment
[LOV-ID: 0282]
xs:int
The service
sfSlaId
0..1
(totalDigits:3)
fulfillment SLA
ID.
0..1 A comment.
saSlaId
0..1
[LOV-ID: 0283]
xs:int
0..1 The service level
(totalDigits:3)
assurance id
Service Level
Agreement
baseProductOrderType
An order for a base product.
Element
Type
disconDate
xs:date
bbType
xs:int (totalDigits:3)
startPoint
Swisscom (Schweiz) AG
CH-3050 Bern
Occ Comment
0.. The date of service
1 deactivation.
0.. [LOV-ID: 0276] The
1 BB type.
Element
Type
taxRegion
xs:int
(totalDigits:3)
accessNet
xs:string
(minLength:1,
maxLength:5)
The access
net part of a
1..1 start- or
end-point
(e.g. "ALL").
unitType
xs:int
1..1
unitNumber
xs:int
1..1
sse
xs:int
1..1
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
[LOV-ID:
1..1 1504] The
tax region
0..
A start point.
1
59/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
contactType
xs:int
(totalDigits:3)
contactNr
xs:int
(totalDigits:6)
xs:int
upPreparation
(totalDigits:3)
0..1 [LOV-ID:
0115] The
type of
contact for
UP.
0..4 The contact
number for
UP.
[LOV-ID:
1070]
0..1
Copper
minimal
bbAccess
xs:int (totalDigits:3)
bbPortNr
xs:string (minLength:1,
maxLength:15)
dnType
xs:int (totalDigits:3)
dnVnNsnReq
xs:string (pattern:0[19]\d{8})
stnrDdi
xs:string (pattern:0[19]\d{8})
Element
Type
Occ Comment
xs:int
UP Board
1..1
(totalDigits:6)
Nr.
boardNr
switchingPlaceNr
UP
xs:int
1..1 Switching
(totalDigits:6)
Place Nr.
contactType
[LOV-ID:
0115] The
xs:int
1..1 type of
(totalDigits:3)
contact for
UP.
contactNr
The contact
xs:int
1..4 number for
(totalDigits:6)
UP.
coordinateX
X
xs:int
0..1 coordinate
(totalDigits:6)
of UP.
coordinateY
Y
xs:int
0..1 coordinate
(totalDigits:6)
of UP.
cableBox
region
xs:int (totalDigits:3)
address
Element
street
Swisscom (Schweiz) AG
CH-3050 Bern
[LOV-ID: 0205] Info
0..
used in manual
1
exception handling.
0.. Info used in manual
4 exception handling.
0.. [LOV-ID: 0109] The
1 DN type.
0.. The requested
1 DN/VN/NSN.
The base number
0..
("Stammnummer")
1
for DDI.
Type
xs:string
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
The cable box (aka.
0..
"Ueberfuehrungspun
1
kt", "UP").
0.. [LOV-ID: 1501] The
1 region.
Occ Comment
0.. The street
0.. In case of BBCS
60/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
(minLength:1,
maxLength:30)
houseNr
The
house
0..
number
1
of an
address.
building
xs:string
(minLength:1,
maxLength:30)
The
building
0..
infomatio
1
n of an
address.
zip
xs:int
The zip of
(minInclusive:1000, 0..
an
maxInclusive:9999 1
address.
99)
city
xs:string
(minLength:1,
maxLength:25)
sgMm
xs:int (totalDigits:3)
nrOfWires
xs:int (totalDigits:2)
Element
Type
speedProfileNr
xs:int
(totalDigits:3)
description
xs:string
(minLength:1,
maxLength:60)
Swisscom (Schweiz) AG
CH-3050 Bern
standalone
0..
1
0..
1
[LOV-ID: 0107] The
"Schalt-Merkmal".
The number of wires
(only copper).
The
additional
0.. city
1 informatio
n of an
address.
Occ Comment
[LOV-ID:
1010] A
1..1 speed
profile
number.
0..
1
0..1
xs:string (minLength:1)
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
1
The city
0..
of an
1
address.
accessSpeedChange xs:int (totalDigits:3)
poolType
name of
an
address.
xs:string
(minLength:1,
maxLength:12)
xs:string
additionalCi
(minLength:1,
ty
maxLength:25)
accessSpeed
1
[LOV-ID: 1064] The
0..
access speed
1
changed.
The DHCP Pool-Type
(named item) of the
subscriber (e.g.
0..
"pool2"); the LOV-ID
1
1007 shows the
currently available
Pool-Type names.
61/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
cpeOwner
xs:int (totalDigits:3)
appointmentId
xs:long (totalDigits:10)
appointmentDateTi
xs:dateTime
me
selfInstall
xs:int (totalDigits:3)
opStatus
xs:int (totalDigits:3)
inhouseInstallationI
nhouseInstallationInfoType
nfo
history
baseProductOrderHistoryType
[LOV-ID: 4006] The
0..
CPE owner. (aka
1
"modem owner")
Appointment ID
0..
referencing an
1
existing agreement.
0.. Date and Time of an
1 Appointment
0.. [LOV-ID: 4005] Type
1 of Self Installation.
0.. [LOV-ID: 1014] The
1 OP Status.
Information about a
0..
fiber in house
1
installation
0.. An order history for a
n base product.
baseProductOrderHistoryType:
Element
Type
orderState
xs:int (totalDigits:3)
customerWishDate
xs:date
estimatedDueDateTimeStart xs:dateTime
estimatedDueDateTimeEnd xs:dateTime
Occ Comment
[LOV-ID:
1..1 1002] The
order status.
The customer
0..1
wish date.
The estimated
0..1 due date and
time start.
The estimated
0..1 due date and
time end.
The transition
1..1
date/time.
transDateTime
xs:dateTime
comment
xs:string (minLength:1,
maxLength:256)
0..1 A comment.
reason
xs:string (pattern:[\dAZ]{3})
A 3-letter error
0..1 code (aka
messageId)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
62/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
reasonComment
xs:string (minLength:1,
maxLength:256)
extRef
xs:string (minLength:1,
maxLength:80)
Occ Comment
[LOV-ID: 0282]
xs:int
The service
sfSlaId
0..1
(totalDigits:3)
fulfillment SLA
ID.
where "000"
means "ok".
Some
additional
0..1 textual
description for
the reason.
An external
reference
0..1
provided by
the ISP.
ElementType
sla
[LOV-ID: 0283]
xs:int
The service
saSlaId
0..1
(totalDigits:3)
level assurance
id
disconDate
xs:date
bbType
xs:int (totalDigits:3)
Element
Occ Comment
[LOV-ID:
1010] A
xs:int
speedProfileNr
1..1 speed
(totalDigits:3)
profile
number.
accessSpeed
description
The date of
0..1 service
deactivation.
[LOV-ID: 0276]
0..1
The BB type.
0..1
xs:string
(minLength:1, 0..1
maxLength:60)
xs:int (totalDigits:3)
poolType
xs:string (minLength:1)
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Service Level
Agreement
Type
accessSpeedChange
Swisscom (Schweiz) AG
CH-3050 Bern
0..1
[LOV-ID: 1064]
0..1 The access
speed changed.
The DHCP PoolType (named
item) of the
0..1 subscriber (e.g.
"pool2"); the
LOV-ID 1007
shows the
63/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
cpeOwner
currently
available PoolType names.
[LOV-ID: 4006]
The CPE owner.
0..1
(aka "modem
owner")
xs:int (totalDigits:3)
serviceOrderType (Extension of: baseOrderType)
An order for a service.
Element
Type
Occ Comment
Element
speedProfile
speedProfileReq
accessSpeed
Type
speedProfileNr xs:int
Occ Comment
[LOV-ID:
1..1
1010]
description
xs:string 0..1
Element
Type
speedProfileNr xs:int
Occ Comment
[LOV-ID:
1..1
1010]
description
xs:string 0..1
Element
Type
speedProfileNr xs:int
description
Occ Comment
[LOV-ID:
1..1
1010]
ElementType
xs:int
up
(totalDigits:6)
Occ Comment
A speed in
1..1
kbit/sec.
xs:int
(totalDigits:6)
A speed in
1..1
kbit/sec.
down
bbQuality
xs:int (totalDigits:3)
classOfService
xs:int (totalDigits:3)
fairUseSpeedProfileNr xs:int (totalDigits:3)
Swisscom (Schweiz) AG
CH-3050 Bern
0..1 A speed profile type.
0..1
xs:string 0..1
accessSpeedChange xs:int (totalDigits:3)
effectiveSpeed
0..1 The speed profile.
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
0..1
[LOV-ID: 1064] The
access speed changed.
0..1 The effective speed.
[LOV-ID: 1009] The BB
quality.
[LOV-ID: 1108] The
0..1
Class of Service.
[LOV-ID: 1109] The
requested fair use
profile Nr (e.g. 0 :=
0..1 "Restore original
Service Speed Profile"
1, := "600 down / 100
up").
0..1
64/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
history
serviceOrderHistoryType 0..n An order for a service.
serviceOrderHistoryType:
Element
Type
orderState
xs:int (totalDigits:3)
customerWishDate
xs:date
estimatedDueDateTimeStart xs:dateTime
estimatedDueDateTimeEnd xs:dateTime
transDateTime
xs:dateTime
Comment
xs:string (minLength:1,
maxLength:256)
reason
xs:string (pattern:[\dAZ]{3})
reasonComment
xs:string (minLength:1,
maxLength:256)
extRef
xs:string (minLength:1,
maxLength:80)
0..1 A comment.
A 3-letter error
code (aka
0..1 messageId)
where "000"
means "ok".
Some additional
textual
0..1
description for
the reason.
An external
reference
0..1
provided by the
ISP.
ElementType
sla
Occ Comment
[LOV-ID:
0282] The
xs:int
sfSlaId
0..1 service
(totalDigits:3)
fulfillment
SLA ID.
Occ Comment
[LOV-ID: 1002]
1..1
The order status.
The customer
0..1
wish date.
The estimated
0..1 due date and
time start.
The estimated
0..1 due date and
time end.
The transition
1..1
date/time.
[LOV-ID:
xs:int
0283] The
saSlaId
0..1
(totalDigits:3)
service level
assurance id
speedProfile
Swisscom (Schweiz) AG
CH-3050 Bern
Element
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Type
Occ Comment
0..1
Service Level
Agreement
0..1 The speed
65/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
speedProfileNr xs:int
description
xs:string 0..1
Element
Type
speedProfileReq
speedProfileNr xs:int
effectiveSpeed
ElementType
xs:int
up
(totalDigits:6)
description
down
bbQuality
1..1
profile.
[LOV-ID:
1010]
Occ Comment
[LOV-ID:
1..1
1010]
0..1
A speed profile
type.
0..1
The effective
speed.
0..1
[LOV-ID: 1009]
The BB quality.
xs:string 0..1
xs:int
(totalDigits:6)
Occ Comment
A speed in
1..1
kbit/sec.
1..1
A speed in
kbit/sec.
xs:int (totalDigits:3)
ispChangeDonorOrderType (Extension of: baseOrderType)
Element
Type
orderState
xs:int (totalDigits:3)
customerWishDate
xs:date
estimatedDueDateTimeStart xs:dateTime
estimatedDueDateTimeEnd xs:dateTime
transDateTime
xs:dateTime
comment
xs:string (minLength:1,
maxLength:256)
reason
xs:string (pattern:[\dAZ]{3})
reasonComment
xs:string (minLength:1,
maxLength:256)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
[LOV-ID: 1002]
1..1
The order status.
The customer
0..1
wish date.
The estimated
0..1 due date and
time start.
The estimated
0..1 due date and
time end.
The transition
1..1
date/time.
0..1 A comment.
A 3-letter error
code (aka
0..1 messageId)
where "000"
means "ok".
Some additional
0..1 textual
description for
66/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
xs:string (minLength:1,
maxLength:80)
extRef
Occ Comment
[LOV-ID:
0282] The
xs:int
sfSlaId
0..1 service
(totalDigits:3)
fulfillment
SLA ID.
the reason.
An external
reference
0..1
provided by the
ISP.
ElementType
sla
[LOV-ID:
xs:int
0283] The
saSlaId
0..1
(totalDigits:3)
service level
assurance id
0..1
Service Level
Agreement
inhouseInstallationInfoType
Element
Occ Comment
1..
ContactAddress
contactAddressType
Customer Contact Information
1
xs:string (minLength:1, 0.. Comment for dispatching and
InstallationNotice
maxLength:256)
1 service engineer
inhouseAppointme inhouseAppointmentTyp 0.. An inhouse Appointment
nt
e
1
0..
outOfSla
xs:boolean
1
[LOV-ID: 5009]
LOV_COPA_OUTOFSLA_REASO
N (10 = Appointment outside
of SLA due to customer
0.. preference; 20 = Appointment
outOfSlaReason
xs:int (totalDigits:3)
1 outside of SLA caused by
Installation Partner Swisscom;
30 = Appointment outside of
SLA caused by Installation
Partner KoPa)
xs:string (minLength:1, 0.. Notice text with the reason for
outOfSlaComment
maxLength:256)
1 Out of SLA
Swisscom (Schweiz) AG
CH-3050 Bern
Type
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
67/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
subjectAddressType
Element Type
xs:string (minLength:1,
firstName
maxLength:30)
xs:string (minLength:1,
lastName
maxLength:30)
Occ Comment
0..1 A subject's first name.
0..1 A subject's last name.
ISO 639-1 (Codes for the
representation of names of
0..1
languages) (de = german; fr =
french; it = italian)
language xs:string
xs:string (minLength:5,
maxLength:100)
xs:string (pattern:0[1phone
9]\d{8})
xs:string (minLength:1,
comment
maxLength:256)
eMail
0..1 An E-Mail address ([email protected])
0..1 phone number
0..1
a comment to this address
Informations
inhouseInstallationInfoType
Element
Occ Comment
1..
ContactAddress
contactAddressType
Customer Contact Information
1
xs:string (minLength:1, 0.. Comment for dispatching and
InstallationNotice
maxLength:256)
1 service engineer
inhouseAppointme inhouseAppointmentTyp 0..
An inhouse Appointment
nt
e
1
0..
outOfSla
xs:boolean
1
[LOV-ID: 5009]
LOV_COPA_OUTOFSLA_REASO
N (10 = Appointment outside
of SLA due to customer
0.. preference; 20 = Appointment
outOfSlaReason
xs:int (totalDigits:3)
1 outside of SLA caused by
Installation Partner Swisscom;
30 = Appointment outside of
SLA caused by Installation
Partner KoPa)
Swisscom (Schweiz) AG
CH-3050 Bern
Type
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
68/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
outOfSlaComment
xs:string (minLength:1, 0.. Notice text with the reason for
maxLength:256)
1 Out of SLA
reasonOfPotential
Element Type
Occ Comment
Description of Potential Potential Code negative value:
reason why the maximum speed is lower then the
current access profile. -1000: Pending downgrooming
without service impact -1001: Pending downgrooming
with service impact -1100: Pending devloc change
(lengthing order) -1200: The profile is set manually 1300: -1400: The access is unstable -1501: ICA
problem – impact on stability: BridgeTap -1502: ICA
problem – impact on stability: Degraded Contact -1503:
ICA problem – impact on speed: Missing Splitter -1504:
ICA problem – impact on stability: Missing Splitter on
alarm system (Business Decision) -1505: ICA problem –
impact on stability: External Interference detected 1506: ICA problem – impact on stability: Intermittent
contact -1507: ICA problem – impact on stability: Loop
unbalanced -1508: ICA problem – impact on stability:
Untwisted in-house wiring -1509: ICA problem – impact
potential potential 1..n
on stability: Time varying noise (crosstalk and RFI) 1510: ICA problem – impact on stability: CPE
interoperability problem -1511: ICA problem – impact
on stability: Black-listed CPE -1517: ICA problem –
impact on stability: Abnormal crosstalk -1518: ICA
problem – impact on stability: Defect switched power
supply -1519: ICA problem – impact on speed:
BridgeTap on overhead line -1600: Stability reached
with downgrade positive value: reason why the
maximum speed is higher then the current acccess
profile +1000: outstanding upgrooming +1100: pending
devloc change (short order) +1200: the profile is set
manually +1300: Old CPE hardware +1301: CPE
hardware doesn’t support Vectoring. +1302: CPE
firmware doesn’t support Vectoring Potential Code
negative value: reason why the maximum speed is
lower then the current access profile. -1000: Pending
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
69/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
downgrooming without service impact -1001: Pending
downgrooming with service impact -1100: Pending
devloc change (lengthing order) -1200: The profile is set
manually -1300: -1400: The access is unstable -1501:
ICA problem – impact on stability: BridgeTap -1502: ICA
problem – impact on stability: Degraded Contact -1503:
ICA problem – impact on speed: Missing Splitter -1504:
ICA problem – impact on stability: Missing Splitter on
alarm system (Business Decision) -1505: ICA problem –
impact on stability: External Interference detected 1506: ICA problem – impact on stability: Intermittent
contact -1507: ICA problem – impact on stability: Loop
unbalanced -1508: ICA problem – impact on stability:
Untwisted in-house wiring -1509: ICA problem – impact
on stability: Time varying noise (crosstalk and RFI) 1510: ICA problem – impact on stability: CPE
interoperability problem -1511: ICA problem – impact
on stability: Black-listed CPE -1517: ICA problem –
impact on stability: Abnormal crosstalk -1518: ICA
problem – impact on stability: Defect switched power
supply -1519: ICA problem – impact on speed:
BridgeTap on overhead line -1600: Stability reached
with downgrade positive value: reason why the
maximum speed is higher then the current acccess
profile +1000: outstanding upgrooming +1100: pending
devloc change (short order) +1200: the profile is set
manually +1300: Old CPE hardware +1301: CPE
hardware doesn’t support Vectoring. +1302: CPE
firmware doesn’t support Vectoring Potential Description
cpeInfo
Element
cpeName
Type
Occ
xs:string
1..1
(maxLength:100)
dslamTypeAllow
dslamTypeAllowed
ed
Swisscom (Schweiz) AG
CH-3050 Bern
0..n
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Comment
CPE (Customer
Modem) Name
DSLAM Type(s)
which are
supported from the
cpe - only current
Technolgoie is in
70/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
vectoringCapabi xs:int
lity
(totalDigits:3)
0..1
vectoringCapabl
xs:boolean
eHardware
0..1
vectoringCapabl
xs:boolean
eFirmware
0..1
focus
[LOV-ID: 9009]
Vectoring
Capability ( 1 =
vectoring capable
(Ok); 2 = friendly
(Ok); 3 = Alien
(NOk); 4 unknown (alien) )
Does this CPE
Hardware support
Vectoring?
Does this CPE
Firmware support
Vectoring?
xs:string
(minLength:1,
0..1
maxLength:256)
comment
A comment.
dslamTypeAllowed
Element
technology
dslamType
Type
xs:int
(totalDigits:3)
xs:int
(totalDigits:3)
Occ
Comment
1..1 [LOV-ID: 999245] The technology
0..n [LOV-ID: 1064]: DSLAM Type.
socketType
Element
flatId
flatMemo
socketId
Swisscom (Schweiz) AG
CH-3050 Bern
Type
xs:string
(maxLength:6 false)
xs:string
(maxLength:64)
xs:string
(minLength:13,
maxLength:19)
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
0..1 A flat id (e.g. 02.01).
0..1
1..1
71/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
cooperationId
xs:string
(maxLength:100)
0..1
fiberLineState xs:int (totalDigits:3)
0..1
otoState
xs:int (totalDigits:3)
0..1
firstInHouse
xs:boolean
0..1
availabilityDate xs:date
plug
plugType
0..1
0..n
A cooperation id (e.g.
FreeFormText).
State of fiber line. Populated here,
if no plug exists, else under plug
The state of the OTO (optical
termination outlet). Populated
here, if no plug exists, else under
plug
Is this the first socket in the
house?
an availability date
A list of plugs
plugType
Element
plugNr
Type
xs:int (totalDigits:3)
Occ Comment
1..1 A plug number (1..4).
The state for the whole fiber
fiberLineState
xs:int (totalDigits:3) 0..1
line
The state of the OTO (optical
otoState
xs:int (totalDigits:3) 0..1
termination outlet)
availabilityDate
xs:date
0..1
remark
xs:string
0..1 a remark
true if a serice is active on this
isActive
xs:boolean
0..1
line
maxAccessSpeed speedProfileType
0..1 access profiles
qualifProfile
fiberQualifProfileType 0..n qualification profiles
Ueberfuehrungsrelevant
jumperAction
xs:boolean
0..1
(true/false).
fulfillmentTimeSlot fulfillmentTimeSlot
0..n A list of fulfillment time slots
fiberQualifProfileType
Element
Type
xs:long
qualifIndex
(totalDigits:10)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
The index identifying a profile
0..1
within a qualification response.
72/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
usedAccessSpeed speedProfileType
serviceSpeed
speedProfileType
duplexSpeedType
effectiveSpeed
0..1 A speed profile type.
1..1 A speed profile type.
0..1 The effective speed.
speedProfileType
Element
Type
speedProfileNr xs:int (totalDigits:3)
Occ Comment
[LOV-ID: 1010] A speed profile
1..1
number.
xs:string (minLength:1,
0..1
maxLength:60)
duplexSpeedType
0..1 A upstream/downstream speed pair. Upload
speed in kbit/sec. Download speed in
kbit/sec.
duplexSpeedType
0..1 A upstream/downstream speed pair. Upload
speed in kbit/sec. Download speed in kbit/se
description
max
min
duplexSpeedType
Element
up
down
Type
xs:int (totalDigits:8)
xs:int (totalDigits:8)
Occ Comment
1..1 Upload speed in kbit/sec.
1..1 Download speed in kbit/sec.
2.8
getInstallationTicketDetail
Purpose: Lookup an installation ticket in the WSG DB
2.8.1 REQUEST: getInstallationTicketDetailRequestType
Element Type
Occ Comment
ispId
xs:int (totalDigits:6)
1..1 An ISP ID.
itIdWsg xs:decimal (totalDigits:10) 1..1 Installation ticket id assigned by WSG
2.8.2 RESPONSE: getInstallationTicketDetailAckType
Element
Type
Occ Comment
success
xs:boolean
1..1 The result code for the transaction
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
73/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
("true" if request was successful,
"false" otherwise).
xs:string
reason
(pattern:[\dAZ]{3})
xs:string
reasonComment (minLength:1,
maxLength:256)
ticket
0..1
A 3-letter error code (aka messageId)
where "000" means "ok".
0..1
Some additional textual description
for the reason
An installation ticket and its details.
[LOV-ID: 4003] Onsite support.
"None" is not allowed. Required if
contrEleId is missing. WSG order
number. This order number identifies
0..1 the service creation order to which
the installation ticket belongs.
Required if itIdWsgRef and dnVnNsn
is missing DN, VN or NSN. Required if
refOrderNr and itIdWsgRef is missing
A history entry of the ticket
ticket
ticket:
Element
Type
onsiteSupport
xs:int (totalDigits:3)
ispItRef
xs:string (minLength:1,
maxLength:30)
Element Type
xs:string
name
(minLength:1,
maxLength:60)
endUser
phone
xs:string
(pattern:0[19]\d{8})
Occ Comment
0..
1
An external reference
0.. (an ID assigned by the
1 ISP) identifying the
installation ticket
Occ Comment
0..
A name.
1
A nomalized
phone number
1..
(e.g.
1
"0312223344"
)
Contact information on
1..
the end user (name,
1
phone numbers, etc)
xs:string
commen (minLength:1,
0..
t
maxLength:2048 1
)
holdFlag
xs:boolean
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
0.. If set to true the
1 Installation Ticket is hold
74/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
hwDeliveryState xs:int (totalDigits:3)
hwDeliveryDate xs:date
hwDeliveryLocati xs:string (minLength:1,
on
maxLength:128)
xs:string (minLength:1,
hwType
maxLength:128)
hwExtRefReq
installDate
TimeRange
xs:string (minLength:1,
maxLength:128)
Element
from
Type
xs:dateTime
Occ
1..1
to
xs:dateTime
1..1
installationType
xs:string (minLength:1,
maxLength:30)
additional
InstallationReq
xs:int (totalDigits:3)
appointmentId
xs:long (totalDigits:10)
itIdWsg
xs:decimal (totalDigits:10)
itIdSys
xs:string (maxLength:30)
refOrderNr
xs:string (pattern:[19]\d{25})
ispId
xs:int (totalDigits:6)
ispName
orderType
Swisscom (Schweiz) AG
CH-3050 Bern
xs:string (minLength:1,
maxLength:30)
xs:int (totalDigits:3)
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
until Hardware Delivery
Date.
0.. [LOV-ID: 4007]
1 Hardware Delivery State.
0..
Hardware Delivery Date.
1
0.. Hardware delivery
1 location
0..
CPE Description
1
Additional Information if
ONSITE_SUPPORT is not
0..
set to 1="None": CPE
1
SAP Order-Number of
equipment requested
0..
Installation frame.
1
0.. Additional installation
1 description.
[LOV-ID: 4004] The
0..
requested additional
n
installation support.
Appointment ID
0..
referencing an existing
1
agreement.
1.. Installation ticket id
1 assigned by WSG
IT system generated
0..
number identifying the
1
installation ticket.
0..
1
1..
An ISP ID.
1
1..
The name of the ISP.
1
0.. [LOV-ID: 1001] The
75/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
dnVnNsn
dnVnNsnReq
entryDateTime
xs:string (pattern:0[19]\d{8})
xs:string (pattern:0[19]\d{8})
xs:dateTime
closedDateTime xs:dateTime
contrEleId
xs:int (totalDigits:3)
bbType
xs:int (totalDigits:3)
itIdWsgRef
xs:decimal (totalDigits:10)
dnType
xs:int (totalDigits:3)
speedProfileNr
xs:int (totalDigits:3)
hwExtRefInst
xs:string (minLength:1,
maxLength:128)
Element
additional
InstallationSupp
ort
Occ Comment
[LOV-ID:
4004] The
additional
xs:int
requested
1..1
InstallationReq (totalDigits:3)
additional
installation
support.
aiState
Swisscom (Schweiz) AG
CH-3050 Bern
1
0..
1
0..
1
0..
1
order type.
The requested
DN/VN/NSN.
The entry dateTime.
The date and time when
0..
the ticked has been
1
closed.
0.. [LOV-ID: 0320] A
1 contract element ID.
0.. [LOV-ID: 0276] The BB
1 type.
0.. Reference to installation
1 ticket (2nd intervention)
0.. [LOV-ID: 0109] The DN
1 type.
0.. [LOV-ID: 1010] The
1 speed profile number.
CPE SAP Order-Number
of equipment installed.
Semicolon separate list
with Number,Counter
0.. pairs. E.g.
1 5555.676.6,02;555.600.
6,01 for 2 CPEs of OrderNumber 555.676.6 and 1
CPE of Order-Number
555.600.6
Type
[LOV-ID: --]
The
xs:int
1..1 additional
(totalDigits:3)
installation
support
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
The additional
0..
installation support with
n
it's state.
76/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
state.
fieldForceComm xs:string (minLength:1,
ent
maxLength:256)
0..
1
0..
1
wosId
xs:string (maxLength:17)
itState
xs:int
1..
1
lastModified
DateTime
xs:dateTime
1..
1
lastModified
Username
xs:string (minLength:1,
maxLength:60)
1..
1
responseComme xs:string (minLength:1,
nt
maxLength:256)
0..
1
response
CommentCode
0..
1
progress
Comment
progress
CommentCode
progress
DateTime
billingInformatio
n
Swisscom (Schweiz) AG
CH-3050 Bern
xs:int (totalDigits:3)
xs:string (minLength:1,
maxLength:256)
xs:int (totalDigits:3)
xs:dateTime
Element
Type
billingAction
xs:int
(totalDigits:3)
Occ Comment
[LOV-ID:
1..1 1502] Billing
actions.
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
0..
1
0..
1
0..
1
An information from the
field force.
The work order
synchronisation ID.
[LOV-ID: 4001] The
WSG state of an
installation ticket:
1=ENTERED;
2=REJECTED;
3=CHECKED;
4=PROCESSING;
5=INWORK; 6=CLOSED;
7=CANCELLED).
The last modification
date and time of the
corresponding entity.
The username of the
modifying user.
Text if it is necessary to
give some additional
detail information.
Remark: same attribute
as MESSAGE_TEXT in
previous .vmg record
definitions.
The response comment
code. Code of correction
action taken. (LOV).
An information about
progess
[LOV-ID: --] The code of
the progress information.
The date and time of the
progress
0.. Billing relevant
1 informations.
77/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
historyItem
matCost
Total material
costs in CHF.
xs:decimal
(example:
0..1
(totalDigits:10)
'12.25';
pattern:
'10d.2d')
ppId
xs:int
(totalDigits:3)
Flat rate code
0..1 in CHF. (E.g.
7 = xxx CHF)
ppCount
xs:int
(totalDigits:3)
Number of flat
0..1 rates per TT.
(Generally 1)
stdId
xs:int
(totalDigits:3)
Expense ratio
code. (E.g.
0..1
01=140 CHF,
02=120 CHF)
expense
xs:int
(totalDigits:5)
Work expense
in minutes.
(Conversion
0..1 into hours and
multiply with
STD_ID rate
not done)
Element
Type
itState
xs:int
lastModified
xs:dateTime
DateTime
Occ Comment
[LOV-ID:
4001] The
WSG state of
an installation
ticket:
1=ENTERED;
1.. 2=REJECTED;
1 3=CHECKED;
4=PROCESSIN
G;
5=INWORK;
6=CLOSED;
7=CANCELLED
).
The last
modification
1.. date and time
1 of the
corresponding
entity.
xs:string
lastModified (minLength:1, 1..
Username
maxLength:60 1
)
response
Comment
Swisscom (Schweiz) AG
CH-3050 Bern
0.. A history entry of the
n ticket
The username
of the
modifying
user.
Text if it is
necessary to
give some
xs:string
additional
(minLength:1, 0.. detail
maxLength:25 1 information.
6)
Remark: same
attribute as
MESSAGE_TEX
T in previous
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
78/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
.vmg record
definitions.
The response
comment
response
xs:int
0.. code. Code of
CommentCo
(totalDigits:3) 1 correction
de
action taken.
(LOV).
progress
Comment
xs:string
(minLength:1, 0.. An information
maxLength:25 1 about progess
6)
progress
Comment
Code
[LOV-ID: --]
xs:int
0.. The code of
(totalDigits:3) 1 the progress
information.
progress
DateTime
xs:dateTime
The date and
0..
time of the
1
progress
billing
billingInformati 0.. Billing relevant
Information on
1 informations.
install
DateTime
Range
dateTime
RangeType
0.. Installation
1 frame.
2.9
getTdmMsgDetail
Purpose: Lookup a (APV) voice message in the WSG DB
2.9.1 REQUEST: getTdmMessageDetailRequestType
Element Type
Occ Comment
ispId
xs:int (totalDigits:6)
1..1 An ISP ID.
logId
xs:long
1..1 A log ID of a TDM message
2.9.2 RESPONSE: getTdmMessageDetailAckType
Element
Type
Occ Comment
The result code for the
success
xs:boolean
1..1 transaction ("true" if request was
successful, "false" otherwise).
A 3-letter error code (aka
xs:string
reason
0..1 messageId) where "000" means
(pattern:[\dA-Z]{3})
"ok".
xs:string (minLength:1,
Some additional textual
reasonComment
0..1
maxLength:256)
description for the reason.
tdmMessage
tdmMessage
0..1 TDM message (step).
tdmMessage:
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
79/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Element
Type
tdmMessageType
xs:string (minLength:1,
maxLength:40)
tdmMessageRef
xs:string (minLength:1,
maxLength:40)
xs:string (pattern:0[19]\d{8})
xs:string (pattern:0[19]\d{8})
dnVn1
dnVn2
responseComment
xs:string (minLength:1,
maxLength:256)
transDateTime
xs:dateTime
processFlowNr
xs:string (minLength:1,
maxLength:20)
validActiDateTime
xs:dateTime
actiDateTime
xs:dateTime
validDisconDateTim
xs:dateTime
e
disconDateTime
xs:dateTime
dnTypeOld
xs:int (totalDigits:3)
dnTypeNew
xs:int (totalDigits:3)
bbAccess
xs:int (totalDigits:3)
bbTypeOld
xs:int (totalDigits:3)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
[LOV-ID: 1201] A
1..
voice message type.
1
(e.g. 4:="GV04")
Reference from TERCO
1..
or other TDM
1
application.
1..
1
0..
1
Text if it is necessary
to give some
0..
additional detail
1
information. (free
Text)
0..
1
Reference from OMS
1..
or other Voice
1
application.
0..
1
0..
1
0..
1
0..
1
0.. [LOV-ID: 0109] The
1 dn type.
0.. [LOV-ID: 0109] The
1 dn type.
[LOV-ID: 0205] Info
0..
used in manual
1
exception handling.
0.. [LOV-ID: 0276] The
1 Broadband type.
80/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
bbTypeNew
xs:int (totalDigits:3)
llId
xs:string (minLength:1,
maxLength:13)
sessionTypeOld
xs:int (totalDigits:3)
sessionTypeNew
xs:int (totalDigits:3)
backMessageText
xs:string (minLength:1,
maxLength:80)
Element
boardNr
cableBox
Type
Occ Comment
xs:int
UP Board
1..1
(totalDigits:6)
Nr.
switchingPlaceNr
UP
xs:int
1..1 Switching
(totalDigits:6)
Place Nr.
contactType
[LOV-ID:
0115] The
xs:int
1..1 type of
0..
(totalDigits:3)
contact for
1
UP.
contactNr
The contact
xs:int
1..4 number for
(totalDigits:6)
UP.
coordinateX
xs:int
X coordinate
0..1
(totalDigits:6)
of UP.
coordinateY
xs:int
Y coordinate
0..1
(totalDigits:6)
of UP.
bbOkStatus
xs:int (totalDigits:3)
custBusinessNr
xs:string (maxLength:12)
groupState
xs:int
Swisscom (Schweiz) AG
CH-3050 Bern
0.. [LOV-ID: 0276] The
1 Broadband type.
0..
The local loop ID.
1
[LOV-ID: 1005]
0..
Broadband Session
1
Type.
[LOV-ID: 1005]
0..
Broadband Session
1
Type.
Free text if it is
necessary to give
0..
some additional detail
1
information (e.g. port
shortage).
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
The cable box (aka.
"Ueberfuehrungspunkt
", "UP").
0..
1
1..
1
[LOV-ID: 1004] BB OK
status.
The customer business
number.
[LOV-ID: 1202] The
state of the tdm
1.. message group:
1 1=OPEN;
2=DELAYED;
3=DONE)
81/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
[LOV-ID: 1203] TDM
0..
message previous
1
state.
[LOV-ID: 1204] TDM
message group type
Remark: this type can
1..
change until the "tdm
1
message group" has
reached the state
DONE.
previousGroupStat
xs:int
e
groupType
xs:int (totalDigits:3)
ElementType
sla
Occ Comment
[LOV-ID: 0282]
xs:int
sfSlaId
0..1 The service
(totalDigits:3)
fulfillment SLA ID.
saSlaId
[LOV-ID: 0283]
xs:int
0..1 The service level
(totalDigits:3)
assurance id
bbQualityOld
xs:int (totalDigits:3)
bbQualityNew
xs:int (totalDigits:3)
speedProfileOld
speedProfileNew
contrEleId
0..
1
0..
1
Element
Type
speedProfileNr
xs:int
(totalDigits:3)
description
xs:string
(minLength:1, 0..1
maxLength:60)
Element
Type
speedProfileNr
xs:int
(totalDigits:3)
description
xs:string
(minLength:1, 0..1
maxLength:60)
xs:int (totalDigits:3)
0..
1
Occ Comment
[LOV-ID:
1010] A
1..1 speed
profile
number.
Occ Comment
[LOV-ID:
1010] A
1..1 speed
profile
number.
[LOV-ID: 1009] The
bbQuality.
[LOV-ID: 1009] The
bbQuality.
0.. Old service speed
1 profile
0.. New service speed
1 profile
0.. [LOV-ID: 0320] A
1 contract element ID.
2.10 getOrderGroupNr
Purpose: Fetch a new ORDER_GROUP_NR from the WSG DB.
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
82/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
2.10.1 REQUEST: getOrderGroupNrRequestType
Element
Type
ispId
xs:int (totalDigits:6)
Occ
1..1
Comment
An ISP ID.
2.10.2 RESPONSE: customerOrderAckType customerOrderAckType
Element
Type
Occ Comment
The result code
for the
transaction
success
xs:boolean
1..1 ("true" if request
was successful,
"false"
otherwise).
A 3-letter error
code (aka
reason
xs:string (pattern:[\dA-Z]{3})
0..1 messageId)
where "000"
means "ok".
Some additional
xs:string (minLength:1,
textual
reasonComment
0..1
maxLength:256)
description for
the reason.
The customer
customerOrderNr xs:string (pattern:[1-9]\d{25})
0..1
order ID.
The order group
orderGroupNr
xs:long (totalDigits:12)
0..1
ID.
A Net Service
nsn
xs:string (pattern:010\d{7})
0..1
Number
Element
Type
success
xs:boolean
reason
xs:string
(pattern:[\dAZ]{3})
orderItem
reasonComment xs:string
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
The result code
for the
transaction
1..1 ("true" if request
was successful,
"false"
otherwise).
A 3-letter error
code (aka
0..1 messageId)
where "000"
means "ok".
The acknowledge
message returned
0..n
after processing
an order request.
0..1 Some additional
83/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
(minLength:1,
maxLength:256)
orderNr
xs:string
(pattern:[19]\d{25})
textual
description for
the reason.
0..1 The order ID.
2.11 cancelPendingOrder
Purpose: Cancel a pending customer order or order.
2.11.1 REQUEST: cancelPendingRequestType
Element Type
ispId
xs:int (totalDigits:6)
orderNr
xs:string (pattern:[1-9]\d{25})
comment xs:string (minLength:1, maxLength:256)
Occ
1..1
1..1
0..1
Comment
An ISP ID.
The order ID.
A comment.
2.11.2 RESPONSE: cancelPendingAckType
Element
Type
Occ Comment
The result code for the
success
xs:boolean
1..1 transaction ("true" if request was
successful, "false" otherwise).
A 3-letter error code (aka
xs:string
reason
0..1 messageId) where "000" means
(pattern:[\dA-Z]{3})
"ok".
xs:string (minLength:1,
Some additional textual
reasonComment
0..1
maxLength:256)
description for the reason.
2.12 createInstallationTicket
Purpose: Create an Installation Ticket
2.12.1 REQUEST: createInstallationTicketRequestType
Element
Type
Occ Comment
ispId
xs:int (totalDigits:6)
1..1 An ISP ID.
refOrderNr
xs:string (pattern:[1-9]\d{25}) 0..1
contrEleId
xs:int (totalDigits:3)
0..1
itIdWsgRef
xs:decimal (totalDigits:10)
0..1
bbType
xs:int (totalDigits:3)
1..1 [LOV-ID: 0276] The
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
84/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
BB type.
dnVnNsn
xs:string (pattern:0[1-9]\d{8}) 0..1
custBusinessNr
xs:string (maxLength:12)
0..1
onsiteSupport
xs:int (totalDigits:3)
0..1
xs:string (minLength:1,
maxLength:30)
An external
reference (an ID
0..1 assigned by the ISP)
identifying the
installation ticket
ispItRef
Element Type
xs:string
name
(minLength:1,
maxLength:60)
endUser
phone
xs:string
(pattern:0[19]\d{8})
Occ Comment
0..1 A name.
A nomalized
phone number
1..1
(e.g.
"0312223344")
xs:string
comment (minLength:1,
0..1
maxLength:2048)
holdFlag
xs:boolean
hwDeliveryState
xs:int (totalDigits:3)
hwDeliveryDate
xs:date
hwDeliveryLocation
hwType
hwExtRefReq
Swisscom (Schweiz) AG
CH-3050 Bern
xs:string (minLength:1,
maxLength:128)
xs:string (minLength:1,
maxLength:128)
xs:string (minLength:1,
maxLength:128)
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
The customer
business number.
Contact information
on the end user
1..1
(name, phone
numbers, etc)
If set to true the
Installation Ticket is
0..1
hold until Hardware
Delivery Date.
[LOV-ID: 4007]
0..1 Hardware Delivery
State.
Hardware Delivery
0..1
Date.
Hardware delivery
0..1
location
0..1 CPE Description
Additional
Information if
ONSITE_SUPPORT is
0..1 not set to 1="None":
CPE SAP OrderNumber of
equipment
85/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
requested
installDate
TimeRange
Element
from
Type
xs:dateTime
Occ
1..1
to
xs:dateTime
1..1
Comment
installationType
xs:string (minLength:1,
maxLength:30)
additional
InstallationReq
xs:int (totalDigits:3)
appointmentId
xs:long (totalDigits:10)
wosId
xs:string (maxLength:17)
0..1 Installation frame.
Additional
0..1 installation
description.
[LOV-ID: 4004] The
0..n requested additional
installation support.
Appointment ID
0..1 referencing an
existing agreement.
The work order
0..1
synchronisation ID.
2.12.2 RESPONSE: createInstallationTicketAckType
Element
Type
Occ Comment
The result code for the
success
xs:boolean
1..1 transaction ("true" if request was
successful, "false" otherwise).
A 3-letter error code (aka
xs:string
reason
0..1 messageId) where "000" means
(pattern:[\dA-Z]{3})
"ok".
xs:string (minLength:1,
Some additional textual
reasonComment
0..1
maxLength:256)
description for the reason.
xs:decimal
Installation ticket id assigned by
itIdWsg
0..1
(totalDigits:10)
WSG
2.13 modifyPendingInstallationTicket
Purpose: Modify a pending Installation Ticket
2.13.1 REQUEST: modifyPendingInstallationTicketRequestType
Element
Type
Occ Comment
ispId
xs:int (totalDigits:6)
1..1 An ISP ID.
itIdWsg
xs:decimal (totalDigits:10)
1..1 Installation ticket id
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
86/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
assigned by WSG
Reference to
itIdWsgRef
xs:decimal (totalDigits:10)
0..1 installation ticket (2nd
intervention)
refOrderNr
xs:string (pattern:[1-9]\d{25}) 0..1
contrEleId
xs:int (totalDigits:3)
0..1
bbType
xs:int (totalDigits:3)
0..1
dnVnNsn
xs:string (pattern:0[1-9]\d{8}) 0..1
The customer business
custBusinessNr xs:string (maxLength:12)
0..1
number.
onsiteSupport xs:int (totalDigits:3)
0..1
An external reference
xs:string (minLength:1,
(an ID assigned by the
ispItRef
0..1
maxLength:30)
ISP) identifying the
installation ticket
Element Type
xs:string
name
(minLength:1,
maxLength:60)
endUser
phone
xs:string
(pattern:0[19]\d{8})
Occ Comment
0..1 A name.
A nomalized
phone number
1..1
(e.g.
"0312223344")
Contact information on
1..1 the end user (name,
phone numbers, etc)
xs:string
comment (minLength:1,
0..1
maxLength:2048)
holdFlag
xs:boolean
hwDeliveryState xs:int (totalDigits:3)
hwDeliveryDate xs:date
hwDelivery
Location
hwType
hwExtRefReq
Swisscom (Schweiz) AG
CH-3050 Bern
xs:string (minLength:1,
maxLength:128)
xs:string (minLength:1,
maxLength:128)
xs:string (minLength:1,
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
If set to true the
Installation Ticket is
0..1
hold until Hardware
Delivery Date.
[LOV-ID: 4007]
0..1 Hardware Delivery
State.
Hardware Delivery
0..1
Date.
Hardware delivery
0..1
location
0..1 CPE Description
0..1 Additional Information
87/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
maxLength:128)
installDate
TimeRange
installationType
if ONSITE_SUPPORT is
not set to 1="None":
CPE SAP OrderNumber of equipment
requested
Element
from
Type
xs:dateTime
Occ
1..1
to
xs:dateTime
1..1
Comment
xs:string (minLength:1,
maxLength:30)
additional
xs:int (totalDigits:3)
InstallationReq
appointmentId
xs:long (totalDigits:10)
wosId
xs:string (maxLength:17)
0..1 Installation frame.
Additional installation
description.
[LOV-ID: 4004] The
0..n requested additional
installation support.
Appointment ID
0..1 referencing an existing
agreement.
The work order
0..1
synchronisation ID.
0..1
2.13.2 RESPONSE: modifyPendingInstallationTicketAckType
Element
Type
Occ Comment
The result code for the
success
xs:boolean
1..1 transaction ("true" if request was
successful, "false" otherwise).
A 3-letter error code (aka
xs:string
reason
0..1 messageId) where "000" means
(pattern:[\dA-Z]{3})
"ok".
xs:string (minLength:1,
Some additional textual
reasonComment
0..1
maxLength:256)
description for the reason.
2.14 cancelPendingInstallationTicket
Purpose: Cancel a pending Installation Ticket
2.14.1 REQUEST: cancelPendingInstallationTicketRequestType
Element Type
Occ Comment
ispId
xs:int (totalDigits:6)
1..1 An ISP ID.
Installation ticket id assigned
itIdWsg xs:decimal (totalDigits:10)
1..1
by WSG
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
88/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
comment
xs:string (minLength:1,
maxLength:256)
0..1 A comment.
2.14.2 RESPONSE: cancelPendingInstallationTicketAckType
Element
Type
Occ Comment
The result code for the
success
xs:boolean
1..1 transaction ("true" if request was
successful, "false" otherwise).
A 3-letter error code (aka
xs:string
reason
0..1 messageId) where "000" means
(pattern:[\dA-Z]{3})
"ok".
xs:string (minLength:1,
Some additional textual
reasonComment
0..1
maxLength:256)
description for the reason.
2.15 getBusinessLines
Purpose: Get a report for all business lines related to a DDI number
2.15.1 REQUEST: getBusinessLinesRequestType
ElementType
Occ Comment
ispId
xs:int (totalDigits:6)
1..1 An ISP ID.
xs:string (pattern:0[1The base number ("Stammnummer")
stnrDdi
1..1
9]\d{8})
for DDI.
2.15.2 RESPONSE: getBusinessLinesAckType
Element
Type
success
xs:boolean
reason
xs:string (pattern:[\dA-Z]{3})
reasonComme xs:string (minLength:1,
nt
maxLength:256)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
The result code for
the transaction
1..
("true" if request was
1
successful, "false"
otherwise).
A 3-letter error code
0.. (aka messageId)
1 where "000" means
"ok".
Some additional
0..
textual description
1
for the reason.
89/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
stnr
vnRecord
0.. STNR which belongs
1 to the PABX.
xs:string
Element
Type
vn
xs:string
cableBox
cableBox
bbAssigne
xs:boolean
d
bbInfo
Occ Comment
1..
VN.
1
The cable box (aka.
0..
"Ueberfuehrungspunkt
1
", "UP").
BB already assigned:
0..
true="Yes",
1
false="No".
A business line
0.. identity (VN) (=
n Verrechnungsnumme
r) record.
xs:string
0..
(maxLength:25
Additional information.
1
6)
2.16
createChangeTicket
Description: create a Change Ticket
2.16.1 Request createChangeTicketRequestType
Element
Type
xs:string (minLength:1,
extRef
maxLength:80)
Occ Comment
0.. An external reference
1 provided by the ISP.
1.. designated date for the
exchangeDate xs:date
1 exchange
[LOV-ID: 3019] What
1.. must be exchanged (1
exchangeType xs:int (totalDigits:3)
1 = CPE Hardware: 2 =
CPE Firmware)
[LOV-ID: 9012]
LOV_REMINDER_PROCE
SS (1 = first reminder
at exchange date,
reminderProces
1..
xs:int (totalDigits:3)
second reminder after 5
s
1
days ; 2 = first
reminder at exchange
date, no second
reminder)
customerContac
1..
customerContactType
t1
1
customerContac
0..
customerContactType
t2
1
ElementType
Occ Comment 1..
- choice:
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
90/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
1
xs:string
A DN/NSN
dnNsn (pattern:0[1- 1..1 phone
9]\d{8})
number.
dslam dslam
1..1
customerContactType
Element
Type
greetingCode
firstName
lastName
Street
houseNr
Building
streetAppendix
Zip
City
eMail
Swisscom (Schweiz) AG
CH-3050 Bern
xs:int (totalDigits:3)
Occ Comment
[LOV-ID: 9011]
LOV_GREETING_CODE
0..1
Anrede (Mr.,Ms., Firm,
Unknown ...)
xs:string
(minLength:1,
0..1
maxLength:30)
xs:string
(minLength:1,
1..1
maxLength:30)
xs:string
(minLength:1,
0..1
maxLength:30)
xs:string
(minLength:1,
0..1
maxLength:12)
xs:string
(minLength:1,
0..1
maxLength:30)
xs:string
(minLength:1,
0..1
maxLength:30)
xs:int
(minInclusive:1000,
0..1
maxInclusive:999999)
xs:string
(minLength:1,
0..1
maxLength:25)
xs:string
(minLength:5,
0..1
maxLength:100)
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
A subject's first name.
A subject's last name.
The street name of an
address.
The house number of an
address.
The building infomation of
an address.
An additional street
information (for instance:
Chalet Sonneblick) )
The zip of an address.
The city of an address.
An email address
91/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
xs:string (pattern:
0..1 Mobile phone number
(\+)?([0-9]){7,15})
ISO 639-1 (Codes for the
representation of names of
Language
xs:string
1..1
languages) (de = german;
fr = french; it = italian)
[LOV-ID: 3020] The way
communicationChannel xs:int (totalDigits:3)
1..1 the customer should be
notified
mobilePhone
dslam
Element
Type
xs:string
dslamName
(maxLength:20)
xs:string
dslamPort
(maxLength:20)
Occ Comment
name of the DSLAM (e.g.: ipc1..1
aar730-s-vd-05)
1..1 DSLAM Port notation (e.g.: 1/1/2/12)
2.16.2 Response createChangeTicketResponseType
Element
Type
correlationId
xs:string
success
xs:boolean
xs:string
reason
(pattern:[\dAZ]{3})
xs:string
reasonComment (minLength:1,
maxLength:256)
xs:decimal
changeTicketId
(totalDigits:10)
2.17
Occ
Comment
A unique ID to correlate request and
optional answer(s) within a (ansynch.) batch
process.
The result code for the
transaction ("true" if request
1..1
was successful, "false"
otherwise).
A 3-letter error code (aka
0..1
messageId) where "000" means
"ok".
0..1
Some additional textual
description for the reason.
0..1
modifyPendingChangeTicket
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
92/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Description: Modifies a still pending Change Ticket
2.17.1 Request modifyPendingChangeTicketRequestType
Element
Type
Occ Comment
xs:decimal
Change Ticket ID assigned by
changeTicketId
1..1
(totalDigits:10)
WSG
xs:string
An external reference provided by
extRef
(minLength:1,
0..1
the ISP.
maxLength:80)
exchangeDate
xs:date
1..1 designated date for the exchange
[LOV-ID: 3020] What must be
exchangeType
xs:int (totalDigits:3) 1..1 exchanged (1 = CPE Hardware: 2
= CPE Firmware)
[LOV-ID: 9012]
LOV_REMINDER_PROCESS (1 =
first reminder at exchange date,
reminderProcess xs:int (totalDigits:3) 1..1
second reminder after 5 days ; 2
= first reminder at exchange
date, no second reminder)
customerContact1 customerContactType 1..1 Customer Contact 1
customerContact2 customerContactType 0..1 Customer Contact 2
xs:string
A reason why the ticket should be
changeReason
(minLength:1,
0..1
changed
maxLength:100)
2.17.2 Response modifyPendingChangeTicketResponseType
Element
Type
Occ Comment
The result code for the
transaction ("true" if
success
xs:boolean
1..1
request was successful,
"false" otherwise).
A 3-letter error code
reason
xs:string (pattern:[\dA-Z]{3}) 0..1 (aka messageId) where
"000" means "ok".
Some additional textual
xs:string (minLength:1,
reasonComment
0..1 description for the
maxLength:256)
reason.
changeTicketId xs:decimal (totalDigits:10)
0..1 Change Ticket ID
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
93/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
assigned by WSG
2.18
cancelPendingChangeTicket
Description: create a Change Ticket
2.18.1 Request createChangeTicketRequestType
Element
Type
Occ Comment
xs:int
ispId
1..1 An ISP ID.
(totalDigits:6)
xs:decimal
changeTicketId
1..1 Change Ticket ID assigned by WSG
(totalDigits:10)
xs:string
A reason why the ticket should be
cancelReason (minLength:1,
1..1
cancelled
maxLength:100)
2.18.2 Response
Element
Type
success
xs:boolean
Occ Comment
The result code for the transaction
1..1 ("true" if request was successful, "false"
otherwise).
xs:string
A 3-letter error code (aka messageId)
(pattern:[\dA- 0..1
where "000" means "ok".
Z]{3})
xs:string
Some additional textual description for
reasonComment (minLength:1,
0..1
the reason.
maxLength:256)
reason
2.19
getChangeTicketOverview
Description: Cancel a still pending Change Ticket
2.19.1 Request getChangeTicketOverviewRequestType
Element
Type
ispId
xs:int (totalDigits:6)
changeTicketId
Swisscom (Schweiz) AG
CH-3050 Bern
xs:decimal (totalDigits:10)
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
1..1 An ISP ID.
Change
Ticket ID
0..1
assigned
by WSG
94/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
An
external
reference
0..1
provided
by the
ISP.
xs:string (minLength:1,
maxLength:80)
extRef
Element Type
from
dnNsnRange
to
Occ Comment
A nomalized
phone number
1..1
(e.g.
"0312223344")
xs:string
(pattern:0[19]\d{8})
A nomalized
phone number
0..1
(e.g.
"0312223344")
xs:string
(pattern:0[19]\d{8})
[LOV-ID:
3021
0..1 Change
Ticket
Status
changeTicketStatus
xs:int (totalDigits:3)
ticketCreationDateTimeRange
Element Type
Occ Comment
from
xs:dateTime 1..1
lastModificationDateTimeRange
Element Type
Occ Comment
from
xs:dateTime 1..1
to
to
xs:dateTime
xs:dateTime
1..1
1..1
0..1
0..1
0..1
2.19.2 Response getChangeTicketOverviewResponseType
Element Type
Occ Comment
succe
xs:boolean
ss
reaso
xs:string (pattern:[\dA-Z]{3})
n
reaso xs:string (minLength:1, maxLength:256)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
The result code
for the
transaction
1..
("true" if request
1
was successful,
"false"
otherwise).
A 3-letter error
code (aka
0..
messageId)
1
where "000"
means "ok".
0.. Some additional
95/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
nCo
mme
nt
1
Element
list
textual
description for the
reason.
Occ Comment
Change
xs:decimal
0.. Ticket ID
changeTicketId
(totalDigits:
1 assigned by
10)
WSG
[LOV-ID:
xs:int
3021
1..
changeTicketStatus (totalDigits:
Change
1
3)
Ticket
Status
[LOV-ID:
3022] A
xs:int
Status
0..
statusReason
(totalDigits:
Reason set
1
3)
by the
backend
system
0..
xs:string
An external
n
(minLength:
0.. reference
extRef
1,
1 provided by
maxLength:
the ISP.
80)
designated
1..
exchangeDate
xs:date
date for the
1
exchange
[LOV-ID:
3019] What
must be
xs:int
1.. exchanged
exchangeType
(totalDigits:
1 (1 = CPE
3)
Hardware:
2 = CPE
Firmware)
xs:int
[LOV-ID:
1..
reminderProcess
(totalDigits:
9012]
1
3)
LOV_REMIN
Swisscom (Schweiz) AG
CH-3050 Bern
Type
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
96/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
DER_PROC
ESS (1 =
first
reminder at
exchange
date,
second
reminder
after 5 days
; 2 = first
reminder at
exchange
date, no
second
reminder)
1..
1
lastModificationDate
1..
xs:dateTime
Time
1
creationDateTime
xs:dateTime
2.20
getChangeTicketDetail
Description: gets a list of change Tickets
2.20.1 Request getChangeTicketDetailRequestType
Element
Type
Occ
Comment
ispId
xs:int (totalDigits:6) 1..1 An ISP ID.
xs:decimal
changeTicketId
1..1 Change Ticket ID assigned by WSG
(totalDigits:10)
2.20.2 Response getChangeTicketDetailResponseType
Element
Type
Occ Comment
changeTicket changeTicketType 0..1
workLog
workLogType
0..n List of the work log entries
historyItem changeTicketType 0..n
changeTicketType
Element
Swisscom (Schweiz) AG
CH-3050 Bern
Type
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
97/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
ispId
xs:int (totalDigits:6)
changeTicket
xs:decimal (totalDigits:10)
Id
changeTicket
xs:int (totalDigits:3)
Status
statusReason xs:int (totalDigits:3)
extRef
xs:string (minLength:1, maxLength:80)
- choice:
Element Type
Occ Comment
xs:string
(pattern:0 1.. A DN/NSN phone
dnNsn
[11 number.
9]\d{8})
1..
dslam dslam
1
exchangeDat
xs:date
e
exchangeTyp
xs:int (totalDigits:3)
e
reminderProc
xs:int (totalDigits:3)
ess
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
1..1 An ISP ID.
Change Ticket
1..1 ID assigned
by WSG
[LOV-ID: 3021
1..1 Change Ticket
Status
[LOV-ID:
3022] A
Status Reason
0..1
set by the
backend
system
An external
reference
0..1
provided by
the ISP.
1..1
designated
1..1 date for the
exchange
[LOV-ID:
3019] What
must be
1..1 exchanged (1
= CPE
Hardware: 2 =
CPE Firmware)
[LOV-ID:
9012]
1..1
LOV_REMINDE
R_PROCESS
98/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
(1 = first
reminder at
exchange
date, second
reminder after
5 days ; 2 =
first reminder
at exchange
date, no
second
reminder)
customerCon
tact1
customerCon
tact2
creationDate
Time
lastModificati
onDateTime
customerContactType
1..1
customerContactType
0..1
xs:dateTime
1..1
Customer
Contact 2
1..1
xs:dateTime
customerContactType
Element
Type
greetingCode
xs:int (totalDigits:3)
firstName
lastName
street
houseNr
Swisscom (Schweiz) AG
CH-3050 Bern
xs:string
(minLength:1,
maxLength:30)
xs:string
(minLength:1,
maxLength:30)
xs:string
(minLength:1,
maxLength:30)
xs:string
(minLength:1,
maxLength:12)
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
[LOV-ID: 9011]
LOV_GREETING_CODE
0..1
Anrede (Mr.,Ms., Firm,
Unknown ...)
0..1 A subject's first name.
1..1 A subject's last name.
0..1
The street name of an
address.
0..1
The house number of an
address.
99/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
xs:string
The building infomation of
building
(minLength:1,
0..1
an address.
maxLength:30)
xs:string
An additional street
streetAppendix
(minLength:1,
0..1 information (for instance:
maxLength:30)
Chalet Sonneblick) )
xs:int
zip
(minInclusive:1000,
0..1 The zip of an address.
maxInclusive:999999)
xs:string
city
(minLength:1,
0..1 The city of an address.
maxLength:25)
xs:string
eMail
(minLength:5,
0..1 An email address
maxLength:100)
xs:string (pattern:
mobilePhone
0..1 Mobile phone number
(\+)?([0-9]){7,15})
ISO 639-1 (Codes for the
representation of names of
language
xs:string
1..1
languages) (de = german;
fr = french; it = italian)
[LOV-ID: 3020] The way
communicationChannel xs:int (totalDigits:3)
1..1 the customer should be
notified
workLogType
Element
Type
workLogDateTime xs:dateTime
xs:string
workLogSummary (minLength:1,
maxLength:100)
xs:string
workLogNotes
(maxLength:32768)
Occ Comment
1..1
1..1 A summary of the work log entry.
0..1
An additional comprehensive
description.
2.21
getCpeReport
Description: gets all detail of one change ticket
2.21.1 Request getCpeReportRequestType
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
100/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Element
ispId
Type
Occ Comment
xs:int (totalDigits:6)
1..1 An ISP ID.
Element Type
Occ Comment
xs:decimal
Information
irIdWsg
1..1
(totalDigits:10)
request id.
1..1
- choice:
The file name
xs:string
of a
fileName (minLength:1, 1..1
response/report
maxLength:80)
file.
2.21.2 Response getCpeReportResponseType
Element
Type
Occ Comment
The result code for the transaction
success
xs:boolean
1..1 ("true" if request was successful,
"false" otherwise).
xs:string
A 3-letter error code (aka messageId)
reason
(pattern:[\dA- 0..1
where "000" means "ok".
Z]{3})
xs:string
Some additional textual description
reasonComment (minLength:1,
0..1
for the reason.
maxLength:256)
cpeReportElement cpeReportType 0..n
cpeReportType
Element
Type
xs:string
(pattern:0[19]\d{8})
dslam
cpeInfoType
dnNsn
dslam
cpeActual
cpeVectoringCategory
Swisscom (Schweiz) AG
CH-3050 Bern
Occ Comment
0..1
A DN/NSN phone
number.
0..1
1..1
[LOV-ID: 9009]
Vectoring Capability (
1 = Capable (Ok); 2
= Friendly; 3 = Alien
xs:int (totalDigits:3) 1..1
(Not Capable); 4 =
unknown (alien); 5 Capable, but
firmware upgrade
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
101/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
necessary (Not
Capable) ; Friendly,6
- but firmware
upgrade necessary
(Not Capable) )
cpeVectoringCapable
xs:boolean
cpeFirmwareVectoringCapable xs:boolean
detectionDate
xs:date
1..1
1..1
1..1
[LOV-ID: 3019] What
must be exchanged
exchangeType
xs:int (totalDigits:3) 1..1
(1 = CPE Hardware: 2
= CPE Firmware)
cpeInfoType
cpeProposed
0..1
The priority of the
change.0 ==
changePriority
xs:int
1..1
minimum,
100=maximum
vectoringActivationDatePlanned xs:date
0..1
0..1
comment
xs:string
cpeInfoType
Element
Type
xs:string
cpeName
(maxLength:100)
xs:string
cpeFirmwareVersion
(maxLength:32)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
Occ Comment
1..1 CPE (Customer Modem) Name
0..1 CPE firmware version
102/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
3
List of Values (LOVs)
See document [6] for a list of LOVs. The Id’s are referenced in Annex of the WSDL
definition.
Sample:
“[LOV-ID: 4004] The requested additional installation support.”
4
TDM Message types
4.1
Principles
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
103/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
3200.01:
3200.02:
Copying
“Y”:
Is the Completion of the deactivation part of a Voice
transaction.
Is the Completion of the activation part of a Voice
transaction.
enabled Used in the following Message-Types: For Message Type 03
(Umzug), 04 Umzug CH-weit), 17 (Accesstype-change) and
16 (Change of number. Note: is always Yes for this
message type): On request of an ISP WSG copies a BBService from the “old” location to the new location if
possible. The ISP will be notifiec by Voice-Messages.
Copying
“N”:
enabled Used in the following Message-Types: For Message Type 03
(Umzug), 04 Umzug CH-weit), 17 (Accesstype-change): On
request of an ISP WSG does not copy a BB-Service from the
“old” location to the new location if possible. Only the
disconnection is done. The ISP will be notified by VoiceMessages about the disconnection. The ISP may create the
new BB-Service on his own at the “new” location or
constellation.
Is activation “Y”:
Indicates that the order is an activation.
Is activation “N”:
Indicates that the order is a deactivation.
PONR:
Point Of No Return. From this point onwards a cancellation
/ annulment of the order is no longer possible.
A TDM Message (Time-Division-Multiplexing Telephone technique, formarly calle
“Voice Message”) is uniquely identified by a type and a reference from the producer
system. The following list shows the available types and reference codes.
Reference
APVWSG
4.2
Description
GV01 / Neuanschluss
Type
Process-Flow Nr. Description
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
104/135
3010.11
GV 01 / Neuanschluss
3091.09
3071.09
3061.09
3091.10
3071.10
3061.10
3190.11
5240.05
3200.02
D
i
GV14 / Kündigung
s
Summary
c
o
n
e
c
t
i
o
n
GV14 / Kündigung
Steps
3130.06
3141.07/3151.07
3141.08/3151.08
3190.11
5240.05
3200.01
/
ü
n
d
i
g
u
n
g
4.3
Swisscom (Schweiz) AG
CH-3050 Bern
3130.06
copying enabled
-
is activation
Y
Y
Y
Y
Y
Y
Neuanschluss: Einschaltbegehren
Voice Message Text:
New Voice Line was assigned for DN: <DN1>
Neuanschluss: 3091.09 Schaltmeldung WSG/Einschaltung terminiert
3071.09 Schaltmeldung WSG/Schalt. durch Servispartner
3061.09 Schaltmeldung WSG/Schaltung durch Kunde
PONR (Point of no Return)
Voice Message Text:
PONR for DN: <DN1>. For this Voice-Line with
synchronised DSL order the activation process has
started. Cancellation not possible anymore.
Neuanschluss:
3091.10 Schaltbestätigung/Einschaltung terminiert
3071.10 Schaltbestätigung/Schalt. durch Servispartner
3061.10 Schaltbestätigung/Schaltung durch Kunde
Voice Message Text:
Physical activation for DN: <DN1> confirmed. Physical
activation of DSL is successful done. Waiting for
configuration of DSL.
Neuanschluss: Annullation der Einschaltung
Voice Message Text:
Cancellation of Voice-Order for DN: <DN1>. A
pending synchronised BB-Order has to wait until a new
Voice-Order is submitted
Neuanschluss: Terminverschiebung der Einschaltung
Voice Message Text:
Change of Activation date to <VALID_ACTI_DATE>
Neuanschluss: Abschluss der Einschaltung
Voice Message Text:
Closure of Voice-transaction. DSL will be configured
copying enabled
-
is activation
N
N
N
N
N
N
V
o
i
c
e
Steps
3010.11
3091/3071/3061.09
3091/3071/3061.09
3190.11
5240.05
3200.02
Kündigung: Ausschaltbegehren
o
f
GV01 /
Neuanschluss
Summary
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
105/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Voice Message Text:
Disconnect Voice: Request for voice disconnection DN:
<DN1>. An existing DSL will automatically be
disconnected.
Kündigung:
3141.07
Ausschaltmeldung WSG/Ausschaltung durch Kunde/Servicepartner
3151.07
Ausschaltmeldung WSG/Ausschaltung terminiert
PONR (Point of no Return)
3141.07
3151.07
Der Auschaltungsprozess für die Voice-Kündigung
wurde gestartet.
Voice Message Text:
Disconnection PONR for DN: <DN1>. For this VoiceLine with DSL the deactivation process has started.
Cancellation not possible anymore.
Kündigung:
3141.08
3151.08
3141.08
3151.08
3190.11
5240.05
3200.01
Swisscom (Schweiz) AG
CH-3050 Bern
Ausschaltbestätigung / Ausschaltung durch Kunde/Servicepartner
Ausschaltbestätigung / Ausschaltung terminiert
Bestätigung der physikalischen Ausschaltung des Ports.
Voice Message Text:
Physical deactivation for DN <DN1> confirmed.
Physical deactivation of DSL is successful done. Waiting
for deactivation of DSL.
Kündigung: Annullation der Ausschaltung
Voice Message Text:
Request of Disconnection: Cancellation of Voice-Order
for DN: <DN1>. A pending synchronised BB-Order has
to wait until a new Voice-Order is submitted
Kündigung: Terminverschiebung der Ausschaltung
Voice Message Text:
Request for Disconnection: Change of Activation date to
<VALID_ACTI_DATE>
Kündigung: Abschluss der Ausschaltung
Voice Message Text:
Request for disconnection: Closure of Voice-transaction.
DSL will be disconnected.
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
106/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
GV16 / Nummerwechsel
GV16 / Nummerwechsel
Summary
4.4
Steps
3010.11
3091/3071/3061.09
3091/3171/3061.10
3190.11
3200.02
3130.06
3151.07
3151.08
3190.11
3200.01
16: Nummernwechsel
3010.11
copying enabled
Y
Y
Y
Y
Y
N
N
N
N
N
is activation
Y
Y
Y
Y
Y
N
N
N
N
N
Nummernwechsel: Einschaltbegehren
Voice Message Text:
Change of telephone number: from <DN1> to <DN2>
at <VALID_ACTI_DATE>: Voice Line for new DN
<DN2> was assigned with planned activation date
<VALID_ACTI_DATE>. DN old <DN1>. Please check
also the automatically created Broadband Create order
for copying the BB-Service to the new location.
Nummernwechsel:
3091.09 Schaltmeldung WSG/Einschaltung terminiert
3071.09 Schaltmeldung WSG/Schaltung durch Servispartner
3061.09 Schaltmeldung WSG/Schaltung durch Kunde
PONR (Point of no Return)
3091.09
3071.09
3061.09
Voice Message Text:
Change of telephone number: from <DN1> to <DN2>
at <VALID_ACTI_DATE>: PONR for DN new <DN2>.
For this Voice-Line the activation process was started.
Cancellation not possible anymore. Please check also
the automatically created Broadband Create order for
copying the BB-Service to the new location.
Nummernwechsel:
3091.10 Schaltbestätigung/Einschaltung terminiert
3071.10 Schaltbestätigung/Schaltung durch Servispartner
3061.10 Schaltbestätigung/Schaltung durch Kunde
3091.10
3071.10
3061.10
3190.11
Swisscom (Schweiz) AG
CH-3050 Bern
Voice Message Text:
Change of telephone number: from <DN1> to <DN2>
at <VALID_ACTI_DATE>: Physical activation for DN
new <DN2> confirmed. Physical activation of DSL is
successful done. Waiting for automatic configuration of
DSL
Nummernwechsel: Annullation der Einschaltung
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
107/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
3200.02
3130.06
Voice Message Text:
Change of telephone number: from <DN1> to <DN2>:
Cancellation of Voice-Order for DN new <DN2>. The
automatically created pending synchronised BB-Order
will also be cancelled and will only be set up again after
a new Voice-Activation Order is submitted
Nummernwechsel: Abschluss der Einschaltung
Voice Message Text:
Closure of Voice-Activation transaction. DSL will be
configured. Please check also the automatically created
Broadband Create order for copying the BB-Service to
the new location.
Nummernwechsel: Ausschaltbegehren
Voice Message Text:
Change of telephone number: from <DN1> to <DN2>:
Request for disconnection of Voice service. Please check
also the automatically created Broadband Disconnect
order
Nummernwechsel:
3151.07
Ausschaltmeldung WSG / Ausschaltung terminiert
PONR (Point of no Return)
3151.07
Voice Message Text:
Change of telephone number: from <DN1> to <DN2>:
Disconnection PONR for DN old <DN1>. For this
Voice-Line with DSL the deactivation process has
started. Cancellation not possible anymore.
Nummernwechsel:
3151.08
3151.08
3190.11
Swisscom (Schweiz) AG
CH-3050 Bern
Ausschaltbestätigung / Ausschaltung terminiert
Voice Message Text:
Change of telephone number: fom <DN1> to <DN2>:
Physical deactivation for DN old <DN1> confirmed.
Physical deactivation of DSL is successful done. Waiting
for deactivation of DSL.
Nummernwechsel: Annullation der Ausschaltung
Voice Message Text:
Change of telephone number: from <DN1> to <DN2>:
Cancellation of Voice-Disconnect Order for DN old
<DN1>. The automatically created synchronised BBDisconnect Order will be cancelled and only be set up
after a new Voice-Disconnect Order is submitted
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
108/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
3200.01
Swisscom (Schweiz) AG
CH-3050 Bern
Nummernwechsel: Abschluss der Ausschaltung
Voice Message Text:
Closure of Voice-Disconnect transaction for DN old
<DN1>. DSL will be disconnected
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
109/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
GV25 / Sistierung Aktivierung
GV25 /
Sistierung
Aktivierun
g
Summary
4.5
Steps
3171.05
3171.06
3200.01
25.1: Sistierung aktiv
3171.05
3171.06
3200.01
Swisscom (Schweiz) AG
CH-3050 Bern
copying enabled
-
is activation
N
N
N
Sistierungs aktiv: Meldung des Prozess-starts für die
Sistierung.
Voice Message Text:
Temporary disconnection of voice and Broadband: Due
to temporary disconnection of the voice connection, the
subscriber with the telephone number <DN1> will be
disconnected at <VALID_DISCON_DATE>. Swisscom
will inform the customer for the temporary Voicedisconnect by letter. Please inform the Customer about
the Broadband disconnection and check the Broadband
Disconnect Order for DN <DN1>.
Sistierungs aktiv: Meldung des Beginns der Sistierung
der Voice-Line
Voice Message Text:
Temporary disconnection of voice and Broadband:
Confirmation of Disconnection date
<VALID_DISCON_DATE>. Swisscom will inform the
customer for the temporary Voice-disconnect by letter.
Please inform the Customer about the Broadband
disconnection and check the Broadband Disconnect
Order for DN <DN1>.
Sistierung aktiv: Prozessabschluss des Beginns der
Sistierung
Voice Message Text:
Temporary Disconnection: confirmation of
disconnection.
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
110/135
GV25 /
Sistierung
deaktiv
Summary
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Steps
3171.05
3171.06
3190.11
3200.02
25.2: Sistierung deaktiv
3171.05
3171.06
3190.11
3200.02
Swisscom (Schweiz) AG
CH-3050 Bern
copying enabled
-
is activation
Y
Y
Y
Y
Sistierung deaktiv: Ankündigung der Reaktivierung der
Voice-Linie
Voice Message Text:
Reactivation of Temporary disconnection of voice: the
temporary disconnection of the voice connection for
subscriber with telephone number <DN1> will be
reactivated at <VALID_ACTI_DATE>. Swisscom will
inform the customer for the Voice-line by letter. Please
inform the Customer that Broadband services are
possible again from <VALID_ACTI_DATE> onwards.
Sistierung deaktiv: Mutation nicht leitungsrelevante
Dienste
Voice Message Text:
Reactivation of Temporary disconnection of voice:
Confirmation that the temporary disconnection of the
voice connection for subscriber with telephone number
<DN1> will be reactivated at <VALID_ACTI_DATE>.
Swisscom will inform the customer for the Voice-line by
letter. Please inform the Customer that Broadband
services are possible again from
<VALID_ACTI_DATE> onwards.
Sistierung deaktiv: Annullation der Reaktivierung
Voice Message Text:
Cancellation of Reactivation of Temporary
disconnection for <DN1> . A new Activation date will
follow.
Sistierung deaktiv: Prozessabschluss
Voice Message Text:
Reactivation of Temporary disconnection of voice:
Confirmation that the temporary disconnection of the
voice connection for subscriber with telephone number
<DN1> was reactivated at <VALID_ACTI_DATE>.
From <VALID_ACTI_DATE> onwards Broadband can
be provisioned again.
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
111/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
GV12 / Übernahme
GV12 /
Übernahme
Summary
4.6
Steps
5201.01
3190.11
3200.02
5201.03
12: Übernahme
5201.01
3190.11
3200.02
(5201.03)
is activation
Y
Y
Y
Y
Übernahme: Start der Übernahme
Voice Message Text:
Take-over Voice connection (incl. DSL) for DN: <DN1>
Please clarify with your customer
Übernahme: Annullation der Übernahme
Voice Message Text:
Cancellation for Take-over done
Übernahme: Abschluss der Übernahme
Voice Message Text:
Closure of transaction
GV17 / Nummerntypwechsel Deaktivierung
GV17 / Nummerntypwechsel
Deaktivierung
Summary
4.7
copying enabled
-
Steps
3130.06
3141.07 / 3151.07
3141.08 / 3151.08
3190.11
5240.05
3200.01
copying enabled
Y/N
Y/N
Y/N
Y/N
Y/N
Y/N
is activation
N
N
N
N
N
N
17: Nummerntyp Wechsel (Änderung Anschlussart)
(ISDN <--> PSTN), Deaktivierung
Nummerntypwechsel: Ausschaltbegehren
Swisscom (Schweiz) AG
CH-3050 Bern
3130.06
3141.07
3151.07
Voice Message Text:
Change of connection type DN old <DN1> and DN new
<DN2>: Request for disconnection of Voice service.
Please check also the automatically created Broadband
Disconnect order for disconnecting the BB-Service at the
old location.
Nummerntypwechsel:
3141.07 Ausschaltmeldung WSG / Ausschaltung durch Kunde/Servicepartner
3151.07 Ausschaltmeldung WSG / Ausschaltung terminiert
PONR (Point of no Return)
Voice Message Text:
Change of connection type DN old <DN1> and DN new
<DN2>: Disconnection PONR for DN old <DN1>. For
this Voice-Line with DSL the deactivation process has
started. Cancellation not possible anymore.
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
112/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Nummerntypwechsel:
3141.08
3151.08
3141.08
3151.08
Change of connection type DN old <DN1> and DN new
<DN2>: Physical deactivation for DN old <DN1>
confirmed. Physical deactivation of DSL is successful
done. Waiting for deactivation of DSL.
Nummerntypwechsel: Annullation der Ausschaltung
Voice Message Text:
Change of connection type DN old <DN1> and DN new
<DN2>: Cancellation of Voice-Disconnect Order for
DN old <DN1>. The automatically created
synchronised BB-Disconnect Order will be cancelled
and only be set up after a new Voice-Disconnect Order
is submitted
Nummerntypwechsel: Terminverschiebung der
Ausschaltung
3190.11
Voice Message Text:
Change of connection type DN old <DN1> and DN new
<DN2>: Change of Deactivation date to
<VALID_DISCON_DATE>
Nummerntypwechsel: Abschluss der Ausschaltung
5240.05
Swisscom (Schweiz) AG
CH-3050 Bern
Voice Message Text:
Closure of Voice-Disconnect transaction for DN old
<DN1>. DSL will be disconnected
is activation
Y
Y
Y
Y
Y
Y
Y
P
S
T
N
)
,
A
k
t
i
v
i
e
r
u
n
g
copying enabled
Y/N
Y/N
Y/N
Y/N
Y/N
Y/N
Y/N
(
I
S
D
N
Nummerntypwechsel: Einschaltbegehren
<
>
Steps
3010.11
3091/3071/3061.09
3091/3071/3061.10
3190.11
5240.05
3200.02
3301.14
A
n
s
c
h
l
u
s
s
a
r
t
)
n
d
e
r
u
n
g
GV17 / Nummerntypwechsel
Aktivierung
Summary
3200.01
3010.11
Ausschaltbestätigung / Ausschaltung durch Kunde/Servicepartner
Ausschaltbestätigung / Ausschaltung terminiert
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
113/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Copying enabled = Y: / Voice Message Text:
Change of connection type DN old <DN1> and DN new
<DN2>: Voice Line for new DN <DN2> was assigned
with planned activation date <VALID_ACTI_DATE>.
Please check also the automatically created Broadband
Create order for copying the BB-Service to the new
location.
Copying enabled = N: / Voice Message Text:
Change of connection type DN old <DN1> and DN new
<DN2>: Voice Line for new DN <DN2> was assigned
with planned activation date <VALID_ACTI_DATE>.
Nummerntypwechsel:
3091.09 Schaltmeldung WSG / Einschaltung terminiert
3071.09 Schaltmeldung WSG / Schalt. durch Servispartner
3061.09 Schaltmeldung WSG / Schaltung durch Kunde
PONR (Point of no Return)
3091.09
3071.09
3061.09
Copying enabled = Y: / Voice Message Text:
Change of connection type DN old <DN1> and DN new
<DN2>: PONR for DN new <DN2>. For this VoiceLine the activation process was started. Cancellation not
possible anymore. Please check also the automatically
created Broadband Create order for copying the BBService to the new location.
Copying enabled = N: / Voice Message Text:
Change of connection type DN old <DN1> and DN new
<DN2>: PONR for DN new <DN2>. For this VoiceLine the activation process was started. Cancellation not
possible anymore.
Nummerntypwechsel:
3091.10 Schaltbestätigung / Einschaltung terminiert
3071.10 Schaltbestätigung / Schaltung durch Servispartner
3061.10 Schaltbestätigung / Schaltung durch Kunde
3091.10
3071.10
3061.10
3190.11
Swisscom (Schweiz) AG
CH-3050 Bern
Copying enabled = Y: / Voice Message Text:
Change of connection type DN old <DN1> and DN new
<DN2>: Physical activation for DN new <DN2>
confirmed. Physical activation of DSL is successful
done. Waiting for automatic configuration of DSL
Copying enabled = N: / Voice Message Text:
Relocation: Physical activation for DN new <DN2>
confirmed.
Nummerntypwechsel: Annullation der Einschaltung
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
114/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
5240.05
3200.02
3301.14
SPEZIALFALL
4.8
Copying enabled = Y: / Voice Message Text:
Change of connection type DN old <DN1> and DN new
<DN2>: Cancellation of Voice-Order for DN new
<DN2>. The automatically created pending
synchronised BB-Order will also be cancelled and will
only be set up again after a new Voice-Activation Order
is submitted
Copying enabled = N: / Voice Message Text:
Change of connection type DN old <DN1> and DN new
<DN2>: Cancellation of Voice-Order for DN new
<DN2>.
Nummerntypwechsel: Terminverschiebung der
Einschaltung
Voice Message Text:
Change of connection type DN old <DN1> and DN new
<DN2>: Change of Activation date for DN new <DN2>
to <VALID_ACTI_DATE>
Nummerntypwechsel: Abschluss der Einschaltung
Copying enabled = Y: / Voice Message Text:
Closure of Voice-Activation transaction. DSL will be
configured. Please check also the automatically created
Broadband Create order for copying the BB-Service to
the new location.
Copying enabled = N: / Voice Message Text:
Closure of Voice-Activation transaction.
Nummerntypwechsel: Reine Voice-Transaktion kann die
Provisionierung eines BB-Orders während der Dauer der
Transaktion verhindern.
Voice Message Text:
Change of configuration of Voice-line: This voice-line is
currently blocked for Broadband Orders until
<VALID_ACTI_DATE>
GV03 / 04 / 15 Umzug Deaktivierung
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
115/135
GV03 / 04 / 15
Umzug
Deaktivierung
Summary
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Steps
3130.06
3141.07 / 3151.07
3141.08 / 3151.08
3190.11
5240.05
3200.01
copying enabled
Y/N
Y/N
Y/N
Y/N
Y/N
Y/N
3130.06
Umzug: Ausschaltbegehren
03 / 04 / /15: Umzug (Deaktivierungsteil)
3141.07
3151.07
3141.08
3151.08
3190.11
5240.05
3200.01
Swisscom (Schweiz) AG
CH-3050 Bern
is activation
N
N
N
N
N
N
Voice Message Text:
Relocation DN old <DN1> and DN new <DN2>:
Request for disconnection of Voice service. Please check
also the automatically created Broadband Disconnect
order for disconnecting the BB-Service at the old
location.
Umzug:
3141.07 Ausschaltmeldung WSG / Ausschaltung durch Kunde/Servicepartner
3151.07 Ausschaltmeldung WSG / Ausschaltung terminiert
PONR (Point of no Return)
Voice Message Text:
Relocation DN old <DN1> and DN new <DN2>:
Disconnection PONR for DN old <DN1>. For this
Voice-Line with DSL the deactivation process has
started. Cancellation not possible anymore.
Umzug:
3141.08
3151.08
Ausschaltbestätigung / Ausschaltung durch Kunde/Servicepartner
Ausschaltbestätigung / Ausschaltung terminiert
Voice Message Text:
Relocation DN old <DN1> and DN new <DN2>:
Physical deactivation for DN old <DN1> confirmed.
Physical deactivation of DSL is successful done. Waiting
for deactivation of DSL.
Umzug: Annullation der Ausschaltung
Voice Message Text:
Relocation DN old <DN1> and DN new <DN2>:
Cancellation of Voice-Disconnect Order for DN old
<DN1>. The automatically created synchronised BBDisconnect Order will be cancelled and only be set up
after a new Voice-Disconnect Order is submitted
Umzug: Terminverschiebung der Ausschaltung
Voice Message Text:
Relocation DN old <DN1> and DN new <DN2>:
Change of Deactivation date to
<VALID_DISCON_DATE>
Umzug: Abschluss der Ausschaltung
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
116/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
GV03 / 04 / 15
Umzug
Aktivierung
Summary
Voice Message Text:
Closure of Voice-Disconnect transaction for DN old
<DN1>. DSL will be disconnected
Swisscom (Schweiz) AG
CH-3050 Bern
Steps
3010.11
3091/3071/3061.09
3091/3071/3061.10
3190.11
5240.05
3200.02
copying enabled
Y/N
Y/N
Y/N
Y/N
Y/N
Y/N
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
is activation
Y
Y
Y
Y
Y
Y
117/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
3010.11
Umzug: Einschaltbegehren
Copying enabled = Y / Voice Message Text:
Relocation: Voice Line for new DN <DN2> was
assigned with planned activation date
<VALID_ACTI_DATE>. DN old <DN1>. Please check
also the automatically created Broadband Create order
for copying the BB-Service to the new location.
03 / 04 / /15: Umzug (Aktivierungstelil)
Copying enabled = N / Voice Message Text:
Relocation: Voice Line for new DN <DN2> was
assigned with planned activation date
<VALID_ACTI_DATE>. DN old <DN1>.
Umzug:
3091.09 Schaltmeldung WSG / Einschaltung terminiert
3071.09 Schaltmeldung WSG / Schalt. durch Servispartner
3061.09 Schaltmeldung WSG / Schaltung durch Kunde
PONR (Point of no Return)
3091.09
3071.09
3061.09
Copying enabled = Y / Voice Message Text:
Relocation: PONR for DN new <DN2>. For this VoiceLine the activation process was started. Cancellation not
possible anymore. Please check also the automatically
created Broadband Create order for copying the BBService to the new location.
Copying enabled = N / Voice Message Text:
Relocation: PONR for DN new <DN2>. For this VoiceLine the activation process was started. Cancellation not
possible anymore.
Umzug:
3091.10 Schaltbestätigung / Einschaltung terminiert
3071.10 Schaltbestätigung / Schaltung durch Servispartner
3061.10 Schaltbestätigung / Schaltung durch Kunde
Swisscom (Schweiz) AG
CH-3050 Bern
3091.10
3071.10
3061.10
Copying enabled = Y / Voice Message Text:
Relocation: Physical activation for DN new <DN2>
confirmed. Physical activation of DSL is successful
done. Waiting for automatic configuration of DSL
3190.11
Copying enabled = N / Voice Message Text:
Relocation: Physical activation for DN new <DN2>
confirmed.
Umzug: Annullation der Einschaltung
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
118/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Copying enabled = Y / Voice Message Text:
Relocation DN old <DN1> and DN new <DN2>:
Cancellation of Voice-Order for DN new <DN2>. The
automatically created pending synchronised BB-Order
will also be cancelled and will only be set up again after
a new Voice-Activation Order is submitted.
03 / 04 / /15: Umzug
(Aktivierung)
5240.05
4.9
3200.02
Copying enabled = N / Voice Message Text:
Relocation DN old <DN1> and DN new <DN2>:
Cancellation of Voice-Order for DN new <DN2>.
Umzug: Terminverschiebung der Einschaltung
Voice Message Text:
Relocation DN old <DN1> and DN new <DN2>:
Change of Activation date for DN new <DN2> to
<VALID_ACTI_DATE>
Umzug: Abschluss der Einschaltung.
Copying enabled = Y / Voice Message Text:
Closure of Voice-Activation transaction. DSL will be
configured. Please check also the automatically created
Broadband Create order for copying the BB-Service to
the new location.
Copying enabled = N / Voice Message Text:
Closure of Voice-Activation transaction.
05 / 06 : Zeitweiliger Anschluss
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
119/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
3301.00
05 / 06 : Zeitweiliger Anschluss
3010.03
3020.01
6010.01
6030.01
3200.01
3200.02
0000.00
4.10
Zeitweiliger Anschluss: Mutation leitungsrelevanter
Dienst
Temporary connection
Zeitweiliger Anschluss: ISLK ok.
Temporary connection: Line quality is good for ADSL
Zeitweiliger Anschluss: ISLK nok.
Temporary connection: Line quality is not sufficient for
ADSL
Zeitweiliger Anschluss: ISLK Rückmeldung Mutation
Temporary connection: Line is to be modified for the
voice service
Zeitweiliger Anschluss: Zur Zeit keine Ports verfügbar
Temporary connection: Currently no ports available
Zeitweiliger Anschluss: Anschluss ausgeschaltet
Temporary connection: Disconnected (closure of
transaction)
Zeitweiliger Anschluss: Anschluss eingeschaltet
Temporary connection: Connection is activated
Zeitweiliger Anschluss: Annullation
Temporary connection: Cancellation
37 Änderung
Korrektur Leitungs-Verlauf auf aktivem Anschluss
Voice Message Text:
Adjustment of active line, new cablebox infos.
3272.04
--------------------------------NSN
37 Änderung
Prozess Flow Nr.
<DN>
3272.04
Transaction Date/Time <TRANS_DATETIME>
Korrektur Leitungs-Verlauf auf aktivem Anschluss
Voice Message Text:
Adjustment of active line, new Port Nr. infos
3272.05
--------------------------------NSN
Prozess Flow Nr.
<DN>
3272.05
Transaction Date/Time <TRANS_DATETIME>
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
120/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
4.11
GV11 Korrektur Voice
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
121/135
GV11
Korrektur
Voice
Summary
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Steps
3301.14
3190.11
3200.02
11 Korrektur Voice
3301.14
3190.11
3200.02
11 Special
VoiceMessages
3010.90
3010.91
3010.92
Swisscom (Schweiz) AG
CH-3050 Bern
copying enabled
-
is activation
Y
Y
Y
Voice Message Text:
KORR: Currently a Voice-Order is inhibiting
Broadband Orders to be provisioned. Information about
finishing of KORR will be sent with Message 3200.02 or
3190.11
Voice Message Text:
Cancellation for Take-over done
Voice Message Text:
KORR: the Voice-Order KORR is done. Provsioning of
BB-Orders again possible
Voice Message Text:
“Broadband not possible at new location for DN:
<DN2>. Please contact your customer.”
Important Note: This voice-message is generated when
the flag Copying Enabled = Yes is set but at the new
location it is not possible to provide the same service as
before (For example: VDSL at “old” place, but at new
place only ADSL or “no Broadband” is possible)
Voice Message Text:
“This voice-line does not allow BB because of S21 fix.
DN: <DN2>.”
Important Note: This voice-message is generated when
the flag Copying Enabled = Yes is set but at the new
location it is not possible to provide the BB-service
because of S21 Fix, which inhibits the provision of BBServices.
Voice Message Text:
“For this DN <DN2> WSG will open a voice-driven
order at <HOLD_DATE>.”
Important Note: This voice-message is generated when
WSG identifies in the south-bound Fullfillment system a
pendig voice-Order but will not yet open the order due
to technical restrictions. In this case WSG notifies the
date, when (Date) the automatically created order will be
opened.
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
122/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
5
Web Service Interface
5.1
Security
The following sections describe the implemented precautions aiming to improve the security of
data transport in terms of confidentiality and non-repudiation.
5.1.1
Encryption
To meet the confidentiality aspect of information security the data transport between the web
service client and its server is protected using the https schema.
Https is a URI scheme equivalent to the http scheme, originally intended to be used with the HTTP
protocol, but with added encryption layer. The URI structure is the same, except that URIs begins
with "https:" rather than "http:". The scheme was invented by Netscape Communications
Corporation to provide authentication and encrypted communication and is widely used on the
Web for security-sensitive communication, such as payment transactions.
Instead of using plain text socket communication, the session data is encrypted using either a
version of the SSL (Secure Socket Layer) protocol or the TLS (Transport Layer Security) protocol, thus
ensuring reasonable protection from eavesdroppers, and man in the middle attacks. The default
TCP port of https: is 443.
5.1.2
Authentication, Authorization, and Accounting (AAA)
To meet the accountability and non-repudiation aspects of information security each Web Service
requires username tokens according to the OASIS Web Service Security (WS-Security) definition.
Please consult Appendix A for further details.
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
123/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
5.2
Model: WSDL and XML Schemas
5.2.1
Overview
The interface is defined by the wsgBbOutbound.wsdl (B2B) and the wsgLqsSaq.wsdl
(SAQ). Both WSDL inports Data Types from XSD-files. The files are included in document
in a ZIP file (see chapter 2.1 Overview)
5.2.2
Overview of supported Versions
The following table lists the supported versions for XML fulfillment requests
Port
Namespace
WsgBbV026 http://www.swisscom.com/wsg/bb/v26
WsgBbV024 http://www.swisscom.com/wsg/bb/v25
LqsQualiV0
http://www.swisscom.com/wsg/bb/v26
26
LqsQualiV0
http://www.swisscom.com/wsg/bb/v25
24
5.2.3
Remark
current fulfillment interface
deprecated Fulfillment
interface
current SAQ interface
deprecated SAQ interface
The WSG BB Outbound Web Service
The WSG BB Outbound Web is published under the following URLs:
Platfor
m
Production
URL
Description
https://webservices.swisscom.com/wsg/prod/bb/WsgBb
V026
https://webservices.swisscom.com/wsg/isp/bb/WsgBbV
026
Production
environment, actual
version.
Production
environment, previous
version.
Test environment for
ISPs, actual version.
https://webservices.swisscom.com/wsg/isp/bb/WsgBbV
025
Test environment for
ISPs, previous version.
https://webservices.swisscom.com/wsg/prod/bb/WsgBb
V025
ISPTest
5.2.4
The WSG LQS Service Availability Qualification (SAQ)
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
124/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
The WSG LQS Service Availability Qualification is published under the following URLs:
Platfor
m
Description
https://
Production
webservices.swisscom.com/wsg/prod/lqs/LqsQualiV026 environment, actual
version.
https://
Production
webservices.swisscom.com/wsg/prod/lqs/LqsQualiV025 environment, previous
version.
https://
Test environment for
webservices.swisscom.com/wsg/isp/lqs/LqsQualiV026
ISPs, actual version.
https://
Test environment for
webservices.swisscom.com/wsg/isp/lqs/LqsQualiV025
ISPs, previous version.
Production
ISPTest
5.2.5
URL
Deprecated Versions
With this software release a new version of the Fulfillment B2B specification is provided
(according the table above); all new development activities shall use this version.
The previous version (version number one level lower than the new one) remains valid, but
will become deprecated as soon as a possible next version of this interface will be created
and published.
5.2.6
Multiple Versions
The XML schemas are versioned by their namespace. The ISP have thus to provide the
correct namespace within the submitted XML-request according to the version of
interface which is being invoked (correct declaration of root-attribute “xmlns”).
Example:
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Header>
...
...
</soapenv:Header>
<soapenv:Body>
<createCustomerOrder xmlns="http://www.swisscom.com/wsg/bb/v16">
<request correlationId="abc1234510001">
<ispId>777710</ispId>
...
...
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
125/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
</request>
</createCustomerOrder>
</soapenv:Body>
</soapenv:Envelope>
5.2.7
Correlation from request to response
The attribute correlationId, which is to provide within each request-element of uploaded requests
and which is returned within each response-element, serves to correlate from a request to its
response. Pay attention to provide a unique identifier to permit this correlation.
Example:
Request:
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:v16="http://www.swisscom.com/wsg/bb/v16" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Header>
...
</soapenv:Header>
<soapenv:Body>
<v16:createCustomerOrder>
<v16:request correlationId="abc1234510001">
<v16:ispId>777710</v16:ispId>
...
...
<v16:order xsi:type="v16:modifyType" correlationId="xyz1">
...
...
</v16:order>
<v16:order xsi:type="v16:addType" correlationId="zyx2">
...
...
</v16:order>
</v16:request>
</v16:createCustomerOrder>
</soapenv:Body>
</soapenv:Envelope>
Acknowledge-response:
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<createCustomerOrderResponse xmlns="http://www.swisscom.com/wsg/bb/v16">
<response correlationId="abc1234510001">
...
...
<orderItem correlationId="xyz1">
...
...
</orderItem>
<orderItem correlationId="ord2">
...
...
</orderItem>
</response>
</createCustomerOrderResponse>
</soapenv:Body>
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
126/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
</soapenv:Envelope>
6
General Qualification Information
This section gives special information on the use of the qualification Service
The WSG-interface to the Qualification Service enables ISPs to implement the LQS qualification as an
on-line xDSL query service on their website using the BBCS Qualification Web-Service.
The term "xDSL" stands for: ADSL, SDSL, VDSL and since November 2009: BX
Definition of profile types for this document:
Item
ServiceProfile
AccessProfile
Fair Use
Profile
6.1
Definition
The service-profile characterizes the product (speed) which the customer uses.
The price for the customer results from the used product.
The access-profile characterizes the speed with that the network-access is
configured. Other term wich means the same: network profile
This is a specific profile for fibre-provisioning. Technically it is a access
profile but can be ordered by the ISP similar to a service profile
Purpose of the xDSL check facility
The xDSL Check enables end customers to find out whether their subscriber lines are suitable for ADSL,
VDSL, SDSL or BX and if so, which speed profiles are available. Availability differs for analogue (POTS)
and digital (ISDN) lines, but a POTS customer can query as if he had an ISDN connection and vice versa.
If the subscriber line is not suitable for ADSL, VDSL, SDSL or BX the xDSL check reports the technical
limitation. The facility also detects whether or not the end customer's local exchange presently
supports xDSL. If not, the xDSL check will convey the date planned for the upgrade of the central
exchange, if available.
Advantages of the Check-Facility:
 This Service enables ISPs to meet End customer needs quickly and easily.
 As the data is always current, the responses are up to date.
 For those exchanges which do not yet support xDSL, the customer is informed of the
anticipated implementation date, if it is scheduled
 The xDSL Check Facility is provided free of charge by FWS.
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
127/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
6.2
6.2.1
Qualification
ADSL
The ISP can use the xDSL Check to qualify for ADSL by setting the Parameter Technology to ‘ADSL’
during the request. The qualification can occur using the address or the active telephone number (DN).
If the address is entered without the active telephone number, the xDSL check will respond with Status
OK_STAO, meaning that ADSL is theoretically deliverable but cannot be verified for a specific line or
speed profile. The effective bandwidth may differ from the speed profile indicated in the xDSL response.
Further, a variety of additional customer premise equipment could hinder the implementation of ADSL
at the customer site.
If the address is entered and an existing voice line can be identified, the xDSL check will respond with a
Status OK meaning that ADSL is definitely qualified for this specific line. However, when the address is
entered and no subscriber could be identified or no voice line exists, the xDSL check will respond with a
Status OK_STAO, meaning that ADSL is theoretically deliverable but cannot be verified for a specific line
or speed profile.
Queries using the active Directory Number (DN) will always generate a definitive qualification, or Status
OK.
With regard to other faults and technical limitations on the circuit, the standard message codes apply.
6.2.2
SDSL
The ISP can use the xDSL Check to qualify for SDSL by setting the Parameters Technology to ‘SDSL’
during the request. The qualification can occur using the address, the active telephone number (DN), or
the Billing number (NSN or ‘Network Service Number’). If the check is performed with the address but
without the name, the Status "OK_STAO" is given. This means that SDSL is (in principle) possible but
since no specific connection could be qualified the actual effective transmission rate can vary from the
values provided with the check. In this case, the effective bandwidth may differ from the speed profile
indicated in the xDSL response.
If the check is performed successfully with the name and address, and the subscriber exists, and has an
active SDSL connection the Status "OK" is given since the connection was able to be qualified. If the
check is performed with the name and address but only a voice connection is active, the status
"OK_STAO" is given since the connection could not be identified.
Queries using the active Network Service Number (NSN) with SDSL Service will always generate a
definitive qualification, or Status OK.
Queries using the active Voice Number (DN) will always generate a conditional qualification, or Status
OK_STAO, because the specific circuit could not be identified.
With regard to other faults and technical limitations on the circuit, the standard message codes apply.
6.2.3
VDSL
The ISP can now use the xDSL Check to qualify for VDSL by setting the Parameter Technology to ‘VDSL2’
during the request. The qualification can occur using the address or the active telephone number (DN).
The ADSL rules apply also to VDSL!
6.2.4
BX
The ISP can use the xDSL Check to qualify for BX by setting the Parameter Technology to BX and
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
128/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
contract element to ‘BBCS-F (Fiber)’ during the request. The qualification can occur using the socket id
and plug nr (optional). If no plug nr is entered, the xDSL check will respond with Status OK and a list of
the plugs are returned. The effective bandwidth may differ from the speed profile indicated in the xDSL
response. Queries using the socket id/plug nr will always generate a definitive qualification.
Further, a variety of additional customer premise equipment could hinder the implementation of BX at
the customer site.
With regard to other faults and technical limitations on the circuit, the standard message codes apply.
Qualification by address is available by Service Availability Qualification (SAQ) only. SAQ will respond a
location with the sockets, or a list of locations only, if the address is not specific enough. The SAQ
response will never contain speed profiles.
6.2.5
Qualification with Address
The parameter "street" in an address request is not obligatory. If there are no value for street or the
parameters are not transmitted in the request (that means a request only with zip or city), the Public
Check will do a Qualification with an average result of the entire city if there are not too many possible
starting points.
This feature is implemented for the qualification of locations with no street names, which happens to
appear in very small villages.
If there are too many possible starting points, the Public Check will return an error message.
If the result of a request with an address and the name (first / last name) includes more than one active
number, than the Public Check response has the status “OK_STAO”. For example, that happens if the
same person has an active voice number and an active SDSL number.
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
129/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
6.3
6.3.1
General Response Description
Speed profiles in case of positive response
The long distance service is based upon a max. 1000 Kbps downstream / 100 Kbps upstream profile
that operates in adaptive rate mode. This means that the xDSL modem and the DSLAM select in
minimum the highest possible bandwidth between 600 Kbps downstream / 100 Kbps upstream and
300 Kbps downstream / 50 Kbps upstream.
The business offering for xDSL contains four profiles: 300 Kbps downstream / 300 Kpbs upstream, max.
600 Kbps downstream / 600 Kbps upstream and 6000 Kbps downstream / 600 Kbps upstream. For each
main profile, there is a fallback profile, which shall be applied if the main profile cannot be offered to
the customer for distance reasons. The highest possible profile within a profile group will be delivered.
The actual delivered profile may or may not be shown to the ISP or End customer.
For a list of possible speed profiles please refer the document [4] B2B Speed Profiles.
6.4
Possible reasons for a negative response
The system may provide a negative qualification result ("nok") and a specific error code (Q<nn>).
Please refer the document [1] WSG Messages for a list of possible qualification error codes and their
meaning.
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
130/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
7
Appendix A
7.1
Securing a WEB-Service with Powergate
A WEB-Service can be secured by using WSS Security (ref. OASIS Standard
http://www.oasis-open.org/specs/index.php#wssv1.0). WSS Security Tokens have to be included in
the header of the SOAP Requests. Realizing this feature is dependent of the implementation of the
WS Clients.
The header has to look as follows:
<soapenv:Header>
<wsse:Security
soapenv:actor="http://schemas.xmlsoap.org/soap/actor/next"
soapenv:mustUnderstand="0"
xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<wsse:UsernameToken>
<wsse:Username>586221</wsse:Username>
<wsse:Password>xxxxxx</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
</soapenv:Header>
Concerning "Username" and "Password" please refer to 7.5 Login .
7.2
Setting up a new WEB-Service
1. Determining the URL for the WEB-Service
2. Implementing the client in such a way that the WSS Security Tokens are included in the
SOAP (see following example).
7.3
Sample Client with wss4j
wss4j will be used for creating the WSS Header (ref. http://ws.apache.org/wss4j/). The called
service offers the method "list()"which will return the received header as a string.
public String[] doCall(
com.swisscom.powergate.ws.TestwsSoapBindingStub binding)
throws Exception {
String userName = "58622141964";
String pwd = "tXVLsD43";
Stub bindingStub = (Stub) binding;
Document doc = DocumentBuilderFactory.newInstance()
.newDocumentBuilder().newDocument();
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
131/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Element element = doc.createElementNS(WSConstants.WSSE_NS_OASIS_1_0,
"wsse:" + WSConstants.USERNAME_TOKEN_LN);
WSSecurityUtil.setNamespace(element, WSConstants.WSSE_NS_OASIS_1_0,
WSConstants.WSSE_PREFIX);
// create username element
Element elementUsername = doc.createElementNS(
WSConstants.WSSE_NS_OASIS_1_0, "wsse:"
+ WSConstants.USERNAME_LN);
WSSecurityUtil.setNamespace(elementUsername,
WSConstants.WSSE_NS_OASIS_1_0, WSConstants.WSSE_PREFIX);
elementUsername.appendChild(doc.createTextNode(userName));
element.appendChild(elementUsername);
// create password element
Element elementPassword = doc.createElementNS(
WSConstants.WSSE_NS_OASIS_1_0, "wsse:"
+ WSConstants.PASSWORD_LN);
WSSecurityUtil.setNamespace(elementPassword,
WSConstants.WSSE_NS_OASIS_1_0, WSConstants.WSSE_PREFIX);
elementPassword.appendChild(doc.createTextNode(pwd));
element.appendChild(elementPassword);
// set the header
bindingStub.setHeader(WSConstants.WSSE_NS_OASIS_1_0, "wsse:Security",
element);
assertNotNull("binding is null", binding);
// Time out after a minute
binding.setTimeout(60000);
return binding.list();
}
public void testHeaders() throws Exception {
com.swisscom.powergate.ws.TestwsSoapBindingStub binding;
try {
binding = (com.swisscom.powergate.ws.TestwsSoapBindingStub) new
com.swisscom.powergate.ws.TestWSServiceLocator()
.gettestws(new URL(
"https://www.zugang.ch:44300/bg/services/testws"));
Stub bindingStub = (Stub) binding;
// keep session
bindingStub.setMaintainSession(true);
System.out.println("\n\rCALL 1");
String[] headers = doCall(binding);
for (int i = 0; i < headers.length; i++) {
System.out.println(headers[i]);
}
System.out.println("\n\rCALL 2");
headers = doCall(binding);
for (int i = 0; i < headers.length; i++) {
System.out.println(headers[i]);
}
} catch (javax.xml.rpc.ServiceException jre) {
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
132/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
if (jre.getLinkedCause() != null)
jre.getLinkedCause().printStackTrace();
throw new junit.framework.AssertionFailedError(
"JAX-RPC ServiceException caught: " + jre);
}
assertNotNull("binding is null", binding);
// Time out after a minute
binding.setTimeout(60000);
}
7.4
Errors
Authentication error
In case of an authentication error the system will return HTTP Status 403 Forbidden. The error will
be returned inside the SOAP body as <SOAP-ENV:Fault:
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Authentication required (realm='soap')</faultstring>
</SOAP-ENV:Fault>
Backend Server not available:
HTTP/1.1 502 Bad Gateway
Date: Thu, 20 Apr 2006 11:49:22 GMT
Server: Apache
Pragma: no-cache
Connection: close
Cache-Control: no-cache
Content-Type: text/xml
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Server</faultcode>
<faultstring>Upstream server is not available</faultstring>
<faultactor>https://wstest.swisscom.com/wsg/omso1/bb/WsgBb</faultactor>
<detail>Upstream server is not available</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Error on the Backend Server
Here an example in the form of a standard http error:
HTTP/1.1 500 Internal Server Error
Date: Wed, 19 Apr 2006 14:27:03 GMT
Server: Apache
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
133/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
Set-Cookie: Navajo=AUcAUVoasEVlDVm29EUVyRYuqxwWRG4ozwlKJEewSpvKoVwVEz9mjIclAEQ0goaIH3ZnB9g/RXA-; path=/; secure;
HttpOnly
Set-Cookie: JSESSIONID=AEC47F88F1B35E4329C5C58F40841B4E; path=/wsg/e2e/bb/wsg-outbound; secure; HttpOnly
Content-Type: text/xml;charset=utf-8
Connection: close
<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
<soapenv:Fault>
<faultcode xmlns:ns1="http://xml.apache.org/axis/">
ns1:Client
</faultcode>
<faultstring>No such operation 'list'</faultstring>
<detail>
<ns2:hostname xmlns:ns2="http://xml.apache.org/axis/">
sbe18304.swissptt.ch
</ns2:hostname>
</detail>
</soapenv:Fault>
</soapenv:Body>
</soapenv:Envelope>
Wrong URL (Webservice not existing)
HTTP/1.1 404 Not Found
Date: Wed, 19 Apr 2006 14:30:38 GMT
Server: Apache
Pragma: no-cache
Connection: close
Cache-Control: no-cache
Content-Type: text/xml
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>mapping for request URI '/wsgdf/e2e/bb/WsgBb' not found</faultstring>
<faultactor>https://wstest.swisscom.com/wsgdf/e2e/bb/WsgBb</faultactor>
<detail>mapping for request URI '/wsgdf/e2e/bb/WsgBb' not found</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
No authorisation for the service but valid Login
HTTP/1.1 403 Forbidden
Date: Wed, 19 Apr 2006 14:31:40 GMT
Server: Apache
Pragma: no-cache
Connection: close
Cache-Control: no-cache
Content-Type: text/xml
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
134/135
B2B BBCS Fulfillment Interface Specification
C2 - Internal
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Your are not authorized to access the requested resource</faultstring>
<faultactor>https://wstest.swisscom.com/wsg/prod/bb/WsgBb</faultactor>
<detail>Your are not authorized to access the requested resource</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
7.5
Login from the user point of view
Two possibilities can be used for Login:
▪ Login with PUI (Personal User Identification: 11-digit number) and Password (4 – 15
characters). The PUI will be sent to the user by email or letter after registration. It has to be used
for the first Login.
The password will be sent to the user by letter and can be changed arbitrarily by the user after the
first Login.
▪ Login with username unique alphanumeric identification) and Password (4 – 15 digits).
The username (formerly also known as synonym) van be created by the user after the first login
with the PUI. It must start with an alphabetic character, must be 8-20 characters in length and
must be unique. Maybe the user needs several trials till a unique and not yet used name could be
found.
The password will be sent to the user by letter and can be changed arbitrarily by the user after the
first Login.
Swisscom (Schweiz) AG
CH-3050 Bern
Broadband Connectivity Service (BBCS)
Version
44
Valid from
08.06.2015
135/135