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).
- Now built on .NET Framework 4.8.1 (previously 4.6.1). This puts the Connector on a currently supported and security-maintained runtime, but it also raises the operating system requirement — see Upgrading to 2.1.
-
Client secrets are encrypted at rest. User API keys are no longer stored in plain text in
config.xml. They are encrypted with Windows data protection and bound to the machine. -
Least-privilege operation. The background service now runs as
NetworkServiceinstead ofLocalSystem, and the client application runs as a normal user — so opening the Connector no longer triggers a UAC prompt every time. Starting and stopping the service from the user interface keeps working.
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.
- Run the installer as administrator. It changes the service account and sets file and service permissions, which requires elevation.
- 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.
-
Check access rights on network folders. Because the service now runs as
NetworkServiceinstead ofLocalSystem, 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 grantNetworkService— 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:
-
Configuration files are no longer portable between machines. Because the API keys are encrypted and machine-bound, copying
config.xmlto another computer does not work. - The invoices-sent counter (
stats.xml) has been removed.
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:
- 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.
- Open an admin command prompt and run the command:
sc DELETE MaventaService - Reboot computer might be a good idea here
- 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.