Symptom
- The getUserNameOfNewlyHiredEmployee API call fails with a 404 error.
- Error message: "The resource requested was not found."
- Error code: "NotFound".
Environment
SAP SuccessFactors Onboarding
Reproducing the Issue
- Attempt to update the username for future hire records using the updateUserNamePostHiring API from CPI.
- Use the getUserNameOfNewlyHiredEmployee API to fetch the username of newly hired employees.
- Ensure the candidate has successfully completed the Manage Pending Hires step and has a future joining date.
- Execute the API call.
- Observe the 404 error returned by the API.
Cause
- The API call fails because the URL used does not include the required version parameter (`v1`), causing it to be unrecognized in the system logs.
Resolution
- Use the correct API URL with the mandatory version parameter:
https:/api-server/odatav4/onboarding/AdditionalServices.svc/v1/getUserNameOfNewlyHiredEmployee(userId='2011024364') - Ensure the version (`v1`) is included in the API URL to avoid recognition issues.
- Ensure you have the Manage Onboarding or Offboarding >> Initiate Onboarding API Permission.
See Also
- a href="https://help.sap.com/docs/successfactors-platform/sap-successfactors-api-reference-guide-odata-v4/fetching-username-of-new-hire" Fetching Username of New Hire API Reference Guide /a
Keywords
getUserNameOfNewlyHiredEmployee, 404 error, API version, v1, onboarding, ATS integration, Manage Pending Hires, updateUserNamePostHiring, username fetch, SAP SF onboarding, API failure, error code, resource not found. , KBA , LOD-SF-OBX-ATS , ATS Integration , Problem
Product
SAP SuccessFactors Onboarding 2511
SAP Knowledge Base Article - Public