Recent Posts

Recent Comments

Archives

Categories

Consolidated/Extended

Publicado
Updated
ByJavier Jaure

 


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

 

Descripción

Obtener el consolidado extendido del libro de asistencia con los valores calculados para un periodo de tiempo y
un conjunto de usuarios. A diferencia del consolidado básico, entrega además el detalle de días pagados y no
pagados, los totales de días, y las horas trabajadas en domingos y feriados. 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).
  • El campo TotalAccomplishedExtraTime es equivalente a
    TotalAuthorizedExtraTime; se incluye con un nombre más descriptivo.

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 autorizadas en el periodo, sumando las autorizadas antes y después de la jornada (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)
TotalAccomplishedExtraTime String Total de horas extra efectivamente cumplidas en el periodo (HH:MM). Equivalente a TotalAuthorizedExtraTime
WorkedSundays Number Cantidad de domingos asistidos en el periodo
WorkedSundaysHours String Total de horas trabajadas en domingos según planificación (HH:MM)
ActuallyWorkedSundaysHours String Total de horas realmente trabajadas en domingos (HH:MM)
WorkedHolidays Number Cantidad de feriados asistidos en el periodo
WorkedHolidaysHours String Total de horas trabajadas en feriados según planificación (HH:MM)
ActuallyWorkedHolidaysHours String Total de horas realmente trabajadas en feriados (HH:MM)
Totals Object Totales de días pagados y no pagados (ver detalle abajo)
PaidDays Object Desglose de días pagados (ver detalle abajo)
NonPaidDays Object Desglose de días no pagados (ver detalle abajo)

 

Totals

 

Campos Tipo de dato Descripción
PaidDays Number Cantidad total de días pagados
NonPaidDays Number Cantidad total de días no pagados

 

PaidDays

 

Campos Tipo de dato Descripción
RestDays Number Cantidad de días de descanso
WorkedDays Number Cantidad de días asistidos
Holidays Number Cantidad de feriados que el usuario no debe trabajar
Vacations Number Cantidad de días de vacaciones
PaidTimeOffDays Number Cantidad de días de permiso con goce de sueldo

 

NonPaidDays

 

Campos Tipo de dato Descripción
UnjustifiedAbsenseDays Number Cantidad de días de ausencia injustificada
Leaves Number Cantidad de días de licencia médica
NonPaidTimeOffDays Number Cantidad de días de permiso sin goce de sueldo
NonWorkedHolidays Number Cantidad de feriados que el usuario debe trabajar

 

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": {
              "101": "08:00",
              "102": "04:30"
          },
          "TotalAccomplishedExtraTime": "12:30",
          "WorkedSundays": 2,
          "WorkedSundaysHours": "16:00",
          "ActuallyWorkedSundaysHours": "15:30",
          "WorkedHolidays": 1,
          "WorkedHolidaysHours": "08:00",
          "ActuallyWorkedHolidaysHours": "08:00",
          "Totals": {
              "PaidDays": 24,
              "NonPaidDays": 6
          },
          "PaidDays": {
              "RestDays": 4,
              "WorkedDays": 18,
              "Holidays": 1,
              "Vacations": 1,
              "PaidTimeOffDays": 0
          },
          "NonPaidDays": {
              "UnjustifiedAbsenseDays": 1,
              "Leaves": 0,
              "NonPaidTimeOffDays": 0,
              "NonWorkedHolidays": 5
          }
      }
  ]
Tabla de contenidos