SAP Knowledge Base Article - Public

2278910 - Receiving Error: "Unable to initiate onboarding process. Reason: Unknown Error." [Integration with RCM] - Onboarding 1.0

Symptom

  • When trying to onboard a candidate, the following error is received: 'Unable to initiate onboarding process. Reason: Unknown Error.'
  • In the back-end logs (only accessible by SAP SuccessFactors Cloud Product Support), the following error is present 'ONB_SAVE_CANDIDATE_INFO_ERR'.

Environment

  • SAP SuccessFactors Recruiting
  • SAP SuccessFactors Onboarding 1.0 - All Versions

Reproducing the Issue

  1. Navigate to SAP SuccessFactors HCM > Recruiting
  2. Open the affected requisition and find the candidate with error
  3. Click Initiate Onboarding and the following error is received: 'Unable to initiate onboarding process. Reason: Unknown Error.'

Cause

The field parameter readytoHire in Object Definition > OnboardingCandidateInfo is marked as required.

For other causes find related KBAs with same error recieved: #sfobdintrcmunabletoinitiateuerr

Resolution

For Live Customers (SAP SuccessFactors HCM with Recruiting)

Please reach out to SAP SuccessFactors Cloud Product Support in SAP One Support Launchpad via SAP Expert Chat or Support Incident and provide the following information:

  • Affected BizX Company ID
  • Affected Requisition ID or Title
  • Affected Candidate Name
  • Affected Recruiter
  • Support Access

Note

SAP SuccessFactors Cloud Product Support will investigate the behavior

For Implementation Partner/s or Consultants

a. Confirm if readytoHire is required

  1. Navigate to SAP SuccessFactors HCM > Admin Center > Configure Object Definitions
  2. Select Object Definition as search filter and in the next field find OnboardingCandidateInfo 
  3. Find readyToHire parameter (use Ctrl + F and search the value readyToHire)
  4. In the 5th column, select the corresponding row where readyToHire is located
  5. Find Required (use Ctrl + F and search the value Required)
  6. If the value of Required is set as 'No', find related KBA where the following error is received: 'Unable to initiate onboarding process. Reason: Unknown Error.' in the link provided in the cause section

b. Update readytoHire to No

  1. If the value of Required is set as 'Yes', click done to close more details pop-up window
  2. Click Take Action button (located in the top right corner) and select Make Correction
  3. Find readyToHire parameter (use Ctrl + F and search the value readyToHire)
  4. In the 5th column, select the corresponding row where readyToHire is located
  5. Find Required (use Ctrl + F and search the value Required)
  6. Select 'No' and click Done button
  7. Find and click the Save button at the bottom of the page to reflect the changes

Keywords

SAP SuccessFactors, Onboarding, OBD, ONB, LOD-SF-OBD, INT, LOD-SF-OBD-INT,RCM, Recruiting, LOC-SF-RCM-INT, Integration, RX, Initiate Onboarding, Hire, Candidate  , KBA , #sfobdintrcmunabletoinitiateuerr , LOD-SF-OBD-INT , Integrations with Onboarding , LOD-SF-RCM-INT , Integration Center & Intelligent Services , Bug Filed

Product

SAP SuccessFactors Onboarding all versions