Cómo archivar un empleado
Desactiva un empleado activo de la ubicación sin borrar su histórico: el registro queda marcado como inactivo, sale del listado principal y, cuando procede, se retira de asignaciones futuras de servicios.
En este artículo
Archivar un empleado sirve para retirar a una persona de la operativa diaria sin eliminar su historial. En Marea Gran Via, por ejemplo, un responsable puede archivar a Marta Ruiz desde su ficha o desde la tabla de Empleados.
La acción aplica un soft delete sobre staff.deleted_at. El empleado deja de aparecer en el listado activo, pero puede consultarse al mostrar inactivos; si tenía horarios futuros asociados a servicios, Antylogic intenta retirarlo de esas asignaciones sin alterar el histórico.
Antes de empezar
- Tener sesión iniciada con organización y ubicación seleccionadas, por ejemplo Grupo Marea Demo y Marea Gran Via.
- Trabajar con un empleado de la ubicación actual que esté activo, sin staff.deleted_at.
- Disponer de permiso staff:manage en la ubicación. staff:view permite entrar al listado o detalle, pero no habilita el archivado.
- Usar un runtime documental restaurable o desechable para capturas, porque el archivado puede modificar asignaciones futuras de servicios.
Instrucciones
- 1.
Abre el empleado
Entra en Empleados de la ubicación y localiza el empleado activo. Puedes archivar desde la tabla o abrir primero su ficha, como en el caso documental de Marta Ruiz.
- 2.
Pulsa Desactivar
Usa la acción Desactivar de la fila o el botón Desactivar del pie de la ficha. La acción solo aparece para empleados activos cuando el usuario tiene permiso de gestión de personal.
- 3.
Confirma el archivado
Revisa el modal Archivar empleado. Si el nombre es correcto y aceptas retirar al empleado del listado activo, pulsa Archivar; Cancelar cierra el modal sin cambios.
- 4.
Espera el resultado
La app ejecuta el archivado sin pedir motivo ni parámetros adicionales. Si termina correctamente, muestra Empleado archivado y, desde la ficha, vuelve a la pestaña de personal.
- 5.
Comprueba el listado
Vuelve al listado activo de Empleados. El empleado archivado ya no debe aparecer por defecto porque el listado excluye registros con staff.deleted_at.
- 6.
Muestra los inactivos
Activa Mostrar empleados inactivos o abre el listado con staff_show_deleted=true. El empleado archivado aparece como Inactivo y la acción disponible pasa a Recuperar, que pertenece al flujo de restauración.
Validaciones y límites
- staff:manage es obligatorio para mostrar y ejecutar Desactivar; staff:view no basta para archivar.
- El empleado debe pertenecer a la ubicación seleccionada y seguir activo. Si ya estaba archivado o pertenece a otra ubicación, la operación se trata como no encontrada.
- La acción DELETE no acepta payload: no hay motivo, comentario, dry-run ni confirmación adicional enviada a la API.
- Archivar no borra físicamente el empleado; actualiza staff.deleted_at y lo oculta del listado activo.
- Si existen horarios futuros aplicables vinculados a servicios, el sistema intenta retirar al empleado de esas asignaciones antes de marcarlo como archivado.
- Los horarios históricos o ya iniciados se conservan. Restaurar después al empleado no reconstruye automáticamente las asignaciones futuras retiradas.
Resultado esperado
El empleado queda inactivo en la ubicación, desaparece del listado activo y puede verse al mostrar inactivos. El histórico operativo se conserva y las asignaciones futuras de servicios solo se ajustan cuando el sistema encuentra vínculos aplicables.