Recent Posts

Recent Comments

Archives

Categories

OverTime/GetOvertime

Publicado
Updated
ByJavier Jaure

 


POST https://customerapi.geovictoria.com/api/v1/OverTime/GetOvertime

 

Descripción

Consultar las horas extra de uno o más usuarios de la empresa asociada al token de autenticación, dentro de un
rango de fechas. Devuelve, por día y usuario, el tiempo extra antes y después del turno, junto con el tiempo extra ya
aprobado. La empresa se determina a partir de las credenciales; no se envía en el request.

Request

Request Body

 

Campos Tipo de dato Descripción
StartDate String Fecha de inicio del rango a consultar, formato yyyyMMdd (ej. 20260701). Requerido.
EndDate String Fecha de fin del rango a consultar, formato yyyyMMdd. Requerido.
UserIdentifiers String Identificadores de los usuarios a consultar (ej. RUT, DNI), separados por coma. Ej. “12345678-9,11111111-1”.
Requerido.

Ejemplo request

{
            "StartDate": "20260701",
            "EndDate": "20260731",
            "UserIdentifiers": "12345678-9,11111111-1"
        }

 

Importante

  • El campo UserIdentifiers es obligatorio y admite varios identificadores separados
    por coma    .
  • Las fechas usan el formato yyyyMMdd.
  • La cantidad total de registros consultados (días × usuarios) no puede superar 1500; si se
    excede, la solicitud es rechazada.
  • Los tiempos de la respuesta se expresan en horas decimales (ej. “1.5” equivale a 1 hora 30
    minutos).
  • La empresa no se envía en el body: se determina a partir del token de autenticación.

Response

Response Body

La respuesta es un objeto con el resultado de la operación y la lista de horas extra por día y
usuario:

Campos Tipo de dato Descripción
Success Boolean Indica si la operación fue exitosa.
Message String Mensaje descriptivo del resultado (vacío o informativo en caso de éxito, detalle del error en caso de fallo).
Response Array Lista de horas extra por día y usuario. Vacía si no hay datos en el rango.
Response[].Date String Fecha del registro (formato yyyy-MM-dd HH:mm:ss).
Response[].UserIdentifier String Identificador del usuario.
Response[].ShiftExternalId String Identificador externo del turno asociado al día.
Response[].ExtraTimeBefore String Tiempo extra antes del turno, en horas decimales.
Response[].ExtraTimeAfter String Tiempo extra después del turno, en horas decimales.
Response[].ApprovedOvertimeBefore String Horas extra ya aprobadas antes del turno, en horas decimales.
Response[].ApprovedOvertimeAfter String Horas extra ya aprobadas después del turno, en horas decimales.

 

Códigos

 

Código Descripción
200 Éxito
400 Error en el request

Ejemplo response

{
            "Success": true,
            "Message": "",
            "Response": [
                {
                    "Date": "2026-07-01 00:00:00",
                    "UserIdentifier": "12345678-9",
                    "ShiftExternalId": "TURNO-001",
                    "ExtraTimeBefore": "0.5",
                    "ExtraTimeAfter": "2.0",
                    "ApprovedOvertimeBefore": "0.5",
                    "ApprovedOvertimeAfter": "1.0"
                }
            ]
        }
Tabla de contenidos