SAP Knowledge Base Article - Public

2920464 - Auto-Disqualification of an applicant through OData API - Recruiting Management

Symptom

Does OData API support a candidate being automatically disqualified when the candidate answers a pre-screening question incorrectly?

Note: This article provides a simple example. SAP Support team does not help or support this task. If you are unsure on how to execute this OData call, you will need to engage with a SAP Partner or Professional Services.

Environment

SAP SuccessFactors Recruiting Management 

Resolution

JobApplication OData API now supports the auto-disqualification of candidates, when pre-screening questions are answered incorrectly.

The pre-screening question has to be configured as a disqualifying question, to automatically move the candidate to disqualified status. Appropriate e-mails are triggered to notify candidates when the option is enabled.

When the candidate has answered the question incorrectly the system will place the candidate in the disqualified status.

Example of query:

URL: <host>/odata/v2/upsert

{
"__metadata": {
"type": "SFOData.JobApplication",
"uri": "JobApplication"
},
"candidateId": "[INSERT CANDIDATE ID]",
"jobReqId": "[INSERT JOB REQUISITION ID]",
"address": "Address Candidate Profile",
 
//... all the required fields you have in your template
 
"jobApplicationQuestionResponse": [
{
"__metadata": {
"uri": "https://api68sales.successfactors.com/odata/v2/JobApplicationQuestionResponse", //update the endpoint according to your DC
"type": "SFOData.JobApplicationQuestionResponse"
},
"question": "[INSERT QUESTION NAME]",
"order": "[INSERT ORDER ACCORDING TO THE UI]",
"answer": "[INSERT ANSWER]"
},
{
"__metadata": {
"uri": "https://api68sales.successfactors.com/odata/v2/JobApplicationQuestionResponse", //update the endpoint according to your DC
"type": "SFOData.JobApplicationQuestionResponse"
},
"question": "[INSERT QUESTION NAME]",
"order": "[INSERT ORDER ACCORDING TO THE UI]",
"answer": "[INSERT ANSWER]"
}
]
}

 

The above example was in case there were 2 questions, and only one disqualifier. It will create the job application AND disqualify them at the same time.

Please make sure to make the adjustments according to your configuration. With the above query, you will be able to create the application and automatic disqualify it.

Keywords

api, auto, disqualify, disqualification, odata, application, jobApplication, candidates, question, pre-screening, automatic , KBA , LOD-SF-RCM-API , Webservices & APIs , How To

Product

SAP SuccessFactors Recruiting all versions