🔐 Autenticación

Todos los endpoints (excepto /api/auth/login) requieren un token. Enviar como header Authorization: Bearer <TOKEN>. El token NO se envía por query param.

GET /api/direccion?q=

Geocodifica una dirección física y devuelve el padrón exacto si el punto cae dentro de uno. Si cae en la vía pública, devuelve padrones cercanos. Enriquecida con Location Intel (coordenadas, datos catastrales, normativa urbanística IM, riesgos, infraestructura y equipamientos cercanos: paradas de ómnibus, escuelas primarias, liceos y UTU).

GET /api/padron?q=&depto=

Busca un padrón por su número exacto (todas las coincidencias, con detalle enriquecido). Devuelve además nearby_services: los equipamientos más cercanos a las coordenadas del padrón.

GET /api/services?lng=&lat=&radius=&limit=

Equipamientos cercanos a un punto arbitrario (paradas de ómnibus, escuelas ANEP, liceos, UTU) vía WFS de la Intendencia de Montevideo, ordenados por distancia. Independiente de la búsqueda: ideal para integrar con las coordenadas de cualquier inmueble.

GET /api/location-intel?address=&city=

Technical Due Diligence territorial: geolocaliza una dirección cruzando IDE Uruguay, Catastro WFS, normativa urbanística IM (barrio, FOS, altura, patrimonio), riesgos de inundabilidad e infraestructura de saneamiento, más equipamientos cercanos.

GET /api/search?q=&depto=&loc=®imen=

Búsqueda parcial de un padrón (coincidencia de texto) o filtrado avanzado combinando: min_ae/max_ae (área edificada), min_ap/max_ap (área predio), min_uc/max_uc (unidades), min_val_m/max_val_m (valor m²), depto, loc, regimen. Paginación con limit (default 20, máx 100) y offset.

GET /api/valuation?padron=

Tasación AVM del padrón. Parámetros opcionales: depto, loc, barrio, area_predio, area_edificada, valor_m2_catastral, fos, max_height_m, custom_market_m2, unidad, regimen.

GET /api/market-comparables?padron=&portal=&modo=

Comparables de mercado en tiempo real desde InfoCasas, VeoCasas y RE/MAX, en venta o alquiler, filtrados por zona y superficie comparable (m² construidos y m² fondo), con distancias al padrón objetivo, puntaje de similitud, $/m² y tasación sugerida por mediana de la zona. Con cap_rate=true agrega la rentabilidad bruta de la zona. Fuentes públicas en vivo (sin auth).

{
  "padron": 56144, "depto": "V", "zone": "Prado",
  "operation": "sale", "property_type": "casa",
  "target_area_edificada": 204, "target_area_predio": 289,
  "summary": {
    "total_listings": 50,
    "avg_price_usd": 364476, "avg_area_m2": 214,
    "median_price_m2_usd": 1615, "avg_price_m2_usd": 1724,
    "min_price_m2_usd": 989, "max_price_m2_usd": 4354,
    "confidence": "alta",
    "suggested_valuation_usd": 329460,        // mediana $/m² × área objetivo
    "suggested_valuation_avg_usd": 351696,    // promedio $/m² × área objetivo
    "valuation_range_usd": { "min": 289925, "max": 393900 },
    "by_portal": { "infocasas_count": 34, "veocasas_count": 13, "remax_count": 3,
                   "infocasas_median_m2": 1741, "veocasas_median_m2": 1672, "remax_median_m2": 1580 },
    "cap_rate": { "gross_yield_pct": 8.62, "median_sale_m2_usd": 1615, "median_rent_m2_usd": 11.6 }
  },
  "results": [{
    "portal": "remax", "operation": "sale", "id": "193276177", "title": "...",
    "price_usd": 310000, "price_m2_usd": 2480,
    "area_built": 125, "area_land": 205,
    "property_type": "casa", "bedrooms": 3, "bathrooms": 2,
    "neighborhood": "Prado", "lat": -34.86, "lng": -56.19,
    "distancia_m": 124, "similitud": 64, "listing_url": "https://..."
  }]
}

GET /api/refdata/*

Datos de referencia de padrones desde informes-refdata (fuente pública complementaria): dirección → padrón, superficies, geometría y áreas administrativas (barrio, CCZ, seccional).

GET /api/report?padron=&format=pdf|json

Informe completo en una llamada: AVM + catastro + comparables (con cap rate) + potencial + valor residual del terreno + score de inversión 0–100 + location intel. format=json devuelve todo estructurado para poblar los informes de Evaluaprop.

GET /api/comparables?padron=&limit=

Comparables catastrales DNC: padrones vecinos del mismo depto/localidad/régimen con área edificada dentro de ±40% del objetivo, con su valor m² catastral y distancia.

GET /api/indicadores?depto=&loc=

Indicadores agregados de una zona: cantidad de padrones, mediana de valor m², % de propiedad horizontal y áreas promedio.

GET /api/permisos?padron=

Permisos de construcción aprobados por la Intendencia de Montevideo asociados al padrón (destino, área, calle, año, expediente, tipo de obra).

GET /api/construcciones?padron=&unidad=

Líneas de construcción DNC del padrón (y opcionalmente de una unidad), con destino, categoría, estado, tipo de obra y área construida ya decodificados a etiquetas humanas.

GET /api/smart-search?q=

Búsqueda inteligente que detecta el tipo de consulta (padrón, dirección, coordenadas o filtros) y devuelve el resultado apropiado con resumen en lenguaje natural.

GET /api/reverse?lng=&lat=

Recibe coordenadas de longitud y latitud y devuelve el padrón que contenga dicho punto (reverse geocoding catastral).

GET /api/nearby?lng=&lat=&radius=&limit=

Devuelve las parcelas catastrales más cercanas a un punto central dado un radio en metros (default 100) y un límite de resultados (default 10).

GET /api/filters?depto=

Devuelve la lista de departamentos y localidades disponibles en la base de datos.

GET /api/planos

Planos asociados a un padrón. Requiere todos los parámetros: depto_nombre, padron, regimen, depto, loc, loc_nombre.

GET /api/suggest?q=

Autocompletado de direcciones usando el nomenclátor oficial de IDE Uruguay (calles y cruces).

GET /api/planos → respuesta

Estructura de respuesta de equipamientos cercanos (nearby_services en /api/direccion, /api/padron, /api/location-intel y /api/services):

{
  "services": [
    {
      "type": "parada_omnibus" | "escuela_primaria" | "liceo" | "utu",
      "nombre": "Av. Italia y Calle 1",
      "direccion": "Av. Italia 6200",
      "distancia_m": 120
    }
  ],
  "error": false,
  "message": null
}