VCOM Cloud
Breadcrumbs

GoodWE API

Last modified:



Guideline Data logger import configuration

📗

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.

  • Set the same measuring interval for all data sources in the system to ensure charts are accurately displayed in VCOM. This is used to normalize uneven timestamps and aggregate smaller recorded intervals into larger ones.

  • To ensure that the data source measuring interval has been set correctly in VCOM, open an imported file in the Data logger overview portlet in VCOM and check the timestamps.

  • We 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

  • 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

Pull via HTTPS

File format

JSON

Measuring interval

5 min

Query interval

5 min

User name

User name for the GoodWe SEMS portal.

Password

Password for the GoodWe SEMS portal.

Plant ID

To find the Plant ID required for VCOM, log in to the GoodWe SEMS platform and copy the alphanumeric string in the last part of the URL.

image-20250916-063506.png
Plant ID in the GoodWe SEMS platform


Configuration: API

  1. Set up your GoodWe SEMS account.

  2. Request API access from GoodWE SEMS.

📗

Tip

Contact GoodWE SEMS if you require assistance with these steps.


Configuration: VCOM

  1. In the VCOM icon-database-insert.png System configuration, select Data sourcesData logger overview > select GoodWe API.

  2. Select Add.

  3. Enter the Data logger name and Data logger serial number.

  4. Select the Region (relevant server location).

  5. Enter the User name, Password, and Plant ID from the SEMS GoodWe platform.

  6. Select Register new data logger.

The data logger is set up.

image-20250916-073022.png
Configure GoodWe API in VCOM