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

# Agendar Citas

> Crea una nueva cita en una sola ventana, con todos los datos a la vista y un resumen en vivo a la derecha mientras completas el formulario.

Agendar una cita en CIMAOS se hace en una sola ventana, sin saltos entre pantallas. El formulario muestra los cinco bloques de información que necesitas — profesional, paciente, fecha y horario, sesión y sala, observaciones — y a la derecha un **panel de resumen** que se va actualizando en tiempo real mientras completas los campos.

## Cuándo usar

* Necesitas agendar un paciente que llamó para pedir hora
* Un paciente llegó sin cita y quieres registrarlo
* Quieres planificar la próxima sesión de un tratamiento
* Necesitas coordinar varias citas para el mismo paciente

***

## Cómo abrir el formulario

Existen tres maneras de abrir el formulario de agendamiento. Las tres llegan al mismo formulario único, pero cambian qué campos vienen pre-llenados:

<Tabs>
  <Tab title="Desde el calendario" icon="calendar">
    Haz click directamente sobre un horario libre en cualquiera de las vistas (Día, Semana o Global).

    <Steps>
      <Step title="Abre el calendario">
        Entra al módulo "Calendario" desde el menú lateral.
      </Step>

      <Step title="Haz click en un horario libre">
        Ubica el horario que quieres y haz click sobre la celda → Se abre el formulario.
      </Step>

      <Step title="Verifica los datos pre-llenados">
        El formulario llega con:

        * **Fecha**: el día que estabas viendo (no se puede editar — sale de la vista)
        * **Hora**: el horario en el que hiciste click
        * **Box**: el box donde hiciste click, si aplica
        * **Profesional**: tu usuario (si eres profesional) o el del box (si eres admin/asistente)
      </Step>
    </Steps>

    <Check>
      **Ventaja:** Es el camino más rápido. Fecha, hora, box y profesional ya vienen elegidos. Solo eliges paciente, tipo de sesión y confirmas.
    </Check>
  </Tab>

  <Tab title="Desde el botón del header" icon="calendar-plus">
    Usa el ícono <Icon icon="calendar-plus" /> que está siempre visible en la esquina superior derecha, en cualquier página del sistema.

    <Steps>
      <Step title="Haz click en el ícono">
        El botón <Icon icon="calendar-plus" /> está fijo en la barra superior, no importa en qué módulo estés.
      </Step>

      <Step title="Selecciona el profesional (si aplica)">
        <Tabs>
          <Tab title="Administradores y Asistentes">
            Debes elegir manualmente el profesional para quien estás agendando.
          </Tab>

          <Tab title="Profesionales">
            Tu usuario queda pre-seleccionado automáticamente.
          </Tab>
        </Tabs>
      </Step>

      <Step title="Completa el resto del formulario">
        Ningún campo viene pre-llenado. Eliges fecha, hora, duración, paciente, tipo de sesión y box manualmente.
      </Step>
    </Steps>

    <Info>
      **Cuándo conviene:** Estás en otro módulo (configuración, ficha de paciente, reportes) y quieres agendar sin volver al calendario.
    </Info>
  </Tab>

  <Tab title="Desde la ficha del paciente" icon="user-plus">
    Cuando estás revisando la ficha de un paciente puedes agendar su próxima cita sin salir de ahí.

    <Steps>
      <Step title="Entra a la ficha del paciente">
        Abre la ficha del paciente desde el listado de pacientes o desde el calendario.
      </Step>

      <Step title="Usa la opción de agendar nueva cita">
        Se abre el formulario con el **paciente ya pre-seleccionado y bloqueado**.
      </Step>

      <Step title="Completa fecha, hora y demás campos">
        El campo paciente aparece deshabilitado para evitar cambiarlo por error. El resto lo completas normalmente.
      </Step>
    </Steps>

    <Check>
      **Ventaja:** No tienes que volver a buscar al paciente — ya viene elegido. Útil cuando terminas una consulta y necesitas dejar agendado el control de seguimiento.
    </Check>
  </Tab>
</Tabs>

***

## El formulario de una sola ventana

Toda la información se completa en la misma pantalla, organizada en cinco secciones visibles a la vez. A la derecha, un panel lateral muestra el **resumen de la cita en vivo** y se va llenando a medida que eliges los datos.

### Secciones del formulario

