Upload
lytram
View
217
Download
0
Embed Size (px)
Citation preview
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
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
Raise incident with
ResellerSupport.Voic
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
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
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.