Last modified:
Set up Sungrow iSolarCloud API
General tips
-
Have the data source (data logger, etc.) serial number on hand. When entering the serial number, pay attention to uppercase and lowercase letters and empty spaces.
-
The data source name can be freely selected. For recommendations, see our Naming guideline.
-
If possible, use data sources that support the same Measuring interval or align the intervals. Otherwise minor features may not work properly.
-
We strongly recommend ticking the check box Automatic device creation to ensure that VCOM automatically creates any new devices found during each data import.
-
If possible, perform a connection test once you have completed the configuration in both VCOM and the data source.
Data loggers only
-
For data loggers, update the firmware to the latest version prior to configuration.
-
For data loggers, any import that uses FTP can also use SFTP. The access data, such as the FTP server address, user name, and password remain identical. Only the port changes from port 21 (FTP) to port 2222 (SFTP).
APIs only
-
If you experience import issues with the API, please contact the respective API provider first.
-
Each day at midnight, VCOM checks for complete data and requests data from the past 7 days. If there are no limitations from the API and the data is available, the gaps will be filled.
Configuration details
|
Protocol |
HTTPS Pull |
|---|---|
|
File format |
JSON |
|
Measuring interval |
5 min |
|
Server |
Provided during VCOM configuration |
|
User name |
Your iSolarCloud user name |
|
Password |
Your iSolarCloud password |
|
Plant ID |
Your iSolarCloud Plant ID ( In iSolarCloud, navigate to Plant > [Plant name] > Settings > General information > Plant ID.
You can also query the Plant ID using the iSolarCloud API. See the Sungrow Developer Portal for details. |
|
App key and access key |
|
Configuration: VCOM
Prerequisites
-
User group technical customer or higher
-
At system level , go to
System settings >
Data sources > Data logger overview.
-
Under New source of type, select Sungrow iSolarCloud API as the data source type from the dropdown.
-
Select Add.
-
Enter the Data logger name, Hardware serial number, and Measuring interval.
-
Enter the API configuration data. Be sure to select the region where the desired server is located.
-
Select Register new data logger.
The data source is configured.