<AccordionGroup>
  <Accordion title="1. Profesional" icon="user-doctor">
    Indica para quién es la cita. Si eres administrador o asistente con varios profesionales activos, verás un selector con avatar, nombre y rol. Si eres profesional o si solo hay uno disponible, aparece pre-seleccionado con un badge "Pre-seleccionado".
  </Accordion>

  <Accordion title="2. Paciente" icon="user">
    Busca al paciente escribiendo su nombre o documento. La lista se filtra mientras escribes.

    Si el paciente no existe, usa el botón **"Crear paciente"** que aparece arriba a la derecha del campo. Se abre un formulario rápido sin perder lo que ya completaste.

    <Note>
      Si abriste el formulario desde la ficha de un paciente, este campo viene pre-seleccionado y bloqueado.
    </Note>
  </Accordion>

  <Accordion title="3. Fecha & Horario" icon="clock">
    Tres campos en línea:

    * **Fecha**: el día de la cita. Si abriste desde el calendario, no se puede editar.
    * **Hora**: hora de inicio en formato 24h (HH:MM).
    * **Duración**: lista agrupada en "Cortas" (15–45 min), "Estándar" (60–120 min) y "Largas" (135–240 min). Al lado de cada opción se previsualiza la hora de finalización.

    **Bloques disponibles sugeridos:** si no llegaste con horario pre-seleccionado, debajo aparece una fila de los próximos 5 horarios libres del profesional ("Hoy 15:00", "Mañana 09:30", etc.). Haz click en cualquiera para llenar fecha y hora automáticamente.
  </Accordion>

  <Accordion title="4. Sesión & Sala" icon="stethoscope">
    Dos campos en línea:

    **Tipo de sesión** (opcional): selecciona el tratamiento de la lista configurada en *Configuración → Odontología → Tipos de sesión*. Al elegirlo, **la duración se ajusta automáticamente** al tiempo definido para ese tratamiento.

    **Sala / Box** (obligatorio): aparece como menú desplegable con un **indicador de color** al lado de cada opción que refleja su disponibilidad:

    * <Icon icon="circle" color="#059669" /> **Verde**: box totalmente libre en ese horario
    * <Icon icon="circle" color="#f59e0b" /> **Ámbar**: tiene un detalle a revisar (conflicto leve o profesional ya con cita en otro box)
    * <Icon icon="circle" color="#ef4444" /> **Rojo**: bloqueado, no se puede seleccionar

    Si seleccionas un box en ámbar, debajo aparece un mensaje explicativo con el detalle del conflicto (paciente y horario que choca).

    <Tip>
      El sistema **auto-selecciona** el primer box disponible apenas tienes fecha, hora y duración. Solo necesitas cambiarlo si prefieres otro.
    </Tip>
  </Accordion>

  <Accordion title="5. Observaciones" icon="note-sticky">
    Campo opcional para dejar notas de la cita.

    Soporta **dictado por voz**: presiona el ícono de micrófono para dictar y el sistema transcribe automáticamente. Útil cuando tienes las manos ocupadas o quieres dejar una nota larga sin escribir.

    También puedes [agregar o editar esta nota más tarde](/calendar/gestionar-citas/notas) directamente desde el calendario, sin volver a abrir la cita completa.
  </Accordion>
</AccordionGroup>

***

## Panel de resumen en vivo

A la derecha del formulario verás un panel que se va actualizando mientras completas los campos. Es la confirmación visual antes de crear la cita.

| Bloque          | Qué muestra                                                                                                                                      |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Horario**     | Fecha completa, hora de inicio → hora de fin y duración total                                                                                    |
| **Paciente**    | Nombre completo, documento y teléfono. Tiene un ícono de lápiz <Icon icon="pencil" /> para editar la ficha del paciente sin cerrar el formulario |
| **Profesional** | Avatar, nombre y rol del profesional asignado                                                                                                    |
| **Sesión**      | Tipo de sesión elegido (o "Sin tipo específico")                                                                                                 |
| **Sala**        | Box / sala seleccionado                                                                                                                          |

<Info>
  **Editar paciente desde el resumen:** Si te das cuenta que falta un dato del paciente (teléfono, fecha de nacimiento, etc.), haz click sobre su nombre en el panel derecho. Se abre la ficha en modo edición sin perder lo que llevas avanzado de la cita.
</Info>

***

## Crear la cita

Cuando todos los campos obligatorios están completos, el botón **"Crear cita"** se activa abajo a la derecha. Al confirmar:

* La cita se guarda con estado **"Pendiente"** y aparece en el calendario
* Recibes una confirmación visual
* El formulario se cierra

### Horarios bloqueados

Si el horario que elegiste está bloqueado (por una ausencia, feriado o configuración especial), antes de crear la cita verás una **ventana de confirmación** con el motivo del bloqueo. Puedes:

