Intro
This article gives a definition of the Charge Detail Record (CDR), a fundamental feature of the GreenFlux Billing Engine, and sketches out how CDRs are created and embedded in the billing and invoicing process.
What is a Charge Detail Record (CDR)?
GreenFlux generates a CDR each time it can successfully calculate a cost based on the received transaction data from an online Charge Station after a charging session.
The CDR is a record of the final transaction's information, including first and foremost billing data that customers need for invoicing.
A CDR is not an invoice. Customers can create a CDR data export or use an API connection to their own system (CPO or EMSP) for their invoicing.
You can think of a CDR as a recorded summary of the relevant important transaction data captured during a successful charging session.
CDR example (.json format from Platform API)
{
"data": {
"id": "750466ACFB534ECFB8CE24EE338EC4B9",
"start_date_time": "2023-05-31T08:52:26.0000000+00:00",
"stop_date_time": "2023-05-31T10:02:15.0000000+00:00",
"auth_id": "PT-EDP-CVA052345-1",
"auth_method": "WHITELIST",
"location": {
"id": "39c53572-6c24-437e-953a-6646836c3f9f",
"type": "OTHER",
"publish": true,
"name": "Teste Jorge Ansiao",
"address": "Avenida Dr Vitor Faveiro 2",
"city": "Ansiao",
"postal_code": "3240",
"country": "PRT",
"coordinates": {
"latitude": "39.913401",
"longitude": "-8.438951"
},
"evses": [
{
"uid": "PT-EDP-ETest-Charger-GFXOffi-1",
"evse_id": "PT*EDP*ETest*Charger*GFXOffi*1",
"status": "CHARGING",
"status_schedule": [],
"capabilities": ["REMOTE_START_STOP_CAPABLE", "RFID_READER"],
"connectors": [
{
"id": "1",
"standard": "IEC_62196_T2",
"format": "SOCKET",
"power_type": "AC_1_PHASE",
"voltage": 230,
"amperage": 16,
"max_electric_power": 7400,
"tariff_id": "Test-ToU-EDP-17Apr",
"last_updated": "2023-05-26T12:27:38.0000000+00:00"
}
],
"directions": [],
"parking_restrictions": [],
"last_updated": "2023-05-31T08:52:37.0000000+00:00"
}
],
"directions": [],
"operator": {
"name": "EDP Comercial"
},
"suboperator": {
"name": "EDP Comercial"
},
"auth_rules": [],
"owner": {
"name": "EDP Comercial"
},
"facilities": [
"RESTAURANT",
"CAFE",
"SUPERMARKET",
"NATURE",
"BUS_STOP",
"WIFI"
],
"time_zone": "Europe/Lisbon",
"opening_times": {
"regular_hours": [
{
"weekday": 7,
"period_begin": "2024-07-22T09:00:00.0000000+02:00",
"period_end": "2024-07-22T10:00:00.0000000+02:00"
},
{
"weekday": 6,
"period_begin": "2024-07-22T08:00:00.0000000+02:00",
"period_end": "2024-07-22T09:00:00.0000000+02:00"
},
{
"weekday": 5,
"period_begin": "2024-07-22",
"period_end": "2024-07-22T23:59:00.0000000+02:00"
},
{
"weekday": 4,
"period_begin": "2024-07-22",
"period_end": "2024-07-22T23:59:00.0000000+02:00"
},
{
"weekday": 3,
"period_begin": "2024-07-22",
"period_end": "2024-07-22T23:59:00.0000000+02:00"
},
{
"weekday": 2,
"period_begin": "2024-07-22T12:00:00.0000000+02:00",
"period_end": "2024-07-22T13:59:00.0000000+02:00"
},
{
"weekday": 1,
"period_begin": "2024-07-22T10:00:00.0000000+02:00",
"period_end": "2024-07-22T11:59:00.0000000+02:00"
}
],
"twentyfourseven": false
},
"last_updated": "2023-05-31T08:52:37.0000000+00:00"
},
"currency": "EUR",
"charging_periods": [
{
"start_date_time": "2023-05-31T09:30:01.0000000+00:00",
"dimensions": [
{
"type": "ENERGY",
"volume": 0.194
},
{
"type": "TIME",
"volume": 14.9833
},
{
"type": "ENERGY",
"volume": 0.194
},
{
"type": "TIME",
"volume": 14.9833
}
]
},
{
"start_date_time": "2023-05-31T09:45:00.0000000+00:00",
"dimensions": [
{
"type": "ENERGY",
"volume": 0.261
},
{
"type": "TIME",
"volume": 15.0167
},
{
"type": "ENERGY",
"volume": 0.261
},
{
"type": "TIME",
"volume": 15.0167
}
]
},
{
"start_date_time": "2023-05-31T10:00:01.0000000+00:00",
"dimensions": [
{
"type": "ENERGY",
"volume": 0.058
},
{
"type": "TIME",
"volume": 2.2333
},
{
"type": "ENERGY",
"volume": 0.058
},
{
"type": "TIME",
"volume": 2.2333
}
]
},
{
"start_date_time": "2023-05-31T08:52:26.0000000+00:00",
"dimensions": [
{
"type": "PARKING_TIME",
"volume": 7.5833
},
{
"type": "PARKING_TIME",
"volume": 7.5833
}
]
},
{
"start_date_time": "2023-05-31T09:00:01.0000000+00:00",
"dimensions": [
{
"type": "PARKING_TIME",
"volume": 15
},
{
"type": "PARKING_TIME",
"volume": 15
}
]
},
{
"start_date_time": "2023-05-31T09:15:01.0000000+00:00",
"dimensions": [
{
"type": "PARKING_TIME",
"volume": 15
},
{
"type": "PARKING_TIME",
"volume": 15
}
]
}
],
"total_cost": 14.23,
"total_cost_incl_vat": 17.5,
"total_vat": 3.27,
"total_energy": 0.529,
"total_time": 1.1636,
"total_parking_time": 0.6264,
"last_updated": "2023-05-31T10:02:25.0000000+00:00",
"total_retail_cost": 14.23,
"total_retail_cost_incl_vat": 17.5,
"total_retail_vat": 3.27,
"retail_package_id": "CT_4KBRPNH0BFEV7LB7DMB9AB3KLE",
"customer_external_id": "PT-EDP-199965854",
"driver_external_id": "PT-EDP-199965854",
"emsp_party_id": "EDP",
"emsp_country_code": "PT",
"emsp_external_id": "ptedp",
"vat": 23,
"retail_vat": 23,
"charger_type": "Business"
},
"status_code": 1000,
"status_message": "Success",
"timestamp": "2021-07-15T14:44:31.0000000+00:00"
}View CDRs in EV Portal
You can keep track of your CDRs in EV Portal.
Go to either:
- CPO → Billing → Wholesale CDRs.
- eMSP → Billing → Retail CDRs.
In the Charge Detail Records for dropdown at the top of the page, select the CPO you want to see CDRs of.
See what columns are available and add/remove them from your CDR view by clicking the downward arrow at the top right of the screen to open the Columns menu (as illustrated above):
You can create a CDR .csv file by clicking the Export CDRs button. Read the article Exporting CDRs to learn more.
From Charge Session to a CDR
A CDR is, in essence, the output of GreenFlux's Billing Engine. For in-depth information, read Wholesale Billing Engine and wholesale tariff configuration and Retail Billing Engine and Retail tariff configuration articles.
CDRs play a crucial role in customers' ability to create invoices based on the transaction information included in the CDR.
How GreenFlux makes a CDR from a Charging Session
Additional details
- Meter values are in-session energy measurements (usually in Watt hour).
- The energy volume used in a session is based on the Start and Stop meter values GreenFlux receives.
- The duration of the session is based on the Start and Stop timestamps.