Recent Posts

Recent Comments

Archives

Categories

Consolidated

Publicado
Updated
ByJavier Jaure

 


POST https://customerapi.geovictoria.com/api/v1/Consolidated

 

Descripción

Obtener el consolidado del libro de asistencia con los valores calculados (horas trabajadas, no trabajadas,
horas extra e inasistencias) para un periodo de tiempo y un conjunto de usuarios. Entrega un objeto por usuario con
los totales del periodo.

Request

Request Body

 

Campos Tipo de dato Descripción
StartDate String Fecha inicial de consulta. Formato yyyyMMddHHmmss. Requerido
EndDate String Fecha final de consulta. Formato yyyyMMddHHmmss. Requerido
UserIds String Lista de identificadores de usuario separados por coma. Requerido
IncludeAll Number Indica qué usuarios incluir. 0: solo usuarios habilitados. 1: todos los usuarios.

Ejemplo request

{
      "StartDate": "20240501000000",
      "EndDate": "20240531235959",
      "UserIds": "15715287,76831428",
      "IncludeAll": 0
  }

 

Importante

  • Los montos de horas se devuelven en formato HH:MM.
  • El campo AccomplishedExtraTime es un objeto cuyas claves corresponden al
    identificador del tipo de hora extra y su valor a las horas acumuladas de ese tipo (HH:MM).

Response

Response Body

 

Campos Tipo de dato Descripción
Identifier String Identificador único del usuario
WorkedHours String Total de horas trabajadas en el periodo (HH:MM)
NonWorkedHours String Total de horas no trabajadas en el periodo (HH:MM)
TotalAuthorizedExtraTime String Total de horas extra efectivamente cumplidas en el periodo (HH:MM)
TotalAuthorizedOvertime String Total de horas extra asignadas/autorizadas en el periodo (HH:MM)
Absent Number Cantidad de inasistencias en el periodo
AccomplishedExtraTime Object Detalle de horas extra cumplidas por tipo. La clave es el identificador del tipo de hora extra y el valor las
horas acumuladas (HH:MM)

 

Códigos

 

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

Ejemplo response

[
      {
          "Identifier": "15715287",
          "WorkedHours": "176:00",
          "NonWorkedHours": "08:00",
          "TotalAuthorizedExtraTime": "12:30",
          "TotalAuthorizedOvertime": "15:00",
          "Absent": 1,
          "AccomplishedExtraTime": {
              "100": "08:00",
              "50": "04:30"
          }
      }
  ]
Tabla de contenidos