> For the complete documentation index, see [llms.txt](https://help.steeple.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.steeple.com/es/administration/import-collaborateurs.md).

# ¿Cómo importar colaboradores en masa?

### Presentación

La función de importación permite añadir o sincronizar colaboradores en masa a partir de un archivo, sin tener que añadirlos uno por uno.

### Funcionamiento

#### Paso 1 — Historial de tratamientos

Desde la administración de colaboradores, acceda a la página **Importación** que enumera el historial de sincronizaciones anteriores.

#### Paso 2 — Elegir el tipo de importación

Seleccione el tipo de operación: **alta**, **eliminación** o **sincronización espejo**.

#### Paso 3 — Cargar el archivo

Cargue el archivo Excel o CSV que contiene a los colaboradores.

#### Paso 4 — Consultar las alertas

El sistema analiza el archivo y muestra un informe de **alertas** sobre las anomalías detectadas (líneas no válidas, campos faltantes, etc.).

#### Paso 5 — Verificar el análisis

Un informe de **análisis** detalla las operaciones que se ejecutarán (creaciones, actualizaciones, eliminaciones).

#### Paso 6 — Iniciar la ejecución

Valide para lanzar el  **runner** que aplica las operaciones. El estado se actualiza en directo.

#### Tipos de operaciones

* **Alta** (upsert) : crear nuevos colaboradores o actualizar los existentes
* **Eliminación** (delete) : retirar colaboradores
* **Sincronización espejo** (mirror) : reemplazar la lista completa — los colaboradores ausentes del archivo son retirados

#### Modo de prueba (dry run)

Es posible iniciar una simulación antes de ejecutar realmente los cambios. El modo de prueba muestra un informe de las operaciones previstas sin aplicarlas.

La simulación se convierte en **obligatorio** para un archivo que asigna o modifica un identificador de inicio de sesión: es el único lugar donde se ve, antes de la ejecución, cuántas direcciones de correo dejan de ser identificadores.

#### Colaboradores sin dirección de correo electrónico

La plantilla contiene una columna **Identificador** y una columna **Código PIN TV**, junto a la columna **Correo electrónico**. Permiten importar colaboradores que no tienen una dirección de correo profesional.

* Cada línea debe contener al menos un identificador: una dirección de correo electrónico o un identificador de inicio de sesión.
* Una línea que asigna un identificador de inicio de sesión sin dirección de correo electrónico debe contener un código de 4 cifras, de lo contrario el colaborador no tendría ningún medio para activar su cuenta.
* Un mismo identificador no puede aparecer dos veces en el archivo.

Las líneas que no respeten estas reglas se señalan en el informe de alertas, antes de cualquier escritura: el archivo no se ejecuta mientras no hayan sido corregidas. Ver [¿Cómo añadir un colaborador sin dirección de correo electrónico?](/es/administration/collaborateur-sans-email.md).

#### Seguimiento de mensajes

Cada operación de sincronización genera mensajes de seguimiento que indican el resultado para cada colaborador (éxito, error, etc.).

### Alternativa: aprovisionamiento SCIM

Para una sincronización automática y continua con un directorio empresarial (Azure Active Directory, Okta, etc.), consulte el artículo "Aprovisionamiento automático de colaboradores (Provisioning / SCIM)".

### Lo que el asistente puede hacer

El asistente no puede iniciar una importación masiva. Puede explicar el funcionamiento y orientar hacia la interfaz de administración. Con el ámbito Administración, el asistente puede añadir colaboradores uno por uno.
