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": "juan@example.com",
  "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