Cobertura del nodo n8n-nodes-holded para Holded API v2
Una agencia técnica que escribe el código que las consultoras subcontratan.
Francodesystems nace en 2025 con una idea concreta: que las pymes españolas dejen de pelearse con Excel para sincronizar datos entre SaaS. Si tu ecommerce, tu CRM, tu ERP y tu pasarela no se hablan entre sí, tienes un problema técnico — y somos ingenieros, no consultores con PowerPoint.
Llevo años escribiendo código de integraciones contra ERPs, CRMs y pasarelas para pymes españolas. Después de ver el mismo patrón una y otra vez — proyectos que empiezan con un plugin community y acaban en un trabajo de reparación a los dos años — decidí montar Francodesystems con la idea opuesta: integraciones a medida con arquitectura sólida desde el día 1.
Mi especialidad técnica es Holded API v2. Tengo publicado el nodo community n8n-nodes-holded en npm con cobertura 100% (42 recursos, 323 operaciones) — el más completo del ecosistema. La razón de tener un nodo tan ambicioso no es marketing: es que cada cliente nuevo me lleva a un endpoint que no había tocado antes, y prefiero resolverlo en open source una vez a re-encontrármelo cinco veces.
Stack: Node + TypeScript estricto, BullMQ + PostgreSQL, arquitectura Domain-Driven Design. Para IA aplicada uso la SDK de Anthropic — tenemos agentes Claude en producción asistiendo en tareas administrativas reales. Para deploy, Docker + GitHub Actions con provenance attestation firmada.
Si quieres ver cómo escribo, mira el repo de n8n-nodes-holded — está todo público. Y si quieres ver cómo razono sobre arquitectura para cumplimiento fiscal, el post de Verifactu en ecommerce lo resume bien.
El problema que vimos demasiadas veces
Una pyme española típica hoy tiene Shopify (o WooCommerce) para vender, Holded como ERP/facturación, Stripe o Redsys como pasarela, HubSpot o Pipedrive como CRM, Mailchimp o Brevo para email, Asana o Jira para gestionar proyectos, y un par de hojas de Excel donde cuadran lo que no encaja. Cada uno de esos SaaS es buenísimo por separado — el problema es que no se hablan entre sí.
El equipo administrativo dedica media jornada a la semana copiando pedidos a Holded a mano. El stock está siempre mal porque nadie sincronizó la última modificación. La asesoría devuelve el cierre mensual con correcciones. Y a final de mes nadie sabe del todo dónde va el dinero porque los datos viven en cuatro sistemas que no se cruzan automáticamente.
Los intentos típicos de arreglarlo: comprar un plugin "Shopify ↔ Holded" en el marketplace, contratar a un consultor que monta algo en Make/Zapier, o pedirle al equipo IT que "lo apañe". Los tres caminos llevan al mismo sitio: un sistema frágil que se rompe con el siguiente update y nadie sabe arreglar porque no hay arquitectura debajo.
Francodesystems es la alternativa: ingeniería de integraciones tratada como ingeniería seria, con código que el equipo del cliente puede mantener si decide hacerlo, plazos cerrados y arquitectura pensada para sobrevivir a los cambios de API que vienen.
Lo que tenemos en producción
Somos transparentes: el sitio que estás viendo lo lanzamos en mayo 2026 — no vamos a presumir de millones de proyectos que no hemos hecho. Lo que sí tenemos público y auditable:
Endpoints expuestos como acciones de n8n
Único nodo community con cobertura completa de API v2
Open source firmado por GitHub Actions OIDC
¿Quieres referencias de pymes reales con las que hemos trabajado? Pídelas en el diagnóstico. No las publicamos en el sitio por respeto a su privacidad — pero las compartimos con cualquiera que esté valorando trabajar con nosotros.
Por qué nos eligen frente a una agencia generalista
Especialistas, no generalistas
Hacemos integraciones técnicas y poco más. No te vamos a vender SEO, ni community management, ni diseño web. Eso lo hacen otros mejor. Lo que sí hacemos: conectar cualquier sistema con Holded de forma que sobreviva al tiempo.
Ingenieros, no consultores
El que viene al diagnóstico es el que va a escribir el código. No hay capa intermedia de gestores de cuenta que traducen requisitos. Hablas con quien lo hace, en su jerga, y sale más rápido y mejor.
Holded a fondo, no por encima
Llevamos en producción n8n-nodes-holded con cobertura 100% de la API v2 — eso significa que hemos tocado cada endpoint disponible. Cuando vienes con una integración rara contra Holded, ya nos hemos encontrado el problema antes.
Verifactu no es opcional
Cada integración nueva post-2025 se diseña con Verifactu en mente desde el día 1 — idempotencia, orden de creación garantizado, validación de campos obligatorios. Cuando llegue la inspección, tu cadena de huellas es auditable.
Cómo trabajamos por dentro.
Cuatro principios que aplicamos a cada proyecto, escritos para que tu equipo técnico pueda evaluarlos antes de contratarnos.
Domain-Driven Design por defecto
Cada integración se diseña con capas separadas: dominio puro (modelos de negocio), aplicación (orquestadores), infraestructura (clientes API, persistence). Anti-corruption layers entre tu dominio y el de cada SaaS externo. Cuando Shopify cambia su API, tu dominio no se entera. Cuando Holded mete una v3, mapeamos solo la capa de adaptación. El código sobrevive a las APIs.
Procesos asíncronos y resilientes
Todas las llamadas a SaaS externos pasan por colas BullMQ con retries exponenciales y idempotencia garantizada por jobId. Si Holded está caído 4 horas, tu webhook de Shopify no pierde nada — entra a la cola y se procesa cuando vuelva. Si un webhook se reintenta 5 veces, no duplicamos facturas porque la deduplicación está en el job, no en la base de datos.
Código que el siguiente desarrollador entiende
Sin caja negra ni magia. Documentamos los flujos críticos en Markdown junto al código, comentamos las decisiones no-obvias, dejamos diagramas de secuencia para los puntos sensibles. Si mañana decides traerte el mantenimiento internamente, tu equipo coge el repo y trabaja — no tienes que pagar consultoría para entender lo que hicimos.
Plazos cerrados, sin sorpresas
Después del diagnóstico de 30 minutos te damos alcance, plazo y precio fijos por escrito. Si algo cambia durante el proyecto (typical: descubrimos un caso límite no contemplado), lo hablamos antes de hacerlo y revisamos el alcance abiertamente. Nunca te llega una factura mayor de lo acordado sin haberlo conversado.
Herramientas con las que construimos.
Construimos sobre Holded como ERP central y conectamos cualquier SaaS con API o webhook. Node + TypeScript estricto, Postgres + colas idempotentes para integraciones asíncronas, arquitectura DDD para que el código sobreviva al equipo.
¿Te suena bien?
Cuéntanos qué quieres integrar. 30 minutos de llamada y salimos con un plan claro. Te respondemos en 24 horas.