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

AI Chat Support 24/7

  • Get help via AI chat available 24/7 whenever it suits you
  • Chat extensively uses Maventa support pages, websites, and blogs in its answers
  • If you need assistance that the AI cannot provide, you can also ask a customer service agent to join the conversation
  • Support requests processed Monday to Friday
Cancel Open chat

Got feedback?

Did you not find what you were looking for? Or was something explained unclearly? Or just want to share your thoughts? We are happy to hear your feedback!

Note: This form is not a way to get support, this is only for feedback for the documentation website. If you need support, please contact Maventa support.

Integration Guide Services & Reach API Specification Changelogs Integration guide Getting Started Invoice sending Consumer Invoicing Printing Email invoicing Invoice receiving Scanning Detect Fraud reporting Webhooks Reference implementations Maventa Connector Embeddable User Interface Peppol Network Document Exchange Invoice Response Self-billing support Invoicing formats Validation Peppol BIS 3.0 Finvoice 3.0 Document types and type codes Maventa JSON (table) Maventa JSON (json schema) Companies and Settings Department Company Users Billing Accounts receivable Ropo's reminder and collection service Amili Kassavirta Amili Perintä Receivables webhooks Services and reach Maventa services and reach e-invoicing in Finland Mass Printing Service e-invoicing in Sweden e-invoicing in Norway e-invoicing in Denmark e-invoicing in the Netherlands e-invoicing in Belgium e-invoicing in Germany e-invoicing in Estonia e-invoicing in Latvia e-invoicing in Poland e-invoicing in Italy e-invoicing in France e-invoicing in Spain Api specification API overview Getting Started Common & authentication API Invoices API Documents API Companies & settings API Lookups API Detect API Validator API Receivables API Billing API Scanning API B2CFI API B2CNO API B2CSE API Partner API Getting Started Account Configuration API Methods Invoice Sending API Methods Invoice Receiving API Methods B2C Norway API Methods B2C Finland API Methods Other API Methods Changelogs Product changelog Developer Changelog
Clear Send

Enter your credentials to Maventa testing environment, to authenticate and try things out with the Swagger UI. This will fetch a Bearer token using OAuth2 with the endpoint POST https://ax-stage.maventa.com/oauth2/token. The token is stored in your browser's session storage (cleared when you close the tab) and used in Swagger calls done from this documentation website. The token is valid for 1 hour.

Never use your production credentials here. This is only for testing the Maventa test environment in the Swagger UI.
Reset All None
eui global company lookup document:receive document:send invoice:receive invoice:send company:read company:write validate receivables:assignments analysis billing:reports partner:invoice_delivery_actions partner:lookups partner:takeovers partner:lyanthe_scan_service fi_bank_message:send fi_bank_message:receive
Cancel Sign In