Supported devices

Device Type	API
Alfen Battery Container (250 kWh – 2 MWh)	✅

---

Configuration steps

1. API credentials

   • Retrieve the API key and Battery ID in the Greener portal.
   • They are required by the driver’s “User Inputs”.

2. 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.

3. 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