73
1 / 73 Colt Number Hosting Cocom Web Manager - User Guide Portugal (PT)

Colt Number Hosting Cocom Web Manager - User Guide ... · Cocom is accessible via different interfaces to allow for maximum choice ... ‒ ‘Disabled’ stands ... Colt Number Hosting

  • Upload
    lythuan

  • View
    241

  • Download
    1

Embed Size (px)

Citation preview

1 / 73

Colt Number Hosting

Cocom Web Manager - User Guide

Portugal (PT)

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 2 / 73

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 Description

1.0 April, 2017 Initial Document for Launch

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 3 / 73

Table of Content

1 INTRODUCTION ......................................................................................... 5 1.1 COCOM OVERVIEW ....................................................................................... 5

1.2 SCOPE......................................................................................................... 5

1.3 DESCRIPTION ............................................................................................... 6

1.4 ACCESS TO COCOM WEB MANAGER ............................................................. 6

1.5 LOGIN TO COCOM WEB MANAGER ................................................................ 7

2 COCOM WEB MANAGER ........................................................................ 10 2.1 MENU ........................................................................................................ 10

2.2 NUMBER STATUS ....................................................................................... 11

3 PT NUMBER & PORTING INFORMATION ............................................... 13 3.1 NUMBER FORMAT ....................................................................................... 13

3.2 PORTING INFORMATION .............................................................................. 14

3.3 NUMBER LIFE CYCLE ................................................................................. 16

4 COLT NUMBERS RESERVATION ........................................................... 17 4.1 HOW TO RESERVE NUMBERS ....................................................................... 18

4.2 HOW TO EXTEND A NUMBERS RESERVATION ................................................ 20

4.3 HOW TO CANCEL A NUMBERS RESERVATION ................................................ 22

5 COLT NUMBERS ACTIVATION, DEACTIVATION AND REACTIVATION24 5.1 HOW TO ACTIVATE NUMBERS ...................................................................... 24

5.2 HOW TO DEACTIVATE ACTIVATED NUMBERS ................................................. 27

5.3 HOW TO REACTIVATE DEACTIVATED NUMBERS ............................................. 29

5.4 HOW TO ACTIVATE NUMBERS WITH BULK UPLOAD ....................................... 31

6 MANAGE PORTING ................................................................................. 33 6.1 HOW TO REQUEST NUMBERS PORT-IN .......................................................... 34

6.2 HOW TO CANCEL A PORT-IN REQUEST ........................................................ 36

6.3 BULK PORT-IN REQUEST ............................................................................ 37

7 ADDRESS UPDATE AND DIRECTORY SERVICE UPDATE ................... 40 7.1 ADDRESS UPDATE ..................................................................................... 40

7.2 DIRECTORY SERVICE UPDATE ..................................................................... 42

8 NUMBER ENQUIRY AND STATUS QUERY ............................................ 44 8.1 NUMBER ENQUIRY ...................................................................................... 44

8.2 STATUS QUERY BY TRANSACTION ID .......................................................... 45

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 4 / 73

9 UNRATED CDRS ...................................................................................... 51 9.1 HOW TO DOWNLOAD UNRATED CDRS ......................................................... 51

9.2 HOW TO DOWNLOAD CONSOLIDATED UNRATED CDRS ................................. 53

10 DOCUMENTATION ................................................................................... 57

11 GLOSSARY .............................................................................................. 58

APPENDIX A FLAT FILE FORMAT FOR BULK UPLOAD NUMBER ACTIVATION 60 A.1 REQUEST FILE HEADER RECORD FORMAT ................................................... 60

A.2 REQUEST FILE DETAIL RECORD FORMAT ...................................................... 61

A.3 REQUEST FILE TRAILER RECORD FORMAT ................................................... 64

A.4 NUMBER ACTIVATION REQUEST FILE EXAMPLE ............................................ 65

A.5 EXCEL MACRO ACTIVATION REQUEST ......................................................... 65

APPENDIX B FLAT FILE FORMAT FOR BULK UPLOAD PORTING REQUEST 66 B.1 REQUEST FILE HEADER RECORD FORMAT ................................................... 66

B.2 REQUEST FILE DETAIL RECORD FORMAT ..................................................... 67

B.3 REQUEST FILE TRAILER RECORD FORMAT ................................................... 72

B.4 PORT-IN REQUEST FILE EXAMPLE ............................................................... 72

B.5 EXCEL MACRO PORT IN REQUESTS ............................................................. 73

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 5 / 73

1 Introduction

1.1 Cocom overview

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

support your product related transactions.

Cocom is a standardized Pan-European tool which enables you to manage your transactions per

country and product.

Cocom is accessible via different interfaces to allow for maximum choice and flexibility:

‒ Cocom Web Manager: web based interface which

allow you to proceed to your numbers transactions with with

ease and on demand, without the need to integrate with your

internal systems. It also supports account management

capabilities and provides access to user guides.

‒ Cocom API/XML Interface: XML standard based,

itenables you to connect your back-end systems in a fully

automated way. XML is used for all Cocom transactions. XML

responses are retrieved by you using query XML calls. There is

no CDR delivery via this interface.

‒ Cocom FTP: automated interface which can be accessed via a standard VPN client. It provides

twice daily delivery of unrated CDRs into protected and dedicated FTP directories.

1.2 Scope

This user guide describes how to use Graphical User Interface (GUI) Cocom Web Manager

for Colt Number Hosting, including the below transactions:

‒ Colt number reservation,

‒ Colt number activation,

‒ Number porting,

‒ Address and Directory Update,

‒ Number and status query,

‒ Transfer of twice daily unrated Call Detail Records (CDRs).

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 6 / 73

It also describes how to log-in into Cocom Web Manager, access to user guides and view

Colt Number Hosting customer data.

This user guide describes Cocom Web Manager for Colt Number Hosting in the Portugal

(PT) .

1.3 Description

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

Cocom Web Manager description

The GUI uses XML high security connection requests via HTTPS. All the XML Interfaces are

synchronous.

1.4 Access to Cocom Web Manager

No additional software or development is required to use Cocom Web Manager, a browser

and an Internet connection are sufficient.

Web browser compatibility - the below brower versions are recommended:

‒ Internet Explorer 11.0

‒ Mozilla Firefox 40

‒ Google Chrome 45

Cocom Web Manager is fully integrated into Colt’s customer portal ColtOnline. You access to Cocom

Web Manager with the same ColtOnline single login via the below URL:

‒ ColtOnline: https://online.colt.net/

‒ during ColtOnline downtime: https://coltcocomwebmanager.colt.net/wholesale1

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 7 / 73

1.5 Login to Cocom Web Manager

Login from ColtOnline

