La API de Holded: qué se puede conectar y qué no

Holded tiene API, y eso aparece en cualquier comparativa de ERP como una casilla marcada. La pregunta es qué se puede conectar y cuánto trabajo hay detrás de cada cosa.

Somos Solution Partner de Holded y montamos estas conexiones. Los datos técnicos están consultados el 16 de septiembre de 2026 en la documentación oficial.

Qué es la API de Holded

Es una API REST sobre JSON, en su versión 2, con base en https://api.holded.com/api/v2/. Te autenticas con un token Bearer que se crea desde Ajustes, en la sección de Desarrolladores, eligiendo permisos módulo a módulo: lectura, escritura o acceso total.

Ese último detalle importa más de lo que parece. La clave no hereda el rol del usuario que la genera. Un token con acceso total a contabilidad lo tiene aunque lo cree alguien que en pantalla no puede abrir esa sección. Al repartir claves conviene crear una por integración y darle lo mínimo, para que el día que haya que revocar una no se caiga todo lo demás.

Está disponible en todos los planes de pago y en el periodo de prueba. El plan Free no la incluye.

La superficie es amplia, más de trescientos endpoints repartidos en once áreas:

En la práctica, casi todo lo que se hace a mano en la pantalla se puede hacer desde otro sistema.

Las cuatro formas de conectar Holded a otro sistema

Aquí es donde se decide el presupuesto, y mucha gente se salta el paso. Antes de encargar desarrollo hay tres opciones más baratas, y a veces una de ellas basta.

El conector del catálogo es la primera parada. Holded mantiene integraciones con las plataformas de comercio y cobro más comunes, y si la tuya está ahí y cubre tu caso, se configura y se acabó. No hay nada que mantener, y ese ahorro es real: cada pieza propia que añades es una pieza que se rompe cuando la otra parte cambia algo.

Las herramientas de automatización son el escalón siguiente. Zapier, Make y n8n hablan con la API de Holded sin que escribas código, y valen para la mayoría de flujos de una pyme: dar de alta en el CRM al cliente que aparece en Holded, avisar por Slack de una factura vencida, crear un pedido de compra cuando el stock baja. Nosotros trabajamos con n8n y las diferencias entre las tres están en esta comparativa. Lo hicimos así en la integración de HubSpot con Holded, donde el alta de un cliente en los dos sistemas pasó de diez minutos a cero.

La API directa entra cuando hay lógica de negocio que no cabe en un flujo lineal, cuando el volumen hace inviable pagar por operación, o cuando otro sistema tuyo necesita crear documentos dentro del ERP. Es el caso del software de gestión para una cadena de tiendas de descanso: el ticket se imprime en tienda y a la vez se crea la factura en Holded, con las reglas de la cadena y no con las de un conector genérico.

El servidor MCP es lo más reciente. Sirve para que Claude o ChatGPT consulten tus datos de Holded en una conversación, con el perfil de solo lectura por defecto. Cubre bien la consulta puntual: cuánto se facturó el mes pasado, qué pedidos siguen sin servir, qué clientes deben dinero. Para algo que corre todos los días hace falta un flujo, porque el asistente solo actúa cuando alguien le pregunta. Lo contamos con más detalle en la guía de VeriFactu con Holded.

Qué se conecta de verdad, área por área

Ventas y facturación. Es el área más completa, y también la que tiene la regla especial. Un documento se puede crear en borrador o crear y aprobar de una vez, con el parámetro approveDoc. Con VeriFactu activo, aprobar significa remitir a la Agencia Tributaria en ese momento, y a partir de ahí los campos fiscales ya no se editan: solo queda anular o emitir una rectificativa. Volvemos a esto más abajo porque cambia cómo se diseña el flujo.

Contactos y CRM. Clientes, proveedores, grupos y etiquetas por un lado; embudos y oportunidades por otro. El CRM de Holded es suficiente para un equipo comercial pequeño y se queda corto cuando hay varios comerciales con su propio proceso, que es cuando aparece HubSpot o similar al lado y hay que sincronizar los dos.

Inventario. Productos, tarifas, almacenes y movimientos de stock. Es la segunda área más grande y la que más se integra con tienda online y TPV. El punto delicado es decidir quién manda sobre el stock: si la tienda y el ERP se corrigen mutuamente sin una fuente de verdad clara, acabas con dos cifras distintas y nadie sabe cuál vale.

