introduction - colt … · web viewinternet explorer 11, ... are identified by global identifiers...

Cocom Reseller Connect

Web Manager User Guide

Spain

Cocom Web Manager ES Reseller Connect User Guide v.1.7 1 / 100

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 10th February 2006 Initial Document for Launch

1.1 20th of June 2006 Added Suspend functionality (New chapter 3.4.4), update of

query section (chapter 3.4); added new error message

(APPENDIX B)

1.2 27th of July 2006 Change version number to 1.1.

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

Status

1.3 15 April 2009 Maintenance & Support updated

1.4 16 January 2012 Updated to reflect introduction of new Cocom

New Consolidated CDR feature explained

1.5 16 February 2015 Updated the information related to the Internet Browser

1.6 4th February 2016 Updated to reflect Colt rebranding and browser related

information.

1.7 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 and change in

the notification period for planned maintenance work in section 3


Table of Content

1 INTRODUCTION...........................................................................................51.1 COCOM WEB MANAGER OVERVIEW.................................................................51.2 SCOPE...........................................................................................................51.3 DESCRIPTION..................................................................................................6

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..................................................92.4 MENU ITEMS.................................................................................................122.5 MANAGE CLI................................................................................................13

2.5.1 Activate CLI............................................................................................152.5.2 Deactivate CLI........................................................................................182.5.3 Modify CLI..............................................................................................202.5.4 Call Profiles CLI.....................................................................................222.5.5 Bulk Upload CLI.....................................................................................25

2.6 MANAGE CPS..............................................................................................272.6.1 Activate CPS..........................................................................................282.6.2 Deactivate CPS......................................................................................322.6.3 Bulk Upload CPS...................................................................................33

2.7 STATUS QUERY..........................................................................................362.7.1 Query CLI Status....................................................................................372.7.2 Query Transaction Status......................................................................422.7.3 CLI Reports............................................................................................472.7.4 CPS Reports..........................................................................................50

2.8 CDR DELIVERY............................................................................................552.8.1 CDR File Delivery and Naming Convention...........................................562.8.2 Select Profile for CDR Download...........................................................572.8.3 CDR Search...........................................................................................582.8.4 CDR Download:.....................................................................................592.8.5 CDR File Format:...................................................................................602.8.6 Consolidated CDR Request...................................................................612.8.7 Consolidated CDR Search.....................................................................632.8.8 Consolidated CDR Download................................................................642.8.9 Consolidated CDR File Format:.............................................................65

2.9 VIEW RESELLER DATA..................................................................................662.10 DOCUMENTS.................................................................................................68

2.10.1 User Guides...........................................................................................682.10.2 VPN Access...........................................................................................69

2.11 COCOM WEB MANAGER EXIT........................................................................70

3 MAINTENANCE AND SUPPORT...............................................................714 GLOSSARY.................................................................................................72APPENDIX A FLAT-FILE FORMAT FOR BULK UPLOADS...........................75


A.1 HEADER RECORD.........................................................................................75A.2 DETAIL RECORDS.........................................................................................77A.3 TRAILER RECORD.........................................................................................82

APPENDIX B COLT RESPONSE AND REASON CODES..............................85APPENDIX C B2B GATEWAY ERROR AND WARNING CODES..................89APPENDIX D ERROR CODES FROM PTT (TELEFONICA)...........................90APPENDIX E CALL DATA RECORD FORMAT..................................................94E.1 CDR FILE FORMAT.......................................................................................94E.1.1 CHARACTER CODING....................................................................................94E.1.2 FILE MARK-UP CODING.................................................................................94E.1.3 COMPRESSION/DECOMPRESSION ALGORITHMS..............................................94E.1.4 FILE NAME...................................................................................................95E.1.5 CONSOLIDATED CDR FILE NAME..................................................................96E.2 CALL DETAIL RECORD FORMAT.....................................................................96E.3 SAMPLE CALL DETAIL RECORD.....................................................................99

APPENDIX F COUNTRY CODES......................................................................100APPENDIX G ACTIVITY CODES....................................................................101


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 transitions easily and on demand.

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

