+ All Categories
Home > Documents > Colt Number Hosting · Colt Number Hosting ... Cocom is accessible via different interfaces to...

Colt Number Hosting · Colt Number Hosting ... Cocom is accessible via different interfaces to...

Date post: 10-Jun-2018
Category:
Upload: lytram
View: 217 times
Download: 0 times
Share this document with a friend
73
1 / 73 Colt Number Hosting Cocom Web Manager - User Guide Sweden (SE)
Transcript

1 / 73

Colt Number Hosting

Cocom Web Manager - User Guide

Sweden (SE)

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 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 September, 2016 Initial Document

1.1 February, 2017 Updated to reflect the change in

- Field name from “Subscriber ID” to

“Organization number”

- Planned maintainance notification period in

section

1.3 April, 2017 Complete refresh of the guide to reflect:

- Best practices for Cocom transactions

- Number Life Cycle

- Porting Life Cycle

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 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 NUMBERS STATUS ..................................................................................... 11

3 SE 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 REACTIVATION25 5.1 HOW TO ACTIVATE NUMBERS ...................................................................... 25

5.2 HOW TO DEACTIVATE ACTIVATED NUMBERS ................................................. 28

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

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

6 MANAGE PORTING ................................................................................. 35 6.1 HOW TO REQUEST NUMBERS PORT-IN .......................................................... 36

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

6.3 CHANGE PORT-IN DATE ............................................................................. 39

6.4 BULK PORT-IN REQUEST ............................................................................ 40

7 ADDRESS UPDATE ................................................................................. 42 7.1 ADDRESS UPDATE ..................................................................................... 42

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

8.2 STATUS QUERY BY TRANSACTION ID .......................................................... 46

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 4 / 73

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

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

10 DOCUMENTATION ................................................................................... 59

11 GLOSSARY .............................................................................................. 60

APPENDIX A FLAT FILE FORMAT FOR BULK UPLOAD NUMBER ACTIVATION 62 A.1 ‘’REQUEST FILE HEADER RECORD FORMAT .................................................. 62

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

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

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

A.5 EXCEL MACRO ACTIVATION REQUEST ......................................................... 67

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

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

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

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

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

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 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 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, it

enables 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 – SE – Cocom Web Manager User Guide-v1.3 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 Sweden

(SE).

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 is sufficient.

Web browser compatibility - the below browser versions are recommended:

‒ Internet Explorer 11.0

‒ Mozilla Firefox 40

‒ Google Chrome 45

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

Web Manager with the same Colt Online single login via the below URL:

‒ Colt Online: https://online.colt.net/

‒ during Colton line downtime: https://coltcocomwebmanager.colt.net/wholesale1

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 7 / 73

1.5 Login to Cocom Web Manager

Login from Colt Online

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 – SE – Cocom Web Manager User Guide-v1.3 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 displays 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, according to Web

Manager Role and product-related permissions.

Web Manager Welcome Screen

3

2

1

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 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 Domain which is allowed to perform functional activities based

on profiles.

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 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.

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

‒ Change Port-in Date: allows you change the port in date to a future date.

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

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 11 / 73

CDR

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

day by default.

2.2 Numbers 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

address as activation.

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 12 / 73

Port-in

(Activated)

Live ported in numbers, calls

can be received and initiated.

‒ Deactivation: number will be deactivated, not

reachable and returned to range holder.

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 – SE – Cocom Web Manager User Guide-v1.3 13 / 73

3 SE number & porting information

3.1 Number format

Sweden 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 information.

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

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

In Sweden, geographic number length is from 10 digits, including leading zero. Please find below

additional information about number format:

Length Comments

Local Area

Code (LAC)

2, 3 & 4 ‒ Local Area Code (LAC) – Drop-down menu populated

from number management system: LAC is 2-4 digits

long including 0.

Main Number 2 & 4 digits ‒ Main number is 2-4 digits long

Range 3 & 4 digits ‒ Range Start – Start of number range, which is 3 to 4

digits in length

‒ Range End – End of number range, which is 3 to 4

digits in length

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

numbers reservation in Norrköping, Local Area Code should be 011 (Norrköping as Local Area).

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

Number Hosting Implementation.

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 14 / 73

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.

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 portIn request 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

inconsistant data or the losing provider has

‒ You will need to

resubmit your portin

request based on Colt

Porting Desk guidance.

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 15 / 73

rejected the portin at its end. Format incorrect,

invalid, rejection from the losing carrier)

Delayed The port date is delayed because of:

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

‒ You can change the

portIn date or cancel

portin request.

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 SE:

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 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 – SE – Cocom Web Manager User Guide-v1.3 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 – SE – Cocom Web Manager User Guide-v1.3 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. Select numbers type = Geographical Numbers or Location Independent 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.

