Ga naar hoofdinhoud

SolarEdge omvormer via Cloud API aansluiting

Deze handleiding beschrijft hoe je een SolarEdge omvormer aansluit op de Currentt Navigator via de SolarEdge Monitoring API. Data wordt via de cloud opgehaald, er is geen lokale verbinding met de omvormer nodig.

waarschuwing

De Cloud API kan alleen gebruikt worden om omvormerdata uit te lezen. Sturing van de omvormer of batterij is niet mogelijk via de API. Gebruik hiervoor Modbus RTU of Modbus TCP.

Zie ook: Voor lokale aansluiting, raadpleeg de handleidingen voor Modbus RTU of Modbus TCP.

❓ Wanneer de Cloud API gebruiken?​

De Cloud API is geschikt wanneer:

  • Geen lokale (fysieke) toegang tot de omvormer mogelijk is
  • Monitoring op afstand gewenst is
Let op

De Cloud API heeft een vertraging van 10-15 minuten en is alleen-lezen. Voor real-time data of aansturing van de omvormer, gebruik Modbus RTU of Modbus TCP.

Alleen uitlezen: Via de SolarEdge Monitoring API kan de omvormer uitsluitend worden uitgelezen. Het is niet mogelijk om de omvormer aan te sturen, vermogen te begrenzen of instellingen te wijzigen via de API. Ook batterijsturing is niet mogelijk via de API. Sturing van de omvormer en batterij is alleen mogelijk via een lokale Modbus-verbinding (RTU of TCP).

📌 Vereisten​

  • SolarEdge omvormer die is gecommissioneerd en verbonden met het SolarEdge monitoring platform
  • Internetverbinding op de omvormer (via Ethernet, WiFi of mobiel netwerk)
  • Een account op het SolarEdge monitoring portaal (https://monitoring.solaredge.com)
  • Admin-toegang tot het portaal (om een API-sleutel aan te maken)

1️⃣ Stap 1: Controleer of de omvormer online is​

De omvormer moet data versturen naar de SolarEdge monitoring servers. Controleer dit als volgt:

  1. Ga naar https://monitoring.solaredge.com en log in
  2. Selecteer je site
  3. Controleer of er recente data zichtbaar is in het dashboard
  4. Controleer of de communicatiestatus groen is

Als de omvormer niet online is, controleer dan of de serververbinding correct is ingesteld. De omvormer stuurt data via Ethernet, WiFi of een mobiele verbinding naar de SolarEdge servers.

2️⃣ Stap 2: Site ID noteren​

Je hebt het Site ID nodig voor de API. Dit vind je als volgt:

  1. Log in op https://monitoring.solaredge.com
  2. Navigeer naar je site
  3. Kijk in de URL-balk van je browser: het getal in de URL is je Site ID
    • Voorbeeld: https://monitoring.solaredge.com/solaredge-web/p/site/123456/ -> Site ID = 123456

3️⃣ Stap 3: API-sleutel aanmaken​

Site API-sleutel (toegang tot 1 site)​

  1. Log in op https://monitoring.solaredge.com
  2. Klik op Admin in de bovenste navigatiebalk
  3. Ga naar Site Access > Access Control
  4. Scroll naar het kopje API Access
  5. Vink het akkoordvakje aan ("I have read, understood...")
  6. Klik op Save en bevestig de popup
  7. Kopieer de gegenereerde API-sleutel

Account API-sleutel (toegang tot alle sites)​

Een Account API-sleutel geeft toegang tot alle sites binnen een account. Deze is beschikbaar voor installateuraccounts:

  1. Log in op https://monitoring.solaredge.com
  2. Ga naar Admin > Account Details
  3. Genereer een Account Level API Key
waarschuwing

Het aanmaken van een nieuwe API-sleutel maakt de vorige ongeldig. Bestaande integraties die de oude sleutel gebruiken zullen stoppen met werken.

4️⃣ Stap 4: API testen​

Test of de API-sleutel werkt door de volgende URL in je browser te openen (vervang de waarden):

https://monitoringapi.solaredge.com/site/{SITE_ID}/overview?api_key={API_KEY}

Je zou een JSON-response moeten krijgen met onder andere:

  • currentPower - het huidige vermogen (W)
  • lastDayData - energie van vandaag (Wh)
  • lastMonthData - energie van deze maand (Wh)
  • lifeTimeData - totale energie (Wh)

5️⃣ Stap 5: Configuratie in de Currentt Navigator​

Na het verkrijgen van de API-sleutel, moet het apparaat worden toegevoegd in de Currentt Navigator. Dit kan op twee manieren:

🪄 Via de installatiehulp (aanbevolen)​

  1. Klik op het instellingenicoon (rechtsbovenin het scherm)
  2. Kies Installatiehulp
  3. Volg de stappen op het scherm

De installatiehulp begeleidt je stap voor stap door het volledige configuratieproces.

⚙️ Handmatig configureren​

  1. Klik op het instellingenicoon (rechtsbovenin het scherm)
  2. Ga naar Componenten
  3. Klik op de + knop bij de sectie Omvormers
  4. Selecteer SolarEdge
  5. Kies bij het onderdeel Communicatie voor API en vul de volgende gegevens in:
ParameterWaarde
Site ID(je Site ID, bijv. 123456)
API-sleutel(je API-sleutel)

📋 Samenvatting​

ParameterWaarde
API Base URLhttps://monitoringapi.solaredge.com
AuthenticatieAPI-sleutel als query parameter (api_key=...)
Site IDTe vinden in de URL van het monitoring portaal
Data vertraging10-15 minuten
Max verzoeken/dag300
Data formaatJSON
Firmware vereisteGeen (API is onafhankelijk van lokale firmware)
Internet vereistJa (omvormer en Navigator)