Symptom
- When creating an onboardee through postman from successfactors recruitment using service API - initiateOnboardingForUser throws an error: Values missing for mandatory keys: jobInfo.company,jobInfo.manager-id,jobInfo.company.country (keys varies per error)
- When Onboarding is Initiated, you receive a message MANDATORY_FIELDS_MISSING
Environment
SAP SuccessFactors Onboarding
Reproducing the Issue
- Create the onboardee using Postman, filling out all the required fields:{"userName":"{{cust_userID}}","userId":"{{cust_userID}}","email":"{{contactEmail}}","applicationId":"{{applicationId}}"}
- Create the following services: EmpEmployment, then create EmpJob, PerPerson, PerPersonal, and then we end up with the service called InitiateOnboardingForUser: {"userId":"{{cust_userID}}","atsApplicationId":"{{applicationId}}","startDate": ""}
- Error message prompted: Values missing for mandatory keys: jobInfo.company,jobInfo.manager-id,jobInfo.company.country (keys varies per error)
Cause
- Cause 1: As mentioned in the error message, some fields are mandatory to initiate Onboarding
- Cause 2: Recruiter or the user who initiates the onboarding lacks permission
Resolution
Solution 1: Please enable the fields below from Manage Business Configuration and ensure you provide the values.
- personalInfo.first-name
- personalInfo.last-name
- jobInfo.company and corresponding country
- jobInfo.manager-id
- employmentInfo.start-date
You have to provide this information to initiate onboarding successfully.
Solution 2: Permission must come from the recruitment side, have this checked by the RCM Partner/Consultant
- One permission could be due to Admin permission to Add New User was missing.
- Manage recruiting > ensure necessary permissions under this category is permitted
- Manage Hires > Add New User
See Also
- OData API: Reference Guide - initiateOnboardingForUser
- 2901207 Unable to Initiate ONB from RCM with Mandatory field error - Onboarding
- 3248968 [Onboarding] Onboarding Initiation failed because mandatory field values are not passed from RCM to ONB
Keywords
obx, Mandatory, fields, initiate, onboarding, error, initiateOnboardingForUser, Values missing for mandatory keys:, jobInfo.manager-id , KBA , LOD-SF-OBX-ATS , ATS Integration , Problem
Product
SAP SuccessFactors Onboarding all versions