1

1

2

3

4

5

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 19 / 73

3. Click on Go.

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.

1 2

3

2

4

3 1

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 20 / 73

Transaction ID for numbers reservation

Numbers status:

‒ Numbers are now reserved for you and are ready to be activated at any time 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

1

1

2

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 21 / 73

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.

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.

Numbers status:

2

1 3

1

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 22 / 73

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

activated at any time.

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.

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

1

1

2

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 23 / 73

Number Enquiry, list of reserved numbersOn 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.

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

2

1 3

1

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 24 / 73

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

numbers reservation.

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 25 / 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 – SE – Cocom Web Manager User Guide-v1.3 26 / 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. Enter your Customer Name

3. (optional) Enter the Building Name of your end-customer

4. (optional) Enter the Building Number of your end customer

5. Enter the Street Name of your end-customer address

6. Enter the City Name of your end-customer address

7. Enter the Post Code of your end-customer address

8. Validate the address using the Search Address button.

9. 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 lawful 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 – SE – Cocom Web Manager User Guide-v1.3 27 / 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.

Numbers status:

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

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

‒ Activation process completed: numbers status is Activated when

‒ Activation non-completed (error): numbers status is back to Reserved; please refer to Status

Query section for error messages support.

Notes:

‒ Numbers activation is only allowed for Reserved numbers.

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

numbers activation.

2

1

3 4

5 6

7

8

9

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 28 / 73

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 – SE – Cocom Web Manager User Guide-v1.3 29 / 73

On Number Deactivation page:

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

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

5.3 How to reactivate deactivated numbers

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

1

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 30 / 73

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 – SE – Cocom Web Manager User Guide-v1.3 31 / 73

On Number Reactivation page:

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

activate numbers section.

2. Validate your request by clicking on Submit

Numbers reactivation

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.

Numbers status:

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

between quarantined and activated and is visible temporary during number reactivation

process.

‒ Reactivation process completed: numbers status is either Activated.

2

1

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 32 / 73

‒ Reactivation process non-completed (error): numbers 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.

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

1

1

2

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 33 / 73

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

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

Numbers status:

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

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

‒ Activation process completed: numbers status is Activated when

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

Query section for error messages support.

1

3

2

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 34 / 73

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 – SE – Cocom Web Manager User Guide-v1.3 35 / 73

6 Manage Porting

This section explains you how to:

‒ Request a Port In.

‒ Cancel a Port In Request.

‒ Change a Port In Date.

‒ 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 – SE – Cocom Web Manager User Guide-v1.3 36 / 73

6.1 How to request numbers port-in

To request Numbers port-in:

‒ Go to ‘Request Port–In’ page, from ‘Manage Porting’

‒ Select your Service Profile.

You will land on the below screen:

Request porting screen

1

8

2

5

4

3

7 6 9

11

10

12

13

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 37 / 73

Please follow the below steps:

1. Enter your Customer Name 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. Numbers 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.

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

numbers porting as described in the Implementation Guide. Enter Organization Number.

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 Authority (LOA).

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

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.

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 38 / 73

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:

‒ Go to ‘Cancel Port–In’ page, from ‘Manage Porting’

‒ Select your Service Profile.

On ‘Cancel Port–In request’ page:

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

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.

1

3

2

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 39 / 73

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

numbers porting cancelation leadtime.

6.3 Change Port-In Date

To change a port-in date:

‒ Go to ‘Change Port–In Date’ page, from ‘Manage Porting’.

‒ Select your Service Profile.

On ‘Change Port–In Date’ page:

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

2. Enter new date and time

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

contact at any change of the porting.

4. Validate your request by clicking on Submit

Change Port-In date

1

3

2

4

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 40 / 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.

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

numbers porting cancelation leadtime.

6.4 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’.

3. Select your Service Profile.

Access to bulk upload

1

3

2

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 41 / 73

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.

Transactions ID 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.

1

3

2

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 42 / 73

7 Address Update

This section describes how to proceed with the below transaction:

‒ Update your end-customer address

7.1 Address Update

To update your customer address, from Cocom Home page:

‒ Go to ‘Manage Numbers’, then click on ‘Address Update’

‒ Select your Service Profile

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, Customer Reference.

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

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 43 / 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.

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

1

3

2

4

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 44 / 73

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

address update and LAC validation.

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 45 / 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 numbers status of a particular transaction you have palced.

‒ Number Range: to find numbers status of a particular range.

‒ Customer reference: to find numbers 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

Port In(Activated)

Port Out

Returned

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

Status section.

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 46 / 73

Number Enquiry result Screen

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.

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 47 / 73

Query by Number Hosting Id Screen

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.

