Recent Posts

Recent Comments

Archives

Categories

Shift/Insert

Publicado
Updated
ByCatalina Efigenia






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

Tabla de contenidos