GetLocalListVersion

LocalAuthListManagement CSMS->CS OCPP 2.0.1

Sent by the CSMS to retrieve the current version number of the local authorization list stored on the Charging Station.

Quick Reference

This message has an empty payload: {}

Example Payload

{}

Example Full Frame

[
  2,
  "msg-001",
  "GetLocalListVersion",
  {}
]

Format: [MessageType, MessageId, Action, Payload]

Open in Builder Go to Validator

Overview

GetLocalListVersion queries the Charging Station to find out which version of the local authorization list is currently installed. Use this before sending SendLocalList to determine if an update is needed.

Expected Response

  • versionNumber: Integer version number (0 means no list or list not supported)

Usage Notes

  • Version 0 means either no list is installed or the feature is not supported
  • Sync your CSMS’s known version with the station’s version before sending updates
  • Use SendLocalList with updateType: Full if versions are out of sync

Testing Tips

  • Verify version 0 on a fresh station
  • Send a SendLocalList and verify the version increments

Common Errors

RpcFrameworkError

Cause: Non-empty payload sent

Solution: GetLocalListVersion request payload must be an empty object {}

Related Actions

SendLocalList Authorize ClearCache