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

# Aranceles

> Administra el catálogo de tratamientos y precios de tu clínica, organizados por categorías.

<Note>
  Los aranceles son el catálogo de tratamientos y servicios de tu clínica con sus precios. Cada clínica define sus propios aranceles libremente. Estos precios se usan al crear planes de tratamiento para los pacientes, por lo que mantener el arancel actualizado es fundamental para la facturación correcta.
</Note>

## Funcionalidades

* **Crear aranceles** con nombre, precio y categoría
* **Organizar por categorías** personalizadas (ej: Consultas, Cirugías, Preventivo)
* **Buscar aranceles** por nombre desde el listado
* **Editar precios** directamente desde la lista
* **Desactivar aranceles** sin eliminarlos para conservar el historial
* **Cargar aranceles típicos** desde un catálogo de referencia para poblar tu lista de un saque
* **Importar masivamente** desde un archivo Excel
* **Asociar gastos de laboratorio** a tratamientos que lo requieran
* **Marcar aranceles que requieren caras** para pedir las superficies del diente al presupuestar

***

## Permisos por Rol

| Funcionalidad                           | Administradores | Profesionales | Asistentes |
| --------------------------------------- | :-------------: | :-----------: | :--------: |
| Crear aranceles                         |        Sí       |       No      |     No     |
| Editar aranceles                        |        Sí       |       No      |     No     |
| Desactivar / reactivar aranceles        |        Sí       |       No      |     No     |
| Eliminar aranceles                      |        Sí       |       No      |     No     |
| Gestionar categorías                    |        Sí       |       No      |     No     |
| Cargar aranceles típicos                |        Sí       |       No      |     No     |
| Importar desde Excel                    |        Sí       |       No      |     No     |
| Usar aranceles en planes de tratamiento |        Sí       |       Sí      |     No     |

***

## Crear un arancel

