Overview Legend 🧭
Overview Legend 🧭
Introduction
Holded is a cloud accounting and invoicing platform for small and medium-sized businesses in Spain. It covers bookkeeping, invoicing, and financial reporting for one company per account.Activate Holded
Partner keys
No partner keys and no approval: the connector is ready to use.Activate Holded in your Chift account
One click in Connectors, then create connections straight away.
Connector settings
No connector-specific settings.Test Holded
Vendor fees
No vendor fees, for you or your end users.
Connect Holded
Holded setup guide for end users
The full step-by-step, with screenshots.
- an active paid Holded subscription (Plus, Basic, Standard, Advanced or Premium)
- an API key, generated from Settings > Developers > Credentials in Holded
- name the connection
- enter their Holded API key
- confirm the connection
Rate limits
Holded applies two limits at the same time, per Holded account: a burst limit per minute and a monthly quota. All API keys on the same account share the same counters, so creating more keys does not raise the budget.
When a limit is exceeded, Holded returns an HTTP 429 Too Many Requests error with the
Retry-After and X-RateLimit-Window headers. The X-RateLimit-Window header is minute or month.
Chift automatically manages these limits to optimize performance and prevent interruptions. However, once the API rate limit is reached, Chift cannot bypass these limitations.
Chift’s retry with exponential backoff absorbs the per-minute limit, but not an exhausted monthly quota. An exhausted monthly quota blocks calls until it resets or the end user upgrades their plan.
See Holded’s rate limits page.
Limitations & specificities
Attachments
Attachments
Attachments can only be retrieved for invoices.
Journal entries
Journal entries
Rules on journals and journal entries:
- Holded only has journals for customer invoices, customer refunds, supplier invoices and supplier refunds.
- Creating a journal of any other type is rejected.
- An invoice can only be posted to a journal of its own type.
- Journal entry lines can only target a general ledger account, a customer or a supplier.
Chart of accounts & VAT
Chart of accounts & VAT
When you create a ledger account, or a client or supplier with a new account number, Holded keeps only the first 4 digits of the number you send. It uses them as a prefix, then assigns and returns the full account number. The prefix must exist in the company’s chart of accounts, or the request is rejected.Account balances can only be retrieved for a period of one year or less. Without a start date, Chift takes the 12 months preceding the end date.