SolarEdge Extra

This QuickApp gets extra information from your SolarEdge managed Solar Panels to give you the most insight of your SolarEdge installation. 

• Site Details: Displays the site details, such as name, location, status, etc.
• Site Overview: Display the site overview data.
• Inventory: Return the inventory of SolarEdge equipment in the site, including inverters/SMIs, batteries, meters, gateways and sensors.
• Inverter Technical Data: Return specific inverter data for a given timeframe.
• Site Power: Return the site power measurements in 15 minutes resolution.
• Site Energy: Return the site energy measurements in 15 minutes resolution.
• Site Environmental Benefits: Returns all environmental benefits based on site energy production: CO2 emissions saved, equivalent trees planted, and light bulbs powered for a day.

Use of the monitoring server API is subject to a query limit of 300 requests for a specific account token and a parallel query limit of 300 requests for each specific site ID from the same source IP. The monitoring server API allows up to 3 concurrent API calls from the same source IP. Any additional concurrent calls will return HTTP 429 error – too many requests.

See API documentation on https://www.solaredge.com/sites/default/files/se_monitoring_api.pdf 

 

Site Details:

• id – the siteID
• name – the site name
• account id – the account this site belongs to
• status – the site status (see Site Status on page 53)
• peak power – site peak power
• currency - e.g. EUR
• installationDate – site installation date (format: yyyy-MM-DD hh:mm:ss )
• ptoDate – permission to operate date
• notes
• type – site type
• location:
  •   country
  •   state
  •   city
  •   address
  •   secondary address
  •   zip
  •   time zone
• alertQuantity - number of open alerts in this site *
• alertSeverity – the highest alert severity in this site *
• publicSettings:
•   isPublic - if this site is public (true or false)
•   public name - name

* _{Alert information is only available when using an API_KEY generated by an account. API_KEY generated at the site level does not return this information.}

 

Inventory:

• Inverter 
  •   name – the inverter name e.g. Inverter 1
  •   manufacturer – manufacturer name (SolarEdge)
  •   model name e.g. SE16K
  •   Firmware version e.g. 2.52.311
  •   communicationMethod – the communication interface used to connect to server. e.g.: Ethernet or WIFI.
  •   serialNumber – the equipment serial number e.g.: 7F123456-00
  •   connectedOptimizers – number of optimizers connected to the inverter
• Meters
  •   name – the inverter name e.g. “FeedInMeter”
  •   Manufacturer – e.g. “WattNode”
  •   Model – meter model number
  •   SN – serial number (if applicable)
  •   Type – metertype, e.g. “Production”
  •   Firmware Version (if applicable)
  •   Connected To – Name of SolarEdge device the meter is connected to
  •   connectedSolaredgeDeviceSN – serial number of the inverter/gateway the meter is connected to
  •   form – physical for a HW meter or virtual if calculated by arithmetic between other meters
• Sensors (Irradiance/wind/temperature sensors)
  •   connectedSolaredgeDeviceSN – the S/N of the device it is connected to e.g. 12345678-00
  •   Id – e.g. “SensorDirectIrradiance”
  •   connectedTo – name of the device it is connected to e.g. “Gateway 1”
  •   Category – e.g.IRRADIANCE
  •   Type – e.g. “Plane of array irradiance”
• Gateways
  •   name – the inverter name e.g. Inverter 1
  •   serialNumber – the equipment serialnumber e.g. 7F123456-00
  •   Firmwareversion
• Batteries
  •   Name
  •   SerialNumber
  •   Manufacturer - the battery manufacturer name
  •   Model - the battery model name
  •   Nameplate capacity - the nameplate capacity of the battery as provided by the manufacturer
  •   Firmwareversion
  •   ConnectedTo – Name of SolarEdge device the battery is connected to
  •   connectedSolaredgeDeviceSN – serial number of the inverter/gateway the battery is connected to

 

Interver Technical data:

