Cocom- Reseller Connect
FTP User Guide
France
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
Version / Issue Date / Description of change from previous version / Distributed5.0 / Added section 3.4 VPN to advise Resellers to refer to VPN reseller guide
Updated section 4.1 Table 2 CLI & CPS requests – CLI/CPS requests can now be submitted for active or inactive CLIs
5.3 / 02/03/2005 / Updated with correct file naming for CDR file
Added Document History table
Updated field 4 of section C.2.7 – Request Job File.
6.0 / 06/05/2005 / - Updated to standard template
- Examples updated to latest request/response formats
6.1 / 29/07/2005 / Updated error messages, new brand
6.2 / 07/11/2005 / Update Request Validation codes (E 1.2)
Change of CPS request (4.1 Table 1)
6.3 / Add new description of Error Code in Table 27
Added in Table 1 that an error message will be send for CPS-Requests if CLI activation request is in progress
6.4 / 15/04/2009 / Maintenance & Supported updated.
6.5 / 14/03/2012 / Updated to reflect enhanced Cocom and consolidated CDR feature
6.6 / 02/12/2013 / Updated to reflect Reseller Connect with Wholesale Line Rental
6.7 / 30/07/2015 / Updated to reflect the France Regulatory impacts on the unrated CDRs for calls to non-geographic numbers.
6.8 / 03/02/2016 / Updated to reflect Colt rebranding.
6.9 / 04/03/2017 / Replaced VoIP Access with SIP Trunking and change in the notification period for planned maintenance work in section 5
Colt Cocom FTP User Guide FR 6.9 3/ 84
Contents
Introduction 6
1 Service Outline 7
1.1 Outline Process 7
1.2 Technical Infrastructure 8
1.2.1 Overview 8
1.2.2 Directory Structure 8
1.2.3 File Naming Standard 11
2 Service Requests 12
2.1 Overview 12
2.2 Request File Processing 14
2.3 Validation Rules and Checks 15
3 Service Responses 17
3.1 Colt Responses 17
3.2 PTT Responses 17
4 CDR Files 18
4.1 Consolidated CDR Request 19
4.2 Consolidated CDR Download 21
4.3 Consolidated CDR File Format 21
5 Maintenance and Support 22
6 Tips, Tricks & Rules 23
7 Glossary 24
Appendix A Request File Formats 25
Appendix B Response Files 39
Appendix C File Level Errors 60
Appendix D CDR File 63
Appendix E Reference Data 72
Appendix F Reseller Connect with WLR 84
F.1 File Name 84
F.2 Call Detail Record Format 82
F.3 Sample Call Detail Record 83
Introduction
Colt Technology Services (Colt) has provided you with an electronic interface for the activation and deactivation of Colt Wholesale Products on your end-customer CLIs (Calling Line Identifier) and for the daily transfer of call detail records (CDR). This system is referred to as Cocom.
This interface allows you to submit individual and bulk requests to Colt, and in return allows you to retrieve the results of your requests and to retrieve the CDRs resulting from your end-customers’ traffic within the Colt network.
Cocom can also be used for Carrier Pre-Selection (CPS) requests on end-customer CLIs that are already active within the Colt Network. The system will confirm that the CLI is known to Colt before forwarding the request to the relevant PTT. The responses received from the PTT will be processed and passed back to you.
This document describes the necessary technical details and the processes that allow you to
· Set up your internal systems and processes
· Successfully submit and retrieve requests
· Successfully retrieve CDR files from Colt
The information specific to each country is defined in Appendices to this document.
Examples of this information are:
· CLI and CPS requests
· Action codes
· Switch Profiles
· PTT messages
Reseller Connect with WLR
If resellers are selling Reseller Connect with Wholesale Line Rental, then Colt will have setup access to both Cocom and to the VGA portal. Resellers must use the VGA portal to do all their end-customer activations & deactivations and to view the status of their transactions for Wholesale Line Rental. Cocom must only be used to download unrated CDRs. There is a separate VGA portal user guide which is available from the VGA portal – please use your VGA portal login details and follow the instructions in your welcome letter.
1. Service Outline
1.1 Outline Process
The communications server itself is generally available except when Colt needs to carry out essential housekeeping and maintenance work. So, you have considerable flexibility in deciding how often you choose to upload and retrieve files.
There are three main activities that you will need to carry out on a regular basis. During a typical session you will:
· Upload a request file, followed by a matching job file
· Retrieve response and any error files from previous upload sessions
· And twice a day retrieve CDR files for processing within your own systems
Each of these activities is described in greater detail in later sections.
Figure 1 - Colt Reseller support infrastructure
1.2 Technical Infrastructure
1.2.1 Overview
The Cocom server currently supports FTP access to dedicated and protected directories that have been created specifically for your business. Additionally access via XML and a graphical user interface is available.
Access to the server is via a dedicated VPN client, provided by Colt. These methods are detailed in separate documents accompanying this guide. Colt will assign a temporary IP address on successful access that will remain valid and available only for the duration of your connection to the service.
When you connect with Colt, you will be prompted to enter two User IDs and passwords; the first to gain access to Colt’s customer network, and the second to gain access to your home directory on the Cocom server.
After you have successfully gained access to the server you will be connected to your home directory. Your home directory has been created specifically for you and can only be accessed using the User ID provided to you by Colt.
To use the service you will need to integrate these processes and file interface into your own IT environment. For a stand-alone operation you can use a standard FTP client. Any of the commonly available FTP clients should be satisfactory, for example ReflectionFTP.
1.2.2 Directory Structure
Files within this directory are protected from access by others in a secure environment. The key directories in your home directory on the Cocom Server are shown in the diagram below.
From here you can download your unrated CDRs for existing Colt products which you resell and across one or more Colt countries. You can also do Reseller Connect transactions – i.e. place CLI activation / deactivation and CPS requests.
Figure 2 - Directory Structure
Diagram notes
· Note lower case values above
· Reseller Domain ID is an auto-generated ID, a combination of your company name & random digits, minimum length of 5 and max length of 8
· Country code in ISO 2 character format, note ‘FR’ is used
· The product will be one of the following - all lower case:-
ü reseller-connect
ü sip-trunking
ü voice-line
ü carrier-voip
ü ip-voice-line
ü in-for-resellers
· The profile is up to 5 alphanumeric and is either the account profile or the service profile
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. The unrated CDR files will be generated in separate files by product and made available under each product as per the FTP folder structure above.
The files provided by Colt such as CDR files, and response files are available in separate sub-directories in a standard format (detailed in the Appendices to this Guide):
/request / the directory where you must upload your request files/response / the directory where Colt will deposit response files
/jobin / the directory where you must upload job request files, one for each request file
/jobout / the directory where Colt will deposit job files, one for each response file
/err_in / this is the directory that will contain any error files
/cdr / this directory will contain your CDR files, delivered twice daily as well as any consolidated CDR files you have requested using the consolidated CDR request feature in Cocom Web Manager
/cli_list / at the end of each day, Colt will provide a report of your CLI activity for the day and leave these in this directory for your collection
Table 1 – Sub directories description
1.2.3 File Naming Standard
Files transferred to and from Colt are all uniquely identified and adhere to the following naming convention.
The file names will consist of three parts:
- The first digits are assigned by Colt Technology Services (Colt) and will be your unique identifier, which is up to 5 alphanumeric e.g. a02.
- The next eight (8) digits are the file sequence number with leading zeros, for example 00000001. These must follow strictly in sequence for each request file submitted to Colt and each response file will always match its corresponding request file.
- A suffix separated by a dot that describes the type of the file
· req- request file
· rsp- response file
· error- error files
· cdr- CDR file
The corresponding job files have the additional suffix “job”.
For example a request from a new reseller with service profile a02 would be a pair of files:
a0200000001.req
a0200000001.req.job
The Colt response would be another pair of files:
a0200000001.rsp
a0200000001.rsp.job
2 Service Requests
2.1 Overview
Colt allows service activation, and deactivation requests for Resellers’ end-customers CLIs on the Colt network and optionally, for Carrier Pre-Selection (CPS) service through the local PTT. Colt also allows you to request the transfer of an existing CLI to you from another reseller, through a Modify request, but this feature is restricted and available only on special request.
At any time you may be required to provide written proof that the end-customer has signed
up for service with you. This may be to verify that the end-customer has consented to transfer their service to you, or may be as a result of a demand from the local PTT to verify that a CPS request is valid. If this is required you will be contacted by Colt directly.
You can request service to be activated or deactivated for a given CLI,
· on the Colt network only (CLI only),
· on the Colt network with CPS enabled (CPS or CLI/CPS)
/ Activate / Deactivate /CLI / CLI must not be active / Only if the CLI is already active
CPS / CLI may be inactive or active
· If the CLI is active – no warning message given but CPS request is processed
· If the CLI is inactive – CLI is activated on the Switch then the CPS is processed
· If activation process for CLI is in progress – warning message will be send / Only if CPS is already active on the CLI.
And only if permitted by PTT (e.g. some PTTs will only accept CPS deactivation requests directly from the end-customer)
CLI & CPS Combined (obsolete) / CLI may be inactive or active
· If the CLI is active – warning message given but CPS request is processed
· If the CLI is inactive – CLI is activated on the Switch then the CPS is processed / Not Permitted.
You need to deactivate CPS first, and then submit another request to deactivate the CLI after the CPS has been deactivated.
Table 2 - CLI and CPS Request Rules
You can include up to 500 individual requests in a single file, and the file must be uniquely identified (see 2.2.3 File Naming Standard for the File Naming Specification). Each request file must also be accompanied by a Job File, and it is the Job File that triggers processing of the Request file by Colt.
The normal sequence of events is as follows:
1) You will upload a request file
2) Followed by uploading the corresponding job file
3) Colt detects the job file and automatically looks for the corresponding request file. If no request file is found then the system generates an error.
It is very important that the request file is uploaded BEFORE its corresponding Job file. If you upload a Job file first then the system will start to search for the request file, and will continue to look for up to 90 seconds. If it cannot find the file, or more likely it cannot read the file because it cannot get exclusive access to it, the server will create an error response. The request file will then be ignored by the system.
· Colt will check the request file, and carry some basic validation (detailed in Section 3.3 below)
· Carry out the request within the Colt network, and return the result
· If the file contains a CPS request, then Colt will activate the CLI and forward the request to the local PTT. In the case the CLI is already active and no error occurs no message will be send. If the CLI is not active an acknowledgement will be send.
· If the file contains combined CLI/CPS requests then Colt will generate an acknowledgement for the CLI element and forward the request to the local PTT for the CPS element, if the CLI request is successful.
The local PTT (incumbent Network Operator) normally has a fixed period of time to process a CPS request, typically between 5 and 10 working days. Their response to the request will be sent at any time in the period from your submission, up to the time limit. When Colt receives these responses they are returned directly to you via the response directory within your home directory on the Colt server.
2.2 Request File Processing
Colt carries out some basic validation of requests and request files before accepting them for processing. The rules are simple and are as follows: