OCPP API

    OCPP integratie documentatie

    Technische instructies voor installateurs en ontwikkelaars om OCPP-laadpalen 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 laadpaal • wordt toegewezen bij registratie in het Joulo-dashboard.
    security_secret24-cijferig automatisch gegenereerd secret. Beschikbaar in het laadpaal-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 laadpaal krijgt bij registratie een uniek 24-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 laadpaal in het Joulo-dashboard ontvang je stap-voor-stap instructies specifiek voor jouw merk.

    Web-interface

    Veel laadpalen 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.

    Gerelateerde pagina's

    Joulo voor developers

    Overzicht van alle tools, API's en integraties.

    OCPP-koppeling

    Verbind elke OCPP 1.6J-laadpaal met Joulo.

    OCPP Proxy / Splitter

    Open-source proxy voor meerdere backends.

    Platform status

    Realtime status van alle Joulo-diensten.

    developer.joulo.nl

    Developer portaal met uitgebreide documentatie.

    status.joulo.nl

    Realtime status van alle Joulo-diensten.

    Klaar om te starten?

    Maak een gratis account aan en verbind je laadpaal. Je API-token vind je direct in het dashboard.

    Gratis aanmeldenAPI docs