• timestamp 
• AC current (divided per phase)
• AC voltage (divided per phase)
• AC frequency (divided per phase) 
• QRef (divided per phase)
• CosPhi (divided per phase)
• TotalActivePower 
• apparentPower - Supported starting communication board version 2.474
• activePower - Supported starting communication board version 2.474
• reactivePower
• DC voltage 
• groundFaultResistance 
• powerLimit %
• Lifetime energy - Supported starting communication board version 2.474
• totalEnergy 
• temperature - Celsius
• inverterMode 
  •   SLEEPING – night mode
  •   STARTING – pre-production
  •   MPPT – production
  •   THROTTLED – Forced power reduction
  •   SHUTTING_DOWN – Shutdown procedure
  •   FAULT – error mode
  •   STANDBY – maintenance
  •   LOCKED_STDBY – standby mode lock
  •   LOCKED_FIRE_FIGHTERS – firefighters lock mode
  •   LOCKED_FORCE_SHUTDOWN – forced shutdown from server
  •   LOCKED_COMM_TIMEOUT – communication timeout
  •   LOCKED_INV_TRIP – inverter self-lock trip
  •   LOCKED_INV_ARC_DETECTED – inverter self-lock on arc detection
  •   LOCKED_DG – inverter lock due to DG mode enable
  •   LOCKED_PHASE_BALANCER – inverter lock due to phase imbalance (1ph, Australia only) 
  •   LOCKED_PRE_COMMISSIONING – inverter lock due to pre-commissioning
  •   LOCKED_INTERNAL – inverter lock due to an undisclosed internal reason
• operationMode
  •   0 – On-grid
  •   1 – Operating in off-grid mode using PV or battery
  •   2 - Operating in off-grid mode with generator (e.g. diesel) is present
• apparentPower - VA (divided per phase) 
• activePower - VA (divided per phase) 
• reactivePower - VAR (divided per phase) 
• cosPhi (divided per phase) 
• vL1ToN - 1ph only 
• vL2ToN - 1ph only 
• vL1To2 - 3ph only
• vL2To3 - 3ph only
• vL3To1 - 3ph only

 

Environmental Benefits:

• CO2 - quantity of CO2 emissions that would have been generated by an equivalent fossil fuel system
• SO2 - quantity of SO2 emissions that would have been generated by an equivalent fossil fuel system
• NOX - quantity of NOX emissions that would have been generated by an equivalent fossil fuel system
• treesPlanted - equivalent planting of new trees for reducing CO2 levels
• lightBulbs - number of light bulbs that could have been powered by the site for a day

 

Site Power Detailed:

• timeUnit - the time unit (QUARTER_OF_AN_HOUR)
• unit - the measurement units (e.g. Watt)
• type - i.e. Production, Consumption, SelfConsumption, FeedIn (export) or Purchased (import)
• date - date and time
• value - power in Watt at that time of the day

 

Site Energy Detailed:

• timeUnit - the time unit (QUARTER_OF_AN_HOUR)
• unit - the measurement units (e.g. Wh)
• type - i.e. Production, Consumption, SelfConsumption, FeedIn (export) or Purchased (import)
• date - date and time
• value - power in Wh at that time of the day

 

Overview:

• id
• currentPower
• lastDayData energy
• lastDayData revenue
• lastMonthData energy
• lastMonthData revenue
• lastYearData energy
• lastYearData revenue
• lifeTimeData energy
• lifeTimeData revenue
• lastUpdateTime

 

Changes version 0.1 (25th June 2023)

• First (development) version

 

Variables (mandatory and created automatically): 

• siteID = Site ID of your SolarEdge Inverter (see your Inverter Site Details)
• apiKey = API key of your SolarEdge Inverter like format 12345678-90 (contact your installer if you don't have one)
• serialNumber = Short serialNumer of your SolarEdge Inverter (see your Inverter Inventory Details)
• language = Preferred language (default = English (en)) 
• debugLevel = Number (1=some, 2=few, 3=all, 4=simulation mode) (default = 1)

 

 How to install: 

1. Open the Configuration Interface
2. Go to Settings > Devices
3. Click  +
4. Choose Other Device
5. Choose Upload File
6. Choose file from your computer with .fqax