Cómo crear un empleado
Da de alta una ficha de empleado en la ubicación actual, con rol de personal obligatorio, identidad manual o vinculada a usuario, contacto y avatar opcionales, y configuración inicial de vacaciones.
En este artículo
Crear un empleado sirve para incorporar a una persona al equipo operativo de una ubicación. En Marea Gran Via, la ficha queda ligada al rol de personal que usará el local para organizar sala, cocina, barra o gestión.
El alta no crea roles, permisos, credenciales TPV ni horarios. Es el primer registro de staff: define identidad, contacto, usuario asociado si procede y días anuales de vacaciones con prorrateo opcional.
Antes de empezar
- Trabajar dentro de una organización y ubicación seleccionadas, por ejemplo Grupo Marea Demo y Marea Gran Via.
- Tener permiso de ubicación `staff:manage` para abrir el alta y registrar el empleado.
- Tener al menos un rol de personal disponible en la ubicación; sin `staff_role_id` la creación no se puede completar.
- Para asociar un usuario existente, tener `users:view` o `users:manage` y contar con un usuario aceptado de la ubicación sin empleado asociado.
- Para crear un usuario interno desde el formulario, tener `users:manage`.
Instrucciones
- 1.
Abre Empleados
Entra en la gestión de personal de la ubicación y abre la pestaña Empleados. La tabla muestra el equipo actual, como Marta Ruiz o Diego Serrano, y enseña Registrar cuando el operador puede crear empleados.
- 2.
Inicia el alta
Pulsa Registrar para abrir Registrar empleado. El formulario carga los roles de personal y, si tienes permisos de usuarios, también los usuarios aceptados de la ubicación que todavía no tienen staff asociado.
- 3.
Completa rol e identidad
Elige o conserva el rol de personal. Si no vas a vincular un usuario, introduce nombre y apellido; después puedes añadir email, teléfono y avatar para completar la ficha visible del empleado.
- 4.
Vincula usuario si procede
Si aparece Usuario asociado, selecciona un usuario existente o crea un usuario interno. Al usar los datos del usuario, la app deshabilita los campos manuales y el backend copia nombre, contacto, teléfono y avatar desde ese usuario.
- 5.
Revisa vacaciones
Comprueba los días anuales de vacaciones y la opción Prorratear días de vacaciones anuales. Si está activa y el cálculo da días consumidos, Antylogic crea un evento ficticio aceptado de vacaciones para dejar el saldo inicial coherente.
- 6.
Registra o cancela
Pulsa Registrar para guardar. Si la API responde correctamente, la app confirma el alta, refresca empleados, usuarios y calendarios relacionados, y vuelve a Empleados. Cancelar o volver cierra el alta sin llamar al endpoint de creación.
Validaciones y límites
- La pantalla necesita organización y ubicación seleccionadas.
- Sin `staff:manage`, la UI no permite abrir el alta o no muestra Registrar.
- El rol de personal es obligatorio; el backend rechaza la creación con `error.staff.role_required` si `staff_role_id` llega vacío.
- Sin usuario vinculado, la UI exige nombre y apellido antes de habilitar Registrar.
- La sección Usuario asociado solo aparece con `users:view` o `users:manage`; Crear usuario interno requiere `users:manage`.
- `use_user_data` solo se conserva como verdadero cuando también hay `user_id`; entonces prevalecen los datos del usuario sobre los datos escritos manualmente.
- Los días de vacaciones se normalizan como entero mínimo 0; el control de UI limita el rango visible entre 0 y 365.
- El prorrateo usa la zona horaria de la ubicación y, si genera días, crea un `calendar_event` de tipo `staff_vacation` con `proration_fictional=true`.
- No se encontró validación backend explícita para formato de email, formato E.164 de teléfono, unicidad de email ni obligatoriedad backend de `full_name`; la guía documenta la validación visible en la UI.
Resultado esperado
El empleado queda creado en la ubicación actual con su rol operativo, datos de identidad y contacto, usuario asociado si procede y saldo inicial de vacaciones preparado para la operativa de personal.