Importar en bloque — traer sus datos desde CSV

La función Importar en bloque de Habitia trae todo un portafolio desde archivos CSV en una sola sesión — útil cuando se están mudando de una hoja de cálculo, otra herramienta o registros en papel. El proceso corre en un orden fijo, y cada paso hace referencia a los nombres del paso anterior.

Nota: Solo los roles admin y gerente ven la página de Importar en bloque.

Cuándo usar Importar en bloque

Cuando se están cambiando a Habitia desde una hoja de cálculo u otra herramienta.
Cuando tienen más de 10 propiedades o más de 20 unidades, y agregarlas una por una tomaría todo el día.
No para el día a día — una vez configurados, usen los botones regulares de Agregar.

1. Abran la página de Importar en bloque

Desde el menú lateral, hagan clic en Importar en bloque (icono de subida). La página los lleva por cinco tipos de entidad en un orden fijo:

propiedades → unidades → espacios → activos → contratos

Cada paso depende del anterior, así que el orden importa.

2. Descarguen la plantilla CSV

Cada tarjeta de entidad tiene un botón Descargar plantilla. Hagan clic — recibirán un archivo <entidad>_template.csv con la fila de encabezados que Habitia espera, más una fila de comentarios con pistas para cada columna.

Ábranlo en Numbers, Excel, Google Sheets — lo que usen.

Consejo: No renombren ni eliminen las columnas del encabezado. Habitia identifica los campos por el nombre del encabezado. Si borran o cambian un encabezado, ese campo no se va a importar.

3. Llenen sus datos

Algunas reglas por fila:

Propiedades primero. Requerido. Cada CSV posterior hace referencia a las propiedades por nombre. Usen nombres que reconozcan (“Calle Luna 12” funciona; “Propiedad A” no).
Las unidades hacen referencia a la propiedad por su nombre exacto. Igualen mayúsculas y ortografía.
Espacios y activos son opcionales. Sálten estos pasos si no llevan control de habitaciones o electrodomésticos individualmente.
Los contratos crean inquilinos automáticamente. Si un inquilino en su CSV todavía no existe en Habitia, se crea a partir del correo y el nombre. No tienen que importar inquilinos por separado.

4. Suban un CSV a la vez

Guarden el CSV con los datos.
En la página de Importar en bloque, hagan clic en Subir CSV debajo de la tarjeta de la entidad correspondiente.
Esperen. Verán uno de dos resultados:
- N filas importadas (check verde) — éxito.
- N filas omitidas (triángulo naranja) — algunas filas fallaron la validación. La página se expande para mostrar cada error con número de fila, nombre del campo y mensaje. Arreglen el CSV y vuelvan a subir — Habitia salta las filas que ya existen, así que pueden volver a subir el archivo completo sin problema.

Nota: Cada subida es de compromiso parcial. Las filas válidas se insertan, las inválidas se omiten y se reportan. No hay reversión atómica — si 95 de 100 filas pasan, esas 95 quedan adentro.

5. Sigan a la próxima entidad

Una vez las propiedades estén adentro, hagan las unidades. Después, opcionalmente, espacios y activos. Después, contratos. Hacer las cosas fuera de orden va a generar errores, porque los CSV posteriores hacen referencia a nombres que todavía no existen.

Tamaño y formato del archivo

Máximo 5 MB por archivo (aproximadamente 50,000 filas — mucho más allá de cualquier portafolio real de un solo dueño).
Solo CSV (.csv). Los archivos de Excel no funcionan — exporten a CSV primero.
UTF-8 es lo más seguro. Si su CSV tiene acentos o ñ, guárdenlo como UTF-8 para que los caracteres sobrevivan la subida.

Errores comunes y cómo arreglarlos

Mensaje de error	Qué significa
”Property not found”	El nombre de la propiedad en esta fila no coincide con ninguna propiedad que hayan importado. Revisen ortografía y mayúsculas.
”Required field missing”	Una columna requerida está en blanco. La fila de comentarios de la plantilla marca cuáles campos son requeridos.
”Invalid date”	La fecha no está en formato `YYYY-MM-DD`. Usen `2026-05-12`, no `5/12/26`.
”Unit already exists”	Ese número de unidad ya existe en esa propiedad. Habitia salta el duplicado.

Próximo paso

Agregar una propiedad — para agregar más después de terminar la importación.
Enviar un contrato para firma — para los contratos que entraron en borrador y ahora necesitan firmas.