Colt Online Login Screen

Please proceed with the following steps:

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

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

3. Click on the button ‘Submit to access Colt Online. Please note that during your 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.

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

Colt Online home screen

1

2

1

2

3

4

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 8 / 73

1. Place the mouse over the ‘Sales Tools’ Main menu

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.

Note: Cocom Web Manager Sub menu item with link is displayed only if the user is authorized to

access Cocom Web Manager.

Cocom Web Manager Welcome page

Cocom Web Manager Welcome page displayes all available Account and Service Profiles under your

Reseller Domain name, accordingly to your products (1).

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

name.

Welcome page displays the authorized main menu items for a specific user, accordingling to Web

Manager Role and product-related permissions.

Web Manager Welcome Screen

3

2

1

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 9 / 73

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

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

per service instance:

‒ Account profiles apply to products such as Colt SIP Trunking and Colt Voice Line.

‒ Service profiles apply to Colt Number Hosting, Colt Reseller (VoIP) Connect and Colt

Carrier VoIP (unrated CDRs only). Service profile is purposed to distinguish country and a

product within the country

Note:

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

and Colt Voice Line, they will have the same account profile.

‒ Service profiles enable Colt to continue to support multiple 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 standard of up to 5 alphanumeric. 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.

‒ ‘Active’ stands for a Reseller Domainwhcih is allowed to perform functional activities based

on profiles.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 10 / 73

2 Cocom Web Manager

2.1 Menu

The following section describes the available feature for each function in 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 RESERVATION

Manage Reservation has the following sub-menus:

‒ Reserve Numbers: enables you to reserve a single or range of numbers.

‒ Cancel Number Reservation: enables you to cancel the reserved numbers.

‒ Extend Number Reservation: enables you to extend period of number reservation by 90

days.

MANAGE NUMBERS

The menu Manage Numbers has the following sub-menus:

‒ Activate Numbers: allows you to activate Colt numbers.

‒ Deactivate Numbers: allows you to deactivate the activated numbers.

‒ Address Update: allows you to update the address for the emergency services.

‒ Directory Service Update: allows you to add or update or cease the directory service data

‒ Number Enquiry: allows you to do the number search.

‒ Bulk Upload: allows you to request activation of numbers in a bulk using a Flat File.

MANAGE PORTING

The menu Manage Porting offers the following sub-menus:

‒ Request Port-in: allows you to send port-in request to Colt Porting Desk

‒ Cancel Port-in Request: allows you to cancel the port in request before a stipulated period.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 11 / 73

‒ Bulk Port-in Request: allows you to request port-in in a bulk using a Flat File.

CDR

CDR allows to download unrated CDRs from Cocom Web Manager which will be delivered twice a

day by default.

2.2 Number Status

The below number status are available in Cocom:

Number

Status

Description Possible actions

Free Number is free. It can be

reserved by you or by any other

Number Hosting Customer.

‒ Reservation: Number will be reserved.

Reserved Number is reserved for you and

is ready to be activated by you

only.

‒ Cancel reservation: number will be free again.

‒ Extend Reservation: reservation period will be

extended to 90 days.

‒ Activation: number will be activated and ready

to place and receive calls.

Allocated Transition status between

reservation and completion of

activation.

‒ No action.

Activated Number is live, calls can be

received and initiated.

‒ Deactivation: number will be deactivated and

not reachable.

Quarantined After number deactivation,

number goes to Quarantine

status (i.e deactivated state)

‒ Reactivation: number will be reactivated and

ready again to place and receive calls. Allowed

for the same end customer at the same

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 12 / 73

address as activation.

Port-in

(Activated)

Live ported in numbers, calls

can be received and initiated.

‒ Deactivation: number will be deactivated, not

reachable

Port-in

(Quarantined)

Deactivated ported-in numbers ‒ Port-in Reactivation

Port out Number has been ported out

from Colt

‒ No action

Returned Deactivated ported-in numbers,

returned to the range holder.

‒ No action

All This will include all the numbers

with different status (mentioned

above)

‒ No action

For additional information about number status and action allowed in the country, please refer

to Number Hosting Implementation Guide.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 13 / 73

3 PT number & porting information

3.1 Number format

The PT is divided into a number of Local Areas, part national numbering plan. Each Local Area is

associated to a code, named Local Area Code (LAC).

A geographic telephone number is structured by 3 components:

1. Local Area Code, first digits of the number and providing location infromation.

2. Main Number, which can be seen as the Local Area extension.

3. Range, the final digits of the telephone number.

In PT, geographic number length is of 9 digits, including leading zero. Please find below additional

information about number format:

Length Comments

Local Area

Code (LAC)

2 &3 digits Area code should be of 2 or 3 digits.

Main Number 2 &3 digits Main number should be of 2 or 3 digits.

Range 4 digits Range start/end should be of 4 digits.

A telephone number must be reserved, activated or ported-in into the LAC it belongs. For instance, for

numbers reservation in Mealhada, Local Area Code should be 231 (Mealhada as Local Area).

For additional information about Colt geographic coverage in the country, please refer to

Number Hosting Implementation.

Cocom in an On Demand portal, that give you freedom and full flexibility to manage your

numbers. Please respect the best practices describes in How to reserve numbers section to

reserve correctly numbers range.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 14 / 73

3.2 Porting information

After submitting a porting request in Cocom, a transaction ID is created. This transaction is called the

‘original transaction ID’. Please always track the original transaction ID for status update.

During the porting process, your transaction status is changing, accordingly to the porting process.

Please find below the possible transaction status for original portin request are available in Cocom:

Original

transaction

status

Description Possible actions

In Progress Your portInrequest has been submitted

successfully to Colt Porting Desk.

‒ You can change the portIn date or

cancel portin request.

Confirmed Your portIn request has been confirmed

by Colt Porting desk, i.e. the data you

have provided look good to proceed.

Please note that at this time, your

request has been submitted and

Accepted with the loosing provider for

given Port-Date

‒ You can change the portIn date or

cancel portin request.

Rejected Your portIn request has been rejected

by Colt Porting desk.

Reason is given in the transaction, it

could because you’ve provided

incomplete or insistant data or the

losing provider has rejected the portin

at its end.format incorrect, invalid,

rejection from the losing carrier)

‒ You will need to resubmit your

portin request based on Colt

Porting Desk guidance.

Delayed The port date is delayed because of: ‒ No action

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 15 / 73

‒ To arrange necessary porting

agreement with losing provider (in

case required)

‒ Delayed response from Losing

provider. In case of bulk porting,

losing provider may engage their

Capacity Teams for configuration

check or impact on existing traffic

etc.

Cancelled The portIn request has cancelled by

