Shift/Insert

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

Descripción

Agrega un nuevo turno

Request

Request Body

Campos	Largo	Requerido	Tipo de dato	Descripción
StartHour	5	Condicional	String	Hora de inicio del turno en formato hh:mm. Se utiliza en Turno Fijo y Banda Horaria.
MaxStartHour	5	Condicional	String	Hora máxima de inicio del turno en formato hh:mm. Se utiliza solo para Banda Horaria.
EndHour	5	Condicional	Strings	Hora de fin del turno en formato hh:mm. Se utiliza solo para Turno Fijo.
BreakStart	5	Condicional	String	Hora de inicio de colación en formato hh:mm. Se utiliza solo para Colación Fija.
BreakEnd	5	Condicional	String	Hora de fin de colación en formato hh:mm. Se utiliza solo para Colación Fija.
BreakMinutes	5	Condicional	Number	Minutos de colación. Se utiliza solo para Colación Libre.
ShiftHours	5	Condicional	Number	Horas de trabajo del turno en formato hh:mm. Se utiliza para Fijo por Horas y Banda Horaria.
Custom	20	Condicional	String	Detalle/comentario que se le puede agregar al turno, campo personalizado del turno.
ShiftDay	5	No	String	Para los turnos que terminan el mismo día que inicia se debe agregar el valor “fin”. Para los turnos que terminan posterior al día de inicio no se debe indicar valor.

Importante

 

• Los campos son requeridos según qué turno y colación que se quiera agregar.
• Existen tres tipos de Turnos:
  1. Turno Fijo
      Tiene Hora de Inicio “StartHour” y Hora de fin “EndHour“
  2. Fijo por Horas
      Establece una Cantidad de Horas que se deben lograr durante el día “ShiftHours“
  3. Banda Horaria
      Tiene una Hora de Inicio “StartHour“, Hora de Inicio Máxima “MaxStartHour” y Cantidad de Horas que se deben lograr “ShiftHours“

• Existen tres tipos de Colaciones:
  1. Sin Colación
  2. Colación Libre
      Considera Minutos de Colación “BreakMinutes“
  3. Colación Fija
      Solo existe para el Turno Fijo
      Considera Hora de Inicio de Colación “BreakStart” y Hora de Fin de la Colación “BreakEnd“
• El campo BreakMinutes no puede tener el valor 0.

Ejemplo request 1 – Turno Fijo Sin Colación

{
    "StartHour": "09:00",
    "EndHour": "18:30",
    "Custom": "TurnoFijoSinColacion"
}

Ejemplo request 2 – Turno Fijo Colación Libre

{
    "StartHour": "09:30",
    "EndHour": "19:00",
    "BreakMinutes": 60,
    "Custom": "TurnoFijoColaciLibre"
}

Ejemplo request 3 – Turno Fijo Colación Fija

{
    "StartHour": "09:30",
    "EndHour": "19:00",
    "BreakStart":"13:30",
    "BreakEnd":"14:30",
    "Custom": "TurnoFijoColacFija"
}

Ejemplo request 4 – Fijo por Horas Sin Colación

{
    "ShiftHours": "08:00",
    "Custom": "FijoHoraSinColacion"
}

Ejemplo request 5 – Fijo por Horas Colación Libre

{
    "ShiftHours": "08:00",
    "BreakMinutes": 60,
    "Custom": "FijoHoraColacioLibre"
}

Ejemplo request 6 – Banda Horaria Sin Colación

{
    "StartHour": "08:30",
    "MaxStartHour":"09:00",
    "ShiftHours": "08:00",
    "Custom": "FijHoraSnColacion"
}

Ejemplo request 7 – Banda Horaria Colación Libre

{
    "StartHour": "08:30",
    "MaxStartHour":"09:00",
    "ShiftHours": "08:00",
    "BreakMinutes": 60,
    "Custom": "BandaHorarColacLibre"
}

Response

Response Body

Campos	Tipo de dato	Descripción
–	String	Identificador único encriptado del turno

Importante

 

• Se retorna solo el identificador único encriptado del turno.

 

Códigos

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

Ejemplo response

"TmbIAVlO2KeoahHwhDEkaB" 

Postman

Ejemplo 1
Ejemplo 2
Ejemplo 3
Ejemplo 4
Ejemplo 5
Ejemplo 6
Ejemplo 7
Ejemplo 1

Turno Fijo – Sin Colación

Ejemplo 2

Turno Fijo – Colación Libre

Ejemplo 3

Turno Fijo – Colación Fija

Ejemplo 4

Fijo por Horas – Sin Colación

Ejemplo 5

Fijo por Horas – Colación Libre

Ejemplo 6

Banda Horaria – Sin Colación

Ejemplo 7

Banda Horaria – Colación Libre