Search

Maventa Connector

Maventa Connector is a Windows service application that moves electronic documents between Maventa service and local folders on your computer or server. It is typically used to integrate Maventa with ERP systems that do not have direct Maventa integration available.

We do not recommend using Maventa Connector for new integrations. Instead, please consider using Maventa API directly.

Versions

Latest version

Latest release 2026-08-14 version number: 2.1.9713.28334

Download the installer from: MaventaConnectorInstaller_2.1.97.msi

Connector version 2.1+ requires .NET Framework 4.8.1, which in turn requires Windows 10 (version 21H2 or later), Windows 11, or Windows Server 2022 or later. Connector versions 2.0.x require .NET Framework 4.6.1.

What’s new in 2.1

Version 2.1 focuses on security hardening in line with the EU Cyber Resilience Act (CRA).

Upgrading to 2.1

Check your Windows version first. .NET Framework 4.8.1 cannot be installed on older systems such as Windows 8.1, Windows Server 2016 or Windows Server 2019, and Connector 2.1 will not run on them. Those machines need to be updated to a supported Windows version before upgrading. If .NET Framework 4.8.1 is not already present, install it before running the Connector installer.

  1. Run the installer as administrator. It changes the service account and sets file and service permissions, which requires elevation.
  2. Complete the one-time administrator step. When upgrading an existing installation, the first time you open the Connector after the update it detects that the service still runs under the old account and asks: “This update needs to finish configuring the Maventa Connector background service (a one-time administrator step). Complete it now?” Answer Yes and accept the UAC prompt. This happens only once.
  3. Check access rights on network folders. Because the service now runs as NetworkService instead of LocalSystem, the OUT, IN and BACKUP folders must allow access for that account. The upgrade grants this automatically for folders you own. For folders on a file server or owned by someone else, your administrator may need to grant NetworkService — or the computer account — read and write access. A missing grant typically shows up as an “IN directory does not exist” message in the log for a folder that clearly does exist.

If you decline the one-time prompt, or if the person using the Connector is not an administrator, run the following from the Connector install folder in an administrator command prompt:

Until that is done, the Connector cannot save its settings and invoice transfer will not resume.

Existing settings are migrated automatically on first start, and no re-login is required. Two things to be aware of after upgrading:

Old versions

We do not recommend using old versions of Maventa Connector. For special cases we keep some old versions available. Please contact our support for more information.

Notes for users of Connector version 1.2

Connector version 2.0+ has a new installer (MSI) and might not be able to automatically update. Please stop any running MaventaService and uninstall the old Connector version before attempting to install the new version. Your settings and log entries should be restored automatically.

Security

Connector’s security depends 100% on the OS security and folder privileges that it is running on. Connector client program moves documents between a folder and Maventa API using HTTPS same as all other ERP traffic. As the client program only makes API calls and copies files between API and folder and is triggered from the OS side there are no additional security aspects to consider as there are no incoming ports the software listens to.

From version 2.1 onwards, API keys are no longer stored in plain text: they are encrypted with Windows data protection and bound to the machine, so a copied configuration file cannot be read on another computer. The background service also runs as NetworkService rather than LocalSystem, and the client application runs as a normal user. The configuration folder should still be protected with OS folder permissions, and version 2.1 runs on .NET Framework 4.8.1, which is a currently supported and security-maintained runtime.

Versions 2.0.x and older store API keys in plain text in config.xml, run the service as LocalSystem, and are built on .NET Framework 4.6.1, which no longer receives its own security updates. Any local user with access to the configuration folder can read those keys. This should be taken into consideration when deciding whether to keep running an older version.

FAQ

Question: Installer stops with error like “service already exists”, what to do?

The old Connector service called “MaventaService” already exists and needs to be removed manually. Follow these steps:

  1. Run (as as admin) the command “services.msc” or browse to the Windows Services Management. See if “Maventa Connector Service” is listed. If it’s running, stop it.
  2. Open an admin command prompt and run the command: sc DELETE MaventaService
  3. Reboot computer might be a good idea here
  4. Launch new Connector installer which should now be able to pass

Question: Which operating systems are supported?

Connector 2.1 requires .NET Framework 4.8.1, which limits the supported operating systems to:

  • Windows 10, version 21H2 or later
  • Windows 11
  • Windows Server 2022 or later

Older operating systems — including Windows 7, Windows 8.1, Windows Server 2012 R2, Windows Server 2016 and Windows Server 2019 — cannot install .NET Framework 4.8.1 and therefore cannot run Connector 2.1. Update Windows to a supported version before upgrading the Connector. If that is not possible right away, contact our support about staying on an older Connector version in the meantime.

In any case, you should not be using an operating system that is no longer supported by Microsoft and expect it to keep working properly forever. For security reasons, always use a supported operating system that still receives security updates from Microsoft.

Help

In case of issues with installing or running the Connector, find help at Maventa Connector at Maventa Knowledge Base

There you can also contact customer support in case you need more help.

Back to top