SAP Knowledge Base Article - Public

3584181 - Can't Bulk Accept Data Privacy Consent Statements Through API - Recruiting Management

Symptom

Can not bulk update the Data Privacy Consent Statement (DPCS) of existing candidates via ODATA API or mass accept the Data Privacy Consent Statement on behalf of the candidates via ODATA API.

Note: This is only for External Candidates. 

Environment

SAP SuccessFactors Recruiting Management

Resolution

When use API to bulk update DPCS for existing external candidates.

POST:  https://endpoint/rest/security/privacy/v1/acknowledgements

POST Body: 

{
    {
  "type": "RECRUITING_EXTERNAL",
  "statementId": 123,
  "subjectId": "6358",
  "action": 1
    }
    {
  "type": "RECRUITING_EXTERNAL",
  "statementId": 123,
  "subjectId": "6357",
  "action": 1
    }
}

Post failed and this is expected behavior that it's not possible to mass update the status of acknowledgments for external candidates. 

For how to update the Data Privacy Consent Statement for single candidate, please refer to below KBA 3452944 and 3524394

 

Workaround:

You can update the agreeToPrivacyStatement entity under Candidate to true, which supports multiple updates. 

a. POST: https://endpoint/odata/v2/Candidate - this formatting is for when creating new candidates while accepting DPCS for them.

POST Body: 

{

    "firstName": "Test4",

    "lastName": "Privacy",

    "country": "BR",

    "cellPhone": "55 51 9999-9999",

    "primaryEmail": "privacy4@test.com",

    "shareProfile":"2",

    "password":"123",

    "agreeToPrivacyStatement":"true"

}

b. POST: https://endpoint/odata/v2/upsert - this formatting is for when updating the DPCS value for existing candidates.

POST Body:

{"__metadata": {

 

"uri": "Candidate(candidateId=1495)",

"type": "SFOData.Candidate"

},

    "agreeToPrivacyStatement":"true"

}

 

Note: You cannot upsert the same value twice, so, you cannot upsert true again, if you have done so already. Also, setting it to false, would mark the profile for anonymization automatically and is not retrievable or irreversible.  For more information about updating agreeToPrivacyStatement, refer to Guide: Candidate and CandidateBackground_* - Guide

See Also

3452944 - Data Privacy Consent Statement APIs - Recruiting Management

3524394 - How to Update the Data Privacy Consent Statement via ODATA API - Recruiting Management

Candidate and CandidateBackground_* - Guide

Keywords

RCM, Recruiting Management, Bulk, mass, acceptance, DPCS, API, ODATA, Data Privacy Consent Statement, Postman, external, existing, candidate, POST, agreeToPrivacyStatement, acknowledgements, statementId , KBA , LOD-SF-RCM-API , Webservices & APIs , Problem

Product

SAP SuccessFactors Recruiting all versions