Oracle Recruiting Cloud (ORC) Jobs Feed Implementation Guide

Project Scope

Purpose

 This document defines the requirements and process for implementing a Jobs Feed integration between Oracle Recruiting Cloud (ORC) and Radancy Talent Acquisition Cloud (TAC).

Scope Overview 

The Jobs Feed serves as the primary source of truth for open job requisitions displayed on the Radancy Career Site and supports downstream Radancy modules.

Additional integrations may be required based on the Radancy modules under contract, including but not limited to CRM, Employee Referrals, Hiring Events, Screening & Scheduling, Insights & Analytics, and Programmatic AdTech.

Out of Scope 

This is a one-way integration from Oracle Recruiting Cloud (ORC) to Radancy. This document covers job requisition data only. Applicant data is out of scope and is handled separately if contracted.

Integration Summary

Integration Details

  • Integration Type: API-based job feed
  • Integration Method: Oracle Recruiting Cloud REST API
  • Data Direction: Oracle Recruiting Cloud (ORC) → Radancy
  • Refresh Frequency: Up to four imports per day (standard)
  • Data Format: JSON

Data Retrieval Model

Oracle Recruiting Cloud does not expose all required job data within a single endpoint. As a result, the ORC jobs feed integration uses a multi-call enrichment model in which Radancy retrieves core job requisition data and supplements it with additional API calls to obtain complete job information for career site display and downstream processing.

Authentication & Security

Supported Authentication

Oracle Fusion Cloud HCM REST APIs use Oracle’s Multi Token Over SSL security policy.

Authentication methods supported by Oracle Recruiting Cloud may include:

  • Bearer token–based authentication (issued via the Oracle Identity Domain / IAM configuration)
  • JSON Web Token (JWT)–based authentication (tenant-dependent)
  • Basic Authentication (legacy / tenant-dependent)

Radancy will align to the authentication method supported and approved for the customer’s ORC tenant. The same authentication method is used consistently across all ORC endpoints used by this integration.

Bearer Token Authentication (If Enabled)

Client Requirements:

  • OAuth client created in Oracle HCM Cloud
  • Client ID
  • Client Secret
  • Token endpoint URL
  • Recruiting REST API scopes

Example Token Request

API Header

JWT Authentication (Advanced / Conditional)

Oracle Recruiting Cloud may support JSON Web Token (JWT)–based authentication depending on the client’s Oracle Identity configuration.

This method requires additional setup, including:

  • generation of x509 certificates
  • coordination with the client to install and configure certificates
  • creation and signing of JWT tokens per Oracle requirements

JWT authentication requires coordination between Radancy and the client’s Oracle team and may extend implementation timelines.

Basic Authentication (If OAuth Is Not Enabled)

The user must have Recruiting REST access and content permissions.

Base API Structure

All Oracle HCM REST requests follow this pattern:

Example:

Primary Job Feed Endpoint

Purpose

The primary endpoint retrieves the core set of job requisitions and serves as the source of truth for job records.

Endpoint Details

Query Parameters (High Level)

  • expand=publishedJobs: Retrieves external posting metadata associated with the job requisition.
  • q (filtering): Limits results to eligible jobs (e.g., open and externally posted).
  • onlyData=true: Returns the response without the metadata envelope (formatting preference).

Filtering Rules (ORC)

Jobs are included when they meet the following conditions:

  • Job belongs to a job family
  • Job is open
  • Job is externally posted

Sample Request (Example)

Pagination

ORC uses offset-based pagination with limit and offset. Radancy manages paging internally to retrieve all eligible records.

Secondary Job Data Enrichment

Oracle Recruiting Cloud does not return all job-related data in the primary job requisitions response. Additional job data may be retrieved to support career site display and Radancy products under contract. Radancy will identify required and optional job fields based on product needs. The customer may be asked to confirm field mappings or enable Oracle configuration to expose specific job-related data. Enriched job data may include candidate-facing job content, organizational attributes, location details, and compliance-related information.

References:

Oracle Recruiting Cloud API Documentation

Oracle Recruiting Cloud Authentication Documentation

Job Feed Data Requirements