you or Colt Porting Desk.

‒ No action

Completed The portIn request is completed by

porting desk

‒ No action

Porting-in Life Cycle in Portugal:

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 16 / 73

3.3 Number Life Cycle

Please find below Colt Number Life Cycle and associated transactions:

Please find below Ported-in Number Life Cycle and associated transactions:

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 17 / 73

4 Colt Numbers reservation

This section describes how to proceed with the below transactions:

‒ Reserve numbers

‒ Cancel a numbers reservation

‒ Extend your numbers reservation

Those transactions are made from ‘Number Enquiry’ page. To access the page, from Cocom Home

page:

1. Go to ‘Manage Numbers’

2. Click on ‘Number Enquiry’

3. And select your Service Profile

Service profile selection

1

3

2

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 18 / 73

4.1 How to reserve numbers

To reserve Colt Numbers, from ‘Number Enquiry’ page:

1. Set the search criteria to:

a. Search Criteria = Number Status.

b. Number Status = Free.

2. Number type = Geographical Numbers.

3. If you want to reserve geographical numbers, select the Local Area Code.

4. Set to block size to fulfil your requirement.

5. Click on Search.

Number Enquiry for free numbers

Number Enquiry - Search Result shows you free numbers as per your criteria. To continue:

1. Select the radio button in front of the numbers you want to reserve.

2. Select reserve in user action button.

3. Click on Go.

1

1

2

3

4

5

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 19 / 73

List of free number available

On Reserve Numbers page:

1. Adjust last digit of range start to zero (ex: xxx0).

2. Adjust last digit of range end to 9 in case of range reservation (ex: xxx9). Verifiy that the

difference between range end and range start is equal to the quantity of numbers you need!

3. Customer Reference is a free text field (up to 50 characters), you can enter for instance your

end-customer name or internal reference.

4. Validate your request by clicking on Submit.

Final step for numbers reservation

On the Transaction Result page, you will find the transaction ID associated to the transaction. To

check transaction status, please refer to Status Query section.

Transaction ID for numbers reservation

3

4

1

2 3 1

2

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 20 / 73

Number Status:

‒ Numbers are now reserved for you and are ready to be activated at anytime during the

reservation period.

Notes:

‒ Numbers reservation is only allowed for free numbers.

‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding Colt

numbers reservation.

4.2 How to extend a numbers reservation

To extend Colt Numbers reservation, from ‘Number Enquiry’ page:

1. Set the search criteria to:

a. Search Criteria = Number Status.

b. Number Status = Reserved.

2. Click on Search.

Number Enquiry for reserved numbers

Number Enquiry - Search Result shows your reserved numbers. To continue:

1. Select the radio button in front of the numbers you want to extend the reservation.

2. Select Extend Reservation in user action button.

3. Click on Go.

1

1

2

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 21 / 73

List or reserved numbers

On Extend Number Reservation page:

1. Validate your request by clicking on Submit.

Reservation numbers extension

On the Transaction Result page, you will find the transaction ID associated to the transaction. To

check transaction status, please refer to Status Query section.

Number Status:

‒ Numbers are still reserved but for an additional period of 90 days. Numbers can still to be

activated at anytime.

Notes:

‒ Extend a reservation is only allowed for reserved numbers.

‒ It is not allowed to extend part of a reserved range. The whole range reserved will be

extended.

2

1 3

1

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 22 / 73

‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding Colt

numbers reservation.

4.3 How to cancel a numbers reservation

To cancel Colt Numbers reservation, from ‘Number Enquiry’ page:

1. Set the search criteria to:

a. Search Criteria = Number Status.

b. Number Status = Reserved.

2. Click on Search.

Number Enquiry for reserved numbers

Number Enquiry - Search Result shows your reserved numbers. To continue:

1. Select the radio button in front of the numbers you want to cancel the reservation.

2. Select Cancel Reservation in user action button.

3. Click on Go.

Number Enquiry, list of reserved numbers

1

1

2

2

1 3

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 23 / 73

On Cancel Number Reservation page:

1. Validate your request by clicking on Submit.

Cancelation of numbers reservation

On the Transaction Result page, you will find the transaction ID associated to the transaction. To

check transaction status, please refer to Status Query section.

Number Status:

‒ Numbers are free again. They cannot be activated by you anymore.

‒ Numbers can be reserved by any Number Hosting Customer.

Notes:

‒ Cancel a reservation is only allowed for reserved numbers.

‒ It is not allowed to cancel part of a reserved range. The whole range reserved will be

canceled.

‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding Colt

numbers reservation.

1

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 24 / 73

5 Colt Numbers activation, deactivation and

reactivation

This section explains you how to:

‒ Activate numbers

‒ Deactivate numbers already activated

‒ Reactivate numbers already deactivated

‒ Activate numbers using bulk upload

Those transactions are made from ‘Number Enquiry’ page. To access the page, please refer to Colt

Numbers reservation section.

5.1 How to activate numbers

To activate Colt Numbers, from ‘Number Enquiry’ page:

1. Set the search criteria to:

a. Search Criteria = Number Status.

b. Number Status = Reserved.

2. Click on Search.

Number Enquiry to access your reserved numbers

1

1

2

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 25 / 73

Number Enquiry - Search Result shows your reserved numbers. To continue:

1. Select the radio button in front of the numbers you want to activate

2. Select Activate in user action button

3. Click on Go

Number Enquiry, list of your reserved numbers

On Number Activation page:

1. (optional) You can update if required your Customer Reference

2. Select the Business type: Business or Residential. Enter the End Customer details:

Customer Name, Building Name/Number, Street, City, Post Code, of your end-customer.

For Business customer Type, Enter NIF. For Residential Customer Type, enter BI.

3. Validate the address using the Search Address buton.

4. (optional) – If you have subscribed to the Directory Service Update service, you can provide

the data by ticking the box. Please refer to Directory Service Update section for complete

description.

5. Validate your request by clicking on Submit

It is critical that you enter correct and accurate information about your end-customer as they

are used to route Emergency Calls and also used in case of lawfal interception request.

It’s your responsibility, as Service Provider of end-customer, to provide accurate and always

up to date information.

2

1 3

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 26 / 73

Number activation

On the Transaction Result page, you will find the transaction ID associated to the transaction. To

check transaction status, please refer to Status Query section.

Number Status:

‒ Activation process in progress: Number Status is Allocated. It’s a transitory status between

reserved and activated and is visible temporary during number activation process.

‒ Activation process completed: Number Status is Activated when

‒ Activation non-completed (error): Number Status is back to Reserved, please refer to Status

Query section for error messages support.

Notes:

‒ Numbers activation is only allowed for Reserved numbers.

2

1

3

4

5

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 27 / 73

‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding Colt

numbers activation.

5.2 How to deactivate activated numbers

To deactivate Colt Numbers, from ‘Number Enquiry’ page:

1. Set the search criteria to:

a. Search Criteria = Number Status.

b. Number Status = Activated.

2. Click on Search.

Number Enquiry for activated numbers

Number Enquiry - Search Result shows your activated numbers. To continue:

1. Select the radio button in front of the numbers you want to deactivate.

2. Select Deactivate in user action button.

3. Click on Go.

Number Enquiry, list of activated numbers

1

1

2

2

1 3

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 28 / 73

On Number Deactivation page:

1. (optional) – If you have subscribed to the Directory Service publication for the numbers, you

can remove the data from the publishers by ticking the box. Please refer to Directory Service

Update section for complete description.

2. Validate your request by clicking on Submit

Numbers deactivation

On the Transaction Result page, you will find the transaction ID associated to the transaction. To

check transaction status, please refer to Status Query section.

Number Status:

‒ Numbers are quarantined. They can be reactivated only by you during the country

quarantine period, for the same end-customer and at the same address.

‒ After that period, they will be free again and they can be reserved by any Number Hosting

Customer.

Notes:

‒ Numbers deactivation is only allowed for Actived numbers.

‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding Colt

numbers deactivation and quarantine period.

2

1

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 29 / 73

5.3 How to reactivate deactivated numbers

To reactivate Colt Numbers, from ‘Number Enquiry’ page:

1. Set the search criteria to:

a. Search Criteria = Number Status.

b. Number Status = Quarantined.

2. Click on Search.

Number Enquiry for deactivated numbers

Number Enquiry - Search Result shows your deactivated numbers. To continue:

1. Select the radio button in front of the numbers you want to reactivate.

2. Select Reactivate in user action button.

3. Click on Go.

Number Enquiry, list of deactivated numbers

1

1

2

2

1 3

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 30 / 73

On Number Reactivation page:

‒ Enter exact same end-customer details you entered during activation, as described in How to

activate numbers section.

‒ Validate your request by clicking on Submit

On the Transaction Result page, you will find the transaction ID associated to the transaction. To

check transaction status, please refer to Status Query section.

Number Status:

‒ Reactivation process in progress: Number Status is Allocated. It’s a transitory status

between quarantined and activated and is visible temporary during number reactivation

process.

‒ Reactivation process completed: Number Status is either Activated.

‒ Reactivation process non-completed (error): Number Status is back to Quarantined, please

refer to Status Query section for error messages support.

Notes:

‒ Numbers reactivation is only allowed for Quarantined numbers.

‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding Colt

numbers reactivation and quarantine period.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 31 / 73

5.4 How to activate numbers with Bulk Upload

With this function it is possible to upload a Flat-File (semicolon separated) records for Numbers

activation.

An Excel Macro provided by Colt shall be used to create this Flat-File (semicolon separated). Bulk

activation file is described and available in APPENDIX A.5.

To activate numbers with Bulk Upload, from Cocom Home page:

1. Go to ‘Manage Numbers’, then ‘Bulk upload’.

2. Select your Service Profile.

Access to bulk upload

Finally, on Bulk Upload page:

1. Upload your file by clickin choose file.

2. Select your file in the correct format as described above and click on Open.

3. Validate your request by clicking on Submit.

Numbers activation bulk upload

1 1

2

1

3

2

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 32 / 73

On the Transaction Result page, you will find the transaction ID associated to the transaction. To

check transaction status, please refer to Status Query section.

Transactions ID for numbers activation bulk upload

Number Status:

‒ Activation process in progress: Number Status is Allocated. It’s a transitory status between

reserved and activated and is visible temporary during number activation process.

‒ Activation process completed: Number Status is Activated when

‒ Activation non-completed (error): Number Status is back to Reserved, please refer to Status

Query section for error messages support.

Notes:

‒ Numbers activation is only allowed for Reserved numbers.

‒ Separate Transaction IDs are generated for each data record in the file uploaded.

‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding Colt

numbers activation and bulk upload capabilities.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 33 / 73

6 Manage Porting

This section explains you how to:

‒ Request a Port In.

‒ Cancel a Port In Request.

‒ Request Port-in via bulk using a Flat File (semicolon separated).

Please refer to the Number Hosting Implementation Guide for the country rules regarding

numbers porting.

To manage your porting, from Cocom Home page:

1. Go to ‘Manage Porting’,

2. Select the transaction you want to realize as per the above

3. Select your Service Profile

Manage porting screen

2

1

3

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 34 / 73

6.1 How to request numbers port-in

To request Numbers port-in:

1. Go to ‘Manage Porting,

2. Select ‘Request Port-in’.

3. Select your Service Profile.

Access to Request Port In Screen

Please follow the below steps:

1. Enter end customer details- Customer Name, Business type- business/residential,

NIF/BI and Customer Reference.

2. Enter exact and complete current address of your end-customer.

3. Validate the current address.

4. (optional) In case your end-customer is moving at the same time as porting, please enter

exact and complete new address – in addition to the current address.

5. (optional) Validate the new address.

6. Enter numbers detail respecting format described in the CDR

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

delivered twice a day by default.

8. section.

9. Enter the current provider operating the numbers. Please refer to Number Hosting

Implementation guide for list of providers with whom Colt has porting agreement.

10. (optional) Indicate numbers type: Single line = S; Multi line = M.

11. You can add up to 5 rows within the porting request by clicking on ‘add’ button. If you

need to port more than 5, please use the bulk upload feature as described in Bulk Port-in

Request section.

2

1

3

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 35 / 73

12. Enter port date and select porting window in accordance with the country leadtime

regarding numbers porting as described in the Implementation Guide. Enter Company

registration access code.

13. (optional) Edit your porting contact detail – Notification will be automatically sent to the

contact at any change of the porting.

14. Attach the Letter of Authorization (LOA) and Copy of Invoice.

15. Validate your request by clicking on Submit.

Request porting screen

1

8 2

5

4

3

7

6 9

11

10

13

12

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 36 / 73

On the Transaction Result page, you will find the transaction ID associated to the transaction. To

check transaction status, please refer to Status Query section.

Note:

‒ When a port in request is submitted the transaction status is “In Progress”. It means Colt

porting team has received the request and will start working.

‒ Once the porting team done with the port-in process, the status will be changed manually by

the porting team to “Completed”.

It is critical that you enter correct and accurate information about your end-customer as they

are used to route Emergency Calls and also used in case of lawfal interception request.

It’s your responsibility, as Service Provider of end-customer, to provide accurate and always

up to date information.

