Skip to content
Documentation Menu

Send Local List

Source: OCPP 2.0.1 Part 2 — Specification (Edition 2, 2022-12-15) — Section 1.50 (Messages); Use Case D01 — Send Local Authorization List (Functional Block D. LocalAuthorizationList Management)

Overview

The CSMS sends SendLocalListRequest to update the Charging Station's Local Authorization List. The update may be Full (replace) or Differential (apply changes).

If localAuthorizationList is empty/missing AND updateType = Full, all entries are removed. A Differential update with an empty list has no effect. All idTokens in the list MUST be unique.

Sequence Diagram

CSMS  ──── SendLocalListRequest ────▶  Charging Station
            (versionNumber, updateType, localAuthorizationList[]?)
CSMS  ◀─── SendLocalListResponse ────  Charging Station
            (status, statusInfo?)

Initiator

CSMS → Charging Station

Fields

Field NameField TypeCard.Description
versionNumberinteger1..1Required. Full update: version number of the new list. Differential update: version after the update is applied.
updateTypeUpdateEnumType1..1Required. Full or Differential.
localAuthorizationListAuthorizationData0..*Optional. The list entries.

UpdateEnumType values

Differential, Full.

SendLocalListStatusEnumType values

Accepted, Failed, VersionMismatch.

Examples

{
  "versionNumber": 18,
  "updateType": "Full",
  "localAuthorizationList": [
    {
      "idToken": { "idToken": "044943121F1A80", "type": "ISO14443" },
      "idTokenInfo": {
        "status": "Accepted",
        "groupIdToken": { "idToken": "PARENT001", "type": "Central" }
      }
    },
    {
      "idToken": { "idToken": "BLOCKED-001", "type": "Central" },
      "idTokenInfo": { "status": "Blocked" }
    }
  ]
}

Schema

Source: schemas/SendLocalListRequest.json, schemas/SendLocalListResponse.json (OCPP 2.0.1 FINAL)

Request schema (JSON Schema)
Response schema (JSON Schema)