Customer Information

Source: OCPP 2.0.1 Part 2 — Specification (Edition 2, 2022-12-15) — Section 1.12 (Messages); Use Cases N09 — Get Customer Information, N10 — Clear Customer Information (Functional Block N. Diagnostics)

Overview

The CSMS sends CustomerInformationRequest to:

Ask the Charging Station to report the data it holds about a specific customer (report = true), or
Ask the CS to clear the data it holds about that customer (clear = true), or both.

The customer is identified by one of: customerIdentifier, idToken, or customerCertificate.

When report = true, the CS subsequently sends one or more NotifyCustomerInformation messages carrying the requested data.

Sequence Diagram

CSMS  ──── CustomerInformationRequest ────▶  Charging Station
            (requestId, report, clear, customerIdentifier? | idToken? | customerCertificate?)
CSMS  ◀─── CustomerInformationResponse ────  Charging Station
            (status, statusInfo?)

(if report=true: zero or more NotifyCustomerInformationRequest follow)

Initiator

CSMS → Charging Station

Fields

Field Name	Field Type	Card.	Description
requestId	integer	1..1	Required. Id of the request.
report	boolean	1..1	Required. Flag indicating whether the CS should return `NotifyCustomerInformation` messages.
clear	boolean	1..1	Required. Flag indicating whether the CS should clear customer information.
customerIdentifier	string [0..64]	0..1	Optional. Vendor-specific identifier. One of (customerIdentifier, idToken, customerCertificate) should be set.
idToken	IdTokenType	0..1	Optional. The `IdToken` of the customer.
customerCertificate	CertificateHashDataType	0..1	Optional. The certificate of the customer.

CustomerInformationStatusEnumType values

Accepted, Rejected, Invalid.

Examples

{
  "requestId": 77,
  "report": true,
  "clear": false,
  "idToken": { "idToken": "044943121F1A80", "type": "ISO14443" }
}

{
  "status": "Accepted"
}

Schema

Source: schemas/CustomerInformationRequest.json, schemas/CustomerInformationResponse.json (OCPP 2.0.1 FINAL)

Request schema (JSON Schema)

Response schema (JSON Schema)

Field Name	Field Type	Card.	Description
status	CustomerInformationStatusEnumType	1..1	Required. Whether the request was accepted.
statusInfo	StatusInfoType	0..1	Optional. Detailed status information.