Agendas
Será posible la creación, edición y borrado de agendas por parte de determinados roles que tengan capacidad de gestión.
Para la creación puede utilizarse el siguiente método:
Requisitos funcionales
El nombre es obligatorio y debe tener un máximo de 300 caracteres.
- La grupoAgenda.id es obligatorio, debe estar activo y no debe estar asociado a otra agenda.
La modificación de una agenda se realizará con el siguiente método:
Requisitos funcionales
- La agenda debe ser válida.
Mismos requisitos que para la creación.
- En caso de actualizar una agenda inactiva, se reactivará.
El borrado de una agenda se realizará con el siguiente método:
| Advertencia |
|---|
El borrado de una agenda provocará la eliminación en cascada de toda su configuración al completo. |
Requisitos funcionales
- La agenda debe ser válida.
- La agenda no debe tener reservas en vigor (en plazo y no canceladas).
Grupos de agenda
Para la configuración de los grupos de acceso a las agendas, se cuenta con los siguientes métodos.
Requisitos funcionales
- La agenda debe ser válida.
El nombre es obligatorio y debe tener un máximo de 300 caracteres.
- La organización funcional (organizacion.uuid) debe ser válida.
- El usuario asignado de las solicitudes que se generen con la agenda (asignado.uuid) debe ser válido y perteneciente a los usuarios filtrados por codigo=ASIGNADO_GRUPO_AGENDA.
Requisitos funcionales
- El grupo de agenda debe ser válido.
Mismos requisitos que para la creación.
- En caso de actualizar un grupo de agenda inactivo, se reactivará.
| Advertencia |
|---|
El borrado de un grupo de agenda provocará la eliminación en cascada de su agenda asociada y su configuración al completo. |
Requisitos funcionales
- 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.
Para el borrado de elementos:
| Advertencia |
|---|
El borrado de un periodo de validez eliminará también todas sus configuraciones de tramos horarios asociados a dicha configuración. |
Requisitos funcionales
- La agenda debe ser válida y estar activa.
- La configuración a editar debe estar asociada a la agenda suministrada y activa.
- No debe existir una reserva activa (en plazo y no cancelada) para el periodo de validez afectado en la edición.
Tramos horarios
| Info |
|---|
En construcció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.
| HTML |
|---|
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #49cc90;background: rgba(73,204,144,.1);">
<div style="border-color: #49cc90;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #49cc90;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">POST</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Crear agendas</div>
</div>
</div> |
Requisitos funcionales
El nombre es obligatorio y debe tener un máximo de 300 caracteres.
- La grupoAgenda.id es obligatorio, debe estar activo y no debe estar asociado a otra agenda.
La modificación de una agenda se realizará con el siguiente método:
| HTML |
|---|
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #fca130;background: rgba(252,161,48,.1);">
<div style="border-color: #fca130;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #fca130;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">PUT</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/{idAgenda}</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Actualizar agendas</div>
</div>
</div> |
Requisitos funcionales
- La agenda debe ser válida.
Mismos requisitos que para la creación.
- En caso de actualizar una agenda inactiva, se reactivará.
El borrado de una agenda se realizará con el siguiente método:
| Advertencia |
|---|
El borrado de una agenda provocará la eliminación en cascada de toda su configuración al completo. |
| HTML |
|---|
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #f93e3e;background: rgba(249,62,62,.1);">
<div style="border-color: #f93e3e;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #f93e3e;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">DELETE</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/{idAgenda}</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Eliminar agendas</div>
</div>
</div> |
Requisitos funcionales
- La agenda debe ser válida.
- La agenda no debe tener reservas en vigor (en plazo y no canceladas).
Grupos de agenda
Para la configuración de los grupos de acceso a las agendas, se cuenta con los siguientes métodos.
| HTML |
|---|
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #49cc90;background: rgba(73,204,144,.1);">
<div style="border-color: #49cc90;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #49cc90;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">POST</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/grupos</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Crear grupo de agendas</div>
</div>
</div> |
Requisitos funcionales
- La agenda debe ser válida.
El nombre es obligatorio y debe tener un máximo de 300 caracteres.
- La organización funcional (organizacion.uuid) debe ser válida.
- El usuario asignado de las solicitudes que se generen con la agenda (asignado.uuid) debe ser válido y perteneciente a los usuarios filtrados por codigo=ASIGNADO_GRUPO_AGENDA.
| HTML |
|---|
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #fca130;background: rgba(252,161,48,.1);">
<div style="border-color: #fca130;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #fca130;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">PUT</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/grupos/{idGrupoAgenda}</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Modificar grupo de agendas</div>
</div>
</div> |
Requisitos funcionales
- El grupo de agenda debe ser válido.
Mismos requisitos que para la creación.
- En caso de actualizar un grupo de agenda inactivo, se reactivará.
| HTML |
|---|
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #f93e3e;background: rgba(249,62,62,.1);">
<div style="border-color: #f93e3e;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #f93e3e;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">DELETE</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/grupos/{idGrupoAgenda}</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Eliminar grupo de agendas</div>
</div>
</div> |
| Advertencia |
|---|
El borrado de un grupo de agenda provocará la eliminación en cascada de su agenda asociada y su configuración al completo. |
Requisitos funcionales
- 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.
| HTML |
|---|
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/{idAgenda}/configuraciones</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Obtener configuraciones</div>
</div>
</div>
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/{idAgenda}/configuraciones/{idConfiguracion}</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Obtener configuración</div>
</div>
</div> |
Para la creación de un nuevo periodo de validez, se debe usar este método:
| HTML |
|---|
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #49cc90;background: rgba(73,204,144,.1);">
<div style="border-color: #49cc90;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #49cc90;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">POST</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/{idAgenda}/configuraciones</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Crear configuración</div>
</div>
</div> |
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:
| HTML |
|---|
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #fca130;background: rgba(252,161,48,.1);">
<div style="border-color: #fca130;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #fca130;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">PUT</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/{idAgenda}/configuraciones/{idConfiguracion}</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Editar configuración</div>
</div>
</div> |
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.
Para el borrado de elementos:
| HTML |
|---|
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #f93e3e;background: rgba(249,62,62,.1);">
<div style="border-color: #f93e3e;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #f93e3e;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">DELETE</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/{idAgenda}/configuraciones/{idConfiguracion}</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Eliminar configuración</div>
</div>
</div> |
| Advertencia |
|---|
El borrado de un periodo de validez eliminará también todas sus configuraciones de tramos horarios asociados a dicha configuración. |
Requisitos funcionales
- La agenda debe ser válida y estar activa.
- La configuración a editar debe estar asociada a la agenda suministrada y activa.
- No debe existir una reserva activa (en plazo y no cancelada) para el periodo de validez afectado en la edición.
Tramos horarios
Un periodo de validez de agenda tendrá varios registros de configuración que comprenden los tramos horarios del día en los que el servicio estará disponible. Estos tramos no pueden superponerse.
A cada uno de estos tramos se les configura el día de la semana y la hora de inicio y fin de atención para las citas agendadas.
También es posible gestionar uno a uno cada registro de tramo horario para ajustar la agenda por parte del gestor que la configura.
| HTML |
|---|
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/{idAgenda}/configuraciones/{idConfiguracion}/tramos</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Obtener tramos</div>
</div>
</div>
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/{idAgenda}/configuraciones/{idConfiguracion}/tramos/{idTramo}</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Obtener tramo</div>
</div>
</div> |
Para la creación de un nuevo tramo horario, se debe usar este método:
| HTML |
|---|
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #49cc90;background: rgba(73,204,144,.1);">
<div style="border-color: #49cc90;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #49cc90;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">POST</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/{idAgenda}/configuraciones/{idConfiguracion}/tramos</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Crear tramo</div>
</div>
</div> |
Requisitos funcionales
- La agenda debe ser válida y estar activa.
- La configuración del periodo de validez debe ser válida, estar activa y pertenecer a la agenda.
- El día de la semana indicado debe ser correcto.
- La hora de inicio del horario debe ser anterior a la de fin.
- Los tramos horarios no deben solaparse para una mismo periodo de validez.
Para la modificación:
| HTML |
|---|
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #fca130;background: rgba(252,161,48,.1);">
<div style="border-color: #fca130;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #fca130;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">PUT</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/{idAgenda}/configuraciones/{idConfiguracion}/tramos/{idTramo}</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Modificar tramo</div>
</div>
</div> |
Requisitos funcionales
- La agenda debe ser válida y estar activa.
- La configuración del periodo de validez debe ser válida, estar activa y pertenecer a la agenda.
- No debe existir una reserva activa (en plazo y no cancelada) para el periodo de validez afectado en la edición y dentro del tramo horario que se quiere editar.
- Mismos requisitos funcionales que para la creación.
Para el borrado de elementos:
| HTML |
|---|
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #f93e3e;background: rgba(249,62,62,.1);">
<div style="border-color: #f93e3e;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #f93e3e;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">DELETE</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/{idAgenda}/configuraciones/{idConfiguracion}/tramos/{idTramo}</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Eliminar tramo</div>
</div>
</div> |
Requisitos funcionales
- La agenda debe ser válida y estar activa.
- La configuración del periodo de validez debe ser válida, estar activa y pertenecer a la agenda.
- El tramo horario debe existir y estar activo.
- No debe existir una reserva activa (en plazo y no cancelada) para el periodo de validez afectado en la edición y dentro del tramo horario que se quiere editar.
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:
| HTML |
|---|
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/{idAgenda}/fechasdeshabilitadas</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Obtener fechas deshabilitadas para una agenda</div>
</div>
</div>
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #49cc90;background: rgba(73,204,144,.1);">
<div style="border-color: #49cc90;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #49cc90;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">POST</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/{idAgenda}/fechasdeshabilitadas</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Deshabilitar fecha para una agenda</div>
</div>
</div>
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #f93e3e;background: rgba(249,62,62,.1);">
<div style="border-color: #f93e3e;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #f93e3e;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">DELETE</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/{idAgenda}/fechasdeshabilitadas/{idFechaDeshabilitada}</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Habilitar fecha para una agenda</div>
</div>
</div> |
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.
| HTML |
|---|
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/grupos/{idGrupoAgenda}/fechasdeshabilitadas</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Obtener fechas deshabilitadas para un grupo de agenda</div>
</div>
</div>
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #49cc90;background: rgba(73,204,144,.1);">
<div style="border-color: #49cc90;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #49cc90;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">POST</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/grupos/{idGrupoAgenda}/fechasdeshabilitadas</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Deshabilitar fecha para un grupo de agenda</div>
</div>
</div>
<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #f93e3e;background: rgba(249,62,62,.1);">
<div style="border-color: #f93e3e;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span style="background: #f93e3e;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">DELETE</span>
<span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/agendas/grupos/{idGrupoAgenda}/fechasdeshabilitadas/{idFechaDeshabilitada}</span>
<div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Habilitar fecha para un grupo de agenda</div>
</div>
</div> |
...
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.