OCPP integratie documentatie
Technische instructies voor installateurs en ontwikkelaars om OCPP-laadstations te verbinden met Joulo's Central System Management Server (CSMS).
// verbinding
WebSocket endpoint
URL-formaat
wss://ocpp.joulo.nl/<charge_point_id>?auth=<security_secret>charge_point_idUnieke ID van je laadstation • wordt toegewezen bij registratie in het Joulo-dashboard.security_secret20-cijferig automatisch gegenereerd secret. Beschikbaar in het laadstation-paneel na koppeling.// berichten
Ondersteunde OCPP-berichten
BootNotificationRegistratie bij verbinding • vendor, model, firmware
HeartbeatPeriodieke statuscheck • elke 60 seconden
StatusNotificationConnectorstatus: Available, Charging, Faulted
StartTransactionStart laadsessie met meterwaarde
StopTransactionBeëindig sessie, eindmeterstand en reden
MeterValuesTussentijdse energiemetingen (Wh)
AuthorizeGebruikersautorisatie • altijd geaccepteerd
DataTransferFabrikant-specifieke berichten
// beveiliging
Authenticatie & beveiliging
Elk laadstation krijgt bij registratie een uniek 20-cijferig security secret. Dit secret:
- wordt bewaard bij je registratie, zodat je de verbindings-URL later opnieuw kunt opvragen • alleen jouw eigen account kan het uitlezen (Row Level Security)
- gaat over een versleutelde WebSocket (wss://)
- blijft zichtbaar in je dashboard • vervang je het, dan werkt de oude waarde direct niet meer
De gateway valideert elke verbinding door SHA-256 van het aangeboden secret te vergelijken met de hash bij je registratie. Verbindingen zonder geldig secret worden geweigerd. Elk bericht wordt gevalideerd tegen het OCPP 1.6J-schema.
// configuratie
Configuratie per merk
De OCPP-instellingen bevinden zich op verschillende plekken per merk. Na het koppelen van je laadstation in het Joulo-dashboard ontvang je stap-voor-stap instructies specifiek voor jouw merk.
Web-interface
Veel laadstations hebben een ingebouwde webserver (bijv. 192.168.x.x) waar je de OCPP-URL configureert.
Fabrikant-app
Sommige merken (Alfen, EVBox) bieden een app of cloud-portaal waar je de OCPP backend-URL instelt.
Installateur
Bij sommige installaties configureert de installateur de OCPP-instellingen tijdens de montage.
Tip: zet WebSocketPingInterval op 60 seconden. De fabrieksinstelling is bij sommige merken (waaronder Alfen) 10 seconden, wat onnodig veel verkeer oplevert en op wisselvallige verbindingen voor valse disconnects zorgt.
Gerelateerde pagina's
Joulo voor developers
Overzicht van alle tools, API's en integraties.
OCPP-koppeling
Verbind elke OCPP 1.6J-laadstation met Joulo.
OCPP API
OCPP WebSocket-integratie en configuratie.
Home Assistant
Sensors, lovelace en automations via de REST API.
Platform status
Realtime status van alle Joulo-diensten.
Developer Docs
Quickstart, authenticatie, guides en REST API-referentie.
status.joulo.nl
Realtime status van alle Joulo-diensten.
Klaar om te starten?
Maak een gratis account aan en verbind je laadstation. Je API-token vind je direct in het dashboard.