Contabilidad y tesorería. Asientos, cuentas de gasto, pagos, impuestos, cuentas bancarias y remesas. Se lee mucho más de lo que se escribe, y así debe ser: los cuadros de mando y los informes salen de aquí, mientras que escribir asientos desde fuera es algo que conviene dejar en manos de quien lleva la contabilidad.

Proyectos y equipo. Proyectos, tareas, control de tiempo, empleados, fichajes, nóminas y ausencias. Es la parte que menos se integra y la que más se aprovecha en la dirección: cruzar horas imputadas con facturación del proyecto responde a la pregunta de qué clientes dejan margen, y esa consulta no está hecha en ninguna pantalla.

Dónde están los límites

Esta es la tabla que decide si un proyecto es viable:

Cuando te pasas, la API responde con un 429 y las cabeceras que hacen falta para reaccionar: Retry-After con los segundos de espera, y X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset y X-RateLimit-Window para saber cuál de las dos ventanas has agotado, la del minuto o la del mes.

El límite que duele es el mensual, y duele porque se multiplica sin que lo veas. Los listados van paginados por cursor, con 25 resultados por defecto y 100 como máximo. Recorrer un catálogo de cinco mil productos son cincuenta llamadas. Hacerlo una vez al día son mil quinientas al mes, y ahí el plan Plus ya está fuera y el Básico se queda casi sin margen para lo demás.

De ahí sale la regla que más cupo ahorra: escucha webhooks en vez de preguntar. Holded publica eventos de facturas, compras, pagos, contactos, productos, stock y almacenes, con creación, actualización, borrado y aprobación. Cada envío va firmado con HMAC-SHA256 y lleva un identificador único de evento, y si tu servidor no contesta con un 2xx, Holded reintenta con espera creciente. Una integración que reacciona a lo que pasa consume una fracción de lo que consume una que revisa el catálogo entero cada hora por si acaso.

Lo que más alarga un proyecto de integración

Llamar a la API es la parte rápida. El tiempo se va en estas cuatro cosas:

La numeración, cuando tu sistema emite facturas. Con VeriFactu, una web, un TPV o una aplicación propia dejan de llevar su propia serie y pasan a crear el documento dentro del ERP, para que todas las facturas queden encadenadas en el mismo orden. Decidir qué series hay, qué origen usa cada una y quién las controla es una conversación de negocio con la asesoría, y va antes del código. Lo desarrollamos en la guía de VeriFactu ante la AEAT.

Los duplicados. Aquí es donde approveDoc cambia las reglas. Un flujo normal se reintenta cuando falla: si no sabes si la llamada llegó, la repites. Con una factura aprobada y remitida no puedes, porque el reintento crea una segunda factura que ya no se borra. La integración necesita una clave estable propia, decidir antes de aprobar si ese documento ya existe, y dejar registro de qué se envió. Es trabajo de diseño, no de programación, y es lo que separa una integración que aguanta de una que hay que arreglar cada mes.

El maestro de datos. Los clientes y los productos que hay en el otro sistema y los que hay en Holded casi nunca coinciden. Hay duplicados, nombres distintos para lo mismo, referencias que se escribieron a mano. Limpiar eso es aburrido, no lo quiere hacer nadie y determina si la integración funciona. La mayoría de los proyectos que se retrasan se retrasan aquí.

La carga inicial. Volcar el histórico por primera vez es justo lo que revienta el cupo mensual. Se planifica aparte, a veces a caballo entre dos meses, y a veces conviene subir de plan un mes y volver a bajar.

Para orientarte: un conector del catálogo se configura en una tarde, un flujo en n8n sobre la API lleva una o dos semanas con pruebas incluidas, y una implantación completa de Holded con migración desde otro ERP va de cuatro a ocho semanas. Las integraciones en las que otro sistema emite facturas se cuentan aparte y dependen casi por entero de lo resuelta que esté la parte fiscal.

Cuándo no compensa integrar por API

Cuatro situaciones en las que recomendamos no hacerlo:

Cuando el volumen no lo justifica. Si son quince pedidos al mes, copiarlos a mano cuesta menos que mantener una integración. El cálculo compara el tiempo que ahorras al año con lo que cuesta construirla y sostenerla, y hay bastantes casos en los que no sale.

