n8n-nodes-aliaddo

Nodo comunitario de n8n para integrarse con la API de Aliaddo, el ERP/CRM colombiano en la nube para facturación electrónica, gestión de ventas y más.

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

1. En Aliaddo, ve a Mis datos → Integración → API Key
2. Genera o copia tu Token de Acceso
3. En n8n, crea una nueva credencial de tipo Aliaddo API Auth e ingresa el token

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.

Recursos y Operaciones

| Recurso | Operaciones disponibles | |---|---| | Cotización | Crear, Consultar, Consultar por ID | | Factura | Crear, Consultar, Consultar por ID | | Factura de Compra | Crear, Consultar, Consultar por ID, Pagar | | Orden de Venta | Crear, Consultar, Consultar por ID | | Asiento Contable | Crear, Consultar, Consultar por ID | | Lead | Crear, Consultar, Eliminar, Consultar Etapas | | Negocio | Crear, Consultar, Eliminar | | Actividad | Crear, Consultar, Eliminar | | Contacto | Crear, Consultar, Consultar por ID, Eliminar, Consultar Vendedores | | Producto | Crear, Consultar, Consultar por ID, Eliminar, Stock, Categorías, Unidades | | Impuesto | Crear, Consultar, Consultar por ID | | Bodega | Consultar | | Sucursal | Consultar | | Fuente | Consultar | | Usuario | Consultar, Consultar Propietarios |

Ejemplos de Uso

Consultar todos los contactos y guardarlos en Google Sheets

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

Crear una factura cuando se cierra un negocio en el CRM

Trigger (Webhook) → Aliaddo API (Factura: Crear) → Gmail (Enviar confirmación)

Sincronizar leads desde un formulario

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

Manejo de Errores

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

| Código HTTP | Mensaje | |---|---| | 401 | Token inválido o expirado | | 402 | Cuenta suspendida o plan no permite la acción | | 403 | Sin permisos para esta acción | | 404 | Recurso no encontrado | | 429 | Límite de solicitudes excedido |

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 · [email protected]