TimeOff/GetPending
POST
https://customerapi.geovictoria.com/api/v1/TimeOff/GetPending
Descripción
Retorna una lista de aquellos permisos asignados a usuarios pendientes de consultar. Se refiere a ellos como “novedades“, es decir, que no han sido consultados.
Importante
- El último permiso listado será marcado para que la siguiente consulta inicie con el siguiente permiso del último marcado.
- Retorna un máximo de 1.000 permisos por petición.
Request
Request Body
No hay body en la solicitud
Response
Response Body
| Campos | Tipo de dato | Descripción |
|---|---|---|
| TimeOffTypeId | String | Identificador único y encriptado del permiso. |
| Starts | String | Fecha y hora en que inicia el permiso completo en formato yyyyMMddHHmmss |
| Ends | String | Fecha y hora en que finaliza el permiso completo en forma yyyyMMddHHmmss |
| TimeOffTypeDescription | String | Nombre/Descripción del tipo de permiso |
| Description | String | Comentario del permiso asignado al usuario |
| TimeOffOrigin | String | Origen o procedencia desde donde fue asignado el permiso al usuario |
| UserIdentifier | String | Identificador del usuario |
| StartTime | String | Hora de inicio del permiso parcial fijo por horas en formato hh:mm:ss |
| EndTime | String | Hora de fin del permiso parcial fijo por horas en formato hh:mm:ss |
| AmountHours | String | Cantidad de horas que tiene el permiso parcial en formato hh:mm |
Importante
- Si no hay permisos pendientes, se retorna una lista vacía.
- Los permisos pueden estar activos o inactivos.
- Los permisos pueden ser o no remunerados , es decir, ser pagados o no.
- Si el permiso es no remunerado:
- Puede descontar horas de las horas trabajadas
- Si el permiso es no remunerado:
- Los permisos pueden ser parciales: el empleado puede ausentarse parte de su jornada laboral.
- Si el permiso es parcial:
- Puede ser fijo por horas o no
- Si no es fijo por horas, tiene cantidad de horas que dura el permiso.
- Si el permiso es parcial:
- En plataforma se puede ver en Configuraciones > Permisos del sistema
- La plataforma cuenta con 15 permisos comúnmente utilizados, los que se especifican en la Tabla Permisos Comunes
Códigos
| Código | Descripción |
|---|---|
| 200 | Éxito |
| 400 | Error en el request |
| 500 | Error no controlado, contactar a GV |
[
{
"TimeOffTypeId": "fu2jVhqn1Vk_7yU6GClkzg",
"Description": "Permiso pedido por causas religiosas",
"Starts": "20240612000000",
"Ends": "20240612235959"
"Time0ffTypeDescription": "Permiso Completo: Con Goce de Sueldo",
"TimeOffOrigin": "web",
"UserIdentifier": "19111111k",
"StartTime": "00:00:00",
"EndTime": "00:00:00",
"AmountHours": "00:00"
},
{
"TimeOffTypeId": "cih_h7AP2kWtdbkthGxkwg",
"Description": "Permiso pedido vacaciones extras",
"Starts": "20240612000000"
"Ends": "20240612235959",
"TimeOffTypeDescription": "Permiso Completo: SinGoceSueldo - SinDescuentoHoras",
"TimeOffOrigin": "web",
"UserIdentifier": "19113333k",
"StartTime": "00:00:00",
"EndTime": "00:00:00",
"AmountHours": "00:00"
},
{
"TimeOffTypeId": "IPjrHxrAlkX0q-k3ai¡r9A",
"Description": "Permiso pedido por causas personales",
"Starts": "20240612000000",
"Ends": "20240612235959",
"TimeOffTypeDescription": "Permiso Completo: SinGoceSueldo - ConDescuentoHoras",
"TimeOffOrigin": "web",
"UserIdentifier": "19112222k",
"StartTime": "00:00:00",
"EndTime": "00:00:00",
"AmountHours": "00:00"
},
{
"TimeOffTypeId": "4I_2Hy52psuYx£Ccnz6ruQ",
"Starts": "20240612000000",
"Ends": "20240612235959",
"TimeOffTypeDescription": "Permiso Parcial: ConGoceSueldo - FijoPorHoras",
"TimeOffOrigin": "web",
"UserIdentifier": "19114444k",
"StartTime": "09:00:00",
"EndTime": "00:00:00",
"AmountHours": "00:00"
},
{
"TimeOffTypeId": "VTrrGqqcpKRIrIetjWW8Wg" ,
"Description": "Permiso de urgencia",
"Starts": "20240612000000",
"Ends": "20240612235959",
"TimeOffTypeDescription": "Permiso Parcial: ConGoceSueldo - CantidadHoras",
"TimeOffOrigin": "web",
"UserIdentifier": "19331111k",
"StartTime": "00:00:00"
"EndTime": "00:00:00",
"AmountHours": "02:00"
},
{
"TimeOffTypeId": "mv1iERMj0OrkSUtxfS9MEw",
"Description": "Comentario del permiso al asignarlo",
"Starts": "20240612000000",
"Ends": "20240612235959",
"TimeOffTypeDescription": "Permiso Parcial: SinGoceSueldo - SinDescuentoHoras - FijoPorHoras",
"TimeOffOrigin": "web",
"UserIdentifier": "19332222k",
"StartTime": "14:00:00",
"EndTime": "15:00:00",
"AmountHours": "00:00"
},
{
"TimeOffTypeId": "z7gHhOiKfL1WRF5D378aAQ",
"Description": "Permiso parcial otorgado sin goce de sueldo",
"Starts": "20240612000000",
"Ends": "20240612235959",
"TimeOffTypeDescription": "Permiso Parcial: SinGoceSueldo - SinDescuentoHoras - CantidadHoras",
"TimeOffOrigin": "web",
"UserIdentifier": "110000007",
"StartTime": "00:00:00",
"EndTime": "00:00:00",
"AmountHours": "02:00"
},
{
"TimeOffTypeId": "At67wgLI7YRmJ4KE_pHX7A",
"Description": "Permiso parcial sin remuneración",
"Starts": "20240612000000",
"Ends": "20240612235959",
"TimeOffTypeDescription": "Permiso Parcial: SinGoceSueldo - ConDescuentoHoras - FijoPorHoras",
"TimeOffOrigin": "web",
"UserIdentifier": "198883337",
"StartTime": "17:00:00",
"EndTime": "18:00:00",
"AmountHours": "00:00"
},
{
"TimeOffTypeId": "pDCUD1B6-rzs4nVMqyCczA",
"Description": "Permiso sin remuneración, descuenta las horas trabajadas y en un cantidad de horas",
"Starts": "20240612000000",
"Ends": "20240612235959",
"TimeOffTypeDescription": "Permiso Parcial: SinGoceSueldo - ConDescuentoHoras - CantidadHoras",
"TimeOffOrigin": "web",
"UserIdentifier": "138797890",
"StartTime": "00:00:00",
"EndTime": "00:00:00",
"AmountHours": "02:00"
}
]
Postman
Ejemplo 1
Ejemplo 2
Ejemplo 3
Ejemplo 4
Ejemplo 1
Pendiente permisos completos

Ejemplo 2
Pendiente permisos parciales con goce de sueldo

Ejemplo 3
Pendiente permisos parciales sin goce de sueldo

Ejemplo 4
Caso en que no existen permisos pendientes de consulta
