Supported devices
Device Type | API |
---|---|
Alfen Battery Container (250 kWh – 2 MWh) | ✅ |

Configuration steps
-
API credentials
- Retrieve the API key and Battery ID in the Greener portal.
- They are required by the driver’s “User Inputs”.
-
Add the device
- In Integrations → Add device choose Greener API for Alfen Battery Control.
- Enter the API key and Battery ID exactly as provided.
- Confirm → the container appears with SOC and power.
-
Optional – setpoint control
When Smart-Grid Mode is enabled the driver sends a constant-power set-point (positive = charge, negative = discharge) to
/control/batteries/<ID>/command/set_constant_power_setpoint
.
Metrics exposed
Key | Description | Unit |
---|---|---|
actualPowerTot_W | Battery power (+ = discharge) | W |
stateOfCharge_frac | State of Charge (0–1) | – |
importedEnergyDeltaTot_Wh | Energy charged Δ | Wh |
exportedEnergyDeltaTot_Wh | Energy discharged Δ | Wh |
Troubleshooting
- 401 Unauthorized – check the API key string (no spaces, full length).
- 404 on Battery ID – verify the exact
GREENER_XXX
identifier. - Power not updating – Greener API provides new datapoints every ~10 s;
ensure outbound HTTPS (443) traffic is allowed.
Useful resources
- Greener documentation –
https://www.greener.nu/en/batteries