SAP Knowledge Base Article - Public

3253420 - Initiate Onboarding error MANDATORY_FIELDS_MISSING - Onboarding

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

  1. Create the onboardee using Postman, filling out all the required fields:{"userName":"{{cust_userID}}","userId":"{{cust_userID}}","email":"{{contactEmail}}","applicationId":"{{applicationId}}"}
  2. 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": ""}
  3. 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