CDRs module

CDRs module adjustments

Deviation	Roam OCPI solution
PULL not supported	Only PUSH, Plugsurfing will push the CDRs to the EMP
CDR field validations	Relaxed validations, as specified below, to accept locations that are not fully OCPI compliant

CDR field validations

Plugsurfing is a bit more lenient than the OCPI specification for a set of properties when receiving CDRs from CPOs. This means outgoing CDRs from Plugsurfing will also not fully comply with the OCPI specification for these fields.

Field	OCPI specification	Plugsurfing implementation
cdr_location.address	string(45)	string(200)
cdr_location.postal_code	string(10) (optional)	string(50) _(optional)

CDR push retry logic

If the EMP partner doesn't respond with 200 (and an OCPI success code: 1000), or doesn't respond in time, the request will be retried: the CDR will be resent every night for 7 days.

CDR cost breakdown

Providing the cost breakdown per tariff element is optional in OCPI, however even when the CPO doesn't share it in their CDR we ensure to populate this to the CDR we share with you. Hence, you will always have a cost breakdown in the CDR we share with you.

CDR example

CDR with just one cost segment.

{
  "country_code": "GB",
  "party_id": "EVC",
  "id": "cAmK3kVovbA",
  "start_date_time": "2025-09-22T18:57:12Z",
  "end_date_time": "2025-09-23T00:05:22Z",
  "session_id": "cAmK3kVovbA",
  "cdr_token": {
    "country_code": "DE",
    "party_id": "EMP",
    "uid": "32435435",
    "type": "RFID",
    "contract_id": "DE-EMP-CR2012345-9"
  },
  "auth_method": "AUTH_REQUEST",
  "cdr_location": {
    "id": "el0021a5bf9603f7499e838b5d626712345",
    "name": "Royal Garden",
    "address": "Royal Garden Street 1",
    "city": "London",
    "postal_code": "12345",
    "country": "GBR",
    "coordinates": {
      "latitude": "50.500708",
      "longitude": "1.02942"
    },
    "evse_uid": "ee000a5810f8f1474b49948a8353779ac123",
    "connector_id": "ec00d160596701464df68b78c0fc17297123",
    "connector_standard": "IEC_62196_T2",
    "connector_format": "SOCKET",
    "connector_power_type": "AC_3_PHASE"
  },
  "currency": "GBP",
  "charging_periods": [
    {
      "start_date_time": "2025-09-22T18:57:12Z",
      "dimensions": [
        {
          "type": "ENERGY",
          "volume": 17.268
        }
      ]
    }
  ],
  "total_cost": {
    "excl_vat": 5.61,
    "incl_vat": 6.73
  },
  "total_fixed_cost": {
    "excl_vat": 5.61,
    "incl_vat": 6.73
  },
  "total_energy": 17.268,
  "total_time": 5.136,
  "total_parking_time": 0,
  "credit": false,
  "home_charging_compensation": false,
  "last_updated": "2025-09-23T06:58:22Z"
}

CDR with multiple cost segments.

{
  "country_code": "SE",
  "party_id": "OUT",
  "id": "2dGoDR51PeV",
  "start_date_time": "2025-10-23T09:37:45Z",
  "end_date_time": "2025-10-23T09:48:41Z",
  "session_id": "2dGoDR51PeV",
  "cdr_token": {
    "country_code": "NL",
    "party_id": "OUT",
    "uid": "14171555417659",
    "type": "RFID",
    "contract_id": "NL-OUT-C37C4880W-M"
  },
  "auth_method": "WHITELIST",
  "cdr_location": {
    "id": "el009b18801b0b83479589094b9b9a625df9",
    "name": "North Mountain - generated 2",
    "address": "Address locgen-2-SE-OUT",
    "city": "Stockholm",
    "postal_code": "117 29",
    "country": "SWE",
    "coordinates": {
      "latitude": "59.18921",
      "longitude": "17.821754"
    },
    "evse_uid": "ee00cf340ac6f54742c0b8a7e509ea3516f0",
    "evse_id": "SE*OUT*E2MbmdP",
    "connector_id": "ec0027e1a54ca9384f35a879265292968e99",
    "connector_standard": "CHADEMO",
    "connector_format": "CABLE",
    "connector_power_type": "DC"
  },
  "currency": "SEK",
  "tariffs": [
    {
      "country_code": "SE",
      "party_id": "OUT",
      "id": "2096bcf2e5e88d5b",
      "currency": "SEK",
      "elements": [
        {
          "price_components": [
            {
              "type": "ENERGY",
              "price": 0.25,
              "step_size": 100
            },
            {
              "type": "PARKING_TIME",
              "price": 2,
              "step_size": 900
            },
            {
              "type": "FLAT",
              "price": 0.5,
              "step_size": 1
            }
          ]
        }
      ],
      "last_updated": "2025-10-23T09:37:45Z"
    }
  ],
  "charging_periods": [
    {
      "start_date_time": "2025-10-23T09:37:45Z",
      "dimensions": [
        {
          "type": "ENERGY",
          "volume": 0.3
        }
      ]
    },
    {
      "start_date_time": "2025-10-23T09:39:41Z",
      "dimensions": [
        {
          "type": "PARKING_TIME",
          "volume": 0.15
        }
      ]
    }
  ],
  "total_cost": {
    "excl_vat": 1.08,
    "incl_vat": 1.36
  },
  "total_fixed_cost": {
    "excl_vat": 0.5,
    "incl_vat": 0.63
  },
  "total_energy": 0.25,
  "total_energy_cost": {
    "excl_vat": 0.08,
    "incl_vat": 0.1
  },
  "total_time": 0.182,
  "total_parking_time": 0.15,
  "total_parking_cost": {
    "excl_vat": 0.5,
    "incl_vat": 0.63
  },
  "credit": false,
  "home_charging_compensation": false,
  "last_updated": "2025-10-23T09:48:49Z"
}