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 Name | Field Type | Card. | Description |
|---|---|---|---|
| versionNumber | integer | 1..1 | Required. Full update: version number of the new list. Differential update: version after the update is applied. |
| updateType | UpdateEnumType | 1..1 | Required. Full or Differential. |
| localAuthorizationList | AuthorizationData | 0..* | Optional. The list entries. |
| Field Name | Field Type | Card. | Description |
|---|---|---|---|
| status | SendLocalListStatusEnumType | 1..1 | Required. Whether the CS successfully applied the update. |
| statusInfo | StatusInfoType | 0..1 | Optional. Detailed status information. |
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" }
}
]
}{
"status": "Accepted"
}Schema
Source:
schemas/SendLocalListRequest.json,schemas/SendLocalListResponse.json(OCPP 2.0.1 FINAL)