introduction - web viewthe welcome page displays the authorized main menu items for the user and...

Cocom Reseller Connect

Web Manager User Guide

Germany

Cocom Web Manager Reseller Connect DE User Guide v.2.3 1 / 99

Document History

Soft copies of this document are maintained under change control, but hard copies are not.

This may not be a printout of the latest version.

Revision history

Revision Date Description1.0 27th Feb 2006 Initial Document for Launch

1.1 14th June 2006 Added Suspend functionality (New chapter 3.2.5), update of query

section (chapter 3.4); added new error message (Appendix B)

1.2 27th June 2006 Drop down menu now country specific for CPS Report (chapter

3.4.4)

1.3 27th July 2006 Change version number to 1.1.

CLI history function has been added in chapter 3.4 for Query CLI

Status

1.4 3rd July 2007 Added error message for Modify VoIP

1.5 15th April 2009 Maintenance & Support updated.

1.6 1st April 2011 Updated to reflect move to enhanced Cocom

1.7 24th Aug 2011 Added more detailed information about the new CDR format and

update the Error Messages Table in APPENDIX C Colt response

and Reason codes

1.8 20th Jan 2012 Updated with details of new consolidated CDR feature

1.9 16th Feb 2015 Updated the information related to Internet Browser

2.0 6th May 2015 DTAG decommission their ESAA interface and replace it with

WITA as of 30/06/2015. Updates reflect the new appt timeslot field

in a CPS request and new DTAG Response Codes & messages.

2.1 13th Aug 2015 Updated to reflect the replacement of the optional premise number

field with the mandatory Building number field in Activate CPS

request & bulk request.

2.2 4th Feb 2016 Updated to reflect the new Colt rebranding and browser related

information.

2.3 4th March 2017 Replaced VoIP Access with SIP Trunking, updated to reflect

browser related information in section 1.2 , alternative access to

Cocom Web Manager details in section 2.2 and change in the

notification period for planned maintenance work in section 3


Table of Contents1 INTRODUCTION...........................................................................................51.1 COCOM WEB MANAGER OVERVIEW.................................................................51.2 SCOPE...........................................................................................................5

2 USING COCOM WEB MANAGER................................................................72.1 LOGIN TO COLT ONLINE APPLICATION.............................................................72.2 ACCESS TO COCOM WEB MANAGER...............................................................82.3 WELCOME PAGE ON COCOM WEB MANAGER................................................102.4 MENU ITEMS.................................................................................................112.5 MANAGE CLI................................................................................................12

2.5.1 Activate CLI............................................................................................132.5.2 Deactivate CLI........................................................................................152.5.3 Modify CLI..............................................................................................172.5.4 Call Profiles CLI......................................................................................192.5.5 Bulk Upload CLI.....................................................................................21

2.6 MANAGE CPS..............................................................................................222.6.1 Activate CPS..........................................................................................22

2.7 DEACTIVATE CPS.........................................................................................262.7.1 Bulk Upload CPS....................................................................................26

2.8 STATUS QUERY............................................................................................282.8.1 Query CLI Status....................................................................................292.8.2 Query Transaction Status.......................................................................352.8.3 CLI Reports............................................................................................402.8.4 CPS Reports...........................................................................................42

2.9 CDR DELIVERY............................................................................................462.9.1 CDR File Delivery and Naming Convention...........................................462.9.2 CDR Search...........................................................................................492.9.3 CDR Download.......................................................................................502.9.4 CDR File Format:....................................................................................512.9.5 Consolidated CDR Request...................................................................512.9.6 Consolidated CDR Search.....................................................................542.9.7 Consolidated CDR Download.................................................................552.9.8 Consolidated CDR File Format:.............................................................56

2.10 VIEW RESELLER DATA..................................................................................572.11 DOCUMENTS.................................................................................................59

2.11.1User Guides.............................................................................................592.11.2VPN Access.............................................................................................59

2.12 COCOM WEB MANAGER EXIT........................................................................60

3 MAINTENANCE AND SUPPORT...............................................................614 GLOSSARY.................................................................................................62APPENDIX ACALL DATA RECORD FORMAT....................................................65A.1 CDR FILE FORMAT.......................................................................................65

A.1.1 Character Coding...................................................................................65A.1.2 File Mark-up Coding...............................................................................65A.1.3 Compression/Decompression Algorithms..............................................65A.1.4 File Name...............................................................................................65


A.2 CALL DETAIL RECORD FORMAT.....................................................................66A.3 SAMPLE CALL DETAIL RECORD.....................................................................69

APPENDIX B CSV-FILE FORMAT FOR BULK UPLOADS..................................69B.1 HEADER RECORD.........................................................................................69B.2 DETAIL RECORDS.........................................................................................70

APPENDIX C COLT RESPONSE AND REASON CODES...................................78ERROR CODES FROM PTT (DTAG)....................................................................86COUNTRY CODES................................................................................................96APPENDIX D ACTIVITY CODES..........................................................................99


1 Introduction

1.1 Cocom Web Manager Overview

Colt Technology Services (Colt) has provided you with an electronic B2B interface, Cocom,

to support your product related transactions.

This includes the daily transfer of Call Detail Records (CDR) for Colt’s Reseller and Carrier

products. In addition it supports product-specific transactions, including the activation of

Calling Line Identifier (CLIs) and Carrier Preselection (CPS) requests for Reseller Connect.

Cocom Web Manager is a Graphical User Interface (GUI) and enables the Colt customers

(Resellers and Carriers) to process their product related transactions easily and on demand.

You can still use the existing interfaces choosing their preferred protocol to transport the

XML (eXtensible Mark up Language) elements via HTTPS (HyperText Transfer Protocol

Secure) or you can still use the existing FTP (File Transfer Protocol) Flat File Transfer.

Please refer to the Cocom FTP and Cocom XML user guides if you use these interfaces.

This user guide describes how to use the Graphical User Interface for Reseller Connect,

including CLI activations, CPS requests, as well as ways to query the CLI/CPS Status and

search for error messages.

Please note that this User Guide is made especially for resellers and carriers in Germany.

1.2 Scope

In order to use Cocom Web Manager you won’t need any additional software or

development. A Browser and an Internet connection will be sufficient.

Internet Explorer 6.0, Internet Explorer 8.0, Mozilla Firefox 40 and Google Chrome 45

versions are the recommended browser versions on which the application has been

tested.

DescriptionThe diagram below shows the principle structure of the systems and their interfaces.


Figure 1 - Reseller support infrastructureThe GUI uses XML requests which will be exchanged via HTTPS to have high security

connection. XML Interface allows additional functions such as List Requests, List

Responses, Query Request Status, Query Switch Status, and List CPS Responses.

All the XML Interfaces are synchronous and need to be invoked as and when required by

you.

You can still use the existing FTP File Transfer for flat file CSV requests or use the XML

interface directly with own developed software.


Please note: CLI and CPS requests and responses are country-specific and the

functionalities will differ between countries.

colt

2 Using Cocom Web Manager

The following section describes the login to Cocom Web Manager via Colt Online, how to

download CDRs as well as manage CLI and CPS requests and responses with DTAG, view

user guides and view reseller data.

2.1 Login to Colt Online Application

The access to Cocom Web Manager is fully integrated into Colt’s customer portal Colt

Online. Via your single login on Colt Online you can access all your Reseller Voice products

from Colt on Cocom Web Manager.

Please use your Colt Online access with the following URL:

www.colt.net/online

The following Login screen will appear.

Figure 2 Colt Online Login ScreenPlease proceed with the following steps:

(1) Enter your Username (Authenticated by Colt in your Welcome letter)


5

4

3

2

6

1

1

http://www.colt.net/online

(2) Enter your Password (Authenticated by Colt in your Password letter)

(3) Click on the button “Submit” to access Colt Online.

When you first login, you will be requested to change your password.

(4) If you have forgotten your password, please click on “Forgotten your password”.

You are then requested to enter your “Login ID” and your “E-Mail” address. A new

password will be sent to you by Colt Customer Service.

(5) If you want to create a new account, please click on “Request Login”, you will be

then requested to enter your customer data to create a new account.

(6) Here you can choose the language you prefer.

2.2 Access to Cocom Web Manager

You can access Cocom Web Manager via Sales Tools in the top navigation bar.

Figure 3 Colt Online Welcome Screen(1) Place the mouse over the “Sales Tools” Main menu


2

1

2

3

4

5

6

1

(2) The “Cocom Web Manager” Sub menu item with link is displayed if you are an

authorized user to access Cocom Web Manager. Click the “Cocom Web Manager”

Sub menu link. The Cocom Web Manager application will be invoked and open the

Welcome page in a new browser. Your user credentials are authenticated and

enable you to access the Web Manager application


Please Note: Cocom Web Manager Sub menu item with link will not be displayed if the

user is not authorized to access Cocom Web Manager.

2

Please Note: The alternative access to Cocom Web Manager during downtimes of Colt

Online is: https://coltcocomwebmanager.colt.net/wholesale1

https://coltcocomwebmanager.colt.net/wholesale1

2.3 Welcome Page on Cocom Web Manager

The Welcome page will display all available Account / Service Profiles according to your

products under the Reseller Domain name which is authorized for you.

The Reseller Domain is only held in Cocom Web Manager and is a shortened version of

your company name.

Account profiles are set up based on your billing account (BCN), whereas service profiles

are set up per service instance. Account profiles will apply to products such as SIP

Trunking and Voice Line, and service profiles will apply to Reseller Connect.

If you have more than one product on the same billing account (BCN), e.g. SIP Trunking &

Voice Line, then they will have the same account profile.

Service profiles apply for the products Reseller Connect, Reseller VoIP Connect and Carrier

VoIP (unrated CDRs). Service profiles enable Colt to continue to support multiple Reseller

service profiles being billed on the same Colt billing account (BCN) and provide unrated

CDRs per service profile to Cocom.

Your account or service profiles will conform to the new standard of up to 5 alphanumerics.

All your accounts and service profiles across all products and countries are aggregated

under your Reseller Domain. The status has two different values. “Disabled” stands for a

Reseller Domain which has been created but is not allowed to set up any other activity.

A Reseller Domain with the status “Active” is allowed to perform functional activities

based on profiles.

Figure 4 Web Manager Welcome Screen


1

2

13

4

2 43

1

6

5

On the right top corner you will find the “Home”, “Contact Us” and “Logout” navigations. Click ”Home” link, will refresh the screen and display the Welcome page. If you want to contact your Colt Customer Services, click on the ”Contact Us” link. A screen with phone numbers and E-Mail address of our Colt Customer Service for each of the countries will be displayed.

(3) On the right corner under the top navigation bar, you can see that you are logged

in with your Username

Users are allowed to access the menus according to the Web manager Role and product-

related permissions.

The welcome page displays the authorized main menu items for the User and placing the

mouse over each menu will display the sub menu items with links.

2.4 Menu Items

