Recent Posts

Recent Comments

Archives

Categories

TimeOff/Get

Publicado
Updated
ByAlex Diaz






POST
https://customerapi.geovictoria.com/api/v1/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

 

Ejemplo request

{
    "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
  • 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

 

Códigos






Código Descripción
200 Éxito
400 Error en el request
500 Error no controlado, contactar a GV



Ejemplo response

[
    {
        "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

Tabla de contenidos