Monitoring API release notes


Version 1.16.0 (2023-05-23)

  • New property in (GET /monitoring/v1/plants/{plantId}/installation) endpoint:
    • calculatedAcNominalPower - Nominal AC power of the plant in [W], calculated as the sum of the individual AC powers of all active PV inverters.
  • Support for the functionalities of the Sunny Home Manager in ennexOS:
    • Consumer devices

Version 1.15.0 (2023-03-29)

  • Sunny Portal system migration (SunnyPortal classic to Sunny Portal powered by ennexOS): 
    • Plant/system-list is automatically filtered for migrated systems and contains the new plantIds from Sunny Portal powered by ennexOS
    • Permanent Redirect for migrated classic systems: 
      • API-response returns an HTTP code 308 without a response body
      • New plantId/deviceId in location header, including any query params.
    • More details on MigrationAnnouncement (sma.de)
  • Bugfix for:
    • Endpoint (GET /monitoring/v1/plants/{plantId}/installation) – co2SavingsFactor is missing from plants/installation response object
  • Endpoint (GET /monitoring/v1/devices/{deviceId}/measurement/sets/EnergyMix/{period}) –now available for ennexOS devices too.

Version 1.14.2 (2023-01-25)

  • Bugfix for:
    • Endpoint (GET /monitoring/v1/plants/{plantId}/logs) – Some log messages have returned inacurate data
  • Documentation improvements

Version 1.14.1 (2023-01-12)

  • Bugfix for:
    • Endpoint (GET /monitoring/v1/plants/{plantId}/installation) – Validation error due to incorrect value ranges for the azimuth property

Version 1.14.0 (2023-01-10)

  • Bugfix for:
    • Endpoint (GET /monitoring/v1/plants/{plantId}/measurements/sets/EnergyBalance) – missing or incorrect Total property in some ennexOS systems
  • New property in (GET /monitoring/v1/plants/{plantId}/installation) endpoint:
    • pvModuleAreas - List of the PV modules, supported only in ennexOS systems

Version 1.13.2 (2022-10-19)

  • Bugfix for:

    • Endpoint (GET /monitoring/v1/plants/{plantId}/measurements/sets/EnergyBalance) – Improvement for systems without PV generation


Version 1.13.0 (2022-09-28)

  • Bugfixes for:
    • Endpoint (GET /monitoring/v1/plants/{plantId}/configuration) - plantWithBattery property takes into account whether a battery device is active
    • Endpoint (GET /monitoring/v1/devices/{deviceId}/measurements/sets/PowerAc) - Fallback for missing VoltagePhaseA values
    • Endpoint (GET /monitoring/v1/plants/{plantId}/measurements/sets/EnergyBalance) - Improvement for Week-hourly WithTotal calls
  • SmartConnected info within the following endpoints:
    • Endpoint (GET /monitoring/v1/plants/{plantId}/devices) - SmartConnected-capability of devices
    • Endpoint (GET /monitoring/v1/plants/{plantId}/configuration) - SmartConnected-status of the system
    • Endpoint (GET /monitoring/v1/plants/{plantId}/stakeholders) - SmartConnected-stakeholders

Version 1.12.1 (2022-07-20)

  • Bugfixes for:
    • Endpoint (GET /monitoring/v1/plants/{plantId}/logs; …devices/{deviceId}/logs) - Change the log access level of the custom flow client user, from standard to installer
    • Endpoint (GET /monitoring/v1/plants/{plantId}/communication) - issues with partial timeouts
    • Endpoint (GET /monitoring/v1/devices/{deviceId}/measurements/sets) - No access to the satellite sensor
    • Endpoint (GET /monitoring/v1/plants) - deliver partial result if only classic or only ennexOS is not available

Version 1.12.0 (2022-06-28)

  • New property in (GET /monitoring/v1/plants/{plantId}/installation) endpoint:
    • co2SavingsFactor - The CO2 savings factor [g/kWh] indicates how much CO2 is produced when generating one kilowatt hour of electricity, or how much CO2 was not produced by the environmentally friendly electricity generation of your PV system
  • New property in (GET /monitoring/v1/plants/{plantId}/configuration) endpoint:
    • plantWithLiveData - True, if the plant supports live data, false otherwise. Currently only classic WebConnect and Home-Manager systems support live data

Version 1.11.0 (2022-05-17)

  • Documentation improvements
  • Device status value improvements
  • Bugfixes for:
    • Endpoint (GET /monitoring/v1/devices/{deviceId}/measurements/sets) - delivers partly unsupported measurement sets
    • Endpoint (GET /monitoring/v1/devices/{deviceId}/measurements/sets/PowerDc) - delivers partly wrong timestamps and/or no values