Como podemos ayudarte?
TimeOff/Get
Descripción
Retorna una lista de permisos asociados a usuarios para un periodo específico.
Request
Request Body
| Campos | Largo | Requerido | Tipo de dato | Descripción |
|---|---|---|---|---|
| StartDate | 14 | Sí | String | Fecha y hora de inicio en formato yyyyMMddHHmmss del periodo que se quiere consultar |
| EndDate | 14 | Sí | String | Fecha y hora de fin en formato yyyyMMddHHmmss del periodo que se quiere consultar |
| UserIds | 30 | Sí | String | Identificadores únicos de los usuarios |
Importante
- Los UserIds no deben contener ni puntos ni guión.
- En plataforma, se pueden observar los permisos asignados a usuarios en un cierto periodo en Reportes > Gestión de Asistencia
{
"StartDate": "20240609000000",
"EndDate": "20240616000000",
"UserIds": "19111111k,19113333k,19114444k"
}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 asignados, se retorna una lista vacía.
- 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:
Códigos
| Código | Descripción |
|---|---|
| 200 | Éxito |
| 400 | Error en el request |
| 500 | Error no controlado, contactar a GV |
[
{
"TimeOffTypeId": "fu2jVhqn1Vk_7yU6GClkzg",
"Starts": "20240610000000",
"Ends": "20240610235959",
"TimeOffTypeDescription": "Permiso Completo: Con Goce de Sueldo",
"TimeOffOrigin": "web",
"Description": "Permiso otorgado por reunión del colegio",
"UserIdentifier": "19111111k",
"StartTime": "00:00:00",
"EndTime": "00:00:00",
"AmountHours": "00:00"
},
{
"TimeOffTypeId": "4I_2Hy52psuYxfCcnz6ruQ",
"Starts": "20240611000000",
"Ends": "20240611235959",
"TimeOffTypeDescription": "Permiso Parcial: ConGoceSueldo - FijoPorHoras",
"TimeOffOrigin": "web",
"UserIdentifier": "19113333k",
"StartTime": "00:00:00",
"EndTime": "16:20:00",
"AmountHours": "00:00"
},
{
"TimeOffTypeId": "4I_2Hy52psuYxfCcnz6ruQ",
"Starts": "20240612000000",
"Ends": "20240612235959",
"TimeOffTypeDescription": "Permiso Parcial: ConGoceSueldo - FijoPorHoras",
"TimeOffOrigin": "web",
"UserIdentifier": "19114444k",
"StartTime": "09:00:00",
"EndTime": "00:00:00",
"AmountHours": "00:00"
}
]
Postman
Ejemplo 1
Ejemplo 1
