Upload
lythuan
View
241
Download
1
Embed Size (px)
Citation preview
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 2 / 73
Document History
Soft copies of this document are maintained under change control, but hard copies are not. This
may not be a printout of the latest version.
Revision history
Revision Date Description
1.0 April, 2017 Initial Document for Launch
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 3 / 73
Table of Content
1 INTRODUCTION ......................................................................................... 5 1.1 COCOM OVERVIEW ....................................................................................... 5
1.2 SCOPE......................................................................................................... 5
1.3 DESCRIPTION ............................................................................................... 6
1.4 ACCESS TO COCOM WEB MANAGER ............................................................. 6
1.5 LOGIN TO COCOM WEB MANAGER ................................................................ 7
2 COCOM WEB MANAGER ........................................................................ 10 2.1 MENU ........................................................................................................ 10
2.2 NUMBER STATUS ....................................................................................... 11
3 PT NUMBER & PORTING INFORMATION ............................................... 13 3.1 NUMBER FORMAT ....................................................................................... 13
3.2 PORTING INFORMATION .............................................................................. 14
3.3 NUMBER LIFE CYCLE ................................................................................. 16
4 COLT NUMBERS RESERVATION ........................................................... 17 4.1 HOW TO RESERVE NUMBERS ....................................................................... 18
4.2 HOW TO EXTEND A NUMBERS RESERVATION ................................................ 20
4.3 HOW TO CANCEL A NUMBERS RESERVATION ................................................ 22
5 COLT NUMBERS ACTIVATION, DEACTIVATION AND REACTIVATION24 5.1 HOW TO ACTIVATE NUMBERS ...................................................................... 24
5.2 HOW TO DEACTIVATE ACTIVATED NUMBERS ................................................. 27
5.3 HOW TO REACTIVATE DEACTIVATED NUMBERS ............................................. 29
5.4 HOW TO ACTIVATE NUMBERS WITH BULK UPLOAD ....................................... 31
6 MANAGE PORTING ................................................................................. 33 6.1 HOW TO REQUEST NUMBERS PORT-IN .......................................................... 34
6.2 HOW TO CANCEL A PORT-IN REQUEST ........................................................ 36
6.3 BULK PORT-IN REQUEST ............................................................................ 37
7 ADDRESS UPDATE AND DIRECTORY SERVICE UPDATE ................... 40 7.1 ADDRESS UPDATE ..................................................................................... 40
7.2 DIRECTORY SERVICE UPDATE ..................................................................... 42
8 NUMBER ENQUIRY AND STATUS QUERY ............................................ 44 8.1 NUMBER ENQUIRY ...................................................................................... 44
8.2 STATUS QUERY BY TRANSACTION ID .......................................................... 45
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 4 / 73
9 UNRATED CDRS ...................................................................................... 51 9.1 HOW TO DOWNLOAD UNRATED CDRS ......................................................... 51
9.2 HOW TO DOWNLOAD CONSOLIDATED UNRATED CDRS ................................. 53
10 DOCUMENTATION ................................................................................... 57
11 GLOSSARY .............................................................................................. 58
APPENDIX A FLAT FILE FORMAT FOR BULK UPLOAD NUMBER ACTIVATION 60 A.1 REQUEST FILE HEADER RECORD FORMAT ................................................... 60
A.2 REQUEST FILE DETAIL RECORD FORMAT ...................................................... 61
A.3 REQUEST FILE TRAILER RECORD FORMAT ................................................... 64
A.4 NUMBER ACTIVATION REQUEST FILE EXAMPLE ............................................ 65
A.5 EXCEL MACRO ACTIVATION REQUEST ......................................................... 65
APPENDIX B FLAT FILE FORMAT FOR BULK UPLOAD PORTING REQUEST 66 B.1 REQUEST FILE HEADER RECORD FORMAT ................................................... 66
B.2 REQUEST FILE DETAIL RECORD FORMAT ..................................................... 67
B.3 REQUEST FILE TRAILER RECORD FORMAT ................................................... 72
B.4 PORT-IN REQUEST FILE EXAMPLE ............................................................... 72
B.5 EXCEL MACRO PORT IN REQUESTS ............................................................. 73
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 5 / 73
1 Introduction
1.1 Cocom overview
Colt Technology Services (Colt) has provided you with an electronic B2B interface, Cocom, to
support your product related transactions.
Cocom is a standardized Pan-European tool which enables you to manage your transactions per
country and product.
Cocom is accessible via different interfaces to allow for maximum choice and flexibility:
‒ Cocom Web Manager: web based interface which
allow you to proceed to your numbers transactions with with
ease and on demand, without the need to integrate with your
internal systems. It also supports account management
capabilities and provides access to user guides.
‒ Cocom API/XML Interface: XML standard based,
itenables you to connect your back-end systems in a fully
automated way. XML is used for all Cocom transactions. XML
responses are retrieved by you using query XML calls. There is
no CDR delivery via this interface.
‒ Cocom FTP: automated interface which can be accessed via a standard VPN client. It provides
twice daily delivery of unrated CDRs into protected and dedicated FTP directories.
1.2 Scope
This user guide describes how to use Graphical User Interface (GUI) Cocom Web Manager
for Colt Number Hosting, including the below transactions:
‒ Colt number reservation,
‒ Colt number activation,
‒ Number porting,
‒ Address and Directory Update,
‒ Number and status query,
‒ Transfer of twice daily unrated Call Detail Records (CDRs).
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 6 / 73
It also describes how to log-in into Cocom Web Manager, access to user guides and view
Colt Number Hosting customer data.
This user guide describes Cocom Web Manager for Colt Number Hosting in the Portugal
(PT) .
1.3 Description
The diagram below shows the principle structure of the systems and their interfaces.
Cocom Web Manager description
The GUI uses XML high security connection requests via HTTPS. All the XML Interfaces are
synchronous.
1.4 Access to Cocom Web Manager
No additional software or development is required to use Cocom Web Manager, a browser
and an Internet connection are sufficient.
Web browser compatibility - the below brower versions are recommended:
‒ Internet Explorer 11.0
‒ Mozilla Firefox 40
‒ Google Chrome 45
Cocom Web Manager is fully integrated into Colt’s customer portal ColtOnline. You access to Cocom
Web Manager with the same ColtOnline single login via the below URL:
‒ ColtOnline: https://online.colt.net/
‒ during ColtOnline downtime: https://coltcocomwebmanager.colt.net/wholesale1
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 7 / 73
1.5 Login to Cocom Web Manager
Login from ColtOnline
Colt Online Login Screen
Please proceed with the following steps:
1. Enter your Username (Authenticated by Colt in your Welcome letter)
2. Enter your Password (Authenticated by Colt in your Password letter)
3. Click on the button ‘Submit to access Colt Online. Please note that during your first login, you
will be requested to change your password.
4. If you have forgotten your password, please click on ‘Forgotten your password’. You are then
requested to enter your ‘Login ID’ and your ‘E-Mail’ address. A new password will be sent to
you by Colt Customer Service.
You can access Cocom Web Manager via Sales Tools in the top navigation bar.
Colt Online home screen
1
2
1
2
3
4
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 8 / 73
1. Place the mouse over the ‘Sales Tools’ Main menu
2. The ‘Cocom Web Manager’ Sub menu item with link is displayed if you are an authorized user
to access Cocom Web Manager. Click the ‘Cocom Web Manager’ Sub menu link.
Note: Cocom Web Manager Sub menu item with link is displayed only if the user is authorized to
access Cocom Web Manager.
Cocom Web Manager Welcome page
Cocom Web Manager Welcome page displayes all available Account and Service Profiles under your
Reseller Domain name, accordingly to your products (1).
Reseller Domain is only held in Cocom Web Manager and is a shortened version of your company
name.
Welcome page displays the authorized main menu items for a specific user, accordingling to Web
Manager Role and product-related permissions.
Web Manager Welcome Screen
3
2
1
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 9 / 73
2. On the right top corner you will find the ‘Home’, ‘Contact Us’ and ‘Logout’ navigations. Click
‘Home’ link, will refresh the screen and display the Welcome page.If you want to contact your
Colt Customer Services, click on the ‘Contact Us’ link. A screen with phone numbers and E-
Mail address of our Colt Customer Service for each of the countries will be displayed.
3. On the right corner under the top navigation bar, you can see that you are logged in with your
Username
Account profiles are set up based on your billing account (BCN), whereas service profiles are set up
per service instance:
‒ Account profiles apply to products such as Colt SIP Trunking and Colt Voice Line.
‒ Service profiles apply to Colt Number Hosting, Colt Reseller (VoIP) Connect and Colt
Carrier VoIP (unrated CDRs only). Service profile is purposed to distinguish country and a
product within the country
Note:
‒ If you have more than one product on the same billing account (BCN), e.g. Colt SIP Trunking
and Colt Voice Line, they will have the same account profile.
‒ Service profiles enable Colt to continue to support multiple service profiles being billed on the
same Colt billing account (BCN) and provide unrated CDRs per service profile to Cocom.
Your account or service profiles will conform to the standard of up to 5 alphanumeric. All your
accounts and service profiles across all products and countries are aggregated under your Reseller
Domain.
The status has two different values.
‒ ‘Disabled’ stands for a Reseller Domain which has been created but is not allowed to set up
any other activity.
‒ ‘Active’ stands for a Reseller Domainwhcih is allowed to perform functional activities based
on profiles.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 10 / 73
2 Cocom Web Manager
2.1 Menu
The following section describes the available feature for each function in Cocom Web Manager.
Which feature is available is dependent on the access rights and country configuration of the user
account. Therefore it may be that not all described features are available on your account.
MANAGE RESERVATION
Manage Reservation has the following sub-menus:
‒ Reserve Numbers: enables you to reserve a single or range of numbers.
‒ Cancel Number Reservation: enables you to cancel the reserved numbers.
‒ Extend Number Reservation: enables you to extend period of number reservation by 90
days.
MANAGE NUMBERS
The menu Manage Numbers has the following sub-menus:
‒ Activate Numbers: allows you to activate Colt numbers.
‒ Deactivate Numbers: allows you to deactivate the activated numbers.
‒ Address Update: allows you to update the address for the emergency services.
‒ Directory Service Update: allows you to add or update or cease the directory service data
‒ Number Enquiry: allows you to do the number search.
‒ Bulk Upload: allows you to request activation of numbers in a bulk using a Flat File.
MANAGE PORTING
The menu Manage Porting offers the following sub-menus:
‒ Request Port-in: allows you to send port-in request to Colt Porting Desk
‒ Cancel Port-in Request: allows you to cancel the port in request before a stipulated period.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 11 / 73
‒ Bulk Port-in Request: allows you to request port-in in a bulk using a Flat File.
CDR
CDR allows to download unrated CDRs from Cocom Web Manager which will be delivered twice a
day by default.
2.2 Number Status
The below number status are available in Cocom:
Number
Status
Description Possible actions
Free Number is free. It can be
reserved by you or by any other
Number Hosting Customer.
‒ Reservation: Number will be reserved.
Reserved Number is reserved for you and
is ready to be activated by you
only.
‒ Cancel reservation: number will be free again.
‒ Extend Reservation: reservation period will be
extended to 90 days.
‒ Activation: number will be activated and ready
to place and receive calls.
Allocated Transition status between
reservation and completion of
activation.
‒ No action.
Activated Number is live, calls can be
received and initiated.
‒ Deactivation: number will be deactivated and
not reachable.
Quarantined After number deactivation,
number goes to Quarantine
status (i.e deactivated state)
‒ Reactivation: number will be reactivated and
ready again to place and receive calls. Allowed
for the same end customer at the same
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 12 / 73
address as activation.
Port-in
(Activated)
Live ported in numbers, calls
can be received and initiated.
‒ Deactivation: number will be deactivated, not
reachable
Port-in
(Quarantined)
Deactivated ported-in numbers ‒ Port-in Reactivation
Port out Number has been ported out
from Colt
‒ No action
Returned Deactivated ported-in numbers,
returned to the range holder.
‒ No action
All This will include all the numbers
with different status (mentioned
above)
‒ No action
For additional information about number status and action allowed in the country, please refer
to Number Hosting Implementation Guide.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 13 / 73
3 PT number & porting information
3.1 Number format
The PT is divided into a number of Local Areas, part national numbering plan. Each Local Area is
associated to a code, named Local Area Code (LAC).
A geographic telephone number is structured by 3 components:
1. Local Area Code, first digits of the number and providing location infromation.
2. Main Number, which can be seen as the Local Area extension.
3. Range, the final digits of the telephone number.
In PT, geographic number length is of 9 digits, including leading zero. Please find below additional
information about number format:
Length Comments
Local Area
Code (LAC)
2 &3 digits Area code should be of 2 or 3 digits.
Main Number 2 &3 digits Main number should be of 2 or 3 digits.
Range 4 digits Range start/end should be of 4 digits.
A telephone number must be reserved, activated or ported-in into the LAC it belongs. For instance, for
numbers reservation in Mealhada, Local Area Code should be 231 (Mealhada as Local Area).
For additional information about Colt geographic coverage in the country, please refer to
Number Hosting Implementation.
Cocom in an On Demand portal, that give you freedom and full flexibility to manage your
numbers. Please respect the best practices describes in How to reserve numbers section to
reserve correctly numbers range.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 14 / 73
3.2 Porting information
After submitting a porting request in Cocom, a transaction ID is created. This transaction is called the
‘original transaction ID’. Please always track the original transaction ID for status update.
During the porting process, your transaction status is changing, accordingly to the porting process.
Please find below the possible transaction status for original portin request are available in Cocom:
Original
transaction
status
Description Possible actions
In Progress Your portInrequest has been submitted
successfully to Colt Porting Desk.
‒ You can change the portIn date or
cancel portin request.
Confirmed Your portIn request has been confirmed
by Colt Porting desk, i.e. the data you
have provided look good to proceed.
Please note that at this time, your
request has been submitted and
Accepted with the loosing provider for
given Port-Date
‒ You can change the portIn date or
cancel portin request.
Rejected Your portIn request has been rejected
by Colt Porting desk.
Reason is given in the transaction, it
could because you’ve provided
incomplete or insistant data or the
losing provider has rejected the portin
at its end.format incorrect, invalid,
rejection from the losing carrier)
‒ You will need to resubmit your
portin request based on Colt
Porting Desk guidance.
Delayed The port date is delayed because of: ‒ No action
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 15 / 73
‒ To arrange necessary porting
agreement with losing provider (in
case required)
‒ Delayed response from Losing
provider. In case of bulk porting,
losing provider may engage their
Capacity Teams for configuration
check or impact on existing traffic
etc.
Cancelled The portIn request has cancelled by
you or Colt Porting Desk.
‒ No action
Completed The portIn request is completed by
porting desk
‒ No action
Porting-in Life Cycle in Portugal:
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 16 / 73
3.3 Number Life Cycle
Please find below Colt Number Life Cycle and associated transactions:
Please find below Ported-in Number Life Cycle and associated transactions:
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 17 / 73
4 Colt Numbers reservation
This section describes how to proceed with the below transactions:
‒ Reserve numbers
‒ Cancel a numbers reservation
‒ Extend your numbers reservation
Those transactions are made from ‘Number Enquiry’ page. To access the page, from Cocom Home
page:
1. Go to ‘Manage Numbers’
2. Click on ‘Number Enquiry’
3. And select your Service Profile
Service profile selection
1
3
2
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 18 / 73
4.1 How to reserve numbers
To reserve Colt Numbers, from ‘Number Enquiry’ page:
1. Set the search criteria to:
a. Search Criteria = Number Status.
b. Number Status = Free.
2. Number type = Geographical Numbers.
3. If you want to reserve geographical numbers, select the Local Area Code.
4. Set to block size to fulfil your requirement.
5. Click on Search.
Number Enquiry for free numbers
Number Enquiry - Search Result shows you free numbers as per your criteria. To continue:
1. Select the radio button in front of the numbers you want to reserve.
2. Select reserve in user action button.
3. Click on Go.
1
1
2
3
4
5
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 19 / 73
List of free number available
On Reserve Numbers page:
1. Adjust last digit of range start to zero (ex: xxx0).
2. Adjust last digit of range end to 9 in case of range reservation (ex: xxx9). Verifiy that the
difference between range end and range start is equal to the quantity of numbers you need!
3. Customer Reference is a free text field (up to 50 characters), you can enter for instance your
end-customer name or internal reference.
4. Validate your request by clicking on Submit.
Final step for numbers reservation
On the Transaction Result page, you will find the transaction ID associated to the transaction. To
check transaction status, please refer to Status Query section.
Transaction ID for numbers reservation
3
4
1
2 3 1
2
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 20 / 73
Number Status:
‒ Numbers are now reserved for you and are ready to be activated at anytime during the
reservation period.
Notes:
‒ Numbers reservation is only allowed for free numbers.
‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding Colt
numbers reservation.
4.2 How to extend a numbers reservation
To extend Colt Numbers reservation, from ‘Number Enquiry’ page:
1. Set the search criteria to:
a. Search Criteria = Number Status.
b. Number Status = Reserved.
2. Click on Search.
Number Enquiry for reserved numbers
Number Enquiry - Search Result shows your reserved numbers. To continue:
1. Select the radio button in front of the numbers you want to extend the reservation.
2. Select Extend Reservation in user action button.
3. Click on Go.
1
1
2
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 21 / 73
List or reserved numbers
On Extend Number Reservation page:
1. Validate your request by clicking on Submit.
Reservation numbers extension
On the Transaction Result page, you will find the transaction ID associated to the transaction. To
check transaction status, please refer to Status Query section.
Number Status:
‒ Numbers are still reserved but for an additional period of 90 days. Numbers can still to be
activated at anytime.
Notes:
‒ Extend a reservation is only allowed for reserved numbers.
‒ It is not allowed to extend part of a reserved range. The whole range reserved will be
extended.
2
1 3
1
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 22 / 73
‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding Colt
numbers reservation.
4.3 How to cancel a numbers reservation
To cancel Colt Numbers reservation, from ‘Number Enquiry’ page:
1. Set the search criteria to:
a. Search Criteria = Number Status.
b. Number Status = Reserved.
2. Click on Search.
Number Enquiry for reserved numbers
Number Enquiry - Search Result shows your reserved numbers. To continue:
1. Select the radio button in front of the numbers you want to cancel the reservation.
2. Select Cancel Reservation in user action button.
3. Click on Go.
Number Enquiry, list of reserved numbers
1
1
2
2
1 3
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 23 / 73
On Cancel Number Reservation page:
1. Validate your request by clicking on Submit.
Cancelation of numbers reservation
On the Transaction Result page, you will find the transaction ID associated to the transaction. To
check transaction status, please refer to Status Query section.
Number Status:
‒ Numbers are free again. They cannot be activated by you anymore.
‒ Numbers can be reserved by any Number Hosting Customer.
Notes:
‒ Cancel a reservation is only allowed for reserved numbers.
‒ It is not allowed to cancel part of a reserved range. The whole range reserved will be
canceled.
‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding Colt
numbers reservation.
1
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 24 / 73
5 Colt Numbers activation, deactivation and
reactivation
This section explains you how to:
‒ Activate numbers
‒ Deactivate numbers already activated
‒ Reactivate numbers already deactivated
‒ Activate numbers using bulk upload
Those transactions are made from ‘Number Enquiry’ page. To access the page, please refer to Colt
Numbers reservation section.
5.1 How to activate numbers
To activate Colt Numbers, from ‘Number Enquiry’ page:
1. Set the search criteria to:
a. Search Criteria = Number Status.
b. Number Status = Reserved.
2. Click on Search.
Number Enquiry to access your reserved numbers
1
1
2
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 25 / 73
Number Enquiry - Search Result shows your reserved numbers. To continue:
1. Select the radio button in front of the numbers you want to activate
2. Select Activate in user action button
3. Click on Go
Number Enquiry, list of your reserved numbers
On Number Activation page:
1. (optional) You can update if required your Customer Reference
2. Select the Business type: Business or Residential. Enter the End Customer details:
Customer Name, Building Name/Number, Street, City, Post Code, of your end-customer.
For Business customer Type, Enter NIF. For Residential Customer Type, enter BI.
3. Validate the address using the Search Address buton.
4. (optional) – If you have subscribed to the Directory Service Update service, you can provide
the data by ticking the box. Please refer to Directory Service Update section for complete
description.
5. Validate your request by clicking on Submit
It is critical that you enter correct and accurate information about your end-customer as they
are used to route Emergency Calls and also used in case of lawfal interception request.
It’s your responsibility, as Service Provider of end-customer, to provide accurate and always
up to date information.
2
1 3
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 26 / 73
Number activation
On the Transaction Result page, you will find the transaction ID associated to the transaction. To
check transaction status, please refer to Status Query section.
Number Status:
‒ Activation process in progress: Number Status is Allocated. It’s a transitory status between
reserved and activated and is visible temporary during number activation process.
‒ Activation process completed: Number Status is Activated when
‒ Activation non-completed (error): Number Status is back to Reserved, please refer to Status
Query section for error messages support.
Notes:
‒ Numbers activation is only allowed for Reserved numbers.
2
1
3
4
5
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 27 / 73
‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding Colt
numbers activation.
5.2 How to deactivate activated numbers
To deactivate Colt Numbers, from ‘Number Enquiry’ page:
1. Set the search criteria to:
a. Search Criteria = Number Status.
b. Number Status = Activated.
2. Click on Search.
Number Enquiry for activated numbers
Number Enquiry - Search Result shows your activated numbers. To continue:
1. Select the radio button in front of the numbers you want to deactivate.
2. Select Deactivate in user action button.
3. Click on Go.
Number Enquiry, list of activated numbers
1
1
2
2
1 3
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 28 / 73
On Number Deactivation page:
1. (optional) – If you have subscribed to the Directory Service publication for the numbers, you
can remove the data from the publishers by ticking the box. Please refer to Directory Service
Update section for complete description.
2. Validate your request by clicking on Submit
Numbers deactivation
On the Transaction Result page, you will find the transaction ID associated to the transaction. To
check transaction status, please refer to Status Query section.
Number Status:
‒ Numbers are quarantined. They can be reactivated only by you during the country
quarantine period, for the same end-customer and at the same address.
‒ After that period, they will be free again and they can be reserved by any Number Hosting
Customer.
Notes:
‒ Numbers deactivation is only allowed for Actived numbers.
‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding Colt
numbers deactivation and quarantine period.
2
1
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 29 / 73
5.3 How to reactivate deactivated numbers
To reactivate Colt Numbers, from ‘Number Enquiry’ page:
1. Set the search criteria to:
a. Search Criteria = Number Status.
b. Number Status = Quarantined.
2. Click on Search.
Number Enquiry for deactivated numbers
Number Enquiry - Search Result shows your deactivated numbers. To continue:
1. Select the radio button in front of the numbers you want to reactivate.
2. Select Reactivate in user action button.
3. Click on Go.
Number Enquiry, list of deactivated numbers
1
1
2
2
1 3
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 30 / 73
On Number Reactivation page:
‒ Enter exact same end-customer details you entered during activation, as described in How to
activate numbers section.
‒ Validate your request by clicking on Submit
On the Transaction Result page, you will find the transaction ID associated to the transaction. To
check transaction status, please refer to Status Query section.
Number Status:
‒ Reactivation process in progress: Number Status is Allocated. It’s a transitory status
between quarantined and activated and is visible temporary during number reactivation
process.
‒ Reactivation process completed: Number Status is either Activated.
‒ Reactivation process non-completed (error): Number Status is back to Quarantined, please
refer to Status Query section for error messages support.
Notes:
‒ Numbers reactivation is only allowed for Quarantined numbers.
‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding Colt
numbers reactivation and quarantine period.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 31 / 73
5.4 How to activate numbers with Bulk Upload
With this function it is possible to upload a Flat-File (semicolon separated) records for Numbers
activation.
An Excel Macro provided by Colt shall be used to create this Flat-File (semicolon separated). Bulk
activation file is described and available in APPENDIX A.5.
To activate numbers with Bulk Upload, from Cocom Home page:
1. Go to ‘Manage Numbers’, then ‘Bulk upload’.
2. Select your Service Profile.
Access to bulk upload
Finally, on Bulk Upload page:
1. Upload your file by clickin choose file.
2. Select your file in the correct format as described above and click on Open.
3. Validate your request by clicking on Submit.
Numbers activation bulk upload
1 1
2
1
3
2
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 32 / 73
On the Transaction Result page, you will find the transaction ID associated to the transaction. To
check transaction status, please refer to Status Query section.
Transactions ID for numbers activation bulk upload
Number Status:
‒ Activation process in progress: Number Status is Allocated. It’s a transitory status between
reserved and activated and is visible temporary during number activation process.
‒ Activation process completed: Number Status is Activated when
‒ Activation non-completed (error): Number Status is back to Reserved, please refer to Status
Query section for error messages support.
Notes:
‒ Numbers activation is only allowed for Reserved numbers.
‒ Separate Transaction IDs are generated for each data record in the file uploaded.
‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding Colt
numbers activation and bulk upload capabilities.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 33 / 73
6 Manage Porting
This section explains you how to:
‒ Request a Port In.
‒ Cancel a Port In Request.
‒ Request Port-in via bulk using a Flat File (semicolon separated).
Please refer to the Number Hosting Implementation Guide for the country rules regarding
numbers porting.
To manage your porting, from Cocom Home page:
1. Go to ‘Manage Porting’,
2. Select the transaction you want to realize as per the above
3. Select your Service Profile
Manage porting screen
2
1
3
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 34 / 73
6.1 How to request numbers port-in
To request Numbers port-in:
1. Go to ‘Manage Porting,
2. Select ‘Request Port-in’.
3. Select your Service Profile.
Access to Request Port In Screen
Please follow the below steps:
1. Enter end customer details- Customer Name, Business type- business/residential,
NIF/BI and Customer Reference.
2. Enter exact and complete current address of your end-customer.
3. Validate the current address.
4. (optional) In case your end-customer is moving at the same time as porting, please enter
exact and complete new address – in addition to the current address.
5. (optional) Validate the new address.
6. Enter numbers detail respecting format described in the CDR
7. CDR allows to download unrated CDRs from Cocom Web Manager which will be
delivered twice a day by default.
8. section.
9. Enter the current provider operating the numbers. Please refer to Number Hosting
Implementation guide for list of providers with whom Colt has porting agreement.
10. (optional) Indicate numbers type: Single line = S; Multi line = M.
11. You can add up to 5 rows within the porting request by clicking on ‘add’ button. If you
need to port more than 5, please use the bulk upload feature as described in Bulk Port-in
Request section.
2
1
3
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 35 / 73
12. Enter port date and select porting window in accordance with the country leadtime
regarding numbers porting as described in the Implementation Guide. Enter Company
registration access code.
13. (optional) Edit your porting contact detail – Notification will be automatically sent to the
contact at any change of the porting.
14. Attach the Letter of Authorization (LOA) and Copy of Invoice.
15. Validate your request by clicking on Submit.
Request porting screen
1
8 2
5
4
3
7
6 9
11
10
13
12
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 36 / 73
On the Transaction Result page, you will find the transaction ID associated to the transaction. To
check transaction status, please refer to Status Query section.
Note:
‒ When a port in request is submitted the transaction status is “In Progress”. It means Colt
porting team has received the request and will start working.
‒ Once the porting team done with the port-in process, the status will be changed manually by
the porting team to “Completed”.
It is critical that you enter correct and accurate information about your end-customer as they
are used to route Emergency Calls and also used in case of lawfal interception request.
It’s your responsibility, as Service Provider of end-customer, to provide accurate and always
up to date information.
6.2 How to cancel a Port-In Request
To cancel a numbers port-in request:
1. Go to ‘Manage Porting,
2. Select ‘Cancel Port-in Request’.
3. Select your Service Profile.
Access to Cancel Portin Request
On ‘Cancel Port–In request’ page:
1. Enter transaction ID of the porting request you want to cancel.
1
3
2
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 37 / 73
2. (optional) Edit your porting contact detail – Notification will be automatically sent to the
contact at any change of the porting.
3. Validate your request by clicking on Submit
Cancel Port-In Request
On the Transaction Result page, you will find the transaction ID associated to the transaction. To
check transaction status, please refer to Status Query section.
Please refer to the Number Hosting Implementation Guide for the country rules regarding
numbers porting cancelation leadtime.
6.3 Bulk Port-in Request
With this function it is possible to upload a Flat-File (semicolon separated) records for Numbers
porting.
An Excel Macro provided by Colt shall be used to create this Flat-File (semicolon separated). Bulk
activation file is described and available in APPENDIX A.5.
To port-in numbers with Bulk Upload, from Cocom Home page:
1. Go to ‘Manage Porting,
2. Select ‘Bulk Port-in Request’.
1
3
2
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 38 / 73
3. Select your Service Profile.
Access to bulk upload
On Bulk Port-in Request page:
1. Upload your file by clickin choose file.
2. Select your file in the correct format as described above and click on Open.
3. Validate your request by clicking on Submit.
PortIn bulk upload
On the Transaction Result page, you will find the transaction ID associated to the transaction. To
check transaction status, please refer to Status Query section.
1
3
2
1
3
2
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 39 / 73
Transaction IDs for numbers porting bulk upload
Notes:
‒ Separate Transaction IDs are generated for each data record in the file uploaded.
‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding Colt
numbers porting and bulk upload capabilities.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 40 / 73
7 Address Update and Directory Service Update
This section describes how to proceed with the below transactions:
‒ Update your end-customer address
‒ Update your end-customer Directory publication
7.1 Address Update
To update your customer address, from Cocom Home page:
1. Go to ‘Manage Numbers’
2. Click on ‘Address Update’
3. Select your Service Profile
Access to Address Update
On Address Update page:
1. Enter the Numbers information you want to update the address: Local Area Code, Main
Number, Range start and Range end
2. Enter your Customer Name and address detail
3. Validate the address using the Search Address buton.
4. Validate your request by clicking on Submit
1
3
2
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 41 / 73
Address update screen
It is critical that you enter correct and accurate information about your end-customer as they
are used to route Emergency Calls and also used in case of lawfal interception request.
It’s your responsibility, as Service Provider of end-customer, to provide accurate and always
up to date information.
On the Transaction Result page, you will find the transaction ID associated to the transaction. To
check transaction status, please refer to Status Query section.
Number Status:
‒ Numbers are still activated, only address has been updated.
Notes:
‒ Update an address is only allowed for activated numbers.
‒ It is not allowed to update address part of an activated range. The whole range will be
updated.
‒ Please refer to the Number Hosting Implementation Guide for the country rules regarding
address update and LAC validation.
1
3
2
4
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 42 / 73
7.2 Directory Service Update
To update your customer pubilcation in the Directory Service, from Cocom Home page:
1. Go to ‘Manage Numbers’,
2. Click on ‘Directory Service Update’
3. Select your Service Profile
Note: Directory Service Update can also be done during activation and port-in request by ticking
Directory Service Update box.
Access to Directory Service Update
On Directory Service Update page:
1. Enter Number details: Local Area Code, Main Number, Range Start/End.
2. Select Order Type from the drop down: New, Cease, Amend
3. Enter end-customer information: Business/End Customer Name, Building name/Number,
Steet, City/Town, Post code and telephone number. Validate the address using Search
Address.
4. Validate your request by clicking on Submit
1
3
2
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 43 / 73
Directory Service Update Screen
On the Transaction Result page, you will find the transaction ID associated to the transaction. To
check transaction status, please refer to Status Query section.
Number Status:
‒ Numbers are still activated, only publication information have been updated.
Notes:
‒ Transaction status is shown as completed after your submission. Please expect some delay
between your request and the Diretory Service update.
1
3
2
4
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 44 / 73
8 Number Enquiry and status query
8.1 Number Enquiry
Number Enquiry is the provision to manage the actions related to number search and status/report
on numbers. The page is accessible from ‘Manage Numbers’.
Number search screen presents a drop down box as ‘Search Criteria’ which is described below:
‒ Transaction ID: to find Number Status of a particular transaction you have palced.
‒ Number Range: to find Number Status of a particular range.
‒ Customer reference: to find Number Status based on customer reference you have added
during previous transaction.
‒ Number Status: to find numbers based on their status. Please find below the status:
All
Free
Reserved
Activated
Quarantined
Port In(Activated)
Port-In(Quarantined)
Port Out
Returned
For complete description of number status and possible next actions, please refer to Error!
Reference source not found. section.
Number Enquiry result Screen
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 45 / 73
8.2 Status Query by Transaction ID
You can use this feature to view the details about your transactions requests submitted. You can view
all the transaction between a date range or for a particular transaction id.
To access to transactions status, from Cocom Home page:
‒ Go to ‘Status Query’ and click on ‘Query by Number Hosting Transaction Id’
‒ Select your Service Profile
By default this page displays the list of transaction and also it allows you to query the transactions as
described below.
Query by Number Hosting Id Screen
10
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 46 / 73
You are provided with two options for query and these are query by date or transaction Id.
‒ To query the transaction by date. Please enter ‘from’ and ‘to’ date using date pickers and
then click on ‘Search’ button.
‒ To query the transaction by Transaction Id, please enter a transaction ID in the Transaction
ID field and then click on ‘Search’ button.
A list of transaction matching the query request will be displayed on the same page. To see the
details of the transaction, please click on transaction ID link that will navigate you to ‘Search Result’
page showing the details of the transaction.
Search Result Screen
Query By Number Hosting Transaction Id
Field Description Example
Transaction ID Transaction ID provideded to user when the request is
submitted.
201304202
Transaction Type The type of transaction listed in below table. Number
Activation
Transaction Status ‘Completed’ status signals that the requests In Progress
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 47 / 73
Query By Number Hosting Transaction Id
Field Description Example
successfully completed.
‘In Progress’ status signals that the request has been
accepted and under processing. The duration to process
a request depends on the type of a transaction.
‘Failed with Error’ status signals that the requests could
not be processed. The reason for the failure is presented
on ‘Transaction Description’ field. Error scenario and
Transaction Description listed in below table.
Transaction Date
(yyyy.mm.dd-
hh:mm:ss)
Date when transaction was performed 2012.12.10-
12:00:00
Transaction
Description
Calrifies the status of the transaction. Especially useful
when transaction fails.
NumberActivation
process initiated
with
TransactionID :
201212031009
User Name User name who performed the transaction
Local Area Code Area code of the telephone number 231
Main Number Area code extensionof the telephone number 12
Range Start Number range start of the telephone number 0000
Range End Number range end of the telephone number 0009
Transaction type
Transaction Type
Number Reservation
Number Reservation Cancellation
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 48 / 73
Transaction Type
Number Reservation Extension
Number Activation
Number Deactivation
Number Reactivation
Address Update
Update Directory Services
New Port In
Cancel Port In
Update Port In Date
Port Out
Note: You can also export the transaction list to a excel file.
Error Description for transaction marked as ‘Failed with Error’.
Transaction Description Reason for failure User’s action
No search result found for
your search criteria.
User submits query on either Transaction
ID or number which do not exists in the
database.
Refine search criteria
Number Range is not
available. Please search for
another range and then try
again.
User specified the number in his
transaction request which does not exist in
the number pool.
Search for another
number
Number range is reserved
by another customer. Please
search for another number
range and try again.
User submits reservation request for the
number which is not free in the number pool
Try to reserve
another number
Request failed as the User submits deactivation request for the Check if number and
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 49 / 73
Transaction Description Reason for failure User’s action
number range is not Active. number which is not previously activated the status of the
number are correct
Request failed as the
number range is not active
or allocated.
User submits deactivation request for the
number for which prior activation failed
Check if number and
the status of the
number are correct
Number range is not
reserved. Please reserve the
number range first and then
try again.
User submits activation request for the
number which is not previously reserved
Submit reservation
request prior to
activation
The transaction ID is invalid.
Please retry with valid
transaction ID
User enters non-existing transaction ID
while submitting status query request Refine search criteria
Deactivation request failed.
For detail please contact
colt reseller support.
There was an error occurred within voice
network configuration after user
successfully submitted deactivation
request.
Raise incident with
ResellerSupport.Voic
Request failed as the OCN
does not match with the
number range.
User submitted request related to the
number which belongs to another customer
Check the number
and submit request
again
Request cannot be
processed as address
validation failed. Please
resubmit the request with
valid address.
User enters invalid address
Check the address
and submit request
again
Address validation failed as
the number of characters
exceeds the permissible
limit.
User enters too address characters longer
than allowed
Check the address
and submit request
again
Unable to process your
request due to system error.
Please try again later or
There was an internal system error for
which an incident needs to be raised with
Raise incident with
ResellerSupport.Voic
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 50 / 73
Transaction Description Reason for failure User’s action
contact your Colt
administrator.
Number range is not in
allocated state.
User submits activation request for the
number for which prior reservation request
failed
Check if number and
the status of the
number are correct
Activation request has failed
at voice network hence the
number range is reverting
from status "Allocated" to
status "Reserved".
There was an error occurred within voice
network configuration after user
successfully submitted activation request.
Raise incident with
ResellerSupport.Voic
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 51 / 73
9 Unrated CDRs
Twice a day Colt will deposit a file of unrated Call Detail Records (CDR) onto Cocom Web Manager.
This will contain all of the unrated CDRs collected by the Colt network since the last file, typically each
12 hours.
The unrated CDRs will be delivered 2 working days after the call has been made.
Only the last 90 calendar days of unrated CDRs are available for download.
This section explains you how to:
‒ How to download daily unrated CDR
‒ How to download consolidated unrated CDRs
Please note that the first CDR file will appear in Cocom Web Manager after the first call has been
made.
For more information about unrated CDRs, please check our Cocom Web manager & FTP
unrated CDRs guides.
9.1 How to download Unrated CDRs
From Home Page;
1. Go to ‘CDR’ at the top navigation bar
2. Click on ‘CDR Download’ - overview of your existing products and profiles will be displayed.
3. Enter your Service Profile
4. Click the ‘Search Profile’ button
5. Click on ‘Arrow’ button, a CDR Search page will be displayed.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 52 / 73
Search Profile Screen
On CDR search page;
1. Enter a start date in the From field
2. Enter an end date in the to field
3. Validate your request by clicking on Submit.
CDR Search Screen
On CDR List page:
1. Select a specific CDR file and click on ‘Download CDR’
CDR List Screen
A save dialog box is shown, you can save the file or open the file.
1
2
3 4
5
1 2
3
1
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 53 / 73
CDR Download Screen
CDR file format:
‒ All your CDR files in your reseller domain will be either zipped or plain CDR format. This has
been setup based on your input to the Number Hosting Customer setup form.
‒ Colt recommends you select zipped CDRs to ensure CDR download is completed efficiently.
‒ The extension .cdr may be used by other application like Corel draw and therefore may open
automatically the file. Please use the function “open with” to open it with an editor in the Flat-
File Format (semicolon seperated).
9.2 How to download consolidated unrated CDRs
This feature enables you to place a request for a consolidated CDR file through Cocom Web
Manager. Up to 90 days of CDRs can be requested, e.g. a consolidated file of a week's worth of
CDRs.
Note:
‒ When you wish to consolidate unrated CDRs, these CDRs will be delivered to Cocom Web
Manager & FTP in a compressed/zipped format.
‒ If your twice daily CDR files are already over 5MB in size, then please allow time to download
a consolidated file from Cocom Web Manager or you may find it easier to download files
greater than 5MB directly from Cocom FTP.
From Home Page;
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 54 / 73
1. Go to ‘CDR’ at the top navigation bar and click on ‘Consolidated CDR request.
2. Enter your Service Profile.
3. Click the ‘Search Profile’ button.
4. Click on ‘Arrow’ button, a CDR Search page will be displayed.
Consolidated CDR request - Select profile
On Consolidated CDR Request page;
1. Enter a start date in the From field
2. Enter an end date in the to field
3. Validate your request by clicking on Consolidated CDR.
Consolidated CDR Request
Your Consolidated CDR request will be processed. A transaction ID will be displayed on the screen.
1
2 3
1 2
3
4
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 55 / 73
Consolidated CDR Request: Transaction Result
On CDR page:
1. Click on ‘Search Consolidated CDR’
2. Enter the transaction ID for your Consolidated CDR file
3. click on search button
.
Consolidated CDR Search
If you do not enter a Transaction ID at all and leave this blank, all successfully processed transactions
for the last 5 calendar days will be displayed for the selected service profile.
On Consolidated CDR list screen:
1. Click on the Download Consolidated CDR.
Consolidated CDR Download (1)
1 2
1
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 56 / 73
A save dialog box is shown, you can save the file or open the file.
Consolidated CDR Download (2)
Format:
All Consolidated CDR files delivered to Cocom Web Manager and FTP have a filename in the
following format:<profile><transactionID>.cdr.zip.
Where:
‒ <profile> is up to 5 alphanumeric and is the applicable profile for the product
‒ <transactionID> is the combination of date and unique number, this can be used in Cocom
Web Manager to search for Consolidated CDR
‒ .cdr is the extension
‒ .zip is where the file is zipped
Example: AM220120110182.cdr.zip
The content of the consolidated CDR file is the same as the standard twice daily delivered CDRs.
Please refer to Unrated CDRs User Guides available in Cocom help section for additional information.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 57 / 73
10 Documentation
In Cocom Web Manager Help section, you will find all product related documentation for your Colt
Voice products, including Colt Number Hosting.
This includes:
‒ Colt Number Hosting user guides for Web Manager.
‒ Colt Number Hosting user guides for XML.
‒ Colt Number Hosting Implementation guide.
‒ Unrated CDRs guides (Web Manager & FTP).
‒ VPN access software and instructions.
‒ Bulk Activation / Bulk Port-in macros.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 58 / 73
11 GLOSSARY
Term Description
B2B Business to Business. Typically takes the form of automated processes between
trading partners and is performed in much higher volumes than business-to-
consumer (B2C) applications.
CDR Call Detail Record. A record that contains the details of a call made on the Colt
network. Normally used for end-customer billing purposes. Typically this will be
unrated, i.e. contains no charges but indicates the service used during the call
and the tariff band(s) that apply. If the CDR is rated, then it will include the charge
due for the call.
CLI Calling Line Identifier. A term used within Colt to mean an end-customer
telephone number such as a Directory number.
Cocom Colt Communications server. The FTP server and internal applications that
provide a file level interface allowing Resellers to request bulk activation and
deactivation of CLIs and CPS services and as well as download CDR’s for
Number Hosting product.
CPS Carrier Pre-Selection.
FTP File Transfer Protocol: is a software standard for transferring computer files
between machines with widely different operating systems. It belongs to the
application layer of the Internet protocol suite.
PT Portugal
HTML Hyper Text Mark up Language:is a markup language designed for the creation of
web pages and other information viewable in a browser. HTML is used to
structure information -denoting certain text as headings, paragraphs, lists etc.-
and can be used to define the semantics of a document
HTTP Hypertext Transfer Protocol: Is the primary method used to convey information on
the World Wide Web. The original purpose was to provide a way to publish and
receive HTML pages. The default TCP port of HTTP is 80.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 59 / 73
Term Description
HTTPS Hypertext Transfer Protocol Secure: Is the secure version of HTTP, the
communication protocol of the World Wide Web. It was invented by Netscape
Communications Corporation to provide authentication and encrypted
communication and is used in electronic commerce.
Instead of using plain text socket communication, HTTPS encrypts the session
data using either a version of the SSL (Secure Socket Layer) protocol or the TLS
(Transport Layer Security) protocol, thus ensuring reasonable protection from
eavesdroppers, and man in the middle attacks. The default TCP port of HTTPS is
443.
PTT Public Telegraph Telephony [operator]: Any fixed-line network operator but
typically the major incumbent operator within the country. Colt deals with the
following operators: France Telecom (France), Deutsche Telekom (Germany),
British Telecom (GB), Telia (Sweden), KPN (Netherlands), Belgacom (Belgium),
Austria Telekom (Austria), Telecom Italia (Italy), Eircom (Ireland), Portugal PTT
(Portugal), Telefonica (Spain), Teledenmark (Denmark). Swisscom (Switzerland).
SMTP Simple Mail Transfer Protocol: Is a relatively simple, text-based protocol, where
one or more recipients of a message are specified (and in most cases verified to
exist). The message text is transferred to the specified recipients.
SMTP uses TCP port 25.
URL Uniform Resource Locator: or Web address, is a standardized address name
layout for resources (such as documents or images) on the Internet (or
elsewhere). First created by Tim Berners-Lee for use on the World Wide Web,
the currently used forms are detailed by Internet standard RFC 1738.
WWW World Wide Web: Is an information space in which the items of interest, referred
to as resources, are identified by global identifiers called Uniform Resource
Identifiers (URLs). The term is often mistakenly used as a synonym for the
Internet, but the Web is actually a service that operates over the Internet.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 60 / 73
Term Description
XML eXtensible Mark up Language: is a W3C-recommended general-purpose markup
language for creating special-purpose markup languages. It is a simplified subset
of SGML, capable of describing many different kinds of data. Its primary purpose
is to facilitate the sharing of data across different systems, particularly systems
connected via the Internet.
APPENDIX A Flat File Format for Bulk Upload
Number activation
A.1 Request file Header Record Format
There is just one Header record per file, which must be the first record in the file.
Ref
Identifier/
Field
Name
Data Type Max
Length M/O
Defau
lt
Field Description /
Notes
1 Header Id Alphanume
ric 1 Mandatory H
Must equal character ‘H’
(without quotes)
2 Format
Description
Alphanume
ric 35 Optional none
Free format text for
information only. For
example ‘CLI Requests’
3 Version Alphanume
ric 6 Mandatory 0.1
File Format Version. This is
a required value and should
be the default value unless
otherwise instructed by Colt
4 Product ID Alphanume
ric 30 Mandatory
Geogr
aphic
Numb
er
Hostin
g
Product Name
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 61 / 73
Ref
Identifier/
Field
Name
Data Type Max
Length M/O
Defau
lt
Field Description /
Notes
5 Country ID Alpha 2 Mandatory PT Country ID in ISO-3166
Code
6 Service
Profile ID
Alphanume
ric 3 Mandatory none
This is your unique ID
allocated by Colt.
7 Creation
Date Timestamp 17 Mandatory
Curren
t Date
YYYYMMDD-hh:mm:ss
Example:
20040430-13:42:27
Table : Request Header Record
Please Note: Each field must be delimited by a semi-colon (;) and the line should end with a semi-
colon.
A.2 Request file Detail Record format
Ref Identifier/ Field Name
Data Type Max Length
M/O Default
Field Description / Notes
1
Data
Record
Identifier
Alphanume
ric 1 Mandatory D D for Detail
2 Request
Number Integer 22 Mandatory None
Record number
Starting at 1, increase by 1
with a maximum of 50. No
gaps or duplicates allowed.
The sequence is Number
Hosting customer
maintained.
3 Action Alpha 1 Mandatory None Request Type CLI:
A = Add to Switch
4 Local Area
Code Integer 3 Mandatory None
Area code should be of 2-3
digits.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 62 / 73
Ref Identifier/ Field Name
Data Type Max Length
M/O Default
Field Description / Notes
5 Main
Number Integer 3 Mandatory None
Main number should be of
2-3 digits.
6 Range start Integer 4 Mandatory None
Should be always of 4
digits. Numeric value.
Allways less or Equal than
Range End value
7 Range End Integer 4 Mandatory None
Should be always of 4
digits. Numeric value.
Allways less or Equal than
Range Start value
8
Updated
Customer
reference
Alphanume
ric 50 Optional None Customer reference Id.
Emergency Service Update- End Customer details - Mandatory
9 Customer
Name
Alphanume
ric 80 Mandatory None
End customer name/
Business name for
emergency services. Only
available for Business
customer type.
10 Building
Name
Alphanume
ric 50 Optional None
Building name for address
details of emergency
services.
Either Building name or
Number has to be entered
11 Building
Number
Alphanume
ric 20 Optional None
Building number for
address details of
emergency services.
Either Building name or
Number has to be entered
12 Street Alphanume
ric 50 Mandatory None
Street name for address
details of emergency
services.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 63 / 73
Ref Identifier/ Field Name
Data Type Max Length
M/O Default
Field Description / Notes
13 City/Town Alphanume
ric 50 Mandatory None
City or Town name for
address details of
emergency services.
14 Post Code Integer 50 Mandatory None
Postal code for address
details of emergency
service details.
Directory Services Update(Optional)
15 Order Type Alphanume
ric 10 Mandatory New
Order Status for directory
service details.
Order status is always
‘New’.
If Any of the values of the
Directory services are filled
then system will perform
the validation else not.
16
Business/E
nd
Customer
Name
Alphanume
ric 80 Mandatory None
End customer name or
business name for directory
service details.
17
DSU
Building
Name
Alphanume
ric 50 Optional None
Building name for address
details of directory services.
18
DSU
Building
Number
Alphanume
ric 20 Optional None
Building Number for
address details of directory
services.
19 DSU Street Alphanume
ric 50 Optional None
Street name for address
details of directory services.
20 DSU
City/Town
Alphanume
ric 50 Optional None
City name or Town name
for address details of
directory services.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 64 / 73
Ref Identifier/ Field Name
Data Type Max Length
M/O Default
Field Description / Notes
21 DSU Post
Code
Alphanume
ric 50 Mandatory None
Max length 50 4 digits
followed by a hyphen, then
3 digits,then a space and
then max 41 char long text.
22
DSU
Telephone
Number
Alphanume
ric 20 Optional None
Telephone number for
directory service details.
Table: Request Detail Record Format
Please Note: Each field must be delimited by a semi-colon (;) and the line should end with a semi-
colon.
A.3 Request file Trailer Record Format
Ref
Identifier/
Field
Name
Data Type Max
Length M/O
Defau
lt Field Description / Notes
1 Trailer Id Alphanume
ric 1 Mandatory T
T for Trailer
Must be first field on last line
in file
2
Number of
Records in
this block
Integer 3 Mandatory Maintained by Number
Hosting customer
3 Checksum Integer 10 Optional Blank
Value generated running
Unix checksum on this
block’s data records. By
default no checksum is
performed and the field is
empty
Table: Request Trailer Record
Please Note: Each field must be delimited by a semi-colon (;) and the line should end with a semi-
colon.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 65 / 73
A.4 Number Activation Request File Example
H;Activation Request;0.4;Geographic Number Hosting;PT;ABC;20170406-
10:43:38;
D;1;A;231-M;11;1000;1000;Test activation;Business;Name;Building Name;1;
street;City;1234-456 fsdg;;;;;;;;;
D;2;A;231-M;12;1001;1001;Test activation;Business;Name;Building
Name;2;street;City;1234-456 fsdg;;;;;;;;;
D;3;A;231-M;13;1002;1002;Test activation;Business;Name;Building
Name;3;street;City;1234-456 fsdg;;;;;;;;;
T;3;;
A.5 Excel Macro Activation Request
You can download the Macro from the Help ->User Guide section in Cocom Web Manager.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 66 / 73
APPENDIX B Flat File Format for Bulk Upload Porting
Request
B.1 Request file Header Record Format
There is just one Header record per file, which must be the first record in the file.
Ref
Identifier/
Field
Name
Data Type
Max
Lengt
h
M/O Default Field Description /
Notes
1 Header Id Alphanume
ric 1 Mandatory H
Must equal character ‘H’
(without quotes)
2 Format
Description
Alphanume
ric 35 Optional none
Free format text for
information only. For
example ‘CLI Requests’
3 Version Alphanume
ric 6 Mandatory 0.1
File Format Version. This
is a required value and
should be the default
value unless otherwise
instructed by Colt
4 Product ID Alphanume
ric 30 Mandatory
Geogra
phic
Number
Hosting
Product Name
5 Country ID Alpha 2 Mandatory PT Country ID in ISO-3166
Code
6 Service
Profile ID
Alphanume
ric 3 Mandatory none
This is your unique ID
allocated by Colt.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 67 / 73
Ref
Identifier/
Field
Name
Data Type
Max
Lengt
h
M/O Default Field Description /
Notes
7 Creation
Date Timestamp 17 Mandatory
Current
Date
YYYYMMDD-hh:mm:ss
Example:
20040430-13:42:27
Table : Request Header Record
Please Note: Each field must be delimited by a semi-colon (;) and the line should end with a semi-
colon.
B.2 Request File Detail Record Format
Ref Identifier/ Field Name
Data Type Max Length
M/O Default Field Description / Notes
1
Data
Record
Identifier
Integer 1 Mandatory D D for Detail
2 Request
Number Integer 22 Mandatory None
Record number
Starting at 1, increase by 1
with a maximum of 50. No
gaps or duplicates allowed.
The sequence is Number
Hosting customer
maintained.
3 Action Alpha 1 Mandatory None Request Type CLI:
P = Port-In
4 Customer Name
Alphanume
ric 80 Mandatory None
Only available for Business
customer type.
5 Customer
Type
Alphanume
ric 80 Mandatory None Business or Residential
6 NIF Alphanume
ric 9 Mandatory None
NIF to be entered when
Customer Type Is Business
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 68 / 73
Ref Identifier/ Field Name
Data Type Max Length
M/O Default Field Description / Notes
7 BI Alphanume
ric 12 Mandatory None
BI to be entered when
Customer Type is
Residential.
8 Customer
Reference
Alphanume
ric 50 Optional None Customer Reference Id.
Current Address Details
9 Building Name
Alphanume
ric 50 Optional None
Building name for address
details of emergency
services.
Either Building name or
Number has to be entered
10 Building Number
Alphanume
ric 20 Optional None
Building number for
address details of
emergency services.
Either Building name or
Number has to be entered
11 Street Address
Alphanume
ric 50 Mandatory None
Street name for address
details of emergency
services.
12 City / Town
Alphanume
ric 50 Mandatory None
City or Town name for
address details of
emergency services.
13 Post Code
Integer 50 Mandatory None
Post Code for address
details of emergency
services.
New Address Details (Optional)
14
New
Building
Name
Alphanume
ric 50 Optional None
Building name for address
details of emergency
services.
15
New
Building
Number
Alphanume
ric 20 Optional None
Building number for
address details of
emergency services.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 69 / 73
Ref Identifier/ Field Name
Data Type Max Length
M/O Default Field Description / Notes
16
New Street
Address
Alphanume
ric 50 Mandatory None
Street name for address
details of emergency
services.
17
New City /
Town
Alphanume
ric 50 Mandatory None
City or Town name for
address details of
emergency services.
18 New Post Code
Alphanume
ric 50 Mandatory None
Post Code for address
details of emergency
services.
CLI Details
19 Main Billing
Number
Alphanume
ric 20 Mandatory None
20 Local Area
Code
Alphanume
ric 2-3 Mandatory None
Area code should be of 2-3
digits.
21 Main
Number
Alphanume
ric 2-3 Mandatory None
Main number should be of
3 digits.
23 Range start Alphanume
ric 4 Mandatory None
Should be always of 4
digits. Numeric value.
Allways less or Equal than
Range End value
24 Range End Alphanume
ric 4 Mandatory None
Should be always of4
digits. Numeric value.
Always Greater Or Equal
than Range Start value
25 Current
Provider
Alphanume
ric 20 Mandatory None
26 Single Line Alphanume
ric 1 Optional None S
27 Multi Line Alphanume
ric 1 Optional None M
28 Porting
Date Date Time 10 Mandatory None 27-09-2016
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 70 / 73
Ref Identifier/ Field Name
Data Type Max Length
M/O Default Field Description / Notes
29 Porting
Window
Alphanume
ric 10 Mandatory None
Porting window for port-in
request, permitted value is:
"0900-1200”
“1400-1700”
30 Access
Code
Alphanume
ric 14 Mandatory None
4 digits-4 digits-4 digits e.g.
“3571-5757-7739'.
Switch Maintainer Details
31
Porting
Contact
First Name
Alphanume
ric 80 Mandatory None
32
Porting
Contact
Last Name
Alphanume
ric 50 Mandatory None
33
Porting
Contact
Phone
Integer 20 Mandatory None
34
Porting
Contact
Mobile
Integer 20 Optional None
35
Porting
Contact
Address
Alphanume
ric 50 Mandatory None
36 Letter of
Authority
Alphanume
ric Mandatory None
Porting form is separately
mail to porting helpdesk for
each request.
37 Invoice Alphanume
ric Optional None
Invoice copy is separately
mail to porting helpdesk for
each request.
Directory Services Update(Optional)
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 71 / 73
Ref Identifier/ Field Name
Data Type Max Length
M/O Default Field Description / Notes
38 Order Type Alphanume
ric 10 Mandatory New
Order Status for directory
service details.
Order status is always
‘New’.
If Any of the values of the
Directory services are filled
then system will perform
the validation else not.
39
Business/E
nd
Customer
Name
Alphanume
ric 80 Mandatory None
End customer name or
business name for directory
service details.
40
DSU
Building
Name
Alphanume
ric 50 Optional None
Building name for address
details of directory services.
41
DSU
Building
Number
Alphanume
ric 20 Optional None
Building Number for
address details of directory
services.
42 DSU Street Alphanume
ric 50 Optional None
Street name for address
details of directory services.
43 DSU
City/Town
Alphanume
ric 50 Optional None
City name or Town name
for address details of
directory services.
44 Post Code Alphanume
ric 50 Mandatory None
Max length 50 4 digits
followed by a hyphen, then
3 digits,then a space and
then max 41 char long text.
45 Telephone
Number
Alphanume
ric 20 Optional None
Telephone number for
directory service details.
Table: Request Detail Record Format
Please Note: Each field must be delimited by a semi-colon (;) and the line should end with a semi-
colon.
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 72 / 73
B.3 Request File Trailer Record Format
There is just one Trailer record per file, which must be the last record in the file
Ref
Identifier/
Field
Name
Data Type
Max
Lengt
h
M/O Defau
lt
Field Description /
Notes
1 Trailer Id Alphanume
ric 1 Mandatory T
T for Trailer
Must be first field on last
line in file
2
Number of
Records in
this block
Integer 3 Mandatory Maintained by Number
Hosting customer
3 Checksum Integer 10 Optional Blank
Value generated running
Unix checksum on this
block’s data records. By
default no checksum is
performed and the field is
empty
Table: Request Trailer Record
Please Note: Each field must be delimited by a semi-colon (;) and the line should end with a semi-
colon.
B.4 Port-in Request File Example
H;Port In Request;0.45;Geographic Number Hosting;PT;ABC;20170406-10:02:21;
D;1;P;Business;ABC;123456789;;Testporting;Building
Name;;Street;Mealhada;1234-123abc;;;;;;1234567890;231-
Mealhada;12;1234;1234;Provider;;;10-04-2017;0900-1200;1234-1234-1234;First
Name;Last Name;1234567890;;[email protected];;;;;;;;;;;;;;;;;;;;;
D;2;P;Business;ABC;123456790;;Testporting;Building
Name;;Street;Mealhada;1234-123 abc;;;;;;1234567890;231-
Mealhada;13;1235;1235;Provider;;;10-04-2017;1400-1700;1234-1234-1235;First
Name;Last Name;1234567891;;[email protected];;;;;;;;;;;;;;;;;;;;;
Colt Number Hosting – PT – Cocom Web Manager User Guide-v1.0 73 / 73
D;3;P;Business;ABC;123456791;;Testporting;Building
Name;;Street;Mealhada;1234-123 abc;;;;;;1234567890;231-
Mealhada;14;1236;1236;Provider;;;10-04-2017;0900-1200;1234-1234-1236;First
Name;Last Name;1234567892;;[email protected];;;;;;;;;;;;;;;;;;;;;
T;3;;
B.5 Excel Macro Port In requests
You can download the Macro from the Help ->User Guide section in Cocom Web Manager.