n8n-nodes-aivencerealtycrm

Nodo comunitario n8n para AivenceRealty CRM inmobiliario.

Este paquete añade nodos para interactuar con el CRM inmobiliario AivenceRealty. Permite operaciones completas sobre propiedades, leads, inquilinos, órdenes de mantenimiento, contratistas, pagos, políticas de aprobación y más.

📦 Instalación

npm install n8n-nodes-aivencerealtycrm

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

🔐 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: La URL de tu instancia de AivenceRealty (ej: https://tu-dominio.com)
   • Bearer Token: Tu token de API
4. Guarda las credenciales

📋 Recursos y Operaciones Disponibles

Tabla Completa de Operaciones (v2.3.0)

| Recurso | Operación | Descripción | Método | Endpoint | |---------|-----------|-------------|--------|----------| | Property | list | Listar todas las propiedades | GET | /api/v1/properties | | | getSimilar | Obtener propiedades similares | POST | /api/v1/properties/similar | | | getStatistics | Estadísticas de propiedades | GET | /api/v1/properties/statistics | | Lead | list | Listar leads | GET | /api/v1/leads | | | create | Crear nuevo lead | POST | /api/v1/leads | | Tenant | list | Listar inquilinos | GET | /api/v1/tenants | | | get | Obtener inquilino por ID | GET | /api/v1/tenants/{id} | | | validateExists ⭐ | Validar si inquilino existe | GET | /api/v1/tenants/{id}/exists | | Maintenance Request | checkDuplicate | Verificar orden duplicada | POST | /api/v1/maintenance-requests/check-duplicate | | | create | Crear nueva orden | POST | /api/v1/maintenance-requests | | | get | Obtener orden por ID | GET | /api/v1/maintenance-requests/{id} | | | update | Actualizar orden | PUT | /api/v1/maintenance-requests/{id} | | | list | Listar órdenes | GET | /api/v1/maintenance-requests | | Contractor | findByCategory | Buscar por categoría | GET | /api/v1/contractors/category/{category} | | | findAlternatives | Buscar contratistas alternativos | POST | /api/v1/contractors/alternatives | | Email | send | Enviar email | POST | /api/v1/emails/send | | Appointment | create | Crear cita | POST | /api/v1/appointments | | | list | Listar citas | GET | /api/v1/appointments | | | get | Obtener cita por ID | GET | /api/v1/appointments/{id} | | | update | Actualizar cita | PUT | /api/v1/appointments/{id} | | Calculator | calculate | Calcular hipoteca/gastos | POST | /api/v1/calculator | | Agent | list | Listar agentes | GET | /api/v1/agents | | | get | Obtener agente por ID | GET | /api/v1/agents/{id} | | Owner Expense | create | Crear gasto de propietario | POST | /api/v1/owner-expenses | | | list | Listar gastos | GET | /api/v1/owner-expenses | | Contractor Invoice | create | Crear factura de contratista | POST | /api/v1/contractor-invoices | | | list | Listar facturas | GET | /api/v1/contractor-invoices | | | process | Procesar factura con OCR | POST | /api/v1/contractor-invoices/process | | Payment Proof ⭐ | process ⭐ | Procesar comprobante de pago | POST | /api/v1/payments/verify-proof | | Automation ⭐ | logExecution ⭐ | Registrar ejecución de workflow | POST | /api/v1/automation/log | | Policy ⭐ | evaluate ⭐ | Evaluar política de aprobación | POST | /api/v1/policies/evaluate | | Notification ⭐ | send ⭐ | Enviar notificación multi-canal | POST | /api/v1/notifications/send |

⭐ = Nuevas operaciones en v2.3.0

🎯 Ejemplos de Uso

Crear un Lead

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

Crear Orden de Mantenimiento

{
  "resource": "maintenanceRequest",
  "operation": "create",
  "clienteId": 123,
  "propiedadId": 456,
  "contratistaId": 789,
  "categoria": "fontanería",
  "urgencia": "alta",
  "descripcionCorta": "Fuga de agua",
  "descripcionDetallada": "Fuga en baño principal que requiere atención inmediata"
}

Validar Existencia de Inquilino (v2.3.0)

{
  "resource": "tenant",
  "operation": "validateExists",
  "tenantId": "123"
}

Procesar Comprobante de Pago (v2.3.0)

{
  "resource": "paymentProof",
  "operation": "process",
  "ppTenantId": "123",
  "ppOcrData": {
    "amount": 45000,
    "date": "2026-01-26",
    "reference": "REF123"
  },
  "ppFileUrl": "https://storage.ejemplo.com/comprobante.pdf"
}

Registrar Ejecución de Workflow (v2.3.0)

{
  "resource": "automation",
  "operation": "logExecution",
  "autoWorkflowName": "ProcessPaymentProof",
  "autoExecutionId": "exec_123456",
  "autoStatus": "success",
  "autoDocumentType": "payment_proof",
  "autoMetadata": {
    "tenant_id": 123,
    "amount": 45000,
    "processing_time_ms": 1523
  }
}

Evaluar Política de Aprobación (v2.3.0)

{
  "resource": "policy",
  "operation": "evaluate",
  "policyType": "payment_proof",
  "policyAmount": 45000,
  "policyDocumentData": {
    "amount": 45000,
    "date": "2026-01-26",
    "tenant_id": 123,
    "lease_amount": 50000
  }
}

Respuesta de ejemplo:

{
  "approved": true,
  "auto_approve": false,
  "requires_review": true,
  "reason": "Monto mayor a 50% del alquiler",
  "approval_level": "manager"
}

Enviar Notificación Multi-Canal (v2.3.0)

{
  "resource": "notification",
  "operation": "send",
  "notifRecipientType": "tenant",
  "notifRecipientId": "123",
  "notifChannel": "whatsapp",
  "notifTemplateKey": "payment_received",
  "notifVariables": {
    "amount": 45000,
    "property_address": "Av. Corrientes 1234",
    "payment_date": "26/01/2026"
  }
}

Canales disponibles: database (in-app), whatsapp, email

🔧 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 TypeScript
npm run build

# Vincular localmente para testing
npm link
cd ~/.n8n/custom
npm link n8n-nodes-aivencerealtycrm

# Iniciar n8n
n8n start

📝 Changelog

v2.3.0 (2026-01-26) - Automation & Policies

• ⭐ NUEVO: Recurso Payment Proof con operación process para procesamiento automatizado de comprobantes de pago con OCR
• ⭐ NUEVO: Recurso Automation con operación logExecution para registro centralizado de ejecuciones de workflows
• ⭐ NUEVO: Recurso Policy con operación evaluate para evaluación automática de políticas de aprobación
• ⭐ NUEVO: Recurso Notification con operación send para notificaciones multi-canal (database/whatsapp/email)
• ⭐ NUEVO: Operación validateExists en recurso Tenant para validación rápida de existencia
• ✅ 16 recursos totales
• ✅ 40+ operaciones totales
• ✅ Soporte completo para flujos de automatización con IA

v2.2.0 (2026-01-20)

• ✅ Agregados recursos: Agent, Appointment, Calculator, OwnerExpense, ContractorInvoice
• ✅ Operaciones de procesamiento de facturas con OCR
• ✅ Sistema de cálculos hipotecarios

v2.1.0 (2025-12-15)

• ✅ Agregado recurso Email
• ✅ Mejoras en MaintenanceRequest
• ✅ Validación mejorada de campos

v2.0.0 (2025-11-10)

• ✅ Refactorización completa de la arquitectura
• ✅ Mejoras de performance
• ✅ Tipos TypeScript mejorados

v0.1.0 (2025-10-09)

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

🎓 Características Destacadas de v2.3.0

🤖 Automatización Inteligente

• Procesamiento OCR: Extrae datos de comprobantes de pago y facturas automáticamente
• Políticas Configurables: Evalúa reglas de negocio sin código hardcoded
• Logging Centralizado: Rastrea todas las ejecuciones de workflows desde N8N

🔔 Notificaciones Multi-Canal

• Database: Notificaciones in-app para el CRM
• WhatsApp: Mensajes instantáneos vía Evolution API
• Email: Notificaciones por correo electrónico
• Templates Dinámicos: Variables reemplazables por template

🛡️ Validación y Seguridad

• Validación de existencia de entidades antes de operar
• Políticas de aprobación automáticas por tipo de documento y monto
• Trazabilidad completa de operaciones automatizadas

🔗 Workflows N8N Recomendados

Los siguientes workflows están optimizados para usar el nodo comunitario:

1. ProcessPaymentProof - Procesamiento de comprobantes de pago con OCR → Policy → Notification
2. ProcessContractorInvoice - Procesamiento de facturas de contratistas con OCR → Policy → Automation Log
3. ProcessOwnerExpense - Procesamiento de gastos de propietarios → Policy → Notification
4. Router Central - Routing inteligente de documentos según tipo detectado por IA

📄 Licencia

MIT

👨‍💻 Autor

Federico Aivence

🔗 Links

• Repositorio GitHub
• npm Package
• Reportar Issues

🆘 Soporte

Para soporte técnico o consultas:

• 🐛 Issues: GitHub Issues
• 📖 Documentación: Ver ejemplos en este README