10

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 48 / 73

Search Result Screen

Query By Number Hosting Transaction Id

Field Description Example

Transaction ID Transaction ID provideded to user when the request is

submitted. 2016091714

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

Reservation

Transaction Status

‘Completed’ status signals that the requests

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.

Completed

Transaction Date Date when transaction was performed 2016.09.17

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 49 / 73

Query By Number Hosting Transaction Id

Field Description Example

(yyyy.mm.dd)

Transaction

Description

Calrifies the status of the transaction. Especially useful

when transaction fails.

Request has been

processed

successfully

User Name User name who performed the transaction BSS ROSS

Local Area Code Area code of the telephone number 01

Main Number Area code extensionof the telephone number 486

Range Start Number range start of the telephone number 0417

Range End Number range end of the telephone number 0417

Transaction type

Transaction Type

Number Reservation

Number Reservation Cancellation

Number Reservation Extension

New Port In

Cancel Port In

Update Port In Date

Address Update

Number Activation

Number Deactivation

Number Reactivation

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

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 50 / 73

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

number range is not Active.

User submits deactivation request for the

number which is not previously activated

Check if number and

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 User submitted request related to the

Check the number

and submit request

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 51 / 73

Transaction Description Reason for failure User’s action

number range. number which belongs to another customer 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

contact your Colt

administrator.

There was an internal system error for

which an incident needs to be raised with

[email protected]

Raise incident with

ResellerSupport.Voic

[email protected]

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 – SE – Cocom Web Manager User Guide-v1.3 52 / 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 – SE – Cocom Web Manager User Guide-v1.3 53 / 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’

1

2

3 4

5

1 2

3

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 54 / 73

CDR List Screen

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

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

1

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 55 / 73

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;

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

2

3

4

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 56 / 73

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.

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

1 2

3

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 57 / 73

.

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)

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

Consolidated CDR Download (2)

1 2

1

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 58 / 73

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 – SE – Cocom Web Manager User Guide-v1.3 59 / 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 – SE – Cocom Web Manager User Guide-v1.3 60 / 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.

SE Sweden

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

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 61 / 73

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

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 62 / 73

Term Description

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.

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 Default

Field Description /

Notes

1 Header Id Alphanume

ric 1 Mandatory H

Must equal character

‘H’ (without quotes)

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 63 / 73

Ref

Identifier/

Field

Name

Data Type Max

Length M/O Default

Field Description /

Notes

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

Geographic

Number

Hosting

Product Name

5 Country ID Alpha 2 Mandatory SE 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

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.

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 64 / 73

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 5 Mandatory 011

Area code should be

of 2- 4 digits

including leading 0.

5 Main Number Integer 3 Mandatory None Main number should

be of 2- 4 digits.

6 Range start Integer 4 Mandatory None

Should be always of

3-4 digits. Numeric

value. Allways less

or Equal than Range

End value

7 Range End Integer 4 Mandatory None

Should be always of

3-4 digits. Numeric

value. Allways less

or Equal than Range

Start value

8

Updated

Customer

reference

Alphanume

ric 50 Optional None

Customer reference

Id.

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 65 / 73

Ref

Identifier/ Field Name

Data Type Max Length

M/O Default Field Description / Notes

Emergency Service Update- End Customer details - Mandatory

9 Customer

Type Alpha 80 Mandatory

Business or

Residential

10 Customer

Name

Alphanume

ric 80 Mandatory None

End customer name/

Business name for

emergency services.

Only available for

Business customer

type.

11 First Name Alphanume

ric 50 Mandatory

Only available for

Residential customer

type.

12 Last Name Alphanume

ric 50 Mandatory

Only available for

Residential customer

type.

13 Building

Name

Alphanume

ric 50 Optional None

Building name for

address details of

emergency services.

14 Building

Number

Alphanume

ric 20 Optional

Building name for

address details of

emergency services.

12 Street Alphanume

ric 50 Mandatory None

Street name for

address details of

emergency services.

13 City/Town Alphanume

ric 50 Mandatory None

City or Town name

for address details of

emergency services.

14 Post Code Integer 9 Mandatory None

Postal code for

address details of

emergency service

details.

Table: Request Detail Record Format

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 66 / 73

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

Re

f

Identifier/

Field Name Data Type

Max

Length M/O Default

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.

A.4 Number Activation Request File Example

H;Activation Request;0.4;Geographic Number Hosting;SE;BE4;20160912-

16:13:21;

D;1;A;011;200;0006;0009;bulk req;Business;test;;;;1;REDAREGATAN;

NORRKÖPING;60365;

D;2;A;011;200;0020;0029;bulk req1;Business;bulk testing;;;;1;REDAREGATAN;

