HAVI Score — Matching de Propiedades

Una vez que el comprador tiene su HAVI Score calculado, el sistema cruza su perfil financiero con el inventario de propiedades disponibles para encontrar las más compatibles.

---

Obtener propiedades compatibles

GET /api/v1/matching/:perfilId

Query params opcionales:

Parámetro	Tipo	Descripción
page	number	Página (default: 1)
limit	number	Resultados por página (default: 10)
listingType	string	sale o rent
city	string	Filtrar por ciudad

Respuesta 200:

{
  "status": "success",
  "data": {
    "perfil": {
      "perfilId": "uuid-perfil",
      "haviScore": 715,
      "creditoEstimado": 2100000,
      "enganche": 300000,
      "mensualidadMaxima": 18500
    },
    "propiedades": [
      {
        "id": "uuid-propiedad",
        "title": "Departamento en Narvarte",
        "price": 2450000,
        "listingType": "sale",
        "city": "Ciudad de México",
        "bedrooms": 2,
        "bathrooms": 1,
        "constructionArea": 85,
        "compatibilidad": 94,
        "mensualidadEstimada": 17200,
        "assets": [
          { "url": "https://cdn.havi.app/properties/depa-narvarte.jpg" }
        ]
      }
    ],
    "totalCompatibles": 38,
    "pagination": {
      "total": 38,
      "perPage": 10,
      "currentPage": 1,
      "lastPage": 4
    }
  }
}

El campo compatibilidad (0–100) indica qué tan bien encaja la propiedad con el perfil financiero del comprador.

---

Documentar interés en una propiedad (Fase 3)

Cuando el comprador encuentra una propiedad de su interés, documenta ese interés para que los agentes puedan darle seguimiento.

POST /api/v1/fase3/documentar/:perfilId
Content-Type: application/json

Body:

{
  "propertyId": "uuid-propiedad",
  "mensaje": "Me interesa mucho esta propiedad. ¿Podemos agendar una visita?",
  "preferencia": "whatsapp"
}

Respuesta 201:

{
  "status": "success",
  "data": {
    "perfilId": "uuid-perfil",
    "propertyId": "uuid-propiedad",
    "etapa": "documentado",
    "mensaje": "Tu interés fue registrado. Un agente te contactará pronto.",
    "estimadoContacto": "24-48 horas"
  }
}

---

Documentar con análisis de documentos (Fase 3 con IA)

Requiere autenticación

Versión avanzada que adjunta los documentos analizados al interés del comprador.

POST /api/v1/fase3/documentar-ai/:perfilId
Authorization: Bearer {token}
Content-Type: application/json

{
  "propertyId": "uuid-propiedad",
  "documentIds": ["uuid-doc-1", "uuid-doc-2"]
}

---

Obtener resultado de Fase 3

GET /api/v1/fase3/resultado/:perfilId
Authorization: Bearer {token}

Devuelve el estado del proceso de documentación y si el comprador fue pre-calificado.

---

Actualizar contacto del perfil

Requiere autenticación

PATCH /api/v1/perfil/:perfilId/contacto
Authorization: Bearer {token}
Content-Type: application/json

{
  "telefono": "+52 55 9999 0000",
  "email": "nuevo@email.com"
}