aliaddo

n8n community node for Aliaddo API integration

Package Information

Downloads: 5 weekly / 95 monthly
Latest Version: 1.0.6
Author: Aliaddo

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

  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

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

Discussion