The following section describes the available feature for each function in the Cocom Web

Manager. Which feature is available is dependent on the access rights and country

configuration of the user account. Therefore it may be that not all described features are

available on your account.

MANAGE CLIManage CLIs can provide the following features:

Activate CLI

Deactivate CLI

Modify CLI

Bulk Upload

Switch Profile

Activate and Deactivate CLI allows to activate and deactivate CLIs on the Colt switch. The

action Modify CLI allows to change the ownership of a CLI from another Reseller to your

own Reseller account. It is also possible to upload several CLIs in a CSV formatted file (Bulk Upload). The function Switch Profile allows you to suspend and unsuspend a CLI.

MANAGE CPSThe menu Manage CPS offers the following features:

Activate CPS


5

6

Bulk Upload

Activate CPS allows you to activate CPS. The messages will be sent to Cocom and

forwarded to the PTT. The function Deactivate CPS is not available in all countries. It is also

possible to upload several CPS requests in a CSV formatted file (Bulk Upload).

STATUS QUERYStatus Query allows you to request information for each transaction, immediately after the

transaction has been successfully carried out. Dependent on the action the status of the

transaction can change (e.g. for CPS-Requests).

CDR DELIVERYCDR Delivery allows you to download CDRs which will be delivered twice a day by default. If

available the FTP-Account as described in the “Cocom Reseller FTP User Guide” available

for all countries (Austria, Belgium, France, Germany, Ireland, Italy, Netherlands, Spain,

Sweden, UK) can be used.

2.5 Manage CLI

Manage CLIs can provide the following features:

Activate CLI

Deactivate CLI

Modify CLI

Bulk Upload

Switch Profile

Activate and Deactivate CLI allows to activate and deactivate CLIs on the Colt switch. The

action Modify CLI allows to change the ownership of a CLI from another Reseller to your

own Reseller account. It is also possible to upload several CLIs in a CSV formatted file (Bulk

Upload). The function Switch Profile allows to suspend and unsuspend a CLI.

Click on “Manage CLI” main menu to get the following screen.


1

Figure 5 – Manage CLI screen(2) Activate and Deactivate CLI allows activating and deactivating the CLIs on the Colt

switch for the product: Reseller Connect.

(3) Modify CLI allows to change the ownership of a CLI from another Reseller to your

own Reseller or from one of your profiles to another of your profiles. It is also

possible to upload multiple CLIs in a CSV formatted file (Bulk Upload).

You can find the required files for a “Bulk Upload” attached in the chapter

“APPENDIX B”.

The Call Profile CLI allows you to suspend and unsuspend a CLI .

2.5.1 Activate CLI

From the Welcome Screen click on the button “Manage CLI” to get the following screen. You

can select the different functions from the menu on the left side of this screen. Click “Activate

CLI” Sub menu link and you will be navigated to “Select Profile” screen to activate a CLI

on the Colt switch.

Select a required profile to activate the CLI.


4

1

2

3

5

5

1

4

3

2

Figure 6 –Select profile screen for Activate CLIThe “Profile Name” is displayed in blue color link under “Service Profile/ Account Profile”

column header. Click on the “Profile Name” with link.

The following screen will be displayed:

Figure 7 –Activate CLI ScreenPlease enter the new CLI which you want to activate with a leading zero in the “CLI Field”.

Then type in the CLI (you can enter from 5 up to 22 digits) and click “Submit” to

submit the activation. If you have made a mistake, click on the “Reset” button to clear

the entered CLI.


2

2 45

2

1

54

3

The activation can take a while during which “In Progress…” will be shown. Please wait until

either a “Transaction ID”, or an error message will be shown. The error message will be

displayed if the CLI is not in the correct format.

Feature Description Example

CLI CLI with leading zero

5-22 digits including the leading

zero.

0699712345

Figure 8 –Transaction Result Screen after submitting Activate CLI

After the CLI-Request has been sent to Cocom the Transaction ID for this request will

be displayed if the transaction can be processed successfully. To check the status of this

specific transaction click on “Status Query” , select the feature “Query Transaction

status” and type the Transaction ID.

2.5.2 Deactivate CLI

To deactivate a CLI click on “Manage CLI” and select the menu “Deactivate CLI” or, if

you are already in the menu “Manage CLI” you can choose “Deactivate CLI” directly.

Select the required profile to deactivate a CLI.


67

1

2

7

6

Figure 9 – Select profile Screen for CLI deactivation

Figure 10 –Deactivate CLI ScreenType the CLI in the available field. The format of the CLI needs to be the valid format as

described in chapter Activate CLI (with a leading Zero). To send this request click on the

button “Submit” . To delete the input you can either use the delete button from your

keyboard or click on the button “Reset”

The deactivation request may take a while, during which “In Progress…..” will be shown.

After the request has been successfully processed a Transaction ID will be displayed.

You can use the Transaction ID to search in the Queries for the status of this transaction.


3 4

5

1

2

43

Figure 11 –Transaction Result Screen after submitting Deactivate CLI

2.5.3 Modify CLI

If you have the access rights to use the Modify function you can click on “Modify CLI”

from the “Manage CLI” menu. Modify allows to change the ownership of a CLI from one

Service Profile of another Reseller to your own Service Profile, or from one of your own

service profiles to another of your service profiles. Select a required profile to modify the

CLI on the Colt switch.

Figure 12 –Select Profile Screen for Modify CLI

Type the CLI in the available field you want to modify . The format needs to be the valid

format of a CLI as described in chapter Activate CLI (with a leading Zero).To send the

request click on the button “Submit” To delete the CLI you can either use the delete

button from your keyboard or click on the button “Reset” .


12

34 5

5

1

2

Figure 13 –Modify CLI ScreenThe Modify CLI request can take a while, during which time “In Progress…..” will be shown.

After the request has been successfully processed a “Transaction ID” will be displayed.

You can use the “Transaction ID” to check the status of this specific transaction click on

“Status Query”, select the feature “Query Transaction Status” and type the “Transaction ID”

and click on “Search” button.

Figure 14– Transaction Result for Modify CLI


5

5

4

53

2.5.4 Call Profiles CLI

Using the Call Profiles CLI menu allows you to use the suspend functionality. This

function may not be available for every reseller. If you want to use this function and the

button in the menu is not available, please contact Colt Customer Service to request this

functionality.

Select the required profile to suspend the CLI.

Figure 15 –Select Profile screen for Call Profile CLI

Type the CLI in the available field you want to suspend . The format needs to be the

valid format of a CLI as described in chapter Activate CLI (with a leading Zero) and needs to

be already active.

Click on the drop down menu of the field Suspend and select “Suspend” and click on

the Button “Submit” .

To unsuspend a CLI, please select in the dropdown menu “Unsuspend” .


Please note: The transaction Modify will automatically activate the CLI if not already

activated. The Switch Profile will be reset to STD (Standard) when CLI is modified with

Web Manager.

1

2

3

45

4

1

2

Figure 16 –Call Profile CLI ScreenAfter the request has been successfully processed a “Transaction ID” will be displayed. You

can use the “Transaction ID” to check the status of this specific transaction click on “Status

Query”, select the feature “Query Transaction Status” and type the “Transaction ID” and click

on “Search” button.

Switch profile Switch profile IDSuspend Call SC

Unsuspend Call CS


Please note: A CLI can only be unsuspended if it has been suspended before.

Please note: When a CLI is suspended the Switch Profile will be stored and if the CLI is

unsuspended the Switch Profile will be the same as before the suspend.

5

43

When a call is made for a suspended CLI the following announcement will be played:

Dieser Anschluss ist vorübergehend nicht erreichbar. Bitte rufen Sie später wieder an.When dialing the 0310 (local) or 0311 (distance) from this connection (if preselected), COLT

will still be announced as the used carrier.

2.5.5 Bulk Upload CLI

With this function you are able to upload a CSV-File with up to 499 data records for CLI

activation, deactivation or modification. Click ”Bulk Upload CLI” Sub menu link.

Please find a short description of the format in the APPENDIX B.

Select the required Profile where you want to upload the CSV File.

Figure 17 –Select Profile Screen

To upload a file you can either type the complete path and file name in the available field

or click on the “Browse” button to select a file from your disk drive.

Select a file in the correct format and click on “Open” and click “Submit” . There will be

one “Transaction ID” for all activities requested in the file.


1

2

34

5

2

1

Figure 18 –Bulk Upload CLI Screen

2.6 Manage CPS

The functionalities under Manage CPS menu:

Activate CPS

Bulk Upload CPS

Activate CPS allows to activate Carrier Pre-selection. The messages will be sent to Cocom

and forwarded to your local PTT. The function Deactivate CPS is not available in all

countries. It is also possible to upload several CPS requests in a CSV formatted file (Bulk

Upload).

2.6.1 Activate CPS

From the Welcome Screen click on the button “Manage CPS” to get the following

screen. You can select the different functions from the menu on the left side of this screen

Click on the button “Activate CPS” to see the screen below. To send a CPS request to

DTAG fill in the necessary fields described below. Then select the Reseller Profile to activate

the CPS .


Please note: The Switch profile cannot be changed with a bulk upload request

1

23

3 5

4

Figure 19 – Select Profile Screen for Activate CPS

Enter the required valid fields and click “Submit” to process the CPS request. To delete

the input without submitting, click on the “Reset” button.

Mandatory fields are marked with a red asterisk “*”.

Figure 20 –Activate CPS Screen

Please find below the description of the features:


45

Please note: DTAG accepts all possible ranges for CPS activation

1

2

3

54

Mandatory fields

Feature Description ExampleCLI CLI with leading zero

5-22 digits including the leading zero. The

following prefixes are not allowed for CPS: 00,

01, 0190, 0800, 0900

Due to changes to Cocom only “Stamm-Nr” is allowed here, independently of how many CLI blocks were activated by Colt. The “Stamm-Nr” needs to be a valid DTAG number. It is not possible to send smaller parts of a range or a single Number out of a range to DTAG as it would be rejected (RNG). A CPS request with part of the range will lead to a best match conflict and not sent to DTAG.

0699712345

CPS Level CPS Level defines the calls which are allowed:

Loc – Local (CPS_2)

Dist – Distance (CPS_3)

Loc OR dist – Local or Distance (CPS_4)

Loc AND dist – Local and Distance (CPS_5)

Loc OR Dist (DTAG

activate either local or

distance or both, depending

on which value is not

active)

Customer

Request Date

Preferred date for implementation. Minimum

timeframe is three working days.

Select Tuesday, when today is

Friday.

Area Code Area Code with leading zero 069

Caller Number Telephone number (without extension) 9712345

Building Number Building Number 4

Party/Last Name Either company name or surname for a private

customer

Smith

Street Street number or PO Box number Bahnhofstraße.11

Postal Code Post Code 60528

City City/Town Frankfurt


Optional fields

Feature Description ExampleRange Start All possible number ranges are accepted. Number of additional