<Steps>
  <Step title="Abre la configuración de aranceles">
    Ve a **Configuración** → **Aranceles**
  </Step>

  <Step title="Haz clic en Nuevo Arancel">
    Haz clic en el botón **+ Nuevo Arancel**
  </Step>

  <Step title="Completa los datos">
    * **Nombre**: Nombre del tratamiento (ej: "Consulta General", "Endodoncia Unirradicular")
    * **Monto**: Precio del tratamiento en la moneda de tu clínica
    * **Categoría**: Selecciona una categoría existente o crea una nueva
    * **Requiere selección de caras** (opcional): marca esta casilla si el tratamiento actúa sobre una superficie del diente (ver [Aranceles que requieren caras](#aranceles-que-requieren-caras))
  </Step>

  <Step title="Guarda">
    Haz clic en **Guardar** → El arancel aparece en la lista bajo su categoría
  </Step>
</Steps>

***

## Aranceles que requieren caras

Algunos tratamientos no se aplican a un diente completo, sino a una **superficie (cara)** específica de la pieza: obturaciones, sellantes, incrustaciones o carillas. Para estos aranceles puedes activar la opción **Requiere selección de caras**. Cuando esté activa, al presupuestar el tratamiento se pedirá indicar sobre qué caras de cada pieza se realiza, igual que en el odontograma.

<Info>
  Las caras usan los mismos códigos del odontograma:

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

### Activar desde la lista

Cada arancel tiene una columna **Caras** con un interruptor:

<Steps>
  <Step title="Abre la configuración de aranceles">
    Ve a **Configuración** → **Aranceles**
  </Step>

  <Step title="Ubica el arancel">
    Busca el tratamiento en su categoría
  </Step>

  <Step title="Activa el interruptor de la columna Caras">
    Haz clic en el interruptor → Queda activo de inmediato. Puedes activar varios aranceles seguidos sin recargar.
  </Step>
</Steps>

También puedes marcar la casilla **Requiere selección de caras** al crear un arancel nuevo.

<Tip>
  La activación es retrocompatible: los aranceles que ya tienes y los planes de tratamiento existentes siguen funcionando igual. La selección de caras solo empieza a pedirse en los **nuevos** tratamientos que cargues con un arancel que tenga la opción activa.
</Tip>

<Warning>
  Solo administradores pueden activar o desactivar la opción **Requiere selección de caras**, igual que el resto de la edición de aranceles.
</Warning>

***

## Categorías

Las categorías te permiten organizar los aranceles por tipo de tratamiento.

**Ejemplos de categorías:**

* Consultas
* Operatoria
* Endodoncia
* Cirugía
* Preventivo
* Prótesis
* Ortodoncia
* Periodoncia

### Gestionar categorías

* **Crear**: Se crean al asignar un arancel a una categoría nueva
* **Editar nombre**: Haz clic en el nombre de la categoría para editarlo
* **Eliminar**: Solo se pueden eliminar categorías vacías (sin aranceles asociados)

***

## Buscar un arancel

Cuando tu catálogo crece, usa el buscador en la parte superior del listado para encontrar un arancel por nombre.

* Escribe parte del nombre del tratamiento en el campo **Buscar arancel...**
* El listado filtra en tiempo real, ignorando tildes y mayúsculas
* Si tienes una categoría seleccionada, la búsqueda filtra solo dentro de esa categoría
* Borra el texto del buscador para volver a ver el catálogo completo

<Tip>
  La búsqueda es útil cuando un paciente menciona un tratamiento específico mientras armas el plan de tratamiento. En lugar de recorrer las categorías, escribe el nombre y el arancel aparece de inmediato.
</Tip>

***

## Editar aranceles

Puedes editar el nombre o el monto de cualquier arancel directamente desde la lista:

1. Haz clic en el **nombre** o **monto** del arancel que deseas modificar
2. Edita el valor en el popover que aparece
3. Presiona **Enter** para guardar o **Escape** para cancelar

***

## Desactivar un arancel

Cuando un tratamiento deja de ofrecerse pero quieres conservar los planes de tratamiento antiguos que lo incluyen, **desactivar es la mejor opción**. A diferencia de eliminar, el arancel sigue existiendo en el catálogo (oculto del uso diario) y los registros históricos se mantienen intactos.

<Info>
  **Cuándo desactivar en vez de eliminar:**

  * El arancel ya no se ofrece, pero quieres conservar los planes de tratamiento antiguos que lo incluyen.
  * Estás haciendo limpieza temporal y podrías querer reactivarlo más adelante.
  * Tienes un servicio estacional o que dejas pausado por un tiempo.

  **Cuándo eliminar:**

  * El arancel se creó por error.
  * No tiene planes de tratamiento asociados y no aporta valor mantenerlo.
</Info>

### Desactivar

<Steps>
  <Step title="Abre el menú de la fila">
    En **Configuración** → **Aranceles**, ubica el arancel y haz clic en el ícono de tres puntos (⋯) al final de la fila.
  </Step>

  <Step title="Elige Desactivar">
    En el menú desplegable, selecciona **Desactivar**. El arancel desaparece del listado activo de inmediato.
  </Step>
</Steps>

### Ver aranceles desactivados

En la cabecera del mantenedor verás el switch **Mostrar desactivados**:

* **OFF** (por defecto): el listado muestra solo aranceles activos.
* **ON**: el listado muestra **solo** aranceles desactivados (no se mezclan con los activos).

Los aranceles desactivados aparecen con un badge **"Desactivado"** y un tono más tenue para distinguirlos rápido. Sobre la lista verás un contador del estilo *"3 de 12 desactivados"*.

<Tip>
  Si activas el switch y no hay aranceles desactivados, verás un mensaje con la leyenda *"Los aranceles que desactives aparecerán aquí"*.
</Tip>

### Reactivar

Activa el switch **Mostrar desactivados**, abre el menú (⋯) de la fila y elige **Reactivar**. El arancel vuelve al listado activo y queda disponible nuevamente para planes de tratamiento y agrupaciones nuevas.

### Qué pasa con planes de tratamiento y agrupaciones

Un arancel desactivado **se oculta** de los flujos de selección, pero no rompe lo existente:

| Contexto                                            | Comportamiento                                                                                  |
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Plan de tratamiento **nuevo**                       | No aparece en el selector al agregar tratamientos                                               |
| Plan de tratamiento **existente** que ya lo incluía | Sigue figurando con su precio original                                                          |
| Agrupación **nueva**                                | No aparece en el selector al armarla                                                            |
| Agrupación **existente** que ya lo incluía          | Sigue visible para que puedas **quitarlo**, pero no puedes volver a agregarlo desde el selector |

<Warning>
  Solo administradores (rol **Administrador**) pueden desactivar o reactivar aranceles. Los profesionales y asistentes no ven esta opción.
</Warning>

***

## Cargar aranceles típicos

Si recién empiezas a armar tu catálogo, puedes poblarlo de un saque a partir de un **catálogo de referencia de aranceles dentales frecuentes** (305 aranceles organizados en 16 grupos), en lugar de cargarlos uno por uno. El catálogo es una referencia: tú ajustas los precios y eliges cuáles cargar antes de confirmar.

<Note>
  Esta opción es ideal para clínicas nuevas o que están migrando: en pocos clics tienes una base sólida de tratamientos que después puedes editar, completar o desactivar según tu realidad.
</Note>

### Cómo cargar aranceles típicos

<Steps>
  <Step title="Abre la configuración de aranceles">
    Ve a **Configuración** → **Aranceles**.
  </Step>

  <Step title="Abre el cargador de aranceles típicos">
    En la cabecera del listado, haz clic en el botón con el ícono de **chispa (✨)**. Al pasar el cursor verás el texto **Cargar aranceles típicos**. Se abre el cuadro **Cargar aranceles típicos**.
  </Step>

  <Step title="Define el valor base de referencia">
    En **Valor base de referencia** indica el valor de tu unidad de cobro. Cada arancel del catálogo tiene un **factor (×N)** y su precio se calcula como *valor base × factor*. Al cambiar el valor base, los precios sugeridos se recalculan automáticamente.
  </Step>

  <Step title="Elige los aranceles a cargar">
    Selecciona **grupos completos** (con el checkbox del encabezado de cada grupo) o **aranceles individuales**. Usa **Seleccionar todos** / **Quitar todos** para marcar o desmarcar todo de una vez. Por defecto vienen seleccionados todos los que aún no tienes.
  </Step>

  <Step title="Ajusta los precios (opcional)">
    Si un precio sugerido no te calza, edítalo directamente en el campo de cada arancel. Los precios que edites a mano se mantienen aunque cambies el valor base.
  </Step>

  <Step title="Confirma la carga">
    Haz clic en **Cargar N aranceles** y confirma en el aviso. Los aranceles seleccionados se agregan a tu catálogo, cada uno con su grupo y precio.
  </Step>
</Steps>

### Valor base por país

El **valor base de referencia** se propone según el país de tu clínica:

| País                       | Valor base sugerido |
| -------------------------- | :-----------------: |
| Chile (o país no definido) |       \$10.000      |
| Perú                       |          0          |
| Colombia                   |          0          |

<Info>
  El valor sugerido es solo un punto de partida: puedes cambiarlo por el que uses en tu clínica antes de cargar. En Perú y Colombia parte en 0 para que definas tú el valor de referencia.
</Info>

### Aranceles que ya tienes

La carga es **aditiva**: nunca pisa ni modifica los aranceles que ya tienes en el catálogo.

* Los aranceles que ya existen (mismo grupo y nombre) aparecen marcados como **Ya agregado**, tachados y deshabilitados, para que no los dupliques.
* Si un grupo completo ya está en tu catálogo, se muestra como **Ya agregado** y no se puede volver a seleccionar.
* Puedes cargar el catálogo en **varias pasadas**: la próxima vez que abras el cuadro, solo te ofrecerá los que falten.

<Tip>
  El botón de aranceles típicos desaparece de la cabecera cuando ya cargaste todos los aranceles del catálogo: si no lo ves, es porque tu clínica ya tiene la lista completa.
</Tip>

<Warning>
  La carga en bloque **no se puede deshacer de una vez**: por eso pedimos confirmación antes de cargar. Si después quieres quitar aranceles cargados, tendrás que eliminarlos (o desactivarlos) uno por uno.
</Warning>

***

## Importar desde Excel

Para clínicas con muchos tratamientos, puedes importar aranceles masivamente:

<Steps>
  <Step title="Haz clic en Importar desde Excel">
    En la página de aranceles, haz clic en el botón **Importar desde Excel**
  </Step>

  <Step title="Descarga la plantilla">
    Descarga la plantilla Excel proporcionada con las columnas: Categoría, Nombre, Monto
  </Step>

  <Step title="Completa la plantilla">
    Llena la plantilla con tus aranceles (máximo 500 registros por importación)
  </Step>

  <Step title="Sube el archivo">
    Selecciona el archivo completado y revisa la vista previa antes de confirmar
  </Step>
</Steps>

<Info>
  La importación crea automáticamente las categorías que no existan. Si un arancel ya existe con el mismo nombre, no se duplica.
</Info>

***

## Gastos de laboratorio

Algunos tratamientos tienen costos de laboratorio asociados (ej: coronas, prótesis). Puedes vincular gastos de laboratorio a los aranceles correspondientes para tenerlos registrados.

Haz clic en **Gestionar asociaciones de laboratorio** para vincular gastos a procedimientos específicos.

***

## Conexión con planes de tratamiento

Los aranceles son la base de los planes de tratamiento:

* Al crear un plan de tratamiento, seleccionas aranceles del catálogo
* El precio del arancel se usa como precio base del tratamiento
* Puedes aplicar descuentos sobre el precio del arancel
* Si modificas el precio de un arancel, los planes de tratamiento existentes **no** cambian (mantienen el precio original)

***

## Preguntas Frecuentes

<AccordionGroup>
  <Accordion title="¿Si cambio el precio de un arancel, cambian los planes de tratamiento existentes?" icon="file-invoice-dollar">
    No. Los planes de tratamiento registran el precio al momento de su creación. Un cambio en el arancel solo afecta a los planes de tratamiento nuevos.
  </Accordion>

  <Accordion title="¿Puedo tener aranceles con precio $0?" icon="money-bill">
    Sí. Puedes crear aranceles con monto \$0 para tratamientos sin costo (ej: controles de cortesía).
  </Accordion>

  <Accordion title="¿Qué pasa si elimino un arancel que está en uso?" icon="trash-can">
    El arancel se elimina del catálogo. Los planes de tratamiento existentes que lo usan mantienen la información, pero ya no podrás seleccionarlo para planes de tratamiento nuevos. También se elimina de los paquetes que lo incluyan. Si quieres dejar de ofrecerlo pero conservar el historial limpio, prefiere **Desactivar** en lugar de Eliminar.
  </Accordion>

  <Accordion title="¿Cuál es la diferencia entre desactivar y eliminar un arancel?" icon="circle-pause">
    **Desactivar** oculta el arancel del uso diario sin borrarlo: deja de aparecer al agregarlo a planes de tratamiento o agrupaciones nuevas, pero sigue presente en los registros existentes y puedes reactivarlo cuando quieras. **Eliminar** lo quita del catálogo de forma permanente y lo desvincula de las agrupaciones que lo incluían. Como regla: si dudas, desactiva.
  </Accordion>

  <Accordion title="¿En qué moneda se muestran los precios?" icon="coins">
    La moneda se configura automáticamente según el país de tu clínica (CLP para Chile, PEN para Perú, COP para Colombia).
  </Accordion>

  <Accordion title="¿Para qué sirve la columna Caras de un arancel?" icon="tooth">
    Marca los tratamientos que actúan sobre una superficie del diente (obturaciones, sellantes, incrustaciones, carillas). Cuando está activa, al presupuestar ese arancel se pide indicar las caras (M, O, D, V, P) de cada pieza. Es opcional y retrocompatible: los aranceles sin caras siguen funcionando igual. Más detalle en [Aranceles que requieren caras](#aranceles-que-requieren-caras).
  </Accordion>

  <Accordion title="¿Qué es el factor (×N) en los aranceles típicos?" icon="calculator">
    Es un multiplicador de referencia: el precio de cada arancel se calcula como **valor base × factor**. Por ejemplo, con un valor base de $10.000 y un factor ×2, el precio sugerido es $20.000. Así puedes ajustar todos los precios a la vez cambiando un solo número, y afinar los que necesites a mano.
  </Accordion>

  <Accordion title="¿Cargar aranceles típicos sobrescribe mis aranceles actuales?" icon="layer-group">
    No. La carga es aditiva: solo agrega aranceles nuevos. Los que ya tienes (mismo grupo y nombre) aparecen marcados como **Ya agregado** y no se duplican ni se modifican.
  </Accordion>

  <Accordion title="No veo el botón de aranceles típicos, ¿por qué?" icon="circle-question">
    El botón solo lo ven los administradores y desaparece cuando ya cargaste todos los aranceles del catálogo. Si no lo ves, es porque tu clínica ya tiene la lista completa o tu rol no tiene permiso para gestionar aranceles.
  </Accordion>

  <Accordion title="¿Puedo deshacer una carga de aranceles típicos?" icon="rotate-left">
    No de una sola vez. Por eso se pide confirmación antes de cargar. Si te arrepientes, puedes eliminar o desactivar los aranceles cargados uno por uno desde el listado.
  </Accordion>
</AccordionGroup>

***

## Ver también

* [Paquetes de Aranceles](/configuracion/paquetes) - Agrupa aranceles en paquetes de tratamiento
* [Convenios](/configuracion/convenios) - Configura descuentos automáticos por convenio
* [Planes de tratamiento](/pacientes/presupuestos) - Cómo crear planes de tratamiento con aranceles

<Check>
  **Siguiente paso:** Aprende a crear [Paquetes de Aranceles](/configuracion/paquetes) para agrupar tratamientos frecuentes.
</Check>
