Getting Started
This guide shows how Maventa enables seamless e-invoicing and document exchange through your financial system. It explains the available APIs, key capabilities, and market-specific requirements, helping you understand what is needed to start sending invoices, support consumer invoicing, or serve customers across different countries, whatever your business needs across e-invoicing and digital document exchange.
The Maventa APIs support a wide range of business use cases, including electronic invoicing for business-to-business (B2B), business-to-government (B2G) scenarios, consumer invoicing to bank networks and mobile applications, electronic ordering and other business document exchange, access to value-added services supporting purchase-to-pay and order-to-cash processes, as well as custom applications and import tools. Availability of specific features may vary depending on the country or market, so not all functionality is supported in every region.
Maventa provides two APIs for integration: REST and SOAP. Both can be used, but not all functionality is available via the SOAP API. Going forward, new features and improvements will be delivered exclusively through the REST API.
-
The REST API provides access to account management and e-invoicing services, as well as other business document flows such as order exchange. It also enables integration with advanced services supporting P2P and O2C processes.
-
The SOAP API provides access to account management and e-invoicing services, but is considered legacy and does not support all available features.
There are multiple ways to integrate with Maventa, depending on the services you want to offer and the level of automation you require. The following sections help you define the scope and depth of your integration.
The integration scope defines which Maventa services you connect to and what functionality your users will have. When defining the scope, consider whether you need to support sending invoices and documents, receiving invoices and documents, or all. You should also determine whether your customers require B2B, B2G, or B2C invoicing, as consumer invoicing options vary by market and delivery channel.
In addition, consider which optional services your customers may need. Maventa offers services such as printing, scanning, receivables management, and supplier activation to support and enhance the invoicing flow.
The development effort required for a Maventa integration can range from using a small set of API endpoints to building a fully automated, end-to-end solution. Higher integration levels provide richer functionality but require more development work. For example, you can choose whether users interact with the Maventa UI or whether all actions are handled entirely within your ERP system.
The appropriate integration level depends on your automation needs. It is also possible to start with a simpler integration and extend it over time.
Integrating with Maventa typically involves setting up the connection, validating it in the testing environment, and enabling it in production. Before accessing the production environment, all integrators must complete and sign the Maventa Integration Agreement, which defines key aspects such as billing and support. This agreement is provided by your integration contact.
Instructions for obtaining API keys for testing and production are described below.
Contact us before you start building
Before you start building the integration, we recommend reaching out to our sales team. They will introduce you to the service, assess your business needs, and connect you with our integration care team. Our integration care team will then provide all the necessary technical support to help you build and refine your integration. Depending on your needs, we may also arrange an integration kick-off meeting or additional training to ensure a successful implementation.
To use Maventa APIs, you need access to API keys, which requires a partner company account in our testing environment. To obtain a partner company account, contact our integration care team at integrations@maventa.com.
Once you become a partner, you will receive credentials for our testing environment:
-
client_id– Identifies the company (in this case your partner company account) (Company UUID). -
client_secret– Identifies the user of that company (User API key). -
vendor_api_key– Identifies your software (Vendor API key).
The Vendor API key is available in Maventa UI under Settings > Company settings > Software API keys. The User API key and Company UUID can be found in the Settings section.
Once you have these credentials, you can start making API calls to Maventa and building the integration.
Question: What is a vendor?
In Maventa, a vendor refers to the software that is integrated with the service. A partner account can have one or more vendors, each represented by a software API key (vendor API key). This key is used to authenticate the software when connecting to Maventa via the API.
- The vendor API key uniquely identifies the software connecting to Maventa.
- A single partner account can manage multiple vendor API keys — for example, to support different software products or operations in different countries.
- All vendor API keys are managed under the same partner account, which is the entity that owns and oversees these integrations.
Before moving to the production environment, the integration must be thoroughly tested in the Maventa testing environment. This includes verifying that the core integration flows work as expected: invoices are routed to the correct destinations with accurate data, sending via the Peppol network functions correctly for applicable countries, consumer invoicing is properly configured when in use, received invoices are downloaded in the correct format, webhooks are delivered and processed successfully, and polling intervals are set to reasonable values and so on.
In addition, all integrators are required to complete and sign the Maventa Integration Agreement, which defines key topics such as billing, responsibilities, and support. The agreement will be provided by your integration contact person, either from sales or integration care.
Production API keys can be obtained by following the same process as in the testing environment.
Note that the testing and production endpoints of the API use different API keys. API keys from testing will not work on production and vice versa. Errors like USER NOT FOUND mean that the user_api_key is wrong for that environment. Please, make sure you are using the correct API endpoint for your API key.
The Maventa testing environment allows you to simulate most invoice sending and document exchange processes before moving to production. However, the behavior depends on the route:
- Internal sends between Maventa customers function the same as in production.
- Peppol sends are processed as real transactions within the Peppol test network.
- External operator routes in Finland and Sweden
- Consumer routes
- Email and print deliveries
Simulated sends are not actually delivered, they are marked as SENT in Maventa to mimic real processing.
Important Notes
- All notification emails related to account management and error handling are sent to the actual recipients. Only use email addresses you have access to, avoid using addresses like
test@test.comor your customers’ real addresses. - If you need to test sending invoices via email to a real recipient, please contact support.maventa@visma.com to enable this for your account.
- The testing environment is also used for internal testing, so it may differ from production. It can be temporarily unavailable, and the database may be cleared without notice. For privacy reasons, do not use real production data in the testing environment.
The Maventa UI is a web-based user portal designed to complement API integrations by offering a visual interface for managing e-invoicing operations and supporting technical integration work. While most functionality available in the UI is also accessible through the API, the UI provides a convenient and user-friendly way to view, manage, and troubleshoot integration-related tasks.
Through the Maventa UI, users can:
- Configure settings
- Access invoice and delivery logs
- Handle manual actions such as rerouting invoices in an error state
- Retrieve and manage API credentials including company UUID, user API key, and vendor API key
Logging in to the Maventa UI requires an email-based user account.