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

# Importar Pacientes

> Migra los pacientes de tu clínica desde otro software dental o desde una plantilla Excel, con detección automática de duplicados y limpieza de datos.

<Note>
  Importar Pacientes te permite traer en bloque a los pacientes de tu clínica desde otro software (como Dentalink) o desde una plantilla Excel/CSV. CIMAOS detecta y limpia los datos, identifica duplicados contra tu base actual, y te muestra una vista previa antes de confirmar la importación.
</Note>

## Funcionalidades

* **Importar desde otro software dental** con mapeo automático de columnas (actualmente Dentalink)
* **Importar desde una plantilla CIMAOS** en blanco para clínicas que vienen de un sistema sin conector directo
* **Descargar plantillas** con datos de ejemplo y las columnas exactas que el sistema espera
* **Detectar duplicados** automáticamente contra los pacientes ya cargados, por RUT o por nombre completo
* **Vista previa** de los pacientes detectados con filtros (Nuevos, Duplicados, Errores) y buscador
* **Política de duplicados** configurable: omitir, actualizar el existente o importar igual
* **Resumen final** con cuántos pacientes se crearon, actualizaron, omitieron y errores

***

## Permisos por Rol

| Funcionalidad       | Administradores | Profesionales | Asistentes |
| ------------------- | :-------------: | :-----------: | :--------: |
| Importar pacientes  |        Sí       |       No      |     No     |
| Descargar plantilla |        Sí       |       No      |     No     |

<Info>
  La importación de pacientes solo está disponible para administradores porque modifica la base de pacientes de toda la clínica.
</Info>

***

## Cómo importar pacientes

<Steps>
  <Step title="Abre la página de Clientes">
    Ve a **Configuración** → **Clientes**
  </Step>

  <Step title="Inicia la importación">
    Haz clic en el botón con el ícono **Importar Pacientes** (flecha hacia arriba) en la barra de acciones
  </Step>

  <Step title="Elige el software origen">
    Selecciona desde dónde vienen los pacientes:

    * **Template CIMAOS**: para llenar tú mismo la plantilla con los datos
    * **Dentalink**: si exportaste el archivo desde Dentalink
  </Step>

  <Step title="Carga el archivo">
    Arrastra el archivo a la zona indicada o haz clic en **Seleccionar archivo**.
    Formatos aceptados: `.xlsx`, `.xls`, `.csv` (hasta 10 MB).
  </Step>

  <Step title="Revisa la vista previa">
    El sistema procesa el archivo y muestra los pacientes detectados, agrupados en pestañas: **Todos**, **Nuevos**, **Duplicados** y **Errores**. Usa el buscador para filtrar por nombre o RUT.
  </Step>

  <Step title="Define la política para duplicados">
    En la parte superior derecha de la vista previa, elige cómo tratar los pacientes que ya existen en tu base.
  </Step>

  <Step title="Confirma la importación">
    Haz clic en **Importar pacientes**. Verás un resumen con cuántos se crearon, actualizaron y omitieron.
  </Step>
</Steps>

***

## Sistemas de origen disponibles

<Tabs>
  <Tab title="Template CIMAOS" icon="file-spreadsheet">
    Plantilla Excel en blanco con las columnas exactas que CIMAOS espera. Úsala cuando:

    * Vienes de un software sin conector directo
    * Tienes los pacientes en otro formato y los vas a copiar a la plantilla
    * Empezaste a llevar los pacientes en una hoja de cálculo propia

    **Columnas de la plantilla:** RUT, Nombre, Apellido, Fecha Nacimiento, Teléfono, Celular, Ciudad, Dirección, Email, Sexo.
  </Tab>

  <Tab title="Dentalink" icon="database">
    Conector directo para clínicas que migran desde Dentalink. CIMAOS reconoce el formato exacto del archivo que exporta Dentalink, incluyendo:

    * Nombres de columnas con tildes (ej: **Dirección**, **Teléfono**, **E-Mail**)
    * Campo **Apellidos** (en plural, como lo nombra Dentalink)
    * Campos extra: **Alertas** y **Observaciones** del paciente

    Exporta el listado de pacientes desde Dentalink y súbelo tal como viene.
  </Tab>
