Recent Posts

Recent Comments

Archives

Categories

Shift/List

Publicado
Updated
ByCatalina Efigenia






POST
https://customerapi.geovictoria.com/api/v1/Shift/List


Descripción

Obtiene una lista de los turnos existentes.

Request

Request Body

No hay solicitud

Importante

 

  • En plataforma, se puede ver en Planificaciones > Lista y creación de Turnos o Planificaciones > Calendario Planificación

 

Response

Response Body






Campos Tipo de dato Descripción
Id String Identificador encriptado y único del turno
StartTime String Hora de inicio del turno en formato hh:mm.

Se utiliza en Turno Fijo y Banda Horaria.
MaxStartTime String Hora máxima de inicio del turno en formato hh:mm.

Se utiliza solo para Banda Horaria.
ExitTime String Hora de fin del turno en formato hh:mm.

Se utiliza solo para Turno Fijo.
Type String Tipo de turno.

Existen seis tipos: FixedShift, FixedHours, NotWorking, FreeShift, NoShift y InPerson.
FixedShiftHours String Horas de trabajo del turno.

Se utiliza para Fijo por Horas y Banda Horaria.
ShiftDisplay String Nombre del turno que se muestra en la plataforma.
BreakType String Tipo de colación.

Existe tres tipos: NoLunch, FreeLunch y FixedLunch
BreakMinutes String Minutos de colación.
Se utiliza solo para Colación Libre.
BreakStart String Hora de inicio de colación en formato hh:mm.

Se utiliza solo para Colación Fija.
BreakEnd String Hora de fin de colación en formato hh:mm.

Se utiliza solo para Colación Fija.
Status String Status del turno, si está activo (enabled) o inactivo (disabled).
Custom String Campo personalizado del turno.


Importante

 

Existe dos tipos de turnos según cómo se crean:

a. Se crean por plataforma:

  • “FixedShift”:
    Turno Fijo
  • “FixedHours”:
    Fijo por Horas y  Banda Horaria

b. Turnos por defecto de la plataforma, tienen IDs negativos

  • “NotWorking”: Descanso
    ID: -1
    Días en que un empleado no tiene que trabajar.
    GV2: “No trabaja”
    GV3: “Descanso”
  • “FreeShift”: Horario libre
    ID: -2
    Turno en el que no se define la hora de marcaje, por lo que se asigna para todo el día. Se utiliza para situaciones en las que el empleado no tiene un horario fijo de marcaje, por ejemplo, en el caso de marcajes de casino.
    GV2 y GV3: “Horario libre”
  • “NoShift”: Sin Turno
    ID: -3
    Turno que indica que el empleado no tiene un turno asignado.
    GV2: “Sin Turno”, se asigna por defecto al libro de asistencia.
    GV3: “Presencial”
  • “InPerson”: Presencial
    ID: -4
    Equivalente a “FreeShift: Horario Libre”.
    Término creado por solicitud de cambio de nombre del turno realizado por una empresa en particular.
    GV2: No existe
    GV3: “Presencial”

 

 

Existen tres tipos de colaciones/almuerzo:

  • “NoLunch”: Sin Colación
    No hay tiempo de colación determinado

  • “FreeLunch”: Colación Libre
    Minutos de colación sin horario definido para ser tomado en del turno.
    Ejemplo: 60 min

  • “FixedLunch”: Colación Fija
    Tiempo de colación con horario definido para ser tomado en el turno
    Solo existe para Turno Fijo
    Ejemplo: de 13:00 a 14:00

 

Códigos






Código Descripción
200 Éxito
400 Error en el request
500 Error no controlado, contactar a GV


Ejemplo response

