Symptom
Is it possible to open or close a job requisition via OData API?
Environment
SAP SuccessFactors Recruiting Management
Resolution
Yes.
To accomplish that we need to use a upsert operation on the jobRequistion Entity and include the job requisition ID, internal status and option ID of the job requisition status.
The internalStatus is telling the system what kind of status the requisition will be in, and the status is the picklist status that you would like to set the requisition to. For Example:
EndpointURL/odata/v2/upsert
{
"__metadata":{
"type":"SFOData.JobRequisition",
"uri":"JobRequisition(2447)"
},
"internalStatus":"2",
"status":{"id":"11393"}
}
The above example would be for closing a Job Requisition, as the internalStatus field is set to 2.
The values for the internalStatus are:
- 0 - Requisition Pre-Approved;
- 1 - Requisition Open/Approved;
- 2 - Requisition Closed;
Should you know more about this topic, access the JobRequisition section on the OData API Reference Guide.
Note: isDraft is not supported when internalStatus is used. If you are closing a job requisition using API all mandatory fields need to be populated on the job requisition otherwise the above query will fail.
See Also
2745582 - How to get the Job Requisition status via OData API - Recruiting Management
JobRequisition - SAP SuccessFactors HXM Suite OData API: Reference Guide
Keywords
Open, close, job requisition, OData API, API, internal status, job req status