XML (eXtensible Markup 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 for use by resellers and carriers in Spain.

1.2 Scope

The intended audiences of this document are users of “Cocom Web Manager Application”,

who don’t need to have detailed knowledge of the processes in the background.

The Reseller won’t need any additional software or development to use Cocom Web

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

Internet Explorer 11, Mozilla Firefox 40 and Google Chrome 45 versions are the

recommended browser versions on which the application has been tested.


1.3 Description

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

Figure 1 : Colt Reseller support infrastructure

The 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 the

Resellers.

Resellers can still use the existing FTP File Transfer for Flat File (semicolon separated)

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.

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 Telefonica,

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 Screen

Please proceed with the following steps:


5

4

3

2

6

1

http://www.colt.net/online

Enter your User ID (Authenticated by Colt in your Welcome letter)

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

Click on the button “Submit” to access Colt Online.When you first login, you will be

requested to change your password.

If you have forgotten your password, please click on “Forgotten your password”. You are

then requested to enter your “User ID” and your “E-Mail” address. A new password will

be sent to you by Colt Customer Service.

If you want to create a new account, please click on “Request a Colt Online Account”,

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

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 Place the mouse over the “Sales Tools” Main menu


2

1

2

3

1

4

5

6

1

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.

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 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 alphanumeric.


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.

1

2

13

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

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

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.

On the right corner under the top navigation bar, you can see that you are logged in with

your Username


4

5

6

2 43

1

6

5

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 of the features are

available on your account.

MANAGE CLIManage CLIs can provide the following features:

Activate CLI

Deactivate CLI

Modify CLI

Call Profiles CLI

Bulk Upload CLI

Activate and Deactivate CLI enables you to activate and deactivate CLIs on the Colt

switch. The action Modify CLI enables you 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

Deactivate CPS

Bulk Upload CPS

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.

In addition you can place consolidated CDR requests.

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 10 – Manage CLI screen Activate and Deactivate CLI allows activating and deactivating the CLIs on the Colt

switch for the product: Reseller Connect.

(1) 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”.

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


4

5

1

4

3

2

2

3

5

2.5.1 Activate CLI

Click on the Button “Activate CLI” in the above screen. The Select Profile screen will

appear. Click on a service profile to select it. Upon selecting a profile, you will be

taken to the Activate CLI screen.

Figure 6: Select Profile


12

2

1

Figure 7: Activate CLI

To activate a CLI on the Colt switch type the CLI in the available field select the range

Type and click on “Submit” .To delete the input without submitting click on the

button “Reset” .

Mandatory fields

Feature Description Example

CLI 9 digits without leading zero 955123001

Range Type 1)Select 01 to send a Single CLI

2) Select 02 to send a range without

sending range start and end, but only

the “main” number

3) Select 03 to send a range (Fill in the

fields Range Start and Range End)


34 56

3

4

5 6

Optional fields


Range Start Number with which the range starts

stays empty if range type 01 or 02

is selected

Range End Number with which the range ends

stays empty if range type 01 or 02 is

Selected

Toneburst Click into the field to switch toneburst

on answer on (1). Default value

is toneburst off (0).

Please wait until either a Transaction ID or an error message will be shown. The error

message will be displayed if the CLI has not the right format.

Figure 8: CLI Activation FinishedAfter 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


7

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

and type the Transaction ID . This is described in more detail in chapter Query

Transaction Status.

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. You will be

taken to the “Select Profile” screen and upon selecting a profile , the “Deactivate CLI”

screen will appear.



7

1

1

Figure 10: Deactivate CLI

Type the CLI in the available field . The format and the Range Type needs to be the

valid format of a CLI as described in chapter Activate CLI. Range Type is a mandatory field.

To send this 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” .

Mandatory fields are marked with a red asterisk “*”. The fields are the same as for CLI

Activation.


2 3 4

2

3 4

Figure 11: CLI Deactivation Finished

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.

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.

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. All fields are the same as for CLI

Activation and deactivation.


5

1

5


Figure 13: Modify CLI


1

2 3

To send this request click on the button “Submit” , to delete the CLI or other fields on

the screen, you can either use the delete button from your keyboard or click on the button

“Reset” .

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.

2.5.4 Call Profiles CLI

Using the Call Profiles CLI menu allows 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 customer service to request this functionality.

Select “Call Profiles” from the Menu “Manage CLI” to use this feature. You will be

taken to the “Select Profile” screen. Upon selecting a profile, the “Call Profiles CLI” screen

will appear.

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 and needs to be already active.


23

1

2

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

activated.


Figure 15: Start Screen Call Profiles CLI


2

1

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

Figure 16: Call Profiles CLI

To suspend this specific CLI click on the Button “Submit” . A transaction ID will be

displayed, which can also be viewed under the query section Transaction status.

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

Switch profile Switch profile ID

Suspend SC

Unsuspend CS


3

4

5

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.

4

5 3

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

2.5.5 Bulk Upload CLI

With this function it is possible to upload a CSV formatted file with up to 500 data records for

CLI activation, deactivation or modification. The format is the same as used for the FTP file.

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

An Excel Macro provided by Colt can be used to create this CSV formatted file.

Figure 17: Select profile


1

2

Figure 18: Bulk Upload CLI

To use this feature, click on the button “Bulk Upload CLI” . You will be taken to the

“Select Profile” screen. Upon selecting a profile, the “Bulk Upload CLI” screen will

appear. To upload a file, click on the Button “Browse” to select a file from your disk

drive.


12 3

3

5

Figure 19: Bulk Upload CLI - Browse Files

Select a file in the correct format as described above, click on “Open” to select the file

and then click on the Button “Submit” . There will be single Transaction ID for all

activities requested in the file.

2.6 Manage CPS

The functionalities under Manage CPS menu:

Activate CPS

Deactivate CPS

Bulk Upload CPS

Activate CPS allows to activate Carrier Preselection. The messages will be sent to Cocom

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


45