digits needs to be the same as range end.

300

Range End All possible number ranges are accepted. Number of additional

digits needs to be the same as range start.

399

Internal

Switchboard

Required if specifying a number range for a CPS request.

Value has one digit.

0

First Name For residential subscribers this field is mandatory otherwise the

order will be rejected by DTAG.

In the case of Corporate Customers this field should be blank.

Country Always Germany DE (Germany)

Appointment

Timeslot

The available appointment timeslots are:

0800-1200 CET(Mon-Sat)

1200-1600 CET(Mon-Fri)

Default value is 0800-1200 CET(Mon-Sat)

If the customer request date is a Saturday, select “9“ for

timeslot: 0800-1200 CET

0800-1200

CET(Mon-Sat)

1200-1600

CET(Mon-Fri)

Figure 21 – Transaction Result ScreenAfter the transaction has been processed the assigned “Transaction ID” will be

displayed. To activate a new CPS click again on the “Activate CPS” link.


6

6

2.7 Deactivate CPS

This feature is not available in Germany.

2.7.1 Bulk Upload CPS

The Bulk Upload for CPS will be handled in the same way as Bulk Upload for CLI. You can

upload a CSV-File with up to 499 data records for CPS activation.

Please find a short description of the format in the APPENDIX B. An MS Excel macro is

provided by Colt and this can be found in the Help section in Cocom Web Manager.

Click on the button “Bulk Upload CPS” to see the screen below. Then select the Service

Profile to activate the CPS .

Figure 22 –Select Profile Screen for Bulk Upload CPS

To upload a file you can either type the complete path and file name in the available field

or click on the “Browse” button to select a file from your disk drive.

Select a file in the correct format and click on “Open” and click “Submit” . There will be

one “Transaction ID” for all activities requested in the file.


Please note: The transaction Activate CPS will automatically activate the CLI if not already

activated.

Please note: There is no option available in Cocom to cancel a CPS request.

12

34

5

2

1

Figure 23 –Bulk Upload CPS Screen


5

4

3

2.8 Status Query

The Status Query menu offers the following features:

Query CLI Status

Query Transaction Status

CLI Reports

CPS Reports

Status Query allows to request information for each transaction, immediately after the

transaction has been successfully carried out. Dependent on the action the status of the

transaction can change (e.g. for CPS-Requests).

There are several options to query for information on your CLI and CPS transactions under

Status Query – see under below.

Figure 24– Status Query screen


1

1

2.8.1 Query CLI Status

Click on “Query CLI Status” to request the status of a CLI, and then select the service

profile in order to find the status of the CLI.

Figure 25 - Query CLI Status

Type the CLI in the available field to search for a CLI. You can search for one single CLI

or you can search for several CLIs starting with the same digits. In this case no wildcard

character is necessary. Click on the button “Submit” to send the request. Click on the

button “Reset” to delete your input.

You can also Search for CLI Ranges by leaving out the last numbers of a CLI


2

3 45

2

3

4 5

Figure 26 - Query CLI Status for several CLIs

You can download the search result into MS Excel after clicking on “Export to Excel”

icon and you can save it on your local drive.


6

Figure 27 - Query CLI Search Result Screen

Figure 28 - Query CLI Search for several CLIs Result Screen


6

7

7

The following messages can be displayed:

CLI is active

CLI <…> is not active

CLI is owned by different account

Connection closed

The message connection closed is displayed in the unlikely case the B2B Gateway is not

available and no answer can be send back. In this case, please try the request after a while

again.

Field Description ExampleCLI CLI with leading zero 0694832101

Country Country of Reseller DE

Service Profile Service Profile AAX

Customer Group Name of the Reseller

CLI Type Text Information about CLI if available Single CLI, UNKNOWN

CLI Range Start CLI Range Start number

CLI Range End CLI Range End number

Access Number Not existing for Germany

Switchboard

Number

Switchboard Number if available

Toneburst Not existing for Germany

CPS Level CPS Level defines the calls which are

allowed:

Loc+dist – Local and Distance (CPS_5)

Loc or dist – Local or Distance (CPS_4)

Loc – Local (CPS_2)


Switch Profile Switch Profile STD

CLIserv Colt internal Number


Field Description ExampleTariff Plan Colt internal Number

Pseudo Account

ID

Colt internal Number

Pseudo DN Colt internal Number

Suspended True if CLI is suspended True or false.

For more information on the history of this CLI, please click on the button “CLI History” .

The CLI History will be shown only for CLIs linked to your own Profile. Transactions done by

other Resellers for a CLI owned (now) by you will be displayed, but without showing the

Profile information.

“CPS-Requests” will be shown, but not the multiple responses for a CPS-Request. You will

see for the “Colt Response Code” either -1 (pending), 0 (ok) or any other “Colt Error Code”

with a short explanation in the additional “Response Text”. For a pending CPS-request no

“Transaction Date” will be shown.

Figure 29 - CLI History Result ScreenAt the end of the web page an export option is offered. You can export the whole search

result into Excel. The Excel file will include all information listed on the screen.

Field Description Example

CLI CLI with leading zero 06835956789

Transaction ID Transaction ID – not shown if

transaction is not done by own

Reseller ID

2011012294

Action Type Action ADD CLI, ADD CPS, …

Service Profile Service Profile AB4


7

Field Description Example

Switch Profile Switch Profile as described in the

Call Profile CLI section

Single CLI

UNKNOWN

Transaction

Date

Date when the transaction has

been sent. Format:

YYYYMMDDHHmmss

2011.01.14-10:41:40

Response Code Colt Response Code as described

in APPENDIX C Colt Response

and reason codes

0

Response Text Colt Response Text as described

in APPENDIX C Colt Response

and reason codes

OK

Additional

Response Text

Colt Additional Response Text as

described in APPENDIX C Colt

Response and reason codes


2.8.2 Query Transaction Status

Click on “Query Transaction Status” to search the result for a specific transaction.

Select the required Profile to find the result(s) for a particular transaction.

Figure 30 - Transaction List Screen

A list of all “Transaction IDs” will be displayed on one or more pages. The “Transactions

List” contains the following information:

(Transaction) ID

Transaction Type

Transaction Date

You can sort the list on one web page by clicking on the header line or export the list into

Excel to have a complete list in one file. To request detailed information for a single

transaction click on the “Transaction ID” link.

You can search either for a special “Transaction ID” or for several transactions

between two dates. Click on the ”Calendar Symbol” to select the “Start and the End

Date” and click on the button “Search” to send the request. If the “Transaction ID” is


1

7

2 34 5

5

43

2

1

6

7

known type the “Transaction ID” in the designated field and click on “Search” . To send a

new request you can either click on the button “Clear” or on “Query Transaction Status”

Figure 31 – Search Result – Query Transaction StatusExplanation of the shown fields for CLI and CPS transactions:

For CLI Transaction

Field Description Example(s)

Service Type Service Type CLI

Line ID Line ID 1

Transaction ID Transaction ID 201012292


CLI Type Cli Type – Not available Blank or 00


561Please note: Only Transaction IDs generated by the Cocom Web Manager (Reference ID

Web Manager) can be requested and are displayed in this report.

For CLI Transaction

Field Description Example(s)

CLI TypeText Explanation for CliType – Not

available

Blank or Unknown

Action Activity ADD CLI, REMOVE CLI

Switch Profile Switch profile STD, SC, CS

Colt Response Date Date and time when the

response is processed by Colt

2006.01.19-19:23:46

Colt Response Code Cocom Error Code - refer to

APPENDIX C Colt Response

and reason codes

0

Colt Response Text Cocom Error Text - refer to

APPENDIX C Colt Response

and reason codes

OK


For CPS TransactionField Description Example(s)Service Type Service Type CPS

Transaction ID The Transaction ID 201012293

Request ID Line ID 1


Action Activity ADD CPS

Colt Response Date Date and time when the response is

processed by Colt

2006.01.19-19:23:46

Colt Response

Code

Cocom Error Code - refer to APPENDIX

C Colt Response and reason codes

0

Colt Response Text Cocom Error Text - refer to APPENDIX

C Colt Response and reason codes

OK

CPS Level CPS Level defines the calls which are

allowed:

Loc+dist – Local and Distance (CPS_5)Loc or dist- Local or Distance (CPS_4)Loc – Local (CPS_2)


CPS_5

CPS Status The status of the CPS -1 Pending/ Status

Update from PTT or

1 CPS Request failed

at Cocom Level or

0 For Success

Switch Over Date The Date on which the service is/will be

installed

2006.01.24-00:00:00

Operator Return

Code

Error Code returned from PTT – refer to

APPENDIX D Error Codes from PTT

(DTAG)


For CPS TransactionField Description Example(s)Operator Return

Message

Error Code returned from PTT – refer to

APPENDIX D Error Codes from PTT

(DTAG)

Cease NTF Number Left blank.


2.8.3 CLI Reports

Click on “CLI Reports” to request detailed information about CLIs dependent on the

activity and the “Response Code” in a defined timeframe.

To select “Start and End Dates,” click on the “Calendar Symbol” and choose the

preferred dates.

Figure 32 – CLI Report Screen

To search for a special activity, select one of the offered actions provided in dropdown.

Menu Description

ADD CLI Activate CLI

Remove CLI Deactivate CLI


1

Please note: All Transactions generated by Web Manager, XML and FTP are shown in this

report.

2 3

Please note: Start and End Date are mandatory for this request. The maximum number of

days between Start and End can’t be more than 30 days, because of performance reasons.

4

4

76

5

32

1

Change CLI Change CLI – (for suspend transactions)

Transfer CLI Modify CLI – not available for every

Reseller

To search for a special response code click on the menu “Response Code” and select

one of the following codes provided in dropdown and click on the “Search” button. Click

on the button “Clear” to delete your input.

Menu DescriptionSuccess COLT Response Code 0

Warning COLT Response Code 2 or 8

Error COLT Response Code 16

Figure 33 – CLI Report Response code features

The figure below shows the search result for a “CLI Report”. The first line of the “CLI Report

Results” list shows the number of found items and which of them are shown on the

actual page. The right end of this line offers you the possibility to go to a specific page. You

can select a special page number or choose the ”First” or “Last” page as well as the

”Previous” or the “Next” page.


5 67

1 2 34 5

5

Figure 34 – CLI Report resultClicking on the headline (e.g. CLI) enables you to sort the listing for the selected

feature.

At the end of the web page an export option (Export to Excel) is offered. You can export

the whole search result into Excel.

The MS Excel file will include the listed information you see on screen and some additional

fields (e.g. CPS Level, CPS Status, and Colt Reason Code).

2.8.4 CPS Reports

Click on “CPS Reports” to request detailed information about CPS in a defined time

frame. Additionally it is possible to search on activity or CPS status in this time frame.


6

7

Please note: It is recommended to export the search result into excel if the result is spread

over several pages and you want sort the complete list for a specific parameter. It is

