🔍 ¿Qué hace este endpoint?

Este endpoint permite consultar las solicitudes de tiempo fuera de personas de la empresa asociada en Aleluya, utilizando el identificador único (company_id) indicado en la ruta. La información incluye:

Datos básicos de la persona: Nombre, tipo de contrato.
Datos de la solicitud: Fecha inicial y final de la solicitud, tipo de solicitud, estado, comentario y días de la solicitud de tiempo fuera.
Información de los filtros: Las solicitudes de tiempo fuera se pueden filtrar por estado, por nombre de la solicitud o por nombre de la persona.

🎯 ¿Cuándo usar este endpoint?

Para obtener el listado de solicitudes de tiempo fuera de personas que están asociadas a una empresa.
Para buscar solicitudes específicas por nombre de persona o concepto de nómina.
Para que administradores o responsables de nómina revisen solicitudes pendientes, aprobadas o rechazadas.

📌 Consideraciones importantes

Permisos y autenticación

Solo usuarios con acceso a la empresa y rol administrador (admin) o contador ( accountant) pueden ejecutar este endpoint. Los usuarios con rol revisor (reviewer) también tienen acceso de solo lectura.
Retorna 401 No autorizado si el token es inválido o el usuario no pertenece a la empresa
Retorna 403 No Autorizado si el usuario no tiene un rol autorizado

Paginación

Usa el parámetro page para navegar entre páginas (por defecto: 1)
Usa el parámetro per_page para cambiar la cantidad de registros por página (por defecto: 20, máximo: 50)

Búsqueda

Usa el parámetro search para buscar por nombre de la solicitud de tiempo fuera, nombre o número de documento de la persona.
La búsqueda es parcial y no sensible a mayúsculas/minúsculas.
Si no se incluye este parámetro, se retornan todas las solicitudes de tiempo fuera.

Filtros

Usa el parámetro filter para filtrar los registros por estado de la solicitud tiempo fuera. Valores permitidos: pending, rejected y approved.
Si no se incluye este parámetro, se retornan todas las solicitudes de tiempo fuera.

Ordenamiento

Las solicitudes se ordenan por fecha de inicio descendente (más recientes primero).
Dentro de la misma fecha, se ordenan por nombre y apellido de la persona alfabéticamente.

📘
Puedes usar los parámetros de paginación, búsqueda y filtros a la vez.

Requisitos previos: