SAP Knowledge Base Article - Public

2869117 - How to manage (create, update, rehire) Contingent Workers on EC via OData API - SuccessFactors

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 11), of the guide below:

Contingent Workforce Management

After this, in this same guide, you'll find an explanation on how to manage Contingent Workers via API in the topic 13.1.3, "Managing Contingent Workers with an API", on page 66.

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 67. The userId chosen for the new EmpEmployment entity should be one that doesn't exist in the system yet.

See Also

SAP SuccessFactors Employee Central OData API: Reference Guide

SAP SuccessFactors HXM Suite OData API: Developer Guide

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

Product

SAP SuccessFactors HXM Suite all versions