Importar CSV
Importe múltiples propiedades de forma masiva desde un archivo CSV con validación automática y mapeo de columnas.
Importar CSV
Si tiene un inventario existente de propiedades en una hoja de cálculo, puede importarlas masivamente a Trochai usando un archivo CSV. La herramienta de importación valida los datos automáticamente, le muestra una vista previa y reporta cualquier error encontrado.
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á un diálogo con las opciones de importación.
Preparar el archivo CSV
Formato del archivo
El archivo debe ser un archivo CSV estándar (valores separados por comas) con las siguientes características:
- Primera fila --- Encabezados de columna (nombres de campos)
- Filas siguientes --- Datos de propiedades, una propiedad por fila
- Codificación --- UTF-8 (la codificación estándar de la mayoría de hojas de cálculo)
- Extensión ---
.csv
Columnas soportadas
La herramienta de importación reconoce las siguientes columnas. Los nombres de encabezado son flexibles y aceptan variaciones comunes:
| Campo | Encabezados aceptados | Obligatorio | Tipo | Valores válidos |
|---|---|---|---|---|
| Tipo de listado | listing_type, listing_types, type | Sí | Texto | rent, sale (separar múltiples con ;) |
| Categoría | category | Sí | Texto | apartment, house, land, commercial |
| Precio | price | Sí | Número | Mayor a 0 |
| Moneda | currency | No | Texto | USD, CRC (defecto: USD) |
| Estado | status | No | Texto | active, paused, sold, rented (defecto: active) |
| Slug | slug | No | Texto | Se auto-genera si no se proporciona |
| Provincia | province | No | Texto | Texto libre |
| Cantón | canton | No | Texto | Texto libre |
| Distrito | district | No | Texto | Texto libre |
| Referencias | landmarks | No | Texto | Texto libre |
| Depósito | deposit | No | Número | Monto numérico |
| Cuota mantenimiento | hoa_fee, hoafee | No | Número | Monto numérico |
| Habitaciones | bedrooms, beds | No | Entero | Número entero >= 0 |
| Baños | bathrooms, baths | No | Entero | Número entero >= 0 |
| Parqueos | parking_spots, parking | 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 | No | Texto | Separadas por ; |
| Pet friendly | pet_friendly, petfriendly | No | Booleano | true, 1, yes, si |
| Amueblado | furnished | No | Booleano | true, 1, yes, si |
| Disponibilidad | availability | No | Booleano | true, 1, yes, si |
| Fecha disponible | available_date, availabledate | No | Texto | Formato de fecha |
| Descripción | short_description, description | No | Texto | Texto libre |
| 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. Lo mismo aplica para las amenidades: pool;gym;security_24_7.
Proceso de importación
Paso 1: Seleccionar archivo
Haga clic en Seleccionar archivo y elija su archivo CSV. Solo se aceptan archivos con extensión .csv.
Paso 2: Vista previa
Después de seleccionar el archivo, la herramienta muestra una vista previa de los datos:
- Los encabezados detectados aparecen como columnas de la tabla
- Se muestran las primeras 5 filas de datos para que usted verifique que el mapeo es correcto
- Campos vacíos se muestran como "---"
Revise la vista previa para asegurarse de que los datos se ven correctos antes de continuar.
Paso 3: Importar
Haga clic en el botón Importar CSV para iniciar la importación. La herramienta procesará cada fila del archivo.
Paso 4: Resultados
Después de la importación, verá un resumen con:
- Propiedades importadas --- Número de propiedades creadas exitosamente (badge verde)
- Propiedades omitidas --- Número de filas que no pudieron importarse por errores (badge gris)
- Lista de errores --- Si hubo errores, se muestra el número de fila, el campo con error y un mensaje descriptivo
Mapeo automático de columnas
La herramienta mapea automáticamente los encabezados de su CSV a los campos de Trochai. El mapeo es flexible y acepta variaciones comunes:
listing_type,listing_types,listingtype,typese mapean al tipo de listadobedrooms,bedsse mapean al número de habitacionesbathrooms,bathsse mapean al número de bañosparking_spots,parkingspots,parkingse mapean a los parqueosshort_description,shortdescription,descriptionse mapean a la descripción
Los encabezados que no coinciden con ningún campo conocido se ignoran silenciosamente.
Validación de datos
La herramienta valida cada fila individualmente:
| Validación | Descripción |
|---|---|
| Campos obligatorios | listing_type, category y price deben estar presentes |
| Tipo de listado | Debe ser rent, sale o ambos |
| Categoría | Debe ser apartment, house, land o commercial |
| Estado | Si se proporciona, debe ser active, paused, sold o rented |
| Precio | Debe ser un número mayor a 0 |
| Campos numéricos | Habitaciones, baños, áreas, etc. deben ser números válidos |
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 | active |
| Moneda | USD |
Mejores prácticas
- Verifique la vista previa antes de importar. Si los datos no se ven bien, revise su archivo CSV.
- 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,gym,security_24_7) para mejor integración con el bot. Vea la lista completa en Amenidades. - Exporte desde su hoja de cálculo usando la opción "Guardar como CSV" o "Exportar a CSV".
- Corrija los errores reportados y vuelva a importar solo las filas que fallaron si es necesario.
Las propiedades importadas por CSV se crean sin fotos. Después de la importación, puede editar cada propiedad individualmente para agregar fotos.