> ## 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.

# Tratamientos

> Agrega aranceles al plan de tratamiento, aplica descuentos, selecciona piezas dentales y gestiona el estado de cada tratamiento.

<Note>
  Los tratamientos son los servicios o aranceles que componen el plan de tratamiento. Cada tratamiento tiene un precio, puede tener descuentos y se asocia a piezas dentales específicas.
</Note>

## Agregar un tratamiento

<Steps>
  <Step title="Abre el plan de tratamiento">
    Haz clic en el plan de tratamiento para ver su detalle
  </Step>

  <Step title="Haz clic en Agregar Servicio">
    En la pestaña **Tratamientos**, haz clic en el botón **+ Agregar Servicio** → Se abre un panel lateral
  </Step>

  <Step title="Selecciona el arancel">
    Busca y selecciona el servicio que deseas agregar
  </Step>

  <Step title="Configura los detalles">
    Selecciona piezas dentales, ajusta cantidad y aplica descuentos si es necesario
  </Step>

  <Step title="Guarda">
    Haz clic en **Agregar** → El tratamiento aparece en el plan de tratamiento
  </Step>
</Steps>

***

## Buscar aranceles

En la parte superior del panel hay tres modos para encontrar lo que vas a cargar: **Por nombre**, **Por grupo** y **Plantilla**. El modo activo se indica con un chip destacado.

<Tabs>
  <Tab title="Por nombre" icon="magnifying-glass">
    Escribe el nombre del servicio en el campo de búsqueda. El sistema filtra los aranceles mientras escribes.

    **Ejemplo:** Escribe "resina" para encontrar todos los aranceles que contengan esa palabra.

    <Tip>
      La búsqueda funciona con cualquier parte del nombre. "endo" encontrará "Endodoncia", "Endodoncia Multirradicular", etc.
    </Tip>
  </Tab>

  <Tab title="Por grupo" icon="folder">
    Usa el selector de grupos para filtrar por categoría:

    <Steps>
      <Step title="Selecciona un grupo">
        Haz clic en el selector de grupos → Elige la categoría (ej: "Operatoria", "Endodoncia", "Cirugía")
      </Step>

      <Step title="Ve los aranceles del grupo">
        Se muestran solo los aranceles de esa categoría
      </Step>

      <Step title="Selecciona el arancel">
        Haz clic en el arancel deseado
      </Step>
    </Steps>

    Los grupos se configuran en **Configuración** → **Aranceles**.
  </Tab>

  <Tab title="Plantilla" icon="layer-group">
    Carga una **plantilla** predefinida que agrupa varios aranceles en una sola acción. Útil para tratamientos recurrentes como "Rehabilitación oral completa" o "Kit inicial de ortodoncia".

    <Steps>
      <Step title="Selecciona una plantilla">
        Las plantillas disponibles aparecen como cards. Cada card muestra los aranceles que incluye la plantilla.
      </Step>

      <Step title="Asigna piezas a cada arancel">
        Dentro de la plantilla, cada arancel tiene su propio selector de piezas dentales. Debes seleccionar piezas para **todos** los aranceles antes de poder cargarla al plan de tratamiento.
      </Step>

      <Step title="Aplica descuento si corresponde">
        Si ingresas un descuento a la plantilla, el monto se distribuye automáticamente y en proporción entre todos los aranceles que la componen.
      </Step>

      <Step title="Agrega al plan de tratamiento">
        Haz clic en **Agregar** → Todos los aranceles de la plantilla se suman al plan de tratamiento como líneas individuales, conservando las piezas y el descuento asignados.
      </Step>
    </Steps>

    Las plantillas se crean y administran en **Configuración** → **Paquetes**.

    <Info>
      El botón **Agregar** queda deshabilitado mientras falten piezas por asignar en alguno de los aranceles de la plantilla.
    </Info>
  </Tab>
</Tabs>

***

## Seleccionar piezas dentales

Muchos tratamientos se aplican a piezas dentales específicas. El panel muestra un diagrama dental simplificado donde puedes seleccionar las piezas.

