Sungrow iSolarCloud | Sofar EMS Documentation

Dispositivi supportati

Device Type
Tutti gli inverter Sungrow registrati in iSolarCloud

Prerequisito: ogni inverter è già aggiunto al tuo account iSolarCloud ed è visibile nel portale web o nell'app mobile.

Raccogli le credenziali API
iSolarCloud → Impostazioni → Open API ti fornisce:
API Key, Access Key e RSA Key.
Crea un utente in sola lettura (consigliato)
In Utenti e Ruoli aggiungi un utente “API” dedicato e limita i suoi permessi a Lettura.

Aggiungi il driver in Sofar

Compila i campi:

Campo	Esempio
Username / Password	`api_user / S3cureP@ss`
API Key / Access Key / RSA Key	valori dal passo 1
Filtro posizione	`100;101` (opzionale – lista separata da punti e virgola)
Tipo comando	default (limite potenza attiva)

Salva – ogni inverter appartenente alle posizioni selezionate apparirà automaticamente.

Chiave	Descrizione	Unità
`actualPowerTot_W`	Potenza AC istantanea dell’impianto fotovoltaico	W
`producedEnergyDeltaTot_Wh`	Energia FV dalla lettura precedente ¹	Wh
`importedEnergyDeltaTot_Wh`	Energia importata dalla rete (se fornita da Sungrow)	Wh
`exportedEnergyDeltaTot_Wh`	Energia esportata in rete (immissione)	Wh

¹ Il driver integra la potenza nel tempo quando i contatori assoluti di kWh non sono disponibili.

HTTP 401 / 403 – ricontrolla le credenziali API e che l'utente abbia abilitato l’accesso API in iSolarCloud.
Nessun inverter rilevato – verifica la lista degli ID posizione; lascia il campo vuoto per recuperare tutti gli impianti associati all’account.
Limitazione ignorata – alcune vecchie versioni firmware Sungrow non rispettano i limiti di potenza attiva; passa il driver in modalità comando Alternativa (ON/OFF) nelle impostazioni.

Device Type
Tutti gli inverter Sungrow registrati in iSolarCloud

Prerequisito: ogni inverter è già aggiunto al tuo account iSolarCloud ed è visibile nel portale web o nell'app mobile.

Raccogli le credenziali API
iSolarCloud → Impostazioni → Open API ti fornisce:
API Key, Access Key e RSA Key.
Crea un utente in sola lettura (consigliato)
In Utenti e Ruoli aggiungi un utente “API” dedicato e limita i suoi permessi a Lettura.

Aggiungi il driver in Sofar

Compila i campi:

Campo	Esempio
Username / Password	`api_user / S3cureP@ss`
API Key / Access Key / RSA Key	valori dal passo 1
Filtro posizione	`100;101` (opzionale – lista separata da punti e virgola)
Tipo comando	default (limite potenza attiva)

Salva – ogni inverter appartenente alle posizioni selezionate apparirà automaticamente.

Chiave	Descrizione	Unità
`actualPowerTot_W`	Potenza AC istantanea dell’impianto fotovoltaico	W
`producedEnergyDeltaTot_Wh`	Energia FV dalla lettura precedente ¹	Wh
`importedEnergyDeltaTot_Wh`	Energia importata dalla rete (se fornita da Sungrow)	Wh
`exportedEnergyDeltaTot_Wh`	Energia esportata in rete (immissione)	Wh

¹ Il driver integra la potenza nel tempo quando i contatori assoluti di kWh non sono disponibili.

HTTP 401 / 403 – ricontrolla le credenziali API e che l'utente abbia abilitato l’accesso API in iSolarCloud.
Nessun inverter rilevato – verifica la lista degli ID posizione; lascia il campo vuoto per recuperare tutti gli impianti associati all’account.
Limitazione ignorata – alcune vecchie versioni firmware Sungrow non rispettano i limiti di potenza attiva; passa il driver in modalità comando Alternativa (ON/OFF) nelle impostazioni.