Considera un centro de contacto para el que desees generar cambios de modo que se cubra la demanda de empleados. El centro de contacto funciona las 24 horas, todos los días, y la cantidad de empleados necesarios varía con el tiempo. El centro de contacto contrata empleados a tiempo completo y parcial.
Los empleados de tiempo completo realizan turnos de 9 horas, tienen un descanso de 1 hora después de 4 o 5 horas después del inicio de su turno y pueden comenzar su turno en cualquier momento entre las 5 a.m. y las 12 p.m. Los empleados de tiempo parcial realizan turnos de 4 horas con un descanso de 15 minutos al final de la segunda hora laboral y pueden comenzar su turno en cualquier momento. En ambos casos, las horas de inicio de los cambios posibles se consideran en incrementos de 15 minutos.
El centro de contacto está interesado en planificar los requisitos de personal para los próximos dos días, teniendo en cuenta que podría haber un máximo de 20 empleados a tiempo completo y 40 empleados de tiempo parcial.
Plantillas de turnos para empleados de tiempo completo y parcial
Las reglas que determinan los cambios válidos se pueden representar con una plantilla de cambio. Dentro de una plantilla de cambio, la noción de una pausa se puede representar con una plantilla de evento. Por ejemplo, la plantilla de turno de un empleado a tiempo completo se representa de la siguiente manera:
{
"id": "full-time",
"earliestStartTime": {
"hours": 5
},
"latestStartTime": {
"hours": 12
},
"durationMinutes": 540,
"startTimeIncrementMinutes": 15,
"eventTemplates": [
{
"id": "full-time-break",
"minimumMinutesAfterShiftStart": 240,
"maximumMinutesAfterShiftStart": 300,
"durationMinutes": 60,
"startTimeIncrementMinutes": 60
}
],
"maximumEmployeeCount": 20
}
Del mismo modo, la plantilla de turnos para un turno de empleado a tiempo parcial se representa de la siguiente manera:
{
"id": "part-time",
"earliestStartTime": {},
"latestStartTime": {
"hours": 23,
"minutes": 59
},
"durationMinutes": 240,
"startTimeIncrementMinutes": 15,
"eventTemplates": [
{
"id": "part-time-break",
"minimumMinutesAfterShiftStart": 120,
"maximumMinutesAfterShiftStart": 120,
"durationMinutes": 15,
"startTimeIncrementMinutes": 0
}
],
"maximumEmployeeCount": 40
}
Demanda de los empleados a lo largo del tiempo
La demanda de empleados se representa con una lista de EmployeeDemand, en la que cada uno de estos elementos se caracteriza por un intervalo de tiempo y un recuento de empleados. En este ejemplo, la demanda fluctúa entre 4 y 13 empleados durante un período de dos días y se representa de la siguiente manera:
{
...
"employeeDemands": [
{
"startDateTime": {
"year": 2024,
"month": 5,
"day": 20
},
"endDateTime": {
"year": 2024,
"month": 5,
"day": 20,
"hours": 12
},
"employeeCount": 8
},
{
"startDateTime": {
"year": 2024,
"month": 5,
"day": 20,
"hours": 12
},
"endDateTime": {
"year": 2024,
"month": 5,
"day": 20,
"hours": 20
},
"employeeCount": 12
},
{
"startDateTime": {
"year": 2024,
"month": 5,
"day": 20,
"hours": 20
},
"endDateTime": {
"year": 2024,
"month": 5,
"day": 21,
"hours": 6
},
"employeeCount": 4
},
{
"startDateTime": {
"year": 2024,
"month": 5,
"day": 21,
"hours": 6
},
"endDateTime": {
"year": 2024,
"month": 5,
"day": 22,
"hours": 0
},
"employeeCount": 13
}
]
}
Ejemplo de una solicitud completa
{
"solverConfig": {
"timeLimit": "30s"
},
"shiftTemplates": [
{
"id": "full-time",
"earliestStartTime": {
"hours": 5
},
"latestStartTime": {
"hours": 12
},
"durationMinutes": 540,
"startTimeIncrementMinutes": 15,
"eventTemplates": [
{
"id": "full-time-break",
"minimumMinutesAfterShiftStart": 240,
"maximumMinutesAfterShiftStart": 300,
"durationMinutes": 60,
"startTimeIncrementMinutes": 60
}
],
"maximumEmployeeCount": 20
},
{
"id": "part-time",
"earliestStartTime": {},
"latestStartTime": {
"hours": 23,
"minutes": 59
},
"durationMinutes": 240,
"startTimeIncrementMinutes": 15,
"eventTemplates": [
{
"id": "part-time-break",
"minimumMinutesAfterShiftStart": 120,
"maximumMinutesAfterShiftStart": 120,
"durationMinutes": 15,
"startTimeIncrementMinutes": 0
}
],
"maximumEmployeeCount": 40
}
],
"employeeDemands": [
{
"startDateTime": {
"year": 2024,
"month": 5,
"day": 20
},
"endDateTime": {
"year": 2024,
"month": 5,
"day": 20,
"hours": 12
},
"employeeCount": 8
},
{
"startDateTime": {
"year": 2024,
"month": 5,
"day": 20,
"hours": 12
},
"endDateTime": {
"year": 2024,
"month": 5,
"day": 20,
"hours": 20
},
"employeeCount": 12
},
{
"startDateTime": {
"year": 2024,
"month": 5,
"day": 20,
"hours": 20
},
"endDateTime": {
"year": 2024,
"month": 5,
"day": 21,
"hours": 6
},
"employeeCount": 4
},
{
"startDateTime": {
"year": 2024,
"month": 5,
"day": 21,
"hours": 6
},
"endDateTime": {
"year": 2024,
"month": 5,
"day": 22,
"hours": 0
},
"employeeCount": 13
}
]
}
Ejemplo de respuesta
La respuesta del solucionador contiene una lista de los horarios de los empleados con su cantidad correspondiente de empleados requeridos. Si no es posible cubrir la demanda de manera exacta, la respuesta también enumerará los incumplimientos en cada intervalo de tiempo relevante.
En el siguiente ejemplo, se muestra uno de los horarios de empleados generados para un empleado a tiempo completo:
{
"solutionStatus": "SHIFT_GENERATION_SOLVED",
"employeeSchedules": [
{
"shiftTemplateId": "full-time",
"shifts": [
{
"startDateTime": {
"year": 2024,
"month": 5,
"day": 21,
"hours": 7,
"minutes": 30
},
"endDateTime": {
"year": 2024,
"month": 5,
"day": 21,
"hours": 16,
"minutes": 30
},
"events": [
{
"startDateTime": {
"year": 2024,
"month": 5,
"day": 21,
"hours": 12,
"minutes": 30
},
"endDateTime": {
"year": 2024,
"month": 5,
"day": 21,
"hours": 13,
"minutes": 30
},
"eventTemplateId": "full-time-break"
}
]
}
],
"employeeCount": 1
},
...
]
...
}