### Dentición permanente y temporal

El selector de piezas tiene dos pestañas para elegir el tipo de dentición:

<Tabs>
  <Tab title="Permanente" icon="tooth">
    Muestra las piezas de la **dentición permanente** (dientes definitivos del adulto), organizadas por cuadrantes.
  </Tab>

  <Tab title="Temporal" icon="baby">
    Muestra las piezas de la **dentición temporal** (dientes de leche), pensada para pacientes pediátricos.
  </Tab>
</Tabs>

Cada pestaña muestra un contador con la cantidad de piezas que llevas seleccionadas en esa dentición. Así, si un tratamiento abarca piezas de ambas denticiones, puedes alternar entre pestañas sin perder lo seleccionado en cada una.

<Tip>
  Para pacientes **menores de 13 años**, el selector arranca por defecto en la pestaña **Temporal**, según la fecha de nacimiento registrada en la ficha. Igualmente puedes cambiar de pestaña en cualquier momento si necesitas seleccionar piezas permanentes (por ejemplo, en casos de dentición mixta).
</Tip>

### Cómo seleccionar

1. Elige la pestaña **Permanente** o **Temporal** según corresponda
2. Haz clic en cada pieza dental que corresponda al tratamiento
3. Las piezas seleccionadas se marcan visualmente
4. Puedes seleccionar múltiples piezas, incluso combinando ambas denticiones

### Sin pieza específica

Algunos tratamientos no aplican a piezas específicas (ej: "Limpieza dental", "Consulta", "Blanqueamiento"). En estos casos, simplemente no selecciones ninguna pieza.

<Info>
  La cantidad de piezas seleccionadas afecta el cálculo del precio total. Si seleccionas 3 piezas, el precio se multiplica por 3. El contador suma las piezas de ambas denticiones (permanente y temporal).
</Info>

### Zona personalizada

Si tu clínica no trabaja con piezas dentales específicas (por ejemplo, clínicas de estética facial), el selector también ofrece una pestaña **Zona personalizada** para describir la zona tratada con tus propias palabras, en vez de elegir un diente del catálogo.

<Steps>
  <Step title="Abre la pestaña Zona personalizada">
    En el selector de piezas, haz clic en la pestaña **Zona personalizada**
  </Step>

  <Step title="Escribe la zona tratada">
    Ingresa una descripción corta, como "tercio superior" o "labios" (máximo 60 caracteres)
  </Step>

  <Step title="Agrégala al tratamiento">
    Presiona Enter o haz clic en **+** → La zona queda listada con un check verde
  </Step>
</Steps>

Puedes agregar varias zonas personalizadas al mismo tratamiento y combinarlas con piezas del catálogo si lo necesitas.

<Info>
  Esta pestaña solo aparece si un administrador habilitó el permiso **Permitir zona personalizada en piezas dentales** en [Configuración → Permisos](/configuracion/usuarios/permisos).
</Info>

<Tip>
  La zona personalizada se muestra tal como la escribiste, sin ningún formato adicional, tanto en la lista de tratamientos como en la impresión del plan de tratamiento.
</Tip>

***

## Seleccionar caras del diente

Algunos tratamientos no se aplican a un diente completo, sino a una **superficie (cara)** específica: obturaciones, sellantes, incrustaciones o carillas. Si el arancel que seleccionaste tiene activada la opción **Requiere selección de caras**, el panel muestra una sección **Caras por pieza** debajo del selector de piezas.

