OSCP API Docs¶

Purpose¶

OSCP documentation covers Open Smart Charging Protocol integration behaviour for grid flexibility, capacity forecasts, measurements, connection lifecycle, and energy-management coordination. It is the protocol reference for DERMS and capacity-provider interactions.

OSCP is used when an external grid, DERMS, or capacity-management party needs to exchange flexibility information with BetterFleet. In the current BetterFleet design, OSCP-specific identity and lifecycle belong in a dedicated OSCP domain, while microgrid and charging domains receive protocol-neutral operating-envelope inputs.

What This Covers¶

OSCP roles: Flexibility Provider, Capacity Provider, and external grid or DERMS actors.
Connection lifecycle: registration, handshake, heartbeat, online/offline state, and operational visibility.
Group binding: mapping external group_id values to internal microgrid_id and node_id targets.
Forecast intake: receiving group capacity forecasts and translating them into generic operating envelopes.
Outbound provider messages: measurements, adjustment requests, and capacity-compliance responses.
Fallback handling: forecast gaps, fallback capacity, degraded operation, and auditability.
Connection profiles: partner-specific protocol deviations kept outside the core domain model.

BetterFleet Interpretation¶

Use OSCP when the question is about grid flexibility, DERMS integration, capacity forecasts, site-level operating envelopes, microgrid constraints, or protocol-specific grid coordination. OSCP should not leak protocol identifiers into the microgrid model; the OSCP domain maps protocol messages into BetterFleet concepts.

The public generated docs are the right place for protocol payload and endpoint details. BFDev docs should explain the domain boundary, group-binding model, lifecycle policy, and how OSCP affects microgrid and smart-charging behaviour.

Published Documentation¶

Public docs: https://vemo-oscp-3d8b73.gitlab.io/
Support microsite public wrapper: bf-support-microsite/public/docs/oscp.html
Source path: integrations/vemo-oscp when that integration checkout is present

bf-manage-core
bf-manage-sitepwrmon
bf-digital-twin
Smart charging
Energy and grid integration
Microgrid and operating-envelope handling

Chatbot Retrieval Terms¶

OSCP, Open Smart Charging Protocol, capacity forecast, group capacity forecast, flexibility provider, capacity provider, DERMS, operating envelope, measurements, microgrid, fallback capacity, handshake, heartbeat, group id.

Notes¶

Use the public generated docs for protocol payload and endpoint details.
Use the BFDev OSCP system design for BetterFleet-specific domain boundaries, lifecycle handling, and implementation guardrails.