Cocom Reseller Connect
Web Manager User Guide
Germany
Cocom Web Manager Reseller Connect DE User Guide v.2.3 1 / 99
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 Description1.0 27th Feb 2006 Initial Document for Launch
1.1 14th June 2006 Added Suspend functionality (New chapter 3.2.5), update of query
section (chapter 3.4); added new error message (Appendix B)
1.2 27th June 2006 Drop down menu now country specific for CPS Report (chapter
3.4.4)
1.3 27th July 2006 Change version number to 1.1.
CLI history function has been added in chapter 3.4 for Query CLI
Status
1.4 3rd July 2007 Added error message for Modify VoIP
1.5 15th April 2009 Maintenance & Support updated.
1.6 1st April 2011 Updated to reflect move to enhanced Cocom
1.7 24th Aug 2011 Added more detailed information about the new CDR format and
update the Error Messages Table in APPENDIX C Colt response
and Reason codes
1.8 20th Jan 2012 Updated with details of new consolidated CDR feature
1.9 16th Feb 2015 Updated the information related to Internet Browser
2.0 6th May 2015 DTAG decommission their ESAA interface and replace it with
WITA as of 30/06/2015. Updates reflect the new appt timeslot field
in a CPS request and new DTAG Response Codes & messages.
2.1 13th Aug 2015 Updated to reflect the replacement of the optional premise number
field with the mandatory Building number field in Activate CPS
request & bulk request.
2.2 4th Feb 2016 Updated to reflect the new Colt rebranding and browser related
information.
2.3 4th March 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 and change in the
notification period for planned maintenance work in section 3
Cocom Web Manager Reseller Connect DE User Guide v.2.3 2 / 99
Table of Contents1 INTRODUCTION...........................................................................................51.1 COCOM WEB MANAGER OVERVIEW.................................................................51.2 SCOPE...........................................................................................................5
2 USING COCOM WEB MANAGER................................................................72.1 LOGIN TO COLT ONLINE APPLICATION.............................................................72.2 ACCESS TO COCOM WEB MANAGER...............................................................82.3 WELCOME PAGE ON COCOM WEB MANAGER................................................102.4 MENU ITEMS.................................................................................................112.5 MANAGE CLI................................................................................................12
2.5.1 Activate CLI............................................................................................132.5.2 Deactivate CLI........................................................................................152.5.3 Modify CLI..............................................................................................172.5.4 Call Profiles CLI......................................................................................192.5.5 Bulk Upload CLI.....................................................................................21
2.6 MANAGE CPS..............................................................................................222.6.1 Activate CPS..........................................................................................22
2.7 DEACTIVATE CPS.........................................................................................262.7.1 Bulk Upload CPS....................................................................................26
2.8 STATUS QUERY............................................................................................282.8.1 Query CLI Status....................................................................................292.8.2 Query Transaction Status.......................................................................352.8.3 CLI Reports............................................................................................402.8.4 CPS Reports...........................................................................................42
2.9 CDR DELIVERY............................................................................................462.9.1 CDR File Delivery and Naming Convention...........................................462.9.2 CDR Search...........................................................................................492.9.3 CDR Download.......................................................................................502.9.4 CDR File Format:....................................................................................512.9.5 Consolidated CDR Request...................................................................512.9.6 Consolidated CDR Search.....................................................................542.9.7 Consolidated CDR Download.................................................................552.9.8 Consolidated CDR File Format:.............................................................56
2.10 VIEW RESELLER DATA..................................................................................572.11 DOCUMENTS.................................................................................................59
2.11.1User Guides.............................................................................................592.11.2VPN Access.............................................................................................59
2.12 COCOM WEB MANAGER EXIT........................................................................60
3 MAINTENANCE AND SUPPORT...............................................................614 GLOSSARY.................................................................................................62APPENDIX ACALL DATA RECORD FORMAT....................................................65A.1 CDR FILE FORMAT.......................................................................................65
A.1.1 Character Coding...................................................................................65A.1.2 File Mark-up Coding...............................................................................65A.1.3 Compression/Decompression Algorithms..............................................65A.1.4 File Name...............................................................................................65
Cocom Web Manager Reseller Connect DE User Guide v.2.3 3 / 99
A.2 CALL DETAIL RECORD FORMAT.....................................................................66A.3 SAMPLE CALL DETAIL RECORD.....................................................................69
APPENDIX B CSV-FILE FORMAT FOR BULK UPLOADS..................................69B.1 HEADER RECORD.........................................................................................69B.2 DETAIL RECORDS.........................................................................................70
APPENDIX C COLT RESPONSE AND REASON CODES...................................78ERROR CODES FROM PTT (DTAG)....................................................................86COUNTRY CODES................................................................................................96APPENDIX D ACTIVITY CODES..........................................................................99
Cocom Web Manager Reseller Connect DE User Guide v.2.3 4 / 99
1 Introduction
1.1 Cocom Web Manager 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 Colt’s Reseller and Carrier
products. In addition it supports product-specific transactions, including the activation of
Calling Line Identifier (CLIs) and Carrier Preselection (CPS) requests for Reseller Connect.
Cocom Web Manager is a Graphical User Interface (GUI) and enables the Colt customers
(Resellers and Carriers) to process their product related transactions easily and on demand.
You can still use the existing 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 how to use the Graphical User Interface for Reseller Connect,
including CLI activations, CPS requests, as well as ways to query the CLI/CPS Status and
search for error messages.
Please note that this User Guide is made especially for resellers and carriers in Germany.
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.
Internet Explorer 6.0, Internet Explorer 8.0, Mozilla Firefox 40 and Google Chrome 45
versions are the recommended browser versions on which the application has been
tested.
DescriptionThe diagram below shows the principle structure of the systems and their interfaces.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 5 / 99
Figure 1 - Reseller support infrastructureThe GUI uses XML requests which will be exchanged via HTTPS to have high security
connection. XML Interface allows additional functions such as List Requests, List
Responses, Query Request Status, Query Switch Status, and List CPS Responses.
All the XML Interfaces are synchronous and need to be invoked as and when required by
you.
You can still use the existing FTP File Transfer for flat file CSV requests or use the XML
interface directly with own developed software.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 6 / 99
Please note: CLI and CPS requests and responses are country-specific and the
functionalities will differ between countries.
colt
2 Using Cocom Web Manager
The following section describes the login to Cocom Web Manager via Colt Online, how to
download CDRs as well as manage CLI and CPS requests and responses with DTAG, view
user guides and view reseller data.
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 ScreenPlease proceed with the following steps:
(1) Enter your Username (Authenticated by Colt in your Welcome letter)
Cocom Web Manager Reseller Connect DE User Guide v.2.3 7 / 99
5
4
3
2
6
1
1
(2) Enter your Password (Authenticated by Colt in your Password letter)
(3) Click on the button “Submit” to access Colt Online.
When you 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.
(5) 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.
(6) 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(1) Place the mouse over the “Sales Tools” Main menu
Cocom Web Manager Reseller Connect DE User Guide v.2.3 8 / 99
2
1
2
3
4
5
6
1
(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. 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
Cocom Web Manager Reseller Connect DE User Guide v.2.3 9 / 99
Please Note: Cocom Web Manager Sub menu item with link will not be displayed if the
user is not authorized to access Cocom Web Manager.
2
Please Note: The alternative access to Cocom Web Manager during downtimes of Colt
Online is: https://coltcocomwebmanager.colt.net/wholesale1
2.3 Welcome Page on Cocom Web Manager
The Welcome page will display all available Account / Service Profiles according to your
products under the Reseller Domain name which is authorized for you.
The Reseller Domain is only held in Cocom Web Manager and is a shortened version of
your company name.
Account profiles are set up based on your billing account (BCN), whereas service profiles
are 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 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 set up 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
Cocom Web Manager Reseller Connect DE User Guide v.2.3 10 / 99
1
2
13
4
2 43
1
6
5
Cocom Web Manager Reseller Connect DE User Guide v.2.3 11 / 99
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
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 Menu Items
The following section describes the available feature for each function in the 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 CLIManage CLIs can provide the following features:
Activate CLI
Deactivate CLI
Modify CLI
Bulk Upload
Switch Profile
Activate and Deactivate CLI allows to activate and deactivate CLIs on the Colt switch. The
action Modify CLI allows to change the ownership of a CLI from another Reseller to your
own Reseller account. It is also possible to upload several CLIs in a CSV formatted file (Bulk Upload). The function Switch Profile allows you to suspend and unsuspend a CLI.
MANAGE CPSThe menu Manage CPS offers the following features:
Activate CPS
Cocom Web Manager Reseller Connect DE User Guide v.2.3 12 / 99
5
6
Bulk Upload
Activate CPS allows you to activate CPS. The messages will be sent to Cocom and
forwarded to the PTT. The function Deactivate CPS is not available in all countries. It is also
possible to upload several CPS requests in a CSV formatted file (Bulk Upload).
STATUS QUERYStatus Query allows you to request information for each transaction, immediately after the
transaction has been successfully carried out. Dependent on the action the status of the
transaction can change (e.g. for CPS-Requests).
CDR DELIVERYCDR Delivery allows you to download CDRs which will be delivered twice a day by default. If
available the FTP-Account as described in the “Cocom Reseller FTP User Guide” available
for all countries (Austria, Belgium, France, Germany, Ireland, Italy, Netherlands, Spain,
Sweden, UK) can be used.
2.5 Manage CLI
Manage CLIs can provide the following features:
Activate CLI
Deactivate CLI
Modify CLI
Bulk Upload
Switch Profile
Activate and Deactivate CLI allows to activate and deactivate CLIs on the Colt switch. The
action Modify CLI allows to change the ownership of a CLI from another Reseller to your
own Reseller account. It is also possible to upload several CLIs in a CSV formatted file (Bulk
Upload). The function Switch Profile allows to suspend and unsuspend a CLI.
Click on “Manage CLI” main menu to get the following screen.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 13 / 99
1
Figure 5 – Manage CLI screen(2) Activate and Deactivate CLI allows activating and deactivating the CLIs on the Colt
switch for the product: Reseller Connect.
(3) Modify CLI allows to change the ownership of a CLI from another Reseller to your
own Reseller or from one of your profiles to another of your profiles. It is also
possible to upload multiple CLIs in a CSV formatted file (Bulk Upload).
You can find the required files for a “Bulk Upload” attached in the chapter
“APPENDIX B”.
The Call Profile CLI allows you to suspend and unsuspend a CLI .
2.5.1 Activate CLI
From the Welcome Screen click on the button “Manage CLI” to get the following screen. You
can select the different functions from the menu on the left side of this screen. Click “Activate
CLI” Sub menu link and you will be navigated to “Select Profile” screen to activate a CLI
on the Colt switch.
Select a required profile to activate the CLI.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 14 / 99
4
1
2
3
5
5
1
4
3
2
Figure 6 –Select profile screen for Activate CLIThe “Profile Name” is displayed in blue color link under “Service Profile/ Account Profile”
column header. Click on the “Profile Name” with link.
The following screen will be displayed:
Figure 7 –Activate CLI ScreenPlease enter the new CLI which you want to activate with a leading zero in the “CLI Field”.
Then type in the CLI (you can enter from 5 up to 22 digits) and click “Submit” to
submit the activation. If you have made a mistake, click on the “Reset” button to clear
the entered CLI.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 15 / 99
2
2 45
2
1
54
3
The activation can take a while during which “In Progress…” will be shown. Please wait until
either a “Transaction ID”, or an error message will be shown. The error message will be
displayed if the CLI is not in the correct format.
Feature Description Example
CLI CLI with leading zero
5-22 digits including the leading
zero.
0699712345
Figure 8 –Transaction Result Screen after submitting Activate CLI
After the CLI-Request has been sent to Cocom the Transaction ID for this request will
be displayed if the transaction can be processed successfully. To check the status of this
specific transaction click on “Status Query” , select the feature “Query Transaction
status” and type the Transaction ID.
2.5.2 Deactivate CLI
To deactivate a CLI click on “Manage CLI” and select the menu “Deactivate CLI” or, if
you are already in the menu “Manage CLI” you can choose “Deactivate CLI” directly.
Select the required profile to deactivate a CLI.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 16 / 99
67
1
2
7
6
Figure 9 – Select profile Screen for CLI deactivation
Figure 10 –Deactivate CLI ScreenType the CLI in the available field. The format of the CLI needs to be the valid format as
described in chapter Activate CLI (with a leading Zero). To send this request click on the
button “Submit” . To delete the input you can either use the delete button from your
keyboard or click on the button “Reset”
The deactivation request may take a while, during which “In Progress…..” will be shown.
After the request has been successfully processed a Transaction ID will be displayed.
You can use the Transaction ID to search in the Queries for the status of this transaction.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 17 / 99
3 4
5
1
2
43
Figure 11 –Transaction Result Screen after submitting Deactivate CLI
2.5.3 Modify CLI
If you have the access rights to use the Modify function you can click on “Modify CLI”
from the “Manage CLI” menu. Modify allows to change the ownership of a CLI from one
Service Profile of another Reseller to your own Service Profile, or from one of your own
service profiles to another of your service profiles. Select a required profile to modify the
CLI on the Colt switch.
Figure 12 –Select Profile Screen for Modify CLI
Type the CLI in the available field you want to modify . The format needs to be the valid
format of a CLI as described in chapter Activate CLI (with a leading Zero).To send the
request click on the button “Submit” To delete the CLI you can either use the delete
button from your keyboard or click on the button “Reset” .
Cocom Web Manager Reseller Connect DE User Guide v.2.3 18 / 99
12
34 5
5
1
2
Figure 13 –Modify CLI ScreenThe Modify CLI request can take a while, during which time “In Progress…..” will be shown.
After the request has been successfully processed a “Transaction ID” will be displayed.
You can use the “Transaction ID” to check the status of this specific transaction click on
“Status Query”, select the feature “Query Transaction Status” and type the “Transaction ID”
and click on “Search” button.
Figure 14– Transaction Result for Modify CLI
Cocom Web Manager Reseller Connect DE User Guide v.2.3 19 / 99
5
5
4
53
2.5.4 Call Profiles CLI
Using the Call Profiles CLI menu allows you to use the suspend functionality. This
function may not be available for every reseller. If you want to use this function and the
button in the menu is not available, please contact Colt Customer Service to request this
functionality.
Select the required profile to suspend the CLI.
Figure 15 –Select Profile screen for Call Profile CLI
Type the CLI in the available field you want to suspend . The format needs to be the
valid format of a CLI as described in chapter Activate CLI (with a leading Zero) and needs to
be already active.
Click on the drop down menu of the field Suspend and select “Suspend” and click on
the Button “Submit” .
To unsuspend a CLI, please select in the dropdown menu “Unsuspend” .
Cocom Web Manager Reseller Connect DE User Guide v.2.3 20 / 99
Please note: The transaction Modify will automatically activate the CLI if not already
activated. The Switch Profile will be reset to STD (Standard) when CLI is modified with
Web Manager.
1
2
3
45
4
1
2
Figure 16 –Call Profile CLI ScreenAfter the request has been successfully processed a “Transaction ID” will be displayed. You
can use the “Transaction ID” to check the status of this specific transaction click on “Status
Query”, select the feature “Query Transaction Status” and type the “Transaction ID” and click
on “Search” button.
Switch profile Switch profile IDSuspend Call SC
Unsuspend Call CS
Cocom Web Manager Reseller Connect DE User Guide v.2.3 21 / 99
Please note: A CLI can only be unsuspended if it has been suspended before.
Please note: When a CLI is suspended the Switch Profile will be stored and if the CLI is
unsuspended the Switch Profile will be the same as before the suspend.
5
43
When a call is made for a suspended CLI the following announcement will be played:
Dieser Anschluss ist vorübergehend nicht erreichbar. Bitte rufen Sie später wieder an.When dialing the 0310 (local) or 0311 (distance) from this connection (if preselected), COLT
will still be announced as the used carrier.
2.5.5 Bulk Upload CLI
With this function you are able to upload a CSV-File with up to 499 data records for CLI
activation, deactivation or modification. Click ”Bulk Upload CLI” Sub menu link.
Please find a short description of the format in the APPENDIX B.
Select the required Profile where you want to upload the CSV File.
Figure 17 –Select Profile Screen
To upload a file you can either type the complete path and file name in the available field
or click on the “Browse” button to select a file from your disk drive.
Select a file in the correct format and click on “Open” and click “Submit” . There will be
one “Transaction ID” for all activities requested in the file.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 22 / 99
1
2
34
5
2
1
Figure 18 –Bulk Upload CLI Screen
2.6 Manage CPS
The functionalities under Manage CPS menu:
Activate CPS
Bulk Upload CPS
Activate CPS allows to activate Carrier Pre-selection. The messages will be sent to Cocom
and forwarded to your local PTT. The function Deactivate CPS is not available in all
countries. It is also possible to upload several CPS requests in a CSV formatted file (Bulk
Upload).
2.6.1 Activate CPS
From the Welcome Screen click on the button “Manage CPS” to get the following
screen. You can select the different functions from the menu on the left side of this screen
Click on the button “Activate CPS” to see the screen below. To send a CPS request to
DTAG fill in the necessary fields described below. Then select the Reseller Profile to activate
the CPS .
Cocom Web Manager Reseller Connect DE User Guide v.2.3 23 / 99
Please note: The Switch profile cannot be changed with a bulk upload request
1
23
3 5
4
Figure 19 – Select Profile Screen for Activate CPS
Enter the required valid fields and click “Submit” to process the CPS request. To delete
the input without submitting, click on the “Reset” button.
Mandatory fields are marked with a red asterisk “*”.
Figure 20 –Activate CPS Screen
Please find below the description of the features:
Cocom Web Manager Reseller Connect DE User Guide v.2.3 24 / 99
45
Please note: DTAG accepts all possible ranges for CPS activation
1
2
3
54
Mandatory fields
Feature Description ExampleCLI CLI with leading zero
5-22 digits including the leading zero. The
following prefixes are not allowed for CPS: 00,
01, 0190, 0800, 0900
Due to changes to Cocom only “Stamm-Nr” is allowed here, independently of how many CLI blocks were activated by Colt. The “Stamm-Nr” needs to be a valid DTAG number. It is not possible to send smaller parts of a range or a single Number out of a range to DTAG as it would be rejected (RNG). A CPS request with part of the range will lead to a best match conflict and not sent to DTAG.
0699712345
CPS Level CPS Level defines the calls which are allowed:
Loc – Local (CPS_2)
Dist – Distance (CPS_3)
Loc OR dist – Local or Distance (CPS_4)
Loc AND dist – Local and Distance (CPS_5)
Loc OR Dist (DTAG
activate either local or
distance or both, depending
on which value is not
active)
Customer
Request Date
Preferred date for implementation. Minimum
timeframe is three working days.
Select Tuesday, when today is
Friday.
Area Code Area Code with leading zero 069
Caller Number Telephone number (without extension) 9712345
Building Number Building Number 4
Party/Last Name Either company name or surname for a private
customer
Smith
Street Street number or PO Box number Bahnhofstraße.11
Postal Code Post Code 60528
City City/Town Frankfurt
Cocom Web Manager Reseller Connect DE User Guide v.2.3 25 / 99
Optional fields
Feature Description ExampleRange Start All possible number ranges are accepted. Number of additional
digits needs to be the same as range end.
300
Range End All possible number ranges are accepted. Number of additional
digits needs to be the same as range start.
399
Internal
Switchboard
Required if specifying a number range for a CPS request.
Value has one digit.
0
First Name For residential subscribers this field is mandatory otherwise the
order will be rejected by DTAG.
In the case of Corporate Customers this field should be blank.
Country Always Germany DE (Germany)
Appointment
Timeslot
The available appointment timeslots are:
0800-1200 CET(Mon-Sat)
1200-1600 CET(Mon-Fri)
Default value is 0800-1200 CET(Mon-Sat)
If the customer request date is a Saturday, select “9“ for
timeslot: 0800-1200 CET
0800-1200
CET(Mon-Sat)
1200-1600
CET(Mon-Fri)
Figure 21 – Transaction Result ScreenAfter the transaction has been processed the assigned “Transaction ID” will be
displayed. To activate a new CPS click again on the “Activate CPS” link.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 26 / 99
6
6
2.7 Deactivate CPS
This feature is not available in Germany.
2.7.1 Bulk Upload CPS
The Bulk Upload for CPS will be handled in the same way as Bulk Upload for CLI. You can
upload a CSV-File with up to 499 data records for CPS activation.
Please find a short description of the format in the APPENDIX B. An MS Excel macro is
provided by Colt and this can be found in the Help section in Cocom Web Manager.
Click on the button “Bulk Upload CPS” to see the screen below. Then select the Service
Profile to activate the CPS .
Figure 22 –Select Profile Screen for Bulk Upload CPS
To upload a file you can either type the complete path and file name in the available field
or click on the “Browse” button to select a file from your disk drive.
Select a file in the correct format and click on “Open” and click “Submit” . There will be
one “Transaction ID” for all activities requested in the file.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 27 / 99
Please note: The transaction Activate CPS will automatically activate the CLI if not already
activated.
Please note: There is no option available in Cocom to cancel a CPS request.
12
34
5
2
1
Figure 23 –Bulk Upload CPS Screen
Cocom Web Manager Reseller Connect DE User Guide v.2.3 28 / 99
5
4
3
2.8 Status Query
The Status Query menu offers the following features:
Query CLI Status
Query Transaction Status
CLI Reports
CPS Reports
Status Query allows to request information for each transaction, immediately after the
transaction has been successfully carried out. Dependent on the action the status of the
transaction can change (e.g. for CPS-Requests).
There are several options to query for information on your CLI and CPS transactions under
Status Query – see under below.
Figure 24– Status Query screen
Cocom Web Manager Reseller Connect DE User Guide v.2.3 29 / 99
1
1
2.8.1 Query CLI Status
Click on “Query CLI Status” to request the status of a CLI, and then select the service
profile in order to find the status of the CLI.
Figure 25 - Query CLI Status
Type the CLI in the available field to search for a CLI. You can search for one single CLI
or you can search for several CLIs starting with the same digits. In this case no wildcard
character is necessary. Click on the button “Submit” to send the request. Click on the
button “Reset” to delete your input.
You can also Search for CLI Ranges by leaving out the last numbers of a CLI
Cocom Web Manager Reseller Connect DE User Guide v.2.3 30 / 99
2
3 45
2
3
4 5
Figure 26 - Query CLI Status for several CLIs
You can download the search result into MS Excel after clicking on “Export to Excel”
icon and you can save it on your local drive.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 31 / 99
6
Figure 27 - Query CLI Search Result Screen
Figure 28 - Query CLI Search for several CLIs Result Screen
Cocom Web Manager Reseller Connect DE User Guide v.2.3 32 / 99
6
7
7
The following messages can be displayed:
CLI is active
CLI <…> is not active
CLI is owned by different account
Connection closed
The message connection closed is displayed in the unlikely case the B2B Gateway is not
available and no answer can be send back. In this case, please try the request after a while
again.
Field Description ExampleCLI CLI with leading zero 0694832101
Country Country of Reseller DE
Service Profile Service Profile AAX
Customer Group Name of the Reseller
CLI Type Text Information about CLI if available Single CLI, UNKNOWN
CLI Range Start CLI Range Start number
CLI Range End CLI Range End number
Access Number Not existing for Germany
Switchboard
Number
Switchboard Number if available
Toneburst Not existing for Germany
CPS Level CPS Level defines the calls which are
allowed:
Loc+dist – Local and Distance (CPS_5)
Loc or dist – Local or Distance (CPS_4)
Loc – Local (CPS_2)
Dist – Distance (CPS_3)
Switch Profile Switch Profile STD
CLIserv Colt internal Number
Cocom Web Manager Reseller Connect DE User Guide v.2.3 33 / 99
Field Description ExampleTariff Plan Colt internal Number
Pseudo Account
ID
Colt internal Number
Pseudo DN Colt internal Number
Suspended True if CLI is suspended True or false.
For more information on the history of this CLI, please click on the button “CLI History” .
The CLI History will be shown only for CLIs linked to your own Profile. Transactions done by
other Resellers for a CLI owned (now) by you will be displayed, but without showing the
Profile information.
“CPS-Requests” will be shown, but not the multiple responses for a CPS-Request. You will
see for the “Colt Response Code” either -1 (pending), 0 (ok) or any other “Colt Error Code”
with a short explanation in the additional “Response Text”. For a pending CPS-request no
“Transaction Date” will be shown.
Figure 29 - CLI History Result ScreenAt the end of the web page an export option is offered. You can export the whole search
result into Excel. The Excel file will include all information listed on the screen.
Field Description Example
CLI CLI with leading zero 06835956789
Transaction ID Transaction ID – not shown if
transaction is not done by own
Reseller ID
2011012294
Action Type Action ADD CLI, ADD CPS, …
Service Profile Service Profile AB4
Cocom Web Manager Reseller Connect DE User Guide v.2.3 34 / 99
7
Field Description Example
Switch Profile Switch Profile as described in the
Call Profile CLI section
Single CLI
UNKNOWN
Transaction
Date
Date when the transaction has
been sent. Format:
YYYYMMDDHHmmss
2011.01.14-10:41:40
Response Code Colt Response Code as described
in APPENDIX C Colt Response
and reason codes
0
Response Text Colt Response Text as described
in APPENDIX C Colt Response
and reason codes
OK
Additional
Response Text
Colt Additional Response Text as
described in APPENDIX C Colt
Response and reason codes
Cocom Web Manager Reseller Connect DE User Guide v.2.3 35 / 99
2.8.2 Query Transaction Status
Click on “Query Transaction Status” to search the result for a specific transaction.
Select the required Profile to find the result(s) for a particular transaction.
Figure 30 - Transaction List Screen
A list of all “Transaction IDs” will be displayed on one or more pages. The “Transactions
List” contains the following information:
(Transaction) ID
Transaction Type
Transaction Date
You can sort the list on one web page by clicking on the header line or export the list into
Excel to have a complete list in one file. To request detailed information for a single
transaction click on the “Transaction ID” link.
You can search either for a special “Transaction ID” or for several transactions
between two dates. Click on the ”Calendar Symbol” to select the “Start and the End
Date” and click on the button “Search” to send the request. If the “Transaction ID” is
Cocom Web Manager Reseller Connect DE User Guide v.2.3 36 / 99
1
7
2 34 5
5
43
2
1
6
7
known type the “Transaction ID” in the designated field and click on “Search” . To send a
new request you can either click on the button “Clear” or on “Query Transaction Status”
Figure 31 – Search Result – Query Transaction StatusExplanation of the shown fields for CLI and CPS transactions:
For CLI Transaction
Field Description Example(s)
Service Type Service Type CLI
Line ID Line ID 1
Transaction ID Transaction ID 201012292
CLI CLI with leading zero 0699712345
CLI Type Cli Type – Not available Blank or 00
Cocom Web Manager Reseller Connect DE User Guide v.2.3 37 / 99
561Please note: Only Transaction IDs generated by the Cocom Web Manager (Reference ID
Web Manager) can be requested and are displayed in this report.
For CLI Transaction
Field Description Example(s)
CLI TypeText Explanation for CliType – Not
available
Blank or Unknown
Action Activity ADD CLI, REMOVE CLI
Switch Profile Switch profile STD, SC, CS
Colt Response Date Date and time when the
response is processed by Colt
2006.01.19-19:23:46
Colt Response Code Cocom Error Code - refer to
APPENDIX C Colt Response
and reason codes
0
Colt Response Text Cocom Error Text - refer to
APPENDIX C Colt Response
and reason codes
OK
Cocom Web Manager Reseller Connect DE User Guide v.2.3 38 / 99
For CPS TransactionField Description Example(s)Service Type Service Type CPS
Transaction ID The Transaction ID 201012293
Request ID Line ID 1
CLI CLI with leading zero 0699712345
Action Activity ADD CPS
Colt Response Date Date and time when the response is
processed by Colt
2006.01.19-19:23:46
Colt Response
Code
Cocom Error Code - refer to APPENDIX
C Colt Response and reason codes
0
Colt Response Text Cocom Error Text - refer to APPENDIX
C Colt Response and reason codes
OK
CPS Level CPS Level defines the calls which are
allowed:
Loc+dist – Local and Distance (CPS_5)Loc or dist- Local or Distance (CPS_4)Loc – Local (CPS_2)
Dist – Distance (CPS_3)
CPS_5
CPS Status The status of the CPS -1 Pending/ Status
Update from PTT or
1 CPS Request failed
at Cocom Level or
0 For Success
Switch Over Date The Date on which the service is/will be
installed
2006.01.24-00:00:00
Operator Return
Code
Error Code returned from PTT – refer to
APPENDIX D Error Codes from PTT
(DTAG)
Cocom Web Manager Reseller Connect DE User Guide v.2.3 39 / 99
For CPS TransactionField Description Example(s)Operator Return
Message
Error Code returned from PTT – refer to
APPENDIX D Error Codes from PTT
(DTAG)
Cease NTF Number Left blank.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 40 / 99
2.8.3 CLI Reports
Click on “CLI Reports” to request detailed information about CLIs dependent on the
activity and the “Response Code” in a defined timeframe.
To select “Start and End Dates,” click on the “Calendar Symbol” and choose the
preferred dates.
Figure 32 – CLI Report Screen
To search for a special activity, select one of the offered actions provided in dropdown.
Menu Description
ADD CLI Activate CLI
Remove CLI Deactivate CLI
Cocom Web Manager Reseller Connect DE User Guide v.2.3 41 / 99
1
Please note: All Transactions generated by Web Manager, XML and FTP are shown in this
report.
2 3
Please note: Start and End Date are mandatory for this request. The maximum number of
days between Start and End can’t be more than 30 days, because of performance reasons.
4
4
76
5
32
1
Change CLI Change CLI – (for suspend transactions)
Transfer CLI Modify CLI – not available for every
Reseller
To search for a special response code click on the menu “Response Code” and select
one of the following codes provided in dropdown and click on the “Search” button. Click
on the button “Clear” to delete your input.
Menu DescriptionSuccess COLT Response Code 0
Warning COLT Response Code 2 or 8
Error COLT Response Code 16
Figure 33 – CLI Report Response code features
The figure below shows the search result for a “CLI Report”. The first line of the “CLI Report
Results” list shows the number of found items and which of them are shown on the
actual page. The right end of this line offers you the possibility to go to a specific page. You
can select a special page number or choose the ”First” or “Last” page as well as the
”Previous” or the “Next” page.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 42 / 99
5 67
1 2 34 5
5
Figure 34 – CLI Report resultClicking on the headline (e.g. CLI) enables you to sort the listing for the selected
feature.
At the end of the web page an export option (Export to Excel) is offered. You can export
the whole search result into Excel.
The MS Excel file will include the listed information you see on screen and some additional
fields (e.g. CPS Level, CPS Status, and Colt Reason Code).
2.8.4 CPS Reports
Click on “CPS Reports” to request detailed information about CPS in a defined time
frame. Additionally it is possible to search on activity or CPS status in this time frame.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 43 / 99
6
7
Please note: It is recommended to export the search result into excel if the result is spread
over several pages and you want sort the complete list for a specific parameter. It is
recommended to save the excel file first and open it again to use the full functionality in MS
Excel.
1
7
6
54 321
To select “Start and End Date” click on the ”Calendar Symbol” and choose the
preferred date. Under “Action” dropdown you can only choose “Add CPS”.
Figure 35 – CPS Report Screen
Cocom Web Manager Reseller Connect DE User Guide v.2.3 44 / 99
2 34
Please note: Start and End Date are mandatory for this request. The maximum number of
days between Start and End can’t be more than 30 days, because of performance reasons.
1 2 3
4
6 7
Click on the button “Search” to search for all activities and all CPS status in the specified time frame. Click on the button “Clear” to delete your input.
Figure 36 – CPS Report CPS Status features
The figure “CPS Report Result” below shows the search result for a CPS report. The first
line of the Reports list shows the number of found items and which of them are shown on the
actual page. The right end of this line offers you the possibility to a specific page. You can
select a special page number or choose the ”First” or “Last” page as well as the ”Previous”
or the “Next” page.
The line CPS Status shows the same information as response code, which is the “Response
Code” from Colt.
Figure 37 – CPS Report Result Screen
Clicking on the headline (e.g. CLI) you can sort the listing for the selected feature. The
sorting functionality for the web presentation allows only sorting per web page.
At the end of the web page an export option is offered. You can export the whole search
result into Excel . The Excel file will include the listed information and some additional
fields (e.g. CPS Level, Address information, Colt Reason Code).
Cocom Web Manager Reseller Connect DE User Guide v.2.3 45 / 99
6 7
Please note: CPS Status menu is not relevant for Germany as information about the CPS is
send in the operator error code and operator error text by DTAG. Please refer to the CPS
Report to see the relevant information.
2
3
5
Figure 38 – CPS Report Result Screen ( Status Update Message)The following features are shown on the Web page:
Line ID
Transaction ID
Reference Information
CLI
Action
Response Code
Response Text
Response Date
Switch Over Date
CPS Status
Operator Error Code1
Operator Error Text1
Cocom Web Manager Reseller Connect DE User Guide v.2.3 46 / 99
Please note: It is recommended to export the search result into excel if the result is spread
over several pages and you want sort the complete list for a specific parameter. It is
recommended to save the excel file first and open it again to use the full functionality in MS
Excel.
Please note: In case of any technical error message/response, Customer is advised to contact
Colt.
Possible Reference Information:-
Reference Information Description
WebManager Transaction send via Cocom Web Manager
Online Transaction send via XML Interface
request/abc0000055.req Transaction send via FTP
2.9 CDR Delivery
On the Welcome page you can see the menu item “CDR” and placing the mouse over each
menu will display the sub menu item “CDR download”.
CDR delivery allows 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.9.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) 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.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 47 / 99
Please note: In case of order delayed response, customer will get the update along with new
message with the new date of order delivery. Once the order is completed, customer will get
the order completion message.
Please Note: The First CDR file will appear in Cocom Web Manager after the first call
has been made.
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, note GB to be used
<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 Colt Product Name01 Reseller Connect
10 SIP Trunking
12 IN for Resellers
13 Carrier VoIP
14 Reseller VoIP Connect
The CDR files are provided in a pre-defined fixed length format, independent of country and
product. These files are detailed in Appendix.
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.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 48 / 99
1 23 45 6
Figure 39 Search Profile ScreenAfter clicking on “Arrow” button, a CDR Search page will be displayed.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 49 / 99
1
2
3
4
5
6
2.9.2 CDR Search
Figure 40 CDR Search ScreenIn 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.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 50 / 99
1
2 3
67
Please Note: Only the last 90 calendar days of unrated CDRs are available for download.
1
2 3
4 5
6 7
2.9.3 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. File displayed will
be in the standard format with the file size and CDR date and time stamps.
Figure 41 CDR List Screen
Select a specific CDR file and click on “Download CDR” .
Cocom Web Manager Reseller Connect DE User Guide v.2.3 51 / 99
1
1
Figure 42 CDR Download Screen
Cocom Web Manager Reseller Connect DE User Guide v.2.3 52 / 99
After clicking on the required link, you will be shown a save dialog box 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 days will be available.
2.9.4 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.9.5 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.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 53 / 99
Please note: 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 CSV-Format
12
Figure 43: Consolidated CDR request - Select profile
Cocom Web Manager Reseller Connect DE User Guide v.2.3 54 / 99
Please 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.
1
2
Figure 44: Consolidated CDR Request
Select Start (From) and End (To) date by clicking on the calendar Symbol and
choose the preferred date. Click on the Button “Consolidated CDR”
Your Consolidated CDR request will be processed. A transaction ID will be displayed to
the user, along with a message “Consolidated CDR file “ <profile><transactionID>.cdr.zip”
will be ready for download within the next 2 hours.”
Cocom Web Manager Reseller Connect DE User Guide v.2.3 55 / 99
3 4 5
6
3 4
5
Figure 45: Consolidated CDR Request: Transaction Result
2.9.6 Consolidated CDR Search
Click on “Search Consolidated CDR” link from left menu bar to reach to following page.
You can then input the transaction id for your Consolidated CDR file and click on search
button .
Figure 46: Consolidated CDR Search
Cocom Web Manager Reseller Connect DE User Guide v.2.3 56 / 99
789
6
7
8 9
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.
Please note if you enter part of the transaction ID, a “No result found” message will be
displayed.
2.9.7 Consolidated CDR Download
After Clicking on “Search” button, a Consolidated CDR list will be displayed as shown
in the screenshot below. The result will be displayed according to the Product and Profile.
The File displayed will be in the standard format with the file size and CDR date and time
stamp.
If the file is not present for a specific transaction ID search, it will display following error
message “No data available for selected time range”.
If the transaction ID is incorrect or invalid, the a “No Result found” message will be shown.
Figure 47: Consolidated CDR Download (1)
Select a specific Consolidated CDR file and click on “Download Consolidated CDR”
Cocom Web Manager Reseller Connect DE User Guide v.2.3 57 / 99
9
10
10
Figure 48: Consolidated CDR Download (2)
2.9.8 Consolidated CDR File 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, as described in Appendix A.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 58 / 99
2.10View Reseller Data
Click on ”View Reseller Data” Sub menu link under “Maintain Accounts” main menu to view
your Reseller data. This will provide you with the following information:
Your Reseller Domain name
Your Reseller Domain ID
Your ColtOnline username(s)
Your customer numbers (OCNs)
Your Legal customer name
Country
Product
Billing Account (BCN)
Account Profile
Service Profile
Access Type e.g. FTP / WM / XML
The details you can view relate to your Reseller Domain and your view will be restricted
based on your user role and permissions.
As a Customer Administrator you can see this information only for your own reseller domain
and if you have requested a user to be set up they may see a restricted set of data within
your reseller domain, as defined by you.
After clicking “View Reseller Data” the following screen will be displayed.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 59 / 99
Figure 49 View Reseller DataEnter text or select the required search criteria and click on the “Search” button, and the
corresponding data will be displayed . ”Clear” will clear all data in the search criteria fields.
You will see a link to username details – these are your user contact details held in
ColtOnline. Under the Address link you will see the legal company details we have on
record.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 60 / 99
Please note: This reseller data can be exported and saved as MS Excel, which may
prove useful for you, if you wish to clarify what your users can access, or if you wish to
have a record of profiles required for future product orders.
2.11Documents
In Cocom Web Manager you can find all product related documentation for your Colt
Reseller and Carrier Voice products.
This includes product user guides, VPN access software and instructions and the CLI / CPS
macros referred to earlier in this user guide.
Under the Help function you can access the latest version of all Colt documents.
2.11.1 User Guides
After clicking on “User Guides” from “Help” Tab Menu, the below page will appear
and you can download the FTP or Web Manager user guides from the link and the CLI /
CPS macros referred to in earlier sections of this document .
Figure 50 User Guides Screen
2.11.2 VPN Access
The Cocom server currently supports FTP access to dedicated and protected directories that
have been created specifically for your business. Access to the server is via a dedicated
VPN client, provided by Colt. These methods are detailed in separate documents, which you
can download in the “Help” menu.
Click “VPN Access” Sub menu link under “Help” and from here you can download the
files and related user guides.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 61 / 99
2 1 3
1 2
1
3
2
Figure 51 – Help – VPN Access Screen
2.12Cocom Web Manager Exit
Users can logout from Cocom Web Manager by clicking on the Logout link on Cocom
Web Manager. The user will be then logged out in both systems: Cocom Web Manager and
Colt Online. You can close the Browser window after logging out.
Figure 52 – Web Manager Exit Page
Cocom Web Manager Reseller Connect DE User Guide v.2.3 62 / 99
1
1
2
1
3 Maintenance and Support
The Cocom B2B Gateway Server is available 24 x 7 x 365.
Should we need to temporarily suspend access to the server, for planned maintenance, you
will be notified at least 10 days in advance and be told how long it will be suspended for.
Generally, this is an unusual occurrence (approximately once a month) and service
interruptions are brief.
Customer Service is available during normal office hours, from Monday to Friday
except during Public Holidays.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 63 / 99
4 Glossary
Term DescriptionB2B 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.
CPS Carrier Pre-Selection.
CSV Character Separated Values or
Comma Separated Values:
file format is a tabular data format that has fields separated by the comma character
and quoted by the double quote character. If a field’s value contains a double quote
character it is escaped with a pair of double quote characters.
The CSV file format does not require a specific character encoding, byte order or line
terminator format.
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.
DE Germany
Cocom Web Manager Reseller Connect DE User Guide v.2.3 64 / 99
Term DescriptionHTML 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.
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 (UK), 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.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 65 / 99
Term DescriptionURL 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.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 66 / 99
APPENDIX A Call Data Record Format
The CDR file contains only CDR records in a fixed length format. A CDR file is made
available twice per day – once in the morning and once in the afternoon. The files are
delivered at approximately 9AM and 5PM CET.
The 9 AM CET file contains calls from 4PM CET the previous day until 8AM CET on the
current day
The 5 PM CET file contains calls from 8AM CET to 4PM CET on the current day
Please note that CDR files are delivered to your directory 7 days a week and will vary in size
depending on the level of traffic that your customers generate.
A.1 CDR File Format
A.1.1 Character Coding
ASCII
A.1.2 File Mark-up Coding
No structured Mark-Up used
Fixed length records
Fixed length fields, space filled
A.1.3 Compression/Decompression Algorithms
CDR files are delivered in Zip format (Unix GZip, MS Windows Zip). However, Colt
recognizes that this can be difficult for certain companies to receive and the CDR files can
be delivered in plain text if required. Please notify Colt Customer Services if you need the
CDR files to be delivered as plain text (Uncompressed) files.
A.1.4 File Name
All unrated CDR files delivered to Cocom Web Manager and FTP have a filename in the
following format:-
Cocom Web Manager Reseller Connect DE User Guide v.2.3 67 / 99
<countrycode>_<profile>_<productidentifier>_<sequence no>_<date>.cdr.gz
Where:
<countrycode> in ISO 2 character format, note GB is used
<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 is the extension
.gz is where the file is zipped
Product Identifier Product name01 Reseller Connect
00 Voice Line
10 SIP Trunking
11 IP Voice Line
12 IN for Resellers
13 Carrier VoIP
14 Reseller VoIP Connect
Example: de_abc_01_0001_20101208090122.cdr.gz
A.2 Call Detail Record Format
The data lines are 229 bytes in length and organised as:
Ref NameBytes/Length
PositionAlpha/Numeric
Format &Description
1 Origin 20 1 N
Originating CLI with leading 0. Filler
spaces must be added to fill in the
spaces designated for a field.
2
Destination
(Terminating
)
20 21 NDestination 0 = Domestic and National,
Destination 00 = International
3 Product Type 2 41 N ‘01’=Indirect Service
Cocom Web Manager Reseller Connect DE User Guide v.2.3 68 / 99
4 Date 8 43 N YYYYMMDD
5 Time 8 51 N
HHMMSSss . Time duration is broken
up into tenths of a second. Fractions of
a second will be ignored.
6 Duration 8 59 NDuration of the call to the nearest 1/10th
of a second SSSSSSSs
7 Continuation 1 67 N
‘0’, ‘1’, ‘2’, ‘3’ or ‘5’ – normally a 0; will
be ignored for our purposes. To be
used only if calls are greater than 6
hours
8 Switch ID 25 68 N Unique switch identifier
9Trunk
incoming25 93 N Internal use only
10Trunk
outgoing25 118 N Internal use only
11Account
Code20 143 A Not in use
12 Pulses in 6 163 N Not in use
13Pulses
generated6 169 N Not in use
14 Pulses sent 6 175 N Not in use
15Service
Indicator4 181 N
0000 for standard calls, 0001 for ISDN
calls
16Charged (C-
Num)20 185 N Not in use
17Dialled (D-
Num)20 205 N Not in use
18 Carrier 3 225 AThe Reseller profile of up to 3
alphanumerics
19End of
Record1 228 A Value of zero is shown
20 Line Feed 1 229
ASCII
Control
Character
Line Feed (ASCII Control Character not
visible in plain text editors
Cocom Web Manager Reseller Connect DE User Guide v.2.3 69 / 99
Cocom Web Manager Reseller Connect DE User Guide v.2.3 70 / 99
Please note: There is an ASCII Control Character (Line Feed, HEX 0A) after the last field
19 “End of record”. This Control character generates a new line for the next CDR and
shows that the actual CDR ends. Normally you can ignore this control character except
you use a HEX-Editor to process your CDRs.
.
Please note: In Germany, the header and trailer records will no longer appear in the
unrated CDR file. They will appear as a single file in the “jobout” FTP-folder
A.3 Sample Call Detail Record
06960621234 069566061234012011011911481500000000401 00067
6960621234 0000 069566061234AAX0
06960621234 017622211234012011011911514400000008401 00067
6960621234 0000 017622211234AAX0
APPENDIX B CSV-File Format for Bulk Uploads
You can download the Cocom FTP User Guide for a detailed description of the Format
under the “Help” main menu function. Alternatively you can use the CLI & CPS macros
which can be downloaded from the Help menu – User Guides.
B.1 Header Record
There should be one header record for the file.
Ref
Identifier/ Field Name
Data Type MaxLength
M/O Default Field Description / Notes
1 Header Id Alphanum
eric
1 Mandat
ory
H Must equal
character “H”
(without quotes)
2 Format
Description
Alphanum
eric
35 Optiona
l
none Free format text for
information only.
For example “CLI
Requests”
Cocom Web Manager Reseller Connect DE User Guide v.2.3 71 / 99
Ref
Identifier/ Field Name
Data Type MaxLength
M/O Default Field Description / Notes
3 Version Alphanum
eric
6 Mandat
ory
0.01.1 File Format
Version. This is a
required value and
should be the
default value
unless otherwise
instructed by Colt
4 Creation
Date
Timestam
p
17 Mandat
ory
Current Date
in format
YYYYMMD
D-hh:mm:ss
Example:
20040430-
13:42:27
Current Date in
format
YYYYMMDD-
hh:mm:ss
B.2 Detail Records
CLI-only Detail RecordsThere can be up to 500 detail lines per Request file.
Ref Identifier/ Field Name
Data Type
MaxLength
M/O Default
Field Description / Notes
1 Data Record
Identifier
Alpha 1 Mandator
y
D Must be character “D” (without
quotes)
Cocom Web Manager Reseller Connect DE User Guide v.2.3 72 / 99
Please note: Each field must be delimited by a semi-colon (;) and the line should end
with a semi-colon.
Ref Identifier/ Field Name
Data Type
MaxLength
M/O Default
Field Description / Notes
2 Request
Number
Intege
r
Variable Mandator
y
None Record number
Starting at 1, increase by 1 with a
maximum of 500. No gaps or
duplicates allowed.
The sequence is Reseller-
maintained.
3 CLI Numer
ic
5-22 Mandator
y
None Telephone number
Because CLIs can only be
activated with the leading area
code the CLI has to begin with a
leading 0. If there is no leading
zero it will be added by Colt.
4 Action Alpha 1 Mandator
y
None Request Type CLI:
A = Add to Switch
D = Deactivate on Switch
M = Modify on Switch
Only customer with ‘modify’-
authorisation are allowed to use
the ’modify CLI’ transaction.
To prevent customers for
unauthorised use of the ’modify
CLI’ transaction, they must
request an ’activate CLI’ first.
5 Job date Alpha
numer
ic
17 Mandator
y
None Current Date in format
YYYYMMDD-hh:mm:ss
Example:
20041015-13:42:27
6 Not used Blank
7 Not used Blank
8 Not used Blank
Cocom Web Manager Reseller Connect DE User Guide v.2.3 73 / 99
Ref Identifier/ Field Name
Data Type
MaxLength
M/O Default
Field Description / Notes
9 Not used Blank
10 Not used Blank
11 Not used Blank
12 Not used Blank
13 Not used Blank
14 Not used Blank
15 Not used Blank
16 Not used Blank
17 Not used Blank
CPS and CLI/CPS Detail RecordsThere can be up to 500 detail lines per Request file.
Ref Identifier/ Field Name
Data Type
MaxLength
M/O Default Field Description / Notes
1 Data
Record
Identifier
Alpha 1 Mandatory D Must be character “D” (without
quotes)
2 Request
Number
Integer Variab
le
Mandatory None Record number
Starting at 1, increase by 1
with a maximum of 500. No
gaps or duplicates allowed.
The sequence is Reseller-
maintained.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 74 / 99
Please note: Each field must be delimited by a semi-colon (;) and the line should end with
a semi-colon. Although fields 6-17 are not currently used, they need to appear in the
request by including the semi-colon that indicates the end of the field. Please see for a
sample Request file.
Ref Identifier/ Field Name
Data Type
MaxLength
M/O Default Field Description / Notes
3 CLI Numeric 5-22 Mandatory None Telephone number
Because CLIs can only be
activated with the leading area
code the CLI has to begin with
a leading 0. If there is no
leading zero it will be added
by Colt.
CLIs with the following
prefixes cannot be used in
CPS requests:
00 01 0190 0800 0900Due to changes to Cocom only “Stamm-Nr” is allowed here, independently of how many CLI blocks were activated by Colt. The “Stamm-Nr” needs to be a valid DTAG number. It is not possible to send smaller parts of a range or a single Number out of a range to DTAG as it would be rejected (RNG). A CPS request with part of the range will lead to a best match conflict and not sent to DTAG.
4 Action Alpha 1 Mandatory None Request Type CPS only &
CLI/CPS:
C = Add to Switch and
Activate Pre-selection
Note D is not allowed.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 75 / 99
Ref Identifier/ Field Name
Data Type
MaxLength
M/O Default Field Description / Notes
5 Job date Timestamp 17 Mandatory None Current Date in format
YYYYMMDD-hh:mm:ss
Example:
20041015-13:42:27
6 Customer
Request
Date
Numeric 8 Mandatory YYYYMM
DD
Deutsche Telekom accepts a
Preferred Date of
Implementation
Format = YYYYMMDD
Minimum timeframe is three
working days..
7 CPS Level Alphanum
eric
5 Mandatory None The type of CPS service
required.
For both CPS-only and
CLI/CPS requests:
Mandatory”
CPS_5 – Local and distance (bundle)
CPS_4 – Local or Distance (DTAG activate either local or distance or both, depending on which value is not active)
CPS_3 – Distance CPS_2 – Local
8 Area Code Numeric 6 Mandatory None City code with a leading zero
9 Caller
Number
Numeric 9 Mandatory None Telephone number without
extension
Cocom Web Manager Reseller Connect DE User Guide v.2.3 76 / 99
Ref Identifier/ Field Name
Data Type
MaxLength
M/O Default Field Description / Notes
10 Range Start Numeric 6 Optional None Only required when a block of
contiguous caller numbers is
passed to DTAG.
The number of digits entered
for Range Start and Range
End must be identical,
otherwise the request will be
rejected by Cocom as the
range information is not
properly validated. E.g.
Valid combination: Range start: 00, Range End: 99.
Invalid combination: Range Start: 0, Range End: 99.
Partial range combinations are allowed, e.g. 00-09 or 10-19 or 20-29 or 90-99
Notes: Ranges apply to CPS-
only requests. There is no
range feature associated with
CLIs.
The “Stamm-Nr” needs to be
known by DTAG.
If specifying a range, the
Internal Switchboard value
must be provided.
11 Range End Numeric 6 Optional None Please refer to rule in Range
Start field description.
12 Internal
Switchboar
d
Numeric 6 Optional None Required if specifying a
number range for a CPS
request submission.
Numeric value with one digit.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 77 / 99
Ref Identifier/ Field Name
Data Type
MaxLength
M/O Default Field Description / Notes
13 First name Alphanum
eric
30 Optional None For residential subscribers this
field is mandatory or the order
will be rejected by DTAG.
In the case of a Corporate
customer this field should be
blank.
14 Party Name Alphanum
eric
60 Mandatory None Customer Name
Either:
Company name Surname for a private
customer.15 Street Alphanum
eric
40 Mandatory None Street number or PO Box
number
16 Building
Number
Alphanum
eric
10 Mandatory None Building Number
17 Postal
Code
Alphanum
eric
10 Mandatory None Postal code
18 City Alphanum
eric
40 Mandatory None City or Town
19 Country Alpha 2 Optional None Country using the ISO-3166
code. E.g. DE
20 Appointmen
t Timeslot
Numeric 1 Optional None Possible values are ‘7’ or ‘9’.Enter “9” for 0800-1200
CET(Mon-Sat)
Enter “7” for 1200-1600
CET(Mon-Fri)
Default value is “9”
If the customer request date is
a Saturday, select “9“ for
timeslot: 0800-1200 CET
Cocom Web Manager Reseller Connect DE User Guide v.2.3 78 / 99
Trailer Record
Ref Identifier/ Field Name
MaxLength
M/O Field Description / Notes
1 Trailer Id 1Mandat
ory
T for Trailer
Must be first field on last line in file
2
Number of
Records in
this block
3Optiona
lMaintained by Reseller
3 Checksum 10Optiona
l
Value generated running Unix checksum on this
block’s data records. By default no checksum is
performed and the field is empty
Request File ExamplesCLI-only request message exampleThis is from a German (DE) Reseller AAX to Deactivate CLI 02451910984 and to Activate
CLIs 02451901509 and 02451904415.
H;CLI Requests;0.01.1;20041015-09:50:28;D;1;02451910984;D;20041015-09:50:28;;;;;;;;;;;;;D;2;02451901509;A;20041015-09:50:28;;;;;;;;;;;;;D;3;02451904415;A;20041015-09:50:28;;;;;;;;;;;;;T;3;;
CPS-only request message exampleThis is from a German (DE) Reseller AAX to Activate CPS on CLIs 02151761585 and
02161307496.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 79 / 99
Please note: Each field must be delimited by a semi-colon (;) and the line should end
with a semi-colon.
Please note: Each field must be delimited by a semi-colon (;) and the line should end
with a semi-colon.
H;CPS Only Request;0.01.1;20041015-15:08:27;D;1;02151761585;C;20041015-15:08:27;20041019;CPS_5;02151;761585;;;;Werner;Brunn;Ferd-Scholling Ring;17;60283; Mönchengladbach; DE;9;D;2;02161307496;C;20041015-15:08:27;20041022;CPS_3;02161;307496;;;;Josef;Meyer;Taunusblick;32;60338;Mönchengladbach;DE;7;D;3;089480050;C;20041015-15:08:27;20041022;CPS_3;089;480050;;;;;Paulaner Brauerei GmbH & Co. KG;Hochstrasse;75;D-81541;München; DE;9;T;3;;
CLI/CPS Request message exampleThis is from a German (DE) Reseller AAX to activate three CLIs and to activate CPS on the
CLIs.
H;CLI/CPS Request;0.01.1;20041018-10:50:13;D;1;069520522;C;20041018-15:08:27;20041022;CPS_4;069;520522;;;;;Wäldches Wirtshaus & Brauerei;Am Ginnheimer Wäldchen;8;60431;Frankfurt; DE;9;D;2;069288662;C;20041018-15:08:27;20041027;CPS_4;069;288662;;;;;Erste Frankfurter Hausbrauerei Zwölf Apostel;Rosenberger Straße;1;60313;Frankfurt; DE;9;D;3;069412890;C;20041018-15:08:27;20041022;CPS_3;069;412890;;;;Werner;Stohl;Hanauer Landstraße;568;60386;Frankfurt;DE;7;T;3;;
APPENDIX C Colt response and Reason codes
Colt Response Code
Colt Response Text
Reason Code
Description Explanation
0
ok 0 or 1
Comment:
Activated for
Action Change
The requested action has been
successfully completed
Ok CPS
pending100
CLI activation has been successfully
completed, CPS request is pending
Cocom Web Manager Reseller Connect DE User Guide v.2.3 80 / 99
Colt Response Code
Colt Response Text
Reason Code
Description Explanation
-1Status
Update
CPS
CLI/CPS
Interim response sent by Deutsche
Telekom, no action required by you.
1 Data out of range
CLI is invalid.
The format of CLI is invalid. CLI must
be a number (min 5 digits, max 22
digits)
Action is
invalid.
Invalid Action for provisioning was
requested (only A, D, M, are
allowed)
Job Date is
invalid.
The date format is wrong.
Customer
Request Date
is Invalid.
Possible Causes of Error – Wrong
Data Format supplied for Carrier
Preselection. Correct Format:
YYYYMMDD.
CPS Level is
Invalid
CPS Level is wrongly specified.
Possible values CPS_2,
CPS_3,CPS_4,CPS_5.
Invalid area
Code
Area Code is missing or invalid
Invalid Caller
Number
Caller Number missing or invalid
Range Start is
invalid
Range Start is invalid
Range End is
invalid
Range end is invalid
PartyName is
Invalid
Missing Party name
Street is
invalid
Missing a value for Street
Cocom Web Manager Reseller Connect DE User Guide v.2.3 81 / 99
Colt Response Code
Colt Response Text
Reason Code
Description Explanation
Building
Number is
invalid
Building number is missing or invalid
Postal Code is
invalid
Missing a value for Postal Code field
City is invalid Missing a value for City field
cannot
suspend CLI
<cli> - service
already
suspended
The CLI which should be suspended
is already suspended.
cannot
unsuspend
CLI <cli> -
service not
suspended
The CLI which should be
unsuspended is not suspended.
2 object
already
exists
101
CPS Pending,
object already
exists
CLI is already active, however CPS
is pending
1110 best match
conflict with cli
<cli>
There is a best match conflict, which
can happen if a CLI is provisioned or
deprovisioned which is part of a stub
Cocom Web Manager Reseller Connect DE User Guide v.2.3 82 / 99
Colt Response Code
Colt Response Text
Reason Code
Description Explanation
1111direct conflict
with cli <cli>
The CLI is already provisioned and
has been tried to be provisioned
again. The request has been
submitted for a range of CLIs. The
CLI this response relates to is
already active on the switch. The
CPS request is proceeding normally.
You will probably get a response for
each CLI in the range.
If this is a single occurrence in the
range investigation is required.
1210CLI <cli>
already active
The CLI has been already activated
on the switch
1211CLI already
active
The CLI has been already activated
on the switch
1213cli is already
activated
A CLI activation has already been
send and is now in process
1214
cli already
activated by
modify
A modify command will automatically
activate the CLI if not already active.
1250
Account of cli
has been
modified
Will be sent if and only if there is a
pending modify request on the cli the
Reseller requested a deactivate for
AND the modify has been issued by
a different Reseller
1251 original
account for cli
has changed
Will be sent if and only if there is a
pending modify request on the cli the
Reseller requested to activate for.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 83 / 99
Colt Response Code
Colt Response Text
Reason Code
Description Explanation
1260
Could not
process
current
request -
Pending CPS
request
Will be sent in case the Reseller
requests any action on a CLI while
there is a CPS request that is either
still pending in Cocom which was
sent in the last 7 days OR no final
response has been received from
the PTT. More information provided
below this table.
8100
Account
<account>
cannot modify
its own CLI
Reseller has tried to modify a CLI
which has already been assigned to
him
8101
The target
account must
be different
from the
original
account
Will only be seen by Colt. It indicates
that CS has attempted to transfer a
CLI to a reseller who already owns
the CLI. The message that would be
delivered to a reseller in that case
would be “2 object already exists
account <account id> cannot modify
its own CLI”
8 object does
not exist
These error messages can only
occur for deactivation requests
This message without any other
comment will be shown for a
suspend command which has been
send during a previous suspend
command which is already
processing
1250 Account of cli
has been
modified
Cocom Web Manager Reseller Connect DE User Guide v.2.3 84 / 99
Colt Response Code
Colt Response Text
Reason Code
Description Explanation
1305
Cannot
suspend
unknown CLI
<cli>
CLI is not activated on the switch
1306
Cannot
unsuspend
unknown CLI
<cli>
CLI is not activated on the switch
7021range not
available
7901
No CPS found
for action
DEACTIVATE
8000
Account
<account>
does not exist.
8110 Account
<account>
cannot submit
CPS requests
for CLI of
another
account (best
match)
Cocom Web Manager Reseller Connect DE User Guide v.2.3 85 / 99
Colt Response Code
Colt Response Text
Reason Code
Description Explanation
8111
Account
<account>
cannot submit
CPS requests
for CLI of
another
account (direct
conflict)
8112
Account
<account>
cannot
deactivate cli
of another
account
This message will as well be shown
if a CLI of another reseller is
suspended.
16
unknown
error
Reseller has not sufficient rights or
privileges to process the requested
action
CPS already active
If CPS is already active in Cocom
and reseller submits redundant CPS
activate request
LINE_IDXVER
_01/9:CALLE
R ID 0 IS NOT
FOUND::LINE
_IDXVER_01/
12:INVALID
RESELLER
OBJECT
When system finds error in the
switch response
8001 Account is
locked
Cocom Web Manager Reseller Connect DE User Guide v.2.3 86 / 99
Colt Response Code
Colt Response Text
Reason Code
Description Explanation
8002
account is not
allowed to
activate
8003
account is not
allowed to
deactivate
8004
account is not
allowed to
modify
Account do not have the right for
modifcations
8004
Modify
between Voice
and VoIP not
allowed
Account do not have the right for
modifications between a Voice ID
(Reseller Voice Connect) and VoIP
ID (Reseller VoIP Connet).
8010
account is not
allowed to
perform a
CPS activate
Table - Cocom Validation Codes and Text
Message Message Message Description Explanation
Cocom Web Manager Reseller Connect DE User Guide v.2.3 87 / 99
Please note: A CPS request will be successfully validated and sent to DTAG, even if the
CLI was pre-selected successfully in the past. This is due to the fact that CPS deactivation
requests may have been sent direct to DTAG, since the original CPS request.
Code Type0 B2BGateway Success Message/OK
-1 B2BGateway
Unable to process your request
[additional explanation]
Validation Failed, e.g.
Infrastructure Error from
Cocom, missing request file,
wrong characters
0 cocom OK – Success
99 Cocom
Cannot process your request!
Please contact customer service
support!
No connection between B2B
Gateway and Cocom
Table – B2B Gateway error Codes
Error codes from PTT (DTAG)
The following tables are from documents produced by Deutsche Telekom.
A.1.1 Interim status codes
These response codes reflect the interim status from Deutsche Telekom and do not require
any action from you in Cocom.
Error Code Description Explanation
0000 Keine Änderung zum Auftrag Der Auftrag wird regulär weiterbearbeitet.
Kein Handlungsbedarf.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 88 / 99
Error Code Description Explanation
0002 Der Kundenwunschtermin liegt
ausserhalb des betrieblich
möglichen Zeitrahmens oder ist
kein vertraglicher Arbeitstag.
(verbindlicherLiefertermin =
2015-05-21)
Der neue Ausführungstermin kann folgende Gründe
haben:
- Bei DSL: Kundenwunschtermin (KWT)
unterschreitet die Mindestvorlaufzeit gemäß
Dienstvertrag
- Es wurde ein nicht vertraglich vereinbarter
Arbeitstag ausgewählt
- Die Vorlaufzeit bis zur Lieferung ist betrieblich nicht
ausreichend
Der verbindliche Liefertermin wird entsprechend
angepasst und übermittelt.
Kein Handlungsbedarf.
0003 Telekom hat zum
Kundenwunschtermin keine
ausreichenden Kapazitäten
(verbindlicherLiefertermin =
2015-05-21)
Es liegen keine ausreichenden personellen oder
technischen Ressourcen zum Kundenwunschtermin
(KWT) vor. Daher wird der nächstmögliche Termin
übermittelt.
Das Verhalten ist für Standardaufträge und
Terminverschiebungen identisch.
Kein Handlungsbedarf.
0005 Der Ausführungstermin wurde
von Telekom manuell geändert
(verbindlicherLiefertermin =
2015-05-21)
Es handelt sich um eine Terminanpassung durch die
Telekom (z.B. im Rahmen eines Projektes). I.d.R.
wird der neue Termin mit dem Provider abgestimmt.
Aufgrund technischer Hindernisse erfolgt eine
manuelle Terminänderung heute auch ohne
Abstimmung mit dem Provider.
Kein Handlungsbedarf.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 89 / 99
Error Code Description Explanation
0006 Der Auftrag wird teilausgeführt Nur ein Teil der beauftragten Produkte kann
bereitgestellt werden. Die bereitgestellten Produkte
sind Bestandteil der ABM.
Beispiel:
Bestellung von Preselection Ort und Preselection
Fern. Ist das Produkt Preselection Ort mit
„Teilausführung zulassen“ gekennzeichnet, aber
Preselection Ort nicht möglich, wird Preselection Fern
dennoch bereitgestellt. Ist „Teilausführung zulassen“
nicht gekennzeichnet, wird der gesamte Auftrag
abgelehnt.
Kein Handlungsbedarf.
0070 Der Auftrag wird manuell
bearbeitet. Die Bearbeitungszeit
kann sich daher verlängern.
Kein Handlungsbedarf.
Table 1 Deutsche Telekom Interim Status Update Result Codes
A.1.2 Positive Result Code
Error Code Description Explanation
0010 Auftrag ausgeführt Kein Handlungsbedarf.
Table 2 Deutsche Telekom Positive Result Code
A.1.3 Negative Result Codes
Error Code Description Explanation
1000 ONKZ oder Rufnummer
unbekannt.
Zum Identifikator für die Bestandssuche über die
ONKZ/Rufnummer oder Rechnungsnummer (bei
Anlagenanschlüssen) ist kein Bestand bei der Telekom
vorhanden.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 90 / 99
Error Code Description Explanation
1001 Die Anschrift ist nicht bekannt. Die übermittelte Anschrift wurde überprüft und konnte nicht
eindeutig plausibilisiert werden.
Falls in der ABBM das Meldungsattribut „Standort A korrekt“
befüllt ist, dann validieren Sie bitte die vorgeschlagene
Adresse mit dem Endkunden und senden Sie den Auftrag
erneut.
Ansonsten überprüfen Sie die Adressdaten und senden Sie
den Auftrag erneut.
1002 Straßenname ist unbekannt Der im Standort A übergebene Straßenname ist bei der
Deutschen Telekom nicht referenziert.
1003 Der Kundenwunschtermin liegt
außerhalb des zulässigen
Zeitrahmens.
Sie haben die maximale Vorlaufzeit überschritten.
Bitte geben Sie einen Kundenwunschtermin (KWT) an, der
innerhalb der zulässigen Vorlaufzeit liegt, und stellen Sie
den Auftrag erneut ein.
1004 Es liegt eine Kündigung des
Anschlusses oder eine
Rufnummernänderung am
Anschluss vor.
Der Meldungscode wird nur verwendet wenn der Endkunde
einen Bestand (Rufnummer oder Anschluss) bei der
Telekom unterhält.
ERLM: Der Endkunde hat seinen Telekomanschluss
gekündigt, wodurch die Telekom die Kündigung des DSL
des Providers angestoßen hat. Die Erledigung der DSL-
Kündigung wird über die ERLM mitgeteilt.
ABBM: Der Anschluss, auf den sich der Auftrag bezieht, ist
bereits durch den Endkunden bei der Telekom gekündigt
worden. Der Kündigungsauftrag ist noch nicht ausgeführt.
Der Ausführungstermin der Kündigung liegt zeitlich vor dem
Kundenwunschtermin des Providerauftrags.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 91 / 99
Error Code Description Explanation
1006 Der Auftrag ist derzeit nicht
möglich. Es wurden Änderungen
am Anschluss beauftragt. Das
beauftragte Produkt kann erst
nach Erledigung dieses Auftrags
erteilt werden.
Es ist noch ein offener Auftrag der Telekom zu diesem
Anschluss vorhanden. Ein neuer Auftrag darf frühestens 1
Tag nach dem mitgelieferten Erledigungsdatum des offenen
Auftrags eingestellt werden..
Der MC tritt auch in folgenden Fällen auf:
-die Telekom hat bereits einen Wechselwunsch des
Endkunden zur Telekom erfasst. Bitte reagieren Sie in
diesem Fall auf die Portierungsanzeige beim
Portierungskennungsinhaber. Eine Kündigung ist nicht mehr
notwendig.
- der Endkunde hat bereits bei der Telekom seinen
Anschluss gekündigt, die Kündigung ist noch nicht
ausgeführt, kann aber nicht mehr storniert werden. Bitte
stellen Sie anstelle eines Auftrags mit dem Gf VBL einen
Auftrag mit Gf NEU unter Angabe der Vormieterdaten ein.
Sollte kein offener Auftrag vorliegen, kontaktieren Sie vor
erneutem Einstellen des Auftrags bitte das Clearing-Team.
1007 Bei dem vorliegendem
Geschäftsfall ist das
Änderungskennzeichen für
dieses Produkt nicht zulässig.
Die Änderungskennzeichen „Storno“ und
„Terminverschiebung“ sind vertraglich nicht für diese
Produkt-Geschäftsfall-Kombination vereinbart.
Bitte stellen Sie für den betroffenen Auftrag die vertragliche
Grundlage sicher.
Cancel CPS request is not possible in Cocom
1008 Die bestellte Konfiguration
besteht bereits.
Bitte prüfen Sie Ihre Bestandssituation.
1010 Es ist bereits Bestand des
Auftraggebers vorhanden.
Es liegt eine Beauftragung zu einem bereits bestehenden
Bestand vor.
Möglicherweise ist die angegebene Vertragsnummer nicht
korrekt.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 92 / 99
Error Code Description Explanation
1012 Es liegt bereits ein Auftrag für
diesen Anschluss vor. Ihr
Auftrag kann erst nach
Erledigung des noch offenen
Auftrags erteilt werden.
Es ist noch ein offener Auftrag eines anderen Providers zu
diesem Anschluss vorhanden. Bitte stellen Sie den neuen
Auftrag frühestens 1 Tag nach dem mitgelieferten
Erledigungsdatum des offen Auftrags ein.
Der MC tritt auch auf, wenn ein weiterer
Anbieterwechselauftrag in WITA vorliegt. Bitte beantworten
Sie in diesem Fall zunächst die vorliegende AKM-PV
1013 Externe Auftragsnummer ist
nicht eindeutig oder nicht korrekt
Die externe Auftragsnummer darf nur exklusiv je Auftrag
verwendet werden. Ausgenommen hiervon sind
Stornierungs- und Terminverschiebungsaufträge.
Bitte überprüfen Sie, ob die entsprechende
Auftragsnummer bereits verwendet wurde bzw. ob diese
korrekt ist.
1018 Der Besteller ist nicht berechtigt
für den Kunden zu bestellen
Eine Bestellung im Auftrag Dritter ist nur möglich, wenn
entsprechende Vollmachten dazu vorliegen.
Bitte überprüfen Sie, ob eine Vollmacht vorliegt bzw.
beauftragen Sie die Mandantenfunktion.
Bei AUS-BUE ist die Bestellung im Namen Dritter nicht
vorgesehen.
1020 Das Zeitfenster ist nicht
vereinbart
Es können nur (Sonder-) Zeitfenster gebucht werden, für
die eine Vereinbarung vorliegt.
Bitte überprüfen Sie Ihre vertraglich vereinbarten (Sonder-)
Zeitfenster, und senden Sie den Auftrag erneut
Ab OSS Version 7.00 ist die Angabe des Zeitfensters Pflicht
1021 Der Auftrag wurde nicht korrekt
verarbeitet. Versuchen Sie es zu
einem späteren Zeitpunkt noch
einmal
Der Auftrag ist bei der Bearbeitung in eine Fehlersituation
gelaufen, die sich durch Neuerteilung des Auftrags lösen
lässt.
Stellen Sie den Auftrag am Folgetag erneut ein. Sollte diese
Fehlermeldung dann erneut kommen, kontaktieren Sie bitte
das Clearingteam (Colt Reseller Support).
Cocom Web Manager Reseller Connect DE User Guide v.2.3 93 / 99
Error Code Description Explanation
1023 Ihr Auftrag ist derzeit aus
technischen Gründen nicht
bearbeitbar. Bitte versuchen Sie
es zu einem späteren Zeitpunkt
erneut
Bitte übermitteln Sie den Auftrag zum angegebenen
Wiedervorlagetermin erneut.
Sofern kein Wiedervorlagetermin mitgesendet werden
konnte, stellen Sie den Auftrag frühestens am Folgetag
erneut ein (Empfehlung 3 AT nach Erhalt der ABBM).
1031 Die Anlage enthält einen
maliziösen Code
Die Anlage ist möglicherweise virenbehaftet.
Bitte überprüfen Sie die Anlage auf Viren und übermitteln
Sie den Auftrag inklusive Anhang erneut.
1033 Termin für Anbieterwechsel vor
einem arbeitsfreien Tag ist nicht
möglich
Aufträge im Anbieterwechsel mit Geschäftsfall
Verbundleistung, Providerwechsel und NEU mit
Vorabstimmungs-ID mit einem KWT auf einen Tag vor
einem arbeitsfreien Tag (z.B. Samstag oder Arbeitstag vor
einem Feiertag) werden abgelehnt (gemäß Vorabstimmung
und Spezifikation Anbieterwechsel).
Bitte stellen Sie einen erneuten Auftrag mit einem
korrektem Terminwunsch ein.
1051 Der Auftrag ist bei vorhandener
Bestandssituation nicht möglich
Betrifft Storno und Terminverschiebung:
Ein Storno bzw. eine Terminverschiebung ist erst nach
Versendung einer QEB zum Ursprungsauftrag möglich.
Bitte warten Sie diese ab und senden Sie dann den Storno
bzw. die Terminverschiebung erneut.
Der Ursprungsauftrag konnte nicht gefunden werden.
1086 Kundenauftrag ist nicht
stornierbar, da Stornierung
bereits angestoßen.
Es wurde bereits eine Stornierung eingestellt.
Kein Handlungsbedarf.
Cancel CPS request is not possible in Cocom
1087 Eine Stornierung ist nicht
möglich.
Der Stornoabbruch kann verschiedene Ursachen haben:
Die Buchung des Ursprungsauftrags ist in den IT-Systemen
der Telekom bereits so weit fortgeschritten, dass keine
Stornierung des Auftrags möglich ist.
Ursprungsauftrag ist bereits abgebrochen: Eine Stornierung
ist bei einem bereits abgebrochenem Auftrag nicht mehr
möglich. Keine Handlungsmöglichkeit.
Cancel CPS request is not possible in Cocom
Cocom Web Manager Reseller Connect DE User Guide v.2.3 94 / 99
Error Code Description Explanation
1089 Der Auftrag wurde bereits
durchgeführt. Eine Stornierung
ist nicht mehr möglich.
Bitte warten Sie die ENTM ab und kündigen Sie dann den
Bestand des entsprechenden Einzelvertrags.
Keine Handlungsmöglichkeit.
Cancel CPS request is not possible in Cocom
1102 Produkt oder Geschäftsfall nicht
zulässig
Bitte wählen Sie ein anderes Produkt, das den vertraglichen
Vereinbarung entspricht, und stellen Sie den Auftrag erneut
ein. Bzw. stellen Sie die vertragliche Grundlage für den
Auftrag sicher. Hierzu kontaktieren Sie bitte den
Carriermanager.
Im GF AUS-BUE: Bitte wählen Sie einen anderen
Dienstvertrag/ Leistungsnummer, da die gewählte
Leistungsnummer nicht vereinbarte Produkte für diesen GF
beinhaltet.
1193 Der juristische Nachfolger (Erbe)
kündigt das Vertragsverhältnis
Der Endkunde ist verstorben. Der juristischem Nachfolger
des Endkunden hat das Vertragsverhältnis gekündigt Es ist
daher nicht mehr möglich, den noch nicht ausgeführten
Auftrag auszuführen. Bei Fragen nehmen Sie bitte mit dem
juristischem Nachfolger des Endkunden Kontakt auf.
1194 Der Endkunde verweigert die
Herstellung
Der Endkunde hat der Telekom Deutschland untersagt die
Leitung herzustellen, oder der Zugang zum APL wird
verweigert
Bitte nehmen Sie Kontakt mit Ihrem Endkunden zur Klärung
des konkreten Sachverhalts auf.
1195 Der Insolvenzverwalter des
Endkunden kündigt das
Vertragsverhältnis
Der Endkunde hat Insolvenz angemeldet. Der
Insolvenzverwalter des Endkunden hat das
Vertragsverhältnis gekündigt Es ist daher nicht mehr
möglich, den noch nicht ausgeführten Auftrag auszuführen.
Bei Fragen nehmen Sie bitte mit dem Insolvenzverwalter
Kontakt auf.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 95 / 99
Error Code Description Explanation
1196 Der Endkunde kann die
beauftragte Leistung nicht mehr
abnehmen
Der Telekom Deutschland ist es aus Gründen die beim
Endkunden zu suchen sind nicht mehr möglich den Auftrag
auszuführen.
Gründe die nicht mit anderen MC abgedeckt sind.
Bitte nehmen Sie Kontakt mit Ihrem Endkunden zur Klärung
des konkreten Sachverhalts auf.
1199 Die Voraussetzung für die
Bereitstellung ist nicht mehr
gegeben. Der Auftrag wurde
abgebrochen.
Der Endkundenwunsch kann nicht realisiert werden.
Beispielsweise ist das Produkt auf der vorhandenen
technischen Infrastruktur nicht bereitstellbar.
Keine weiteren Handlungsmöglichkeiten.
2001 Die Leistungsnummer ist nicht
plausibel oder nicht eindeutig
Der angegebenen Leistungsnummer kann kein
Dienstvertrag zugeordnet werden.
Bitte prüfen Sie die Leistungsnummer und stellen den
Auftrag mit geänderter Leitungsnummer neu ein.
2004 Der Eingangskanal ist nicht
zulässig.
Bitte überprüfen Sie den gewählten Eingangskanal
hinsichtlich der vertraglich vereinbarten Eingangskanäle,
und stellen Sie den Auftrag über den zulässigen
Eingangskanal erneut ein.
5500 Der Anschlussinhaber ist falsch Der Anschlussinhaber ist unter der Rufnummer nicht in den
Systemen der Telekom geführt. Bei Preselection erfolgt
keine AKM-PV. Information kann aus diesem Grund nicht
übergeben werden.
Bitte überprüfen Sie den Anschlussinhaber, und stellen Sie
den Auftrag erneut ein.
Table 3 Deutsche Telekom Negative Result Codes
A.1.4 Negative Result Codes
These are system failure errors. Please contact Colt Reseller Support if you receive any of
these error messages.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 96 / 99
Error Code Description Explanation
0987 Ein angegebener Produktbezeichner ist
ungültig
Der angegebene Produktbezeichner ist nicht in
der Produktbezeichner-Tabelle der genutzten
Orderschnittstellenversion enthalten.
Bitte überprüfen Sie die Schreibweise. Ggf. ist
eine andere Orderschnittstellenversion
erforderlich um das gewünschte Produkt
bestellen zu können..
0990 Funktion aktuell nicht unterstützt, Freigabe
wird gesondert bekannt gegeben
Betrifft die Funktionen/Attribute, die in der
aktuellen Orderschnittstellenversion
beschrieben sind, aber erst zu einem späteren
Zeitpunkt freigeschaltet werden.
0991 Die parametrisierte Lastobergrenze ist
erreicht, bitte versuchen Sie es zu einem
späteren Zeitpunkt erneut.
Der Auftrag wurde nicht oder nicht vollständig
entgegengenommen.
Bitte stellen Sie den Auftrag zu einem späteren
Zeitpunkt erneut ein
0993 Versionsnummer fehlerhaft Die angegebene Versionsnummer der
genutzten Orderschnittstelle passt nicht zur
vertraglichen Vereinbarung.
Bitte überprüfen Sie die technischen
Einstellungen ihrer Schnittstelle unter
Beachtung der vertraglichen Vereinbarung und
stellen Sie den Auftrag erneut ein.
0995 Datenstruktur ungültig Die Datenstruktur des Auftrags ist fehlerhaft.
Der Auftrag wurde nicht vollständig übermittelt
oder das Zielprodukt ist mit dem gewählten
Geschäftsfall nicht kombinierbar.
Stellen Sie sicher, dass das Format und der
Inhalt des Auftragsdokumentes der
vereinbarten Schnittstellenbeschreibung
entsprechen, nehmen Sie Korrekturen vor und
stellen Sie den Auftrag erneut ein.
Cocom Web Manager Reseller Connect DE User Guide v.2.3 97 / 99
Error Code Description Explanation
0996 Dokumententyp der Anlage ist unzulässig Es wurde ein Dokumententyp in der Anlage
verwendet der gemäß Beschreibung der OSS
nicht vorgesehen ist.
Bitte überprüfen Sie den Dokumententyp der
Anlage und ändern diesen in einen
zugelassenen Typ. Senden Sie den Auftrag
dann erneut.
0999 Technischer Fehler Ein nicht näher spezifizierter Fehler wurde
während der Bearbeitung des Auftrages
erkannt.
Bitte überprüfen Sie die technischen
Einstellungen ihrer Schnittstelle unter
Beachtung der vertraglichen Vereinbarung und
stellen Sie den Auftrag erneut ein. Sofern dies
nicht erfolgreich ist, kontaktieren Sie das
Clearing-Team.
Table 4 Deutsche Telekom Negative System Failure Codes
Country Codes
Country Code Country Name
AT Austria
BE Belgium
DE Germany
ES Spain
FR France
GB Great Britain
IE Ireland
IT Italy
NL Netherlands
SE Sweden
Cocom Web Manager Reseller Connect DE User Guide v.2.3 98 / 99
APPENDIX D Activity Codes
CountryAction Type
Current FTP Flat File Code
CoCOM Kernel/XML Schema Descriptive Code Description
DE CLI A Add CLI Activate CLI on Switch
DE CLI D Remove CLI Deactivate CLI on Switch
DE CLI M Transfer CLI
Modify CLI ownership to this
Reseller
DE CLI L Change CLI
Change CLI Parameters
(used for suspend and
unsuspend)
DE
CPS
CLI/
CPS C Add CPS
Activate CLI on Switch AND
activate Pre-selection
Cocom Web Manager Reseller Connect DE User Guide v.2.3 99 / 99