> 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 funcionalidad 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 los procesos

Desde la Administración de colaboradores, acceda a la página **Importación** que enumera el historial de las 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 — Subir el archivo

Suba el archivo Excel o CSV que contiene los colaboradores.

#### Paso 4 — Consultar las alertas

El sistema analiza el archivo y muestra un informe de**alertas** sobre las anomalías detectadas (filas 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 iniciar el **runner** que aplica las operaciones. El estado se actualiza en tiempo real.

#### 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 se eliminan

#### Modo de prueba (dry run)

Es posible lanzar 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 **obligatorio** para un archivo que asigna o modifica un identificador de inicio de sesión: es el único lugar donde ve, antes de la ejecución, cuántas direcciones de correo electrónico dejan de ser identificadores.

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

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

* Cada fila debe llevar al menos un identificador: una dirección de correo electrónico o un identificador de inicio de sesión.
* Una fila que asigna un identificador de inicio de sesión sin dirección de correo electrónico debe llevar un código de 4 cifras; de lo contrario, el colaborador no tendría ninguna forma de activar su cuenta.
* Un mismo identificador no puede figurar dos veces en el archivo.

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

#### Seguimiento de los 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 de empresa (Azure Active Directory, Okta, etc.), consulte el artículo "Aprovisionamiento automático de colaboradores (Provisioning / SCIM)".

### Lo que puede hacer el asistente

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.
