What is a CDR

A CDRCDR - Charge Detail Record. Transaction details of an individual charging session, such as duration, energy volume, location, etc. is the description of a concluded charging session. The CDR is the only billing-relevant object.

A CDR is the cumulative Session object combined with the relevant tariff information.

Link to Cdrs

Use case:

  • Get complete charging session & cost information of all transaction at CPO's location. Real-time and historic

Flow

Push

GreenFlux can Push CDRs to Partners by calling POST on the Partners CDRs endpoint.

NOTE: CDRs can not yet be updated or removed. This might be added in a future version of OCPI.

Pull

Partners can use the GET on the CDR endpoint to receive a list of CDRs.

Example CDR

{
   "id":"NLGFX63759518932331194001",
   "start_date_time":"2021-06-17T08:35:34Z",
   "stop_date_time":"2021-06-17T09:29:27Z",
   "auth_id":"NL*GFX*0dd6AE*6",
   "auth_method":"AUTH_REQUEST",
   "location":{
      "id":"2738009c-0aa9-4197-8c16-7cc93fa1fa69",
      "type":"OTHER",
      "publish": true,
      "name":"U0015",
      "address":"Streename 441",
      "city":"Amsterdam",
      "postal_code":"1097JM",
      "country":"NLD",
      "coordinates":{
         "latitude":"52.1205740",
         "longitude":"5.391620"
      },
      "related_locations":null,
      "evses":[
         {
            "uid":"NL-GFX-EEU171220-2",
            "evse_id":"NL*GFX*EEU171220*2",
            "status":"CHARGING",
            "status_schedule":[
               
            ],
            "capabilities":[
               
            ],
            "connectors":[
               {
                  "id":"2",
                  "standard":"IEC_62196_T2",
                  "format":"SOCKET",
                  "power_type":"AC_3_PHASE",
                  "voltage":230,
                  "amperage":32,
                  "tariff_id":"A5",
                  "terms_and_conditions":null,
                  "last_updated":"2021-01-18T06:58:56Z"
               }
            ],
            "floor_level":null,
            "coordinates":null,
            "physical_reference":null,
            "directions":[
               
            ],
            "parking_restrictions":[
               
            ],
            "images":null,
            "last_updated":"2021-06-17T08:35:38Z"
         }
      ],
      "directions":[
         
      ],
      "operator":{
         "name":"CPO",
         "website":"https://www.energie.nl/",
         "logo":{
            "url":"https://gfxappp.blob.core.windows.net/logos/94a6e8ba-c24e-4a5f-8dac-14ab495f9ad4.png",
            "thumbnail":"https://gfxappp.blob.core.windows.net/logos/94a6e8ba-c24e-4a5f-8dac-14ab495f9ad4.png",
            "category":"OPERATOR",
            "type":"png",
            "width":0,
            "height":0
         }
      },
      "suboperator":{
         "name":"CPO",
         "website":"https://www.energie.nl/",
         "logo":{
            "url":"https://gfxappp.blob.core.windows.net/logos/94a6e8ba-c24e-4a5f-8dac-14ab495f9ad4.png",
            "thumbnail":"https://gfxappp.blob.core.windows.net/logos/94a6e8ba-c24e-4a5f-8dac-14ab495f9ad4.png",
            "category":"OPERATOR",
            "type":"png",
            "width":0,
            "height":0
         }
      },
      "owner":{
         "name":"CPO",
         "website":"https://www.energie.nl/",
         "logo":{
            "url":"https://gfxappp.blob.core.windows.net/logos/94a6e8ba-c24e-4a5f-8dac-14ab495f9ad4.png",
            "thumbnail":"https://gfxappp.blob.core.windows.net/logos/94a6e8ba-c24e-4a5f-8dac-14ab495f9ad4.png",
            "category":"OPERATOR",
            "type":"png",
            "width":0,
            "height":0
         }
      },
      "facilities":[
         
      ],
      "time_zone":null,
      "opening_times":{
         "regular_hours":null,
         "twentyfourseven":true,
         "exceptional_openings":null,
         "exceptional_closings":null
      },
      "charging_when_closed":null,
      "images":null,
      "energy_mix":null,
      "last_updated":"2021-06-17T08:35:38Z"
   },
   "meter_id":null,
   "currency":"EUR",
   "tariffs":null,
   "charging_periods":[
      {
         "start_date_time":"2021-06-17T08:35:34Z",
         "dimensions":[
            {
               "type":"ENERGY",
               "volume":9.17
            },
            {
               "type":"TIME",
               "volume":0.480981,
            },
                       {
               "type":"Parking",
               "volume":0.4090
            }
         ]
      }
   ],
   "total_cost":2.57,
   "total_energy":9.17,
   "total_time":0.8981,
   "total_parking_time": 0.4090,
   "remark":null,
   "last_updated":"2021-06-17T09:29:30Z",

}

Addendums to OCPI 2.1.1 format

As OCPI has developed, extra fields were needed. These are included in CDRs as 'Addendum'.

For Platform subscription they are enabled if the information is available in our system.

CDR standard without addendum
      "total_cost": 0,
      "total_energy": 0,
      "total_time": 0,
      "total_parking_time": 0,
      "remark":null,
      "last_updated": "2015-06-29T22:01:13Z"

CDR incl addendum
      "total_cost": 0,
      "total_energy": 0,
      "total_time": 0,
      "total_parking_time": 0,
      "remark":null,
      "last_updated": "2015-06-29T22:01:13Z"      

      "total_cost_incl_vat": 0,
      "total_vat": 0,
      "total_retail_cost": 0,
      "total_retail_cost_incl_vat": 0,
      "total_retail_vat": 0,
      "total_reimbursement_cost": 0,
      "retail_package_id": "string",
      "authorization_id": "string",
      "auth_host_reference": "string",
      "customer_external_id": "string",
      "driver_external_id": "string",
      "emsp_party_id": "string",
      "emsp_country_code": "string",
      "vat": 0,
      "retail_vat": 0

Property

Type

Description

authorization_id

string (36)

Reference to the authorization given by the eMSP. When the eMSP provided an authorization_reference in either: real-time authorization or StartSession, this field SHALL contain the same value.

total_cost_incl_vat

number

Total cost including vat

total_vat

number

Total vat

total_retail_cost_incl_vat

number

Total retail cost including vat

total_retail_vat

number

Total retail vat

vat

number

Vat rate whole sale costs

retail_vat

number

Vat rate retail costs

retail_package_id

number

Retailpackage connected to driver

auth_host_reference

string

Authorization host reference (e.g. payment terminals)

customer_external_id

string

Customer external id
(only when known within GreenFlux platform)

driver_external_id

string

Driver external id
(only when known within GreenFlux platform)

Property

Type

Description

emsp_party_id

string

eMSP ID of this party. (following the 15118 ISO standard).

emsp_country_code

string

Country code of the country this party is operating in

total_reimbursement_cost

string

Total reimbursement cost


Did this page help you?