...
- El grupo de agenda debe ser válido.
- La agenda asociada al grupo no debe tener reservas en vigor (en plazo y no canceladas).
Periodos de validez
Una agenda tendrá varios registros de configuración que comprenden periodos de validez en los que la agenda estará disponible. Estos periodos de calendario no pueden superponerse.
A cada uno de estos periodos de trabajo se les podrá configurar diferentes opciones, como los tramos horarios de disponibilidad durante la semana, los minutos de atención de cada cita y el número de reservas máximo por cada cita horaria.
Con estas configuraciones y las reservas existentes se construye el calendario de disponibilidad de fechas y horas.
También es posible gestionar uno a uno cada registro de configuración para ajustar la agenda por parte del gestor que la configura.
Para la creación de un nuevo periodo de validez, se debe usar este método:
Requisitos funcionales
- La agenda debe ser válida y estar activa.
- Los minutos de atención (intervaloReservaMinutos) deben ser un número entero positivo menor de 1440.
- El número de reservas por cita (capacidad) debe ser un entero positivo mayor que 0.
- Las fechas del periodo de validez debe formar un rango correcto y la fecha de inicio debe ser igual o superior a la actual.
- El periodo de validez no puede solaparse para una misma agenda.
- Se almacenará sólo la fecha y se ignorarán las horas que lleguen por parámetro, ya que el periodo de validez comprende días completos.
Para la modificación:
Requisitos funcionales
- La configuración a editar debe estar asociada a la agenda suministrada.
- No debe existir una reserva activa (en plazo y no cancelada) para el periodo de validez afectado en la edición.
- Mismos requisitos funcionales que para la creación.
Festivos y otras fechas deshabilitadas
Como el calendario se configura por periodos de validez, se ha incorporado la posibilidad de configurar fechas concretas para excluirlas completamente de cualquier calendario que se genere.
Estas fechas pueden configurarse a nivel de agenda o a nivel de grupo de agenda, en función de si la dependencia del día deshabilitado es con respecto al servicio prestado o al grupo de personas que lo gestiona.
La gestión de estas fechas se realiza consumiendo los siguientes métodos de la API:
Requisitos funcionales
- La agenda debe ser válida y estar activa.
- La agenda no debe tener reservas en vigor (en plazo y no canceladas) para la fecha en cuestión.
- Se registrará la fecha suministrada sin las horas en la creación.
- Si se intenta rehabilitar una fecha, esta debe ser válida.
Requisitos funcionales
- El grupo de agenda debe ser válido y activo.
- La agenda asociada al grupo no debe tener reservas en vigor (en plazo y no canceladas).
- Se registrará la fecha suministrada sin las horas en la creación.
- Si se intenta rehabilitar una fecha, esta debe ser válida.