Manage Workforce Schedule Creation
Organizations can use a third-party scheduling application to manage their workforce schedule. Oracle Fusion Cloud Workforce Scheduling can import these schedules by performing a POST operation on the scheduleRequests resource.
Schedule managers can verify imported schedules using the Workforce Schedules page.
Create a Workforce Schedule
Let's say that a department for a clinic in San Francisco has a nurse practitioner, Alan Smith, scheduled Monday through Friday on an 8 AM to 6 PM shift. The department has one open 8 AM to 6 PM shift for a registered nurse to cover from Monday through Friday.
Workforce Scheduling imports the schedule for the clinic using a POST operation on
the scheduleRequests resource with these attribute values.
- importMode is FULL for the scheduleRequests resource.
- importMode is FULL for the scheduleEvents resource.
- shiftAction is CREATE for the scheduleShiftEvents resource.
Here's the Workforce Scheduling configuration that applies to this scenario.
| Configuration | Purpose |
| Enterprise Shifts | Define a shift for all shifts to be imported. |
| Schedule Generation Profiles | Define schedule generation profiles to identify staffing departments, the scheduling period, and other configuration options. |
| Work Patterns | Define work patterns for workers. |
| Manage Common Lookups |
Review the lookup type ORA_HWM_SHIFT_ENTRY_OWNER values. For shifts imported from a third-party scheduling app, the RequestSource field in the ScheduleRequest object is controlled by the owner.
|
To create a department's workforce schedules:
- Extract from your third-party scheduling application, the schedules for the departments and the required period.
- Load the extracted data to Oracle Fusion Cloud Workforce Scheduling using the
scheduleRequests REST service.
- Perform a POST operation on the scheduleRequests REST resource by using the sample payload.
- Verify the details returned in the response.
- Create the workforce schedules by running the Process Imported Shifts process to add the imported shift to the workforce schedule.
Example URL
Use this resource URL format.
POST
/hcmRestApi/resources/11.13.18.05/scheduleRequestsExample Request
Here's an example of the request body in JSON format:
{
"scheduleRequestNumber": "Import001",
"requestTime": "2025-01-01T12:00:00.010+01:00",
"requestSource": "ORA_HWM_WFM",
"importMode": "FULL",
"startDate": "2025-06-02",
"endDate": "2025-06-08",
"validationFlag": "Y",
"departmentName": "Clinic",
"locationCode": "SAN_FRAN",
"locationSetCode": "COMMON",
"scheduleEvents": [
{
"scheduleEventNumber": "SE101",
"resourceReferenceType": "PERSON_NUMBER",
"resourceReference": "CLINIC_001",
"importMode": "FULL",
"scheduleShiftEvents": [
{
"scheduleShiftEventNumber": "SSE101-1",
"shiftNumber": "SSE101-1",
"shiftAction": "CREATE",
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-02",
"jobProfileType": "ORA_JOB",
"jobProfile": "NP",
"jobSetCode": "COMMON"
},
{
"scheduleShiftEventNumber": "SSE101-2",
"shiftNumber": "SSE101-2",
"shiftAction": "CREATE",
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-03",
"jobProfileType": "ORA_JOB",
"jobProfile": "NP",
"jobSetCode": "COMMON"
},
{
"scheduleShiftEventNumber": "SSE101-3",
"shiftNumber": "SSE101-3",
"shiftAction": "CREATE",
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-04",
"jobProfileType": "ORA_JOB",
"jobProfile": "NP",
"jobSetCode": "COMMON"
},
{
"scheduleShiftEventNumber": "SSE101-4",
"shiftNumber": "SSE101-4",
"shiftAction": "CREATE",
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-05",
"jobProfileType": "ORA_JOB",
"jobProfile": "NP",
"jobSetCode": "COMMON"
},
{
"scheduleShiftEventNumber": "SSE101-5",
"shiftNumber": "SSE101-5",
"shiftAction": "CREATE",
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-06",
"jobProfileType": "ORA_JOB",
"jobProfile": "NP",
"jobSetCode": "COMMON"
}
]
},
{
"scheduleEventNumber": "SE102",
"resourceReferenceType": "OPEN_SHIFT",
"importMode": "FULL",
"scheduleShiftEvents": [
{
"scheduleShiftEventNumber": "SSE102-1",
"shiftNumber": "SSE102-1",
"shiftAction": "CREATE",
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-02",
"jobProfileType": "ORA_JOB",
"jobProfile": "RN",
"jobSetCode": "COMMON"
},
{
"scheduleShiftEventNumber": "SSE102-2",
"shiftNumber": "SSE102-2",
"shiftAction": "CREATE",
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-03",
"jobProfileType": "ORA_JOB",
"jobProfile": "RN",
"jobSetCode": "COMMON"
},
{
"scheduleShiftEventNumber": "SSE102-3",
"shiftNumber": "SSE102-3",
"shiftAction": "CREATE",
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-04",
"jobProfileType": "ORA_JOB",
"jobProfile": "RN",
"jobSetCode": "COMMON"
},
{
"scheduleShiftEventNumber": "SSE102-4",
"shiftNumber": "SSE102-4",
"shiftAction": "CREATE",
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-05",
"jobProfileType": "ORA_JOB",
"jobProfile": "RN",
"jobSetCode": "COMMON"
},
{
"scheduleShiftEventNumber": "SSE102-5",
"shiftNumber": "SSE102-5",
"shiftAction": "CREATE",
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-06",
"jobProfileType": "ORA_JOB",
"jobProfile": "RN",
"jobSetCode": "COMMON"
}
]
}
]
}Example Response
Here's an example of the response body in JSON format.
Status 201
{
"scheduleRequestNumber": "Import001",
"requestSource": "ORA_HWM_WFM",
"schedRequestId": 300100658212780,
"requestTime": "2025-01-01T12:00:00.010+01:00",
"importMode": "FULL",
"startDate": "2025-06-02",
"endDate": "2025-06-08",
"validationFlag": true,
"departmentName": "Clinic",
"locationCode": "SAN_FRAN",
"locationSetCode": "COMMON",
"locationId": null,
"departmentId": null,
"scheduleEvents": [
{
"resourceReferenceType": "PERSON_NUMBER",
"resourceReference": "CLINIC_001",
"importMode": "FULL",
"periodStartDate": "2025-06-02",
"periodEndDate": "2025-06-08",
"publish": null,
"workerNotification": null,
"allowEdits": null,
"schedEventId": 300100658212781,
"schedRequestId": 300100658212780,
"scheduleEventNumber": "SE101",
"scheduleShiftEvents": [
{
"shiftDuration": null,
"shiftNumber": "SSE101-1",
"shiftAction": "CREATE",
"referenceDay": null,
"shiftStartTime": null,
"shiftEndTime": null,
"shiftTimeNotWorked": null,
"shiftCategory": null,
"shiftCode": null,
"shiftType": null,
"schedShiftEventId": 300100658212782,
"schedEventId": 300100658212781,
"allowEdits": null,
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-02",
"paidBreakDuration": null,
"unpaidBreakDuration": null,
"comments": null,
"premiumShiftCode": null,
"allowOvertimeFlag": null,
"workforceShiftCategory": null,
"shiftIncentive": null,
"otherQualification": null,
"otherQualificationType": null,
"jobProfile": "NP",
"jobProfileType": "ORA_JOB",
"jobSetCode": "COMMON",
"businessUnitName": null,
"scheduleShiftEventNumber": "SSE101-1",
"links": : [
{...
}
}
],
{
"shiftDuration": null,
"shiftNumber": "SSE101-2",
"shiftAction": "CREATE",
"referenceDay": null,
"shiftStartTime": null,
"shiftEndTime": null,
"shiftTimeNotWorked": null,
"shiftCategory": null,
"shiftCode": null,
"shiftType": null,
"schedShiftEventId": 300100658212783,
"schedEventId": 300100658212781,
"allowEdits": null,
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-03",
"paidBreakDuration": null,
"unpaidBreakDuration": null,
"comments": null,
"premiumShiftCode": null,
"allowOvertimeFlag": null,
"workforceShiftCategory": null,
"shiftIncentive": null,
"otherQualification": null,
"otherQualificationType": null,
"jobProfile": "NP",
"jobProfileType": "ORA_JOB",
"jobSetCode": "COMMON",
"businessUnitName": null,
"scheduleShiftEventNumber": "SSE101-2",
"links": [
{...
}
]
},
{
"shiftDuration": null,
"shiftNumber": "SSE101-3",
"shiftAction": "CREATE",
"referenceDay": null,
"shiftStartTime": null,
"shiftEndTime": null,
"shiftTimeNotWorked": null,
"shiftCategory": null,
"shiftCode": null,
"shiftType": null,
"schedShiftEventId": 300100658212784,
"schedEventId": 300100658212781,
"allowEdits": null,
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-04",
"paidBreakDuration": null,
"unpaidBreakDuration": null,
"comments": null,
"premiumShiftCode": null,
"allowOvertimeFlag": null,
"workforceShiftCategory": null,
"shiftIncentive": null,
"otherQualification": null,
"otherQualificationType": null,
"jobProfile": "NP",
"jobProfileType": "ORA_JOB",
"jobSetCode": "COMMON",
"businessUnitName": null,
"scheduleShiftEventNumber": "SSE101-3",
"links": [
{...
}
]
},
{
"shiftDuration": null,
"shiftNumber": "SSE101-4",
"shiftAction": "CREATE",
"referenceDay": null,
"shiftStartTime": null,
"shiftEndTime": null,
"shiftTimeNotWorked": null,
"shiftCategory": null,
"shiftCode": null,
"shiftType": null,
"schedShiftEventId": 300100658212785,
"schedEventId": 300100658212781,
"allowEdits": null,
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-05",
"paidBreakDuration": null,
"unpaidBreakDuration": null,
"comments": null,
"premiumShiftCode": null,
"allowOvertimeFlag": null,
"workforceShiftCategory": null,
"shiftIncentive": null,
"otherQualification": null,
"otherQualificationType": null,
"jobProfile": "NP",
"jobProfileType": "ORA_JOB",
"jobSetCode": "COMMON",
"businessUnitName": null,
"scheduleShiftEventNumber": "SSE101-4",
"links": [
{...
}
]
},
{
"shiftDuration": null,
"shiftNumber": "SSE101-5",
"shiftAction": "CREATE",
"referenceDay": null,
"shiftStartTime": null,
"shiftEndTime": null,
"shiftTimeNotWorked": null,
"shiftCategory": null,
"shiftCode": null,
"shiftType": null,
"schedShiftEventId": 300100658212786,
"schedEventId": 300100658212781,
"allowEdits": null,
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-06",
"paidBreakDuration": null,
"unpaidBreakDuration": null,
"comments": null,
"premiumShiftCode": null,
"allowOvertimeFlag": null,
"workforceShiftCategory": null,
"shiftIncentive": null,
"otherQualification": null,
"otherQualificationType": null,
"jobProfile": "NP",
"jobProfileType": "ORA_JOB",
"jobSetCode": "COMMON",
"businessUnitName": null,
"scheduleShiftEventNumber": "SSE101-5",
"links": [
{...
}
]
}
],
"links": [
{...
}
]
},
{
"resourceReferenceType": "OPEN_SHIFT",
"resourceReference": null,
"importMode": "FULL",
"periodStartDate": "2025-06-02",
"periodEndDate": "2025-06-08",
"publish": null,
"workerNotification": null,
"allowEdits": null,
"schedEventId": 300100658212787,
"schedRequestId": 300100658212780,
"scheduleEventNumber": "SE102",
"scheduleShiftEvents": [
{
"shiftDuration": null,
"shiftNumber": "SSE102-1",
"shiftAction": "CREATE",
"referenceDay": null,
"shiftStartTime": null,
"shiftEndTime": null,
"shiftTimeNotWorked": null,
"shiftCategory": null,
"shiftCode": null,
"shiftType": null,
"schedShiftEventId": 300100658212788,
"schedEventId": 300100658212787,
"allowEdits": null,
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-02",
"paidBreakDuration": null,
"unpaidBreakDuration": null,
"comments": null,
"premiumShiftCode": null,
"allowOvertimeFlag": null,
"workforceShiftCategory": null,
"shiftIncentive": null,
"otherQualification": null,
"otherQualificationType": null,
"jobProfile": "RN",
"jobProfileType": "ORA_JOB",
"jobSetCode": "COMMON",
"businessUnitName": null,
"scheduleShiftEventNumber": "SSE102-1",
"links": [
{....
}
]
},
{
"shiftDuration": null,
"shiftNumber": "SSE102-2",
"shiftAction": "CREATE",
"referenceDay": null,
"shiftStartTime": null,
"shiftEndTime": null,
"shiftTimeNotWorked": null,
"shiftCategory": null,
"shiftCode": null,
"shiftType": null,
"schedShiftEventId": 300100658212789,
"schedEventId": 300100658212787,
"allowEdits": null,
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-03",
"paidBreakDuration": null,
"unpaidBreakDuration": null,
"comments": null,
"premiumShiftCode": null,
"allowOvertimeFlag": null,
"workforceShiftCategory": null,
"shiftIncentive": null,
"otherQualification": null,
"otherQualificationType": null,
"jobProfile": "RN",
"jobProfileType": "ORA_JOB",
"jobSetCode": "COMMON",
"businessUnitName": null,
"scheduleShiftEventNumber": "SSE102-2",
"links": [
{
.... }
]
},
{
"shiftDuration": null,
"shiftNumber": "SSE102-3",
"shiftAction": "CREATE",
"referenceDay": null,
"shiftStartTime": null,
"shiftEndTime": null,
"shiftTimeNotWorked": null,
"shiftCategory": null,
"shiftCode": null,
"shiftType": null,
"schedShiftEventId": 300100658212790,
"schedEventId": 300100658212787,
"allowEdits": null,
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-04",
"paidBreakDuration": null,
"unpaidBreakDuration": null,
"comments": null,
"premiumShiftCode": null,
"allowOvertimeFlag": null,
"workforceShiftCategory": null,
"shiftIncentive": null,
"otherQualification": null,
"otherQualificationType": null,
"jobProfile": "RN",
"jobProfileType": "ORA_JOB",
"jobSetCode": "COMMON",
"businessUnitName": null,
"scheduleShiftEventNumber": "SSE102-3",
"links": [
{
.... }
]
},
{
"shiftDuration": null,
"shiftNumber": "SSE102-4",
"shiftAction": "CREATE",
"referenceDay": null,
"shiftStartTime": null,
"shiftEndTime": null,
"shiftTimeNotWorked": null,
"shiftCategory": null,
"shiftCode": null,
"shiftType": null,
"schedShiftEventId": 300100658212791,
"schedEventId": 300100658212787,
"allowEdits": null,
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-05",
"paidBreakDuration": null,
"unpaidBreakDuration": null,
"comments": null,
"premiumShiftCode": null,
"allowOvertimeFlag": null,
"workforceShiftCategory": null,
"shiftIncentive": null,
"otherQualification": null,
"otherQualificationType": null,
"jobProfile": "RN",
"jobProfileType": "ORA_JOB",
"jobSetCode": "COMMON",
"businessUnitName": null,
"scheduleShiftEventNumber": "SSE102-4",
"links": [
{
.... }
]
},
{
"shiftDuration": null,
"shiftNumber": "SSE102-5",
"shiftAction": "CREATE",
"referenceDay": null,
"shiftStartTime": null,
"shiftEndTime": null,
"shiftTimeNotWorked": null,
"shiftCategory": null,
"shiftCode": null,
"shiftType": null,
"schedShiftEventId": 300100658212792,
"schedEventId": 300100658212787,
"allowEdits": null,
"shiftTypeExtendedCode": "REGULAR",
"workforceShiftName": "SHIFT_8A-6P",
"shiftDate": "2025-06-06",
"paidBreakDuration": null,
"unpaidBreakDuration": null,
"comments": null,
"premiumShiftCode": null,
"allowOvertimeFlag": null,
"workforceShiftCategory": null,
"shiftIncentive": null,
"otherQualification": null,
"otherQualificationType": null,
"jobProfile": "RN",
"jobProfileType": "ORA_JOB",
"jobSetCode": "COMMON",
"businessUnitName": null,
"scheduleShiftEventNumber": "SSE102-5",
"links": [
{
.... }
]
}
}