recommended to save the excel file first and open it again to use the full functionality in MS

Excel.

1

7

6

54 321

To select “Start and End Date” click on the ”Calendar Symbol” and choose the

preferred date. Under “Action” dropdown you can only choose “Add CPS”.

Figure 35 – CPS Report Screen


2 34

Please note: Start and End Date are mandatory for this request. The maximum number of

days between Start and End can’t be more than 30 days, because of performance reasons.

1 2 3

4

6 7

Click on the button “Search” to search for all activities and all CPS status in the specified time frame. Click on the button “Clear” to delete your input.

Figure 36 – CPS Report CPS Status features

The figure “CPS Report Result” below shows the search result for a CPS report. The first

line of the Reports list shows the number of found items and which of them are shown on the

actual page. The right end of this line offers you the possibility to a specific page. You can

select a special page number or choose the ”First” or “Last” page as well as the ”Previous”

or the “Next” page.

The line CPS Status shows the same information as response code, which is the “Response

Code” from Colt.

Figure 37 – CPS Report Result Screen

Clicking on the headline (e.g. CLI) you can sort the listing for the selected feature. The

sorting functionality for the web presentation allows only sorting per web page.

At the end of the web page an export option is offered. You can export the whole search

result into Excel . The Excel file will include the listed information and some additional

fields (e.g. CPS Level, Address information, Colt Reason Code).


6 7

Please note: CPS Status menu is not relevant for Germany as information about the CPS is

send in the operator error code and operator error text by DTAG. Please refer to the CPS

Report to see the relevant information.

2

3

5

Figure 38 – CPS Report Result Screen ( Status Update Message)The following features are shown on the Web page:

Line ID

Transaction ID

Reference Information

CLI

Action

Response Code

Response Text

Response Date

Switch Over Date

CPS Status

Operator Error Code1

Operator Error Text1


Please note: It is recommended to export the search result into excel if the result is spread

over several pages and you want sort the complete list for a specific parameter. It is

recommended to save the excel file first and open it again to use the full functionality in MS

Excel.

Please note: In case of any technical error message/response, Customer is advised to contact

Colt.

Possible Reference Information:-

Reference Information Description

WebManager Transaction send via Cocom Web Manager

Online Transaction send via XML Interface

request/abc0000055.req Transaction send via FTP

2.9 CDR Delivery

On the Welcome page you can see the menu item “CDR” and placing the mouse over each

menu will display the sub menu item “CDR download”.

CDR delivery allows to download unrated CDRs from Cocom Web Manager which will be

delivered twice a day by default.

The following sections describe the CDR delivery functionality in more detail, including:

CDR File Delivery and Naming Convention

Select Reseller Profile for CDR Download

CDR Search

CDR Download

Consolidated CDRs

2.9.1 CDR File Delivery and Naming Convention

Twice a day, every day of the week, Colt will deposit a file of unrated Call Detail Records

(CDR) onto Cocom Web Manager. This will contain all of the unrated CDRs collected by the

Colt network since the last file, typically each 12 hours.


Please note: In case of order delayed response, customer will get the update along with new

message with the new date of order delivery. Once the order is completed, customer will get

the order completion message.

Please Note: The First CDR file will appear in Cocom Web Manager after the first call

has been made.

The unrated CDRs will be delivered 2 working days after the call has been made.

Files transferred to and from Colt are all uniquely identified and adhere to the following file

format

<countrycode>_<profile>_<productidentifier>_<sequence no>_<date>.cdr.gz

Where:

<countrycode> in ISO 2 character format, note GB to be used

<profile> is up to 5 alphanumerics and is the applicable profile for the product

<productidentifier> is the product identifier (1-2 alphanumerics) – see table below

<sequence no> is a rolling four digit sequence per <profile>_<product> combination

<date> is YYYYMMDDHHmmss

cdr.gz is where the file is zipped

Product Identifier Colt Product Name01 Reseller Connect

10 SIP Trunking

12 IN for Resellers

13 Carrier VoIP

14 Reseller VoIP Connect

The CDR files are provided in a pre-defined fixed length format, independent of country and

product. These files are detailed in Appendix.

Select Profile for CDR Download

Go to “CDR” at the top navigation bar and subsequently click on “CDR Download”

the below screen will appear. After clicking on the “Search Profile” button without typing

a search term, an overview of your existing products and profiles will be displayed .

You can search for CDRs for a particular account profile or service profile by typing

the profile and click on the “Search Profile” button. Then click on the arrow on the right hand

side under Search.


1 23 45 6

Figure 39 Search Profile ScreenAfter clicking on “Arrow” button, a CDR Search page will be displayed.


1

2

3

4

5

6

2.9.2 CDR Search

Figure 40 CDR Search ScreenIn the headline , you can see the product and profile which you have just chosen

Unrated CDRs will be delivered on Cocom two days after the call has been made.

The number of CDR-files will be restricted to your defined time frame. To display the CDR-

files enter a start date in the “From” field and an end date in the “To” field. Enter the

date in the format: DD/MM/YYYY, or alternative click on the “Calendar Symbol” to select the

preferred date for each profile you can see the corresponding OCN and BCN – note these

values are not editable in Cocom Web Manager. .

Now click on the “Search” button to search for all unrated CDRs in the specified time

frame or click on the “Clear” button to clear all entered fields.


1

2 3

67

Please Note: Only the last 90 calendar days of unrated CDRs are available for download.

1

2 3

4 5

6 7

2.9.3 CDR Download

After Clicking on “Search” button, a CDR list will be displayed as shown in the below

screenshot. The result will be displayed according to Product and Profile. File displayed will

be in the standard format with the file size and CDR date and time stamps.

Figure 41 CDR List Screen

Select a specific CDR file and click on “Download CDR” .


1

1

Figure 42 CDR Download Screen


After clicking on the required link, you will be shown a save dialog box as shown in above

screenshot.

You will be asked to either “Open" / “Save” the file or “Cancel” the download. Select the

appropriate function.

Only CDRs from the last 90 days will be available.

2.9.4 CDR File Format:

All your CDR files in your reseller domain will be either zipped or plain CDR format. This has

been setup based on your input to the Reseller setup form. We recommend you select

zipped CDRs to ensure CDR download is completed efficiently.

2.9.5 Consolidated CDR Request

This feature enables you to place a request for a consolidated CDR file through Cocom Web

Manager. Up to 90 days of CDRs can be requested, e.g. a consolidated file of a week's

worth of CDRs.

Click on “CDR” and on the left side of the screen select “Consolidated CDR Request”.

Search for the specific Profile.


Please note: The extension .cdr may be used by other application like Corel draw and

therefore may open automatically the file. Please use the function “open with” to open it

with an editor in the CSV-Format

12

Figure 43: Consolidated CDR request - Select profile


Please Note: When you wish to consolidate unrated CDRs, these CDRs will be

delivered to Cocom Web Manager & FTP in a compressed/zipped format. If your

twice daily CDR files are already over 5MB in size, then please allow time to

download a consolidated file from Cocom Web Manager or you may find it easier to

download files greater than 5MB directly from Cocom FTP.

1

2

Figure 44: Consolidated CDR Request

Select Start (From) and End (To) date by clicking on the calendar Symbol and

choose the preferred date. Click on the Button “Consolidated CDR”

Your Consolidated CDR request will be processed. A transaction ID will be displayed to

the user, along with a message “Consolidated CDR file “ <profile><transactionID>.cdr.zip”

will be ready for download within the next 2 hours.”


3 4 5

6

3 4

5

Figure 45: Consolidated CDR Request: Transaction Result

2.9.6 Consolidated CDR Search

Click on “Search Consolidated CDR” link from left menu bar to reach to following page.

You can then input the transaction id for your Consolidated CDR file and click on search

button .

Figure 46: Consolidated CDR Search


789

6

7

8 9

If you do not enter a Transaction ID at all and leave this blank, all successfully processed

transactions for the last 5 calendar days will be displayed for the selected service profile.

Please note if you enter part of the transaction ID, a “No result found” message will be

displayed.

2.9.7 Consolidated CDR Download

After Clicking on “Search” button, a Consolidated CDR list will be displayed as shown

in the screenshot below. The result will be displayed according to the Product and Profile.

The File displayed will be in the standard format with the file size and CDR date and time

stamp.

If the file is not present for a specific transaction ID search, it will display following error

message “No data available for selected time range”.

If the transaction ID is incorrect or invalid, the a “No Result found” message will be shown.

Figure 47: Consolidated CDR Download (1)

Select a specific Consolidated CDR file and click on “Download Consolidated CDR”


9

10

10

Figure 48: Consolidated CDR Download (2)

2.9.8 Consolidated CDR File Format:

All Consolidated CDR files delivered to Cocom Web Manager and FTP have a filename in

the following format:-

<profile><transactionID>.cdr.zip.

Where:

<profile> is up to 5 alphanumeric and is the applicable profile for the product <transactionID> is the combination of date and unique number, this can be

used in Cocom Web Manager to search for Consolidated CDR .cdr is the extension .zip is where the file is zipped

Example: AM220120110182.cdr.zip

The content of the consolidated CDR file is the same as the standard twice daily delivered

CDRs, as described in Appendix A.


2.10View Reseller Data

Click on ”View Reseller Data” Sub menu link under “Maintain Accounts” main menu to view

your Reseller data. This will provide you with the following information:

Your Reseller Domain name

Your Reseller Domain ID

Your ColtOnline username(s)

Your customer numbers (OCNs)

Your Legal customer name

Country

Product

Billing Account (BCN)

Account Profile

Service Profile

Access Type e.g. FTP / WM / XML

The details you can view relate to your Reseller Domain and your view will be restricted

based on your user role and permissions.

As a Customer Administrator you can see this information only for your own reseller domain

and if you have requested a user to be set up they may see a restricted set of data within

your reseller domain, as defined by you.

After clicking “View Reseller Data” the following screen will be displayed.


Figure 49 View Reseller DataEnter text or select the required search criteria and click on the “Search” button, and the

corresponding data will be displayed . ”Clear” will clear all data in the search criteria fields.

You will see a link to username details – these are your user contact details held in

ColtOnline. Under the Address link you will see the legal company details we have on

record.


Please note: This reseller data can be exported and saved as MS Excel, which may

prove useful for you, if you wish to clarify what your users can access, or if you wish to

have a record of profiles required for future product orders.

2.11Documents

In Cocom Web Manager you can find all product related documentation for your Colt

Reseller and Carrier Voice products.

This includes product user guides, VPN access software and instructions and the CLI / CPS

macros referred to earlier in this user guide.

Under the Help function you can access the latest version of all Colt documents.

2.11.1 User Guides

After clicking on “User Guides” from “Help” Tab Menu, the below page will appear

and you can download the FTP or Web Manager user guides from the link and the CLI /

CPS macros referred to in earlier sections of this document .

Figure 50 User Guides Screen

2.11.2 VPN Access

