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

    Elke laadstation krijgt bij registratie een uniek 20-cijferig security secret. Dit secret wordt:

    • SHA-256 gehasht opgeslagen in de database • het origineel wordt nooit bewaard
    • Verstuurd via encrypted WebSocket (wss://)
    • Eenmalig zichtbaar voor de gebruiker • daarna alleen te regenereren

    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

    proxy.joulo.nl (uitleg)

    Gehoste OCPP-proxy: WebSocket-URL, CSMS + Joulo.

    Joulo voor developers

    Overzicht van alle tools, API's en integraties.

    OCPP-koppeling

    Verbind elke OCPP 1.6J-laadstation met Joulo.

    OCPP Proxy / Splitter

    Open-source proxy voor meerdere backends.

    Hosted OCPP Proxy

    Gebruik proxy.joulo.nl zonder self-hosting.

    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