Billing CDR Standard and Examples
The format specification of our billing CDR format along with an example and important information to know.
For our CDR files we aim to match the FCS 3.01 specification as closely as possible.
Please see here for the full specification: UK-Standard-CDR-Format-v3_01-Final
Note that whilst we do our best to match FCS 3.01, some aspects are not implemented.
NOTE: This article covers the file standard for the CDR. If you are looking for how to download your CDR file, click here
Phone Number Format
All phone numbers in the CDR are in E.164 format. This can be shown as:
+(Country Code)(Rest of Phone Number)
For example, the UK phone number 0333 188 7878 in E.164 format would be +443331887878.
CSV Format
All CDR files will be downloaded as a CSV file. Due to the specific formatting requirement of the file it is highly recommended that you do not open the CDR file in spreadsheet software (such as Excel) as these programs will likely automatically change the formatting when you open them (for example they will likely remove the "+" at the start of phone numbers), which will cause billing engines to fail to read it correctly.
If you do want to open and read your CDR record, please make a copy of it first.
Diverted Calls
If a call is diverted, it will show on the CDR as two separate lines. One of the inbound side of the call, and the other for the outbound. You can tell which is which via the "RecordID" column, in which the inbound side of the call will be prefixed with "DIVERTED_INBOUND_" and the outbound side with "DIVERTED_OUTBOUND_"
Example CDR File
See below to download an example of what our CDR files look like.
NOTE: When viewing the example file please take note of the following:
- The prices are not representative of actual pricing. Please check your rate card for pricing.
- The charge codes listed does not reflect all possible charge codes. Please check the rate card.
- The record ID can be completely random and will likely change format depending on the source/destination of the call, do not assume the formatting in the example file is how it will show in the live file.
- The example file is a .XLSX file, this is done to preserve formatting. The actual file will be a .CSV file.
Access4 - CDR Example File 03_11_2025
File Breakdown
See below for a full breakdown of the standard and how we implement each column.
| Column Header | Description |
| Call Type | Can be one of 4 options:
|
| Call Cause | Not Implemented |
| Customer Identifier |
A unique identifier that shows which user the call is assigned to, this shows as <user_extension>@<domain>. For example if user 253 on domain "PetesPlumbers.rs" this would show under the customer identifier as "253@PetesPlumbers.rs". Some calls cannot be associated with a user, so they would instead show as "domain@<domain>". |
| Telephone Number Dialled | The exact telephone number dialled by the calling party. In E.164 format. |
| Call Date | The date that the call occurred formatted as DD/MM/YYYY |
| Call Time |
The time that the call started, formatted as "HH:MM:SS". Note that the CDR and invoice logs the call time as the start of the phone call. This means that if a call starts during one billing period, but ends in another, you will be billed for the full duration of the call in the first billing period |
| Duration | Duration of the call in seconds. |
| Bytes Transmitted | Not Implemented |
| Bytes Received | Not Implemented |
| Description | Billing charge description. See rate card for list. |
| Chargecode | Billing charge code. See rate card for list. |
| Time Band | Not implemented |
| Salesprice | The charge for the call in GBP. |
| Salesprice (pre-bundle) | Not implemented |
| Extension | Extension number of the user the call is associated with (will be blank if unknown). |
| DDI | Not implemented |
| Grouping ID | Not implemented |
| Call Class | Not implemented |
| Carrier | Will always say "Access4 Ltd". |
| Recording | Not implemented |
| VAT | E for exempt |
| Country of Origin | Not implemented |
| Network | Not implemented |
| Retail tariff code | Not implemented |
| Remote Network | Not implemented |
| APN | Not implemented |
| Diverted Number | For the outbound side of a diverted call, this will show the phone number the call was diverted to. |
| Ring Time | Not implemented |
| RecordID | A unique ID for the call. |
| Currency | The currency that charges are in. Will always be GBP. |
| Presentation Number | The Caller ID of the of the calling party. |
| Network Access Reference | Not implemented |
| NGCS Access Charge | Not implemented |
| NGCS Service Charge | Not implemented |
| Total Bytes Transferred | Not implemented |
| User ID | Not implemented |
| Onward Billing Reference | Not implemented |
| Contract Name | The platform name associated with your reseller account. |
| Bundle Name | Not implemented |
| Bundle Allowance | Not implemented |
| Discount Reference | Not implemented |
| Routing Code | Not implemented |