6.2 How to cancel a Port-In Request

To cancel a numbers port-in request:

1. Go to ‘Manage Porting,

2. Select ‘Cancel Port-in Request’.

3. Select your Service Profile.

Access to Cancel Portin Request

On ‘Cancel Port–In request’ page:

1. Enter transaction ID of the porting request you want to cancel.

1

3

2

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 37 / 73

2. (optional) Edit your porting contact detail – Notification will be automatically sent to the

contact at any change of the porting.

3. Validate your request by clicking on Submit

Cancel Port-In Request

On the Transaction Result page, you will find the transaction ID associated to the transaction. To

check transaction status, please refer to Status Query section.

Please refer to the Number Hosting Implementation Guide for the country rules regarding

numbers porting cancelation leadtime.

6.3 Bulk Port-in Request

With this function it is possible to upload a Flat-File (semicolon separated) records for Numbers

porting.

An Excel Macro provided by Colt shall be used to create this Flat-File (semicolon separated). Bulk

activation file is described and available in APPENDIX A.5.

To port-in numbers with Bulk Upload, from Cocom Home page:

1. Go to ‘Manage Porting,

2. Select ‘Bulk Port-in Request’.

1

3

2

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 38 / 73

3. Select your Service Profile.

Access to bulk upload

On Bulk Port-in Request page:

1. Upload your file by clickin choose file.

2. Select your file in the correct format as described above and click on Open.

3. Validate your request by clicking on Submit.

PortIn bulk upload

On the Transaction Result page, you will find the transaction ID associated to the transaction. To

check transaction status, please refer to Status Query section.

1

3

2

1

3

2

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 39 / 73

Transaction IDs for numbers porting bulk upload

Notes:

‒ Separate Transaction IDs are generated for each data record in the file uploaded.

‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding Colt

numbers porting and bulk upload capabilities.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 40 / 73

7 Address Update and Directory Service Update

This section describes how to proceed with the below transactions:

‒ Update your end-customer address

‒ Update your end-customer Directory publication

7.1 Address Update

To update your customer address, from Cocom Home page:

1. Go to ‘Manage Numbers’

2. Click on ‘Address Update’

3. Select your Service Profile

Access to Address Update

On Address Update page:

1. Enter the Numbers information you want to update the address: Local Area Code, Main

Number, Range start and Range end

2. Enter your Customer Name and address detail

3. Validate the address using the Search Address buton.

4. Validate your request by clicking on Submit

1

3

2

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 41 / 73

Address update screen

It is critical that you enter correct and accurate information about your end-customer as they

are used to route Emergency Calls and also used in case of lawfal interception request.

It’s your responsibility, as Service Provider of end-customer, to provide accurate and always

up to date information.

On the Transaction Result page, you will find the transaction ID associated to the transaction. To

check transaction status, please refer to Status Query section.

Number Status:

‒ Numbers are still activated, only address has been updated.

Notes:

‒ Update an address is only allowed for activated numbers.

‒ It is not allowed to update address part of an activated range. The whole range will be

updated.

‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding

address update and LAC validation.

1

3

2

4

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 42 / 73

7.2 Directory Service Update

To update your customer pubilcation in the Directory Service, from Cocom Home page:

1. Go to ‘Manage Numbers’,

2. Click on ‘Directory Service Update’

3. Select your Service Profile

Note: Directory Service Update can also be done during activation and port-in request by ticking

Directory Service Update box.

Access to Directory Service Update

On Directory Service Update page:

1. Enter Number details: Local Area Code, Main Number, Range Start/End.

2. Select Order Type from the drop down: New, Cease, Amend

3. Enter end-customer information: Business/End Customer Name, Building name/Number,

Steet, City/Town, Post code and telephone number. Validate the address using Search

Address.

4. Validate your request by clicking on Submit

1

3

2

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 43 / 73

Directory Service Update Screen

On the Transaction Result page, you will find the transaction ID associated to the transaction. To

check transaction status, please refer to Status Query section.

Number Status:

‒ Numbers are still activated, only publication information have been updated.

Notes:

‒ Transaction status is shown as completed after your submission. Please expect some delay

between your request and the Diretory Service update.

1

3

2

4

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 44 / 73

8 Number Enquiry and status query

8.1 Number Enquiry

Number Enquiry is the provision to manage the actions related to number search and status/report

on numbers. The page is accessible from ‘Manage Numbers’.

Number search screen presents a drop down box as ‘Search Criteria’ which is described below:

‒ Transaction ID: to find Number Status of a particular transaction you have palced.

‒ Number Range: to find Number Status of a particular range.

‒ Customer reference: to find Number Status based on customer reference you have added

during previous transaction.

‒ Number Status: to find numbers based on their status. Please find below the status:

All

Free

Reserved

Activated

Quarantined

Port In(Activated)

Port-In(Quarantined)

Port Out

Returned

For complete description of number status and possible next actions, please refer to Error!

Reference source not found. section.

Number Enquiry result Screen

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 45 / 73

8.2 Status Query by Transaction ID

You can use this feature to view the details about your transactions requests submitted. You can view

all the transaction between a date range or for a particular transaction id.

To access to transactions status, from Cocom Home page:

‒ Go to ‘Status Query’ and click on ‘Query by Number Hosting Transaction Id’

‒ Select your Service Profile

By default this page displays the list of transaction and also it allows you to query the transactions as

described below.

Query by Number Hosting Id Screen

10

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 46 / 73

You are provided with two options for query and these are query by date or transaction Id.

‒ To query the transaction by date. Please enter ‘from’ and ‘to’ date using date pickers and

then click on ‘Search’ button.

‒ To query the transaction by Transaction Id, please enter a transaction ID in the Transaction

ID field and then click on ‘Search’ button.

A list of transaction matching the query request will be displayed on the same page. To see the

details of the transaction, please click on transaction ID link that will navigate you to ‘Search Result’

page showing the details of the transaction.

Search Result Screen

Query By Number Hosting Transaction Id

Field Description Example

Transaction ID Transaction ID provideded to user when the request is

submitted.

201304202

Transaction Type The type of transaction listed in below table. Number

Activation

Transaction Status ‘Completed’ status signals that the requests In Progress

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 47 / 73

Query By Number Hosting Transaction Id

Field Description Example

successfully completed.

‘In Progress’ status signals that the request has been

accepted and under processing. The duration to process

a request depends on the type of a transaction.

‘Failed with Error’ status signals that the requests could

not be processed. The reason for the failure is presented

on ‘Transaction Description’ field. Error scenario and

Transaction Description listed in below table.

Transaction Date

(yyyy.mm.dd-

hh:mm:ss)

Date when transaction was performed 2012.12.10-

12:00:00

