Tiempo personal

Este tutorial trata sobre la gestion de tiempo personal (vacaciones, enfermedad, permisos) de los empleados, incluyendo solicitudes, aprobaciones y consulta de saldos.

Solicitudes de tiempo personal

Las solicitudes de tiempo personal permiten a los empleados solicitar dias libres. Siguen un flujo de trabajo completo: en proceso, aprobado, rechazado y gozado.

Para acceder a las solicitudes:

1. Ir a "Nominas".
2. En "Tiempo personal", seleccionar "Solicitudes".

Listado de solicitudes

El listado muestra todas las solicitudes con su estado:

• En proceso (icono azul): solicitud pendiente de aprobacion.
• Aprobado (icono verde con una verificacion): solicitud aprobada pero aun no gozada.
• Rechazado (icono rojo): solicitud rechazada.
• Gozado (icono verde con doble verificacion): solicitud aprobada y ya gozada.

Cada fila muestra: ID, empleado, tipo de tiempo personal, fecha de inicio, fecha de fin, dias solicitados y estado.

Crear una solicitud de tiempo personal

1. Hacer clic en "Nuevo".
2. Completar los campos:

• Empleado: seleccionar el empleado solicitante.
• Tipo de tiempo personal: seleccionar el tipo (vacaciones, enfermedad, permiso personal, etc.).
• Fecha de inicio: primer dia de la ausencia.
• Fecha de fin: ultimo dia de la ausencia.
• Dias: cantidad de dias habiles solicitados.
• Notas: motivo o descripcion de la solicitud.

3. Opcionalmente, adjuntar archivos PDF de respaldo (certificado medico, carta de solicitud, etc.).
4. Hacer clic en "Guardar".

La solicitud queda en estado "En proceso".

Ver detalle de una solicitud

En el listado, hacer clic en la solicitud para ver el detalle completo:

Informacion general

• ID de la solicitud.
• Empleado.
• Tipo de tiempo personal.
• Fecha de inicio y fecha de fin.
• Dias solicitados.
• Notas.
• Saldo de tiempo personal del empleado (enlace al historial).

Pago en contratos de destajo

Para empleados contratados bajo la modalidad de destajo, el sistema muestra el calculo del pago de tiempo personal:

• Tabla con las nominas recientes usadas para el calculo del promedio: rango de fechas de cada nomina, dias trabajados y monto.
• Total de dias y monto considerado.
• Promedio diario: resultado de dividir el monto total entre los dias.
• Subtotal de pago de tiempo personal: promedio diario multiplicado por los dias de la solicitud.
• Para cada beneficio/deduccion aplicable a tiempo personal: nombre y monto calculado.
• Total a pagar: subtotal mas beneficios/deducciones asociados.

Este calculo se basa en la cantidad de nominas recientes configurada en "Configuraciones generales" para el promedio diario.

Documentos adjuntos

Si se adjuntaron archivos PDF, se muestran como enlaces de descarga.

Flujo de trabajo

Muestra las fases del flujo de trabajo con fecha, usuario e informacion relevante:

• En proceso: quien creo la solicitud y cuando.
• Aprobado: quien aprobo la solicitud y cuando.
• Gozado: cuando se marco como gozada.
• Rechazado: quien rechazo, la razon del rechazo y cuando (solo si aplica).

Aprobar una solicitud

1. En el detalle de la solicitud, hacer clic en "Aprobar" (icono de pulgar arriba).
2. La solicitud cambia a estado "Aprobado".

Rechazar una solicitud

1. En el detalle de la solicitud, hacer clic en "Rechazar" (icono de pulgar abajo).
2. Se abre un dialogo donde debe ingresar la "Razon del rechazo".
3. Hacer clic en "Confirmar rechazo".
4. La solicitud cambia a estado "Rechazado".

Desaprobar una solicitud

Si una solicitud fue aprobada pero aun no ha sido gozada, se puede revertir la aprobacion:

1. En el detalle de la solicitud aprobada, hacer clic en "Desaprobar".
2. La solicitud regresa a estado "En proceso".

Revertir un rechazo

Si una solicitud fue rechazada pero aun no ha sido gozada, se puede revertir el rechazo:

1. En el detalle de la solicitud rechazada, hacer clic en "Desrechazar".
2. La solicitud regresa a estado "En proceso".

Editar una solicitud

1. En el detalle de la solicitud, hacer clic en "Editar".
2. Solo se pueden editar solicitudes que esten en estado "En proceso" (no aprobadas ni rechazadas).
3. Modificar los campos necesarios.
4. Hacer clic en "Guardar".

Borrar una solicitud

En el detalle, hacer clic en "Borrar". Solo se pueden borrar solicitudes que esten en estado "En proceso" (no aprobadas ni rechazadas ni gozadas).

Imprimir una solicitud

En el detalle de la solicitud, hacer clic en "Imprimir" para generar una version imprimible usando la plantilla configurada.

Saldos de tiempo personal

Los saldos de tiempo personal muestran la cantidad de dias disponibles para cada empleado y el historial de movimientos.

Para acceder a los saldos:

1. Ir a "Nominas".
2. En "Tiempo personal", seleccionar "Saldos".

Listado de saldos

El listado muestra todos los empleados con su saldo de tiempo personal. Se puede filtrar por:

• Activos: empleados con contrato activo.
• Terminados: empleados con contrato terminado.
• Todos: ambos estados.

Cada fila muestra: empleado, dias disponibles, dias gozados, dias pendientes.

Ver detalle del saldo

En el listado, hacer clic en el empleado para ver el historial completo:

• Saldo actual: dias disponibles.
• Historial de movimientos: tabla con cada movimiento que afecta el saldo:
  • Solicitudes de tiempo personal (dias gozados).
  • Incidencias que descuentan dias de tiempo personal.
  • Corridas de nomina que incluyen pagos de tiempo personal.
  • Cada movimiento muestra la fecha, tipo, descripcion, dias sumados/restados y saldo resultante.

API (llamadas desde sistemas externos)

Listar solicitudes de tiempo personal

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/payroll/personal_time_off/personal_time_off_requests.json

Crear una solicitud de tiempo personal

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "personal_time_off_request": {
      "employee_id": "1",
      "personal_time_off_type_id": "1",
      "start_date": "2024-07-01",
      "end_date": "2024-07-05",
      "days": "5",
      "notes": "Vacaciones de verano"
    }
  }' \
  https://app.zauru.com/payroll/personal_time_off/personal_time_off_requests.json

Aprobar una solicitud

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/payroll/personal_time_off/personal_time_off_requests/1/approve.json

Listar saldos de tiempo personal

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/payroll/personal_time_off/personal_time_off_balances.json