Cómo conectar Holded con n8n
Montamos y mantenemos tus automatizaciones de Holded en n8n: flujos bien diseñados, n8n Cloud o servidor propio, avisos cuando algo falla y documentación.
Por Juan Cantón Rodríguez · Actualizado el
Tiempo de implantación · 5-15 días laborables según flujos
El problema
El primer flujo de n8n con Holded se monta en una tarde. Los problemas llegan a los tres meses: un flujo que lleva días sin ejecutarse y nadie se ha dado cuenta, una factura duplicada porque un reintento llegó dos veces, una clave de API con acceso total guardada en la instancia de alguien que ya no está en la empresa, o la cuota mensual de la API de Holded agotada a mitad de mes por un flujo que consulta cada cinco minutos. n8n trae herramientas para evitar casi todo eso (flujos de error, reintentos, deduplicación, exportación de flujos), pero ninguna viene configurada: hay que decidir y montar cada una. Y en una pyme, quien construyó los flujos suele ser la única persona que sabe cómo funcionan.
PropuestaLa solución
Esta página es el servicio, no el nodo. Si ya manejas n8n y solo te falta conectar Holded, nuestro nodo verificado es gratis y probablemente te baste. Aquí hablamos de todo lo que viene después de instalarlo: decidir qué flujos merecen la pena, montarlos en n8n Cloud o en un servidor propio, dar a cada integración una clave de Holded con los permisos justos, decidir qué pasa cuando un flujo falla y quién se entera, dejarlo todo documentado y versionado, y mantenerlo cuando cambian Holded o n8n. Y si tu caso no es para n8n, te lo decimos antes de empezar.
Qué automatizamos
- Diseño de los flujos con tu equipo antes de tocar n8n: qué se automatiza, qué lo dispara y qué pasa en cada caso raro
- Instancia de n8n lista para producción: n8n Cloud, o autoalojada con dominio, HTTPS, Postgres y copias de seguridad
- Una clave de API de Holded por integración, con lectura o escritura solo en los módulos que usa
- Disparadores por webhook de Holded en lugar de consultas periódicas cuando el evento existe, con la firma verificada
- Reintentos con espera y control de duplicados en cada flujo que crea documentos en Holded
- Un flujo de errores común que avisa por email, Slack o Teams con el enlace a la ejecución que falló
- Flujos exportados a un repositorio Git y documentados: qué hace cada uno, de qué depende y cómo se reactiva
- Mantenimiento: actualizaciones de n8n y del nodo, revisión de errores y ajustes cuando Holded cambia o amplía la API
Casos de uso típicos
Perfiles en los que la integración Holded ↔ n8n suele encajar y qué cambia con ella. Son ejemplos ilustrativos, no clientes concretos.
Escenario típico: flujos montados por alguien que ya no está
Antes: Hay una docena de flujos en n8n, nadie sabe cuáles siguen activos y uno dejó de funcionar hace semanas sin que nadie lo viera.
Después: Inventario, flujos rehechos donde hacía falta, avisos de error y un documento por flujo. Lo que ya no se usaba, apagado.
Escenario típico: pyme que empieza con n8n y Holded
Antes: Quiere automatizar los pedidos de la tienda y los avisos de cobro, pero nadie del equipo es técnico ni quiere administrar un servidor.
Después: n8n Cloud, pocos flujos bien acabados con sus alertas y mantenimiento por horas cuando haga falta.
Escenario típico: los datos tienen que quedarse en casa
Antes: Una política interna pide que los datos de facturación no pasen por servicios de terceros.
Después: n8n autoalojado en su servidor, con copias que incluyen la clave de cifrado y una comprobación externa que avisa si la instancia se cae.
Escenario típico: un flujo que ya no cabe en n8n
Antes: Una sincronización que empezó pequeña mueve ahora miles de documentos al día y acumula reglas fiscales.
Después: La sacamos a un servicio dedicado contra la API de Holded, y n8n se queda con los avisos y las tareas pequeñas.
Qué cambia exactamente
El día a día sin la integración y con ella, lado a lado.
Sin la integración
- Flujos que fallan sin que nadie se entere
- Una clave de Holded con acceso total compartida por todos los flujos
- Facturas duplicadas cuando un reintento llega dos veces
- Flujos que solo entiende quien los hizo
- Actualizaciones de n8n aplazadas por miedo a romper algo
Con la integración
- Un flujo de errores que avisa con el enlace a la ejecución fallida
- Una clave por integración con los permisos justos
- Comprobación de duplicados antes de crear cualquier documento
- Flujos en un repositorio, cada uno con su documentación
- Actualizaciones con copia de seguridad previa y las notas de versión revisadas
Cómo lo construimos
Empezamos por un inventario: qué procesos quieres automatizar, cuántas veces al día ocurren, qué documentos crean en Holded y qué no puede fallar nunca. Con eso decidimos dónde corre n8n. En n8n Cloud, n8n se encarga del servidor y de las actualizaciones de seguridad, los datos se alojan en la Unión Europea y se paga por ejecuciones al mes (cada ejecución cuenta entera, tenga los pasos que tenga). Autoalojado, la edición Community no cobra por uso, pero las actualizaciones, las copias y la vigilancia pasan a ser trabajo de alguien, y funciones como la conexión con Git, los entornos o el envío de logs a sistemas externos son de los planes de pago. Conectamos Holded con nuestro nodo verificado: una credencial por integración, con una clave de la API v2 limitada a los permisos que pide ese flujo, y disparador por webhook con la firma de Holded comprobada cuando existe el evento. Cada flujo que escribe en Holded lleva reintentos con espera para los errores temporales y una comprobación previa para no crear dos veces el mismo documento. Las validaciones de negocio (un NIF que falta, un importe que no cuadra) paran el flujo a propósito con un error claro en vez de dejar pasar datos malos. Todos los flujos comparten un flujo de errores que avisa a una persona con el enlace a la ejecución fallida, y una comprobación externa vigila que la instancia siga viva. Al terminar, los flujos quedan exportados en un repositorio con un documento por flujo. Después, o te formamos para llevarlo tú, o lo mantenemos nosotros por horas.
¿Qué conectores hay para Holded y n8n?
Todas las opciones que existen, no solo la nuestra. Si tu caso lo resuelve un módulo de 50 €, cógelo: te lo decimos aquí antes de que nos escribas.
n8n-nodes-holded por tu cuenta (nuestro nodo)
Verificado por n8n, open source y con la API v2 de Holded completa, más un disparador para los webhooks de Holded. Si en tu equipo alguien ya maneja n8n y los flujos son pocos y sencillos, con el nodo te basta y no nos necesitas.
Dónde se queda corto: Es la pieza de conexión, no el trabajo de alrededor: el diseño de los flujos, los permisos, los errores, las alertas y el mantenimiento quedan de tu lado.
Nodo HTTP Request de n8n contra la API v2
Viene de serie en n8n y puede llamar a cualquier endpoint de Holded con tu clave. Sirve para una llamada puntual que no justifica instalar nada.
Dónde se queda corto: La autenticación, la paginación por cursor, los errores y los límites de la API los resuelves tú, llamada a llamada.
Zapier o Make
Los dos tienen app de Holded y son más fáciles de arrancar si nadie del equipo es técnico.
Dónde se queda corto: Cobran por consumo: Zapier por cada tarea completada y Make por créditos, que gasta cada acción. Sus acciones de Holded cubren una parte de la API (Make, por ejemplo, no trae módulos de facturas). n8n Cloud cuenta ejecuciones del flujo entero y la edición autoalojada no cobra por uso.
Montaje y mantenimiento con nosotros
El diseño de los flujos, la instancia, los permisos, la gestión de errores, las alertas, la documentación y el mantenimiento, con el mismo nodo gratuito por debajo. Si lo prefieres, te lo dejamos montado y formamos a tu equipo para que lo lleve.
Servicio dedicado contra la API, fuera de n8n
Para procesos críticos: volumen alto, concurrencia, lógica fiscal delicada o acuerdos de servicio. Cola persistida, idempotencia, tests y despliegue como cualquier otro software. n8n puede seguir ocupándose de los avisos y las tareas pequeñas.
Qué se rompe al conectar Holded con n8n
Los fallos que aparecen de verdad, casi siempre semanas después de dar la integración por buena.
- 01
La cuota mensual de la API de Holded se acaba antes de lo que parece
Holded aplica dos límites por cuenta: peticiones por minuto y llamadas al mes, según el plan (500 en Plus, 2.000 en Basic, 7.500 en Standard y 30.000 en Advanced). Un flujo que consulta Holded cada cinco minutos hace 8.640 llamadas al mes, más que la cuota de Standard, y cada página de un listado es otra llamada. Todas las claves de la cuenta comparten el mismo contador, así que un flujo mal hecho deja sin API al resto de integraciones. Por debajo de Premium, al llegar al tope la API responde 429 hasta que se renueva. Por eso preferimos los webhooks de Holded al sondeo.
- 02
Un reintento puede crear la factura dos veces
El reintento automático de n8n repite la petición entera. Si Holded llegó a crear el documento pero la respuesta se perdió, el segundo intento crea otro. Con los webhooks pasa lo mismo al revés: si el flujo no responde a tiempo con un 2xx, Holded reenvía el evento. Hay que deduplicar por el identificador del evento (la cabecera x-holded-webhook-id) y buscar el documento antes de crearlo. Y una factura aprobada en Holded ya no se edita: el error se corrige con una rectificativa.
- 03
Si la instancia se cae, ningún flujo de errores avisa
El flujo de errores de n8n se ejecuta cuando falla una ejecución. Si el servidor está parado, si el disparador nunca llega a saltar o si alguien desactivó el flujo, no hay ejecución que falle y nadie se entera. Hace falta una comprobación desde fuera (n8n expone un endpoint de salud) y, para los flujos que deben correr a diario, mirar cuándo fue la última ejecución correcta.
- 04
El historial de ejecuciones no es un registro de auditoría
n8n borra las ejecuciones antiguas. Autoalojado, por defecto guarda 14 días y un máximo de 10.000. En n8n Cloud, el plan Starter guarda 7 días y el Pro 30. Si dentro de seis meses alguien pregunta qué se envió a Holded y cuándo, la respuesta tiene que estar guardada en otro sitio.
- 05
Versionar los flujos no viene de serie
La conexión de n8n con Git y los entornos de pruebas son de los planes de pago, y el historial de versiones de un flujo cubre solo las últimas 24 horas fuera de ellos (5 días en n8n Cloud Pro). En la edición gratuita, versionar es exportar los flujos a un repositorio de forma periódica. Sin eso, un cambio que rompe un flujo no tiene marcha atrás fácil.
- 06
Sin la clave de cifrado, las credenciales no sirven
n8n cifra las credenciales con una clave que vive en su carpeta de configuración, fuera de la base de datos. Una copia de la base de datos sin esa clave restaura los flujos pero no las credenciales, y toca regenerar todas las claves de API. La copia de seguridad tiene que incluir las dos cosas.
- 07
Una clave con acceso total para todos los flujos
Las claves de la API v2 de Holded se crean con permisos por módulo (lectura, escritura o acceso total), y si a una le falta un permiso la API responde 403. Una sola clave con acceso total para todo multiplica el daño de un error y no deja revocar un flujo sin parar los demás. Lo mismo con los webhooks: si el disparador no lleva el secreto de firma configurado, cualquiera que conozca la URL puede lanzar el flujo.
- 08
La licencia de n8n no es la del nodo
Nuestro nodo es MIT. n8n se publica bajo la Sustainable Use License, que el propio n8n define como fair-code y no como open source: el uso interno en tu empresa es gratis, y se puede cobrar por montar y mantener flujos, pero no se puede ofrecer n8n para que terceros construyan sus propios flujos. Si tu equipo va a editar flujos, la instancia tiene que estar a tu nombre.
Preguntas frecuentes
¿En qué se diferencia esto del nodo gratuito?
El nodo es la pieza que conecta n8n con la API de Holded, y puedes instalarlo hoy mismo sin hablar con nadie. Este servicio es el trabajo de alrededor: diseñar los flujos, montar la instancia, configurar permisos, errores y alertas, documentar y mantener. Si tu equipo ya domina n8n y los flujos son sencillos, probablemente te baste con el nodo.
¿n8n Cloud o autoalojado?
n8n Cloud si nadie de tu equipo va a administrar un servidor: n8n se encarga del alojamiento y aplica solo las actualizaciones de seguridad, los datos se alojan en la Unión Europea y se paga por ejecuciones al mes. Autoalojado si necesitas que los datos se queden en tu servidor o vas a tener mucho volumen: la edición Community no cobra por uso, pero las actualizaciones (n8n recomienda al menos una al mes), las copias de seguridad y la vigilancia son trabajo de alguien, nuestro o tuyo. Lo decidimos contigo en el inventario inicial.
¿n8n es open source?
No en sentido estricto, y n8n tampoco lo dice: lo publica bajo su Sustainable Use License, que llama fair-code. El código es público y el uso interno en tu empresa es gratis, pero no puedes ofrecer n8n como servicio para que otros construyan sus flujos. Nuestro nodo de Holded sí es open source, con licencia MIT.
¿Podéis alojar n8n vosotros?
La licencia de n8n permite que ejecutemos tus flujos en una instancia nuestra siempre que tu equipo no los cree ni los edite. En cuanto queráis tocarlos vosotros, la instancia tiene que ser vuestra: una cuenta de n8n Cloud a vuestro nombre o vuestro servidor, con nosotros como usuarios. Es lo que recomendamos de entrada, para que nunca dependáis de nosotros para acceder a lo vuestro.
¿Quién lo mantiene cuando Holded cambia la API?
El nodo lo mantenemos nosotros para todo el mundo: se genera desde el catálogo oficial de la API v2 y publicamos versión nueva cuando Holded la amplía. Con mantenimiento contratado, además actualizamos el nodo en tu instancia, comprobamos tus flujos y ajustamos lo que cambie. Sin mantenimiento, el nodo sigue siendo gratuito y lo puedes actualizar tú desde n8n.
¿Cómo nos enteramos si algo falla?
Cada flujo tiene asignado un flujo de errores que avisa a una persona concreta por email, Slack o Teams con el enlace a la ejecución que falló. Las validaciones de negocio paran el flujo con un mensaje que se entiende. Y como un servidor parado no genera errores, una comprobación externa avisa si la instancia deja de responder.
¿Cuándo nos diríais que n8n no es la herramienta?
Cuando el proceso mueve mucho volumen con concurrencia, cuando un error fiscal no se puede permitir (rectificativas, Verifactu), cuando hace falta un acuerdo de servicio o tests automáticos serios. Ahí recomendamos un servicio dedicado contra la API de Holded. Y cuando una integración nativa de Holded ya resuelve lo que necesitas, también te lo decimos: es mejor no mantener nada.
¿Cuánto cuesta y cuánto tarda?
La instancia y los primeros flujos, de 5 a 15 días laborables según cuántos flujos sean y lo complejos que resulten, con presupuesto cerrado desde 2.200 € sin IVA (a 70 €/h). El mantenimiento va por horas a la misma tarifa. La suscripción de n8n Cloud o el servidor se pagan aparte, directamente al proveedor.
- Si solo quieres el nodo gratis para montarlo tú: n8n-nodes-holded, el nodo de Holded verificado por n8n
- Para ver flujos concretos con el nodo: 5 workflows reales de n8n con Holded
- Para ver qué expone la API que hay debajo: La API v2 de Holded, explicada
Holded vs el resto. Sin marketing.
Si todavía no tienes claro si Holded es la herramienta correcta para tu pyme, estas son las comparativas honestas con las alternativas más comunes en España.
Odoo vs Sage 200
ERP modular de Sage para pymes en crecimiento (antes Sage Murano)
Leer comparativavsOdoo vs Dynamics 365 Business Central
El ERP para pymes de Microsoft, integrado con Microsoft 365
Leer comparativavsOdoo vs SAP Business One
El ERP de SAP para pequeñas y medianas empresas
Leer comparativaIntegraciones relacionadas
Otras conexiones de la misma categoría que n8n y las que comparten plataforma con esta.
Integración Holded Shopify. Facturación, stock y devoluciones de Shopify a Holded en tiempo real.
Integración Holded WooCommerce. WooCommerce y Holded sincronizados sin plugins frágiles ni footprint en WordPress.
Integración Holded PrestaShop. PrestaShop ↔ Holded sin depender del módulo oficial de pago.
¿Quieres conectar varios SaaS a la vez? Ver pack "Proyecto completo"
¿Hablamos de tu integración con n8n?
Llamada de 30 minutos sin compromiso. Salimos con alcance y precio.