Description

@mikiguillamon/n8n-nodes-holded

Community node de n8n para trabajar con Holded.

Qué incluye

• Autenticación por API key de Holded.
• Activación mediante licencia.
• Operaciones guiadas para recursos habituales:

– Contacts
– Products
– Services
– Documents
– Payments
– Projects
– Tasks
– Leads
– Bookings
– Accounting Accounts

• Operación Custom API Request para cubrir cualquier endpoint de Holded sin esperar a que exista una acción dedicada en el nodo.
• Compatible con el uso como herramienta en agentes de IA de n8n.
• Controles tipo nodos oficiales de n8n:

– Return All y Limit en operaciones Get Many.
– Filtros guiados por recurso.
– Additional Query Parameters para parámetros no modelados.
– Fields para cuerpos simples sin escribir JSON.
– JSON avanzado opcional para casos con estructuras anidadas.

• Creación guiada de documentos comerciales:

– Facturas, presupuestos, pedidos, albaranes, compras y abonos.
– Datos de contacto, fechas, moneda, numeración, método de pago, etiquetas, envío y líneas de documento.

Enfoque

La API de Holded es amplia y cambia con el tiempo. Este paquete combina dos capas:

1. Operaciones guiadas para los flujos más frecuentes.
2. Una petición API personalizada para cubrir el resto de endpoints y casos avanzados.

Con esto el nodo es usable desde el primer momento y, a la vez, no se queda corto cuando Holded añade o ajusta endpoints.

Credenciales

Holded autentica las peticiones enviando la API key en la cabecera key.

Además, este nodo requiere una licencia. En la versión actual, cualquier clave de licencia con 10 o más caracteres se considera válida. La validación está preparada para cambiarse más adelante a una comprobación contra un servidor externo.

Instalación en n8n

En una instancia self-hosted de n8n:

1. Ve a Settings > Community Nodes.
2. Selecciona Install.
3. Introduce el paquete @mikiguillamon/n8n-nodes-holded.
4. Acepta el aviso de instalación de código no verificado.
5. Reinicia n8n si tu despliegue lo requiere.

Después, busca el nodo Holded en el editor de workflows.

Desarrollo local

npm install
npm run lint
npm run build
npm run dev

Notas

• El nodo usa la URL base https://api.holded.com.
• El nodo está marcado como usableAsTool, por lo que puede usarse como herramienta en agentes de IA dentro de n8n.
• Las operaciones de creación y actualización aceptan Fields para payloads simples y Advanced Body JSON para no limitar los campos que expone Holded en cada recurso.
• La creación de documentos comerciales tiene campos guiados para los casos habituales y permite completar o sobrescribir cualquier dato con Advanced Body JSON.
• Las operaciones Get Many permiten limitar resultados desde n8n. Si Holded no devuelve paginación nativa en un endpoint concreto, el límite se aplica sobre la respuesta recibida.
• Para endpoints no modelados explícitamente, usa Custom API Request.