CustomerInformation

CustomerInformation CSMS->CS OCPP 2.0.1

Sent by the CSMS to request or clear customer-related information stored on the Charging Station, such as transaction history or authorization data for a specific customer.

Quick Reference

Required Fields

requestId integer

Request ID to correlate NotifyCustomerInformation responses

report boolean

If true, the Charging Station should report customer information

clear boolean

If true, the Charging Station should clear customer information

Optional Fields

customerIdentifier string(64)

Customer identifier (e.g., name or customer number)

idToken IdTokenType

Token associated with the customer

customerCertificate CertificateHashDataType

Certificate associated with the customer

Example Payload

{
  "requestId": 1,
  "report": true,
  "clear": false,
  "idToken": {
    "idToken": "AABBCCDD",
    "type": "ISO14443"
  }
}

Example Full Frame

[
  2,
  "msg-001",
  "CustomerInformation",
  {
    "requestId": 1,
    "report": true,
    "clear": false,
    "idToken": {
      "idToken": "AABBCCDD",
      "type": "ISO14443"
    }
  }
]

Format: [MessageType, MessageId, Action, Payload]

Open in Builder Go to Validator

Overview

CustomerInformation enables the CSMS to request or delete customer-related data stored on the Charging Station. This is particularly important for GDPR compliance — the right to be forgotten requires being able to delete PII from charging hardware.

When to Send

To report charging history for a specific customer
To delete stored customer data for GDPR compliance
To audit what data is stored on the station for a specific user

Expected Response

Initial: status: Accepted, Rejected, or Invalid

If report: true, the actual data arrives via NotifyCustomerInformation.

Usage Notes

Both report and clear can be true simultaneously (report then delete)
The identifier can be the idToken, a certificate, or a customerIdentifier string
clear: true permanently removes the matching data — use with caution

Testing Tips

Build up transaction history for an idToken, then request and verify the report
Test clear: true and verify the data is no longer reported on subsequent requests

Common Errors

`GenericError`

Cause: Both report and clear are false

Solution: At least one of report or clear must be true