Crear servicio
Crea un servicio de calendario público o interno y guarda, en la misma operación, recurrencia opcional, roles requeridos y empleados planificados.
En este artículo
Un servicio define un bloque operativo de la ubicación. En Marea Gran Via puede ser Público, para alimentar reservas, disponibilidad, optimización y sesiones operativas, o Interno, para bloquear o planificar trabajo dentro del calendario.
El alta se guarda como una operación completa: evento service, recurrencia opcional, roles requeridos y turnos planificados. Si una parte falla, Antylogic cancela la creación completa.
Antes de empezar
- Sesión iniciada con Grupo Marea Demo y la ubicación Marea Gran Via seleccionadas.
- Permiso de ubicación service:manage. El permiso service:view permite consultar, pero no crear.
- Para un servicio Público debe existir al menos un plano y un catálogo seleccionable, por ejemplo Plano demo 1 y Carta Gran Via.
- Para añadir dotación deben existir roles de staff, como Sala, y empleados activos, como Marta Ruiz.
- Permiso staff-schedule:manage si se guardan empleados planificados dentro del alta.
- Permiso reservation-automatic:use si se selecciona una configuración de optimización no system.
Instrucciones
- 1.
Abre Nuevo servicio
Desde Calendario de servicios, usa Crear servicio. También puedes abrir calendars/create?kind=service&preset=services. La pantalla valida organización, ubicación y permiso service:manage antes de mostrar el formulario editable.
- 2.
Completa la información principal
En Info, introduce título, inicio, fin, zona horaria y, si procede, descripción. El inicio debe ser anterior al fin. En llamadas directas sin timezone, Antylogic usa la zona horaria de la ubicación o UTC.
- 3.
Elige la visibilidad
Mantén Público cuando el servicio deba alimentar reservas, disponibilidad, optimización o sesiones operativas. Cambia a Interno cuando solo deba servir como bloque de calendario y planificación interna.
- 4.
Configura las referencias públicas
Para un servicio Público, selecciona Plano y Catálogo. La Optimización puede quedar en Modo manual; si se informa una configuración, debe ser válida, no system y requiere reservation-automatic:use.
- 5.
Añade repetición si aplica
En Repetir, deja el servicio como puntual o configura frecuencia diaria, semanal, mensual o anual con intervalo, fecha límite y reglas específicas. Solo se guarda calendar_recurrence cuando el formulario envía recurrence.
- 6.
Define roles requeridos
En Roles requeridos, añade cada rol necesario, por ejemplo Sala, con mínimo y recomendado. Un rol solo puede aparecer una vez. La falta de cobertura no bloquea el alta: el sistema devuelve warnings o problems.
- 7.
Planifica empleados si hace falta
En Empleados, añade empleados activos con rol y horario. Los turnos se guardan como eventos hijos staff_schedule del servicio y requieren staff-schedule:manage cuando se incluyen en el bundle.
- 8.
Crea el servicio
Pulsa Crear servicio. Antylogic crea el evento service, sincroniza recurrencia, dotación y turnos, muestra Evento creado correctamente, refresca calendar-events y vuelve a la ruta de retorno.
Validaciones y límites
- Un servicio Público no puede crearse sin layout_id y catalog_id válidos.
- Un servicio Interno no debe documentarse como reservable ni como abrible desde TPV o sesiones públicas.
- El endpoint service-bundle solo acepta event.kind service; si kind llega vacío, se normaliza a service.
- La recurrencia solo admite daily, weekly, monthly o yearly, con reglas de calendario dentro de los rangos permitidos.
- El backend rechaza servicios que caen en días de vacaciones de ubicación existentes.
- No se crean service_occurrences durante esta acción; se generan o consultan después desde las superficies de calendario.
Resultado esperado
El calendario queda actualizado con el nuevo servicio. Si se incluyeron roles o empleados, la dotación queda vinculada al mismo alta y las alertas de cobertura se devuelven como warnings o problems.