CDRs

The CDRs module: who generates and sends charge detail records, the methods per role and the CDR object.

On this page

Technical considerations

The CDR is to be considered as a concluded event.

CDRs are generated and sent by the CPO to the HUB and then forward by the HUB to the EMSP. The MOBI.Hub may also generate CDRs when an entity uses the optional Disputes and Partnerships modules available in the MOBI.Hub platform.

When receiving CDRs from a CPO, Mobi.e acts as a CDR Receiver. When generating CDRs under the applicable optional services, Mobi.e acts as a CDR Sender.

Methods to be implemented

MOBI.Hub

`CDRs` methods for the MOBI.Hub
Method	Direction	Description of usage
`GET`	Request	Retrieve CDRs from the CPO for a given period.
`POST`	Request	Send a CDR to an EMSP when generated by the MOBI.Hub under the applicable optional services.
`POST`	Response	Receive a new CDR from a CPO.

CPO

`CDRs` methods for the CPO
Method	Direction	Description of usage
`GET`	Request	Retrieve CDRs from the MOBI.Hub for a given period.
`POST`	Request	Send a new CDR to the MOBI.Hub.
`POST`	Response	Receive a CDR generated by the MOBI.Hub, when the CPO has made the corresponding CDR Receiver endpoint available.

EMSP

`CDRs` methods for the EMSP
Method	Direction	Description of usage
`GET`	Request	Retrieve CDRs from the MOBI.Hub for a given period.
`POST`	Response	Receive a new CDR from the MOBI.Hub.

Objects description

CDR

Table 5 – `CDR` object properties
Property	Mandatory	Value	Comments
`country_code`	TRUE	`PT`
`party_id`	TRUE
`id`	TRUE		Always provided by MOBI.Hub
`start_date_time`	TRUE
`end_date_time`	TRUE
`session_id`	TRUE
`cdr_token`	TRUE
`auth_method`	TRUE	`WHITELIST`	The EMSPs must implement the
`cdr_location`	TRUE		See remarks below concerning private charging stations.
`currency`	TRUE	`EUR`
`tariffs`	TRUE
`charging_periods`	FALSE
`total_cost`	TRUE
`total_fixed_cost`	TRUE
`total_energy`	TRUE
`total_energy_cost`	TRUE
`total_time`	TRUE
`total_time_cost`	TRUE
`total_parking_time`	TRUE
`total_parking_cost`	TRUE
`remark`	FALSE
`credit`	FALSE
`credit_reference_id`	FALSE
`Last_updated`	TRUE

The following CdrDimensionType may be received:

ENERGY
ENERGY_EXPORT
ENERGY_IMPORT
MAX_POWER
MIN_POWER
PARKING_TIME
POWER
TIME

CdrLocation

For the CdrLocation class, since there are specific considerations to take concerning the access type for the charging stations, the following rule shall apply:

Table 6 – `CdrLocation` mandatory properties per access type
Property	Mandatory per Access Type		Comments
Property	Private	Public	Comments
`id`	TRUE	TRUE
`name`	TRUE	FALSE
`address`	FALSE	TRUE
`city`	TRUE	TRUE
`postal_code`	FALSE	FALSE
`country`	TRUE	TRUE
`coordinates`	FALSE	TRUE
`evse_uid`	TRUE	TRUE
`evse_id`	TRUE	TRUE
`connector_id`	TRUE	TRUE
`connector_standard`	TRUE	TRUE
`connector_format`	TRUE	TRUE
`connector_power_type`	TRUE	TRUE