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

# Horarios Sugeridos

> Encuentra automáticamente los próximos espacios disponibles sin revisar el calendario manualmente. El sistema busca por ti.

El asistente de horarios sugeridos busca automáticamente los próximos bloques de tiempo disponibles, considerando horarios de trabajo, ausencias, citas agendadas y disponibilidad de boxes.

## Cuándo usar

* Un paciente llama sin preferencia de horario específico
* Quieres agendar rápidamente en el próximo espacio disponible
* Necesitas ver opciones de horarios sin revisar día por día el calendario
* Buscas múltiples opciones para ofrecerle al paciente

***

## Dónde aparece

Esta funcionalidad está disponible **solo cuando abres el formulario de agendamiento desde el botón del header** (ícono <Icon icon="calendar-plus" /> en la esquina superior derecha).

<Note>
  **No aparece** cuando haces clic directamente en un horario del calendario, ya que en ese caso el horario ya está pre-seleccionado.
</Note>

***

## Cómo funciona

El sistema busca automáticamente horarios disponibles después de que seleccionas la duración de la cita:

<Steps>
  <Step title="Abre el formulario desde el header">
    Haz clic en el ícono <Icon icon="calendar-plus" /> en la esquina superior derecha → Se abre el formulario de agendamiento
  </Step>

  <Step title="Selecciona el profesional (si aplica)">
    Si eres administrador o asistente, selecciona para quién estás agendando → Si eres profesional, ya está pre-seleccionado
  </Step>

  <Step title="Selecciona la duración">
    En el Paso 1 del formulario → Selecciona la duración de la cita (ejemplo: 30 minutos) → El sistema busca automáticamente
  </Step>

  <Step title="Revisa los bloques sugeridos">
    Verás una lista de "Próximos Bloques Disponibles" → Cada bloque muestra fecha, horario y boxes disponibles
  </Step>

  <Step title="Selecciona un bloque (opcional)">
    Haz clic en el bloque que prefieres → La fecha y hora se llenan automáticamente en el formulario → O ignora las sugerencias y selecciona manualmente
  </Step>

  <Step title="Continúa con el agendamiento">
    Completa los demás datos (paciente, tratamiento, box) → Finaliza el agendamiento normalmente
  </Step>
</Steps>

<Check>
  El sistema busca hasta **30 días hacia adelante** para encontrar los primeros **5 bloques disponibles** que cumplan con todos los criterios.
</Check>

***

## Información mostrada

Cada bloque disponible muestra:

| Campo        | Descripción                                                 |
| ------------ | ----------------------------------------------------------- |
| **Fecha**    | "Hoy", "Mañana", o día de la semana (ejemplo: "Mar 21 nov") |
| **Horario**  | Hora de inicio y fin (ejemplo: "15:00 - 15:30")             |
| **Duración** | Duración del bloque en minutos (coincide con tu selección)  |
| **Boxes**    | Nombres de los boxes disponibles en ese horario             |

***

## Qué considera el sistema

El algoritmo de búsqueda analiza múltiples factores para encontrar horarios verdaderamente disponibles:

<Tabs>
  <Tab title="Horarios de trabajo" icon="clock">
    Solo muestra bloques dentro de los horarios laborales configurados del profesional.

    **Ejemplo:** Si el profesional trabaja Lunes de 9:00 a 13:00 y de 15:00 a 19:00, solo verás bloques en esos rangos.
  </Tab>

  <Tab title="Ausencias" icon="calendar-xmark">
    Excluye automáticamente períodos de ausencia del profesional (vacaciones, licencias, capacitaciones, feriados).

    **Ventaja:** No te sugiere horarios en días que el profesional no estará disponible.
  </Tab>

  <Tab title="Citas agendadas" icon="calendar-check">
    Omite horarios ya ocupados por otras citas del profesional (solo considera citas confirmadas y pendientes, no canceladas ni inasistencias).

    **Ventaja:** Solo ves espacios realmente libres.
  </Tab>

  <Tab title="Disponibilidad de boxes" icon="door-open">
    Solo muestra bloques si hay al menos un box disponible (no ocupado por otros profesionales).

    **Ejemplo:** Si todos los boxes están ocupados a las 15:00 por otros profesionales, ese horario no aparecerá.
  </Tab>
</Tabs>

