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í.
sector	Sector del puesto. Solo hace falta cuando el mismo nombre de puesto existe en más de un sector; en ese caso indica cuál asignar.
area	Área del sector. Solo se usa para desempatar si el mismo puesto existe en varios sectores con el mismo nombre.
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 el mismo nombre de puesto existe en varios sectores (por ejemplo, "Administrativo" en RRHH y en Operaciones), la fila debe indicar el sector en la columna sector para que el sistema sepa cuál asignar; de lo contrario se reporta como inválida.

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 → Más → Cargar empleados desde CSV.

2. (Opcional) Descargá la plantilla CSV con los encabezados correctos. Es el primer paso que más errores evita.

3. Seleccioná tu archivo y hacé clic en Validar archivo. Todavía no se crea nada.

4. El sistema procesa el archivo y muestra el reporte de validación con tres números:

   • Filas válidas: cuántas pasaron todas las validaciones y están listas para importar.
   • Con errores: cuántas quedarían afuera.
   • Total en el archivo: cuántas filas se leyeron, sin contar el encabezado.

Si no estás seguro de qué columnas lleva el archivo, la página las lista: abrí Columnas que espera el archivo, debajo de la zona de carga.

Reporte de validación

El reporte agrupa los errores por causa: si a veinte filas les falta el nombre, eso se dice una vez y al lado van los veinte números de 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.
• 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.
• Puesto 'X' existe en varios sectores; indicá el sector (columna sector) — hay más de un puesto con ese nombre y la fila no dice de qué sector es.

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".

Descargar sólo las filas con errores

El botón Descargar filas con errores te devuelve un CSV con únicamente esas filas y una columna errores al final que dice qué corregir en cada una. Trae todas las columnas de la plantilla, así que lo corregís ahí mismo y lo volvés a subir tal cual, sin tener que buscar los números de fila en el archivo original.

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. Podés cerrarla: la importación sigue y el resultado queda en el historial.

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 → Más → Historial de importaciones (o la URL /admin/csv_imports) podés:

• Ver todas las cargas previas con el nombre del archivo, la fecha, quién la hizo, el estado y el resultado.
• 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, y volver a descargar sus filas con errores.

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

El historial de EPP usa el mismo pipeline

La importación de entregas de EPP documentadas en papel (el historial previo a usar SafetyPanel) funciona exactamente igual: se valida el archivo entero, se agrupan los errores por causa y recién después se importa. Se entra desde Empleados → Más → Cargar historial de EPP, y sus columnas son documento, categoria y fecha como obligatorias. Ver Entrega de EPP.

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.