Retrieve real-time DER telemetry from a SolarEdge Commercial Gateway via the SolarEdge Monitoring API and push aggregated fleet data to a DERMS

Steps

1. Authenticate to the SolarEdge Monitoring API at monitoring.solaredge.com using the site API key (obtained from the SolarEdge monitoring portal under Admin > Site Access > API Access); include it as the api_key query parameter on all requests
2. Retrieve site power and energy: GET https://monitoringapi.solaredge.com/site/{siteId}/currentPowerFlow?api_key=YOUR_KEY to get real-time active power for PV production, storage charge/discharge, and grid import/export
3. For storage state of charge, call GET /site/{siteId}/storageData?startTime=...&endTime=...&serials=... with the battery serial numbers; parse the storageData.batteries[].telemetries[].batteryPercentageState field
4. Aggregate the fleet: loop over all site IDs, collect currentPowerFlow responses, sum production_kw and battery_charge_kw, and POST the aggregated JSON telemetry payload to the DERMS ingest endpoint on a 5-minute schedule
5. Handle API rate limits: SolarEdge enforces 300 requests per API key per day for the standard tier; for fleets exceeding ~50 sites at 5-minute intervals, request a commercial API tier with higher limits through your SolarEdge account manager
6. Subscribe to SolarEdge site alerts via GET /site/{siteId}/alerts to detect offline inverters or grid disconnection events that would affect DER availability for dispatch