OCPI API Docs¶

Purpose¶

OCPI documentation covers Open Charge Point Interface integration behaviour for charge point operator and e-mobility service provider workflows. It is the main protocol reference for roaming, token authorization, session exchange, tariff exchange, location exchange, credential setup, and charge detail records.

OCPI lets independent charging platforms exchange roaming data without placing a central broker in control of the charging assets. BetterFleet uses this protocol context when it needs to connect charge point operators, e-mobility service providers, and roaming hubs across locations, tariffs, tokens, commands, sessions, and billing records.

What This Covers¶

Platform roles: CPO, eMSP, MSP, and roaming hub responsibilities.
Discovery and onboarding: version negotiation, module discovery, credentials exchange, and token rotation.
Core catalogue data: locations, EVSEs, connectors, tariffs, and driver tokens.
Real-time operations: session updates, remote commands, reservation actions, connector unlocks, and authorization checks.
Settlement data: CDRs, signed meter readings, tariff references, tax fields, and payment-related extensions.
Operational concerns: OCPI status codes, pagination, HTTPS transport, JSON payloads, retry behaviour, and partner-specific rollout constraints.

BetterFleet Interpretation¶

Use OCPI when the question is about roaming and third-party charging-network interoperability. In BetterFleet terms, OCPI usually sits at the boundary between internal charging/session state and an external party that needs a standards-based view of locations, tariffs, tokens, sessions, or CDRs.

The generated docs are the right place for exact module payloads and endpoint shapes. BFDev docs should hold durable BetterFleet context: which service owns the integration, how data maps into product concepts, which rollout or support runbook applies, and where API compatibility constraints affect a change.

Published Documentation¶

Public docs: https://ocpi-integrator-587b19.gitlab.io
Support microsite public wrapper: bf-support-microsite/public/docs/ocpi.html
Source path: integrations/ocpi-integrator

bf-manage-roaming
bf-manage-core
Roaming and shared charging
Commercial settlement and shared charging
Network access and interoperability

Chatbot Retrieval Terms¶

OCPI, roaming, eMSP, CPO, credentials, locations, tariffs, tokens, sessions, CDRs, charge detail records, authorization, connector status, remote charging, shared charging.

Notes¶

Use the public generated docs for endpoint-level details and schema examples.
Keep durable BetterFleet-specific interpretation in this BFDev docs section so the chatbot can retrieve it.