🧮 n8n-nodes-xubio

Nodo comunitario de n8n para integración completa con la API de Xubio 🚀

Integra tu flujo de trabajo de n8n con Xubio, la plataforma de gestión contable argentina líder en el mercado. Este nodo te permite automatizar todas tus operaciones contables con soporte de IA integrado.

✨ Características Principales

• 🔐 Autenticación automática con manejo de tokens OAuth2
• 🤖 Soporte de IA dinámico para operaciones personalizadas
• 📊 Gestión completa de entidades contables
• 🔄 Reintentos automáticos en caso de errores de autenticación
• 🎯 Operaciones CRUD para todas las entidades principales
• ⚡ API personalizada para endpoints específicos

🏗️ Entidades Soportadas

| Entidad | Operaciones | Descripción | |---------|-------------|-------------| | 👥 Clientes | CRUD completo | Gestión de clientes y contactos | | 💰 Cobranzas | CRUD completo | Manejo de recibos y cobranzas | | 🛒 Órdenes de Compra | CRUD completo | Control de compras y proveedores | | 💳 Órdenes de Pago | CRUD completo | Gestión de pagos y facturación | | 🏢 Proveedores | CRUD completo | Administración de proveedores | | 🔧 API Personalizada | Operaciones libres | Acceso directo a cualquier endpoint |

🚀 Instalación

Método 1: Instalación desde npm (Recomendado)

npm install n8n-nodes-xubio

Método 2: Instalación manual

1. Clona el repositorio:

git clone https://github.com/lucho/n8n-nodes-xubio.git
cd n8n-nodes-xubio

2. Instala las dependencias:

npm install

3. Compila el proyecto:

npm run build

4. Copia la carpeta dist a tu directorio de nodos comunitarios de n8n.

⚙️ Configuración

1. Configurar Credenciales

En n8n, ve a Settings > Credentials y agrega una nueva credencial de tipo Xubio API:

• Client ID: Tu ID de cliente de la API de Xubio
• Secret ID: Tu clave secreta de la API de Xubio
• Base URL: URL base de la API (por defecto: https://xubio.com/API/1.1)

2. Usar el Nodo

1. Agrega el nodo Xubio a tu flujo de trabajo
2. Selecciona la credencial configurada
3. Elige el recurso y la operación deseada
4. Configura los parámetros específicos

📋 Operaciones Disponibles

👥 Clientes

// Obtener todos los clientes
{
  "resource": "client",
  "operation": "getAll",
  "filters": {
    "activo": 1,
    "fechaDesde": "2024-01-01"
  }
}

// Crear un nuevo cliente
{
  "resource": "client",
  "operation": "create",
  "clientData": {
    "nombre": "Juan Pérez",
    "email": "[email protected]",
    "cuit": "20-12345678-9"
  }
}

💰 Cobranzas

// Obtener cobranzas por fecha
{
  "resource": "cobranza",
  "operation": "getAll",
  "fechaDesde": "2024-01-01",
  "fechaHasta": "2024-12-31"
}

// Crear nueva cobranza
{
  "resource": "cobranza",
  "operation": "create",
  "cobranzaData": {
    "clienteId": 123,
    "monto": 50000,
    "fechaVencimiento": "2024-02-15"
  }
}

🔧 API Personalizada con IA

// Operación dinámica con IA
{
  "resource": "custom",
  "configMode": "ai",
  "aiMethod": "={{ $fromAI('HTTP_method', 'HTTP method to call', 'GET') }}",
  "aiEndpoint": "={{ $fromAI('endpoint', 'API endpoint to call', '/clienteBean') }}",
  "aiQueryParams": "={{ $fromAI('query_params', 'Query parameters as JSON', '{}') }}"
}

🤖 Características de IA

El nodo incluye soporte avanzado de IA para operaciones dinámicas:

• Configuración automática de parámetros basada en contexto
• Validación inteligente de datos de entrada
• Sugerencias dinámicas para endpoints y métodos
• Manejo automático de errores y reintentos

🔧 Desarrollo

Requisitos

• Node.js >= 18.10
• pnpm >= 8.1
• n8n >= 1.95.3

Scripts Disponibles

# Compilar el proyecto
npm run build

# Desarrollo con watch
npm run dev

# Formatear código
npm run format

# Linting
npm run lint

# Corregir errores de linting
npm run lintfix

Estructura del Proyecto

mcp-xubio/
├── src/                    # Código fuente TypeScript
│   ├── xubio-api.ts       # Clase principal de la API
│   ├── xubio-client-api.ts # API específica para clientes
│   └── types.ts           # Definiciones de tipos
├── nodes/                 # Nodos de n8n
│   └── Xubio/            # Nodo principal
├── credentials/          # Configuración de credenciales
└── dist/                # Código compilado

🐛 Solución de Problemas

Error de Autenticación

Si recibes errores 401, verifica:

• Las credenciales están correctamente configuradas
• El Client ID y Secret ID son válidos
• La cuenta tiene permisos para la API

Error de Compilación

# Limpiar y reinstalar dependencias
rm -rf node_modules package-lock.json
npm install
npm run build

Problemas de Conectividad

• Verifica que el servidor de n8n tenga acceso a https://xubio.com
• Revisa la configuración de firewall/proxy
• Confirma que la URL base sea correcta

📚 Ejemplos de Uso

Flujo de Facturación Automática

graph LR
    A[Trigger] --> B[Obtener Clientes]
    B --> C[Crear Factura]
    C --> D[Enviar Email]
    D --> E[Actualizar Estado]

Integración con CRM

graph LR
    A[CRM Webhook] --> B[Crear Cliente en Xubio]
    B --> C[Generar Cobranza]
    C --> D[Notificar Cliente]

🤝 Contribuir

¡Las contribuciones son bienvenidas! Por favor:

1. Fork el proyecto
2. Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT - ver el archivo LICENSE para detalles.

🆘 Soporte

• 📖 Documentación: Guía de instalación de n8n
• 🐛 Issues: GitHub Issues
• 💬 Discusiones: GitHub Discussions
• 📧 Email: [email protected]

🙏 Agradecimientos

• n8n por la plataforma de automatización
• Xubio por la API contable
• La comunidad de desarrolladores de n8n

¿Te gustó este nodo? ¡Dale una ⭐ en GitHub!