Please Note: Switch profile cannot be changed with a bulk upload request.

4

countries. It is also possible to upload several CPS requests in a Flat File (comma

separated) (Bulk Upload).

User will 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. When you select any

function, you will first be required to select a service profile before proceeding to the function

screen.

Figure 20: Start Screen Manage CPS

2.6.1 Activate CPS

Click on the Button “Activate CPS” in the above screen. The Select Profile screen will

appear. Click on a service profile to select it. Upon selecting a profile, you will be taken

to the Activate CPS screen.


12

1


To send a CPS request to Telefonica, fill in the necessary fields described below. Fields

which are mandatory are marked with a red asterisk (*).


2

Figure 22: Screen Activate CPS

To clear all fields click on the button “Reset” . Click on the button “Submit” to

send the transaction. After the transaction has been processed the assigned Transaction ID

will be displayed. To activate a new CPS click again on the button “Activate CPS”.


4 3

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

already activated.

3

4

Mandatory fields


CLI CLI with no leading zero, it should be

9 digits. It can be left empty,

if Range Type is 03

955123001

Range Type Select 01 to send a single CLI

Select 02 to send a range without sending range

start and end, but only the “main” number.

Select 03 to send a range (Fill in the fields Range

Start and Range End)

CPS Level Type of CPS service required:

00- Long Distance

01 - Global Preselection

02 - Exclusion of metropolitan calls

03 - Inclusion of metropolitan calls

04 - Deactivation of Preselection

01

Optional fields


Range Start Number with which the range starts stays empty if

range type 01 or 02 is

selected

955100002

Range End Number with which the range ends stays empty if

range type 01 or 02 is selected955100006

Customer ID Private Customer: DNI/CIF or passport

Number Company: VAT Number

Customer Name Private Customer: Customer Name as per their

Telefonica account

Company: Company Name

Toneburst Click into the field to switch toneburst on answer

on (1).

Default is toneburst off (0).

Default Value: Unchecked


2.6.2 Deactivate CPS

Click on the button “Deactivate CPS”. You will be taken to the “Select Profile” screen

and upon selecting a profile; the “Deactivate CPS” screen will appear.

To send a CPS request to Telefonica fill in the necessary fields described below. Fields

which are mandatory are marked with a red asterisk (*).


Figure 24: Screen Deactivate CPS


1

2

3

1

To clear all fields click on the button “Reset” . Click on the button “Submit” to send

the transaction. After the transaction has been processed the assigned Transaction ID will

be displayed. To deactivate a new CPS, click again on the button “Deactivate CPS”.

Mandatory fields


CLI CLI with no leading zero, it should be

9 digits. Left empty if Range Type is 03

955123001

Range Type Select 01 to send a single CLI.

Select 02 to send a range without sending range

start and end, but only the “main” number.

Select 03 to send a range (Fill in the fields Range

Start and Range End)

CPS Level Type of CPS service

required:

00 - Long Distance

01 - Global Preselection

02 - Exclusion of metropolitan calls

03 - Inclusion of metropolitan calls

04 - Deactivation of Preselection

01

Optional fields


Range Start Number with which the range starts stays empty

if range type 01 or 02 is selected955100002

Range End Number with which the range ends stays empty if

range type 01 or 02 is selected955100006

2.6.3 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 formatted file with up to 499 data records for CPS activation or deactivation.

The format is the same as used for the FTP file.


3 2

Please find a short description of the format in APPENDIX A CSV formatted file for bulk

uploads.

An Excel Macro provided by Colt can be used to create this CSV formatted file.

To use this feature, click on the button “Bulk Upload CPS” . You will be taken to the

“Select Profile” screen. Upon selecting a profile, the “Bulk Upload CPS” screen will appear.



1

1

Figure 26: Bulk Upload CPS

Figure 26: Bulk Upload CPS – Browse Files


2

3

To upload a file, click on the Button “Browse” to select a file from your disk drive. After

browsing the correct file name, click on the Button “Submit” .

2.7 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 as follows.


2 3

Figure 27: Start Screen Status Query

2.7.1 Query CLI Status

Click on “Query CLI Status” to request the status of a CLI. The Select Profile screen

will appear. Click on a service profile to select it. Upon selecting a profile, you will be taken to

the Query CLI Status screen.


1

1


Figure 29: Query CLI Status


2

3

4

1

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 “Reset” to delete your input. Click on the Button “Search” to

send the request.

Figure 30: Search result: Query CLI Status

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 again after a

while.


2

4 3

5

Field Description Example

CLI CLI (no leading zero) 913546010

Country Country of Reseller ES

Service Profile Service Profile 850

Customer Group Name of the Reseller

CLI Type Text Information about CLI Single CLI

CLI Range Start CLI Range Start number

CLI Range End CLI Range End number

Access Number Not existing for Spain

Switchboard

Number

Not existing for Spain

Toneburst Toneburst on answer: off (0) or on (1) 0

CPS Level The CPS Level of a CLI. Only relevant

if CLI is preselected. Value could be 00,

01, 02, 03, 04

01