<Info>
  El sistema considera **todos estos factores simultáneamente** para asegurar que los horarios sugeridos sean verdaderamente agendables.
</Info>

***

## Casos de uso

<AccordionGroup>
  <Accordion title="Paciente sin preferencia de horario" icon="user">
    **Situación:** Un paciente llama diciendo "quiero hora para limpieza pero cualquier día me sirve".

    **Solución:** Abres el formulario desde el header → Seleccionas duración 30 min → Le ofreces las 5 opciones sugeridas → El paciente elige la que prefiere.

    **Ventaja:** No pierdes tiempo revisando el calendario día por día.
  </Accordion>

  <Accordion title="Agendar seguimiento rápido" icon="calendar-plus">
    **Situación:** Terminas una cita y quieres agendar al paciente para su próximo control en 2 semanas aproximadamente.

    **Solución:** Desde la ficha del paciente → Abres formulario con el botón del header → Ves sugerencias → Agendas en el primer bloque disponible después de 2 semanas.

    **Ventaja:** Agendas sin salir de la ficha del paciente.
  </Accordion>

  <Accordion title="Ofrecer múltiples opciones" icon="list">
    **Situación:** El paciente pregunta "¿qué horarios tienes disponibles esta semana?".

    **Solución:** Abres el formulario → Ves las 5 sugerencias → Le ofreces todas las opciones de un vistazo.

    **Ventaja:** Respuesta inmediata sin navegar por el calendario.
  </Accordion>

  <Accordion title="Agendamiento urgente" icon="bolt">
    **Situación:** Necesitas agendar un paciente lo antes posible por urgencia.

    **Solución:** Abres formulario → Ves sugerencias → El primer bloque mostrado es el próximo disponible.

    **Ventaja:** Encuentras el horario más cercano automáticamente.
  </Accordion>
</AccordionGroup>

***

## Preguntas Frecuentes

<AccordionGroup>
  <Accordion title="¿Por qué no veo sugerencias?" icon="circle-question">
    **Causas posibles:**

    * No has seleccionado la duración de la cita aún
    * Abriste el formulario haciendo clic en un horario del calendario (ya tiene hora pre-seleccionada)
    * No hay horarios disponibles en los próximos 30 días

    **Solución:** Asegúrate de abrir desde el botón del header y seleccionar la duración.
  </Accordion>

  <Accordion title="¿Puedo ignorar las sugerencias?" icon="xmark">
    **Sí, son completamente opcionales.** Si ningún bloque te sirve, simplemente pasa al siguiente paso y selecciona manualmente la fecha y hora que prefieras.

    Las sugerencias son una ayuda, no una obligación.
  </Accordion>

  <Accordion title="¿Solo muestra 5 bloques?" icon="hashtag">
    Sí, el sistema está optimizado para mostrar los primeros 5 bloques disponibles. Esto evita saturar la interfaz con demasiadas opciones.

    Si necesitas más opciones, puedes seleccionar manualmente la fecha en el calendario.
  </Accordion>

  <Accordion title="¿Cómo cambia la búsqueda si cambio la duración?" icon="clock">
    Al cambiar la duración (ejemplo: de 30 min a 60 min), el sistema **recalcula automáticamente** y te muestra nuevos bloques que cumplan con la nueva duración.

    **Ejemplo:** Un bloque de 30 min puede no servir para una cita de 60 min si el siguiente horario está ocupado.
  </Accordion>

  <Accordion title="¿Por qué algunos días no aparecen?" icon="calendar-xmark">
    El sistema omite automáticamente:

    * Días fuera del horario laboral del profesional
    * Días con ausencias (vacaciones, licencias)
    * Horarios completamente ocupados

    Solo verás días con al menos un bloque verdaderamente disponible.
  </Accordion>
</AccordionGroup>

***

## Ver también

* [Agendar Citas](/calendar/gestionar-citas/agendar) - Aprende las dos formas de agendar
* [Vistas y Navegación](/calendar/vistas-agenda) - Explora el calendario visualmente
* [Horarios de Trabajo](/configuracion/organizacion/horarios) - Configura horarios y ausencias

<Tip>
  **Próximo paso:** Si no encuentras horarios adecuados en las sugerencias, revisa la configuración de [Horarios de Trabajo](/configuracion/organizacion/horarios) para asegurarte de que los horarios laborales estén correctamente definidos.
</Tip>