Importar desde CSV

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

Cuándo Usar Importación CSV

La Importación CSV es ideal cuando:

Migras desde otro sistema
Tienes datos de empleados en Excel o Google Sheets
Añades un equipo grande 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 múltiples pasos:

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

Importación Paso a Paso

Navegar a Trabajadores

Ve a Recursos → Trabajadores en el menú lateral.

Hacer Clic en Importar CSV

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

Descargar la Plantilla

En el modal que se abre, descarga la plantilla para ver el formato requerido:

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

Preparar Tu Archivo CSV

Abre la plantilla y añade los datos de tus trabajadores.

Campos Obligatorios:

Campo	Descripción
employee_id	Identificador único (obligatorio, debe ser único)
first_name	Nombre del trabajador (obligatorio)
last_name	Apellido del trabajador (obligatorio)

Campos Opcionales:

Campo	Descripción
email	Dirección de email
phone	Número de teléfono
hire_date	Fecha de contratación (formato AAAA-MM-DD)
employment_type	Tiempo Completo, Parcial, etc.
status	Activo o Inactivo

Si el estado no se especifica, por defecto es “Activo”.

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

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

Los campos obligatorios están presentes
Los IDs de empleado 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 y Confirmar

Revisa lo que se importará y confirma. Los trabajadores importados exitosamente aparecerán en la tabla de trabajadores.

Ejemplo de Formato CSV

Tu CSV debería verse así:


employee_id,first_name,last_name,email,phone,status
EMP001,Juan,García,juan@finca.com,+34612345678,Activo
EMP002,María,López,maria@finca.com,+34612345679,Activo
EMP003,Pedro,Martínez,,,Activo

Reglas de Importación

Regla	Descripción
IDs únicos	Los IDs de empleado deben ser únicos dentro de tu organización
Campos obligatorios	employee_id, first_name y last_name son siempre obligatorios
Formato de archivo	Solo se aceptan archivos .csv
Estado por defecto	El estado por defecto es “Activo” si no se especifica

Manejo de Errores

Si tu importación tiene errores:

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

Errores comunes:

Campo obligatorio faltante — Añade la columna employee_id, first_name o last_name
ID duplicado — Cambia el ID de empleado para que sea único
Formato de fecha inválido — Usa formato AAAA-MM-DD para hire_date

Consejos para una Importación Exitosa

Limpia Tus Datos Primero

Antes de importar:

Elimina filas vacías
Asegúrate de que los IDs de empleado sean únicos
Revisa la ortografía de los nombres
Formatea los números de teléfono consistentemente

Usa 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 trabajadores, prueba primero con un lote pequeño para verificar que el formato funciona correctamente.

Próximos Pasos

Ver Trabajadores — Ver tu equipo importado
Editar y Eliminar — Añadir más detalles a trabajadores importados
Añadir Trabajadores — Añadir trabajadores individuales con detalles completos