Carga masiva de empleados desde CSV

La carga masiva permite dar de alta cientos de empleados a la vez a partir de un archivo CSV, sin tener que crearlos uno por uno. El proceso ocurre en dos etapas: primero se valida todo el archivo y se muestra un reporte completo de errores, y recién después se importa en segundo plano.

¿Por qué dos etapas?

Si un archivo tiene 500 filas y 6 errores, querés ver los 6 errores juntos —no uno a la vez— y poder importar las 494 filas válidas mientras corregís el resto por separado. La validación previa hace exactamente eso.

Cuándo usarla

• Onboarding de un cliente nuevo con muchos empleados.
• Migraciones desde otros sistemas.
• Altas estacionales o por nuevo contrato (transportistas, choferes, técnicos, etc.).

Para cargar uno o dos empleados, conviene usar el alta manual desde Empleados → Nuevo empleado.

Requisitos del archivo

El archivo debe ser CSV (extensión .csv). El sistema detecta automáticamente:

• Codificación: UTF-8 o ISO-8859-1 (este último es el predeterminado al exportar desde Excel en español).
• Separador: coma (,) o punto y coma (;).

Límites:

• Máximo 5 MB por archivo.
• Máximo 5000 filas por carga.

Columnas requeridas

Columna	Contenido
nombre	Nombre del empleado
apellido	Apellido
documento	DNI (debe ser único dentro de la cuenta)

Columnas opcionales

Columna	Contenido
puesto	Nombre de un puesto del catálogo o de los sitios indicados. Si existe en el catálogo pero no en el sitio, se crea automáticamente ahí.
area / sector	Agrupación organizativa opcional; solo informativa en la carga.
email	Email del empleado
password	Contraseña inicial. Si está vacía, se usa el DNI como contraseña y el empleado deberá cambiarla en su primer ingreso.
empleador	Empleador del trabajador (útil cuando se incluyen empleados de empresas tercerizadas). Si está vacío, se usa el nombre de la cuenta.
sitios	Sitios asignados al empleado, separados por | (por ejemplo taller|taller2). Cada valor debe coincidir con el identificador (slug) de un cliente o establecimiento existente. Si algún sitio no se encuentra, la fila se reporta como inválida.

Puestos

El nombre del Puesto debe coincidir con un puesto del catálogo de la cuenta o con un puesto ya existente en los sitios indicados. La comparación ignora mayúsculas y acentos. Si el nombre no se encuentra, la fila se reporta como inválida y no se importa.

Si necesitás definir puestos nuevos, hacelo en el catálogo de puestos antes de cargar el archivo. Al importar, el puesto se asigna al empleado en cada sitio indicado (columna sitios, o el sitio de la carga cuando subís el archivo desde un cliente/establecimiento).

Cómo cargar un archivo

1. Ingresá a Empleados → Cargar CSV.

2. (Opcional) Descargá la plantilla CSV con los encabezados correctos.

3. Seleccioná tu archivo y hacé clic en Cargar empleados.

4. El sistema procesa el archivo y muestra el reporte de validación:

   • Filas válidas: cuántas filas pasaron todas las validaciones.
   • Filas con errores: cuántas tienen problemas, listadas con número de fila, nombre, DNI y los errores específicos.

Reporte de validación

El reporte muestra todos los errores juntos, agrupados por fila. Algunos errores típicos:

• Nombre es obligatorio — falta el nombre.
• DNI XXXXX duplicado en el archivo (ver fila N) — el mismo DNI aparece dos veces en el archivo.
• DNI XXXXX ya está en uso — un empleado activo ya tiene ese DNI.
• DNI XXXXX pertenece a un empleado eliminado — un empleado dado de baja tiene ese DNI; restaurá el empleado original o usá un DNI distinto.
• Area 'X' no encontrada — el nombre del área no coincide con ninguno existente (solo si completaste la columna).
• Sector 'X' no encontrado — el sector no existe dentro del área indicada (solo si completaste la columna).
• Puesto 'X' no encontrado en el catálogo ni en los sitios indicados — el puesto no coincide con el catálogo ni con los puestos de los sitios.

Desde acá tenés dos opciones:

Opción A — Corregir el archivo y volver a subir

Hacé clic en Volver a subir, corregí los errores en tu CSV y subilo de nuevo. Esto es lo recomendado si los errores son pocos o si querés mantener la trazabilidad de un único archivo "limpio".

Opción B — Importar las filas válidas

Hacé clic en Importar N empleados. El sistema importa solo las filas válidas; las que tienen errores se omiten y quedan listadas en la pantalla de resultado para que las trates por separado.

Importación parcial

Cuando hay filas omitidas por validación, la importación queda marcada como parcial. La pantalla final muestra cuántos empleados se crearon y qué filas se omitieron y por qué.

Importación en segundo plano

La importación se ejecuta como tarea en segundo plano, así que el archivo puede tener cientos o miles de filas sin que el navegador se quede esperando. Mientras corre verás una barra de progreso con la fila actual sobre el total de filas válidas; la página se actualiza sola cada pocos segundos.

Solo puede haber una importación activa por cuenta a la vez. Si entrás a Cargar CSV mientras ya hay una en curso, vas a ver un aviso con un enlace al progreso de la importación activa.

Pantalla de resultado

Al finalizar, la pantalla muestra uno de estos estados:

Estado	Significado
Completada	Todas las filas válidas se importaron sin errores.
Parcial	Algunas filas se importaron y otras se omitieron por errores de validación o fallaron durante la importación. La pantalla detalla cada caso.
Falló	Hubo un error inesperado durante la importación. Las filas ya creadas quedan en la cuenta; podés consultar el detalle para ver hasta dónde llegó.

Historial de importaciones

Cada carga queda registrada. Desde Empleados → Cargar CSV → Ver historial de importaciones (o la URL /admin/csv_imports) podés:

• Ver todas las cargas previas con fecha, quién las hizo, estado y conteos.
• Abrir el detalle de cualquier carga para volver a ver el reporte de validación o el resumen de la importación, incluso meses después.

Esto es útil para auditar quién subió qué y cuándo, y para volver a consultar los errores de un archivo específico.

Buenas prácticas

• Antes de la primera carga grande, dejá listo el catálogo de puestos. Es mucho más rápido configurarlo una sola vez que corregir un CSV con cientos de errores de "Puesto no encontrado".
• Usá la plantilla CSV descargable como punto de partida —tiene los encabezados exactos.
• Verificá los DNIs duplicados antes de subir si tu archivo viene de varias fuentes (por ejemplo, planillas distintas por empleador). El reporte los detecta, pero te ahorra una vuelta extra.
• Para empleados de empresas tercerizadas, usá la columna empleador para distinguirlos. Esto facilita filtrar y reportar más adelante.