Importar desde CSV

Si tienes datos de equipamiento en hojas de cálculo, puedes importarlos directamente a Koru.Farm usando archivos CSV. Esta es la forma más rápida de migrar un inventario existente.

Cuándo Usar Importación CSV

La Importación CSV es ideal cuando:

Migras desde otro sistema
Tienes datos de equipamiento en Excel o Google Sheets
Añades un gran número de elementos a la vez
Tus datos ya están organizados en formato de hoja de cálculo

Resumen del Proceso de Importación

La importación CSV sigue un proceso de 4 pasos:

Subir CSV — Sube tu archivo
Verificación — El sistema comprueba tus datos
Comparación — Revisa lo que se importará
Importar — Añadir equipamiento a la base de datos

Importación Paso a Paso

Navegar a Equipamiento

Ve a Recursos → Equipamiento en el menú lateral.

Hacer Clic en Importar CSV

Haz clic en el botón Importar CSV (entre Creación Masiva y Añadir Equipamiento).

Descargar la Plantilla

En el modal que se abre, verás Paso 1 de 4: Subir CSV.

Primero, descarga la plantilla para ver el formato requerido:

Haz clic en Descargar Plantilla de Equipamiento Plan Simple para obtener un archivo CSV con los encabezados de columna correctos.

Preparar Tu Archivo CSV

Abre la plantilla y añade tus datos de equipamiento.

Campos Obligatorios:

Campo	Descripción
name	Nombre del equipamiento (obligatorio, debe ser único)
type	Tipo de equipamiento (obligatorio, debe coincidir con tipos configurados)

Campos Opcionales:

También puedes incluir columnas adicionales para otras propiedades del equipamiento.

Importante: El tipo de equipamiento debe coincidir con uno de los tipos configurados en Configuración → Valores Predeterminados. Los tipos comunes incluyen: Tractor, Cosechadora, Sembradora, Pulverizador, Cultivador, Riego, Herramientas Manuales, Otros.

Subir Tu Archivo CSV

Puedes subir tu archivo de dos formas:

Arrastrar y soltar — Arrastra el archivo CSV al área de carga
Clic para explorar — Haz clic en el área de carga y selecciona tu archivo

Solo se aceptan archivos CSV. Si tus datos están en formato Excel (.xlsx), expórtalos como CSV primero.

Verificar Datos (Paso 2)

Después de subir, el sistema verifica tus datos y comprueba:

Los campos obligatorios están presentes
Los tipos de equipamiento son válidos
Los nombres son únicos
El formato de datos es correcto

Si hay errores, se mostrarán para que puedas corregirlos en tu CSV y volver a subirlo.

Revisar Comparación (Paso 3)

Revisa lo que se importará:

Ver cada elemento de equipamiento que se creará
Comprobar que la información es correcta
Verificar que no existen duplicados

Completar Importación (Paso 4)

Confirma la importación para añadir todo el equipamiento a tu base de datos. Los elementos importados exitosamente aparecerán en la tabla de equipamiento.

Requisitos de Formato CSV

Columnas Obligatorias

Tu CSV debe incluir estas columnas:


name,type
Tractor John Deere,Tractor
Bomba de Riego #1,Riego
Pulverizador Manual,Pulverizador

Tipos de Equipamiento Válidos

El tipo de equipamiento debe coincidir con uno de estos valores:

Tractor
Cosechadora
Sembradora
Pulverizador
Cultivador
Riego
Herramientas Manuales
Otros

O cualquier tipo personalizado que hayas añadido en Configuración → Valores Predeterminados.

Valores Predeterminados

Estado por defecto es “operacional” si no se especifica en tu CSV
Descripción estará vacía si no se incluye

Reglas de Importación

Regla	Descripción
Nombres únicos	Los nombres de equipamiento deben ser únicos dentro de tu organización
Tipos válidos	El tipo debe coincidir con tipos de equipamiento configurados
Campos obligatorios	Nombre y tipo son siempre obligatorios
Formato de archivo	Solo se aceptan archivos .csv

Manejo de Errores

Si tu importación tiene errores:

El sistema mostrará qué está mal
Descarga o anota los errores
Corrige tu archivo CSV
Vuelve a subir el archivo corregido

Errores comunes:

Campo obligatorio faltante — Añade la columna name o type
Tipo inválido — Usa un tipo de equipamiento válido de la lista
Nombre duplicado — Cambia el nombre del equipamiento para que sea único

Consejos para una Importación Exitosa

Prepara Tus Datos Primero

Antes de importar:

Limpia los datos de tu hoja de cálculo
Asegúrate de que los nombres sean únicos y descriptivos
Haz coincidir los tipos con opciones válidas
Elimina filas vacías

Comienza con la Plantilla

Siempre descarga y usa la plantilla como punto de partida. Esto asegura que tus columnas tengan los nombres correctos.

Prueba con un Lote Pequeño

Si tienes muchos elementos, prueba primero con un lote pequeño para verificar que el formato funciona correctamente.

Próximos Pasos

Ver Equipamiento — Ver tu equipamiento importado
Editar y Eliminar — Añadir más detalles a elementos importados
Añadir Equipamiento — Añadir elementos individuales con detalles completos