Importar CSV
Importe múltiples propiedades de forma masiva desde un archivo CSV con mapeo de columnas, validación previa y opción de deshacer.
Importar CSV
Si tiene un inventario existente de propiedades en una hoja de cálculo, puede importarlas masivamente a Trochai usando un archivo CSV. El asistente de importación le guía paso a paso: mapea columnas, valida los datos antes de importar, y le permite deshacer la importación si es necesario.
La importación de CSV está disponible únicamente para usuarios con rol de administrador. Los agentes y observadores no pueden importar propiedades.
Acceder a la importación
Navegue a Propiedades en el menú lateral.
Haga clic en el botón Importar CSV junto al botón de agregar propiedad.
Se abrirá el asistente de importación en un diálogo de 3 pasos.
Preparar el archivo CSV
Formato y límites del archivo
| Requisito | Valor |
|---|---|
| Formato | CSV (valores separados por comas) |
| Primera fila | Encabezados de columna (nombres de campos) |
| Codificación | UTF-8 (compatible con exportaciones de Excel) |
| Extensión | .csv |
| Tamaño máximo | 2 MB |
| Filas máximas | 1,000 propiedades por archivo |
Descargar plantilla
Dentro del asistente, puede descargar una plantilla CSV con las columnas más comunes y 2 propiedades de ejemplo. Use esta plantilla como punto de partida para preparar su archivo.
Columnas soportadas
La herramienta reconoce las siguientes columnas. Los nombres de encabezado son flexibles y aceptan variaciones en español e inglés:
| Campo | Encabezados aceptados | Obligatorio | Tipo | Valores válidos |
|---|---|---|---|---|
| Tipo de listado | listing_type, listing_types, type, tipo, tipo_listado | Sí | Texto | rent/alquiler/renta, sale/venta (separar múltiples con ;) |
| Categoría | category, categoria | Sí | Texto | apartment/apartamento/apto, house/casa, land/terreno/lote, commercial/comercial |
| Precio | price, precio | Sí | Número | Mayor a 0 |
| Título | title, titulo | No | Texto | Máximo 200 caracteres |
| Moneda | currency, moneda | No | Texto | USD, CRC (defecto: USD) |
| Estado | status, estado | No | Texto | active, paused, sold, rented, draft, archived (defecto: draft) |
| Provincia | state, province, provincia | No | Texto | Texto libre |
| Cantón | city, canton | No | Texto | Texto libre |
| Distrito | neighborhood, district, distrito, zona | No | Texto | Texto libre |
| Referencias | landmarks, referencias | No | Texto | Texto libre |
| Depósito | deposit, deposito | No | Número | Monto numérico |
| Cuota mantenimiento | hoa_fee, hoafee | No | Número | Monto numérico |
| Habitaciones | bedrooms, beds, habitaciones, dormitorios | No | Entero | Número entero >= 0 |
| Baños | bathrooms, baths, banos | No | Entero | Número entero >= 0 |
| Parqueos | parking_spots, parking, parqueos, estacionamientos | No | Entero | Número entero >= 0 |
| Área construida | built_area_m2, builtarea | No | Número | Metros cuadrados |
| Área de terreno | land_area_m2, landarea | No | Número | Metros cuadrados |
| Amenidades | amenities, amenidades | No | Texto | Separadas por ; (acepta nombres en español, ej: piscina → pool) |
| Pet friendly | pet_friendly, petfriendly | No | Booleano | true, 1, yes, si, sí, verdadero |
| Amueblado | furnished, amueblado | No | Booleano | Mismos valores booleanos |
| Disponibilidad | availability, disponibilidad | No | Booleano | Mismos valores booleanos |
| Fecha disponible | available_date, availabledate | No | Texto | Formato de fecha |
| Descripción | short_description, description, descripcion | No | Texto | Máximo 5,000 caracteres |
| URL de video | video_url, videourl | No | Texto | URL completa |
| URL de tour 3D | tour_3d_url, tour3durl | No | Texto | URL completa |
Ejemplo de CSV
listing_type,category,price,currency,province,canton,district,bedrooms,bathrooms,amenities,description
sale,apartment,150000,USD,San Jose,Escazu,San Rafael,2,2,pool;gym;security_24_7,Apartamento moderno con vista al valle
rent,house,1200,USD,Heredia,Belen,La Asuncion,3,2,gardens;parking,Casa amplia en residencial tranquilo
sale;rent,commercial,250000,USD,San Jose,Santa Ana,Pozos,0,1,elevator;lobby,Local comercial en centro empresarialPara propiedades con múltiples tipos de listado (venta y alquiler), separe los valores con punto y coma (;), por ejemplo: sale;rent o venta;alquiler. Lo mismo aplica para las amenidades.
Proceso de importación
Paso 1: Subir archivo y mapear columnas
Suba su archivo CSV arrastrándolo al área indicada o haciendo clic para seleccionarlo. Solo se aceptan archivos .csv de hasta 2 MB y 1,000 filas.
La herramienta detecta automáticamente los encabezados y los mapea a los campos de Trochai. Para cada columna, verá los primeros 3 valores de ejemplo.
Revise y ajuste el mapeo si es necesario. Cada columna tiene un desplegable donde puede cambiar a qué campo de Trochai se mapea, o seleccionar "Omitir" para ignorar esa columna.
El mapeo automático es inteligente: normaliza los encabezados (ignora mayúsculas, espacios, guiones y acentos) y reconoce nombres en español e inglés.
No puede mapear dos columnas de su CSV al mismo campo de Trochai. Si lo intenta, el duplicado se resaltará en rojo y verá el mensaje "Este campo ya está mapeado a otra columna".
Si selecciona Omitir en una o más columnas, aparecerá una advertencia ámbar listando exactamente qué columnas no se importarán. Esto evita perder datos por accidente.
Paso 2: Revisar e importar
Al avanzar al paso 2, la herramienta ejecuta automáticamente una validación previa (dry-run) de todos los datos sin escribir nada en la base de datos:
- Filas válidas (badge verde): cantidad de propiedades que pasaron todas las validaciones
- Filas con errores (badge rojo): cantidad de filas con problemas
- Vista previa: las primeras filas válidas transformadas, para que vea cómo se verán en Trochai
Edición inline de errores
En lugar de tener que volver a editar el CSV en su computadora, ahora puede corregir los errores directamente desde el asistente. Cada fila con errores aparece como una tarjeta contextual que muestra:
- Número de fila, título de la propiedad, categoría, tipo de listado y ubicación (provincia, cantón, distrito)
- Un campo de entrada por cada propiedad con error, con el valor actual ya cargado
- Los mensajes de error agrupados por campo (si un campo tiene varios errores, se concatenan separados por
·)
Edite los valores directamente en los campos de la tarjeta. Los cambios se marcan como "sin guardar".
Cuando termine, haga clic en Re-validar (aparece en la barra inferior) para volver a ejecutar la validación con sus correcciones.
Si quedan errores, repita el proceso. Cuando todas las filas estén válidas, haga clic en Importar.
La barra de navegación inferior (Atrás, Cerrar, Re-validar, Importar) es fija mientras se desplaza por las tarjetas, así que siempre tiene los botones a la mano. El diálogo también es más ancho para que las tarjetas de error sean más cómodas de revisar.
Las filas con errores se omiten automáticamente al importar, pero lo ideal es corregirlas inline antes de continuar.
Paso 3: Resultados
Después de la importación, verá un resumen con:
- Importadas (badge verde): cantidad de propiedades creadas exitosamente
- Omitidas (badge gris): filas que no se pudieron importar
- Errores (badge rojo): filas con errores de validación
Desde esta pantalla tiene dos opciones:
- Deshacer Importación: eliminar todas las propiedades recién importadas
- Cerrar: cerrar el asistente y volver a la lista de propiedades
Deshacer importación
Si detecta un error después de importar, puede deshacer toda la importación desde la pantalla de resultados (Paso 3). Esto elimina permanentemente todas las propiedades que fueron importadas en ese lote.
La acción de deshacer no se puede revertir. Una vez eliminadas las propiedades, deberá importarlas nuevamente. Se le pedirá confirmación antes de proceder.
Validación de datos
La herramienta valida cada fila individualmente durante el dry-run:
| Validación | Descripción |
|---|---|
| Campos obligatorios | listing_type, category y price deben estar presentes |
| Tipo de listado | Debe ser rent/alquiler, sale/venta o ambos |
| Categoría | Debe ser apartment/apartamento, house/casa, land/terreno o commercial/comercial |
| Estado | Si se proporciona, debe ser active, paused, sold, rented, draft o archived |
| Precio | Debe ser un número mayor a 0 |
| Campos numéricos | Habitaciones, baños, áreas, etc. deben ser números válidos |
| Longitud de texto | Título máximo 200 caracteres, descripción máximo 5,000 caracteres |
Las filas con errores se omiten individualmente sin afectar la importación de las filas válidas.
Valores automáticos
Si ciertos campos no están presentes en el CSV, se asignan valores por defecto:
| Campo | Valor por defecto |
|---|---|
| Slug | Se genera automáticamente a partir de la categoría y el distrito |
| Estado | draft (borrador --- debe activar manualmente las propiedades) |
| Moneda | USD |
Las propiedades importadas se crean con estado borrador (draft). Revise cada propiedad y cámbiela a active cuando esté lista para que el bot la encuentre en búsquedas.
Mejores prácticas
- Use la plantilla CSV descargable como punto de partida para evitar errores de formato.
- Revise el mapeo de columnas en el Paso 1, especialmente si su hoja de cálculo tiene nombres de columna personalizados.
- Verifique la validación previa en el Paso 2 antes de importar. Corrija los errores en su CSV y vuelva a intentar.
- Incluya al menos los campos obligatorios --- tipo de listado, categoría y precio.
- Agregue ubicación y descripción siempre que sea posible para que el bot funcione correctamente.
- Use los nombres de amenidades predefinidos (como
pool/piscina,gym,security_24_7) para mejor integración con el bot. Vea la lista completa en Amenidades. - Active las propiedades después de importar --- las propiedades en estado
draftno aparecen en búsquedas del bot.
Las propiedades importadas por CSV se crean sin fotos. Después de la importación, puede editar cada propiedad individualmente para agregar fotos.