API de Holded: qué se puede integrar y cómo hacerlo

La API de Holded es la puerta de entrada programática a tu cuenta de Holded: permite que otras aplicaciones lean y escriban datos de tu empresa (clientes, facturas, presupuestos, productos, cobros, oportunidades o asientos contables) sin que nadie tenga que copiarlos a mano. Sirve para conectar Holded con tu web, tu tienda online, tu CRM o una aplicación a medida.

Holded es un software de gestión en la nube muy extendido entre pymes españolas. Empezó como programa de facturación y hoy cubre también contabilidad, tesorería, inventario, proyectos, CRM y equipo, por lo que muchas empresas lo usan como su ERP. Que tenga una API completa es una de sus grandes ventajas: tus datos no se quedan encerrados dentro del programa.

En Devyond hemos integrado Holded en varios proyectos y nuestra experiencia es muy buena. Casi todo lo que ves en la interfaz está también disponible en la API, así que puedes sacar tus datos para hacer informes de tesorería, automatizar la facturación desde tu aplicación o sincronizar clientes con otras herramientas.

La documentación oficial para desarrolladores de Holded organiza la API por áreas del programa. A grandes rasgos, encontrarás recursos para:

Facturación y ventas: facturas, presupuestos, pedidos, albaranes, recibos y sus pagos. Es lo que más se integra, porque permite emitir facturas desde tu propia aplicación o tienda y que queden registradas en Holded.

Contactos: clientes y proveedores, con sus datos fiscales y de contacto. Es la base de casi cualquier integración, porque un cliente tiene que existir en Holded antes de facturarle.

Productos e inventario: catálogo, precios y existencias, útil para sincronizar una tienda online con el stock real.

Contabilidad y tesorería: cuentas, asientos y movimientos, que permiten construir informes financieros fuera de Holded.

CRM y proyectos: embudos, oportunidades, proyectos y tareas, para quien gestiona también la parte comercial u operativa en Holded.

Equipo: empleados y fichajes, en los planes que incluyen la parte de recursos humanos.

Si tu equipo copia datos entre Holded y otra herramienta, si emites facturas a partir de pedidos o cobros que ocurren en tu web, o si quieres un panel con información financiera al día, la API de Holded es la forma correcta de resolverlo. Antes de empezar, revisa qué plan tienes, porque los límites de uso dependen de él.

Para usar la API necesitas una clave (API key) que se genera desde la propia cuenta de Holded, en la configuración, dentro del apartado de desarrolladores. Esa clave identifica a tu empresa y da acceso a sus datos, así que hay que tratarla como una contraseña: guardarla en el servidor, nunca en el navegador, y crear claves distintas para cada integración si es posible.

En 2026 Holded lanzó la versión 2 de su API, que es la recomendada para cualquier desarrollo nuevo. Usa autenticación con token Bearer, una URL base unificada y más cobertura que la versión anterior. La versión 1 sigue funcionando para integraciones existentes, pero está marcada como obsoleta, así que conviene planificar la migración.

La API tiene dos límites: uno de peticiones por minuto, para evitar picos, y una cuota mensual de llamadas. Ambos dependen del plan contratado, y la diferencia entre los planes básicos y los superiores es grande. Si tu integración mueve muchos documentos al mes, revisa la cuota de tu plan en la documentación oficial antes de diseñarla: puede ser el factor que decida si sincronizar en tiempo real o por lotes.

La versión 2 incorpora webhooks: Holded avisa a tu aplicación cuando se crea, modifica o elimina un contacto, una factura o un pago. Esto permite reaccionar al momento, por ejemplo actualizar el estado de un pedido cuando se cobra la factura, sin tener que consultar la API cada pocos minutos. Cada aviso va firmado para que puedas comprobar que viene de Holded.

Cuando una integración supera los límites, la API responde con un error de demasiadas peticiones e indica cuánto esperar. Una integración bien hecha gestiona esos casos, reintenta y deja registro de lo que ha fallado.

La clave da acceso a datos fiscales y financieros. Guarda las claves cifradas, limita quién puede verlas, revócalas cuando dejes de usar una integración y registra qué hace cada proceso. Son buenas prácticas básicas que evitan sustos.

Estos son los casos de integración más habituales que vemos en pymes:

Facturar desde tu aplicación o tu tienda. Cuando se completa un pedido o un cobro en tu web, se crea automáticamente el cliente (si no existe) y la factura en Holded. Nadie vuelve a teclear una factura.

Sincronizar clientes con tu CRM. Los clientes que se ganan en el CRM pasan a Holded con sus datos fiscales, y la información de facturación vuelve al CRM para que el equipo comercial vea qué ha comprado cada cliente.

Informes de tesorería y cuadros de mando. Extraer facturas, cobros y gastos para construir un panel con previsión de caja, cobros pendientes o rentabilidad por cliente o proyecto, combinando datos de Holded con los de otras herramientas.

Holded indica que sus facturas cumplen con Verifactu, el nuevo sistema de facturación de la Agencia Tributaria. Por eso, una opción habitual para empresas cuya web o aplicación emite facturas por su cuenta es dejar de generarlas ahí y crearlas en Holded a través de la API. Así la factura legal la emite un software preparado y tu aplicación solo envía los datos.

También es frecuente integrar Holded con la pasarela de pago (por ejemplo, Stripe o el TPV del banco) para que los cobros queden conciliados con sus facturas.

Antes de programar nada, define qué sistema manda en cada dato: dónde se da de alta un cliente, dónde se emite la factura y en qué dirección viaja cada cambio. Esa decisión evita duplicados y es la base de cualquier integración que funcione bien a largo plazo.

Hay dos formas de conectar Holded con otras herramientas. La primera es usar una integración ya hecha: Holded tiene un catálogo de integraciones nativas y existen conectores en plataformas de automatización. Son rápidas de activar y suficientes para casos sencillos.

La segunda es una integración a medida con la API, programada para tu caso. Tiene sentido cuando hay reglas propias (cómo se numeran las series, qué impuestos aplican, qué pasa con los abonos), muchos documentos al mes, varias herramientas implicadas o procesos críticos en los que un error cuesta dinero.

En nuestro servicio de integración de ERP y sistemas conectamos Holded con webs, tiendas, CRM y aplicaciones a medida con código propio. Empezamos por un mapa de datos (qué se sincroniza, en qué dirección y con qué frecuencia), usamos webhooks cuando el proceso lo pide y cargas por lotes cuando no, y dejamos un panel donde ver cada sincronización y sus errores.

Así sabes en todo momento qué ha pasado y no dependes de nadie para detectar que una factura no se ha creado.

Si quieres conectar Holded con tu web, tu CRM o tu aplicación, cuéntanos qué herramientas usas y qué datos copias hoy a mano. Te diremos si basta con un conector o si compensa una integración a medida.

La API de Holded permite leer y escribir casi todo lo que ves en el programa: facturas, contactos, productos, contabilidad, CRM y proyectos. Su versión 2 añade webhooks para reaccionar al momento, y los límites de uso dependen del plan que tengas contratado.

Antes de integrar, define qué sistema manda en cada dato y elige entre un conector ya hecho o una integración a medida según la complejidad de tu caso.

Si quieres que tus facturas, clientes y cobros dejen de copiarse a mano, en Devyond conectamos Holded con tu web, tu tienda, tu CRM o tu aplicación con un mapa de datos claro y un panel para ver cada sincronización.

Si quieres que tus facturas, clientes y cobros dejen de copiarse a mano, te ayudamos a integrar Holded con el resto de tus herramientas.