Cuando el conector nativo ya lo hace. Rehacer por API algo que Holded ya mantiene es asumir un coste de mantenimiento a cambio de nada. Solo tiene sentido si el conector se queda corto en algo concreto que puedas nombrar.

Cuando el otro sistema no tiene API. Con un programa instalado en un ordenador de la oficina, sin interfaz de integración, no hay API de Holded que arregle eso. Lo vimos en el software de gestión de producción para una fábrica de muebles: cuando una de las dos partes no se deja conectar, la vía es otra.

Cuando el cupo obliga a subir de plan por encima del ahorro. Si el diseño solo cabe en un plan superior y la diferencia anual se come el beneficio, el problema es el diseño. Casi siempre se arregla pasando de consultar a escuchar, y si aun así no cabe, es que no tocaba.

Preguntas frecuentes

¿Qué plan de Holded hace falta para usar la API?

Cualquier plan de pago, y también el trial. El plan Free no incluye acceso a la API. Entre los planes de pago lo que varía es el cupo: las llamadas al mes van de 500 en el plan Plus a más de 100.000 en Premium, y el techo por minuto de 60 a 600. Esa cifra es la que hay que mirar antes de diseñar nada, porque una sincronización diaria de un catálogo mediano se come el cupo de los planes bajos sin llegar a fin de mes.

¿Puedo conectar mi tienda online con Holded sin programar?

Depende de la tienda. Holded tiene conectores propios para las plataformas más comunes, y si el tuyo está en el catálogo y hace lo que necesitas, esa es la vía: se configura en una tarde y la mantiene Holded. Cuando el conector se queda corto, el siguiente escalón es una herramienta como n8n, Make o Zapier, que llama a la API por ti sin que escribas código. Solo hace falta desarrollo cuando el flujo tiene reglas de negocio propias o cuando la factura se emite desde tu sistema.

¿Holded avisa cuando pasa algo o hay que preguntarle cada rato?

Avisa. Holded publica webhooks para facturas, compras, pagos, contactos, productos, stock y almacenes, con eventos de creación, actualización, borrado y aprobación. Cada envío va firmado con HMAC-SHA256 y lleva un identificador único de evento, que es lo que te permite descartar entregas repetidas. Si tu servidor no responde con un 2xx, Holded reintenta con espera creciente. Escuchar webhooks en lugar de preguntar cada cinco minutos ahorra la mayor parte del cupo mensual de llamadas.

¿Se puede conectar Holded a ChatGPT o a Claude?

Sí, desde junio de 2026 Holded publica un servidor MCP oficial. Es remoto, se autentica con OAuth y funciona con Claude, ChatGPT, Gemini y Cursor. El asistente hereda los permisos del usuario que lo conecta y el perfil por defecto es de solo lectura, así que consulta facturas, contactos o inventario sin poder crear documentos. Cubre bien la consulta puntual; para algo que corre todos los días hace falta una automatización.

¿Cuánto tarda montar una integración con Holded?

Un conector del catálogo se configura en una tarde. Un flujo en n8n sobre la API, entre una y dos semanas contando pruebas con datos reales. Una integración en la que otro sistema emite facturas lleva bastante más, y el tiempo no se va en programar: se va en acordar las series de numeración, el mapeo de clientes y productos, y qué pasa cuando algo falla a mitad. Esa conversación conviene tenerla antes de escribir código, no después.

Conclusión

La API de Holded da para casi todo lo que una pyme necesita conectar. Antes de encargar nada hay tres decisiones que conviene cerrar: si hace falta desarrollo o basta con un conector, cuántas llamadas al mes va a consumir el diseño, y quién manda sobre cada dato cuando dos sistemas guardan lo mismo.

Y dos reglas que ahorran disgustos: escuchar webhooks en lugar de consultar cada rato, y resolver la numeración y los duplicados antes de escribir la primera línea.

Montamos integraciones sobre Holded como Solution Partner certificado, desde conectar una tienda hasta que un software de gestión a medida facture dentro del ERP, pasando por la automatización de procesos que hay alrededor. Si tienes un caso concreto, cuéntanoslo y te decimos por qué vía lo haríamos, incluida la de no hacerlo.