Importación Masiva de Propiedades

La importación masiva te permite cargar decenas o cientos de propiedades desde un archivo Excel o CSV en minutos, ideal para migrar inventario de otros sistemas o capturar listados existentes.

Flujo de Importación

graph TD
    A[Descargar Plantilla] --> B[Llenar Datos]
    B --> C[Subir Archivo]
    C --> D{Validación}
    D -->|Errores| E[Corregir en Editor]
    D -->|OK| F[Vista Previa]
    E --> D
    F --> G[Confirmar Importación]
    G --> H[Propiedades Creadas]

Pasos para Importar

1. Descargar la Plantilla

Ve a Propiedades → Importar
Haz clic en "Descargar Plantilla Excel"
Recibirás un archivo .xlsx con todas las columnas configuradas

2. Llenar la Plantilla

La plantilla incluye 27 campos organizados por categoría:

Campo	Descripción	Requerido	Ejemplo
`titulo`	Nombre de la propiedad	✅ Sí	Casa en Polanco
`tipo_propiedad`	Tipo de inmueble	✅ Sí	casa, departamento, terreno, oficina, local
`tipo_operacion`	Tipo de operación	✅ Sí	venta, renta
`precio`	Precio del inmueble	✅ Sí	2500000
`moneda`	Moneda del precio	No (MXN default)	MXN, USD
`descripcion`	Descripción detallada	No	Hermosa casa con acabados...
`estado`	Estado/Provincia	✅ Sí	Jalisco
`municipio`	Municipio/Delegación	✅ Sí	Guadalajara
`colonia`	Colonia/Barrio	No	Providencia
`direccion`	Dirección completa	No	Av. México 2534
`codigo_postal`	CP del inmueble	No	44630
`latitud`	Coordenada latitud	No	20.6736
`longitud`	Coordenada longitud	No	-103.3680
`recamaras`	Número de recámaras	No	3
`banos`	Baños completos	No	2
`medios_banos`	Medios baños	No	1
`estacionamientos`	Lugares de estacionamiento	No	2
`area_construida`	M² construidos	No	250
`area_total`	M² totales	No	300
`area_terreno`	M² de terreno	No	150
`antiguedad`	Años de antigüedad	No	5
`amueblada`	Si está amueblada	No	si, no
`uso_profesional`	Permite uso de oficina	No	si, no
`amenidades`	Lista separada por comas	No	alberca, gym, roof garden
`notas_privadas`	Notas internas	No	Propietario viaja...
`url_tour_virtual`	URL del tour 360°	No	https://tour.com/abc
`url_video`	URL de video YouTube	No	https://youtube.com/watch?v=...

3. Subir el Archivo

Haz clic en "Seleccionar Archivo" o arrastra tu archivo
Formatos aceptados: .xlsx, .xls, .csv
Tamaño máximo: 10MB (aproximadamente 5,000 propiedades)

4. Validación y Corrección

sequenceDiagram
    participant U as Usuario
    participant S as Sistema
    participant V as Validador

    U->>S: Sube archivo
    S->>V: Procesa filas
    V-->>S: Reporte de errores
    S-->>U: Muestra tabla de validación

    alt Hay errores
        U->>S: Corrige en editor inline
        S->>V: Re-valida fila
    end

    U->>S: Confirma importación
    S-->>U: Propiedades creadas

El sistema valida cada fila y muestra:

✅ Verde: Fila válida, lista para importar
⚠️ Amarillo: Advertencias (campos opcionales faltantes)
❌ Rojo: Errores que impiden la importación

Puedes corregir errores directamente en la tabla sin necesidad de volver a subir el archivo.

5. Confirmar Importación

Una vez validadas todas las filas:

Revisa el resumen de propiedades a crear
Haz clic en "Importar [N] Propiedades"
El proceso se ejecuta en segundo plano
Recibirás una notificación al completarse

Reglas de Validación

Campo	Regla	Mensaje de Error
titulo	Mínimo 10 caracteres	"Título demasiado corto"
precio	Número positivo	"Precio debe ser mayor a 0"
tipo_propiedad	Valor de la lista permitida	"Tipo no reconocido"
estado	Debe existir en catálogo	"Estado no encontrado"
latitud/longitud	Formato decimal válido	"Coordenadas inválidas"
area_*	Número positivo	"Área debe ser positiva"

Tips para una Importación Exitosa

💡 Consejo: Si tienes propiedades de más de una operación (venta + renta), crea dos filas con el mismo inmueble pero diferente tipo_operacion.

📍 Ubicación: Si no tienes coordenadas, llena al menos estado, municipio y colonia — el sistema intentará geocodificar automáticamente.

🖼️ Imágenes: La importación masiva no incluye imágenes. Después de importar, usa el editor de cada propiedad para agregar fotos.

Preguntas Frecuentes

¿Puedo importar propiedades con imágenes?

No directamente. Las imágenes deben agregarse manualmente después de la importación o mediante la API.

¿Qué pasa si una fila tiene errores?

Solo se importan las filas válidas. Puedes corregir las filas con errores y volver a procesarlas.

¿Se duplican propiedades si importo el mismo archivo?

Sí, el sistema no detecta duplicados automáticamente. Revisa tu inventario antes de importar.

¿Puedo agregar amenidades personalizadas?

Sí, separa las amenidades con comas. Las nuevas se agregarán al catálogo de tu agencia.