# Connect SAP SuccessFactors

SAP SuccessFactors is an HRIS integration that syncs employee, job, and compensation data to Pave. SAP SuccessFactors supports two connection methods: API and SFTP.

### Which method should I use?

* **API**: Use this method if your SAP SuccessFactors admin can create an API user and register an OAuth2 client application. This provides direct data sync through the SAP SuccessFactors OData API.
* **SFTP**: Use this method if your organization requires file-based data transfer. SFTP setup requires assistance from Pave's team.

## Before you connect

The API method requires several configuration steps in SAP SuccessFactors. Complete all of the following steps before connecting in Pave. If you are using the SFTP method, skip to "Connect SAP SuccessFactors to Pave" below.

### Request a public key certificate from Pave

Contact your Pave team to request a public key certificate. You will need this certificate when registering the OAuth2 client application in a later step.

### Create a Pave API user


1. In SAP SuccessFactors, go to **Admin Center** and search for **Employee Import**.
2. Select **Download Template** and choose **Basic User Data** as the object.
3. Open the template and fill in the following columns for the Pave API user:
   * **USERID**: a user ID for the Pave integration (for example, "pavesfadmin")
   * **USERNAME**: a username for the user
   * **STATUS**: set to "active"
   * **FIRSTNAME**, **LASTNAME**, **EMAIL**: the user's details
   * **HIRE_DATE**: any valid date
   * **TIMEZONE**, **DEFAULT_LOCALE**: your organization's timezone and locale
4. Save the file as CSV with UTF-8 encoding.
5. Return to **Employee Import** in Admin Center. Select **Basic User Data** as the object and upload your CSV file.
6. Click **Validate** to check for errors, then click **Import** to create the user.

### Allowlist Pave IP addresses


1. In SAP SuccessFactors, go to **API Center** and select **OData IP Allowlisting**.
2. Add the IP addresses provided by your Pave team. Your Pave contact will provide the specific addresses during setup.

### Set the API user password to never expire


1. In SAP SuccessFactors, search for **Password & Login Policy Settings**.
2. Create a new entry for the Pave API user you created.
3. Set the **Username** to the Pave API user's user ID.
4. Set **Maximum password age** to **-1** (never expires).

### Register an OAuth2 client application


1. In SAP SuccessFactors, go to **Admin Tools** and search for **Manage OAuth2 Client Applications**.
2. Click **Register Client Application**.
3. Enter an **Application Name** (for example, "Pave Connection"), a **Description**, and an **Application URL**.
4. In the **Bind to Users** field, enter the user ID of the Pave API user you created earlier.
5. Upload the certificate body from the public key certificate you received from Pave. Copy only the certificate content between the "BEGIN CERTIFICATE" and "END CERTIFICATE" lines (do not include those lines themselves).
6. Click **Save** to register the application.
7. Click **View** on the application you just registered. Copy the **API Key** shown on this page. You will need it when connecting in Pave.

## Connect SAP SuccessFactors to Pave

### API method


1. In Pave, go to **Connections** and find SAP SuccessFactors.
2. Enter your **API Key** from the OAuth2 client application you registered.
3. Enter your **Name ID** (the user ID of the Pave API user you created, for example "pavesfadmin").
4. Enter your **SAP Company ID**. To find this in SAP SuccessFactors, click your profile image in the upper right and select **Show Version Information**. Your Company ID is listed in the dialog that appears.
5. Click **Submit**.
6. Go to **Connections** and verify the SAP SuccessFactors integration shows as connected.

### SFTP method

Contact your Pave Customer Success Engineer or email support@pave.com to set up an SFTP-based SAP SuccessFactors connection. Your CSE will configure the file delivery and field mapping.

## Troubleshooting

**Connection shows in error state** The access token may have expired or the OAuth2 client application may no longer be active. Verify that the API user's password is set to never expire and that the OAuth2 client application is still registered in SAP SuccessFactors. Also confirm that Pave's IP addresses are still allowlisted in the API Center. Note: the API user's password should not contain special characters, as SAP SuccessFactors may reject them.

**No data appears after connecting** Verify that the API user has the correct security permissions to access employee data through the OData API. Check that the user is active and properly bound to the OAuth2 client application.

**Data is missing or incomplete** The API method syncs data from several SAP SuccessFactors OData endpoints. If specific fields are missing, check that the employee records have the expected data populated in SAP SuccessFactors. For the SFTP method, verify that your report file includes all expected fields and was delivered to the correct location.

## Fields that sync

Custom mappings may apply to your account.

### API method

* First name, last name, preferred name
* Email
* Employee ID
* Gender
* Job title, department, job code
* City, state, country, zip code
* Manager
* Start date
* Base salary, recurring pay components, non-recurring pay components

### SFTP method

Fields depend on your report configuration. Your Pave team will work with you to map the fields in your report to the corresponding Pave fields. Common fields include employee ID, email, name, job title, department, level, location, start date, salary, bonus, and commission.