The Cocom server currently supports FTP access to dedicated and protected directories that

have been created specifically for your business. Access to the server is via a dedicated

VPN client, provided by Colt. These methods are detailed in separate documents, which you

can download in the “Help” menu.

Click “VPN Access” Sub menu link under “Help” and from here you can download the

files and related user guides.


2 1 3

1 2

1

3

2

Figure 51 – Help – VPN Access Screen

2.12Cocom Web Manager Exit

Users can logout from Cocom Web Manager by clicking on the Logout link on Cocom

Web Manager. The user will be then logged out in both systems: Cocom Web Manager and

Colt Online. You can close the Browser window after logging out.

Figure 52 – Web Manager Exit Page


1

1

2

1

3 Maintenance and Support

The Cocom B2B Gateway Server is available 24 x 7 x 365.

Should we need to temporarily suspend access to the server, for planned maintenance, you

will be notified at least 10 days in advance and be told how long it will be suspended for.

Generally, this is an unusual occurrence (approximately once a month) and service

interruptions are brief.

Customer Service is available during normal office hours, from Monday to Friday

except during Public Holidays.


4 Glossary

Term DescriptionB2B Business to Business:

typically takes the form of automated processes between trading partners and is

performed in much higher volumes than business-to-consumer (B2C) applications.

CDR Call Detail Record. A record that contains the details of a call made on the Colt

network. Normally used for end-customer billing purposes. Typically this will be

unrated, i.e. contains no charges but indicates the service used during the call and the

tariff band(s) that apply. If the CDR is rated, then it will include the charge due for the

call.

CLI Calling Line Identifier. A term used within Colt to mean an end-customer telephone

number such as a Directory number.

Cocom Colt Communications server. The FTP server and internal applications that provide a

file level interface allowing Resellers to request bulk activation and deactivation of CLIs

and CPS services.

CPS Carrier Pre-Selection.

CSV Character Separated Values or

Comma Separated Values:

file format is a tabular data format that has fields separated by the comma character

and quoted by the double quote character. If a field’s value contains a double quote

character it is escaped with a pair of double quote characters.

The CSV file format does not require a specific character encoding, byte order or line

terminator format.

FTP File Transfer Protocol:

is a software standard for transferring computer files between machines with widely

different operating systems. It belongs to the application layer of the Internet protocol

suite.

DE Germany


Term DescriptionHTML Hyper Text Mark up Language:

is a markup language designed for the creation of web pages and other information

viewable in a browser. HTML is used to structure information -denoting certain text as

headings, paragraphs, lists etc.- and can be used to define the semantics of a

document

HTTP HyperText Transfer Protocol):

is the primary method used to convey information on the World Wide Web. The original

purpose was to provide a way to publish and receive HTML pages. The default TCP

port of HTTP is 80.

HTTPS HyperText Transfer Protocol Secure:

is the secure version of HTTP, the communication protocol of the World Wide Web. It

was invented by Netscape Communications Corporation to provide authentication and

encrypted communication and is used in electronic commerce.

Instead of using plain text socket communication, HTTPS encrypts the session data

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.

PTT Public Telegraph Telephony [operator]:

Any fixed-line network operator but typically the major incumbent operator within the

country. Colt deals with the following operators: France Telecom (France), Deutsche

Telekom (Germany), British Telecom (UK), Telia (Sweden), KPN (Netherlands),

Belgacom (Belgium), Austria Telekom (Austria), Telecom Italia (Italy), Eircom (Ireland),

Portugal PTT (Portugal), Telefonica (Spain), Teledenmark (Denmark). Swisscom

(Switzerland).

SMTP Simple Mail Transfer Protocol:

is a relatively simple, text-based protocol, where one or more recipients of a message

are specified (and in most cases verified to exist). The message text is transferred to

the specified recipients.

SMTP uses TCP port 25.


Term DescriptionURL Uniform Resource Locator:

or Web address, is a standardized address name layout for resources (such as

documents or images) on the Internet (or elsewhere). First created by Tim Berners-Lee

for use on the World Wide Web, the currently used forms are detailed by Internet

standard RFC 1738.

WWW World Wide Web:

is an information space in which the items of interest, referred to as resources, are

identified by global identifiers called Uniform Resource Identifiers (URLs). The term is

often mistakenly used as a synonym for the Internet, but the Web is actually a service

that operates over the Internet.

XML eXtensible Mark up Language:

is a W3C-recommended general-purpose markup language for creating special-

purpose markup languages. It is a simplified subset of SGML, capable of describing

many different kinds of data. Its primary purpose is to facilitate the sharing of data

across different systems, particularly systems connected via the Internet.


APPENDIX A Call Data Record Format

The CDR file contains only CDR records in a fixed length format. A CDR file is made

available twice per day – once in the morning and once in the afternoon. The files are

delivered at approximately 9AM and 5PM CET.

The 9 AM CET file contains calls from 4PM CET the previous day until 8AM CET on the

current day

The 5 PM CET file contains calls from 8AM CET to 4PM CET on the current day

Please note that CDR files are delivered to your directory 7 days a week and will vary in size

depending on the level of traffic that your customers generate.

A.1 CDR File Format

A.1.1 Character Coding

ASCII

A.1.2 File Mark-up Coding

No structured Mark-Up used

Fixed length records

Fixed length fields, space filled

A.1.3 Compression/Decompression Algorithms

CDR files are delivered in Zip format (Unix GZip, MS Windows Zip). However, Colt

recognizes that this can be difficult for certain companies to receive and the CDR files can

be delivered in plain text if required. Please notify Colt Customer Services if you need the

CDR files to be delivered as plain text (Uncompressed) files.

A.1.4 File Name

All unrated CDR files delivered to Cocom Web Manager and FTP have a filename in the

following format:-


<countrycode>_<profile>_<productidentifier>_<sequence no>_<date>.cdr.gz

Where:

<countrycode> in ISO 2 character format, note GB is used

<profile> is up to 5 alphanumerics and is the applicable profile for the product

<productidentifier> is the product identifier (1-2 alphanumerics) – see table below

<sequence no> is a rolling four digit sequence per <profile>_<product> combination

<date> is YYYYMMDDHHmmss

.cdr is the extension

.gz is where the file is zipped

Product Identifier Product name01 Reseller Connect

00 Voice Line

10 SIP Trunking

11 IP Voice Line

12 IN for Resellers

13 Carrier VoIP

14 Reseller VoIP Connect

Example: de_abc_01_0001_20101208090122.cdr.gz

A.2 Call Detail Record Format

The data lines are 229 bytes in length and organised as:

Ref NameBytes/Length

PositionAlpha/Numeric

Format &Description

1 Origin 20 1 N

Originating CLI with leading 0. Filler

spaces must be added to fill in the

spaces designated for a field.

2

Destination

(Terminating

)

20 21 NDestination 0 = Domestic and National,

Destination 00 = International

3 Product Type 2 41 N ‘01’=Indirect Service


4 Date 8 43 N YYYYMMDD

5 Time 8 51 N

HHMMSSss . Time duration is broken

up into tenths of a second. Fractions of

a second will be ignored.

6 Duration 8 59 NDuration of the call to the nearest 1/10th

of a second SSSSSSSs

7 Continuation 1 67 N

‘0’, ‘1’, ‘2’, ‘3’ or ‘5’ – normally a 0; will

be ignored for our purposes. To be

used only if calls are greater than 6

hours

8 Switch ID 25 68 N Unique switch identifier

9Trunk

incoming25 93 N Internal use only

10Trunk

outgoing25 118 N Internal use only

11Account

Code20 143 A Not in use

12 Pulses in 6 163 N Not in use

13Pulses

generated6 169 N Not in use

14 Pulses sent 6 175 N Not in use

15Service

Indicator4 181 N

0000 for standard calls, 0001 for ISDN

calls

16Charged (C-

Num)20 185 N Not in use

17Dialled (D-

Num)20 205 N Not in use

18 Carrier 3 225 AThe Reseller profile of up to 3

alphanumerics

19End of

Record1 228 A Value of zero is shown

20 Line Feed 1 229

ASCII

Control

Character

