n8n-nodes-aliaddo

Paquete de nodos comunitarios de n8n para integrarse con Aliaddo, el ERP/CRM colombiano en la nube para facturación electrónica, ventas, contactos, inventario y contabilidad, y con su Hub de autenticación de usuario. Incluye dos nodos:

• Aliaddo ERP — 20 recursos sobre la API de Aliaddo.
• Aliaddo HUB — autenticación y consulta de suscripciones contra el Hub de Aliaddo.

Requisitos

• n8n versión >=1.30.0
• Node.js versión >=18.0.0
• Una cuenta activa en Aliaddo

Instalación

En n8n Cloud o Self-hosted

1. Ve a Settings → Community Nodes
2. Haz clic en Install
3. Ingresa n8n-nodes-aliaddo y confirma

Manual (Self-hosted)

npm install n8n-nodes-aliaddo

Configuración de Credenciales

Aliaddo ERP Auth

1. En Aliaddo, ve a Mis datos → Integración → API Key
2. En n8n, crea una credencial de tipo Aliaddo ERP Auth y elige uno de los dos modos:
   • Access Token (Classic): pega el token clásico generado en Aliaddo. Disponible para todo público. Si lo defines, API Key/Secret Key se ignoran.
   • API Key + Secret Key: el nodo firma cada petición automáticamente con HMAC-SHA256 (X-Api-Key/X-Nonce/X-Timestamp/X-Signature). Uso restringido al equipo de desarrollo de Aliaddo (no disponible para el público general). En este modo, el campo Bearer Token (Dinámico) del nodo (visible siempre) permite enviar un Bearer generado fuera de n8n (por ejemplo, con el nodo Aliaddo HUB); déjalo vacío si no aplica.

Límite de tasa: La API de Aliaddo permite entre 50 y 150 solicitudes por minuto. El nodo muestra un mensaje claro si se supera el límite.

Aliaddo HUB Auth

1. Solicita tu API Key y Secret Key del Hub de Aliaddo al equipo de Aliaddo.
2. En n8n, crea una credencial de tipo Aliaddo HUB Auth, ingresa ambas claves y elige el Environment (Production o UAT).
3. Todas las peticiones del nodo Aliaddo HUB se firman automáticamente con HMAC-SHA256.

Uso como Tool de un AI Agent

Ambos nodos (Aliaddo ERP y Aliaddo HUB) se pueden conectar como tool de un nodo AI Agent. Al ser un paquete comunitario (no viene incluido por defecto en n8n), tu instancia self-hosted necesita la variable de entorno N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true (requiere reiniciar n8n) para que aparezcan como opción de tool; sin ella, el nodo se instala y se ve en el editor pero el AI Agent no lo reconoce como herramienta.

Recursos y Operaciones — Aliaddo ERP

Los recursos Motor de Búsqueda, Validar Cliente/Producto/Stock, Consultar IDs de Entidades y Crear Documento están pensados para exponerse como herramientas de un AI Agent de n8n (vía $fromAI()), reduciendo la cantidad de nodos/herramientas que el agente necesita elegir.

Recursos y Operaciones — Aliaddo HUB

Ejemplos de Uso

Consultar todos los contactos y guardarlos en Google Sheets

Trigger (Schedule) → Aliaddo ERP (Contacto: Consultar, Retornar Todos = true) → Google Sheets (Append)

Crear una factura cuando se cierra un negocio en el CRM

Trigger (Webhook) → Aliaddo ERP (Factura de Venta: Crear) → Gmail (Enviar confirmación)

Sincronizar leads desde un formulario

n8n Form → Aliaddo ERP (Lead: Crear) → Slack (Notificar equipo de ventas)

Agente de IA que crea documentos comerciales por conversación

AI Agent → Aliaddo ERP (Consultar IDs de Entidades) → Aliaddo ERP (Validar Stock, si aplica) → Aliaddo ERP (Crear Documento)

Autenticar un usuario del Hub y listar sus suscripciones

Trigger (Webhook) → Aliaddo HUB (Obtener Token) → Aliaddo HUB (Consultar Suscripciones) → Respond to Webhook

Manejo de Errores

Aliaddo ERP

El nodo incluye mensajes descriptivos en español para los errores más comunes de la API:

Aliaddo HUB

El nodo propaga el mensaje de error tal como lo devuelve el Hub (ya viene descriptivo en español), junto con el código de estado HTTP:

[
  {
    "error": {
      "message": "401 - \"{\\\"success\\\":false,\\\"message\\\":\\\"Firma inválida: Nonce duplicado o reusado (Replay Attack detectado).\\\"}\"",
      "status": 401
    }
  }
]

En ambos nodos

Activa On Error: Continue (using error output) en la configuración del nodo para enrutar los ítems fallidos a una salida "Error" separada en vez de detener el workflow.

Documentación de la API

• Referencia oficial de la API de Aliaddo
• Autenticación por API Key

Licencia

MIT

Contribuciones

¿Encuentras un problema o quieres añadir una operación? Abre un issue o un pull request en el repositorio.

Desarrollado por el equipo de Aliaddo · soporte@aliaddo.com