Symptom
What is the process of creating, updating or rehiring contingent workers on EC via OData API requests?
Environment
- SAP SuccessFactors HXM Suite
- OData API
Resolution
First thing to do would be checking if all the requirements for Contingent Workers were properly set up in your instance. They are explained in the topic 3, "Setting Up Contingent Workers" (page 10), of the guide below:
Contingent Workforce Management
After this, for more information on managing Contingent Workers via API please refer to page 619 of this help guide:
SAP SuccessFactors API Reference Guide (OData V2)
NOTE: In case you need to rehire a full time employee as a contingent worker, use the "Rehire a contingent worker (new employment switch is On)" method described on page 62 (Contingent Workforce Management). The userId chosen for the new EmpEmployment entity should be one that doesn't exist in the system yet.
NOTE2: In case you need to rehire a contingent worker as a full time employee, use the steps below:
- 1) Create employment info (OData API upsert in the EmpEmployment) with the same person ID but with a different user ID. Please notice that you will not need any OData API upsert in the OData.User entity (this is created automatically after your OData API upsert in the EmpEmployment.
- 2) Create job information (OData API upsert in the EmpJob).
- 3) Create or update any other entities as necessary
See Also
Keywords
odata, api, sfapi, successfactors, success factors, sf, sfsf, bizx, contingent worker, cw, external employee, isContingentWorker, employee central, hire, work order, upsert, workorder , KBA , LOD-SF-INT-EC , Employee Central SFAPI & OData Entities , LOD-SF-INT , Integrations , LOD-SF-INT-ODATA , OData API Framework , How To