### Additional data

* **Compensation history**: Supported via the API method. Pave syncs current and historical compensation records from SAP SuccessFactors.
* **Custom fields**: Supported. For the SFTP method, add custom fields to your report and they will sync automatically. For the API method, contact your Pave team to configure custom field mappings.
* **Benefits**: Not supported.




Connect SAP SuccessFactors

Connect ADP

Connect BambooHR

Connect Dayforce

Connect Deel

Connect Gusto

Connect HiBob

Connect Workday

Connect Namely

Connect Paylocity

Connect Personio

Connect Rippling

Connect UKG Pro

Connect CharlieHR

Connect Humaans

Connect Justworks

Connect Sapling

Connect TriNet

Connect Zenefits

HRIS Integrations

Connect Carta

Connect ComputerShare

Connect Shareworks

Connect E*Trade

Connect Fidelity

Connect Global Shares

Connect Pulley

Connect Schwab

Connect Ledgy

EMS integrations

Connect Culture Amp

Connect Workday Performance

Performance integrations

Connect Ashby

Connect Greenhouse

Connect Lever

Connect Workday ATS

ATS integrations

Manage your connections

Upload custom reports

Pave API

Integrations

Team View Overview

Team View Column Configuration

Team View Customizations

Re-ordering Columns

Deleting Columns

Adding Columns

Team View Settings

Team View

Configurations overview

Cycle access permissions

Overview

Employee eligibility

Approval chains

Planning windows

Budgets

Recommendation logic

Adding non-integration data to your cycle

Reward letters

Cycle Setup

Columns

OTE planning

Writing formulas with Handlebars

Hourly and monthly pay

Columns and Formulas

Using the planner worksheet

Using the employee detail view

Cycle Progress dashboard

Budgets dashboard

Cycle Outcomes dashboard

Approval Statuses 

Worksheet Experience

Overview of smart features in compensation planning

Peer Comparison

Smart Flags

Priority Sort

Compensation Outliers

Manager Compression Flag

Vesting Drop Flag

Flags and Insights

Compensation Planning

How does Pave Work?

Intro to Pave

Contact Us

Pave 101

Getting Started

Grades

Setting up Company Job Architecture

Company Job Architecture

Job Architecture 101

Pay Zone Manager

Step 1: Build Foundation

Generate Bands from Market Data

Editing Bands

Calculated Columns

Bands Set Audit Log

Bulk & Manually Associate Market Data to Bands

Employee Distribution in Bands

How to duplicate band sets

Managing & Reordering Calculated Columns

Unmatched Employees

View changes

Pay Types: Calculated TDC, Annual Equity, and Refresh Equity

Manually Create New Band Sets

Band Sets

Upload/Download Bands

Step 3: Update Ranges

Advanced Filters

Compare Bands

Generate Bands for New Jobs in Your Job Architecture

Relative Permissions

Ongoing Management & Analysis

Edit and apply benchmarks

Set weights and logic

Map data sources to jobs

Supported survey providers

Manage Pave data sources

Manage survey data sources

Benchmarks overview

Survey aging

Step 2: Benchmarking

Market Pricing

Create an account and log in

Set up single sign-on (SSO)

Account setup

Configure role permissions

Create and manage roles

Roles and permissions

Impersonate a user

Manage notifications

Complete your company profile

Manage company settings

Platform settings

Account & Permissions

Create and manage Peer Groups in Market Data

Create and manage Market Data reports

Equity data benchmarking

Explore data composition

Explore the Pave job catalog

Filter Market Data benchmarks

Get started with Market Data

Share Market Data externally

Market Data Benchmarks (Features & Workflows)

Understand Calculated Benchmarks

Understand Consistency Labels

Understand job matching

Understand Market Data methodology

Understand job levels

Market Data Methodology 

Explore Global Location Insights

Explore Equity Practices

Other Pave Market Data Products 

Market Data FAQ

FAQ's

Upgrade to Market Data Pro

Upgrades & Pricing 

Market Data

Understanding Equity in Total Rewards

Display Original Grant Value

Compensation Simulator Configurations

Compensation Simulator Overview

Learning Hub Configuration

Learning Hub Overview

Reward Letters

Accessing your Total Rewards portal

Total Rewards 101

Visual Offer Letters with Workday

Visual Offer Letters with Greenhouse

Visual Offer Letters with Lever

Visual Offer Letter as a Candidate

Previewing Visual Offer Letters

Visual Offer Letters with Ashby

Creating and sending Visual Offer Letters in Pave

Visual Offer Letter 101

Why is my equity different in the equity tab on the left hand side compared to the equity valuation on the graphs?

Why can't I view my own Total Rewards portal?

Total Rewards and Visual Offer Letter FAQ

How can I complete our Greenhouse connection if "API credential management" is not in my Greenhouse menu?