Line Feed (ASCII Control Character not

visible in plain text editors



Please note: There is an ASCII Control Character (Line Feed, HEX 0A) after the last field

19 “End of record”. This Control character generates a new line for the next CDR and

shows that the actual CDR ends. Normally you can ignore this control character except

you use a HEX-Editor to process your CDRs.

.

Please note: In Germany, the header and trailer records will no longer appear in the

unrated CDR file. They will appear as a single file in the “jobout” FTP-folder

A.3 Sample Call Detail Record

06960621234 069566061234012011011911481500000000401 00067

6960621234 0000 069566061234AAX0

06960621234 017622211234012011011911514400000008401 00067

6960621234 0000 017622211234AAX0

APPENDIX B CSV-File Format for Bulk Uploads

You can download the Cocom FTP User Guide for a detailed description of the Format

under the “Help” main menu function. Alternatively you can use the CLI & CPS macros

which can be downloaded from the Help menu – User Guides.

B.1 Header Record

There should be one header record for the file.

Ref

Identifier/ Field Name

Data Type MaxLength

M/O Default Field Description / Notes

1 Header Id Alphanum

eric

1 Mandat

ory

H Must equal

character “H”

(without quotes)

2 Format

Description

Alphanum

eric

35 Optiona

l

none Free format text for

information only.

For example “CLI

Requests”


Ref

Identifier/ Field Name

Data Type MaxLength


3 Version Alphanum

eric

6 Mandat

ory

0.01.1 File Format

Version. This is a

required value and

should be the

default value

unless otherwise

instructed by Colt

4 Creation

Date

Timestam

p

17 Mandat

ory

Current Date

in format

YYYYMMD

D-hh:mm:ss

Example:

20040430-

13:42:27

Current Date in

format

YYYYMMDD-

hh:mm:ss

B.2 Detail Records

CLI-only Detail RecordsThere can be up to 500 detail lines per Request file.

Ref Identifier/ Field Name

Data Type

MaxLength

M/O Default

Field Description / Notes

1 Data Record

Identifier

Alpha 1 Mandator

y

D Must be character “D” (without

quotes)


Please note: Each field must be delimited by a semi-colon (;) and the line should end

with a semi-colon.


Data Type

MaxLength

M/O Default


2 Request

Number

Intege

r

Variable Mandator

y

None Record number

Starting at 1, increase by 1 with a

maximum of 500. No gaps or

duplicates allowed.

The sequence is Reseller-

maintained.

3 CLI Numer

ic

5-22 Mandator

y

None Telephone number

Because CLIs can only be

activated with the leading area

code the CLI has to begin with a

leading 0. If there is no leading

zero it will be added by Colt.

4 Action Alpha 1 Mandator

y

None Request Type CLI:

A = Add to Switch

D = Deactivate on Switch

M = Modify on Switch

Only customer with ‘modify’-

authorisation are allowed to use

the ’modify CLI’ transaction.

To prevent customers for

unauthorised use of the ’modify

CLI’ transaction, they must

request an ’activate CLI’ first.

5 Job date Alpha

numer

ic

17 Mandator

y

None Current Date in format

YYYYMMDD-hh:mm:ss

Example:

20041015-13:42:27

6 Not used Blank

7 Not used Blank

8 Not used Blank



Data Type

MaxLength

M/O Default


9 Not used Blank

10 Not used Blank

11 Not used Blank

12 Not used Blank

13 Not used Blank

14 Not used Blank

15 Not used Blank

16 Not used Blank

17 Not used Blank

CPS and CLI/CPS Detail RecordsThere can be up to 500 detail lines per Request file.


Data Type

MaxLength


1 Data

Record

Identifier

Alpha 1 Mandatory D Must be character “D” (without

quotes)

2 Request

Number

Integer Variab

le

Mandatory None Record number

Starting at 1, increase by 1

with a maximum of 500. No

gaps or duplicates allowed.

The sequence is Reseller-

maintained.


Please note: Each field must be delimited by a semi-colon (;) and the line should end with

a semi-colon. Although fields 6-17 are not currently used, they need to appear in the

request by including the semi-colon that indicates the end of the field. Please see for a

sample Request file.


Data Type

MaxLength


3 CLI Numeric 5-22 Mandatory None Telephone number

Because CLIs can only be

activated with the leading area

code the CLI has to begin with

a leading 0. If there is no

leading zero it will be added

by Colt.

CLIs with the following

prefixes cannot be used in

CPS requests:

00 01 0190 0800 0900Due to changes to Cocom only “Stamm-Nr” is allowed here, independently of how many CLI blocks were activated by Colt. The “Stamm-Nr” needs to be a valid DTAG number. It is not possible to send smaller parts of a range or a single Number out of a range to DTAG as it would be rejected (RNG). A CPS request with part of the range will lead to a best match conflict and not sent to DTAG.

4 Action Alpha 1 Mandatory None Request Type CPS only &

CLI/CPS:

C = Add to Switch and

Activate Pre-selection

Note D is not allowed.



Data Type

MaxLength


5 Job date Timestamp 17 Mandatory None Current Date in format

YYYYMMDD-hh:mm:ss

Example:

20041015-13:42:27

6 Customer

Request

Date

Numeric 8 Mandatory YYYYMM

DD

Deutsche Telekom accepts a

Preferred Date of

Implementation

Format = YYYYMMDD

Minimum timeframe is three

working days..

7 CPS Level Alphanum

eric

5 Mandatory None The type of CPS service

required.

For both CPS-only and

CLI/CPS requests:

Mandatory”

CPS_5 – Local and distance (bundle)

CPS_4 – Local or Distance (DTAG activate either local or distance or both, depending on which value is not active)

CPS_3 – Distance CPS_2 – Local

8 Area Code Numeric 6 Mandatory None City code with a leading zero

9 Caller

Number

Numeric 9 Mandatory None Telephone number without

extension



Data Type

MaxLength


10 Range Start Numeric 6 Optional None Only required when a block of

contiguous caller numbers is

passed to DTAG.

The number of digits entered

for Range Start and Range

End must be identical,

otherwise the request will be

rejected by Cocom as the

range information is not

properly validated. E.g.

Valid combination: Range start: 00, Range End: 99.

Invalid combination: Range Start: 0, Range End: 99.

Partial range combinations are allowed, e.g. 00-09 or 10-19 or 20-29 or 90-99

Notes: Ranges apply to CPS-

only requests. There is no

range feature associated with

CLIs.

The “Stamm-Nr” needs to be

known by DTAG.

If specifying a range, the

Internal Switchboard value

must be provided.

11 Range End Numeric 6 Optional None Please refer to rule in Range

Start field description.

12 Internal

Switchboar

d

Numeric 6 Optional None Required if specifying a

number range for a CPS

request submission.

Numeric value with one digit.



Data Type

MaxLength


13 First name Alphanum

eric

30 Optional None For residential subscribers this

field is mandatory or the order

will be rejected by DTAG.

In the case of a Corporate

customer this field should be

blank.

14 Party Name Alphanum

eric

60 Mandatory None Customer Name

Either:

Company name Surname for a private

customer.15 Street Alphanum

eric

40 Mandatory None Street number or PO Box

number

16 Building

Number

Alphanum

eric

10 Mandatory None Building Number

17 Postal

Code

Alphanum

eric

10 Mandatory None Postal code

18 City Alphanum

eric

40 Mandatory None City or Town

19 Country Alpha 2 Optional None Country using the ISO-3166

code. E.g. DE

20 Appointmen

t Timeslot

Numeric 1 Optional None Possible values are ‘7’ or ‘9’.Enter “9” for 0800-1200

CET(Mon-Sat)

Enter “7” for 1200-1600

CET(Mon-Fri)

Default value is “9”

If the customer request date is

a Saturday, select “9“ for

timeslot: 0800-1200 CET


Trailer Record


MaxLength

M/O Field Description / Notes

1 Trailer Id 1Mandat

ory

T for Trailer

Must be first field on last line in file

2

Number of

Records in

this block

3Optiona

lMaintained by Reseller

3 Checksum 10Optiona

l

Value generated running Unix checksum on this

block’s data records. By default no checksum is

performed and the field is empty

Request File ExamplesCLI-only request message exampleThis is from a German (DE) Reseller AAX to Deactivate CLI 02451910984 and to Activate

CLIs 02451901509 and 02451904415.

H;CLI Requests;0.01.1;20041015-09:50:28;D;1;02451910984;D;20041015-09:50:28;;;;;;;;;;;;;D;2;02451901509;A;20041015-09:50:28;;;;;;;;;;;;;D;3;02451904415;A;20041015-09:50:28;;;;;;;;;;;;;T;3;;

CPS-only request message exampleThis is from a German (DE) Reseller AAX to Activate CPS on CLIs 02151761585 and

02161307496.



with a semi-colon.


with a semi-colon.

H;CPS Only Request;0.01.1;20041015-15:08:27;D;1;02151761585;C;20041015-15:08:27;20041019;CPS_5;02151;761585;;;;Werner;Brunn;Ferd-Scholling Ring;17;60283; Mönchengladbach; DE;9;D;2;02161307496;C;20041015-15:08:27;20041022;CPS_3;02161;307496;;;;Josef;Meyer;Taunusblick;32;60338;Mönchengladbach;DE;7;D;3;089480050;C;20041015-15:08:27;20041022;CPS_3;089;480050;;;;;Paulaner Brauerei GmbH & Co. KG;Hochstrasse;75;D-81541;München; DE;9;T;3;;

CLI/CPS Request message exampleThis is from a German (DE) Reseller AAX to activate three CLIs and to activate CPS on the

CLIs.

H;CLI/CPS Request;0.01.1;20041018-10:50:13;D;1;069520522;C;20041018-15:08:27;20041022;CPS_4;069;520522;;;;;Wäldches Wirtshaus & Brauerei;Am Ginnheimer Wäldchen;8;60431;Frankfurt; DE;9;D;2;069288662;C;20041018-15:08:27;20041027;CPS_4;069;288662;;;;;Erste Frankfurter Hausbrauerei Zwölf Apostel;Rosenberger Straße;1;60313;Frankfurt; DE;9;D;3;069412890;C;20041018-15:08:27;20041022;CPS_3;069;412890;;;;Werner;Stohl;Hanauer Landstraße;568;60386;Frankfurt;DE;7;T;3;;

APPENDIX C Colt response and Reason codes

Colt Response Code

Colt Response Text

Reason Code

Description Explanation

0

ok 0 or 1

Comment:

Activated for

Action Change

The requested action has been

successfully completed

Ok CPS

pending100

CLI activation has been successfully

completed, CPS request is pending


Colt Response Code

Colt Response Text

Reason Code


-1Status

Update

CPS

CLI/CPS

Interim response sent by Deutsche

Telekom, no action required by you.

1 Data out of range

CLI is invalid.

The format of CLI is invalid. CLI must

be a number (min 5 digits, max 22

digits)

Action is

invalid.

Invalid Action for provisioning was

requested (only A, D, M, are

allowed)

Job Date is

invalid.

The date format is wrong.

Customer

Request Date

is Invalid.

Possible Causes of Error – Wrong

Data Format supplied for Carrier

Preselection. Correct Format:

YYYYMMDD.

CPS Level is

Invalid

CPS Level is wrongly specified.

Possible values CPS_2,

CPS_3,CPS_4,CPS_5.

Invalid area

Code

Area Code is missing or invalid

Invalid Caller

Number

Caller Number missing or invalid

Range Start is

invalid

Range Start is invalid

Range End is

invalid

Range end is invalid

PartyName is

Invalid

Missing Party name

Street is

invalid

Missing a value for Street


Colt Response Code

Colt Response Text

Reason Code


Building

Number is

invalid

Building number is missing or invalid

Postal Code is

invalid

Missing a value for Postal Code field

City is invalid Missing a value for City field

cannot

suspend CLI

<cli> - service

already

suspended

The CLI which should be suspended

is already suspended.

cannot

unsuspend

CLI <cli> -

service not

suspended

The CLI which should be

unsuspended is not suspended.

2 object

already

exists

101

CPS Pending,

object already

exists

CLI is already active, however CPS

is pending

1110 best match

conflict with cli

<cli>

There is a best match conflict, which

can happen if a CLI is provisioned or

deprovisioned which is part of a stub


Colt Response Code

Colt Response Text

Reason Code


1111direct conflict

with cli <cli>

The CLI is already provisioned and

has been tried to be provisioned

again. The request has been

submitted for a range of CLIs. The

CLI this response relates to is

already active on the switch. The

CPS request is proceeding normally.

You will probably get a response for

each CLI in the range.

If this is a single occurrence in the

range investigation is required.

1210CLI <cli>

already active

The CLI has been already activated

on the switch

1211CLI already

active

The CLI has been already activated

on the switch

1213cli is already

activated

A CLI activation has already been

send and is now in process

1214

cli already

activated by

modify

A modify command will automatically

activate the CLI if not already active.

1250

Account of cli

has been

modified

Will be sent if and only if there is a

pending modify request on the cli the

Reseller requested a deactivate for

AND the modify has been issued by

a different Reseller

1251 original

account for cli

has changed

Will be sent if and only if there is a

pending modify request on the cli the

Reseller requested to activate for.


Colt Response Code

Colt Response Text

Reason Code


1260

Could not

process

current

request -

Pending CPS

request

Will be sent in case the Reseller

requests any action on a CLI while

there is a CPS request that is either

still pending in Cocom which was

sent in the last 7 days OR no final

response has been received from

the PTT. More information provided

below this table.

8100

Account

<account>

cannot modify

its own CLI

Reseller has tried to modify a CLI

which has already been assigned to

him

8101

The target

account must

be different

from the

original

account

Will only be seen by Colt. It indicates

that CS has attempted to transfer a

CLI to a reseller who already owns

the CLI. The message that would be

delivered to a reseller in that case

would be “2 object already exists

account <account id> cannot modify

its own CLI”

8 object does

not exist

These error messages can only

occur for deactivation requests

This message without any other

comment will be shown for a

suspend command which has been

send during a previous suspend

command which is already

processing

1250 Account of cli

has been

modified


Colt Response Code

Colt Response Text

Reason Code


1305

Cannot

suspend

unknown CLI

<cli>

CLI is not activated on the switch

1306

Cannot

unsuspend

unknown CLI

<cli>

CLI is not activated on the switch

7021range not

available

7901

No CPS found

for action

DEACTIVATE

8000

Account

<account>

does not exist.

8110 Account

<account>

cannot submit

CPS requests

for CLI of

another

account (best

match)


Colt Response Code

Colt Response Text

Reason Code


8111

Account

<account>

cannot submit

CPS requests

for CLI of

another

account (direct

conflict)

8112

Account

<account>

cannot

deactivate cli

of another

account

This message will as well be shown

if a CLI of another reseller is

suspended.

16

unknown

error

Reseller has not sufficient rights or

privileges to process the requested

action

CPS already active

If CPS is already active in Cocom

and reseller submits redundant CPS

activate request

LINE_IDXVER

_01/9:CALLE

R ID 0 IS NOT

FOUND::LINE

_IDXVER_01/

12:INVALID

RESELLER

OBJECT

When system finds error in the

switch response

8001 Account is

locked


Colt Response Code

Colt Response Text

Reason Code


8002

account is not

allowed to

activate

8003

account is not

allowed to

deactivate

8004

account is not

allowed to

modify

Account do not have the right for

modifcations

8004

Modify

between Voice

and VoIP not

allowed

Account do not have the right for

modifications between a Voice ID

(Reseller Voice Connect) and VoIP

ID (Reseller VoIP Connet).

8010

account is not

allowed to

perform a

CPS activate

Table - Cocom Validation Codes and Text

Message Message Message Description Explanation


Please note: A CPS request will be successfully validated and sent to DTAG, even if the

CLI was pre-selected successfully in the past. This is due to the fact that CPS deactivation

requests may have been sent direct to DTAG, since the original CPS request.

Code Type0 B2BGateway Success Message/OK

-1 B2BGateway

Unable to process your request

[additional explanation]

Validation Failed, e.g.

Infrastructure Error from

Cocom, missing request file,

wrong characters

0 cocom OK – Success

99 Cocom

Cannot process your request!

Please contact customer service

support!

No connection between B2B

Gateway and Cocom

Table – B2B Gateway error Codes

Error codes from PTT (DTAG)

The following tables are from documents produced by Deutsche Telekom.

A.1.1 Interim status codes

These response codes reflect the interim status from Deutsche Telekom and do not require

any action from you in Cocom.

Error Code Description Explanation

0000 Keine Änderung zum Auftrag Der Auftrag wird regulär weiterbearbeitet.

Kein Handlungsbedarf.



0002 Der Kundenwunschtermin liegt

ausserhalb des betrieblich

möglichen Zeitrahmens oder ist

kein vertraglicher Arbeitstag.

(verbindlicherLiefertermin =

2015-05-21)

Der neue Ausführungstermin kann folgende Gründe

haben:

- Bei DSL: Kundenwunschtermin (KWT)

unterschreitet die Mindestvorlaufzeit gemäß

Dienstvertrag

- Es wurde ein nicht vertraglich vereinbarter

Arbeitstag ausgewählt

- Die Vorlaufzeit bis zur Lieferung ist betrieblich nicht

ausreichend

Der verbindliche Liefertermin wird entsprechend

angepasst und übermittelt.


0003 Telekom hat zum

Kundenwunschtermin keine

ausreichenden Kapazitäten


2015-05-21)

