Skip to content
Documentation Menu

Notify Report

Source: OCPP 2.0.1 Part 2 — Specification (Edition 2, 2022-12-15) — Section 1.40 (Messages); Use Cases B07 — Get Base Report, B08 — Get Custom Report (Functional Block B. Provisioning)

Overview

After the CSMS sends GetBaseReportRequest or GetReportRequest, the Charging Station delivers the resulting Device Model report as a sequence of NotifyReportRequest messages. Each carries a chunk of reportData[] and is identified by seqNo; the last chunk has tbc = false.

Sequence Diagram

Charging Station  ──── NotifyReportRequest ────▶  CSMS
                       (requestId, generatedAt, tbc?, seqNo, reportData[]?)
Charging Station  ◀─── NotifyReportResponse ────  CSMS

(repeated until tbc = false)

Initiator

Charging Station → CSMS

Fields

Field NameField TypeCard.Description
requestIdinteger1..1Required. The id from the originating GetReportRequest or GetBaseReportRequest.
generatedAtdateTime1..1Required. Timestamp at the Charging Station when the message was generated.
tbcboolean0..1Optional. "To be continued" indicator. Default false.
seqNointeger1..1Required. Sequence number. First message starts at 0.
reportDataReportDataType0..*Optional. List of ReportData entries.

ReportDataType (selected fields)

FieldTypeCard.Description
componentComponentType1..1Component for which the report data applies.
variableVariableType1..1Variable for which the report data applies.
variableAttributeVariableAttributeType1..*List of attribute values (Actual, Target, MinSet, MaxSet).
variableCharacteristicsVariableCharacteristicsType0..1Optional. Type, unit, valuesList, min/max, supportsMonitoring.

Examples

{
  "requestId": 11,
  "generatedAt": "2026-04-27T12:34:56Z",
  "seqNo": 0,
  "tbc": false,
  "reportData": [
    {
      "component": { "name": "OCPPCommCtrlr" },
      "variable": { "name": "HeartbeatInterval" },
      "variableAttribute": [
        { "type": "Actual", "value": "300", "mutability": "ReadWrite", "persistent": true }
      ],
      "variableCharacteristics": {
        "dataType": "integer",
        "unit": "s",
        "supportsMonitoring": true
      }
    }
  ]
}

Schema

Source: schemas/NotifyReportRequest.json, schemas/NotifyReportResponse.json (OCPP 2.0.1 FINAL)

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