Trusted by winning dev teams
Sync data with Holded
Unified. Reliable. Secure.
Holded is a cloud ERP and accounting platform widely used by SMEs in Spain and across the broader Spanish-speaking market. Acquired by Visma in 2021, it covers invoicing, accounting, inventory, CRM, projects, and HR, making it one of the most comprehensive business management platforms for the Spanish SME market.
Integrate Holded alongside dozens of other accounting and ERP systems through Maesn Unified API.
API Key Authentication Managed Per Tenant: No Raw Key Handling
Holded uses static API keys. Maesn handles API key management as part of its unified authentication layer. Your customers connect once through Maesn's onboarding flow and you never touch raw keys directly.
DocType Routing and Multi-Module Architecture: Abstracted Behind One API Surface
All Holded documents share a single endpoint controlled by a docType parameter, and the API is split across five separate modules with different base paths. Maesn maps Holded's document model to its common data model and routes to the correct module path automatically. No docType management or module path tracking required.
Tenant-Specific IVA Tax IDs Resolved Automatically: Spanish Tax Logic Stays Out of Your Codebase
Spanish IVA rates are not passed as plain values in Holded. They reference tenant-configured tax object IDs that must be fetched and mapped before every document creation. Maesn resolves tax IDs and numbering series per tenant during onboarding and applies them automatically in all subsequent operations.
"Adding Qonto to our existing integrations was a piece of cake with Maesn. It is a game changer for our customers with all the integration cababilites!"
Juri Preis
CEO @ Smarta
The Maesn difference
Built faster and sell more with Maesn
Stop keeping your engineers busy with building one integration after the other. Focus on your core value: Your product.
Focus on your core product
Engineering focus
Enable your sales team to have what your leads want. Launch a portfolio of integrations in days, not quarters. Accelerate your sales.
Stop losing deals due to integrations
Sales enablement
Integrations reduce churn - dramatically. Increase your customer satisfaction with end-to-end integration to all relevant systems.
Tie your customers for ever
Higher customer retention
Integrate with
Maesn API
Production
approval
Integration
App
Why companies choose Maesn
3 Reasons Why It Is Better To Integrate Holded API With Maesn
Secure & Compliant
We have a strong relationship to Holded. This ensures that the Maesn API is always up-to-date and any maintenance is covered on our end.
Common Data Model
We provide a clean, unified data model that abstracts away system-specific quirks, so teams can build reliable integrations without dealing with ERP-specific complexity or workaround-heavy implementations.
Holded Sandbox
We provide you with everything you need, so you can focus on what counts.
Holded is a cloud ERP and accounting platform built primarily for the Spanish market, used by over 80,000 SMEs across Spain and the broader Spanish-speaking market. It covers invoicing, accounting, inventory, CRM, projects, and HR. It was acquired by Visma in 2021.
The main challenges are managing static API keys per tenant without OAuth, routing document requests through the correct docType parameter, navigating five separate module APIs with different base paths, resolving tenant-specific IVA tax IDs and numbering series before creating documents, and handling plan and role constraints. The API is only available on paid plans and requires Owner or Administrator access.
All sales and purchase documents in Holded share a single /documents/{docType} endpoint. The docType parameter determines which document type is created or retrieved. Using the wrong value creates the wrong document type without returning an error.
Spain's IVA system has four rates: 21% standard, 10% reduced, 4% super-reduced, and 0% for exports and intra-EU B2B. In Holded these are not passed as plain percentage values. They reference tenant-configured tax object IDs that must be fetched via the taxes endpoint before creating any document. Maesn resolves these IDs per tenant automatically.
A direct Holded API integration requires managing API keys per tenant, routing through docType, navigating five module paths, resolving IVA tax IDs and numbering series per tenant, and handling plan and role constraints, all before shipping your first feature. Maesn handles all of this through a single unified API.
Maesn focuses on the financial and accounting data most relevant for integrations, including invoicing, contacts, products, payments, and accounting. Check the Maesn documentation for Holded for current endpoint coverage.
Frequently Asked Questions About Holded API Integration
