Integration Guide
Welcome to Maventa integration guide!
This guide will tell you how to connect your financial system to Maventa e-invoicing and document exchange service. See how to move from testing to production, what API methods to use for different functionality, as well as get useful tips and information about how the integration works.
Maventa offers electronic invoicing and document transfer services for companies and public organizations.
The service can be thought of as an electronic postal office that acts as a connector between suppliers and buyers and their systems. In addition to electronic business document delivery, Maventa supports a variety of value added services for invoicing and related financial processes.
There are two APIs that can be used for connecting to Maventa, REST and SOAP.Both can be used, but note that all the functionality is not available over the SOAP API
- REST Maventa REST API gives access to account management and Maventa’s e-invoicing services. It is also used for other business document traffic like order document exchange. The API allows also connecting to a growing number of advanced functions and services for P2P and O2C.
- SOAP MaventaSOAP API gives access to account management and Maventa’s e-invoicing services.
What can the APIs be used for?
- Electronic invoicing B2B/B2G/G2B
- Consumer invoicing to netbank and mobile applications
- Electronic ordering and other e-document delivery
- Connection to value added services for P2P and O2C
- Custom applications and import tools
Maventa e-invoicing overview
PENDING_IMAGE_FIX
What type of integration to make
There are different ways to integrate to Maventa and the selection of offered services. The following guide will help you decide and defined what you want from your integration.
Integration scope
The integration scope impacts what Maventa services you integrate to. The scope defines what are the key functionalities and capabilities users will have in the service.
Things to consider when defining the scope:
- 
    Sending, receiving or both? Will your customers be using Maventa to send or to receive electronic documents or for both. 
- 
    B2B / B2C invoicing? Do your customers have needs for consumer invoicing. Maventa has different consumer invoicing options between the market areas, delivering to bank network or mobile application depending on country. 
- 
    Additional services? What are the services your customers want to activate? We have different services that support the invoicing flow, such as printing and scan service as well as help to bring customers added value such as Receivables Management and Supplier Activation. See Services & Networks part in Integration guide for more information. 
Integrators can either use the REST API or the legacy SOAP API. Going forward, only the REST API will expose new features and improvements.
Integration level
In terms of development effort, integrating with Maventa can range from using just a few API endpoints to a fully fledged out and complex solution. The higher the integration level, the more feature rich your solution will be while at the same time requiring more development effort to achieve (for example will the users access Maventa UI or will all actions take place within your ERP system).
Basic value • Minimal automation
- Sending invoices
- Receiving invoices
- Companies & Settings
- Monitoring invoices
- Handling errors
Suitable for quick start. Mix of API + UI + Email.
High value • More automation
- Sending invoices
- Receiving invoices
- Companies & Settings
- Monitoring invoices
- Handling errors
More automation than Level 1, but still partly dependent on Web UI.
Maximum value • Full automation
- Sending invoices
- Receiving invoices
- Handling errors
- Companies & Settings
- Monitoring invoices
Full automation. Everything handled via API. No UI or Email.
The level should be chosen based on the integrators needs and the amount of automation required. It is also good to note that you can start from a level and continue to deepen the integration over time.
Quick guide to e-invoicing
Interested to know more about electronic invoicing? Here’s our quick guide to the basics of electronic invoicing and document exchange.
FIX_LINK_PENDING