SendLocalList

Pushes the offline authorization list, as a full replacement or a differential update.

Version
OCPP 2.0.1
Direction
CSMS → Charge Point
Functional block
Local Auth List Management

SendLocalList also exists in OCPP 1.6, with a different payload. See the OCPP 1.6 version.

Same mechanism as 1.6 with the 2.0.1 token structure. An entry with no idTokenInfo is still a deletion in a differential update — the one piece of non-obvious behaviour carried over unchanged.

Request

FieldTypeRequiredDescription
versionNumberintegerRequiredThe version this update produces.
updateTypeUpdateEnumTypeRequiredFull to replace, Differential to apply changes.
localAuthorizationListAuthorizationData[]OptionalEntries, each with an idToken and an optional idTokenInfo.
json
[2, "19223201", "SendLocalList", {
  "versionNumber": 43,
  "updateType": "Differential",
  "localAuthorizationList": [{
    "idToken": { "idToken": "04A1B2C3D4E580", "type": "ISO14443" },
    "idTokenInfo": { "status": "Accepted" }
  }]
}]

Response

FieldTypeRequiredDescription
statusSendLocalListStatusEnumTypeRequiredResult of the update.
statusInfoStatusInfoTypeOptionalReason code.
json
[3, "19223201", {
  "status": "Accepted"
}]

Values

SendLocalListStatusEnumType

ValueMeaning
AcceptedApplied.
FailedThe update failed.
VersionMismatchversionNumber was not higher than the version held.

Implementation notes

An entry without `idTokenInfo` deletes that token in a differential update. Unchanged from 1.6, and still the most-missed detail in this message.

`NotSupported` is gone. Whether the station has a local list is answered by the device model, not by this response.

Recover from VersionMismatch by reading GetLocalListVersion and sending a higher number — not by retrying the same one.