Transaction

Description

Calrifies the status of the transaction. Especially useful

when transaction fails.

NumberActivation

process initiated

with

TransactionID :

201212031009

User Name User name who performed the transaction

Local Area Code Area code of the telephone number 231

Main Number Area code extensionof the telephone number 12

Range Start Number range start of the telephone number 0000

Range End Number range end of the telephone number 0009

Transaction type

Transaction Type

Number Reservation

Number Reservation Cancellation

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 48 / 73

Transaction Type

Number Reservation Extension

Number Activation

Number Deactivation

Number Reactivation

Address Update

Update Directory Services

New Port In

Cancel Port In

Update Port In Date

Port Out

Note: You can also export the transaction list to a excel file.

Error Description for transaction marked as ‘Failed with Error’.

Transaction Description Reason for failure User’s action

No search result found for

your search criteria.

User submits query on either Transaction

ID or number which do not exists in the

database.

Refine search criteria

Number Range is not

available. Please search for

another range and then try

again.

User specified the number in his

transaction request which does not exist in

the number pool.

Search for another

number

Number range is reserved

by another customer. Please

search for another number

range and try again.

User submits reservation request for the

number which is not free in the number pool

Try to reserve

another number

Request failed as the User submits deactivation request for the Check if number and

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 49 / 73

Transaction Description Reason for failure User’s action

number range is not Active. number which is not previously activated the status of the

number are correct

Request failed as the

number range is not active

or allocated.

User submits deactivation request for the

number for which prior activation failed

Check if number and

the status of the

number are correct

Number range is not

reserved. Please reserve the

number range first and then

try again.

User submits activation request for the

number which is not previously reserved

Submit reservation

request prior to

activation

The transaction ID is invalid.

Please retry with valid

transaction ID

User enters non-existing transaction ID

while submitting status query request Refine search criteria

Deactivation request failed.

For detail please contact

colt reseller support.

There was an error occurred within voice

network configuration after user

successfully submitted deactivation

request.

Raise incident with

ResellerSupport.Voic

[email protected]

Request failed as the OCN

does not match with the

number range.

User submitted request related to the

number which belongs to another customer

Check the number

and submit request

again

Request cannot be

processed as address

validation failed. Please

resubmit the request with

valid address.

User enters invalid address

Check the address

and submit request

again

Address validation failed as

the number of characters

exceeds the permissible

limit.

User enters too address characters longer

than allowed

Check the address

and submit request

again

Unable to process your

request due to system error.

Please try again later or

There was an internal system error for

which an incident needs to be raised with

[email protected]

Raise incident with

ResellerSupport.Voic

[email protected]

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 50 / 73

Transaction Description Reason for failure User’s action

contact your Colt

administrator.

Number range is not in

allocated state.

User submits activation request for the

number for which prior reservation request

failed

Check if number and

the status of the

number are correct

Activation request has failed

at voice network hence the

number range is reverting

from status "Allocated" to

status "Reserved".

There was an error occurred within voice

network configuration after user

successfully submitted activation request.

Raise incident with

ResellerSupport.Voic

[email protected]

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 51 / 73

9 Unrated CDRs

Twice a day 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.

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

This section explains you how to:

‒ How to download daily unrated CDR

‒ How to download consolidated unrated CDRs

Please note that the first CDR file will appear in Cocom Web Manager after the first call has been

made.

For more information about unrated CDRs, please check our Cocom Web manager & FTP

unrated CDRs guides.

9.1 How to download Unrated CDRs

From Home Page;

1. Go to ‘CDR’ at the top navigation bar

2. Click on ‘CDR Download’ - overview of your existing products and profiles will be displayed.

3. Enter your Service Profile

4. Click the ‘Search Profile’ button

5. Click on ‘Arrow’ button, a CDR Search page will be displayed.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 52 / 73

Search Profile Screen

On CDR search page;

1. Enter a start date in the From field

2. Enter an end date in the to field

3. Validate your request by clicking on Submit.

CDR Search Screen

On CDR List page:

1. Select a specific CDR file and click on ‘Download CDR’

CDR List Screen

A save dialog box is shown, you can save the file or open the file.

1

2

3 4

5

1 2

3

1

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 53 / 73

CDR Download Screen

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 Number Hosting Customer setup form.

‒ Colt recommends you select zipped CDRs to ensure CDR download is completed efficiently.

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

9.2 How to download consolidated unrated CDRs

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.

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.

From Home Page;

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 54 / 73

1. Go to ‘CDR’ at the top navigation bar and click on ‘Consolidated CDR request.

2. Enter your Service Profile.

3. Click the ‘Search Profile’ button.

4. Click on ‘Arrow’ button, a CDR Search page will be displayed.

Consolidated CDR request - Select profile

On Consolidated CDR Request page;

1. Enter a start date in the From field

2. Enter an end date in the to field

3. Validate your request by clicking on Consolidated CDR.

Consolidated CDR Request

Your Consolidated CDR request will be processed. A transaction ID will be displayed on the screen.

1

2 3

1 2

3

4

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 55 / 73

Consolidated CDR Request: Transaction Result

On CDR page:

1. Click on ‘Search Consolidated CDR’

2. Enter the transaction ID for your Consolidated CDR file

3. click on search button

.

Consolidated CDR Search

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.

On Consolidated CDR list screen:

1. Click on the Download Consolidated CDR.

Consolidated CDR Download (1)

1 2

1

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 56 / 73

A save dialog box is shown, you can save the file or open the file.

Consolidated CDR Download (2)

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.

Please refer to Unrated CDRs User Guides available in Cocom help section for additional information.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 57 / 73

10 Documentation

In Cocom Web Manager Help section, you will find all product related documentation for your Colt

Voice products, including Colt Number Hosting.

This includes:

‒ Colt Number Hosting user guides for Web Manager.

‒ Colt Number Hosting user guides for XML.

‒ Colt Number Hosting Implementation guide.

‒ Unrated CDRs guides (Web Manager & FTP).

‒ VPN access software and instructions.

‒ Bulk Activation / Bulk Port-in macros.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 58 / 73

11 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 and as well as download CDR’s for

Number Hosting product.

CPS Carrier Pre-Selection.

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.

PT Portugal

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

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.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 59 / 73

Term Description

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 (GB), 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.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 60 / 73

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 Flat File Format for Bulk Upload

Number activation

A.1 Request file Header Record Format

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

Ref

Identifier/

Field

Name

Data Type Max

Length M/O

Defau

lt

Field Description /

Notes

1 Header Id Alphanume

ric 1 Mandatory 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 Mandatory 0.1

File Format Version. This is

a required value and should

be the default value unless

otherwise instructed by Colt