Switch Profile Switch Profile STD

CLIserv Colt internal Number

Tariff Plan Colt internal Number

Pseudo Account ID Colt internal Number

Pseudo DN Colt internal Number

Suspended True if CLI is suspended or barred True or false

The table above lists the fields with a short description which are displayed for a Status

request.

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 service profile. Transactions


5

Please Note: Information for some fields won’t be available for all countries.

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

the service 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 31: Search result: CLI History

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 all information listed on the screen.


CLI CLI with no leading zero 967234562

Transaction ID Transaction ID – not shown if

transaction is not done by own Service

Profile

201102174

Action Type Action as described in APPENDIX G ADD CLI, ADD CPS

Switch Profile Switch Profile as described in 2.5.4 Call

Profiles CLI

Single CLI

UNKNOWN

Transaction Date Date when the transaction has been

send

Response Code Colt Response Code as described in

APPENDIX B Colt Response and

reason codes


66


Response Text Colt Response Text as described in

APPENDIX B Colt Response and

reason codes

Additional Response

Text

Colt Additional Response Text as

described in APPENDIX B Colt

Response and reason codes

2.7.2 Query Transaction Status

Click on “Query Transaction Status” to search for a specific transaction. The Select

Profile screen will appear. Click on a service profile to select it. Upon selecting a profile, you

will be taken to the Query Transaction Status screen.



1

1

Figure 33: Query Transaction Status

A list of all Transaction IDs will be displayed on one ore more pages.

The Transactions List contains the following information:

Transaction ID

Transaction Type

Transaction Status

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.

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 (From) and the End (To)

Date and click on the Button “Search” to send the request.

In case of known transaction id, type it to "Transaction ID" text field and click on Search

button. To send a new request you can either click on the Button “Reset” or on “Query

Transaction Status”.


2 3

4

2 3

4

Figure 34: Search Result - Query Transaction Status (CLI)

Figure 35: Search Result - Query Transaction Status (CPS)Explanation of the shown fields for CLI and CPS transactions:


Please Note: Only Transaction IDs generated by the Cocom Web Manager (Reference

ID WebManager) can be requested and are displayed in this report.

For CLI Transaction

Field Description Example(s)

Service Type Service Type CLI

Line ID Line ID 1

Transaction ID Transaction ID 201102174

CLI CLI with no leading zero 917430859

CliType Cli Type – Not available Blank or 00

CliTypeText Explanation for CliType – Not

available

Blank or Unknown

Action Activity ADD CLI, REMOVE CLI

SwitchProfile 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 B for Colt


0

Colt Response Text Cocom Error Text – refer to

APPENDIX B for Colt


OK

For CPS Transaction


Service Type Service Type CPS

Transaction ID The Transaction ID 201102174

Request ID Line ID 1

CLI CLI (no leading zero) 917430859

Action Activity ADD CPS, REMOVE CPS

Colt Response Date Date and time when the 2006.01.19-19:23:46


For CPS Transaction


response is processed by Colt

Colt Response Code Cocom Error Code - refer to

APPENDIX B for Colt


0

Colt Response Text Cocom Error Text – refer to

APPENDIX B for Colt


OK

CPS Level The CPS Level of a CLI. Only

relevant if CLI is Preselected.

Value can be 00, 01, 02, 03, 04

01

CPS Status The status of the CPS -1 Pending no answer from PTT yet

Confirmed

Switched

Reject

Cancel other

Cease Pending

Cease Actual

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

Telefonica – refer to

APPENDIX D for Error Codes

from PTT (Telefonica)

Operator Return Message Error Text returned from

Telefonica – refer to

APPENDIX D for Error Codes

from PTT (Telefonica)

Cease NTF Number Left blank.


2.7.3 CLI Reports

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

activity and the response code in a defined time frame.

To select Start and End date, click on the calendar Symbol and choose the

preferred date. Click on the Button “Search” to search for all activities and all Response

Codes in the specified time frame.



1

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.

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

report.

1

Figure 37: Query CLI Report

To search for a special activity click on the menu “Action” and select one of the offered

activities.

Figure 38: Menu Action


4

2 3

4

Menu Description

ADD CLI Activate CLI

Remove CLI Deactivate CLI

Change CLI Change CLI (for suspend)

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 and click on the Button “Search”

Figure 39: Menu Response Code

Menu Description

Success Colt Response Code 0

Warning Colt Response Code 2 or 8

Error Colt Response Code 16

The figure below shows the search result for a CLI Report.

The following features are shown on the Web page:

Line ID

Transaction ID

Reference Information

CLI

Activity

Response Code


56

5

6

Response Text

Response Date

Switch Over Date

Figure 40: Search result: CLI Report

Clicking on the Header Column (e.g. CLI) enables you to sort the listing for the selected

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


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

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

2.7.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.


7

8

1

Please Note: It is recommend 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 from Excel.

7

8

To select Start and End date, click on the calendar Symbol and choose the

preferred date. Click on the Button “Search” to search for all activities and all CPS

status in the specified time frame.



