2883239 - How to update the Application Status via Integration Center/OData API - Recruiting Management

This article explains how to update the Application Status via Integration Centre

Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental.

 SAP SuccessFactors Recruiting Management

The example below show how to update a JobApplication via Integration center.

Initial Conditions:

Application ID 3020 in Status: “Interview One” - ("appStatusSetItemId"= 10)

task:

send the application to Status: “Interview Two” - ("appStatusSetItemId"= 11)

STEPS

1. access Admin Centre > Integration Center
2. click on "My Integrations"
3. click on "Create" and select "Scheduled CSV Input Integration"
4. using the search bar on the top-left corner select "JobApplication" entity
5. proceed as in the screesnhot below uploading a sample CSV and doing the appropriate mapping with drag&drop between the columns of your CSV (on the left) and the destination ODATA field (on the right):
    
6. the “Run Preview Records” as below:
   

   

      

Results:

The Application has been moved successfully from Interview One to Interview Two since the tool updated "appStatusSetItemId" 

from 10 to 11 via ODATA Upsert:

As additional confirmation the Application history shows that the Application status has been updated via OData:

How to perform the same via manual ODATA Upsert:

It's also possible to achieve the same result doing a manual ODATA Upsert.

URL:   .../odata/v2/upsert

Method: POST

Payload:

{
"__metadata": {
"uri": "JobApplication(xxxxL)"
},
"appStatusSetItemId" : "xx"
}

Important considerations:

1. You need to be sure that the ID of the status is part of the Status Set linked to the Job Requisition Template.

How to verify the correct Status Set associated:

- check the correct Job Requsition Template associated to Job Req ID

- and verify the line in XML:

   <application-status-set name="Set Name Example"/>

If you send the ID of a status part of a different Set, you will generate a data issue and the application will not be visible anymore.

2. If the option "When number of remaining openings becomes less than one Automatically close requisitions with status XXX" is enabled in Manage Recruiting Settings page,

and you change the application status to a "Hired" one, the related job requisition will NOT be closed automatically.

You need to close the job requisition manually or via OData API.

appStatusSetItemId, odata, Application, status, update, integration, center, via, change, value, data , KBA , LOD-SF-RCM-INT , Integration Center & Intelligent Services , LOD-SF-RCM-API , Webservices & APIs , How To