Cocom Web Manager
User Guide Unrated CDRs
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
Reseller Guide / Version / Issue Date / Description of change from previous versionGeneric Body / 1.0 / 01/04/2011 / Initial Document for Launch
1.1 / 24/08/2011 / Added more detailed information about the new CDR format
1.2 / 14/11/2011 / Added additional sample CDR files for reference
1.3 / 20/01/2012 / Updated with details of the new consolidated CDR feature
1.4 / 31/10/2012 / Updated with details of Contact Centre services
1.5 / 22/11/2012 / Updated with details of Number Hosting services
1.6 / 29/05/2013 / Further updates in reference to Contact Centre Services
1.7 / 05/09/2013 / Further updates in reference to International Contact Centre services
1.8 / 24/07/2015 / Updated to reflect the UK & France Regulatory impacts on the unrated CDRs for calls to non-geographic numbers.
1.9 / 10/08/2015 / We have extended the SIP Trunking service to the following countries: Czech Republic & Luxembourg and unrated CDRs are now available for you to download from Cocom Web Manager & FTP. The country codes now include CZ & LU as seen in appendix B.
2.0 / 27/10/2015 / Sample CDRs refreshed.
2.1 / 20/01/2016 / Updated to Reflect the new COLT logo, browser related information and Sample CDRs refreshed.
2.2 / 02/03/2017 / Replaced VoIP Access with SIP Trunking, updated to reflect browser related information in section 1.2, alternative access to Cocom Web Manager details in section 2.2, change in the notification period for planned maintenance work in section 3,addition of new countries in sectionB.1
2.3 / 08/03/2017 / We now support an enhanced ISDN service over SIP, which is a next generation version of Voice Line. Unrated CDRs for Voice Line (v) will be available under “IP Voice Line” in Cocom.
2.4 / 26/04/2017 / Additional information provided for Voice Line (v) and SIP Trunking to the CDR contents
Table of Contents
1 INTRODUCTION 4
1.1 Overview 4
1.2 Scope 5
1.3 Description 5
2 Using Cocom Web manager 6
2.1 Login To Colt Online Application 6
2.2 Access To Cocom Web Manager 7
2.3 Welcome Page On Cocom Web Manager 8
2.4 CDR Delivery 9
2.4.1 CDR File Delivery and Naming Convention 10
2.4.2 Select Profile for CDR Download 12
2.4.3 CDR Search 13
2.4.4 CDR Download 14
2.4.5 CDR File Format: 15
2.4.6 Consolidated CDR Request 15
2.4.7 Consolidated CDR Search 18
2.4.8 Consolidated CDR Download 18
2.4.9 Consolidated CDR File Format: 19
2.5 View Reseller Data 20
2.6 Documents 22
2.6.1 User Guides 22
2.6.2 VPN Access 22
2.7 Cocom Web Manager Exit 23
3 MAINTENANCE AND SUPPORT 24
4 GLOSSARY 25
APPENDIX A Call Data Record Format 27
A.1 CDR File Format 27
A.1.1 Character Coding 27
A.1.2 File Mark-up Coding 27
A.1.3 Compression/Decompression Algorithms 27
A.1.4 File Name 28
A.2 Call Detail Record Format 29
A.3 Sample Call Detail Record 31
APPENDIX B Colt Error codes 33
B.1 Country Codes 33
B.2 Call Detail Record Format 35
B.2.1 Inbound Call Scenarios 35
B.2.2 Call detail records in Germany, Austria & France 38
B.2.3 Sample Call Detail Records for Inbound Call Scenarios 39
B.2.4 Outbound Call Scenarios 44
B.2.5 Sample Call Detail Records for Outbound Call Scenarios 49
1 INTRODUCTION
1.1 Overview
Colt Technology Services (Colt) has provided you with an electronic B2B interface, Cocom, to support your product related transactions.
This includes the daily transfer of Call Detail Records (CDR) for all Colt Reseller and Carrier products. In addition it supports product-specific transactions for Reseller Connect, including the activation of Calling Line Identifier (CLIs) and Carrier Pre-selection and status queries.
Cocom Web Manager is a Graphical User Interface (GUI) and enables the Colt customers (Resellers and Carriers) to process their transactions easily and on demand.
You can still use the existing Cocom interfaces choosing their preferred protocol to transport the XML (eXtensible Mark up Language) elements via HTTPS (HyperText Transfer Protocol Secure) or you can still use the existing FTP (File Transfer Protocol) Flat File Transfer. Please refer to the Cocom FTP and Cocom XML user guides if you use these interfaces.
This user guide describes the delivery of unrated CDRs via Cocom Web Manager. Any Reseller Connect specific transactions on Cocom Web Manager are described in the Reseller Connect Web Manager user guide.
1.2 Scope
In order to use Cocom Web Manager you won’t need any additional software or development. A Browser and an Internet connection will be sufficient.
We support Internet Explorer 11, Mozilla Firefox 40 and Google Chrome 45 and test the application with the latest versions of these browsers. If you have any queries on this, please contact Colt Customer Services.
1.3 Description
The diagram below shows the principle structure of the systems and their interfaces for the delivery of unrated CDRs.
Figure 1 CDR Delivery via Cocom Web Manager and FTP
2 Using Cocom Web manager
The following section describes the login to Cocom Web Manager, the functionalities for downloading CDRs as well as general functions to download reseller data and user guides.
2.1 Login To Colt Online Application
The access to Cocom Web Manager is fully integrated into Colt’s customer portal Colt Online. Via your single login on Colt Online you can access all your Reseller Voice products from Colt on Cocom Web Manager.
Please use your Colt Online access with the following URL:
www.colt.net/online
The following Login screen will appear.
Figure 2: Colt Online Login Screen
Please proceed with the following steps:
(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 “Login” to access Colt Online.
When you first login, you will be requested to change your password.
(1) 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.
(2) If you want to create a new account, please click on “Request Login”, you will be then requested to enter your customer data to create a new account.
(3) Here you can choose the language you prefer.
2.2 Access To Cocom Web Manager
You can access Cocom Web Manager via Sales Tools in the top navigation bar.
Figure 3: Colt Online Welcome Screen
Place the mouse over the “Sales Tools” Main menu
(4) The “Cocom Web Manager” Sub menu item with link is displayed if you are an authorized user to access Cocom Web Manager. Click the “Cocom Web Manager” Sub menu link. The Cocom Web Manager application will be invoked and open the Welcome page in a new browser. Your user credentials are authenticated and enable you to access the Web Manager application
2.3 Welcome Page On Cocom Web Manager
The Welcome page will displayall available Account / Service Profiles according to your products under the Reseller Domain name which is authorized for you.
The Reseller Domainis only held in Cocom Web Manager and is a shortened version of your company name.
Account profilesare set up based on your billing account (BCN), whereas service profilesare set up per service instance. Account profiles will apply to products such as SIP Trunking and Voice Line, and service profiles will apply to Reseller Connect.
If you have more than one product on the same billing account (BCN), e.g. SIP Trunking & Voice Line, then they will have the same account profile.
Service profiles apply for the products Reseller Connect, Reseller VoIP Connect, Geographic Number Hosting, IN Number Hosting and Carrier VoIP (unrated CDRs). Service profiles enable Colt to continue to support multiple Reseller service profiles being billed on the same Colt billing account (BCN) and provide unrated CDRs per service profile to Cocom.
Your account or service profiles will conform to the new standard of up to 5 alphanumerics.
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 do any other activity.
A Reseller Domain with the status “Active” is allowed to perform functional activities based on profiles.
Figure 4 Web Manager Welcome Screen
Users are allowed to access the menus according to the Web manager Role and product-related permissions.
The welcome page displays the authorized main menu items for the User and placing the mouse over each menu will display the sub menu items with links.
2.4 CDR Delivery
CDR delivery allows you to download unrated CDRs from Cocom Web Manager which will be delivered twice a day by default.
The following sections describe the CDR delivery functionality in more detail, including:
· CDR File Delivery and Naming Convention
· Select Reseller Profile for CDR Download
· CDR Search
· CDR Download
· Consolidated CDRs
2.4.1 CDR File Delivery and Naming Convention
Twice a day, every day of the week, Colt will deposit a file of unrated Call Detail Records (CDR) into Cocom Web Manager. This will contain all of the unrated CDRs collected by the Colt network since the last file, typically every 12 hours.
The unrated CDRs will be delivered 2 working days after the call has been made.
Files transferred to and from Colt are all uniquely identified and adhere to the following file format
countrycode>_<profile>_<productidentifier>_<sequence no>_<date>.cdr.gz
Where:
· <countrycode> in ISO 2 character format
· <profile> is up to 5 alphanumerics and is the applicable profile for the product
· <productidentifier> is the product identifier (1-2 alphanumerics) – see table below
· <sequence no> is a rolling four digit sequence per <profile>_<product> combination
· <date> is YYYYMMDDHHmmss
· cdr.gz is where the file is zipped
Product Identifier / Product name01 / Reseller Connect
00 / Voice Line
10 / SIP Trunking
11 / IP Voice Line (Voice Line (v))
12 / IN for Resellers
13 / Carrier VoIP
14 / Reseller VoIP Connect
15 / Geographic Number Hosting
16 / IN Number Hosting
17 / Contact Centre
18 / International Contact Centre
The CDR files are provided in a pre-defined fixed length format, independent of country and product. These files are detailed in Appendix A and Appendix C provides more detail for Contact Centre CDR files. Please note Carrier VoIP is covered in a separate user guide.
2.4.2 Select Profile for CDR Download
Go to “CDR” at the top navigation bar and subsequently click on “CDR Download” the below screen will appear. After clicking on the “Search Profile” button without typing a search term, an overview of your existing products and profiles will be displayed . You can search for CDRs for a particular account profile or service profile by typing the profile and click on the “Search Profile” button. Then click on the arrow on the right hand side under Search.
Figure 5 Search Profile Screen
After clicking on “Arrow” button, a CDR Search page will be displayed.
2.4.3 CDR Search
Figure 6 CDR Search Screen
In the headline, you can see the product and profile which you have just chosen
Unrated CDRs will be delivered on Cocom two days after the call has been made.
The number of CDR-files will be restricted to your defined time frame. To display the CDR-files enter a start date in the “From” field and an end date in the “To” field. Enter the date in the format: DD/MM/YYYY, or alternative click on the “Calendar Symbol” to select the preferred date. For each profile you can see the corresponding OCN and BCN – note these values are not editable in Cocom Web Manager. .
Now click on the “Search” button to search for all unrated CDRs in the specified time frame or click on the “Clear” button to clear all entered fields.
2.4.4 CDR Download
After Clicking on “Search” button, a CDR list will be displayed as shown in the below screenshot. The result will be displayed according to Product and Profile. Files displayed will be in the standard format with the file size and CDR date and time stamps.
Figure 7 CDR List Screen
Select a specific CDR file and click on “Download CDR” .
Figure 8 CDR Download Screen
After clicking on the required link, a save dialog box opens as shown in above screenshot.
You will be asked to either “Open" / “Save” the file or “Cancel” the download. Select the appropriate function.
Only CDRs from the last 90 calendar days will be available.
2.4.5 CDR File Format:
All your CDR files in your reseller domain will be either zipped or plain CDR format. This has been setup based on your input to the Reseller setup form. We recommend you select zipped CDRs to ensure CDR download is completed efficiently.
2.4.6 Consolidated CDR Request
This feature enables you to place a request for a consolidated CDR file through Cocom Web Manager. Up to 90 days of CDRs can be requested, e.g. a consolidated file of a week's worth of CDRs.
Click on “CDR” and on the left side of the screen select “Consolidated CDR Request”. Search for the specific Profile.