Last modified:
Set up Sungrow iSolarCloud API
General tips
-
Serial number: 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.
-
Name: In most cases, the data source name can be freely selected. For recommendations, see our Naming guideline.
-
Multiple data sources: If possible, use data sources that support the same measuring interval or align the intervals if possible. Otherwise, minor features may not work properly. See also Measuring interval.
-
Automatic device creation: This will automatically create new devices in the system, such as inverters or batteries, as soon as their data is included in a new import file. It is not possible to manually create these devices. In rare exceptional cases, for example, if the devices are already included in another system, you do not need to tick this checkbox.
-
Connection test: 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
Steps
-
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.