HAVI Score — Descripción General

El HAVI Score es el motor de análisis crediticio de la plataforma. Utiliza inteligencia artificial (MoonshotAI + OCR con Tesseract) para analizar documentos financieros y calcular el perfil crediticio de un comprador en segundos.

¿Para qué sirve?

• Portales inmobiliarios — Mostrar al agente si un comprador realmente puede pagar la propiedad
• Instituciones financieras (CILA y similares) — Pre-calificación automática antes de un crédito hipotecario
• Agencias inmobiliarias — Filtrar prospectos y enfocar esfuerzos en compradores calificados

Flujo completo

Comprador                              Backend HAVI
    │                                       │
    ├─ POST /fase1/perfil               →   Crear perfil inicial
    │                                       │
    ├─ POST /fase2/validar/:id          →   Refinar datos (ingresos, deudas, score)
    │                                       │
    ├─ (opcional) POST /onboarding/perfil → Flujo en un solo paso
    │                                       │
    ├─ GET  /matching/:id               →   Ver propiedades compatibles
    │                                       │
    └─ POST /fase3/documentar/:id       →   Documentar interés en una propiedad

HAVI Score — Escala

Rango	Etiqueta	Riesgo	Descripción
800 – 850	Excelente	Muy bajo	Crédito preferencial, acceso a mejores tasas
740 – 799	Muy bueno	Bajo	Alta probabilidad de aprobación
670 – 739	Bueno	Moderado	Aprobación estándar
580 – 669	Regular	Alto	Requiere garantías adicionales
300 – 579	Bajo	Muy alto	Difícil acceso a crédito hipotecario

Base URL HAVI Score

https://api.havi.app/api/v1

Todos los endpoints de HAVI Score son públicos (no requieren autenticación) salvo los indicados.