ocpi - charging details

(must, nice to have)

    • (minimum content of OCPI CDR (= Charge Detail Record) JSON string)

    • (dependent on OCPI Tariff - see separate entry)

    • CDR information

      • CPO country code

      • CPO id

      • CDR id

      • Start of charging or reserved session

      • End of charging or reserved session

      • CDR token

        • Token id (made empty)

        • Token type

        • Contract id (randomised)

      • Authentication method


      • CDR location: relevant elements from Location

        • CPO location id

        • Street and house number

        • City

        • Postal code

        • Country

        • Coordinates (latitude, longitude)


        • CPO EVSE id

        • EMI3 EVSE id


          • CPO connector id

          • Connector type

          • Socket/cable

          • AC (single, three-phase) or DC


      • Currency


      • Tariffs: relevant elements from Tariff

        • CPO country code

        • CPO id

        • Tariff id

        • Currency


          • Tariff element

            • Tariff type

            • Price

            • VAT

            • Step size

          • Last update


    • Charging periods (a session consists of 1 or more charging periods that each has a different tariff)

      • Charging period

        • Start date time

      • Dimensions

        • Dimension

          • Type measured (current in A, energy in kWh, power in kW, time - parking_time - reservation_time in hours)

          • Volume consumed

      • Tariff id


    • Total cost (total sum of all the costs; total_cost = total_energy_cost + total_parking_cost + total_reservation_cost)

    • Total energy (total energy charged, in kWh)

    • Total energy cost (total sum of all the cost of all energy used)

    • Total time (total duration of the charging session - charging and not charging - in hours)

    • Total time cost (total sum of all the cost related to duration of charging during this transaction) (=> total_energy_cost - total_time_cost = fixed fees related to energy consumption)

    • Total parking time (total duration of the charging session where the EV was not charging - no energy was transferred - in hours) (=> total_time - total_parking_time = charging time)

    • Total parking cost (total sum of all the cost related to parking of this transaction, including fixed price components)

    • Total reservation cost (total sum of all the cost related to a reservation, including fixed price components)

    • Last update


Mandatory elements and additional recommendations

(red = must, green = nice to have, bold = mandatory in OCPI - (in italics = repeating information))

(minimum content of OCPI CDR (= Charge Detail Record) JSON string)

(dependent on OCPI Tariff - see separate entry)

country_code

party_id

id

start_date_time

end_date_time

cdr_token

uid - made empty

type

contract_id - randomised

auth_method

cdr_location

id

name

address

city,

postal_code

country

coordinates

latitude

longitude


evses_uid

evse_id

connectors_id

connectors_standard

connectors_format

connectors_power_type


currency: "EUR"

tariffs

country_code

party_id

id

currency: "EUR"

elements

price_components

type

price

vat

step_size

last_updated


charging_periods

start_date_time

dimensions

type

volume

tariff_id


total_cost

excl_vat

incl_vat

total_energy

total_energy_cost

total_time

total_time_cost

excl_vat

incl_vat

total_parking_time

total_parking_cost

total_reservation_cost

last_updated