Define qué se reserva y en qué zona horaria
En el módulo de Catálogo y configuración de agenda defines cada servicio con su duración en minutos y su precio en centavos enteros, y lo asocias a los recursos capaces de atenderlo (como un consultorio, un sillón, un especialista o una sala).
Toda la disponibilidad se calcula en el servidor usando la zona horaria IANA configurada para el negocio (por ejemplo, America/Panama). Nunca conviertas horas mentalmente al cargar turnos: el motor de calendario proyecta cada jornada local a instantes reales para comparar citas, retenciones temporales y eventos externos.
Parámetros que determinan si un horario está realmente libre
Para que el asistente o el panel propongan únicamente huecos viables, EMP combina cinco reglas sobre cada recurso asignado al servicio.
| Parámetro | Qué configura | Cómo afecta los horarios ofrecidos |
|---|---|---|
| Duración del servicio | Tiempo efectivo de atención en minutos. | Determina el bloque base que debe caber íntegro antes de un receso o del cierre. |
| Buffers (antes y después) | Minutos de preparación previa (bufferBeforeMinutes) o limpieza posterior (bufferAfterMinutes). | Amplían la ventana efectiva ocupada por cada cita para que dos turnos seguidos no se pisen. |
| Recesos (breaks) | Pausas fijas dentro del horario laboral (por ejemplo, almuerzo de 12:30 a 13:30). | Ninguna cita ni su buffer asociado pueden solaparse con un tramo de receso. |
| Capacidad del recurso | Número máximo de citas simultáneas que admite un mismo recurso (capacity >= 1). | El servidor evalúa el pico de ocupación simultánea minuto a minuto sumando citas confirmadas y retenciones activas. |
| Ocupación externa (Google / CalDAV) | Eventos leídos del calendario externo vinculado al negocio. | Cualquier evento externo ocupado consume la capacidad total del recurso durante ese intervalo; si la lectura falla, se bloquea por seguridad. |
Protección de reservas futuras y retenciones activas
Un cambio administrativo apresurado puede dejar sin espacio a clientes que ya tienen turno confirmado. Por eso el servidor de EMP bloquea automáticamente cualquier intento de modificar la duración o los buffers de un servicio, así como cualquier reducción de la capacidad de un recurso, mientras existan reservas futuras confirmadas o retenciones temporales (holds) activas que dependan de ellos.
Si necesitas ajustar la duración de un tratamiento o reducir el cupo de una sala, revisa y reprograma primero las citas futuras afectadas o crea un servicio nuevo para las próximas reservas. Recuerda también que acortar el horario de apertura hacia adelante no cancela por sí solo las citas que ya habían sido confirmadas.
Antes de continuar
- Comprueba la zona horaria del negocio, la duración en minutos y el precio en centavos de cada servicio.
- Incluye recesos y buffers antes/después para reflejar el tiempo real de preparación entre clientes.
- Revisa las reservas futuras activas antes de intentar cambiar duraciones, buffers o reducir capacidad.
La demo conserva datos en memoria. Las conexiones de proveedores requieren configuración, autorización y verificación en tu entorno persistente.