In this release, following changes have been made on the Remote Commands APIs on the External/Platform API:
1. Updated behavior of the Platform API Remote Commands endpoints.
Posting Commands:
When posting any of the commands like Reset, The Post endpoint will return a result that can be one of the following:
NOT_SUPPORTED
REJECTED
ACCEPTED
TIMEOUT
UNKNOWN_SESSION
If the validation is successful, we return ACCEPTED. This does not mean that the command was already successfully sent to the charge station yet because of the asynchronous nature of how the OCPP communication works over the WebSockets.
2. Get Command Status and Response:
The Get Command Notification endpoint can be used to poll for the status and the response data of the commands for this purpose. The 'result' property is the status of the command with the following possible values:
ACCEPTED
CANCELED_RESERVATION
EVSE_OCCUPIED
EVSE_INOPERATIVE
FAILED
NOT_SUPPORTED
REJECTED
TIMEOUT
UNKNOWN_RESERVATION
PENDING
3. We introduced a new Status called PENDING which is the default status when a command was attempted to be sent to a charge station but it has not sent back a response yet.
If a command fails to be sent because the Charge Station was not connected at the time the status is set to EVSE_INOPERATIVE which is an end state.
If a command request is sent to a charge station but the charge station does not send back a response for longer than 1 hour the status is set to TIMEOUT.
4. The rest of the statuses are set when we DO receive a command response from the charge station and have specific mappings based on the status in the command response coming from the Charge Station.