Package Information
Downloads: 5 weekly / 95 monthly
Latest Version: 1.0.6
Author: Aliaddo
Available Nodes
Documentation
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
- Ve a Settings → Community Nodes
- Haz clic en Install
- Ingresa
n8n-nodes-aliaddoy confirma
Manual (Self-hosted)
npm install n8n-nodes-aliaddo
Configuración de Credenciales
- En Aliaddo, ve a Mis datos → Integración → API Key
- Genera o copia tu Token de Acceso
- 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
Licencia
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