Es liegen keine ausreichenden personellen oder

technischen Ressourcen zum Kundenwunschtermin

(KWT) vor. Daher wird der nächstmögliche Termin

übermittelt.

Das Verhalten ist für Standardaufträge und

Terminverschiebungen identisch.


0005 Der Ausführungstermin wurde

von Telekom manuell geändert


2015-05-21)

Es handelt sich um eine Terminanpassung durch die

Telekom (z.B. im Rahmen eines Projektes). I.d.R.

wird der neue Termin mit dem Provider abgestimmt.

Aufgrund technischer Hindernisse erfolgt eine

manuelle Terminänderung heute auch ohne

Abstimmung mit dem Provider.




0006 Der Auftrag wird teilausgeführt Nur ein Teil der beauftragten Produkte kann

bereitgestellt werden. Die bereitgestellten Produkte

sind Bestandteil der ABM.

Beispiel:

Bestellung von Preselection Ort und Preselection

Fern. Ist das Produkt Preselection Ort mit

„Teilausführung zulassen“ gekennzeichnet, aber

Preselection Ort nicht möglich, wird Preselection Fern

dennoch bereitgestellt. Ist „Teilausführung zulassen“

nicht gekennzeichnet, wird der gesamte Auftrag

abgelehnt.


0070 Der Auftrag wird manuell

bearbeitet. Die Bearbeitungszeit

kann sich daher verlängern.


Table 1 Deutsche Telekom Interim Status Update Result Codes

A.1.2 Positive Result Code


0010 Auftrag ausgeführt Kein Handlungsbedarf.

Table 2 Deutsche Telekom Positive Result Code

A.1.3 Negative Result Codes


1000 ONKZ oder Rufnummer

unbekannt.

Zum Identifikator für die Bestandssuche über die

ONKZ/Rufnummer oder Rechnungsnummer (bei

Anlagenanschlüssen) ist kein Bestand bei der Telekom

vorhanden.



1001 Die Anschrift ist nicht bekannt. Die übermittelte Anschrift wurde überprüft und konnte nicht

eindeutig plausibilisiert werden.

Falls in der ABBM das Meldungsattribut „Standort A korrekt“

befüllt ist, dann validieren Sie bitte die vorgeschlagene

Adresse mit dem Endkunden und senden Sie den Auftrag

erneut.

Ansonsten überprüfen Sie die Adressdaten und senden Sie

den Auftrag erneut.

1002 Straßenname ist unbekannt Der im Standort A übergebene Straßenname ist bei der

Deutschen Telekom nicht referenziert.

1003 Der Kundenwunschtermin liegt

außerhalb des zulässigen

Zeitrahmens.

Sie haben die maximale Vorlaufzeit überschritten.

Bitte geben Sie einen Kundenwunschtermin (KWT) an, der

innerhalb der zulässigen Vorlaufzeit liegt, und stellen Sie

den Auftrag erneut ein.

1004 Es liegt eine Kündigung des

Anschlusses oder eine

Rufnummernänderung am

Anschluss vor.

Der Meldungscode wird nur verwendet wenn der Endkunde

einen Bestand (Rufnummer oder Anschluss) bei der

Telekom unterhält.

ERLM: Der Endkunde hat seinen Telekomanschluss

gekündigt, wodurch die Telekom die Kündigung des DSL

des Providers angestoßen hat. Die Erledigung der DSL-

Kündigung wird über die ERLM mitgeteilt.

ABBM: Der Anschluss, auf den sich der Auftrag bezieht, ist

bereits durch den Endkunden bei der Telekom gekündigt

worden. Der Kündigungsauftrag ist noch nicht ausgeführt.

Der Ausführungstermin der Kündigung liegt zeitlich vor dem

Kundenwunschtermin des Providerauftrags.



1006 Der Auftrag ist derzeit nicht

möglich. Es wurden Änderungen

am Anschluss beauftragt. Das

beauftragte Produkt kann erst

nach Erledigung dieses Auftrags

erteilt werden.

Es ist noch ein offener Auftrag der Telekom zu diesem

Anschluss vorhanden. Ein neuer Auftrag darf frühestens 1

Tag nach dem mitgelieferten Erledigungsdatum des offenen

Auftrags eingestellt werden..

Der MC tritt auch in folgenden Fällen auf:

-die Telekom hat bereits einen Wechselwunsch des

Endkunden zur Telekom erfasst. Bitte reagieren Sie in

diesem Fall auf die Portierungsanzeige beim

Portierungskennungsinhaber. Eine Kündigung ist nicht mehr

notwendig.

- der Endkunde hat bereits bei der Telekom seinen

Anschluss gekündigt, die Kündigung ist noch nicht

ausgeführt, kann aber nicht mehr storniert werden. Bitte

stellen Sie anstelle eines Auftrags mit dem Gf VBL einen

Auftrag mit Gf NEU unter Angabe der Vormieterdaten ein.

Sollte kein offener Auftrag vorliegen, kontaktieren Sie vor

erneutem Einstellen des Auftrags bitte das Clearing-Team.

1007 Bei dem vorliegendem

Geschäftsfall ist das

Änderungskennzeichen für

dieses Produkt nicht zulässig.

Die Änderungskennzeichen „Storno“ und

„Terminverschiebung“ sind vertraglich nicht für diese

Produkt-Geschäftsfall-Kombination vereinbart.

Bitte stellen Sie für den betroffenen Auftrag die vertragliche

Grundlage sicher.

Cancel CPS request is not possible in Cocom

1008 Die bestellte Konfiguration

besteht bereits.

Bitte prüfen Sie Ihre Bestandssituation.

1010 Es ist bereits Bestand des

Auftraggebers vorhanden.

Es liegt eine Beauftragung zu einem bereits bestehenden

Bestand vor.

Möglicherweise ist die angegebene Vertragsnummer nicht

korrekt.



1012 Es liegt bereits ein Auftrag für

diesen Anschluss vor. Ihr

Auftrag kann erst nach

Erledigung des noch offenen

Auftrags erteilt werden.

Es ist noch ein offener Auftrag eines anderen Providers zu

diesem Anschluss vorhanden. Bitte stellen Sie den neuen

Auftrag frühestens 1 Tag nach dem mitgelieferten

Erledigungsdatum des offen Auftrags ein.

Der MC tritt auch auf, wenn ein weiterer

Anbieterwechselauftrag in WITA vorliegt. Bitte beantworten

Sie in diesem Fall zunächst die vorliegende AKM-PV

1013 Externe Auftragsnummer ist

nicht eindeutig oder nicht korrekt

Die externe Auftragsnummer darf nur exklusiv je Auftrag

verwendet werden. Ausgenommen hiervon sind

Stornierungs- und Terminverschiebungsaufträge.

Bitte überprüfen Sie, ob die entsprechende

Auftragsnummer bereits verwendet wurde bzw. ob diese

korrekt ist.

1018 Der Besteller ist nicht berechtigt

für den Kunden zu bestellen

Eine Bestellung im Auftrag Dritter ist nur möglich, wenn

entsprechende Vollmachten dazu vorliegen.

Bitte überprüfen Sie, ob eine Vollmacht vorliegt bzw.

