2341070 - API services for Recruiting Management - SFAPI and oData API - Recruiting Management

SAP Knowledge Base Article - Public

2341070 - API services for Recruiting Management - SFAPI and oData API - Recruiting Management

Symptom

The SFAPI is SuccessFactors Data API. It is a SOAP Web Service designed for importing and exporting data to and from your SuccessFactors instance. It provides generic CRUD (Create, Read, Update, Delete) operations to access data, as well as meta-data operations to allow runtime discovery of the data.

The OData API is a solution with allows to export, create and update operations in the Recruiting Module. This Knowledge Base Article explains what OData API is and what possibilities it offers when in use with the Recruiting Management Module. Please note that OData API does not replace the SFAPI solution - it is an alternate integration.

This Knowledge Base Article is a Master KBA for API services in use with Recruiting Management

Environment

Recruiting Management

SFAPI

OData API

Resolution

1) Entity level SFAPI and oData API permissions for Recruiting Management

Entity Level permissions for both APIs: SFAPI and oData API are managed from RBP Permissions. If the api user is not granted permissions to update / instert / upsert / delete operations in "Recruiting Permissions" these actions won't be possible. Please refer to the following Knowledge Base Article for more information: 2323622

2) SFAPI entities and possible issues

Recruitment logical entities correspond with Recruitiment physical tables in the SuccessFactors database schema. Following SFAPI entities are available for Recruiting:

  • JobRequisition$<job req template ID>
  • JobCodeEntity$<job code entity ID>
  • JobPosting
  • JobApplication$<application template ID>
  • JobApplicant$<application template ID>
  • Candidate$<candidate profile template ID>
  • BackgroundCheck
  • Onboarding
  • AssessmentOrder
  • AssessmentReport

For more information about SFAPI Recruiting entities please refer to the attachment.

Potential issues for SFAPI in use with Recruiting entities:

Error type Explanation KBA reference
Error: Internal error occurred! when updating application status using SFAPI  misconfiguration in the statusId field definition in the Application template 2341145
Error - Internal error occurred in SFAPI Response.xml! During Recruiting Data Import RH_SFI_IMPORT_RECRUITING_DATA Either the stauts which is coming in Request.xml (for example: TransferredToSAP) is not defined under: Applicant Status Configuration or mis-spelled the Status Name while defining in Applicant Status Configuration 2245467
operatorTeam fields are not auto-populating when job requisitions are created using SFAPI / OData API This is a current product limitation 2291807

Direct link to all Knowledge Base articles containing keywords "SFAPI" and "Recruiting": LINK

3) OData API entities and possible issues

Following entities are available for OData API with Recruiting:

  • JobProfile
  • JobReqFwdCandidates
  • JobReqQuestion
  • JobReqScreeningQuestion
  • JobReqScreeningQuestionChoice
  • JobReqTemplate_<template name>
  • JobRequisitionLocale
  • JobRequisitionOperator
  • JobRequisitionPosting
  • JobApplication
  • JobApplicationAudit
  • JobApplicationComments
  • JobApplicationInterview
  • JobApplicationOnboardingData
  • JobApplicationOnboardingStatus
  • JobApplicationQuestionResponse
  • JobApplicationSnapshot_<background element name>
  • JobApplicationStatus
  • JobApplicationStatusLabel
  • JobAppTemplate_<template name>
  • Candidate
  • CandidateBackground_<background element name>
  • Job Offer
  • JobOfferApprover
  • JobOfferTemplate_<template name>
  • OfferLetter

More information about entities in Recuriitng and possible actions can be found in the following Knowledge Base Article: 2251702

Potential issues for OData API in use with Recruiting entities:

Error type Explanation KBA reference
OData API error: "Recruiting OData API Application Create/Update permission in Admin Center is not enabled" incorrect permissions assigned to the user which is being used to update the application via API call 2273532
'COE_GENERAL_FORBIDDEN' error message when trying to use any Recruiting entity in Integration Center incorrect permissions assigned to the user which is being used to update the application via API call 2336587

Direct link to all Knowledge Base articles containing keywords "oData" and "Recruiting": LINK

Keywords

KBA , LOD-SF-RCM-API , Webservices & APIs , LOD-SF-INT-API , SF API & Adhoc API Framework , How To

Product

SAP SuccessFactors HCM Core all versions

Attachments

SFAPI_Recruitment_Entities_v1.01.docx