TimeOff/Upsert

 

POST
https://customerapi.geovictoria.com/api/v1/TimeOff/Upsert

Descripción

Asignar un permiso a un usuario en una fecha específica.

Request

Request Body

 

 

Campos	Largo	Requerido	Tipo de dato	Descripción
UserIdentifier	16	Sí	String	Identificador único del usuario al que se le asignará el permiso
TimeOffTypeId	30	Sí	String	Identificador único y encriptado del tipo de permiso que será asignado.
StartDate	14	Sí	String	Fecha y hora en que inicia el permiso completo en formato yyyyMMddHHmmss
EndDate	14	Sí	String	Fecha y hora en que finaliza el permiso completo en forma yyyyMMddHHmmss
StartTime	5	Sí	String	Hora de inicio del permiso parcial fijo por horas en formato HH:mm:
EndTime	5	Sí	String	Hora de fin del permiso parcial fijo por horas en formato HH:mm
Hours	5	No	String	Cantidad de horas que tiene el permiso parcial en formato HH:mm
Description	300	No	String	Descripción del permiso asignado
TypeOffAssigment	300	No	String	Define si el permiso de media jornada se asigna a la primera parte de la jornada o a la última. Posibles valores: “start” y “end”.

 

Importante

• Solo se pueden asignar permisos que ya fueron creados.
• El campo «TimeOffTypeId» para identificar el permiso se puede obtener del campo «TimeOffTypeId» del endpoint TimeOff/Get o del campo «Id» de TimeOff/GetTypes.
• El campo UserIdentifier para identificar el usuario se puede obtener del campo «Identifier» de User/List.
• El campo TypeOffAssigment es utilizado solo para la asignación de permisos parciales de media jornada.

Ejemplo 1 Permiso Completo

{
    "UserIdentifier": "19111111k",
    "TimeOffTypeId": "WBlTS2dvAOwN4Kk7XZliiA",
    "StartDate": "20240619000000",
    "EndDate": "20240619235959"
}

Ejemplo 2 Permiso Parcial – Fijo por Horas

{
    "UserIdentifier": "19111111k",
    "TimeOffTypeId": "4I_2Hy52psuYxfCcnz6ruQ",
    "StartDate": "20240621000000",
    "EndDate": "20240621235959",
    "StartTime": "14:00",
    "EndTime": "17:00"
}

Ejemplo 3 Permiso Parcial – Cantidad de Horas

{
    "UserIdentifier": "19111111k",
    "TimeOffTypeId": "z7gHhOiKfL1WRF5D378aAQ",
    "StartDate": "20240621000000",
    "EndDate": "20240621235959",
    "Hours": "04:00"
}

Ejemplo 4 Permiso Parcial – Media Jornada 

{
    "UserIdentifier": "19111111k",
    "TimeOffTypeId": "z7gHhOiKfL1WRF5D37dfsAQ",
    "StartDate": "20240621000000",
    "EndDate": "20240621235959",
    "TypeOffAssigment": "start"
}

Response

Response Body

 

 

Campos	Tipo de dato	Descripción
–	Boolean	Boleano que representa si fue exitoso la asignación del permiso al usuario.

 

Códigos

 

 

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

Ejemplo response

true

Postman

Ejemplo 1
Ejemplo 2
Ejemplo 3
Ejemplo 1

Permiso Completo

Ejemplo 2

Permiso Parcial y Fijo por Horas 

Ejemplo 3

Permiso Parcial y Cantidad de horas