Generar patrón de hoja de horas (prueba)
Repite una semana inicial a lo largo de un intervalo de fechas de hasta dos años, para poder validar una regla de liquidación antes de la puesta en marcha, ya sea para un empleado, una unidad organizativa o todos. También puede aprobar los periodos que genera, para comprobar una configuración completa de principio a fin. Solo en espacios de trabajo de prueba.
Por qué existe
Un espacio de trabajo configurado en septiembre tiene exactamente un periodo de aprobación: septiembre. No hay primer ni segundo trimestre, así que no hay ninguna cadena de liquidaciones que revisar; y los periodos nunca se pueden crear en el pasado, porque cada uno se abre con el saldo final del anterior.
Esta tarea va en sentido contrario. Introduce una semana representativa —en la fecha de inicio del espacio de trabajo o cualquier semana posterior— y deja que la tarea la repita hacia delante a partir de ahí. Cada periodo que crea es el más reciente, así que la cadena se construye en el orden en que habría ocurrido de verdad.
Antes de ejecutarla
- Configura las reglas que quieres validar: la política de liquidación, las cuentas de la bolsa de horas y las condiciones laborales con la aprobación de hojas de horas activada.
- Asegúrate de que el calendario de festivos cubre los meses que vas a generar. Los días que no cubre se generan como días laborables normales.
- Da al empleado algo sobre lo que rellenar automáticamente: una actividad predeterminada o una distribución porcentual en su lista de actividades. Activar el relleno automático en la política de jornada no basta por sí solo; sin un destino, la tarea se detiene en lugar de rellenar un año de días en blanco.
- Como ese empleado, introduce tu semana representativa a través de la hoja de horas normal. Registros reales en actividades reales. Empieza en la fecha de inicio del espacio de trabajo, o donde quieras, e indica a la tarea dónde con Fecha de inicio.
Dale cierta forma a la semana. Una semana con exactamente las horas teóricas produce una diferencia de cero en cada periodo, así que nunca se alcanza ningún tope y nada caduca: el año generado no demostraría nada. Registra más de la jornada teórica algunas semanas y menos otras.
El patrón
El patrón es lo que has introducido, no algo que se configura. La tarea lee semanas completas a partir de la semana en la que cae la fecha de inicio y las repite hasta la fecha de fin. Si dejas la fecha de inicio vacía, empieza donde empieza el espacio de trabajo, o donde empieza el contrato del empleado si es posterior, ya que no se puede registrar nada antes de ninguna de las dos:
| Semanas del patrón | Qué se repite |
|---|---|
| 1 | Un patrón semanal |
| 2 | Una rotación quincenal |
| 4 | Una rotación de 4 semanas: un ciclo de guardia o de guardia localizable |
| Vacío | Nada: los registros se quedan como están; consulta Probar una configuración completa |
Aquí una semana va de lunes a domingo, así que el patrón es la misma rotación sea cual sea el día de la semana en que empieza el intervalo. Se respetan los días de la semana: un martes del patrón siempre se copia a un martes.
Opciones
| Opción | Significado |
|---|---|
| Empleado | Genera los datos de este empleado. |
| Unidad organizativa | Genera los datos de todos los empleados de esta unidad y de sus subunidades. |
| Todos los empleados | Genera los datos de todos los empleados del espacio de trabajo. |
| Fecha de inicio | Dónde empieza el intervalo. Déjala vacía para empezar en la fecha de inicio del espacio de trabajo, o en la del contrato si es posterior. Una fecha anterior a cualquiera de ellas se adelanta hasta esa fecha. |
| Fecha de fin | Dónde termina el intervalo. Déjala vacía para terminar hoy. Se redondea hacia fuera para que todos los periodos de aprobación que toca el intervalo se generen completos. Como máximo, 24 meses después de la fecha de inicio. |
| Semanas del patrón | Cuántas semanas forman el patrón, de 1 a 8. Déjalo vacío para no rellenar nada: la tarea solo trabaja sobre los periodos que toca el intervalo, tal como están; consulta Probar una configuración completa. |
| Sobrescribir los registros de tiempo existentes | Sustituye el tiempo de trabajo que ya haya en un día de destino. Desactivado por defecto. |
| Aprobar automáticamente los resúmenes | Envía y aprueba cada periodo generado, del más antiguo al más reciente, en nombre del empleado y de su responsable. Desactivado por defecto. |
Elige exactamente una de las opciones Empleado, Unidad organizativa y Todos los empleados. Cada empleado se genera por separado, con su propio patrón, sus condiciones laborales y sus periodos. Con una unidad o con todos los empleados, un empleado que no se puede generar (sin condiciones laborales con aprobación de hojas de horas, con una ventana de patrón vacía…) se omite y aparece en la lista con el motivo, y los demás se generan; con un solo empleado, en cambio, la ejecución se detiene.
Qué hace la tarea con cada día
Recorriendo el intervalo generado día a día:
- Un festivo no se toca.
- Un día con una ausencia no se toca: unas vacaciones planificadas en el mes 7 se mantienen tal cual.
- Un día que ya tiene tiempo de trabajo no se toca, salvo que hayas marcado Sobrescribir.
- En los demás casos, se copia el día correspondiente del patrón: tanto los registros como los fichajes de entrada y de salida, a las mismas horas del día.
- Un día que el patrón deja en blanco recibe sus horas teóricas previstas. En un fin de semana o un festivo son cero, así que esos días quedan vacíos.
Después, la tarea evalúa los complementos y las horas extra en todos los días de los periodos que cubre: los días copiados y los que ya estaban, como los registros traídos con una importación, que de lo contrario no se evalúan hasta la ejecución nocturna. Por último, para cada periodo de aprobación que ha cubierto, crea el periodo y lo deja listo.
Enviar y aprobar te corresponde a ti, salvo que actives Aprobar automáticamente los resúmenes: recorrer tú mismo los periodos suele ser el objetivo del ejercicio, para seguir la cadena de saldos desde el cierre de cada periodo hasta la apertura del siguiente. Con la aprobación automática activada, la tarea envía y aprueba cada periodo por orden, de modo que se ejecuta la liquidación y el siguiente periodo se abre con el saldo liquidado. Se detiene en un periodo que no se puede enviar (una infracción bloqueante o un periodo anterior todavía abierto) e indica dónde.
Interpretar los resultados de la ejecución
| Campo | Significado |
|---|---|
source_window | Los días de los que se leyó el patrón |
resolved_span | Los días generados realmente, tras redondear a periodos completos |
days_written | Días que recibieron registros |
days_skipped | Días que no se tocaron, por motivo: holiday, leave, has_data, locked |
days_erased | Registros quitados por Sobrescribir |
days_reconciled | Días cuyos complementos u horas extra cambiaron al evaluarlos |
periods_ready | Periodos creados y dejados listos |
periods_skipped | Periodos que no se tocaron: ya estaban listos, o ya se habían enviado o aprobado |
periods_approved | Periodos enviados y aprobados (con la aprobación automática) |
employees, employees_skipped | Cuántos empleados se generaron y cuántos se omitieron |
per_employee | Los mismos recuentos por empleado, con el motivo por el que se omitió un empleado o dónde se detuvieron sus aprobaciones |
Con varios empleados, los recuentos son totales de todos ellos.
Compara days_skipped.holiday con los festivos que esperas en el año generado. Un recuento de cero en doce meses significa que el calendario de festivos no llega tan lejos.
Probar una configuración completa
Para comprobar que una configuración calcula las cifras correctas, incorpora empleados de prueba con un periodo completo de registros —mediante una importación o introduciéndolos a mano— y ejecuta la tarea con:
- Todos los empleados (o la unidad que estás probando),
- Fecha de inicio en el primer día del primer periodo y Fecha de fin en el último día del último,
- Semanas del patrón vacío, para que no se rellene nada: los registros quedan tal como los introdujiste, y un día que dejaste vacío sigue vacío,
- Aprobar automáticamente los resúmenes activado.
La tarea evalúa los complementos, aprueba los periodos y ejecuta la liquidación, de modo que los resúmenes muestran los saldos finales, listos para compararlos con lo que dicen las reglas. El equipo de implantación lo ejecuta desde un script con la clave de API del espacio de trabajo.
Volver a ejecutarla
Ejecutar la tarea una segunda vez con las mismas opciones no cambia nada: los días que ya tienen datos se omiten y los periodos que ya existen no se vuelven a crear. Para cambiar la forma del año, cambia la semana del patrón y vuelve a ejecutarla con Sobrescribir activado.
Solución de problemas
| Problema | Solución |
|---|---|
| La tarea no aparece en la lista | El espacio de trabajo no está marcado como espacio de trabajo de prueba |
| «no registrations between …» | La ventana del patrón está vacía: introduce primero la semana o haz que la fecha de inicio apunte a la semana que sí introdujiste |
| «months is no longer an option» | El intervalo de fechas ha sustituido a Meses: indica una fecha de inicio y una fecha de fin |
| «nothing to register norm time on» | La lista de actividades no tiene actividad predeterminada ni distribución porcentual: define una. Tener activado el plugin de relleno automático en la política de jornada no le da por sí mismo un destino |
| «do not enable timesheet approval» | Activa la aprobación de hojas de horas en las condiciones laborales del empleado |
| «exactly one of employee_id, org_unit_id or all_employees» | Elige un ámbito: un empleado, una unidad organizativa o Todos los empleados |
| Se ha omitido un empleado | per_employee indica el motivo, con los mismos mensajes que en esta tabla |
| Las aprobaciones se detuvieron en un periodo | per_employee indica el periodo y el motivo: una infracción bloqueante (como un día laborable sin registros) o un periodo anterior que todavía no está aprobado |
| La diferencia de cada periodo es todo el tiempo trabajado | Los días generados no tienen horas teóricas previstas: comprueba que las condiciones laborales cubren el año generado |
| Los festivos se generaron como días laborables | El calendario de festivos no cubre esos meses |
| Se ha omitido un periodo | Ya estaba enviado o aprobado; reábrelo primero si querías volver a generarlo |