beauftragen Sie die Mandantenfunktion.

Bei AUS-BUE ist die Bestellung im Namen Dritter nicht

vorgesehen.

1020 Das Zeitfenster ist nicht

vereinbart

Es können nur (Sonder-) Zeitfenster gebucht werden, für

die eine Vereinbarung vorliegt.

Bitte überprüfen Sie Ihre vertraglich vereinbarten (Sonder-)

Zeitfenster, und senden Sie den Auftrag erneut

Ab OSS Version 7.00 ist die Angabe des Zeitfensters Pflicht

1021 Der Auftrag wurde nicht korrekt

verarbeitet. Versuchen Sie es zu

einem späteren Zeitpunkt noch

einmal

Der Auftrag ist bei der Bearbeitung in eine Fehlersituation

gelaufen, die sich durch Neuerteilung des Auftrags lösen

lässt.

Stellen Sie den Auftrag am Folgetag erneut ein. Sollte diese

Fehlermeldung dann erneut kommen, kontaktieren Sie bitte

das Clearingteam (Colt Reseller Support).



1023 Ihr Auftrag ist derzeit aus

technischen Gründen nicht

bearbeitbar. Bitte versuchen Sie

es zu einem späteren Zeitpunkt

erneut

Bitte übermitteln Sie den Auftrag zum angegebenen

Wiedervorlagetermin erneut.

Sofern kein Wiedervorlagetermin mitgesendet werden

konnte, stellen Sie den Auftrag frühestens am Folgetag

erneut ein (Empfehlung 3 AT nach Erhalt der ABBM).

1031 Die Anlage enthält einen

maliziösen Code

Die Anlage ist möglicherweise virenbehaftet.

Bitte überprüfen Sie die Anlage auf Viren und übermitteln

Sie den Auftrag inklusive Anhang erneut.

1033 Termin für Anbieterwechsel vor

einem arbeitsfreien Tag ist nicht

möglich

Aufträge im Anbieterwechsel mit Geschäftsfall

Verbundleistung, Providerwechsel und NEU mit

Vorabstimmungs-ID mit einem KWT auf einen Tag vor

einem arbeitsfreien Tag (z.B. Samstag oder Arbeitstag vor

einem Feiertag) werden abgelehnt (gemäß Vorabstimmung

und Spezifikation Anbieterwechsel).

Bitte stellen Sie einen erneuten Auftrag mit einem

korrektem Terminwunsch ein.

1051 Der Auftrag ist bei vorhandener

Bestandssituation nicht möglich

Betrifft Storno und Terminverschiebung:

Ein Storno bzw. eine Terminverschiebung ist erst nach

Versendung einer QEB zum Ursprungsauftrag möglich.

Bitte warten Sie diese ab und senden Sie dann den Storno

bzw. die Terminverschiebung erneut.

Der Ursprungsauftrag konnte nicht gefunden werden.

1086 Kundenauftrag ist nicht

stornierbar, da Stornierung

bereits angestoßen.

Es wurde bereits eine Stornierung eingestellt.



1087 Eine Stornierung ist nicht

möglich.

Der Stornoabbruch kann verschiedene Ursachen haben:

Die Buchung des Ursprungsauftrags ist in den IT-Systemen

der Telekom bereits so weit fortgeschritten, dass keine

Stornierung des Auftrags möglich ist.

Ursprungsauftrag ist bereits abgebrochen: Eine Stornierung

ist bei einem bereits abgebrochenem Auftrag nicht mehr

möglich. Keine Handlungsmöglichkeit.




1089 Der Auftrag wurde bereits

durchgeführt. Eine Stornierung

ist nicht mehr möglich.

Bitte warten Sie die ENTM ab und kündigen Sie dann den

Bestand des entsprechenden Einzelvertrags.

Keine Handlungsmöglichkeit.


1102 Produkt oder Geschäftsfall nicht

zulässig

Bitte wählen Sie ein anderes Produkt, das den vertraglichen

Vereinbarung entspricht, und stellen Sie den Auftrag erneut

ein. Bzw. stellen Sie die vertragliche Grundlage für den

Auftrag sicher. Hierzu kontaktieren Sie bitte den

Carriermanager.

Im GF AUS-BUE: Bitte wählen Sie einen anderen

Dienstvertrag/ Leistungsnummer, da die gewählte

Leistungsnummer nicht vereinbarte Produkte für diesen GF

beinhaltet.

1193 Der juristische Nachfolger (Erbe)

kündigt das Vertragsverhältnis

Der Endkunde ist verstorben. Der juristischem Nachfolger

des Endkunden hat das Vertragsverhältnis gekündigt Es ist

daher nicht mehr möglich, den noch nicht ausgeführten

Auftrag auszuführen. Bei Fragen nehmen Sie bitte mit dem

juristischem Nachfolger des Endkunden Kontakt auf.

1194 Der Endkunde verweigert die

Herstellung

Der Endkunde hat der Telekom Deutschland untersagt die

Leitung herzustellen, oder der Zugang zum APL wird

verweigert

Bitte nehmen Sie Kontakt mit Ihrem Endkunden zur Klärung

des konkreten Sachverhalts auf.

1195 Der Insolvenzverwalter des

Endkunden kündigt das

Vertragsverhältnis

Der Endkunde hat Insolvenz angemeldet. Der

Insolvenzverwalter des Endkunden hat das

Vertragsverhältnis gekündigt Es ist daher nicht mehr

möglich, den noch nicht ausgeführten Auftrag auszuführen.

Bei Fragen nehmen Sie bitte mit dem Insolvenzverwalter

Kontakt auf.



1196 Der Endkunde kann die

beauftragte Leistung nicht mehr

abnehmen

Der Telekom Deutschland ist es aus Gründen die beim

Endkunden zu suchen sind nicht mehr möglich den Auftrag

auszuführen.

Gründe die nicht mit anderen MC abgedeckt sind.

Bitte nehmen Sie Kontakt mit Ihrem Endkunden zur Klärung

des konkreten Sachverhalts auf.

1199 Die Voraussetzung für die

Bereitstellung ist nicht mehr

gegeben. Der Auftrag wurde

abgebrochen.

Der Endkundenwunsch kann nicht realisiert werden.

Beispielsweise ist das Produkt auf der vorhandenen

technischen Infrastruktur nicht bereitstellbar.

Keine weiteren Handlungsmöglichkeiten.

2001 Die Leistungsnummer ist nicht

plausibel oder nicht eindeutig

Der angegebenen Leistungsnummer kann kein

Dienstvertrag zugeordnet werden.

Bitte prüfen Sie die Leistungsnummer und stellen den

Auftrag mit geänderter Leitungsnummer neu ein.

2004 Der Eingangskanal ist nicht

zulässig.

Bitte überprüfen Sie den gewählten Eingangskanal

hinsichtlich der vertraglich vereinbarten Eingangskanäle,

und stellen Sie den Auftrag über den zulässigen

Eingangskanal erneut ein.

5500 Der Anschlussinhaber ist falsch Der Anschlussinhaber ist unter der Rufnummer nicht in den

Systemen der Telekom geführt. Bei Preselection erfolgt

keine AKM-PV. Information kann aus diesem Grund nicht

übergeben werden.

Bitte überprüfen Sie den Anschlussinhaber, und stellen Sie

den Auftrag erneut ein.

Table 3 Deutsche Telekom Negative Result Codes

A.1.4 Negative Result Codes

These are system failure errors. Please contact Colt Reseller Support if you receive any of

these error messages.



0987 Ein angegebener Produktbezeichner ist

ungültig

Der angegebene Produktbezeichner ist nicht in

der Produktbezeichner-Tabelle der genutzten

Orderschnittstellenversion enthalten.

Bitte überprüfen Sie die Schreibweise. Ggf. ist

eine andere Orderschnittstellenversion

erforderlich um das gewünschte Produkt

bestellen zu können..

0990 Funktion aktuell nicht unterstützt, Freigabe

wird gesondert bekannt gegeben

Betrifft die Funktionen/Attribute, die in der

aktuellen Orderschnittstellenversion

beschrieben sind, aber erst zu einem späteren

Zeitpunkt freigeschaltet werden.

0991 Die parametrisierte Lastobergrenze ist

erreicht, bitte versuchen Sie es zu einem

späteren Zeitpunkt erneut.

Der Auftrag wurde nicht oder nicht vollständig

entgegengenommen.

Bitte stellen Sie den Auftrag zu einem späteren

Zeitpunkt erneut ein

0993 Versionsnummer fehlerhaft Die angegebene Versionsnummer der

genutzten Orderschnittstelle passt nicht zur

vertraglichen Vereinbarung.

Bitte überprüfen Sie die technischen

Einstellungen ihrer Schnittstelle unter

Beachtung der vertraglichen Vereinbarung und

stellen Sie den Auftrag erneut ein.

0995 Datenstruktur ungültig Die Datenstruktur des Auftrags ist fehlerhaft.

Der Auftrag wurde nicht vollständig übermittelt

oder das Zielprodukt ist mit dem gewählten

Geschäftsfall nicht kombinierbar.

Stellen Sie sicher, dass das Format und der

Inhalt des Auftragsdokumentes der

vereinbarten Schnittstellenbeschreibung

entsprechen, nehmen Sie Korrekturen vor und

stellen Sie den Auftrag erneut ein.



0996 Dokumententyp der Anlage ist unzulässig Es wurde ein Dokumententyp in der Anlage

verwendet der gemäß Beschreibung der OSS

nicht vorgesehen ist.

Bitte überprüfen Sie den Dokumententyp der

Anlage und ändern diesen in einen

zugelassenen Typ. Senden Sie den Auftrag

dann erneut.

0999 Technischer Fehler Ein nicht näher spezifizierter Fehler wurde

während der Bearbeitung des Auftrages

erkannt.

Bitte überprüfen Sie die technischen

Einstellungen ihrer Schnittstelle unter

Beachtung der vertraglichen Vereinbarung und

stellen Sie den Auftrag erneut ein. Sofern dies

nicht erfolgreich ist, kontaktieren Sie das

Clearing-Team.

Table 4 Deutsche Telekom Negative System Failure Codes

Country Codes

Country Code Country Name

AT Austria

BE Belgium

DE Germany

ES Spain

FR France

GB Great Britain

IE Ireland

IT Italy

NL Netherlands

SE Sweden


APPENDIX D Activity Codes

CountryAction Type

Current FTP Flat File Code

CoCOM Kernel/XML Schema Descriptive Code Description

DE CLI A Add CLI Activate CLI on Switch

DE CLI D Remove CLI Deactivate CLI on Switch

DE CLI M Transfer CLI

Modify CLI ownership to this

Reseller

DE CLI L Change CLI

Change CLI Parameters

(used for suspend and

unsuspend)

DE

CPS

CLI/

CPS C Add CPS

Activate CLI on Switch AND

activate Pre-selection