4 Product ID Alphanume

ric 30 Mandatory

Geogr

aphic

Numb

er

Hostin

g

Product Name

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 61 / 73

Ref

Identifier/

Field

Name

Data Type Max

Length M/O

Defau

lt

Field Description /

Notes

5 Country ID Alpha 2 Mandatory PT Country ID in ISO-3166

Code

6 Service

Profile ID

Alphanume

ric 3 Mandatory none

This is your unique ID

allocated by Colt.

7 Creation

Date Timestamp 17 Mandatory

Curren

t Date

YYYYMMDD-hh:mm:ss

Example:

20040430-13:42:27

Table : Request Header Record

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

colon.

A.2 Request file Detail Record format

Ref Identifier/ Field Name

Data Type Max Length

M/O Default

Field Description / Notes

1

Data

Record

Identifier

Alphanume

ric 1 Mandatory D D for Detail

2 Request

Number Integer 22 Mandatory None

Record number

Starting at 1, increase by 1

with a maximum of 50. No

gaps or duplicates allowed.

The sequence is Number

Hosting customer

maintained.

3 Action Alpha 1 Mandatory None Request Type CLI:

A = Add to Switch

4 Local Area

Code Integer 3 Mandatory None

Area code should be of 2-3

digits.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 62 / 73

Ref Identifier/ Field Name

Data Type Max Length

M/O Default

Field Description / Notes

5 Main

Number Integer 3 Mandatory None

Main number should be of

2-3 digits.

6 Range start Integer 4 Mandatory None

Should be always of 4

digits. Numeric value.

Allways less or Equal than

Range End value

7 Range End Integer 4 Mandatory None

Should be always of 4

digits. Numeric value.

Allways less or Equal than

Range Start value

8

Updated

Customer

reference

Alphanume

ric 50 Optional None Customer reference Id.

Emergency Service Update- End Customer details - Mandatory

9 Customer

Name

Alphanume

ric 80 Mandatory None

End customer name/

Business name for

emergency services. Only

available for Business

customer type.

10 Building

Name

Alphanume

ric 50 Optional None

Building name for address

details of emergency

services.

Either Building name or

Number has to be entered

11 Building

Number

Alphanume

ric 20 Optional None

Building number for

address details of

emergency services.

Either Building name or

Number has to be entered

12 Street Alphanume

ric 50 Mandatory None

Street name for address

details of emergency

services.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 63 / 73

Ref Identifier/ Field Name

Data Type Max Length

M/O Default

Field Description / Notes

13 City/Town Alphanume

ric 50 Mandatory None

City or Town name for

address details of

emergency services.

14 Post Code Integer 50 Mandatory None

Postal code for address

details of emergency

service details.

Directory Services Update(Optional)

15 Order Type Alphanume

ric 10 Mandatory New

Order Status for directory

service details.

Order status is always

‘New’.

If Any of the values of the

Directory services are filled

then system will perform

the validation else not.

16

Business/E

nd

Customer

Name

Alphanume

ric 80 Mandatory None

End customer name or

business name for directory

service details.

17

DSU

Building

Name

Alphanume

ric 50 Optional None

Building name for address

details of directory services.

18

DSU

Building

Number

Alphanume

ric 20 Optional None

Building Number for

address details of directory

services.

19 DSU Street Alphanume

ric 50 Optional None

Street name for address

details of directory services.

20 DSU

City/Town

Alphanume

ric 50 Optional None

City name or Town name

for address details of

directory services.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 64 / 73

Ref Identifier/ Field Name

Data Type Max Length

M/O Default

Field Description / Notes

21 DSU Post

Code

Alphanume

ric 50 Mandatory None

Max length 50 4 digits

followed by a hyphen, then

3 digits,then a space and

then max 41 char long text.

22

DSU

Telephone

Number

Alphanume

ric 20 Optional None

Telephone number for

directory service details.

Table: Request Detail Record Format

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

colon.

A.3 Request file Trailer Record Format

Ref

Identifier/

Field

Name

Data Type Max

Length M/O

Defau

lt Field Description / Notes

1 Trailer Id Alphanume

ric 1 Mandatory T

T for Trailer

Must be first field on last line

in file

2

Number of

Records in

this block

Integer 3 Mandatory Maintained by Number

Hosting customer

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

Table: Request Trailer Record

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

colon.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 65 / 73

A.4 Number Activation Request File Example

H;Activation Request;0.4;Geographic Number Hosting;PT;ABC;20170406-

10:43:38;

D;1;A;231-M;11;1000;1000;Test activation;Business;Name;Building Name;1;

street;City;1234-456 fsdg;;;;;;;;;

D;2;A;231-M;12;1001;1001;Test activation;Business;Name;Building

Name;2;street;City;1234-456 fsdg;;;;;;;;;

D;3;A;231-M;13;1002;1002;Test activation;Business;Name;Building

Name;3;street;City;1234-456 fsdg;;;;;;;;;

T;3;;

A.5 Excel Macro Activation Request

You can download the Macro from the Help ->User Guide section in Cocom Web Manager.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 66 / 73

APPENDIX B Flat File Format for Bulk Upload Porting

Request

B.1 Request file Header Record Format

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

Ref

Identifier/

Field

Name

Data Type

Max

Lengt

h

M/O Default Field Description /

Notes

1 Header Id Alphanume

ric 1 Mandatory 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 Mandatory 0.1

File Format Version. This

is a required value and

should be the default

value unless otherwise

instructed by Colt

4 Product ID Alphanume

ric 30 Mandatory

Geogra

phic

Number

Hosting

Product Name

5 Country ID Alpha 2 Mandatory PT Country ID in ISO-3166

Code

6 Service

Profile ID

Alphanume

ric 3 Mandatory none

This is your unique ID

allocated by Colt.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 67 / 73

Ref

Identifier/

Field

Name

Data Type

Max

Lengt

h

M/O Default Field Description /

Notes

7 Creation

Date Timestamp 17 Mandatory

Current

Date

YYYYMMDD-hh:mm:ss

Example:

20040430-13:42:27

Table : Request Header Record

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

colon.

B.2 Request File Detail Record Format

Ref Identifier/ Field Name

Data Type Max Length

M/O Default Field Description / Notes

1

Data

Record

Identifier

Integer 1 Mandatory D D for Detail

2 Request

Number Integer 22 Mandatory None

Record number

Starting at 1, increase by 1

with a maximum of 50. No

gaps or duplicates allowed.

The sequence is Number

Hosting customer

maintained.

3 Action Alpha 1 Mandatory None Request Type CLI:

P = Port-In

4 Customer Name

Alphanume

ric 80 Mandatory None

Only available for Business

customer type.

5 Customer