[   
  {
    "Id": "TmbIAVlO2KeoahHwhDEkaA",
    "StartTime": "09:00",
     "MaxStartTime": "",
    "ExitTime": "18:30",
    "Type": "FixedShift",
    "FixedShiftHours": "00:00",
    "ShiftDisplay": "09:00 - 18:30 ( No Lunch )",
    "BreakType": "NoLunch",
    "BreakMinutes": "",
    "BreakStart": "00:00",
    "BreakEnd": "00:00",
    "Status": "enabled",
    "Custom": "TurnoFijoSinColacion"
  },   
  {
    "Id": "lVEEQaakLzHV8F3Wuv-Xug",
    "StartTime": "09:00",
    "MaxStartTime": "",
    "ExitTime": "18:30",
    "Type": "FixedShift",
    "FixedShiftHours": "00:00",
    "ShiftDisplay": "09:00 - 18:30 (60 mins)",
    "BreakType": "FreeLunch",
    "BreakMinutes": "60",
    "BreakStart": "00:00",
    "BreakEnd": "00:00",
    "Status": "enabled",
    "Custom": "TurnoFijoColaciLibre"
  },
  {
    "Id": "WewWx0t3z9R2RLIibRV-iA",
    "StartTime": "09:00",
    "MaxStartTime": "",
    "ExitTime": "18:30",
    "Type": "FixedShift",
    "FixedShiftHours": "00:00",
    "ShiftDisplay": "09:00 - 18:30 (13:00-14:00)",
    "BreakType": "FixedLunch",
    "BreakMinutes": "",
    "BreakStart": "13:00",
    "BreakEnd": "14:00",
    "Status": "enabled",
    "Custom": "TurnoFijoColaciFija"
  },
 {
    "Id": "zq1IadJv_we0WZKmAygWSQ",
    "StartTime": "00:00",
    "MaxStartTime": "",
    "ExitTime": "00:00",
    "Type": "FixedHours",
    "FixedShiftHours": "08:00",
    "ShiftDisplay": "08:00:00 hrs. ( No Lunch )",
    "BreakType": "NoLunch",
    "BreakMinutes": "",
    "BreakStart": "00:00",
    "BreakEnd": "00:00",
    "Status": "enabled",
    "Custom": "FijoHorasSinColacion"
  },
  {
    "Id": "ifkVdP4DkakOGa3h-YKHpg",
    "StartTime": "00:00",
    "MaxStartTime": "",
    "ExitTime": "00:00",
    "Type": "FixedHours",
    "FixedShiftHours": "08:00",
    "ShiftDisplay": "08:00:00 hrs. (60 mins)",
    "BreakType": "FreeLunch",
    "BreakMinutes": "60",
    "BreakStart": "00:00",
    "BreakEnd": "00:00",
    "Status": "enabled",
    "Custom": "FijoHorasConColacion"
  },
  {
    "Id": "Mv2OEImzPpO07WVsoa6Bew",
    "StartTime": "08:30",
    "MaxStartTime": "09:00",
    "ExitTime": "00:00",
    "Type": "FixedHours",
    "FixedShiftHours": "09:00",
    "ShiftDisplay": "09:00:00 hrs. ( No Lunch )",
    "BreakType": "NoLunch",
    "BreakMinutes": "60",
    "BreakStart": "00:00",
    "BreakEnd": "00:00",
    "Status": "enabled",
    "Custom": "BandaHorariaSinColac"
  },
  {
    "Id": "NJdtLIRxo-svfPyY6RkQug",
    "StartTime": "08:30",
    "MaxStartTime": "09:00",
    "ExitTime": "00:00",
    "Type": "FixedHours",
    "FixedShiftHours": "09:00",
    "ShiftDisplay": "09:00:00 hrs. (60 mins)",
    "BreakType": "FreeLunch",
    "BreakMinutes": "60",
    "BreakStart": "00:00",
    "BreakEnd": "00:00",
    "Status": "enabled",
    "Custom": "BandaHorariaConColac"
  }
]

Postman

Ejemplo 1
Ejemplo 2
Ejemplo 3
Ejemplo 1

Ejemplo 2

Ejemplo 3

Tabla de contenidos