* **Cancelar** para elegir otro horario
* **Continuar** y agendar igual si tienes autorización para hacerlo

<Warning>
  Agendar sobre un horario bloqueado puede dejar al profesional con conflictos. Úsalo solo cuando estés seguro (ejemplo: el paciente ya confirmó que llega y el feriado se compensa otro día).
</Warning>

***

## Campos del formulario

| Campo              | Obligatorio | Descripción                                                      |
| ------------------ | ----------- | ---------------------------------------------------------------- |
| **Profesional**    | Sí          | Para quién es la cita. Pre-seleccionado si eres profesional      |
| **Paciente**       | Sí          | Busca uno existente o crea uno nuevo desde el mismo formulario   |
| **Fecha**          | Sí          | Día de la cita (no editable si abriste desde el calendario)      |
| **Hora**           | Sí          | Hora de inicio en formato 24h                                    |
| **Duración**       | Sí          | Mínimo 15 minutos. Se ajusta sola si eliges un tipo de sesión    |
| **Tipo de sesión** | No          | Tratamiento que se realizará. Define la duración por defecto     |
| **Sala / Box**     | Sí          | Donde se atenderá la cita. Auto-selecciona el primero disponible |
| **Observaciones**  | No          | Notas de la cita. Soporta dictado por voz                        |

***

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Por qué no puedo editar la fecha?" icon="circle-question">
    Si abriste el formulario haciendo click en el calendario, la fecha viene del día que estabas viendo y queda bloqueada. Esto es a propósito: evita que sin querer la cita termine en otra fecha.

    Si necesitas otra fecha, cierra el formulario y abre desde el botón del header — ahí la fecha sí es editable.
  </Accordion>

  <Accordion title="¿Qué significan los colores en el selector de sala?" icon="palette">
    Reflejan la disponibilidad del box en el horario y duración que elegiste:

    * **Verde**: libre, sin conflictos
    * **Ámbar**: hay algo a revisar (ejemplo: el profesional tiene otra cita en otro box en ese mismo horario)
    * **Rojo**: ocupado o bloqueado, no seleccionable

    Si eliges uno en ámbar, debajo aparece la explicación exacta del conflicto.
  </Accordion>

  <Accordion title="¿Puedo crear el paciente sin salir del formulario?" icon="user-plus">
    Sí. Si el paciente no aparece en la búsqueda, haz click en **"Crear paciente"** arriba a la derecha del campo de búsqueda. Se abre un formulario rápido y al guardarlo el paciente queda elegido automáticamente.
  </Accordion>

  <Accordion title="¿Por qué la duración cambia cuando elijo el tipo de sesión?" icon="clock">
    Cada tipo de sesión tiene una duración predefinida en *Configuración → Odontología → Tipos de sesión*. Al elegirlo, la duración se ajusta a ese valor para que no tengas que recordarlo.

    Después puedes cambiarla manualmente si esta cita en particular va a tomar más o menos tiempo.
  </Accordion>

  <Accordion title="¿Por qué no veo bloques sugeridos?" icon="list">
    Los bloques sugeridos solo aparecen cuando **no hay horario pre-seleccionado**. Si abriste el formulario haciendo click en el calendario, ya tienes hora elegida, así que no se muestran.

    Para verlos, abre desde el botón del header.
  </Accordion>

  <Accordion title="¿Qué pasa si el horario está bloqueado?" icon="lock">
    Al darle "Crear cita" aparece una ventana avisándote del motivo (ausencia, feriado, etc.). Puedes cancelar o continuar de todas formas si tienes autorización.
  </Accordion>

  <Accordion title="¿El panel de resumen se guarda?" icon="floppy-disk">
    No. El panel derecho es solo una previsualización mientras completas el formulario. La cita se crea recién cuando confirmas con el botón **"Crear cita"**.
  </Accordion>
</AccordionGroup>

***

## Ver también

* [Horarios Sugeridos](/calendar/gestionar-citas/horarios-sugeridos) - Cómo el sistema busca huecos disponibles automáticamente
* [Tipos de Sesión](/configuracion/calendario/tipos-sesion) - Plantillas de tratamientos para agendar más rápido
* [Sobrecupo](/calendar/gestionar-citas/sobrecupo) - Agendar varios pacientes en el mismo horario
* [Estados de Citas](/calendar/gestionar-citas/estados) - Confirmar, cancelar o marcar inasistencias
* [Vistas y Navegación](/calendar/vistas-agenda) - Domina las vistas del calendario