</Tabs>

<Tip>
  En la pantalla de carga, junto a la zona de subida verás una tarjeta para **descargar la plantilla** del sistema seleccionado. La plantilla incluye una fila de ejemplo realista para que veas el formato esperado.
</Tip>

<Info>
  Próximamente vendrán más softwares disponibles para importar. Si necesitas migrar desde uno que no aparece en la lista, usa el **Template CIMAOS**.
</Info>

***

## Datos requeridos y opcionales

**Requeridos** (sin estos campos el paciente no se importa):

* Nombre
* Apellido (o Apellidos)

**Opcionales** (si están malformados, se importan vacíos sin bloquear al paciente):

* RUT
* Fecha de nacimiento
* Teléfono y Celular
* Sexo
* Ciudad
* Dirección
* Email

Si una fila no tiene **Nombre** ni **Apellido** ni **RUT**, se omite por completo (no aparece como error). Si tiene RUT pero no Nombre o Apellido, aparece como error en la vista previa.

***

## Limpieza automática de datos

CIMAOS valida y limpia los datos al importar. Si un campo opcional viene malformado, se descarta silenciosamente y el paciente se importa sin ese dato.

| Campo                      | Qué hace el sistema                                                                                                                                                                                                                                               |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Documento de identidad** | Se valida según el **país de tu clínica** (RUT con dígito verificador en Chile, DNI en Perú, Cédula en Colombia), igual que al cargar un paciente desde la ficha. Documentos inválidos se importan vacíos. En Chile, además, se aplica el formato `12.345.678-9`. |
| **Fecha de nacimiento**    | Acepta `YYYY-MM-DD`, `DD/MM/YYYY` y `DD-MM-YYYY`. Otros formatos se descartan.                                                                                                                                                                                    |
| **Teléfono y Celular**     | Limpia espacios, paréntesis y guiones. Normaliza al formato local.                                                                                                                                                                                                |
| **Email**                  | Valida que tenga formato válido. Emails inválidos se importan vacíos.                                                                                                                                                                                             |
| **Sexo**                   | Acepta `M`/`F`, `Masculino`/`Femenino`, `Hombre`/`Mujer`, `Male`/`Female`.                                                                                                                                                                                        |
| **Ciudad**                 | Compara contra el catálogo de ciudades del país de tu clínica e incluye la región si hay coincidencia.                                                                                                                                                            |

***

## Detección de duplicados

Antes de importar, CIMAOS revisa cada paciente del archivo contra los que ya tienes en la clínica. Un paciente se marca como duplicado si:

* **Tiene el mismo RUT** que un paciente existente, o
* **Tiene el mismo nombre y apellido** (normalizado: sin tildes, sin diferencias de mayúsculas)

En la vista previa, los duplicados aparecen destacados en color ámbar y puedes filtrarlos con la pestaña **Duplicados**.

### Política para duplicados

| Política                 | Qué hace                                                                                                                       |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| **Omitir**               | No importa los duplicados. Solo se crean los pacientes nuevos. *(Opción por defecto)*                                          |
| **Actualizar existente** | Sobreescribe los datos del paciente existente con los del archivo. Útil cuando el archivo tiene información más actualizada.   |
| **Importar igual**       | Crea un paciente nuevo aunque ya exista uno con el mismo RUT o nombre. Útil cuando son personas distintas con datos parecidos. |

<Warning>
  **Actualizar existente** reemplaza los datos del paciente actual. Si el archivo trae un campo vacío, ese campo se borrará en CIMAOS. Úsalo solo cuando estés seguro de que el archivo es la fuente de verdad.
</Warning>

***

## Vista previa: filtros y búsqueda