NORRKÖPING;60365;

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 67 / 73

T;2;;

A.5 Excel Macro Activation Request

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

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

Length

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

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 68 / 73

Ref

Identifier/

Field

Name

Data Type Max

Length

M/O Default Field Description /

Notes

4 Product ID Alphanume

ric

30 Mandatory Geographic

Number

Hosting

Product Name

5 Country ID Alpha 2 Mandatory SE 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 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

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 69 / 73

Ref

Identifier/ Field Name

Data Type Max Length

M/O Default Field Description / Notes

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

Type

Alphanume

ric 80 Mandatory None

Business or

Residential

5 Customer Name

Alphanume

ric 80 Mandatory None

Only available for

Business customer

type.

6 First Name

Alphanume

ric 50 Mandatory None

Only available for

Residential customer

type.

7 Last Name Alphanume

ric 50 Mandatory None

Only available for

Residential customer

type.

8 Customer

Reference

Alphanume

ric 50 Optional None

Customer Reference

Id.

Current Address Details

10 Building Name

Alphanume

ric 50 Optional None

Building name for

address details of

emergency services.

11 Building Number

Alphanume

ric 20 Optional None

Building number for

address details of

emergency services.

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 70 / 73

Ref

Identifier/ Field Name

Data Type Max Length

M/O Default Field Description / Notes

12 Street Address

Alphanume

ric 50 Mandatory None

Street name for

address details of

emergency services.

13 City / Town

Alphanume

ric 50 Mandatory None

City or Town name

for address details of

emergency services.

14 Post Code

Integer 6 Mandatory None

Post Code should be

numeric in current

address with the

pattern as: 1 2345 or

12 345 or 123 45 or

1234 5.

New Address Details (Optional)

15

New Building

Name

Alphanume

ric 50 Optional None

Building name for

address details of

emergency services.

16 New Building

Number

Alphanume

ric 20 Optional None

Building number for

address details of

emergency services.

17

New Street

Address

Alphanume

ric 50 Mandatory None

Street name for

address details of

emergency services.

18

New City /

Town

Alphanume

ric 50 Mandatory None

City or Town name

for address details of

emergency services.

19 New Post Code

Alphanume

ric 9 Mandatory None

Post Code should be

numeric in current

address with the

pattern as: 1 2345 or

12 345 or 123 45 or

1234 5.

CLI Details

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 71 / 73

Ref

Identifier/ Field Name

Data Type Max Length

M/O Default Field Description / Notes

20 Main Billing

Number

Alphanume

ric 20 Mandatory None

21 Local Area

Code

Alphanume

ric 4 Mandatory None

Area code should be

of 2- 4 digits

including leading 0.

22 Main Number Alphanume

ric 4 Mandatory None

Main number should

be of 2- 4 digits.

23 Range start Alphanume

ric 4 Mandatory None

Should be always of

3-4 digits. Numeric

value. Allways less

or Equal than Range

End value

24 Range End Alphanume

ric 4 Mandatory None

Should be always

of3- 4 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

29 Porting Time Alphanume

ric 10 Mandatory None

Porting time e.g:

0800-1600

30 Organization

Number Numeric 10 Mandatory None

Switch Maintainer Details

31

Porting

Contact First

Name

Alphanume

ric 80 Mandatory None

Colt Number Hosting – SE – Cocom Web Manager User Guide-v1.3 72 / 73

Ref

Identifier/ Field Name

Data Type Max Length

M/O Default Field Description / Notes

32

Porting

Contact Last

Name

Alphanume

ric 25 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

Yes and No (Y and

N). Letter of

Authorization file is

separately mail to

porting helpdesk for

each request.

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.

B.3 Request File Trailer Record Format

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

Re

f

Identifier/

Field Name

Data Type Max

Length

M/O Default Field Description /

Notes

1 Trailer Id Alphanume

ric

1 Mandatory T T for Trailer

Must be first field on last

line in file

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

Re

f

Identifier/

Field Name

Data Type Max

Length

M/O Default Field Description /

Notes

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;SE;BE4;20160915-11:18:35;

D;1;P;Business;bulk;;;UAT porting;;1;REDAREGATAN;NORRKÖPING;603

65;;;;;;123456789;011;200;1234;1234;abc;;;05-10-2016;0800-

1600;1234567890;Yamini;Choudhary;1234567890;;[email protected];

D;2;P;Business;bulk1;;;UAT;;1;REDAREGATAN;NORRKÖPING;603

65;;;;;;123456788;011;200;1235;1235;xyz;;;05-10-2016;0800-

1600;1234567890;Yamini;Choudhary;1234567899;;[email protected];

T;2;;

B.5 Excel Macro Port In requests

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


Recommended