> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equinos.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Importar estudiantes desde Excel o CSV

> Registra muchos estudiantes de una vez subiendo un archivo Excel o CSV con la plantilla de Equinos.

Si ya tienes la lista de tus estudiantes en Excel, puedes cargarla de una sola vez en lugar de crearlos uno por uno.

## Abrir la importación

1. En el menú lateral, ve a **Académico** → **Estudiantes**.
2. Haz clic en **Importar**.

Se abre el panel **Importar Estudiantes**.

## Preparar el archivo

### Descargar la plantilla

En el panel, junto a **Usa nuestra plantilla**, haz clic en **Plantilla**. Se descarga `plantilla_estudiantes.xlsx` con las columnas correctas y dos filas de ejemplo.

<Note>
  Borra las filas de ejemplo de la plantilla antes de importar. Si las dejas, se crearán como estudiantes.
</Note>

### Columnas

La primera fila del archivo debe tener estos encabezados. Solo **Nombre** y **Apellido** son obligatorios.

| Columna | Obligatoria | Ejemplo |
| - | - | - |
| **Nombre** | Sí | Juan |
| **Apellido** | Sí | Pérez |
| **Email** | No | [juan@ejemplo.com](mailto:juan@ejemplo.com) |
| **Teléfono** | No | +57 300 123 4567 |
| **Género** | No | Masculino, Femenino u Otro |
| **Tipo Documento** | No | TI |
| **Número Documento** | No | 1234567890 |
| **Nivel** | No | Principiante, Intermedio, Avanzado o Profesional |
| **Contacto Emergencia - Nombre** | No | María Pérez |
| **Contacto Emergencia - Teléfono** | No | +57 300 765 4321 |
| **Contacto Emergencia - Parentesco** | No | Madre |
| **Notas** | No | Alergia al polvo |

* Si **Nivel** está vacío o no se reconoce, el estudiante queda como **Principiante**.
* Si **Género** no se reconoce, queda vacío.
* Todos los estudiantes importados quedan con estado **Activo** y reciben un código automático.

<Tip>
  Después de importar, completa la **Fecha de Nacimiento** desde la ficha de cada estudiante.
</Tip>

## Importar paso a paso

<Steps>
  <Step title="Sube el archivo">
    Arrastra el archivo a la zona de carga o haz clic en ella para seleccionarlo. Se aceptan Excel (.xlsx, .xls) o CSV de hasta 5 MB.
  </Step>

  <Step title="Revisa la vista previa">
    Verás cuántas filas y columnas se detectaron y una tabla con las primeras 10 filas. Los archivos .xls no tienen vista previa, pero se pueden importar igual. Si te equivocaste de archivo, haz clic en **Cambiar archivo**.
  </Step>

  <Step title="Importa">
    Haz clic en **Importar N registros** (o **Importar archivo** para .xls). Espera mientras aparece **Importando estudiantes...**.
  </Step>

  <Step title="Revisa el resultado">
    Verás el número de estudiantes **Importados** y de **Errores**. En **Detalle de errores** aparece la fila, el campo y el problema de cada error. Haz clic en **Listo** para cerrar o en **Importar otro archivo** para cargar otro.
  </Step>
</Steps>

Las filas con errores se saltan; el resto se importa. Corrige esas filas en tu archivo y vuelve a importarlas solas.

## Errores comunes

| Mensaje | Qué hacer |
| - | - |
| **El nombre es obligatorio** / **El apellido es obligatorio** | Completa la celda en esa fila |
| **El email no tiene un formato válido** | Corrige el email (por ejemplo, `nombre@dominio.com`) |
| **Solo se permiten archivos Excel (.xlsx, .xls) o CSV** | Guarda el archivo en uno de esos formatos |
| **El archivo no puede superar 5MB** | Divide la lista en varios archivos |
| **El archivo está vacío o solo tiene encabezados** | Agrega al menos una fila de estudiantes |

## Antes de importar

* Usa la plantilla y no cambies los nombres de las columnas.
* La importación solo crea estudiantes nuevos: no actualiza los existentes ni detecta duplicados. Si importas el mismo archivo dos veces, los estudiantes quedarán repetidos.
* Prueba primero con un archivo pequeño (5 a 10 estudiantes).
* Guarda una copia de tu archivo original.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.