Skip to content
APFerrer
M-HOL-01 · ModuleFinance and invoicing

Holded integration: invoices, credit memos, payments and a signed webhook

A two-way connector with Holded: it issues invoices from your application and receives credit memos, payments and status changes without duplicates.

Source codeEmbeddableOEM

Many industry applications issue their invoices in Holded and then need to know what happens there: credit memos, refunds and payments. This Holded API integration handles both directions. It issues invoices from your application and brings back the changes made in Holded, without duplicates.

Who it is for

Vertical software companies whose customers invoice with Holded, Holded integrators and companies with their own application. Holded is mostly used in Spain, and the module maps Spanish taxes.

What a Holded API integration solves

  • Invoices typed in twice. The invoice is created in Holded with the data from your application.
  • Totals that do not match. Before the invoice is approved, the module checks that the Holded total matches yours.
  • Invoices left half-issued. If something fails, it retries and continues where it stopped.
  • Changes that never come back. Credit memos and payments recorded in Holded flow back to your application.

What it does

  • Connects each account with its API key, which is stored encrypted, checks the permissions and registers Holded's notifications.
  • Issues invoices in steps that can be repeated without creating duplicates: it finds or creates the contact by tax ID (NIF), creates the draft with the taxes for each line, compares totals and approves it. The number and the PDF are Holded's.
  • Maps Spanish taxes to the ones set up in the customer's account: VAT, IGIC, IPSI, exempt and not subject to tax.
  • Receives Holded's notifications, checks their signature, discards repeats and replies straight away.
  • Brings in credit memos created in Holded, spreading the amount across the invoiced orders, and syncs payments, statuses and due dates.
  • Periodically checks for anything that did not arrive by notification.
  • Retries when Holded throttles requests or does not respond, and includes a simulated mode for development.

Benefits

  • Your application shows the same payment status as Holded.
  • You do not create duplicate invoices, even if the connection fails.

Industry context

General industry data with its public source. These are not results of this product.

  • In Spain, invoicing software has to comply with the VERI*FACTU regulation by January 1, 2027 for Corporate Income Tax (Impuesto sobre Sociedades) taxpayers and by July 1, 2027 for everyone else who is required to comply. Source: BOE (Spain's official gazette), "Royal Decree 1007/2023 of December 5", fourth final provision, consolidated text of December 2025.

What you get with each license

Price upon request, depending on license type and scope. Integration support and maintenance are contracted separately.

  • The module code, with documentation to adapt it to your invoice and order model.
  • Integration examples and the simulated mode.
  • A warranty against defects for the agreed period.

Technical specifications

Language and runtime: TypeScript 5.9 on Node.js. Minimum supported version: Node.js 20.9 (the one declared by Next.js 16).

Frameworks: Next.js 16.4. Data access with Prisma 7.8.

Database: PostgreSQL.

Operating systems: Server with Node.js.

Interface languages: Spanish.

Required infrastructure:

  • PostgreSQL.
  • Publication at an HTTPS address to receive Holded's notifications.
  • A scheduler for periodic tasks (cron) to run the status reconciliation.
  • Holded, with an API key for each account (requires your own account).

Private deployment: It runs on your infrastructure, but it needs a connection to the Holded API, which is what the module integrates with.

Main libraries:

Library Version License
next 16.4.2 MIT
@prisma/client 7.8.0 Apache-2.0
@prisma/adapter-pg 7.8.0 Apache-2.0
pg 8.21.0 MIT
zod 3.25.76 MIT

Dependencies with specific license terms:

  • @img/sharp-libvips-* 1.3 (libvips binaries, an optional dependency of Next.js): LGPL-3.0-or-later; @img/sharp-win32-* and @img/sharp-wasm32 0.35: Apache-2.0 AND LGPL-3.0-or-later.

Compatibility and integrations: Holded API v2 and Holded webhooks for invoices, credit memos and payments.

Redistribution terms

The asset's own code can be integrated into the licensee's commercial products under the embeddable module, source code and OEM licenses, on the terms of the contract. The libvips binaries that Next.js installs as an optional dependency (LGPL-3.0-or-later) have specific terms; see the list under Technical specifications.

Installation requirements

A Node.js application with PostgreSQL, published over HTTPS to receive Holded's notifications, and a periodic reconciliation task. Each customer needs its own Holded account with an API key.

FAQ

Frequently asked questions

  • What permissions does the Holded key need?

    Read access to contacts, numbering series, services and taxes, permission to register notifications and write access to invoices. Read and notification permissions are checked when the account is connected; write access is confirmed with the first invoice issued.

  • Does it comply with VERI\*FACTU?

    The module does not number or record invoices on its own: Holded creates, numbers and approves the invoice. VERI\*FACTU compliance is the responsibility of the program that issues the invoice. Confirm it with Holded and with your advisor.

  • Does it support IGIC?

    Yes, as well as VAT and IPSI, matched to the taxes configured in the account.

  • Is maintenance included?

    No. If Holded changes its API, adapting the module is part of maintenance, which is contracted separately, like support.

Request

Request information on M-HOL-01

Fill in the form with the asset reference and the license type you're considering. I reply in writing. If you need to review code, tick the NDA box and we'll sign one before anything is shared.

Controller: APFerrer. Purpose: to answer your request. You can exercise your rights as described in the privacy policy.

Price upon request, depending on license type and scope. Maintenance and support are contracted separately.