API overview
Maventa offers two APIs for integrating e-invoicing and document exchange: a modern REST API and a legacy SOAP API.
We highly recommend using the REST API for all new integrations. It and provides a more straightforward developer experience and better performance. The REST API gives you full access to Maventa’s capabilities with clear, well-documented endpoints.
New functionality is mainly added to the REST API. The SOAP API remains available for existing integrations, but we encourage migrating to REST when possible. If you’re starting fresh, REST is the way to go.
Looking for code examples? Maventa provides reference implementations for Java and C# to help you get started with the REST API.
Service availability
Maventa is built to run without interruptions, and most updates and maintenance are carried out in the background without affecting the service.
Invoices are usually processed within minutes. At the turn of the month and during other high-traffic periods, queues can be longer and delivery may take up to a few hours. See delivery times for details.
Temporary problems on the receiving side, such as another Peppol Access Point being down, do not fail your invoice straight away. Maventa retries automatically, investigates unexpected cases, and contacts the receiving Access Point when needed. An invoice is marked as failed only when delivery cannot succeed, with an error message that explains why. See when delivery does not succeed immediately.
Maventa’s monitoring and alerting cover all invoices in processing, so invoices do not get lost or stuck without notice. Cases that need manual investigation may take longer to deliver.
Maintenance and service status
Service breaks for maintenance are rare. When one is needed, it is announced well in advance:
- on status.visma.com under Common Services (Maventa / Visma .net AutoInvoice)
- on the Maventa announcements page
- on this documentation site
- by email to customers for larger maintenance breaks
Maintenance is scheduled at night and never at the turn of the month, when invoice volumes are highest.
Current incidents and their progress are also published on status.visma.com. If your integration receives 503 service_unavailable responses, retry with exponential backoff.
IP addresses and firewalls
We do not recommend IP address based firewall rules for Maventa’s services. Maventa’s IP addresses can change, and we do not commit to keeping them unchanged or to announcing changes in advance. Rules based on IP addresses may therefore stop working without notice.
If your environment requires an IP allowlist, contact Maventa support before setting one up.