Antes de confirmar, puedes revisar los pacientes detectados:

* **Todos**: muestra todas las filas detectadas
* **Nuevos**: solo los que no existen aún en tu base
* **Duplicados**: solo los que coinciden con un paciente existente
* **Errores**: filas que no se pueden importar (típicamente por falta de Nombre o Apellido). En esta pestaña verás la **razón** de cada error.

El **buscador** filtra por nombre o RUT dentro de la pestaña activa, lo que es útil cuando estás migrando varios miles de pacientes y quieres verificar uno específico.

<Tip>
  Las filas con error se cuentan como "no importables", pero el resto del archivo se procesa normalmente. No necesitas corregir el archivo ni reintentar — al confirmar, los errores quedan reportados en el resumen final.
</Tip>

***

## Resumen final

Al terminar, CIMAOS muestra un resumen con:

* **Pacientes migrados**: total de creados + actualizados, sobre el total del archivo
* **Duplicados**: cuántos se omitieron por la política seleccionada
* **Errores**: filas que no se pudieron importar

Haz clic en **Ver pacientes importados** para volver al listado de Clientes y confirmar que todo está en orden.

***

## Preguntas Frecuentes

<AccordionGroup>
  <Accordion title="¿Qué pasa si subo el archivo equivocado?" icon="circle-question">
    El sistema valida que las columnas requeridas (Nombre y Apellido) estén presentes con los nombres exactos del software seleccionado. Si no las encuentra, te muestra un mensaje indicando qué columnas faltan, y no se importa nada.

    Si elegiste **Dentalink** pero subiste un archivo con formato distinto, cambia al sistema correcto desde la pestaña **Origen** y vuelve a subir.
  </Accordion>

  <Accordion title="¿Hay un límite de pacientes por importación?" icon="users">
    El archivo puede pesar hasta **10 MB**. En la práctica, esto cubre miles de pacientes en un solo archivo. Si tu clínica tiene más, divide el archivo en partes.
  </Accordion>

  <Accordion title="¿Puedo deshacer una importación?" icon="rotate-left">
    No hay un "deshacer" automático. Si necesitas revertir, deshabilita los pacientes importados desde el listado de Clientes. Por eso es importante revisar bien la **vista previa** antes de confirmar.
  </Accordion>

  <Accordion title="¿Por qué algunos pacientes se importaron sin teléfono o sin RUT?" icon="phone">
    Los datos opcionales malformados se descartan silenciosamente para no bloquear la importación del paciente. Si un teléfono no es numérico o un RUT tiene un dígito verificador inválido, el paciente se crea sin ese dato. Puedes completarlo manualmente desde la ficha del paciente.
  </Accordion>

  <Accordion title="¿Qué pasa si tengo dos pacientes con el mismo nombre?" icon="user-group">
    El sistema los detecta como duplicados por nombre. Si son personas distintas, usa la política **Importar igual** para que se creen como pacientes separados. Si tienen RUT, esa diferencia evita falsos duplicados desde la primera importación.
  </Accordion>

  <Accordion title="¿La importación trae los planes de tratamiento y la historia clínica también?" icon="file-medical">
    No. La importación masiva trae **solo los datos del paciente** (identificación, contacto, ubicación). Los planes de tratamiento, evoluciones e historia clínica se cargan manualmente o mediante una migración asistida (consulta con el equipo de soporte).
  </Accordion>
</AccordionGroup>

***

## Ver también

* [Aranceles](/configuracion/arancel) — Configura el catálogo de tratamientos antes de cargar pacientes y crear planes de tratamiento
* [Exportar datos](/configuracion/exportar) — Cómo exportar la información de tu clínica
* [Ficha del Paciente](/pacientes/index) — Trabajar con pacientes una vez importados

<Check>
  **Siguiente paso:** Una vez importados los pacientes, configura los [Aranceles](/configuracion/arancel) para empezar a crear planes de tratamiento.
</Check>
