Scheduling

Scheduling is a subset of smart charging whereby charging periods can be set in advance to automatically start and stop according to a given schedule as defined with the following APIs.

Basic Charge Plan

The Basic Charge Plan asic charge plan )allows to schedule a charging session for a specific day and time. The following is an example of a basic charge plan.

{
  "id": "string",
  "chargeStartTime": "2021-09-10T09:45:52.285Z",
  "chargeStopTime": "2021-09-10T09:45:52.286Z",
  "repeat": true,
  "isEnabled": true
}

id (String)
Charger serial number.

chargeStartTime (String)
Start time for schedule. Must be in the format "YYYY-MM-DD 'T' hh:mm:ss.SSSZ".

chargeStopTime (String)
Stop time for schedule. Must be in the format "YYYY-MM-DD 'T' hh:mm:ss.SSSZ".

repeat (Bool)
If set to true, the schedule repeats every 24 hours.

isEnabled (Bool)
If set to true, the schedule is enabled. If set to false, the schedule is disabled, however, it is not deleted.

Weekly Charge Plan

The Weekly Charge Plan allows to schedule charging sessions for a whole week. Each day can have a maximum of two ranges.

The following illustrates an example of a schedule for three days.

{
    "isEnabled": true,
    "days": [
        {
            "dayOfWeek": 0,
            "ranges": []
        },
        {
            "dayOfWeek": 1,
            "ranges": [
                {
                    "startTime": "09:00Z",
                    "stopTime": "12:00Z",
                    "chargingCurrentLimit": 10
                },
                {
                    "startTime": "18:00Z",
                    "stopTime": "22:00Z"
                }
            ]
        },
        {
            "dayOfWeek": 2,
            "ranges": [
                {
                    "startTime": "06:00Z",
                    "stopTime": "10:00Z"
                }
            ]
        },
        {
            "dayOfWeek": 3,
            "ranges": [
                {
                    "startTime": "22:00Z",
                    "stopTime": "06:00Z",
                    "chargingCurrentLimit": 8
                }
            ]
        },
        {
            "dayOfWeek": 4,
            "ranges": []
        },
        {
            "dayOfWeek": 5,
            "ranges": []
        },
        {
            "dayOfWeek": 6,
            "ranges": []
        }
    ]
}

isEnabled (Bool)
If set to true, the schedule is enabled. If set to false, the schedule is disabled, however, it is not deleted.

dayOfWeek (Int)
Sets the day of the week starting with 0 (Monday).

startTime & stopTime (String)
Start and stop time for schedule. Must be in the format "hh:mmZ".

chargingCurrentLimit (Int)
Sets the charging current limit. If chargingCurrentLimit is not specified, 32A is set as default.

State Machine Diagrams

Authorization required

36783678

Authorization not required

36783678

What’s Next
Did this page help you?