<Info>
  Que un arancel pida caras o no se define en su configuración. Tu administrador lo activa desde **Configuración** → **Aranceles** (columna **Caras**). Ver [Aranceles que requieren caras](/configuracion/arancel#aranceles-que-requieren-caras).
</Info>

### Códigos de las caras

Son los mismos del odontograma:

| Código | Cara               |
| :----: | ------------------ |
|  **M** | Mesial             |
|  **O** | Oclusal / Incisal  |
|  **D** | Distal             |
|  **V** | Vestibular         |
|  **P** | Palatina / Lingual |

### Cómo asignar las caras

<Steps>
  <Step title="Selecciona las piezas">
    Primero marca las piezas dentales en el selector, como en cualquier tratamiento
  </Step>

  <Step title="Marca las caras de cada pieza">
    En la sección **Caras por pieza**, cada diente seleccionado aparece con los botones **M, O, D, V, P**. Haz clic en las caras que correspondan a esa pieza. Puedes elegir varias caras por diente (ej: "MOD").
  </Step>

  <Step title="Agrega el tratamiento">
    Cuando todas las piezas tengan al menos una cara asignada, el botón **Agregar** se habilita
  </Step>
</Steps>

<Warning>
  Las caras se asignan **por pieza individual**. Las áreas generales (arcada completa, boca completa) no llevan caras: para usar caras debes seleccionar dientes específicos.
</Warning>

<Info>
  Si un arancel requiere caras y alguna pieza quedó sin asignar, verás el aviso **"Falta asignar caras"** y el botón **Agregar** permanece deshabilitado hasta que completes todas las piezas.
</Info>

<Warning>
  Si el arancel requiere caras y agregaste una **zona personalizada** en vez de una pieza del catálogo, el sistema también te pedirá asignarle caras a esa zona antes de habilitar el botón **Agregar**. Para tratamientos de zona personalizada, elige un arancel que **no** requiera selección de caras.
</Warning>

<Tip>
  Los aranceles que **no** requieren caras siguen funcionando igual que siempre: no verás la sección **Caras por pieza** y agregas el tratamiento de forma normal.
</Tip>

***

## Resumen de precios

Al seleccionar un arancel, el panel muestra un resumen con todos los valores:

| Campo                 | Descripción                                                  |
| --------------------- | ------------------------------------------------------------ |
| **Valor clínica**     | Precio base del arancel según tu configuración               |
| **Valor convenio**    | Precio con el descuento del convenio del paciente (si tiene) |
| **Valor laboratorio** | Costo de laboratorio asociado al arancel (si existe)         |
| **Descuento**         | Descuento manual que apliques (si tienes permiso)            |
| **Cantidad**          | Número de piezas seleccionadas                               |
| **Subtotal**          | Total calculado del tratamiento                              |

### Cálculo del subtotal

```
Subtotal = (Valor Convenio + Valor Laboratorio) × Cantidad de piezas - Descuento
```

**Ejemplo:**

* Valor convenio: \$50.000
* Valor laboratorio: \$10.000
* Piezas seleccionadas: 2
* Descuento: \$5.000
* **Subtotal**: ($50.000 + $10.000) × 2 - $5.000 = **$115.000\*\*

***

## Convenios del paciente

Si el paciente tiene un convenio asociado, el descuento se aplica automáticamente.

### Cómo funciona

1. El sistema detecta si el paciente tiene convenio activo
2. Aplica el porcentaje de descuento al precio base
3. Muestra el "Valor convenio" junto al precio original

**Ejemplo:** Si el arancel cuesta \$100.000 y el convenio tiene 20% de descuento:

* Valor clínica: \$100.000
* Valor convenio: \$80.000 (el paciente paga este valor)

<Info>
  El convenio se configura en el perfil del paciente. El descuento del convenio es independiente de cualquier descuento manual que apliques.
</Info>

***

## Aplicar descuentos

Si tienes permiso, puedes agregar un descuento adicional a cada tratamiento.

<Steps>
  <Step title="Selecciona el arancel">
    Busca y selecciona el servicio
  </Step>

  <Step title="Ingresa el descuento">
    En el campo **Descuento**, ingresa el monto a descontar
  </Step>

  <Step title="Verifica el subtotal">
    El resumen se actualiza mostrando el nuevo total
  </Step>
</Steps>

### Tipos de descuento

El descuento se ingresa como **monto fijo** (ej: \$10.000), no como porcentaje.

<Warning>
  Si no ves el campo de descuento, significa que no tienes permiso para aplicar descuentos. Contacta al administrador de la clínica.
</Warning>

### Descuento vs Convenio

| Tipo                 | Aplicación                   | Quién lo define                   |
| -------------------- | ---------------------------- | --------------------------------- |
| **Convenio**         | Automático según el paciente | Configuración del sistema         |
| **Descuento manual** | Por cada tratamiento         | El profesional (si tiene permiso) |

Ambos descuentos se aplican: primero el convenio, luego el descuento manual.

***

## Aranceles de laboratorio

Algunos aranceles tienen costos de laboratorio asociados (ej: coronas, prótesis, carillas).

### Cómo funcionan

* El costo de laboratorio se configura en el arancel
* Se suma automáticamente al calcular el subtotal
* Aparece desglosado en el resumen y en la impresión

### Ejemplo

Para un arancel "Corona de Porcelana":

* Valor clínica: \$150.000
* Valor laboratorio: \$80.000
* **Total por pieza**: \$230.000

<Info>
  Los aranceles de laboratorio se configuran en **Configuración > Aranceles > Laboratorio**.
</Info>

***

## Lista de tratamientos

Una vez agregados, los tratamientos aparecen en una lista dentro del plan de tratamiento.

### Información mostrada

Cada tratamiento en la lista muestra:

* Nombre del servicio
* Piezas dentales (si aplica), con sus caras entre paréntesis cuando el arancel las requiere (ej: **3.6 (MOD)**)
* Precio y descuentos
* Estado actual
* Botones de acción

<Info>
  Las caras seleccionadas también aparecen en la **impresión / PDF** del plan de tratamiento y en el **link público** que compartes con el paciente.
</Info>

### Acciones disponibles

* **Cambiar estado**: Haz clic en el indicador de estado
* **Eliminar**: Haz clic en el ícono de basura (si tienes permiso)

***

## Estados de tratamiento

Cada tratamiento tiene un estado que indica su progreso:

| Estado          | Color         | Significado                 |
| --------------- | ------------- | --------------------------- |
| **Pendiente**   | Gris/Amarillo | Tratamiento aún no iniciado |
| **En progreso** | Azul          | Tratamiento en ejecución    |
| **Finalizado**  | Verde         | Tratamiento completado      |

### Cambiar estado

<Steps>
  <Step title="Ubica el tratamiento">
    En la lista de tratamientos, busca el que deseas actualizar
  </Step>

  <Step title="Haz clic en el estado">
    Haz clic en el indicador de estado actual
  </Step>

  <Step title="Selecciona el nuevo estado">
    Elige entre Pendiente, En progreso o Finalizado
  </Step>
</Steps>

<Info>
  El estado del plan de tratamiento se actualiza automáticamente cuando cambias el estado de los tratamientos.
</Info>

***

## Eliminar tratamiento

Puedes eliminar un tratamiento en estado **Pendiente** aunque el plan ya tenga pagos registrados. No necesitas eliminar los pagos primero.

<Steps>
  <Step title="Ubica el tratamiento">
    En la lista de tratamientos, busca el que deseas eliminar
  </Step>

  <Step title="Haz clic en eliminar">
    Haz clic en el ícono de basura
  </Step>

  <Step title="Confirma">
    Confirma que deseas eliminar el tratamiento
  </Step>
</Steps>

### Saldo a favor al eliminar

Si al eliminar el arancel lo que el paciente ya pagó **supera el nuevo total** del plan, el sistema **no bloquea** la acción. Antes de confirmar, el cuadro de confirmación muestra un aviso indicando el **saldo a favor** que quedará (por ejemplo, "Al eliminarlo, el paciente quedará con un saldo a favor de \$45.000").

Tras eliminar, el resumen del plan deja de mostrar un pendiente en negativo y pasa a indicar **"A favor: \$X"**, reflejando el monto a favor del paciente.

<Info>
  El aviso de saldo a favor es informativo, no impide eliminar el arancel. Más información en [Pagos → Resumen financiero](/pacientes/presupuestos/pagos#resumen-financiero).
</Info>

<Warning>
  Si no ves el botón de eliminar, puede ser porque:

  * El tratamiento no está en estado "Pendiente"
  * No tienes permiso para eliminar tratamientos
</Warning>

***

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Puedo modificar un tratamiento después de agregarlo?" icon="pencil">
    No puedes editar un tratamiento existente. La solución es eliminarlo (si está pendiente) y agregar uno nuevo con los datos correctos.
  </Accordion>

  <Accordion title="¿Qué pasa si el paciente tiene convenio?" icon="handshake">
    El descuento del convenio se aplica automáticamente. Verás el "Valor Convenio" junto al precio base. Este descuento es adicional a cualquier descuento manual.
  </Accordion>

  <Accordion title="¿Por qué no puedo aplicar descuentos?" icon="percent">
    Tu administrador puede haber restringido esta función. Contacta al administrador para que revise los permisos en **Configuración > Permisos**.
  </Accordion>

  <Accordion title="¿Por qué no puedo eliminar un tratamiento?" icon="trash">
    Solo puedes eliminar tratamientos en estado "Pendiente". Puedes eliminarlos aunque el plan tenga pagos registrados; si lo pagado supera el nuevo total, el plan reflejará un saldo a favor del paciente. Si tampoco así ves el botón, es posible que no tengas permiso para eliminar tratamientos.
  </Accordion>

  <Accordion title="¿Qué pasa si elimino un arancel ya pagado?" icon="hand-holding-dollar">
    Puedes eliminarlo igual. Si lo que el paciente pagó supera el nuevo total del plan, verás un aviso con el saldo a favor que quedará y, al confirmar, el resumen del plan mostrará **"A favor: \$X"**. No se bloquea la acción.
  </Accordion>

  <Accordion title="¿Cómo selecciono piezas de leche (dentición temporal)?" icon="baby">
    En el selector de piezas, cambia a la pestaña **Temporal**. Allí verás las piezas de la dentición temporal. Para pacientes menores de 13 años, el selector ya arranca en esta pestaña de forma automática según la fecha de nacimiento del paciente.
  </Accordion>

  <Accordion title="¿Por qué no veo la pestaña Zona personalizada?" icon="pen">
    Un administrador debe habilitar primero el permiso **Permitir zona personalizada en piezas dentales** en **Configuración** → **Permisos**. Si no lo ves, pídele a tu administrador que lo active.
  </Accordion>

  <Accordion title="¿Por qué algunos tratamientos me piden seleccionar caras?" icon="tooth">
    Porque ese arancel tiene activada la opción **Requiere selección de caras** en su configuración (Configuración → Aranceles). Sirve para tratamientos que actúan sobre una superficie del diente (obturaciones, sellantes, incrustaciones, carillas). Marca las caras (M, O, D, V, P) de cada pieza seleccionada; el botón **Agregar** se habilita cuando todas las piezas tienen al menos una cara.
  </Accordion>

  <Accordion title="No puedo agregar el tratamiento y dice 'Falta asignar caras'" icon="triangle-exclamation">
    El arancel requiere caras y alguna pieza seleccionada quedó sin marcar ninguna. Revisa la sección **Caras por pieza** y asigna al menos una cara a cada diente. Recuerda que las caras solo se asignan a piezas individuales, no a áreas como arcada o boca completa.
  </Accordion>
</AccordionGroup>

***

## Ver también

* [Pagos](/pacientes/presupuestos/pagos) - Registrar y gestionar pagos
* [Historial de movimientos](/pacientes/presupuestos/historial) - Ver quién agregó o eliminó cada arancel y cuándo
* [Enviar e Imprimir](/pacientes/presupuestos/enviar-imprimir) - Compartir el plan de tratamiento con el paciente

<Check>
  **Siguiente paso:** Aprende a [registrar pagos](/pacientes/presupuestos/pagos) en el plan de tratamiento.
</Check>