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

# Importaciones

> Importa datos masivos a tus colecciones desde archivos CSV o XLSX

La función de importación te permite cargar datos masivos a tus colecciones desde archivos **CSV** o **XLSX** (Excel). Puedes importar datos a una colección existente o crear una nueva colección durante el proceso.

<Frame caption="Sección de importaciones de Databases">
  <img src="https://mintcdn.com/jelouai/daUUvITM1J6ByU2U/assets/images/datum/imports.png?fit=max&auto=format&n=daUUvITM1J6ByU2U&q=85&s=48da8b652294743341dfdc81dab4da4c" alt="Página de importaciones con botón New Import y estado vacío indicando que no hay importaciones" width="3024" height="1730" data-path="assets/images/datum/imports.png" />
</Frame>

## Importar a una colección existente

Haz clic en el ícono de importación en la barra lateral izquierda y luego en **+ New Import** para abrir el asistente.

<Frame caption="Asistente de importación: selección de colección y carga de archivo">
  <img src="https://mintcdn.com/jelouai/daUUvITM1J6ByU2U/assets/images/datum/import-wizard.png?fit=max&auto=format&n=daUUvITM1J6ByU2U&q=85&s=604cd039bea9ef98d61a0d7202a7ae63" alt="Asistente de importación mostrando paso 1 con opciones Use Existing y Create New, selector de colección y zona de carga de archivos" width="3024" height="1730" data-path="assets/images/datum/import-wizard.png" />
</Frame>

El asistente tiene **5 pasos**:

<Steps>
  <Step title="Upload File">
    Asegúrate de que **Use Existing** esté seleccionado, elige la colección destino del dropdown y arrastra tu archivo CSV o XLSX a la zona de carga (o haz clic para seleccionarlo).

    <Note>
      Tamaño máximo de archivo: **500 MB**. Formatos soportados: **CSV** y **XLSX**.
    </Note>
  </Step>

  <Step title="Review Mappings">
    Asocia cada campo de la colección con una columna del archivo CSV. El asistente detecta coincidencias automáticamente (ej. un campo `email` se mapea solo). Para cada campo puedes seleccionar un **Subtype** (General Text, ID Number) y un **Country** cuando aplique. Las columnas del CSV que no mapees aparecerán en la sección **Unused CSV columns** y serán ignoradas.
  </Step>

  <Step title="Configure Options">
    Opcionalmente activa **Enable duplicate detection** para evitar registros duplicados. Al activarla se muestran opciones adicionales:

    * **Campo único para coincidencia** — El campo que identifica un duplicado.
    * **Cuando se encuentra un duplicado** — Acción a tomar: **Omitir**, **Actualizar** o **Error**.
    * **Estrategia de actualización** (solo si eliges Actualizar) — **Combinar** (actualiza solo los campos mapeados y conserva el resto) o **Reemplazar** (sobrescribe todos los campos, excepto los del sistema).
  </Step>

  <Step title="Preview Data">
    Revisa una previsualización de las primeras filas. Verás contadores de filas válidas, errores y duplicados. Haz clic en cualquier fila para ver el detalle del error.
  </Step>

  <Step title="Review & Confirm">
    Revisa el resumen final con los detalles del archivo, la colección destino, los mapeos de columnas y los campos omitidos. Haz clic en **Start Import** para ejecutar la importación.
  </Step>
</Steps>

## Importar creando una nueva colección

Este flujo tiene **6 pasos** (uno más que el de una colección existente, porque primero defines los campos):

<Steps>
  <Step title="Upload File">
    Haz clic en **+ New Import**, selecciona **Create New**, ingresa el nombre de la nueva colección y sube tu archivo CSV o XLSX.
  </Step>

  <Step title="Define Fields">
    Databases inferirá los tipos de campo automáticamente a partir de las columnas del archivo. Puedes ajustar los tipos manualmente si es necesario.
  </Step>

  <Step title="Review Mappings">
    Revisa y ajusta la asociación entre las columnas del archivo y los campos que definiste. Para cada campo puedes elegir un **Subtype** (Texto general o Número de identificación) y un **Country** cuando aplique.
  </Step>

  <Step title="Configure Options">
    Configura la detección de duplicados con las mismas opciones descritas en el flujo anterior.
  </Step>

  <Step title="Preview Data">
    Revisa la previsualización de filas y verifica que los datos y tipos sean correctos.
  </Step>

  <Step title="Review & Confirm">
    Revisa el resumen final y haz clic en **Start Import**.
  </Step>
</Steps>

## Historial de importaciones

Todas las importaciones se muestran en la sección de Importaciones con su estado. Desde aquí puedes monitorear el progreso de las importaciones en curso y revisar el resultado de las anteriores. Además puedes:

* **Cancelar** una importación en curso (mientras está en proceso o pendiente).
* **Eliminar** cualquier importación del historial.
* Descargar, desde el panel de detalle de una importación, el **Reporte de rendimiento** (importaciones completadas) y el **Reporte de errores** (cuando hubo filas fallidas), ambos en formato CSV.