Type

Alphanume

ric 80 Mandatory None Business or Residential

6 NIF Alphanume

ric 9 Mandatory None

NIF to be entered when

Customer Type Is Business

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 68 / 73

Ref Identifier/ Field Name

Data Type Max Length

M/O Default Field Description / Notes

7 BI Alphanume

ric 12 Mandatory None

BI to be entered when

Customer Type is

Residential.

8 Customer

Reference

Alphanume

ric 50 Optional None Customer Reference Id.

Current Address Details

9 Building Name

Alphanume

ric 50 Optional None

Building name for address

details of emergency

services.

Either Building name or

Number has to be entered

10 Building Number

Alphanume

ric 20 Optional None

Building number for

address details of

emergency services.

Either Building name or

Number has to be entered

11 Street Address

Alphanume

ric 50 Mandatory None

Street name for address

details of emergency

services.

12 City / Town

Alphanume

ric 50 Mandatory None

City or Town name for

address details of

emergency services.

13 Post Code

Integer 50 Mandatory None

Post Code for address

details of emergency

services.

New Address Details (Optional)

14

New

Building

Name

Alphanume

ric 50 Optional None

Building name for address

details of emergency

services.

15

New

Building

Number

Alphanume

ric 20 Optional None

Building number for

address details of

emergency services.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 69 / 73

Ref Identifier/ Field Name

Data Type Max Length

M/O Default Field Description / Notes

16

New Street

Address

Alphanume

ric 50 Mandatory None

Street name for address

details of emergency

services.

17

New City /

Town

Alphanume

ric 50 Mandatory None

City or Town name for

address details of

emergency services.

18 New Post Code

Alphanume

ric 50 Mandatory None

Post Code for address

details of emergency

services.

CLI Details

19 Main Billing

Number

Alphanume

ric 20 Mandatory None

20 Local Area

Code

Alphanume

ric 2-3 Mandatory None

Area code should be of 2-3

digits.

21 Main

Number

Alphanume

ric 2-3 Mandatory None

Main number should be of

3 digits.

23 Range start Alphanume

ric 4 Mandatory None

Should be always of 4

digits. Numeric value.

Allways less or Equal than

Range End value

24 Range End Alphanume

ric 4 Mandatory None

Should be always of4

digits. Numeric value.

Always Greater Or Equal

than Range Start value

25 Current

Provider

Alphanume

ric 20 Mandatory None

26 Single Line Alphanume

ric 1 Optional None S

27 Multi Line Alphanume

ric 1 Optional None M

28 Porting

Date Date Time 10 Mandatory None 27-09-2016

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 70 / 73

Ref Identifier/ Field Name

Data Type Max Length

M/O Default Field Description / Notes

29 Porting

Window

Alphanume

ric 10 Mandatory None

Porting window for port-in

request, permitted value is:

"0900-1200”

“1400-1700”

30 Access

Code

Alphanume

ric 14 Mandatory None

4 digits-4 digits-4 digits e.g.

“3571-5757-7739'.

Switch Maintainer Details

31

Porting

Contact

First Name

Alphanume

ric 80 Mandatory None

32

Porting

Contact

Last Name

Alphanume

ric 50 Mandatory None

33

Porting

Contact

Phone

Integer 20 Mandatory None

34

Porting

Contact

Mobile

Integer 20 Optional None

35

Porting

Contact

Email

Address

Alphanume

ric 50 Mandatory None

36 Letter of

Authority

Alphanume

ric Mandatory None

Porting form is separately

mail to porting helpdesk for

each request.

37 Invoice Alphanume

ric Optional None

Invoice copy is separately

mail to porting helpdesk for

each request.

Directory Services Update(Optional)

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 71 / 73

Ref Identifier/ Field Name

Data Type Max Length

M/O Default Field Description / Notes

38 Order Type Alphanume

ric 10 Mandatory New

Order Status for directory

service details.

Order status is always

‘New’.

If Any of the values of the

Directory services are filled

then system will perform

the validation else not.

39

Business/E

nd

Customer

Name

Alphanume

ric 80 Mandatory None

End customer name or

business name for directory

service details.

40

DSU

Building

Name

Alphanume

ric 50 Optional None

Building name for address

details of directory services.

41

DSU

Building

Number

Alphanume

ric 20 Optional None

Building Number for

address details of directory

services.

42 DSU Street Alphanume

ric 50 Optional None

Street name for address

details of directory services.

43 DSU

City/Town

Alphanume

ric 50 Optional None

City name or Town name

for address details of

directory services.

44 Post Code Alphanume

ric 50 Mandatory None

Max length 50 4 digits

followed by a hyphen, then

3 digits,then a space and

then max 41 char long text.

45 Telephone

Number

Alphanume

ric 20 Optional None

Telephone number for

directory service details.

Table: Request Detail Record Format

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

colon.

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 72 / 73

B.3 Request File Trailer Record Format

There is just one Trailer record per file, which must be the last record in the file

Ref

Identifier/

Field

Name

Data Type

Max

Lengt

h

M/O Defau

lt

Field Description /

Notes

1 Trailer Id Alphanume

ric 1 Mandatory T

T for Trailer

Must be first field on last

line in file

2

Number of

Records in

this block

Integer 3 Mandatory Maintained by Number

Hosting customer

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

Table: Request Trailer Record

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

colon.

B.4 Port-in Request File Example

H;Port In Request;0.45;Geographic Number Hosting;PT;ABC;20170406-10:02:21;

D;1;P;Business;ABC;123456789;;Testporting;Building

Name;;Street;Mealhada;1234-123abc;;;;;;1234567890;231-

Mealhada;12;1234;1234;Provider;;;10-04-2017;0900-1200;1234-1234-1234;First

Name;Last Name;1234567890;;[email protected];;;;;;;;;;;;;;;;;;;;;

D;2;P;Business;ABC;123456790;;Testporting;Building

Name;;Street;Mealhada;1234-123 abc;;;;;;1234567890;231-

Mealhada;13;1235;1235;Provider;;;10-04-2017;1400-1700;1234-1234-1235;First

Name;Last Name;1234567891;;[email protected];;;;;;;;;;;;;;;;;;;;;

Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 73 / 73

D;3;P;Business;ABC;123456791;;Testporting;Building

Name;;Street;Mealhada;1234-123 abc;;;;;;1234567890;231-

Mealhada;14;1236;1236;Provider;;;10-04-2017;0900-1200;1234-1234-1236;First

Name;Last Name;1234567892;;[email protected];;;;;;;;;;;;;;;;;;;;;

T;3;;

B.5 Excel Macro Port In requests

You can download the Macro from the Help ->User Guide section in Cocom Web Manager.