HabiKaan Iniciar sesión

Importar datos por CSV (migración)

Para
Superadmin Administración
Dónde

Inicio → Importar datos (/importar)

Estado

✅ disponible

Para qué sirve. Dar de alta mucha información de golpe cuando arrancas un condominio o migras de otro sistema, sin capturar registro por registro. Hoy se pueden importar: clusters/secciones, torres, casas, cajones, personas, dueños, ocupantes, vehículos, proveedores y saldos iniciales/cargos.

Importar por CSV: vista previa validada antes de aplicar

Pasos.

  1. Entra a Importar datos y elige la entidad (por ejemplo Casas).
  2. Pulsa ⬇︎ Plantilla CSV y ábrela en Excel o Google Sheets. Cada columna trae un ejemplo; las marcadas con * son obligatorias.
  3. Llena una fila por registro y guárdala como CSV.
  4. Sube el archivo con Subir y previsualizar. Verás una vista previa validada: cuántas filas se crearán, cuáles se omiten (ya existen o están repetidas) y cuáles tienen error (con el motivo por fila). Nada se guarda todavía.
  5. Si todo se ve bien, pulsa Confirmar e importar. Las filas con error simplemente se omiten.

Notas / reglas.

  • Respeta el orden: primero clusters y torres, luego casas y personas, y al final lo que depende de ellas (dueños, ocupantes, cajones, vehículos, saldos). Para referirte a un cluster o una torre usa su clave o nombre; a una casa, su identificador (ej. A-101); a una persona, su correo (o nombre completo) — deben existir antes. Al importar ocupantes, si la casa no tiene ocupación vigente se crea una automáticamente.
  • No duplica: si una casa/persona/proveedor ya existe (por identificador, correo o nombre) esa fila se omite, no se sobrescribe.
  • Todo se importa al condominio activo (el del selector de arriba). Si estás en vista de conjunto (varios subcondominios), cada plantilla trae una primera columna Condominio y ahí escribes a cuál va cada fila: así cargas los dos en un solo archivo. Se acepta el nombre del condominio (sin distinguir acentos ni mayúsculas) o su id, y es obligatorio — dejarlo vacío no manda la fila a ningún lado por default, porque cargar cientos de renglones en el condominio equivocado y separarlos después cuesta mucho más que capturar la columna.
  • Con la columna Condominio, todo lo demás se resuelve dentro del condominio de esa fila: la torre «A» que se busca es la del subcondominio que dice el renglón, y dos torres con el mismo nombre en subcondominios distintos se crean las dos (no se descarta la segunda como repetida).
  • Los vehículos importados quedan aprobados. Los saldos iniciales cuentan de inmediato (a menos que pongas una fecha "Cuenta desde" futura); para una cuota con periodo repetido, se omite el duplicado.
  • Formato CSV (máx. 5 MB). Si tu archivo trae columnas que no están en la plantilla, se ignoran (te avisa en la vista previa).

Preguntas frecuentes.

  • ¿Puedo deshacer una importación? No hay un “deshacer” masivo; por eso existe la vista previa — revísala antes de confirmar. Los registros quedan como cualquier alta manual (con auditoría).
  • ¿Y si me equivoco en una fila? Corrige esa fila en tu CSV y vuelve a subir: las que ya existan se omitirán y solo entrarán las nuevas.

¿Quieres ver HabiKaan en acción? Solicita una demo.