Receive Charging Profiles using OCPI format

This guide provides detailed steps for Charge Point Operators (CPOs) to integrate with Jedlix, a Smart Charging Service Provider (SCSP), using the OCPI 2.2 Charging Profiles module, including examples for each step.

For detailed information on the OCPI charging profiles module:

OCPI Charging Profiles - Github

Prerequisities

This requires the CPO to setup the Sessions module and share session data with Jedlix according to the guide:

  • Session Data exchange using OCPI formatted messages

Technical Details

Optimising sessions starts with a customer having a managed session in the Jedlix platform. A session will be started once the CPO sends the Session object to Jedlix when a new charging session is initiated. When a session is active, every update received will lead to reiteration of the charge profile.

Jedlix expects the following actions to be supported to enable the most reliable smart charging service.

Receive Charging Profile

  • Upon receival of a session start or update, Jedlix calculates the optimal Charging Profile.
  • The Charging Profile will be sent to the CPO using the Charging Profiles PUT method on the Receiver interface.
  • Example charging profile body:
    {
      "charging_profile": {
        "start_date_time": "2023-10-01T12:00:00Z",
        "charging_rate_unit": "W",
        "charging_profile_period": [
          {
            "start_period": 0,
            "limit": 22000
          },
          {
            "start_period": 1800,
            "limit": 0
          },
          {
            "start_period": 3600,
            "limit": 10000
          }
        ]
      },
      "response_url": "https://www.jedlix.com/ocpi/2.2.1/chargingprofiles/response?request_id=123456"
    }
    

Remove Charging Profile

  • This enables Jedlix to request the removal of a set Charging Profile.
  • Jedlix sends a DELETE request to https://www.cpo.com/ocpi/2.2.1/chargingprofiles/1234?response_url=https://www.server.com/example.
  • CPO sends a clear request to the Charge Point and informs Jedlix of the outcome by calling the POST method on the provided URL with a ClearProfileResult Object.

Retrieving ActiveChargingProfile

  • Jedlix can inquire about the current planned Charging Profile for a session.
  • Jedlix sends a GET request to https://www.cpo.com/ocpi/2.2.1/chargingprofiles/1234?duration=900&response_url=https://www.msp.com/ocpi/2.2.1/chargingprofile/response?request_id=5678.
  • CPO retrieves the ActiveChargingProfile from the Charge Point and sends it to Jedlix by calling the POST method on the provided URL with an ActiveChargingProfileResult Object.

Push ActiveChargingProfile Updates

  • If the ActiveChargingProfile of a Charge Point changes, the CPO sends this updated ActiveChargingProfile to Jedlix.
  • CPO sends a PUT request to https://www.server.com/ocpi/2.2.1/chargingprofiles/1234 with the updated ActiveChargingProfile when other inputs have made changes to the existing profile.