OverTime/Delete

 


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

 

Descripción

Eliminar horas extra previamente registradas para uno o más usuarios de la empresa asociada al token de
autenticación. Recibe un array de eliminaciones; cada elemento indica el usuario, la fecha y la
cantidad de horas extra a quitar (antes y/o después de la jornada). Devuelve el detalle de lo eliminado. La empresa se
determina a partir de las credenciales; no se envía en el request.

Request

Request Body

Objeto con un campo Deletions, que es un array de objetos con los siguientes campos:

Campos Tipo de dato Descripción
UserIdentifier String Identificador del usuario dueño de las horas extra (ej. RUT, DNI). Requerido.
Date String Fecha de las horas extra a eliminar, formato yyyyMMdd (ej. 20260701). Requerido.
DurationBefore String Cantidad de horas extra a eliminar antes de la jornada, formato HH:mm. No puede superar las horas
extra existentes de ese día.
DurationAfter String Cantidad de horas extra a eliminar después de la jornada, formato HH:mm. No puede superar las
horas extra existentes de ese día.

Ejemplo request

{
            "Deletions": [
                {
                    "UserIdentifier": "12345678-9",
                    "Date": "20260701",
                    "DurationBefore": "01:00",
                    "DurationAfter": "02:00"
                }
            ]
}

 

Importante

  • El campo Deletions es un array: permite eliminar horas extra de varios
    usuarios/fechas en una sola llamada.
  • El campo Date debe venir en formato yyyyMMdd; un formato distinto rechaza
    la solicitud.
  • Debe existir hora extra registrada para el usuario en esa fecha; en caso contrario la solicitud es
    rechazada.
  • Las horas a eliminar (DurationBefore / DurationAfter) no pueden superar las
    horas extra existentes de ese día.
  • 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 el detalle de lo eliminado:

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 con el detalle de las horas extra eliminadas.
Response[].UserIdentifier String Identificador del usuario al que se le eliminaron horas extra.
Response[].Date String Fecha de las horas extra eliminadas (formato yyyyMMdd).
Response[].DeletedOvertimeBefore String Cantidad de horas extra eliminadas antes de la jornada (formato HH:mm).
Response[].DeletedOvertimeAfter String Cantidad de horas extra eliminadas después de la jornada (formato HH:mm).

 

Códigos

 

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

Ejemplo response

{
            "Success": true,
            "Message": "",
            "Response": [
                {
                    "UserIdentifier": "12345678-9",
                    "Date": "20260701",
                    "DeletedOvertimeBefore": "01:00",
                    "DeletedOvertimeAfter": "02:00"
                }
            ]
        }
Tabla de contenidos