Recent Posts

Recent Comments

Archives

Categories

OverTime/Add

Publicado
Updated
ByJavier Jaure

 


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

 

Descripción

Registrar horas extra para uno o más usuarios de la empresa asociada al token de autenticación. Recibe un
array de horas extra (una operación por rango de fechas y usuario). . La empresa se determina a partir de las credenciales; no se envía en el request.

Request

Request Body

Arreglo de objetos con los siguientes campos:

Campos Tipo de dato Descripción
UserIdentifier String Identificador del usuario al que se le asignan las horas extra (ej. RUT, DNI). Debe corresponder a un usuario
activo de la empresa. Requerido.
StartDateOvertime String Fecha de inicio de las horas extra, formato yyyyMMdd (ej. 20260701). Requerido.
EndDateOvertime String Fecha de fin de las horas extra, formato yyyyMMdd. Internamente se completa hasta las 23:59:59 del día.
Requerido.
DurationBefore String Duración de las horas extra antes de la jornada, formato HH:mm. Opcional.
DurationAfter String Duración de las horas extra después de la jornada, formato HH:mm. Opcional.
OvertimeValueBefore Integer Valor (tipo) de la hora extra antes de la jornada. Debe ser un entero que exista y esté
habilitado en la empresa.
OvertimeValueAfter Integer Valor (tipo) de la hora extra después de la jornada. Debe ser un entero que exista y esté
habilitado en la empresa.
OvertimeCreatedBy String Nombre/identificación de quién crea la hora extra; queda registrado como creador. Opcional.
CreatedByIdentifier String Identificador del usuario creador de la hora extra. Si corresponde a un usuario activo, se registra su nombre; en
caso contrario se registra como creada por la Customer API. Opcional.

Ejemplo request

[
            {
                "UserIdentifier": "12345678-9",
                "StartDateOvertime": "20260701",
                "EndDateOvertime": "20260701",
                "DurationBefore": "01:00",
                "DurationAfter": "02:00",
                "OvertimeValueBefore": "50",
                "OvertimeValueAfter": "50",
                "CreatedByIdentifier": "11111111-1"
            }
        ]

 

Importante

  • El body es un array: permite cargar horas extra de varios usuarios/fechas en una sola
    llamada.
  • UserIdentifier debe corresponder a un usuario activo de la empresa.
  • Los campos OvertimeValueBefore y OvertimeValueAfter deben ser enteros y
    corresponder a valores de hora extra existentes y habilitados en la empresa; en caso contrario la
    solicitud es rechazada.
  • Las fechas usan el formato yyyyMMdd.
  • 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:

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 Boolean Resultado de la ejecución: true si las horas extra se procesaron correctamente.

 

Códigos

 

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

Ejemplo response

{
            "Success": true,
            "Message": "",
            "Response": true
        }
Tabla de contenidos