n8n-nodes-aivence-realty

Nodo n8n para AivenceRealty CRM (Laravel).

Este paquete añade nodos para interactuar con el CRM inmobiliario AivenceRealty. Permite operaciones completas sobre Properties, Leads, Maintenance Orders, Contractors, y más.

📦 Instalación

npm install n8n-nodes-aivence-realty

O desde la interfaz de n8n: Community Nodes → Install y escribir n8n-nodes-aivence-realty.

🔐 Configuración

1. Obtén un Bearer Token desde tu panel de AivenceRealty
2. En n8n, ve a Credentials y crea credenciales de tipo AivenceRealty API
3. Introduce:
   • URL Base: https://realty.aivence.com (o tu dominio)
   • Bearer Token: Tu token de API
4. Guarda las credenciales

📋 Recursos Disponibles

1. Property (Propiedades)

• list - Listar todas las propiedades
• getSimilar - Obtener propiedades similares
• getStatistics - Estadísticas de propiedades

2. Lead (Leads)

• list - Listar leads
• create - Crear nuevo lead (campos: nombre, telefono, mensaje)

3. Tenant (Inquilinos)

• list - Listar inquilinos

4. Maintenance Order (Órdenes de Mantenimiento)

• checkDuplicate - Verificar si existe orden duplicada
• create - Crear nueva orden
• get - Obtener orden por ID
• update - Actualizar orden
• list - Listar órdenes

5. Contractor (Contratistas)

• findByCategory - Buscar por categoría (fontanería, electricidad, etc.)
• findAlternatives - Buscar contratistas alternativos

6. Monthly Cost (Costos Mensuales)

• track - Registrar costo mensual

7. WhatsApp

• sendMessage - Enviar mensaje por WhatsApp (Evolution API)

8. Calculator (Calculadoras Financieras) ✨ NUEVO

• mortgage - Calcular cuota mensual de hipoteca
• rentalYield - Calcular rentabilidad de inversión (ROI)
• closingCosts - Calcular costos de escrituración

🎯 Ejemplos de Uso

Crear un Lead

{
  "resource": "lead",
  "operation": "create",
  "nombre": "Juan Pérez",
  "telefono": "5491112345678",
  "mensaje": "Busco departamento 2 ambientes en Palermo"
}

Crear Orden de Mantenimiento

{
  "resource": "maintenanceOrder",
  "operation": "create",
  "clienteId": 123,
  "propiedadId": 456,
  "contratistaId": 789,
  "categoria": "fontanería",
  "urgencia": "alta",
  "descripcionCorta": "Fuga de agua",
  "descripcionDetallada": "Fuga en baño principal..."
}

Calcular Hipoteca

{
  "resource": "calculator",
  "operation": "mortgage",
  "propertyValue": 150000,
  "downPaymentPercent": 20,
  "interestRate": 4.5,
  "loanTermYears": 30
}

Respuesta:

{
  "monthly_payment": 608.02,
  "total_loan": 120000,
  "down_payment": 30000,
  "total_interest": 98887.20,
  "total_paid": 218887.20
}

Calcular Rentabilidad

{
  "resource": "calculator",
  "operation": "rentalYield",
  "propertyValue": 150000,
  "monthlyRent": 1200,
  "annualExpenses": 3000
}

Respuesta:

{
  "annual_rent": 14400,
  "net_annual_income": 11400,
  "gross_yield": 9.6,
  "net_yield": 7.6,
  "roi": 7.6,
  "payback_years": 13.16
}

🔧 Desarrollo Local

# Clonar repositorio
git clone https://github.com/aivence/n8n-nodes-aivence-realty.git
cd n8n-nodes-aivence-realty

# Instalar dependencias
npm install

# Compilar
npm run build

# Vincular localmente
npm link
cd ~/.n8n
npm link n8n-nodes-aivence-realty

# Iniciar n8n
n8n start

📝 Changelog

v0.1.3 (2025-10-12)

• ✨ Nuevo recurso: Calculator (Calculadoras Financieras)
• ➕ Operación: Calcular hipoteca (mortgage)
• ➕ Operación: Calcular rentabilidad (rentalYield)
• ➕ Operación: Calcular costos de cierre (closingCosts)
• 📚 README actualizado con ejemplos de calculadoras

v0.1.0 (2025-10-09)

• 🎉 Versión inicial
• ✅ 7 recursos implementados
• ✅ 15 operaciones totales
• ✅ Integración completa con API Laravel

📄 Licencia

MIT

👨‍💻 Autor

Federico Aivence - [email protected]

🔗 Links

• AivenceRealty CRM
• Repositorio GitHub
• Reportar Issues