OCPI 2.2.1-d2 | Draft 2

OCPI Implementation Guides

Comprehensive developer documentation for implementing the Open Charge Point Interface (OCPI) 2.2.1-d2 specification. Each guide covers a specific chapter — foundational concepts and core modules used to exchange data between CPO and eMSP platforms.

Content attribution: EVRoaming Foundation . This documentation is a reformat of the official OCPI 2.2.1-d2 protocol specification.

9 guides 57 total topics 9 of 9 available
9 topics Available

Terminology and Definitions

Key terms, abbreviations, market roles, provider/operator distinctions, charging topology, variable naming conventions, cardinality, and data retention rules used throughout the OCPI protocol.

2.12.22.32.42.52.62.72.82.9
9 topics Available

Supported Topologies

Network topologies supported by OCPI, from simple peer-to-peer connections through dual and mixed-role configurations to Hub-based architectures with message routing.

3.13.23.33.43.53.63.73.83.9
10 topics Available

Transport and Format

JSON/HTTP implementation guide covering security and authentication, pull and push models, request and response formats, message routing, unique IDs, endpoints, and offline behaviour.

4.14.24.34.44.54.64.74.84.94.10
5 topics Available

Status Codes

HTTP transport status codes and OCPI content-level status codes covering the success (1xxx), client error (2xxx), server error (3xxx), and hub error (4xxx) ranges.

5.15.25.35.45.5
5 topics Available

Versions Module

Required base module for discovering supported OCPI versions and their available endpoints, including version information, version details, data types, and GET examples.

6.16.26.36.46.5
5 topics Available

Credentials Module

Exchange of credentials tokens for authorisation of requests between OCPI platforms, including use cases, sender and receiver interfaces, object descriptions, and data types.

7.17.27.37.47.5
4 topics Available

Locations Module

Charging Location objects owned by the CPO, describing the operator's charging sites. Covers interfaces, object descriptions, and data types for managing locations via OCPI.

8.18.28.38.4
5 topics Available

Sessions Module

Charging Session objects describing one charging session, with the session lifecycle, sender and receiver interfaces, object descriptions, and data types used between CPO and eMSP systems.

9.19.29.39.49.5
5 topics Available

CDRs Module

Charge Detail Record describing a concluded charging session — the only billing-relevant object. Covers the CDR lifecycle, sender and receiver interfaces, object descriptions, and data types.

10.110.210.310.410.5

Guides marked Coming Soon are actively being developed. Check back for updates as more implementation guides are published.