OCPP API

    OCPP integratie documentatie

    Technische instructies voor installateurs en ontwikkelaars om OCPP-laadstations te verbinden met Joulo's Central System Management Server (CSMS).

    OCPP 1.6J
    WebSocket
    SHA-256

    // 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

    BootNotification
    CP → CSMS

    Registratie bij verbinding • vendor, model, firmware

    Heartbeat
    CP → CSMS

    Periodieke statuscheck • elke 60 seconden

    StatusNotification
    CP → CSMS

    Connectorstatus: Available, Charging, Faulted

    StartTransaction
    CP → CSMS

    Start laadsessie met meterwaarde

    StopTransaction
    CP → CSMS

    Beëindig sessie, eindmeterstand en reden

    MeterValues
    CP → CSMS

    Tussentijdse energiemetingen (Wh)

    Authorize
    CP → CSMS

    Gebruikersautorisatie • altijd geaccepteerd

    DataTransfer
    CP ↔ CSMS

    Fabrikant-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.

    Gratis aanmeldenAPI docs