Our IP Voice services are billed monthly in arrears.
CDR Records are able to be retrieved in an unfinalised format up until the invoice for that period is issued. Once the invoice is issued, CDR records are considered "finalised".
CDR records are accessed by sending an HTTP GET to the correct URL. Your IP address must be whitelisted to use this service. IP whitelisting occurs once per week.
Dates must be provided in ISO 8601 format.
CDR records are returned for the period as a CSV file, with the first row containing header columns. If we update the file format, we will preserve the order of the columns and add additional columns to the end. Regardless, you should take care to parse the file using the headers provided.
An example file is below:
Call Date,Call From,Call To,Total Duration,Billable Duration,Answer Status,Billing Classification,Cost ex,Network,RWTS Account code,Customer Account Code
01/02/2019 19:03:57,Anonymous,6128458XXXX,5,4,ANSWERED,National Landline,0.00,VoIP,trunkidentifier,
01/02/2019 17:57:40,0297XXXXXX,6113007XXXX,145,142,ANSWERED,13 numbers,0.25,VoIP,trunkidentifier,redirect
01/02/2019 17:49:34,0298XXXXXX,6141066XXXX,154,144,ANSWERED,Mobile Calls,0.17,VoIP,trunkidentifier,
The billing identifier that should be use to isolate calls to a particular SIP trunk or service is the field labelled "RWTS Account code". This is an alphanumeric identifier assigned to the customer service that is communicated to you during service setup. This field is always provided.
Customer Account Code is a user provided account code set either with the X-AccountCode SIP header or from the Account Code setting within CloudPBX.
Call From and Call To contain the CLI presented/delivered during a call. While this is often the source or destination of the call, in call forwarding scenarios this contains the actual CLI destination of the call.
Duration reflects the total duration of the call.
Billable Duration reflects the total billable duration of the call.
Answer Status can be one of ANSWERED, NOT ANSWERED, BUSY or FAILED
Billing Class is the invoice description that appears for this call. This is a grouping field. In situations where Extension Level Billing is utilised, the extension level billing will be provided here.