2 3 6

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

Figure 42: CPS Report

To search for a special activity click on the menu “Action” and select one of the offered

activities.

Figure 43: Menu Action


4

2 3

45

6

Menu Description

ADD CPS Activate CPS

Remove CPS Deactivate CPS

Change CPS order Change CPS settings (not available as

a command in Web Manager)

To search for a CPS Status click on the menu “CPS Status” , select one of the following

codes and click on the Button “Search”.

Figure 44: Menu CPS Status


56

Menu Description

Confirmed Valid request has been received by Telefonica

Switched Telefonica response if order OK. Ready for service as of

“Switchover Date & Time”

Reject Possible response from Telefonica. An additional error code will

be send – refer to APPENDIX D for Error Codes from PTT

(Telefonica). Order must be corrected and resubmitted

Cease Actual Result of Cease by End Customer or Telefonica

Cease Pending Notification of Cease requested by End Customer or by

Telefonica

Cancel Other The order has been rejected for the reason given by Telefonica –

refer to APPENDIX D for Error Codes from PTT (Telefonica)

The figure below shows the search result for a CPS Report.

Figure 45: Search result: CPS Report Status

Clicking on the Header Column (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.


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).


7

8

7

8

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

Possible Reference Information

Reference Information Description

WebManager Transaction sent via Cocom Web Manager

Online Transaction sent via XML Interface

request/ABC0000055.req Transaction sent via FTP

Transaction sent by Colt Customer Service

2.8 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”.


Please Note: It is recommend 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 from Excel.

CDR delivery allows downloading 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.8.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.

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 ES 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


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

has been made.

<date> is YYYYMMDDHHmmss

cdr.zip is where the file is zipped

Product Identifier Product name

01 Reseller Connect

00 Voice Line

10 SIP Trunking

11 IP Voice Line

12 IN for Resellers

13 Carrier VoIP

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

product. These files are detailed in Appendix E.

2.8.2 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 46: Search Profile Screen After clicking on “Arrow” button, a CDR Search page will be displayed.

2.8.3 CDR Search

Figure 47: CDR Search Screen


1

2

3

4

5

6

1

2 3

4 5

In 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.

2.8.4 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 48: CDR List


2 3

4 5

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

1

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

Figure 49: 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. CDRs are provided twice a day.

2.8.5 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.


1

2.8.6 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.

Figure 50: Consolidated CDR request - Select 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 flat file format (semicolon separated).

12

1

2

Figure 51: 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.”


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.

3 4 5

6

3 4

5

Figure 52: Consolidated CDR Request: Transaction Result

2.8.7 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 53: Consolidated CDR Search


789

6

78 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.8.8 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 54: Consolidated CDR Download (1)

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


9

10

10

Figure 55: Consolidated CDR Download (2)

2.8.9 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 E.


2.9 View 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 53: 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.10 Documents

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.10.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 54: User Guides Screen


2 1 3

1

3

2

2.10.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.

Figure 55: Help – VPN Access Screen


1 2

1

2

2.11Cocom 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 56: Logout Screen


1

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 Description

B2B 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 Preselection.

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 quotes 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.

HTML 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


Term Description

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.

URL 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.


Term Description

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 CSV formatted file for bulk uploads

Please refer to the Colt Cocom FTP User Guide for a detailed description of the CSV

formatted file.

A.1Header Record

There is just one Header record per file, which must be the first record in the file.

Ref Identifier/ Field Name

Data Type MaxLength

M/O Default Field Description / Notes

1 Header Id Alphanume

ric

1 Mandato

ry

H Must equal character “H”

(without quotes)

2 Format

Description

Alphanume

ric

35 Optional none Free format text for

information only. For

example “CLI Requests”

3 Version Alphanume

ric

6 Mandato

ry

0.02.1 File Format Version. This is a

required value and should be

the default value unless

otherwise instructed by Colt

4 Country ID Alpha 2 Mandato

ry

ES Country ID in ISO-3166 Code

5 Service

Profile

Numeric 3 Mandato

ry

none This is your unique ID

allocated by Colt.

6 Customer

Group

Alphanume

ric

30 Mandato

ry

None Leave blank

7 Tariff Plan Alphanume

ric

2 Mandato

ry

None Leave blank

8 CLISERV

Screening

Index

Alphanume

ric

3 Mandato

ry

None Leave blank



Data Type MaxLength


9 The number

of current

block

Integer 2 Optional 01 01-99; Currently only 01 is

supported

10 Total

number of

blocks


supported

11 Creation

Date

Timestamp 17 Mandato

ry

Current

Date in

format

YYYYMMD

D-hh:mm:ss

Example:

20040430-

13:42:27

Current Date in format

YYYYMMDD-hh:mm:ss


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

semi-colon.

A.2Detail Records

There can be up to 500 detail records per Request file.


Data Type

MaxLength

Mandatory/Optional

Default Field Description / Notes

1 Data

Record

Identifier

Alpha-

numeri

c

1 Mandatory D D for Detail

2 Request

Number

Intege

r

22 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.

3 CLI Intege

r

9 Mandatory if

Range

Indicator =

“01” or “02”.

Must be

blank if

Range

Indicator =

“03”

None Telephone number

Numeric, 9 digits

No leading zero

First 3 digits must be a valid

Spain area code.



Data Type

MaxLength

Mandatory/Optional


4 Action Alpha 1 Mandatory None Request Type CLI:

A - Add to Switch

D - Delete from Switch

M - Modify CLI ownership.

And modify CPS ownership (if

CPS pre-selected)

Request Type CLI/CPS:

A - Add to Switch AND

Activate Preselection

Note: D & C are not allowed.

Request Type CPS:

(There must be an Active CLI)

A - Activate Preselection

D - Deactivate Preselection

C - Change Preselection

settings (i.e. CPS Level)

5 Toneburst Boole

an

1 Optional none Toneburst on answer.

0 - OFF

1 - ON

Defaults to “0” if field is blank

6 Job date Timest

amp

17 Mandatory none Current Date in format

YYYYMMDD-hh:mm:ss

Example:

20040430-13:42:27



Data Type

MaxLength

Mandatory/Optional


7 Customer

Request

Date

Intege

r

8 Optional none *Not relevant for CLI only

requests

Date that the customer

requires the action to take

place. Telefonica doesn’t

accept a preferred date of

implementation.

This field should be blank.

8 CPS Level Alpha-

numeri

c

9 CLI Request:

Must be

blank

CPS

Request:

Mandatory

CLI/CPS

Request:

Mandatory

none *Not relevant for CLI only

requests

The type of CPS service

required.

The following codes are

allowed:

00 – Long Distance

01 – Global Preselection

02 – Exclusion of metropolitan

calls

03 – Inclusion of metropolitan

calls

04 – Deactivation of

Preselection



Data Type

MaxLength

Mandatory/Optional


9 Range

Indicator

Alpha-

numeri

c

Mandatory None Whether or not the activation

is for a range.

The following values are

permitted:

01 – Perform the specified

action on the Individual CLI in

the CLI field (Field 3)


action on the Range. Used for

PABX, ISDN ranges. Only

need to enter the “main”

number of the range in the CLI

Field – Field 3.


action on the range of

individual CLIs in the range

fields (Fields 10 – 11)

10 Start

Range

Alpha-

numeri

c

9 Mandatory if

Range

Indicator =

03

Blank The start number of the range.

Only populate for requests

with Range Indicator = “03”

11 End range Alpha-

numeri

c

9 Mandatory if

Range

Indicator =

03

Blank *Not relevant for CLI only

requests

The end number of the range.

Only populate for requests

with Range Indicator = “03”



Data Type

MaxLength

Mandatory/Optional


12 Customer

Name

Alpha-

numeri

c

30 Optional Blank *Not relevant for CLI only

requests

Private Customer: Customer

Name, as per their Telefonica

account.

Company: Company Name

13 Customer

Ref

Alpha-

numeri

c

Optional Blank *Not relevant for CLI only

requests

Private Customer: DNI/CIF or

passport number

Company: VAT number

14 Alpha-

numeri

c

Optional Blank Not used. Leave blank.

15 Alpha-

numeri

c

Optional Blank Not used. Leave blank.


A.3Trailer Record


Data Type MaxLength


1 Trailer Id Alphanume

ric

1 Mandato

ry

T T for Trailer

Must be first field on last line in

file

2 Number of

Records in

this block

Integer 3 Optional Maintained by Reseller

3 Checksum Integer 10 Optional Blank Value generated running Unix

checksum on this block’s data

records. By default no checksum

is performed and the field is

empty

4 Number of

current

block


supported

5 Total

number of

blocks


supported


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

semi-colon.

Request File Example

CLI-only request message example

This is from Spain (ES) Reseller 856 to Deactivate CLI 955666123, and to Activate CLIs

955666120 and Activate CLI 955652000.

H;CLI;0.02.1;ES;856;;;;01;01;20041030-09:50:28;

D;1;955666123;D;;20041030-09:50:28;;;;;;;;;;

D;2;955666120;A;1;20041030-09:50:28;;;03;;;;;;;

D;3;955652000;A;0;20041030-09:50:28;;;01;;;;;;;

T;3;0;01;01;

CPS Only RequestsThis is from Spain (ES) Reseller 856 to Activate CPS on CLI 955652000, change the CPS

level on CLI 955443604 from ‘global calls’ to ‘exclude metropolitan calls’ and to Deactivate

CPS on CLI 955600145.

H;CPS Only Request;0.02.1;ES;856;;;;01;01;20041030-15:08:27;

D;1;955652000;A;0;20041030-15:08:27;;01;01;;;Ana Montaya;15647896B;;;

D;2;955443604;C;0;20041030-15:08:27;;00;02;;;Maria Cruz;;;;

D;3;955600145;D;0;20041030-15:08:27;;04;01;;;Esperanza

Fernandez;58276990F;;;

T;3;0;01;01;

