Skip to main content
Skip table of contents

KACO REST API

Set up KACO REST API

KACO inverters of the blueplanet TL series can send data directly to VCOM via the KACO REST 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.

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

  • If possible, perform a connection test once you have completed the configuration in both VCOM and the data source.

Configuration details

Protocol

REST API

File format

CSV

Measuring interval

Variable: 300 sec/5 min recommended

Server

www1.meteocontrol.de

Port

80 or 443

Configuration: Inverter
  • Enable data transfer to meteocontrol

Configuration: VCOM
  • In VCOM under Data logger configuration, add the REST API as the device type.

  • Enter the inverter serial number correctly, for example 50.0TLXXXXXXX

image-20241108-125758.png

KACO REST API configuration

Troubleshooting: Missing data in VCOM

The interval column has incorrect data:

  • The inverter sends only one file per day

  • The data file is empty

  • Incorrect time stamp in the data file

troubleshooting kaco direct-20241108-125916.png

Example of missing data: incorrect timestamp

  • The inverter does not establish a connection to meteocontrol

    image-20241108-130149.png

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.