Below is a list of required, recommended and optional fields. The customer/ATS must provide the fields and data in the format to be displayed on their career site. Please note that certain fields (not all are displayed on your career site) will be required/recommended to support your Radancy TAC platform (i.e. CRM, Employee Referrals, Hiring Events, Programmatic AdTech, etc.)

Field Description Required
Company Name Name of your organization Recommended
Company ID / Org ID If your ATS supports multiple instances Optional
Job Title Title of the job Yes
Job ID/Requisition Number Unique Identifier Yes
Job Category Category of job Yes
Job Description One or more fields containing all descriptive data including relevant HTML format. Include/define any separate Qualifications/Experience/Requirements/Company Profile, etc.) Yes

Primary Job Location

  • City
  • State/Province
  • Country
  • Postal Code
Preferable in separate individual fields for city, state, country and postal code of the primary location Yes
Additional Locations

Option 1 – Single field separated by consistent unique identifiers, such as semi-colons and commas. (Preferred)
<additional locations>city, state, country; city, state, country; city, state, country</additional locations>

Option 2 – In separate fields for each additional city, state and country.
<additional locations>city,state,country</additional locations>
<additional locations1>city1,state1,country1</additional locations1>
<additional locations2>city1,state1,country1</additional locations2>

Recommended
Application URL ATS application URL Yes
Job Posting Date Date job was created in ATS Yes
Job Status Open/Closed/Filled Recommended
Job Shift 1/2/3/Evening/Weekend Recommended
Job Type Type of job; FT/PT/PD Recommended
Job Level Senior, Manager, Entry, etc. Recommended
Language Language requirements Recommended
Facility Name If multiple physical locations Recommended
Brand/Division/Department If multiple brand/division/department names Recommended
Business Unit If multiple business units Recommended
Salary Salary info; Min – Max Yes
Remote Status Yes/No – enhances candidate search experience on career site; a primary job location is still required Recommended
Job Profile Standardized job title templates. Optional
Recruiter Name Name of Primary Recruiter Recommended
Recruiter Email Email of Primary Recruiter. Required for CRM/Referrals Yes
Hiring Manager Email Email of Hiring Manager Optional
Sourcer Email Email of Sourcer Optional
Referral Reward Description of the reward to be earned for a successful hire Recommended
Referral Featured Job Yes/No Recommended
Custom Fields Customer to provide use case description Optional

Notes:

Referrals: If all correlated fields are included in the jobs feed integration, jobs are automatically published within the Employee Referrals dashboard (ready to refer). If any jobs are missing required data, they will instead be listed under “draft” status requiring manual intervention by the customer (recruiter) to complete. Once completed, the job can then be published and “enabled” to begin referring. If any data is not available from your ATS, it is possible for Radancy to apply conditional logic to streamline workflow processes.

  • Fields can be defaulted to a standard selected value (e.g., Reward plan is for all jobs “$500”)
  • Fields can be conditionally mapped based on other fields (e.g., if experience level is “Entry”, Reward plan is “$100”, if experience level is “Advanced”, Reward plan is “$500”)

Please contact your assigned Digital Project Manager or Integration Specialist.

High-Level Implementation Timeline

High Level Jobs Implementation Timeline    
Task Owner Date/Timeline

Kickoff call

  • Discovery and documentation exchange.
  • Define action items.
Customer/ATS/Radancy -
Provide API Credentials or XML job feed to Radancy Customer/ATS 5-10 business days

Validate access to API or receipt of XML job feed

  • Review required fields and data format.
Radancy 5-10 business days

Create integration connectors and import test data

  • During implementation, Radancy will recommend optimizations to the test feed and/or data as necessary.
  • Display test jobs on staging preview site.
Radancy 5-10 business days

Customer UAT

  • Customer conducts testing on the staging preview site (full job posting appearance).
  • Customer to provide Radancy with feedback and revisions.
  • Repeat until customer approval is attained.
Customer/Radancy 5-10 business days

Go Live Ready

  • Customer and Radancy to coordinate migration of integration work from staging/preview to production environment in accordance with your career site launch.
Customer/Radancy -

*Timeline is subject to change based on implementation variables.

Was this article helpful?
0 out of 0 found this helpful