Combined CLI/CPS RequestsThis is from Spanish (ES) Reseller 856 to Activate CPS on ISDN range with main number

955456100 and Activate a range of numbers 955100002 – 955100006.

H;CLI/CPS Request;0.02.1;AT;856;;;;01;01;20041118-10:50:13;

D;1;955456100;A;0;20041118-10:50:13;;01;02;;;Riojavino;E15647895;;;

D;2;;A;0;20041118-10:50:13;;00;03;955100002;955100006;Sofia

Cruz,45126245B;;;

T;2;0;01;01;


APPENDIX B Colt Response and reason codes

Colt Response Code

Colt Response Text

Description Explanation

0

okComment: Activated

for Action Change

The requested action has been successfully

completed

Ok CPS

pending

CLI activation has been successfully completed,

CPS request is pending

1 Data out of

rangeCLI is invalid. 9 digits without leading zeros.

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.

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

are

00 - Long Distance

01- Global Preselection

02- Exclusion of metropolitan calls

03- Inclusion of metropolitan calls

04- Deactivation of Preselection

Invalid area Code Area Code is missing or invalid


Colt Response Code

Colt Response Text


Invalid Caller

Number

Caller Number missing or invalid

Range Start is

invalid

Range Start is invalid

Range End is invalid Range end is invalid

2 object

already

exists

CPS Pending, object

already exists

CLI is already active, however CPS is pending

best match conflict

with cli <cli>

There is a best match conflict, which can happen

if a CLI is provisioned or de-provisioned which is

part of a stub

direct 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.

CLI <cli> already

active

The CLI has been already activated on the switch

CLI already active The CLI has been already activated on the switch

cli is already

activated

A CLI activation has already been send and is

now in process

cli already activated

by modify

A modify command will automatically activate the

CLI if not already active.


Colt Response Code

Colt Response Text


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

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.

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.

Account <account>

cannot modify its

own CLI

Reseller has tried to modify a CLI which has

already been assigned to him

8 object does

not exist Cannot suspend

unknown CLI <cli>

CLI is not activated on the switch

Account of cli has

been modified

range not available

No CPS found for

action DEACTIVATE

Account <account>

does not exist.


Colt Response Code

Colt Response Text


Account <account>

cannot submit CPS

requests for CLI of

another account

(best match)

Account <account>

cannot submit CPS

requests for CLI of

another account

(direct conflict)

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

Account is locked

account is not

allowed to activate

account is not

allowed to deactivate

account is not

allowed to modify

Account do not have the right for modifications

account is not

allowed to perform a

CPS activate


APPENDIX CB2B Gateway Error and Warning Codes

B2B Gateway returns status /error and warning messages in the following structure:

Status message – Returned in Acknowledgement messageCode – numeric code messageType – The system reporting the error. Currently B2BGateway and

Cocom are the only values for this field messageDescription – Text description of the message (occasionally may

include java stack trace)

Message Code Message Type Message Description

0 B2BGateway Success Message/OK

-1 B2BGateway Validation Failed, Infrastructure Error

0 Cocom OK – Success

99 Cocom Error Message - Stack trace


APPENDIX D Error Codes from PTT (Telefonica)

The following tables are from the Telefonica CPS Result codes

PTT Response Code

Description in Spanish

Description in English

Explanation

0507 Formato del

numero telefónico

incorrecto o en

blanco

Incorrect Format of

telephone number or

field is blank

When the telephone number comes blank

or contains non numerical characters or

the length is not 9 digits

0508 Falta de

correspondencia

entre el numero y el

DNI/CIF del

abonado

Lack of

correspondence

between the number

and the DNI/CIF of

the subscriber

When for the given telephone number,

the DNI/CIF of the request does not

agree with the one of the subscriber who

has contracted the access

0509 Código de operador

solicitante erróneo

Operating Code of

applicant is erroneous

When the field that identifies the code of

the operating applicant does not have a

recognized value or is incorrect

0510 Numero de

referencia

duplicado o

incorrecto

Duplicated or

incorrect order

number

When a request with a order number

appears that or has been used by the

operator, or that is incorrect to contain

non alphanumeric characters

0511 Solicitud

redundante

Redundant request When the action that is asked for does

not modify the state in which is the

subscriber, and would not make lack

carry out no task

0512 Formato del

DNI/CIF incorrecto

o en blanco

Format of the

incorrect DNI/CIF or

blank

When this field comes blank or contains

non alphanumeric characters

0514 Unidad de

preselección

Incorrect unit of

Preselection or blank

When this field comes blank or does not

have a recognized value


PTT Response Code



Explanation

incorrecto o en

blanco

0515 Tipo de

modificación

incorrecto o en

blanco

Incorrect type of

modification or field is

blank

When this field comes blank, it does not

have a recognized value, or the asked for

modification is incompatible with the

Preselection modality in which is the

subscriber"

0701 Inhabilitación

solicitada al

operador de acceso

Deactivate / Cease

requested by Access

Operator

0702 Inhabilitación por

baja en el operador

de acceso

Deactivate / Cease by

