# SAP SuccessFactors

<figure><img src="/files/6PfJV31e3UwAAnddd6uq" alt=""><figcaption></figcaption></figure>

### What you get

* **Live People directory** — SuccessFactors workers appear in Siit with their full role and org context.
* **Lifecycle triggers** — Hire date, Termination date, and Birthday flow into Siit as workflow triggers.
* **Organization awareness** — department, cost center, location, and legal entity hierarchies are preserved for routing, approvals, and audiences.
* **Manager resolution** — SuccessFactors' reporting structure powers auto‑selected approvers.
* **Multi‑entity support** — legal entity, company, and region are synced and usable as workflow conditions.

### What syncs from SuccessFactors

| Category        | Fields                                                     |
| --------------- | ---------------------------------------------------------- |
| Identity        | Preferred name, legal name, work email, person ID, user ID |
| Role            | Job title, job code, department, division                  |
| Org structure   | Manager, cost center, location, company, legal entity      |
| Employment      | Worker type, employment status                             |
| Lifecycle dates | Hire date, termination date, date of birth                 |

Work email is the canonical identifier.

### Before you connect

SuccessFactors requires more preparation than most HRIS platforms. Setup varies significantly by tenant configuration. You'll need:

* A SuccessFactors admin to configure an OData API user and the relevant role-based permissions.
* Your tenant URL and API endpoint.
* Agreement with your SuccessFactors administrator on the scope of data exposed to Siit.

For the recommended setup for your tenant, reach out to support via the in‑app chat — we'll work with you to scope and configure the connection correctly.

### Connect SAP SuccessFactors

1. Have your SuccessFactors admin create an OData API user with the required permissions to read worker data.
2. In Siit, go to **Settings → Integrations**, find **SAP SuccessFactors** in the HRIS section, and click **Connect**.
3. Enter your tenant URL, API user credentials, and any company-specific identifiers.
4. Review the imported workers and field mapping, then click **Finish setup**.

### After the connection

* Compare Siit's worker count with your SuccessFactors active worker report.
* In **Settings → People → Fields**, set SuccessFactors as the source of truth for org‑structure fields if you're also connected to an IdP.
* Build a Day‑1 onboarding workflow using the Hire date trigger.

### Sync frequency

SuccessFactors data refreshes every few hours by default. For very large tenants, the schedule is tuned based on worker count. Manual syncs are available from **Settings → Integrations → SAP SuccessFactors → Sync now**.

### Common workflows

**Day‑1 onboarding.** *Trigger: Hire date. Actions: create IdP account, assign apps by department, ship equipment, DM manager.*

**Offboarding on termination.** *Trigger: Termination date. Actions: revoke sessions, remove app access, equipment pickup, notify manager.*

**Legal entity‑aware approval.** *Condition: Requester's legal entity → Route to the right regional approver.*

### Troubleshooting

**"401 Unauthorized" on connect.** The API user password is wrong, expired, or the user has been locked. Reset and update Siit.

**Workers missing.** The API user's role-based permissions likely lack access to a specific employee group or business unit. Ask your SuccessFactors admin to extend the permission scope.

**Sync is slow on a large tenant.** Reach out via in‑app chat — we can adjust the sync strategy for your tenant.

**Custom field missing.** Make sure the field is included in the API user's role permissions, then re-map in Siit.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.siit.io/integrations/hris/sap-successfactors.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.