VCOM Cloud
English German
English German

Import interface V2

Last modified:

About Import Interface V2

Import Interface V2 is a standardized push interface for transferring data from external systems to VCOM. It is typically used when a system is not supported through a dedicated manufacturer integration or when data needs to be transferred from a proprietary data logger, an in-house monitoring system, or a PPC.

Instead of VCOM retrieving data from a data logger or cloud platform, a manufacturer or third-party system implements meteocontrol's import specification and then sends measured data directly to VCOM on a regular basis.

Using this data source does not incur additional costs.

📗

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

  • FTP (port 21) or SFTP (port 2222) push

    • The credentials specific to your data source are shown in VCOM

  • or HTTP push

Note for data transfer via FTP/SFTP

As an FTP/SFTP client, you can establish only 10 connections in parallel. Keep this in mind if you are collecting data from many loggers and want to send it all at once.

File format

  • XML (recommended)

  • or CSV

Note

The maximum size for a single file is 5 MB.

Possible measuring intervals

  • 60 sec (1 min). Will be aggregated to a larger interval once the storage period for minute values expires. See also Data resolutions and storage periods.

  • 300 sec (5 min)

  • 600 sec (10 min)

  • 900 sec (15 min)

  • 1800 sec (30 min)

  • 3600 sec (60 min)

Server

Add Import Interface V2 as data source in VCOM

Prerequisites

  • User group technical customer or higher

Steps

  1. At system level , go to  icon-wrench1.png System settings > icon-database-insert.png Data sources > Overview.

  2. Select + New data source. A window appears.

  3. Select Other data source.

  4. Select Import Interface V2.

  5. Select Next.

  6. Under Data logger name, enter a name of your choice containing your device’s manufacturer. Some individual names are already reserved in the portal and you can only use them in combination with an addition. For example, you can not use "sunspec", but you can use "sunspec logger".

Reserved individual names
  • abb

  • ae-sitelink

  • also-energy

  • archimede

  • aril

  • arteche

  • beckhoff

  • capfile

  • chint

  • contec

  • delos

  • diehl

  • edas

  • emacs

  • enedis

  • enerbird

  • field-logic

  • fronius

  • fudura

  • gantner

  • generic-csv

  • goodwe

  • growatt

  • huawei

  • i-less

  • inaccess

  • ip-gateway

  • joulz

  • kaco

  • kaco-xp100

  • kenter

  • kippzonen

  • kostal

  • laplace

  • lti

  • mako365

  • meteocontrol

  • meteocontrol-weblog

  • mscons

  • obvius

  • pronomic

  • raptech

  • renesys

  • seegma

  • seinon

  • sigenergy

  • skytron

  • sma

  • sol-connect

  • solar-md

  • solar-monitor

  • solaredge

  • solargis

  • solarlog

  • solarmax

  • solis-cloud

  • solon

  • streem

  • sungrow

  • sunspec

  • sunways

  • suryalog

  • tmeic

  • tricera

  • uribe-solar

  • wattline

  • webdyn

  • zebotec

  1. Enter the Hardware serial number of your device. This is also included in the import files and you must enter it here to uniquely assign the files to your system.

  2. Under Data transfer via, select how the data should be transferred:

    • FTP (or SFTP).

    • Or HTTP.

  3. Under Measuring interval, select how often the data is actually measured. It is often 300 sec/5 min. If your device supports 1-minute-values, then select the interval to which the data should be aggregated after the storage period for minute values expires. See also Data resolutions and storage periods.

  4. Tick the check box 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.

  5. Select Register new data logger.

  6. Depending on the data transfer method you have selected, additional fields appear:

    • FTP transfer: Your access credentials are automatically generated and displayed together with the server address under FTP access data. Use the credentials to send your data to the server.

    • HTTP transfer: The Server (XML) and Server (CSV) addresses are displayed. Select the server that matches the format of your data. Use the API key provided by Sales to authenticate data transfers.

  7. Select Save settings.

Your system is now registered as data source in VCOM. Once it is configured with meteocontrol's import specification and the previously provided access data, it can automatically transfer data to VCOM.

Third-party manufacturers using Import interface V2

The table below lists examples of third-party manufacturers that support Import Interface V2. Please note that this is not a complete list.

Caution

meteocontrol cannot guarantee that third-party manufacturers maintain up-to-date import configurations. For setup details and any other questions, contact the manufacturer directly.

Manufacturer

Function

Import data

Protocol

Further information

DeXcon


PPC

check mark Meter/power analyzer

check mark PPC

FTP Push

Data format: XML

https://www.dexcon.tech/

Elum

PPC

check mark Inverter

check mark Meter/power analyzer

check mark Weather sensors

check mark Battery

FTP Push

Data format: XML

https://elum-energy.com/energy-monitoring-software

IntegraSUN

Data logger

check mark PPC

FTP Push

Data format: XML

IntegraSUN – ServiceZeit

Plexlog

Data logger

check mark Inverter

check mark Meter/power analyzer

check mark Weather sensors

FTP Push

Data format: XML

https://www.plexlog.de/web/

SmartDog

Data logger

check mark Inverter

check mark Meter/power analyzer

check mark Weather sensors

FTP Push

Data format: XML

https://www.ecodata-sl.de/de/produkte/smartdog