loss in the Access

Operator


cambio de titular


change of titling


interrupción del

servicio


interruption of service

0705 Cancelación por

falta de

acreditación del

consentimiento del

abonado

Cancellation of

Preselection due to

lack of accreditation

of subscriber’s

consent

LOA problem

1101 Numeración con

proceso de

preselección ya en

marcha

Preselection already

in progress

When on the CLI a process of

Preselection in progress on the part of

another operator or of the same operator

exists that not yet has finalized, and both

processes affect at least a same type of

calls


PTT Response Code



Explanation

1102 Numeración

portada a otro

operador

Numeration carried to

another operator

When the number has been carried

another operator and no longer depends

on the access operator

1103 Numeración no

preseleccionable

Non Preselectable

numeration

When the number is not Preselectable,

understanding like Preselectable

numeration that that is including in the

ranks published by the CMT like

preseleccionables numbers and the

numeration that has been carried the

access operator

1104 Abonado ha

causado baja en el

aperador de acceso

Subscriber has

inflicted losses in the

access operator

When the subscriber is terminated by the

access operator for not paying his bill!

1105 Línea de abanado

con Telecomputo

Local line with

Telecómputo

When the subscriber asks for

Preselection and this one is incompatible

with the associate facilities of the line

(Telecómputo)

1106 Abonado con

servicio suspendido

o interrumpido

Subscriber with

suspended or

interrupted service

When the subscriber has the service

suspended or interrupted according to

articles 59 and 60 of the Universal

Regulation on watch.

1111 Solicitud

redundante

Redundant request When the action that is asked for does

not modify the state in which is the

subscriber, and would not make lack

carry out no task

1113 Numero telefónico

no preseleccionado

Not Preselected

telephone number

When the telephone number is not

Preselected with the operating applicant

1116 Numeración no

geográfica o no

Numbering non-

geographic or not

When the Preselection of the following

numerations is asked for:


PTT Response Code



Explanation

perteneciente al

operador de acceso

pertaining to the

access operator

Geographic numeration that is not

assigned to the access operator,

excepting the case of the geographic

numeration that it has been carried being

the access operator the receiver.

Non-geographic numeration.

1117 Numero CENTREX

Cabecera sin línea

física

Number CENTREX

Head without wire line

When the Preselection of numbers Head

of CENTREX is asked for.

1118 Numeración con

proceso de

preselección ya en

marcha

Preselection already

in progress

When on the CLI a process of

Preselection in progress on the part of

another operator or of the same operator

exists that not yet has finalized, and both

processes affect at least a same type of

calls

1119 Numeración

portada a otro

operador

Numeration carried to

another operator

When the number has been carried

another operator and no longer depends

on the access operator

1200 Inhabilitada por un

tercer operador

Unsolicited cease by

another Operator

1300 Inhabilitada por

Telefónica

Unsolicited cease by

Telefonica


APPENDIX E 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

E.1CDR File Format

E.2Character Coding

ASCII

E.3File Mark-up Coding

No structured Mark-Up used

Fixed length records

Fixed length fields, space filled

E.4Compression/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.


Please Note: The 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.

E.5File 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 ES 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 name

01 Reseller Connect

00 Voice Line

10 SIP Trunking

11 IP Voice Line

12 IN for Resellers

13 Carrier VoIP

Example: ES_AB1_01_0007_20110204170001.cdr.gz


E.6Consolidated CDR File Name

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 .cdr is the extension .zip is where the file is zipped

Example: AM220120110182.cdr.zip

E.7Call 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.

2Destination

(Terminating)20 21 N

Destination 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

11 Account Code 20 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

19 End of Record 1 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.

E.8Sample Call Detail Record

Sample CDR file name from enhanced Cocom:-

ES_AB1_01_0007_20110204170001.cdr.gz

Sample unrated CDRs in the new standard format delivered to enhanced Cocom:-

0913231234 917861234012011120707255510000002240 00001 1127

1128 0000000000000000000000 AB10

0913231234 917861234012011120707400480000008590 00001 1177

1126 0000000000000000000000 AB10

0916741234 916691234012011120708040520000001400 00001 1127

1177 0000000000000000000000 AB10

0948441234 944701234012011120707223710000010830 00001 1156

1155 0000000000000000000000 AB10

0941311234 945271234012011120707283610000000590 00001 1156

1155 0000000000000000000000 AB10


APPENDIX F 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

PT Portugal

DK Denmark


APPENDIX G Activity codes

Country

Action Type

Current FTP Flat File Code

Cocom Kernel/XML Schema Descriptive Code

Description

ES CLI A ADD CLI Activate CLI on Switch

CLI D REMOVE CLI Deactivate CLI on Switch

CLI M TRANSFER CLI Modify CLI ownership to this Reseller

CPS A ADD CPS Activate Preselection on an existing

switched CLI

CPS D REMOVE CPS Deactivate Preselection

CPS C CHANGE CPS Change Preselection settings

CLICPS A ADD CPS Activate CLI on Switch AND activate

Preselection
